ArcGIS Help 10.1 - 设置镶嵌数据集属性 (Data Management)

摘要

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

用法

此工具可用于在地理处理或 Python 环境中设置镶嵌数据集的属性。

语法

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) 信息。 3D —DEM 可用时，可进行 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

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

摘要

用法

语法

代码实例

环境

相关主题

许可信息