设置镶嵌数据集属性

描述

定义用于显示镶嵌数据集并将其用作影像服务的默认设置。

使用方法

• 当前镶嵌数据集属性位于镶嵌数据集属性对话框的默认值选项卡中。

语法

arcpy.management.SetMosaicDatasetProperties(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_capabilities,...] （可选）	指定将在镶嵌数据集上执行的测量。 执行垂直测量的功能取决于影像，并且可能需要 DEM。 None —不执行测量功能。 Basic —将执行距离、点、质心和面积计算等地面测量。 Base-Top Height —将执行从要素底端到要素顶端的测量。 有理多项式系数必须嵌入影像中。 Base-Top Shadow Height —将执行从要素底端到其阴影顶端的测量。 需要太阳方位角和太阳高度角的信息。 Top-Top Shadow Height —将执行从要素顶端到其阴影顶端的测量。 需要太阳方位角、太阳高度角和有理多项式系数。 3D —如果 DEM 可用，则将在 3D 模式下进行测量。	String
default_mensuration_capabilities （可选）	指定镶嵌数据集的默认测量功能。 必须在 allowed_mensuration_capabilities 参数所用值的列表中设置默认测量值，或在镶嵌数据集的测量功能属性中设置默认测量值。 None —不执行测量功能。 Basic —将执行距离、点、质心和面积计算等地面测量。 Base-Top Height —将执行从要素底端到要素顶端的测量。 有理多项式系数必须嵌入影像中。 Base-Top Shadow Height —将执行从要素底端到其阴影顶端的测量。 需要太阳方位角和太阳高度角的信息。 Top-Top Shadow Height —将执行从要素顶端到其阴影顶端的测量。 需要太阳方位角、太阳高度角和有理多项式系数。 3D —如果 DEM 可用，则将在 3D 模式下进行测量。	String
allowed_mosaic_methods [allowed_mosaic_methods,...] （可选）	指定显示重叠影像的规则。 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 （可选）	使用 default_mosaic_method 参数的 ByAttribute 值排列栅格时要使用的字段。 根据属性表中类型为元数据并且为整型的字段来定义字段列表。 此列表可包括但不限于以下各项： MinPS MaxPS LowPS HighPS CenterX CenterY ZOrder Shape_Length Shape_Area 如果字段是数值或日期字段，则必须设置 order_base 参数。 如果 allowed_mosaic_methods 列表中不包含 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_methods 参数中指定 ByAttribute 值时，需要此参数。	String
sorting_order （可选）	指定将按升序还是降序排序栅格。 ASCENDING —栅格将按升序排序。 这是默认设置。 DESCENDING —栅格将按降序排序。 仅在 allowed_mosaic_methods 参数中指定 ByAttribute 值时，需要此参数。	Boolean
mosaic_operator （可选）	指定将使用的重叠像素的解决规则。 FIRST —将显示属性表中的第一个影像。 LAST —将显示属性表中的最后一个影像。 MIN —将显示最低像素值。 MAX —将显示最高像素值。 MEAN —将使用算术平均值计算平均重叠像素值。 BLEND —将使用距离权重算法计算平均重叠像素值。 SUM —将所有的重叠像素值相加在一起。	String
blend_width （可选）	将应用 mosaic_operator 参数的 BLEND 值的像素数。	Long
view_point_x （可选）	将用于水平平移影像中心的数值。 单位与空间参考系统相同。 仅当 allowed_mosaic_methods 参数设置为 Viewpoint 时，此参数才适用。	Double
view_point_y （可选）	将用于垂直平移影像中心的数值。 单位与空间参考系统相同。 仅当 allowed_mosaic_methods 参数设置为 Viewpoint 时，此参数才适用。	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_fields,...] （可选）	属性表中可供客户查看的字段。 默认情况下，列表包括以下各项： Name 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 （可选）	指定 start_time_field 和 end_time_field 等参数的镶嵌数据集的时间格式。 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 （可选）	指定您正在使用的影像类型的特定模板，或选择通用模板。 通用选项包含以下标准支持栅格传感器类型：	String
product_band_definitions [Band Name {Wavelength Minimum} {Wavelength Maximum},...] （可选）	波长范围、波段数量和波段顺序的定义。 使用 CUSTOM 产品定义来编辑 product_definition 值和添加新波段。	Value Table

派生输出

名称	说明	数据类型
out_mosaic_dataset	已更新的镶嵌数据集。	Mosaic Layer

代码示例

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")

环境

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

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是