设置镶嵌数据集属性 (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})
参数说明数据类型
in_mosaic_dataset

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

Mosaic Layer
rows_maximum_imagesize
(可选)

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

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

Long
columns_maximum_imagesize
(可选)

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

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

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

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

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

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

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_capabilities,...]
(可选)

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

  • Basic允许计算距离、点、质心和面积。
  • 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_methods,...]
(可选)

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

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

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

String
sorting_order
(可选)

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

  • ASCENDING将栅格按升序排列。这是默认设置。
  • DESCENDING将栅格按降序排列。

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

Boolean
mosaic_operator
(可选)

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

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

定义“混合”镶嵌运算符应用的以像素为单位的距离(按照显示比例)。

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不提供任何元数据给客户端。
  • 基本将传输栅格数据集级别信息,比如列和行、像元大小和空间参考信息。
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
(可选)

指定时间字段的格式。

  • 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

代码实例

SetMosaicDatasetProperties 示例 1(Python 窗口)

这是 SetMosaicDatasetProperties 的 Python 示例。

import arcpy
arcpy.SetMosaicDatasetProperties_management("c:/workspace/mdproperties.gdb/md", "", "", "", 
                                   "", "", "", "", "", "", "", "", "", 
                                   "", "", "", "", "", "", "", "", "", 
                                   "", "", "", "0.2", "BASIC", 
                                   "NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE", 
                                   "ENABLED", "YEARS", "YEARE", "YYYYMM", 
                                   "NAD_1983_HARN_To_WGS_1984_2", "10", "500")
SetMosaicDatasetProperties 示例 2(独立脚本)

这是 SetMosaicDatasetProperties 的 Python 脚本示例。

#===========================
#Set Mosaic Dataset Properties
'''Usage: SetMosaicDatasetProperties_management(in_mosaic_dataset, {rows_maximum_imagesize},
                                                {columns_maximum_imagesize}, {None | JPEG | LZ77 | LERC},
                                                {None | JPEG | LZ77 | LERC}, {JPEG_quality},
                                                {LERC_Tolerance}, {BILINEAR | NEAREST |
                                                CUBIC | MAJORITY}, {NOT_CLIP | CLIP},
                                                {FOOTPRINTS_MAY_CONTAIN_NODATA | FOOTPRINTS_DO_NOT_CONTAIN_NODATA},
                                                {CLIP | NOT_CLIP}, {NOT_APPLY | APPLY},
                                                {Basic | Base-Top Height | Base-Top Shadow Height |
                                                Top-Top Shadow Height | 3D}, {Basic | Base-Top Height |
                                                Base-Top Shadow Height | Top-Top Shadow Height | 3D},
                                                {Center | NorthWest | LockRaster | ByAttribute |
                                                Nadir | Viewpoint | Seamline | None}, {Center |
                                                NorthWest | LockRaster | ByAttribute | Nadir |
                                                Viewpoint | Seamline | None}, {Name | MinPS |
                                                MaxPS | LowPS | HighPS | Tag | GroupName |
                                                ProductName | CenterX | CenterY | ZOrder |
                                                SOrder | Shape_Length | Shape_Area}, {order_base},
                                                {ASCENDING | DESCENDING}, {FIRST | LAST | MIN |
                                                MAX | MEAN | BLEND}, {blend_width}, {view_point_x},
                                                {view_point_y}, {max_num_per_mosaic},
                                                {cell_size_tolerance}, {cell_size}, {FULL | NONE | BASIC},
                                                {transmission_fields;transmission_fields...},
                                                {DISABLED | ENABLED}, {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},
                                                {geographic_transform;geographic_transform...},
                                                {max_num_of_download_items}, {max_num_of_records_returned})
'''

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

    #Set mosaic dataset imagery properties group
    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")

    #Set mosaic dataset mosaic properties group
    arcpy.SetMosaicDatasetProperties_management("mdproperties.gdb/md", "", "", "",
                                                "", "", "", "", "", "", "", "", "", "",
                                                "NorthWest;LockRaster;ByAttribute;Seamline",
                                                "ByAttribute", "ZORDER", "3",
                                                "DESCENDING", "BLEND", "10", "200",
                                                "100", "40", "0.2")

    #Set mosaic dataset catalog properties group
    arcpy.SetMosaicDatasetProperties_management("mdproperties.gdb/md", "", "", "", "",
                                                "", "", "", "", "", "", "", "", "",
                                                "", "", "", "", "", "", "", "", "",
                                                "", "", "1", "BASIC", "NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE",
                                                "ENABLED", "YEARS", "YEARE", "YYYYMM",
                                                "NAD_1983_HARN_To_WGS_1984_2", "10", "500")

except:
    print "Set Mosaic Dataset example failed."
    print arcpy.GetMessages()

环境

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

相关主题

许可信息

ArcGIS for Desktop Basic:否
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013