ArcMap

设置镶嵌数据集属性

摘要

定义显示镶嵌数据集和将其作为影像服务提供时的默认设置。

用法

  • 可在镶嵌数据集属性的默认值选项卡中找到当前镶嵌数据集属性。

语法

SetMosaicDatasetProperties_management (in_mosaic_dataset, {rows_maximum_imagesize}, {columns_maximum_imagesize}, {allowed_compressions}, {default_compression_type}, {JPEG_quality}, {LERC_Tolerance}, {resampling_type}, {clip_to_footprints}, {footprints_may_contain_nodata}, {clip_to_boundary}, {color_correction}, {allowed_mensuration_capabilities}, {default_mensuration_capabilities}, {allowed_mosaic_methods}, {default_mosaic_method}, {order_field}, {order_base}, {sorting_order}, {mosaic_operator}, {blend_width}, {view_point_x}, {view_point_y}, {max_num_per_mosaic}, {cell_size_tolerance}, {cell_size}, {metadata_level}, {transmission_fields}, {use_time}, {start_time_field}, {end_time_field}, {time_format}, {geographic_transform}, {max_num_of_download_items}, {max_num_of_records_returned}, {data_source_type}, {minimum_pixel_contribution}, {processing_templates}, {default_processing_template}, {time_interval}, {time_interval_units}, {product_definition}, {product_band_definitions})
参数说明数据类型
in_mosaic_dataset

需要设置属性的镶嵌数据集。

Mosaic Layer
rows_maximum_imagesize
(可选)

镶嵌影像的最大行数，由镶嵌数据集在每次请求时生成。这有助于控制客户查看影像时服务器必须执行的工作量。如果数字较大，则会创建更大的影像，但同时也会延长处理镶嵌数据集的时间。如果将值设置得过小，影像可能显示不出来。

Long
columns_maximum_imagesize
(可选)

镶嵌影像的最大列数，由镶嵌数据集在每次请求时生成。这有助于控制客户查看影像时服务器必须执行的工作量。如果数字较大，则会创建更大的影像，但同时也会延长处理镶嵌数据集的时间。如果将值设置得过小，影像可能显示不出来。

Long
allowed_compressions
[allowed_compressions,...]
(可选)

定义用于将镶嵌影像从计算机传输到显示器（或者从服务器到客户端）的压缩方法。

  • None —不应用压缩。
  • JPEG — 最多压缩至 8:1 并且适合用作背景
  • LZ77 — 压缩大约为 2:1。适合用于分析。
  • LERC —压缩为 10:1 到 20:1。压缩迅速且适合用作具有较高位深度（12 位到 32 位）的原始影像
String
default_compression_type
(可选)

设置默认的压缩类型。默认压缩必须位于 allowed_compressions 列表中或者已经在镶嵌数据集的允许的压缩方法属性中设置。

  • None —不应用压缩。
  • JPEG — 最多压缩至 8:1 并且适合用作背景
  • LZ77 — 压缩大约为 2:1。适合用于分析。
  • LERC —压缩为 10:1 到 20:1。压缩迅速且适合用作具有较高位深度（12 位到 32 位）的原始影像
String
JPEG_quality
(可选)

使用 JPEG 时的压缩质量。压缩质量的范围是 1 到 100。数字越大，意味着影像的质量越高，但压缩程度越低。

Long
LERC_Tolerance
(可选)

限制使用 LERC 压缩时的每像素错误。该值以镶嵌数据集的单位指定。例如，如果误差为 10 厘米而镶嵌数据集的单位为米，则输入 0.1。

Double
resampling_type
(可选)

确定以较小比例显示数据集时计算像素值的方法。根据您拥有的数据类型选择相应的技术。

  • NEAREST —最快的重采样方法，可最大程度减少像素值的变化。适用于离散数据，例如土地覆被。
  • BILINEAR — 通过计算周围 4 像素的平均值（基于距离）来计算每个像素的值。适用于连续数据。
  • CUBIC —通过根据周围的 16 像素拟合平滑曲线来计算每个像素的值。生成平滑影像，但可创建位于源数据中超出范围外的值。适用于连续数据。
  • MAJORITY —基于 3 x 3 窗口中出现频率最高的值来确定每个像素的值。适用于离散数据。
String
clip_to_footprints
(可选)

栅格数据集及其轮廓通常会具有相同的范围。如果范围不同，可将栅格数据集裁剪至轮廓线。

  • NOT_CLIP —不将栅格裁剪至轮廓线。这是默认设置。
  • CLIP —将栅格裁剪至轮廓线。
Boolean
footprints_may_contain_nodata
(可选)

允许含有 NoData 值的像素。

  • FOOTPRINTS_MAY_CONTAIN_NODATA —显示含有 NoData 值的像素。这是默认设置。
  • FOOTPRINTS_DO_NOT_CONTAIN_NODATA —不显示含有 NoData 值的像素。请注意，虽然您会发现性能有所提升，但如果影像不包含 NoData 值，相应部分则会在镶嵌数据集中显示为洞。
Boolean
clip_to_boundary
(可选)

镶嵌数据集及其边界通常具有相同的范围。如果范围不同，可将镶嵌数据集裁剪到边界。

  • CLIP — 裁剪镶嵌影像到边界。这是默认设置。
  • NOT_CLIP —不裁剪镶嵌影像到边界。
Boolean
color_correction
(可选)

启用镶嵌数据集上的色彩校正。

  • NOT_APPLY —关闭色彩校正。这是默认设置。
  • APPLY —应用为镶嵌数据集设置的色彩校正。
Boolean
allowed_mensuration_capabilities
[allowed_mensuration_capability,...]
(可选)

选择查看器可对镶嵌数据集执行的测量。能否执行垂直测量取决于您的影像，并且可能需要 DEM。

  • None —不允许测量功能。
  • Basic — 允许距离、点、质心和面积计算等地面测量。
  • Base-Top Height —允许执行从要素底端到要素顶端的测量。有理多项式系数必须已嵌入到影像中。
  • Base-Top Shadow Height —允许执行从要素底端到其阴影顶端的测量。需要太阳方位角和太阳高程信息。
  • Top-Top Shadow Height —允许执行从要素顶端到其阴影顶端的测量。需要太阳方位角、太阳高程和有理多项式系数。
  • 3D —必须提供 DEM。
String
default_mensuration_capabilities
(可选)

选择此镶嵌数据集的默认测量功能。必须在 allowed_mensuration_capabilities 参数列表中设置默认值，或者已在镶嵌数据集的测量功能属性中设置默认值。

  • None —不允许测量功能。
  • Basic — 允许距离、点、质心和面积计算等地面测量。
  • Base-Top Height —允许执行从要素底端到要素顶端的测量。有理多项式系数必须已嵌入到影像中。
  • Base-Top Shadow Height —允许执行从要素底端到其阴影顶端的测量。需要太阳方位角和太阳高程信息。
  • Top-Top Shadow Height —允许执行从要素顶端到其阴影顶端的测量。需要太阳方位角、太阳高程和有理多项式系数。
  • 3D —必须提供 DEM。
String
allowed_mosaic_methods
[allowed_mosaic_method,...]
(可选)

定义显示重叠影像的规则。

  • None —根据镶嵌数据集属性表中的 ObjectID 对栅格进行排序。
  • Center —显示距离屏幕中心最近的影像。
  • NorthWest —显示距离镶嵌数据集边界西北角最近的影像。
  • LockRaster —选择要显示的特定栅格数据集。
  • ByAttribute —基于属性表中的字段显示影像并设置影像优先级。
  • Nadir —通过最近视角到零视角的视角范围来显示栅格。
  • Viewpoint —显示距离所选视角最近的影像。
  • Seamline —使用接缝线在影像间进行平滑过渡。
String
default_mosaic_method
(可选)

选择此镶嵌数据集的默认镶嵌方法。必须在 allowed_mosaic_methods 参数列表中设置默认值，或者已在镶嵌数据集的允许的镶嵌方法属性中设置默认值。

  • None —根据镶嵌数据集属性表中的 ObjectID 对栅格进行排序。
  • Center —显示距离屏幕中心最近的影像。
  • NorthWest —显示距离镶嵌数据集边界西北角最近的影像。
  • LockRaster —选择要显示的特定栅格数据集。
  • ByAttribute —基于属性表中的字段显示影像并设置影像优先级。
  • Nadir —通过最近视角到零视角的视角范围来显示栅格。
  • Viewpoint —显示距离所选视角最近的影像。
  • Seamline —使用接缝线在影像间进行平滑过渡。
String
order_field
(可选)

在使用 ByAttribute 镶嵌方法排列栅格时，选择要使用的默认字段。根据属性表中类型为元数据并且为整型的字段来定义字段列表。此列表可包括但不限于以下各项：

  • 名称
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Tag
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

如果您的字段是数值或日期字段，则需要设置 order_base 参数。

如果 ByAttribute 不是允许的镶嵌方法，则不需要此参数。

String
order_base
(可选)

按栅格与 order_field 参数中所选字段的值之间的差异对栅格进行排序。

如果使用“日期”属性，则需要采用下列格式之一：

  • YYYY/MM/DD hh:mm:ss.s
  • YYYY/MM/DD hh:mm:ss
  • yyyy/MM/dd HH:mm
  • yyyy/MM/dd HH
  • YYYY/MM/DD
  • YYYY/MM
  • YYYY

只有为 allowed_mosaic_method 参数指定了“按属性”时，才需要定义此参数。

String
sorting_order
(可选)

选择按升序还是降序排列栅格。

  • ASCENDING —升序排列。这是默认设置。
  • DESCENDING —降序排列。

只有为 ByAttribute 参数指定了 allowed_mosaic_method 时，才需要定义此参数。

Boolean
mosaic_operator
(可选)

定义重叠像素的解决规则。

  • FIRST —显示属性表中的第一个影像。
  • LAST —显示属性表中的最后一个影像。
  • MIN —显示最低像素值。
  • MAX —显示最高像素值。
  • MEAN —使用算术平均值计算平均重叠像素值。
  • BLEND —使用距离权重算法计算平均重叠像素值。
  • SUM —添加所有的重叠像素值。
String
blend_width
(可选)

设置要应用 BLEND mosaic_operator 的像素数量。

Long
view_point_x
(可选)

使用视点镶嵌方法时，可使用此参数水平平移影像的中心。单位与空间参考系统的单位相同。

Double
view_point_y
(可选)

使用视点镶嵌方法时，可使用此参数垂直平移影像的中心。单位与空间参考系统的单位相同。

Double
max_num_per_mosaic
(可选)

设置给定时间内镶嵌数据集中可显示的栅格数据集的最大数量。

Long
cell_size_tolerance
(可选)

将具有相似空间分辨率的影像视为具有相同的标称分辨率。例如，系数为 0.1 时，对于使用像元大小的工具和操作而言，像元大小相差不足 10% 的所有影像都将被划分为一组。

Double
cell_size
(可选)

使用现有栅格数据集设置镶嵌数据集的像元大小或指定其宽度 (x) 和高度 (y)。如果指定像元大小，可以将单个值用于方形像元大小，或者将 X 值和 Y 值用于矩形像元大小。

Cell Size XY
metadata_level
(可选)

设置发布镶嵌数据集时，从服务器提供给客户端的元数据级别。

  • FULL —传输镶嵌数据集级别应用的处理相关的元数据以及与各个栅格数据集相关的元数据。
  • NONE —不提供任何元数据给客户端。
  • BASIC —传输与各个栅格数据集相关的元数据，如列数和行数、像元大小和空间参考信息。
String
transmission_fields
[transmission_field,...]
(可选)

限制属性表中可供客户查看的字段。默认情况下，列表包括以下各项：

  • 名称
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Tag
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

String
use_time
(可选)

启用镶嵌数据集上的时间动画。如果激活了时间，则需要指定起始和结束字段，以及时间格式。

  • DISABLED —镶嵌数据集将不具有时间感知功能。这是默认设置。
  • ENABLED —镶嵌数据集具有时间感知功能。这样客户就可以使用时间滑块。
Boolean
start_time_field
(可选)

属性表中用于显示起始时间的字段。

String
end_time_field
(可选)

属性表中用于显示结束时间的字段。

String
time_format
(可选)

选择上述所选字段中时间的显示格式。

  • YYYY —年
  • YYYYMM —年和月
  • YYYY/MM —年和月
  • YYYY-MM —年和月
  • YYYYMMDD —年、月和日
  • YYYY/MM/DD —年、月和日
  • YYYY-MM-DD —年、月和日
  • YYYYMMDDhhmmss —年、月、日、小时、分钟和秒
  • YYYY/MM/DD hh:mm:ss —年、月、日、小时、分钟和秒
  • YYYY-MM-DD hh:mm:ss —年、月、日、小时、分钟和秒
  • YYYYMMDDhhmmss.s —年、月、日、小时、分钟、秒和秒的小数位
  • YYYY/MM/DD hh:mm:ss.s —年、月、日、小时、分钟、秒和秒的小数位
  • YYYY-MM-DD hh:mm:ss.s —年、月、日、小时、分钟、秒和秒的小数位
String
geographic_transform
[geographic_transform,...]
(可选)

与此镶嵌数据集相关联的地理变换。

String
max_num_of_download_items
(可选)

限制每个请求可下载的最大栅格数据集数。

Long
max_num_of_records_returned
(可选)

限制每个请求可下载的最大记录数。

Long
data_source_type
(可选)

定义镶嵌数据集内的影像类型。

  • GENERIC —镶嵌数据集没有指定的数据类型。
  • THEMATIC —专题数据具有离散值，例如土地覆被。
  • PROCESSED —镶嵌数据集的颜色已经过调整。
  • ELEVATION —镶嵌数据集包含高程数据。
  • SCIENTIFIC —镶嵌数据集包含科学数据。
  • VECTOR_UV —镶嵌数据集具有两个变量。
  • VECTOR_MAGDIR —镶嵌数据集具有量级和方向。
String
minimum_pixel_contribution
(可选)

设置镶嵌数据集项目至少需要具有多少像素才可视为足够在镶嵌数据集中使用。由于存在重叠影像，可能有某个项目仅显示整个影像的一小部分。跳过这些镶嵌数据集项目将有助于提高镶嵌数据集的性能。

Long
processing_templates
[processing_templates,...]
(可选)

选择想要用于动态处理镶嵌数据集或镶嵌数据集项目的函数链。可以添加、删除函数链或对其进行重新排序。

添加的所有模板名称都要求唯一。

有关函数链使用方法的信息，请参阅编辑函数链模板。

File; String
default_processing_template
(可选)

定义默认的函数链。访问镶嵌数据集时，会应用默认的函数链。

String
time_interval
(可选)

指定用于表示每个时间步长间隔的持续时间。时间步长间隔定义时态数据的间隔长度。时间单位在 time_interval_units 参数中进行。

Double
time_interval_units
(可选)

为您的时间间隔选择合适的单位。

  • None —无时间单位或单位未知。
  • Milliseconds —时间单位为毫秒。
  • Seconds —时间单位为秒。
  • Minutes —时间单位为分钟。
  • Hours —时间单位为小时。
  • Days —时间单位为天。
  • Weeks —时间单位为周。
  • Months —时间单位为月。
  • Years —时间单位为年。
  • Decades —时间单位为十年。
  • Centuries —时间单位为百年。
String
product_definition
(可选)

选择您正在使用的影像类型的特定模板，或选择通用模板。通用选项包含以下标准支持栅格传感器类型：

  • NONE —不为镶嵌数据集指定波段顺序。这是默认设置。
  • NATURAL_COLOR_RGB —使用红色、绿色和蓝色波长范围创建 3 波段镶嵌数据集。该波段组合用于自然色影像。
  • NATURAL_COLOR_RGBI —使用红色、绿色、蓝色和近红外波长范围创建 4 波段镶嵌数据集。
  • VECTOR_FIELD_UV —创建显示两个变量的镶嵌数据集。
  • VECTOR_FIELD_MAGNITUDE_DIRECTION —创建显示量级和方向的镶嵌数据集。
  • FALSE_COLOR_IRG —使用近红外、红色和绿色波长范围创建 3 波段镶嵌数据集。
  • DMCII_3BANDS —使用 DMCii 波长范围创建 3 波段镶嵌数据集。
  • DEIMOS2_4BANDS —使用 Deimos-2 波长范围创建 4 波段镶嵌数据集。
  • DUBAISAT-2_4BANDS —使用 DubaiSat-2 波长范围创建 4 波段镶嵌数据集。
  • FORMOSAT-2_4BANDS —使用 FORMOSAT-2 波长范围创建 4 波段镶嵌数据集。
  • GEOEYE-1_4BANDS —使用 GeoEye-1 波长范围创建 4 波段镶嵌数据集。
  • GF-1 PMS_4BANDS —使用 Gaofen-1 全色多光谱传感器波长范围创建 4 波段镶嵌数据集。
  • GF-1 WFV_4BANDS —使用 Gaofen-1 宽视域传感器波长范围创建 4 波段镶嵌数据集。
  • GF-2 PMS_4BANDS —使用 Gaofen-2 全色多光谱传感器波长范围创建 4 波段镶嵌数据集。
  • GF-4 PMI_4BANDS —使用 Gaofen-4 全色和多光谱波长范围创建 4 波段镶嵌数据集。
  • HJ 1A/1B CCD_4BANDS —使用 Huan Jing-1 CCD 多光谱或高光谱传感器波长范围创建 4 波段镶嵌数据集。
  • IKONOS_4BANDS —使用 IKONOS 波长范围创建 4 波段镶嵌数据集。
  • JILIN-1_3BANDS —使用 Jilin-1 波长范围创建 3 波段镶嵌数据集。
  • KOMPSAT-2_4BANDS —使用 KOMPSAT-2 波长范围创建 4 波段镶嵌数据集。
  • KOMPSAT-3_4BANDS —使用 KOMPSAT-3 波长范围创建 4 波段镶嵌数据集。
  • LANDSAT_6BANDS —使用 Landsat 5 和 7 的 TM 和 ETM+ 传感器的波长范围创建 6 波段镶嵌数据集。
  • LANDSAT_8BANDS —使用 LANDSAT 8 波长范围创建 8 波段镶嵌数据集。
  • LANDSAT_MSS_4BANDS —使用 MSS 传感器的 Landsat 波长范围创建 4 波段镶嵌数据集。
  • PLEIADES-1_4BANDS —使用 PLEIADES-1 波长范围创建 4 波段镶嵌数据集。
  • QUICKBIRD_4BANDS —使用 QuickBird 波长范围创建 4 波段镶嵌数据集。
  • RAPIDEYE_5BANDS —使用 RapidEye 波长范围创建 5 波段镶嵌数据集。
  • SENTINEL2_13BANDS —使用 Sentinel 2 MSI 波长范围创建 13 波段镶嵌数据集。
  • SKYSAT_4BANDS —使用 SkySat-C MSI 波长范围创建 4 波段镶嵌数据集。
  • SPOT-5_4BANDS —使用 SPOT-5 波长范围创建 4 波段镶嵌数据集。
  • SPOT-6_4BANDS —使用 SPOT-6 波长范围创建 4 波段镶嵌数据集。
  • SPOT-7_4BANDS —使用 SPOT-7 波长范围创建 4 波段镶嵌数据集。
  • TH-01_4BANDS —使用 Tian Hui-1 波长范围创建 4 波段镶嵌数据集。
  • WORLDVIEW-2_8BANDS —使用 WorldView-2 波长范围创建 8 波段镶嵌数据集。
  • WORLDVIEW-3_8BANDS —使用 WorldView-3 波长范围创建 8 波段镶嵌数据集。
  • WORLDVIEW-4_4BANDS —使用 WorldView-4 波长范围创建 4 波段镶嵌数据集。
  • ZY1-02C PMS_3BANDS —使用 ZiYuan-1 全色或多光谱波长范围创建 3 波段镶嵌数据集。
  • ZY3-CRESDA_4BANDS —使用 ZiYuan-3 CRESDA 波长范围创建 4 波段镶嵌数据集。
  • ZY3-SASMAC_4BANDS —使用 ZiYuan-3 SASMAC 波长范围创建 4 波段镶嵌数据集。
  • CUSTOM —定义波段数和每个波段的平均波长。
String
product_band_definitions
[Band Name {Wavelength Minimum} {Wavelength Maximum},...]
(可选)

使用 product_definition 产品定义时，通过调整波长范围、更改波段数量或波段顺序和添加新波段来编辑 CUSTOM。

Value Table

派生输出

名称说明数据类型
out_mosaic_dataset

代码示例

SetMosaicDatasetProperties 示例 1（Python 窗口）

这是 SetMosaicDatasetProperties 工具的 Python 示例。

import arcpy
arcpy.SetMosaicDatasetProperties_management(
    "c:/workspace/mdproperties.gdb/md", cell_size="0.2", metadata_level="BASIC", 
    transmission_fields="NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE", 
    use_time="ENABLED", start_time_field="YEARS", end_time_field="YEARE", 
    time_format="YYYYMM", geographic_transform=
    "NAD_1983_HARN_To_WGS_1984_2", max_num_of_download_items="10", 
    max_num_of_records_returned="500", source_type="GENERIC", 
    minimum_pixel_contribution="50", processing_templates="None;C:/Test/NewRFTs/Aspect.rft.xml", 
    default_processing_template="None")
SetMosaicDatasetProperties 示例 2（独立脚本）

这是 SetMosaicDatasetProperties 工具的 Python 脚本示例。

#Set mosaic dataset imagery properties group

import arcpy
arcpy.env.workspace = "C:/Workspace"

arcpy.SetMosaicDatasetProperties_management(
    "mdproperties.gdb/md", "525340", "3909809", "None;JPEG", "JPEG",
    "85", "0.5", "CUBIC", "CLIP", "FOOTPRINTS_MAY_CONTAIN_NODATA",
    "NOT_CLIP", "APPLY", "Base-Top Height;Top-Top Shadow Height",
    "Base-Top Height")

环境

此工具不使用任何地理处理环境。

许可信息

  • ArcGIS Desktop Basic: 否
  • ArcGIS Desktop Standard: 是
  • ArcGIS Desktop Advanced: 是

相关主题