摘要
定义显示镶嵌数据集和将其作为影像服务提供时的默认设置。
用法
可在镶嵌数据集属性的默认值选项卡中找到当前镶嵌数据集属性。
语法
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})
参数 | 说明 | 数据类型 |
in_mosaic_dataset | 需要设置属性的镶嵌数据集。 | Mosaic Layer |
rows_maximum_imagesize (可选) | 镶嵌影像的最大行数,由镶嵌数据集在每次请求时生成。这有助于控制客户查看影像时服务器必须执行的工作量。如果数字较大,则会创建更大的影像,但同时也会延长处理镶嵌数据集的时间。如果将值设置得过小,影像可能显示不出来。 | Long |
columns_maximum_imagesize (可选) | 镶嵌影像的最大列数,由镶嵌数据集在每次请求时生成。这有助于控制客户查看影像时服务器必须执行的工作量。如果数字较大,则会创建更大的影像,但同时也会延长处理镶嵌数据集的时间。如果将值设置得过小,影像可能显示不出来。 | Long |
allowed_compressions [allowed_compressions,...] (可选) | 定义用于将镶嵌影像从计算机传输到显示器(或者从服务器到客户端)的压缩方法。
| String |
default_compression_type (可选) | 设置默认的压缩类型。默认压缩必须位于 allowed_compressions 列表中或者已经在镶嵌数据集的允许的压缩方法属性中设置。
| String |
JPEG_quality (可选) | 使用 JPEG 时的压缩质量。压缩质量的范围是 1 到 100。数字越大,意味着影像的质量越高,但压缩程度越低。 | Long |
LERC_Tolerance (可选) | 限制使用 LERC 压缩时的每像素错误。该值以镶嵌数据集的单位指定。例如,如果误差为 10 厘米而镶嵌数据集的单位为米,则输入 0.1。 | Double |
resampling_type (可选) | 确定以较小比例显示数据集时计算像素值的方法。根据您拥有的数据类型选择相应的技术。
| String |
clip_to_footprints (可选) | 栅格数据集及其轮廓通常会具有相同的范围。如果范围不同,可将栅格数据集裁剪至轮廓线。
| Boolean |
footprints_may_contain_nodata (可选) | 允许含有 NoData 值的像素。
| Boolean |
clip_to_boundary (可选) | 镶嵌数据集及其边界通常具有相同的范围。如果范围不同,可将镶嵌数据集裁剪到边界。
| Boolean |
color_correction (可选) | 启用镶嵌数据集上的色彩校正。
| Boolean |
allowed_mensuration_capabilities [allowed_mensuration_capability,...] (可选) | 选择查看器可对镶嵌数据集执行的测量。能否执行垂直测量取决于您的影像,并且可能需要 DEM。
| String |
default_mensuration_capabilities (可选) | 选择此镶嵌数据集的默认测量功能。必须在 allowed_mensuration_capabilities 参数列表中设置默认值,或者已在镶嵌数据集的测量功能属性中设置默认值。
| String |
allowed_mosaic_methods [allowed_mosaic_method,...] (可选) | 定义显示重叠影像的规则。
| String |
default_mosaic_method (可选) | 选择此镶嵌数据集的默认镶嵌方法。必须在 allowed_mosaic_methods 参数列表中设置默认值,或者已在镶嵌数据集的允许的镶嵌方法属性中设置默认值。
| String |
order_field (可选) | 在使用 ByAttribute 镶嵌方法排列栅格时,选择要使用的默认字段。根据属性表中类型为元数据并且为整型的字段来定义字段列表。此列表可包括但不限于以下各项:
如果您的字段是数值或日期字段,则需要设置 order_base 参数。 如果 ByAttribute 不是允许的镶嵌方法,则不需要此参数。 | String |
order_base (可选) | 按栅格与 order_field 参数中所选字段的值之间的差异对栅格进行排序。 如果使用“日期”属性,则需要采用下列格式之一:
只有为 allowed_mosaic_method 参数指定了“按属性”时,才需要定义此参数。 | String |
sorting_order (可选) | 选择按升序还是降序排列栅格。
只有为 ByAttribute 参数指定了 allowed_mosaic_method 时,才需要定义此参数。 | Boolean |
mosaic_operator (可选) | 定义重叠像素的解决规则。
| 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 (可选) | 设置发布镶嵌数据集时,从服务器提供给客户端的元数据级别。
| String |
transmission_fields [transmission_field,...] (可选) | 限制属性表中可供客户查看的字段。默认情况下,列表包括以下各项:
| String |
use_time (可选) | 启用镶嵌数据集上的时间动画。如果激活了时间,则需要指定起始和结束字段,以及时间格式。
| Boolean |
start_time_field (可选) | 属性表中用于显示起始时间的字段。 | String |
end_time_field (可选) | 属性表中用于显示结束时间的字段。 | String |
time_format (可选) | 选择上述所选字段中时间的显示格式。
| String |
geographic_transform [geographic_transform,...] (可选) | 与此镶嵌数据集相关联的地理变换。 | String |
max_num_of_download_items (可选) | 限制每个请求可下载的最大栅格数据集数。 | Long |
max_num_of_records_returned (可选) | 限制每个请求可下载的最大记录数。 | Long |
data_source_type (可选) | 定义镶嵌数据集内的影像类型。
| String |
minimum_pixel_contribution (可选) | 设置镶嵌数据集项目至少需要具有多少像素才可视为足够在镶嵌数据集中使用。由于存在重叠影像,可能有某个项目仅显示整个影像的一小部分。跳过这些镶嵌数据集项目将有助于提高镶嵌数据集的性能。 | Long |
processing_templates [processing_templates,...] (可选) | 选择想要用于动态处理镶嵌数据集或镶嵌数据集项目的函数链。可以添加、删除函数链或对其进行重新排序。 添加的所有模板名称都要求唯一。 有关函数链使用方法的信息,请参阅编辑函数链模板。 | File; String |
default_processing_template (可选) | 定义默认的函数链。访问镶嵌数据集时,会应用默认的函数链。 | String |
time_interval (可选) | 指定用于表示每个时间步长间隔的持续时间。时间步长间隔定义时态数据的间隔长度。时间单位在 time_interval_units 参数中进行。 | Double |
time_interval_units (可选) | 为您的时间间隔选择合适的单位。
| String |
代码示例
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: 是