设置镶嵌数据集属性 (Data Management)

许可等级:BasicStandardAdvanced

摘要

设置镶嵌数据集的属性。这些属性大多定义了当显示镶嵌数据集时所使用的默认值,或将其作为影像服务发布时的使用方式。

用法

语法

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})
参数说明数据类型
in_mosaic_dataset

将设置属性的镶嵌数据集。

Mosaic Layer
rows_maximum_imagesize
(可选)

设置镶嵌影像的最大行数,由镶嵌数据集在每次请求时生成。

如果增加请求的最大图像大小的行数或列数,则会增加镶嵌数据集的处理时间。然而,如果要打印大型、高分辨率图时,建议您增大这些数字。如果将这些数字设置得过小,可能会不显示影像。例如,如果将数字更改为 10,则用于显示影像的显示窗口的尺寸将仅为 10 像素或更小。

Long
columns_maximum_imagesize
(可选)

设置镶嵌影像的最大列数,由镶嵌数据集在每次请求时生成。

如果增加请求的最大图像大小的行数或列数,则会增加镶嵌数据集的处理时间。然而,如果要打印大型、高分辨率图时,建议您增大这些数字。如果将这些数字设置得过小,可能会不显示影像。例如,如果将数字更改为 10,则用于显示影像的显示窗口的尺寸将仅为 10 像素或更小。

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

设置镶嵌数据集的“允许的传输压缩”属性,此属性定义用于将镶嵌影像从计算机传输到显示器(或者从服务器到客户端)的压缩方法。

  • 不应用压缩。
  • JPEG将应用 JPEG 压缩。
  • LZW将应用 LZW 压缩。
  • LERC将应用有限错误栅格压缩。
String
default_compression_type
(可选)

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

String
JPEG_quality
(可选)

设置应用 JPEG 压缩时使用的压缩质量。压缩质量的变化范围是 1 到 100。数字较大,意味着图像的质量较高,但压缩比较少。

Long
LERC_Tolerance
(可选)

在使用 LERC 压缩方法时指定 LERC 容差。容差代表适用于每个像素的最大错误值(并非图像的平均值)。该值以镶嵌数据集的单位指定。例如,如果误差为 10 厘米而镶嵌数据集的单位为米,则输入 0.1。

LERC 是一种高效的有损压缩方法,建议用于较大像素深度的数据(如浮点型、32 位、16 位或 12 位数据)。对于浮点数据而言,LERC 比 LZ77 的压缩效果好 5 到 10 倍,压缩速度快 5 到 10 倍。对于整型数据,LERC 也优于 LZ77。

使用整型数据并且指定的错误限制为 0.99 或更低时,LERC 被视为无损压缩。

Double
resampling_type
(可选)

设置用于显示镶嵌影像的默认重采样方法。

  • NEAREST将应用最邻近重采样方法。
  • BILINEAR将应用双线性插值重采样方法。
  • CUBIC将应用三次卷积重采样方法。
  • MAJORITY将应用众数重采样方法。
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,...]
(可选)

选择此镶嵌数据集允许的测量功能。

  • 不可使用任何测量功能。
  • 基本允许计算距离、点、质心和面积。
  • Base-Top Height允许测量底部至顶层高度。要执行底部至顶层高度测量,需要有理多项式系数 (RPC) 信息。
  • Base-Top Shadow Height允许测量底部至顶层阴影高度。要执行底部至顶层阴影高度测量,需要太阳方位角和太阳高程信息。
  • Top-Top Shadow Height允许测量顶部至顶部阴影高度。要执行此测量,需要太阳方位角、太阳高程和有理多项式系数 (RPC) 信息。
  • 3DDEM 可用时,可进行 3D 测量。
String
default_mensuration_capabilities
(可选)

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

String
allowed_mosaic_methods
[allowed_mosaic_method,...]
(可选)

选择镶嵌数据集允许的镶嵌方法。镶嵌影像可根据一组输入栅格创建。镶嵌方法定义如何根据镶嵌数据集中的不同栅格创建镶嵌图像。

  • 根据镶嵌数据集属性表中的顺序 (ObjectID) 对栅格进行排序。
  • 中心根据栅格中心与视图中心的距离对栅格进行排序,与视图中心距离越小,栅格的默认次序越靠前。
  • 西北采用独立于视图的方式对栅格进行排序,中心越靠近西北的栅格显示的位置越靠前。
  • 锁定栅格允许用户根据 ObjectID 锁定单个或多个栅格数据的显示。
  • 按属性根据已定义的元数据属性及其与基值的差对栅格进行排序。
  • 像底点根据像底点位置和视图中心的距离对栅格进行排序。此方法与“最接近中心”方法类似,但不同的是,它对栅格使用像底点,该点可能会偏离中心,尤其是在倾斜的影像中。
  • 视点使用“视点”工具根据用户定义的位置与栅格的像底点位置对栅格进行排序。
  • 接缝线使用预定义的接缝线形状分割栅格,并且可以选择是否沿接边使用羽化功能。在生成接缝线的过程中对排序进行预定义。使用此镶嵌方法时,镶嵌运算符 LAST 无效。
String
default_mosaic_method
(可选)

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

String
order_field
(可选)

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

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

如果您的字段是数值或日期字段,则需要设置排序基础参数。

如果“按属性”不是允许的镶嵌方法,则不需要此参数。

String
order_base
(可选)

根据此值与属性表中“排序字段”其他值之间的差异对影像进行排序。

如果使用“日期”属性,它需要采用下列格式之一:

  • 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将栅格按降序排列。

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

Boolean
mosaic_operator
(可选)

选择用来解析重叠像元要使用的镶嵌运算符。

  • FIRST叠置区域将包含源中所列出的第一个栅格数据集中的像元。
  • LAST叠置区域将包含源中所列出的最后一个栅格数据集中的像元。
  • MIN叠置区域将包含所有叠置像元中的最小像元值。
  • MAX叠置区域将包含所有叠置像元中的最大像元值。
  • MEAN叠置区域将包含所有叠置像元中的平均像元值。
  • BLEND重叠区域是镶嵌影像中沿各栅格数据集边缘重叠的像元值的混合。默认情况下,各栅格的边由轮廓线或接缝线定义。
  • SUM叠置区域是所有叠置像元的所有像元值加在一起得出的总像素值。
String
blend_width
(可选)

以像素为单位定义针对镶嵌运算符指定 BLEDN 时使用的距离(按照显示比例)。

Long
view_point_x
(可选)

定义用于计算显示中心的 x-偏移。此值使用镶嵌数据集空间参考系统的单位计算。

只有为允许的镶嵌方法参数指定视点时才使用此值。

Double
view_point_y
(可选)

定义用于计算显示中心的 y-偏移。此值使用镶嵌数据集空间参考系统的单位计算。

只有为允许的镶嵌方法参数指定视点时才使用此值。

Double
max_num_per_mosaic
(可选)

可用于创建镶嵌影像的最大栅格数。

Long
cell_size_tolerance
(可选)

容差因素必须大于或等于 0.0。

因素为 0.1 表示,对于应用像素(像元)大小的工具和操作,超过最低像素大小 10% 的所有 LowPS 值均相同。

Double
cell_size
(可选)

可选择图层作为像元大小模板,也可指定实际像元大小。如果指定像元大小,可以将单个值用于方形像元大小,或者将 X 值和 Y 值用于矩形像元大小。

Cell Size XY
metadata_level
(可选)

选择发布镶嵌数据集时,从服务器提供给客户端的元数据级别。

  • FULL所有元数据将被传输,包含基本栅格数据集信息及函数链的详细信息。这是默认设置。
  • NONE不提供任何元数据给客户端。
  • BASIC将传输栅格数据集级别信息,比如列和行、像元大小和空间参考信息。
String
transmission_fields
[transmission_field,...]
(可选)

选择用户可以访问的字段。此列表可以包含默认情况下没有添加到镶嵌数据集属性表的字段。默认情况下,此列表包括:

  • 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
(可选)

时间字段的格式。

  • 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镶嵌数据集包含高程数据。
String
minimum_pixel_contribution
(可选)

指定镶嵌数据集项目至少需要具有多少像素才能被认为足够在镶嵌数据集中使用。

此属性允许镶嵌数据集跳过所有像素量不够大的栅格项目。跳过这些镶嵌数据集项目将有助于提高镶嵌数据集的计算或显示性能。这在大量叠置栅格只具有少量像素时尤其有用。

Long

代码实例

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")
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 for Desktop Basic: 否
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014