Establecer las propiedades del dataset de mosaico (Administración de datos)
Resumen
Establece las propiedades de un dataset de mosaico. Varias de estas propiedades definen los valores predeterminados que se usan al visualizar el dataset de mosaico o cómo se puede usar cuando se publica como un servicio de imagen.
Uso
-
Esta herramienta le permite establecer las propiedades del dataset de mosaico dentro de un ambiente de geoprocesamiento o Python.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_mosaic_dataset |
El dataset de mosaico al cual se le establecerán las propiedades. | Mosaic Layer |
rows_maximum_imagesize (Opcional) |
Establezca el número máximo de filas para la imagen a la que se le realizó un mosaico, generada por el dataset de mosaico para cada solicitud. Al aumentar las filas y columnas para el Tamaño máximo de imágenes de solicitudes, estará aumentando el tiempo que toma procesar el mosaico. Sin embargo, quizá desee aumentar estos números si está imprimiendo trazados muy grandes, de alta resolución. Si hace estos números demasiado pequeños, es posible que no se visualice ninguna imagen. Por ejemplo, si cambiara los números a 10, la ventana de visualización podría tener solo 10 píxeles, o menos, para visualizar una imagen. | Long |
columns_maximum_imagesize (Opcional) |
Establezca el número máximo de columnas para la imagen a la que se le realizó un mosaico, generada por el dataset de mosaico para cada solicitud. Al aumentar las filas y columnas para el Tamaño máximo de imágenes de solicitudes, estará aumentando el tiempo que toma procesar el mosaico. Sin embargo, quizá desee aumentar estos números si está imprimiendo trazados muy grandes, de alta resolución. Si hace estos números demasiado pequeños, es posible que no se visualice ninguna imagen. Por ejemplo, si cambiara los números a 10, la ventana de visualización podría tener solo 10 píxeles, o menos, para visualizar una imagen. | Long |
allowed_compressions [allowed_compressions,...] (Opcional) |
Establezca la propiedad Métodos de compresión permitidos del dataset de mosaico, que define el método de compresión utilizado para transmitir la imagen a la cual se le realizó el mosaico de la computadora a la pantalla (o del servidor al cliente).
| String |
default_compression_type (Opcional) |
Establezca el tipo de compresión predeterminado. La compresión predeterminada debe estar en la lista allowed_compressions o ya debe estar establecida en la propiedad Métodos de compresión permitidos en el dataset del mosaico. | String |
JPEG_quality (Opcional) |
Establezca la calidad de compresión que se usará cuando se usa la compresión JPEG. La calidad de compresión puede variar entre 1 y 100. Un número mayor indica una mejor calidad en la imagen pero menos compresión. | Long |
LERC_Tolerance (Opcional) |
Especificar la tolerancia LERC, cuando se utiliza el método de compresión LERC. La tolerancia representa el valor máximo de error que es aplicable por píxel (no un promedio para la imagen). Este valor se especifica en las unidades del dataset de mosaico. Por ejemplo, si el error es 10 centímetros y el dataset de mosaico está en metros, introduzca 0,1. LERC es un método de compresión con pérdida de información eficaz que se recomienda para datos con una gran profundidad de píxel, como datos flotantes de 32 bits, 16 bits o 12 bits. LERC comprime mejor (5 a 10 veces) y más rápido (5 a 10 veces) que LZ77 para datos flotantes, y también es mejor con datos enteros. Cuando se utilizan datos enteros y el error límite especificado es 0,99 o menos, LERC se considera una compresión sin pérdida de información. | Double |
resampling_type (Opcional) |
Establezca el método de remuestreo predeterminado que se utiliza para visualizar la imagen en mosaico.
| String |
clip_to_footprints (Opcional) |
Especifique si desea limitar la extensión de cada ráster a su huella o usar todo el ráster para crear la imagen en mosaico. En muchas ocasiones el ráster y la huella serán la misma, pero cuando son distintas puede especificar si desea recortar el ráster o no.
| Boolean |
footprints_may_contain_nodata (Opcional) | Especifique si las huellas del dataset de mosaico contiene píxeles de NoData.
| Boolean |
clip_to_boundary (Opcional) |
Especifique si desea sujetar la imagen del dataset de mosaico al límite o visualizar toda la imagen en mosaico. Con frecuencia, el límite representará todo el dataset de mosaico; sin embargo, puede modificarlo para que excluya parte del dataset.
| Boolean |
color_correction (Opcional) |
Elija si habilitar la corrección de color que se ha establecido para el dataset de mosaico.
| Boolean |
allowed_mensuration_capabilities [allowed_mensuration_capabilities,...] (Opcional) |
Elija las capacidades de medición permisibles para este dataset de mosaico.
| String |
default_mensuration_capabilities (Opcional) |
Elija la capacidad de medición predeterminada para este dataset de mosaico. El valor predeterminado se debe establecer en la lista de parámetros allowed_mensuration_capabilities o ya debe estar establecido en la propiedad Capacidades de medición del dataset. | String |
allowed_mosaic_methods [allowed_mosaic_methods,...] (Opcional) |
Elija qué métodos de mosaico permitirá este dataset de mosaico. La imagen en mosaico se puede crear a partir de varios rásteres de entrada. El método de mosaico define cómo se crea la imagen en mosaico a partir de diferentes rásteres en el dataset de mosaico.
| String |
default_mosaic_method (Opcional) |
Elija el método de mosaico predeterminado para este dataset de mosaico. El valor predeterminado se debe establecer en la lista de parámetros allowed_mosaic_methods o ya debe estar establecido en la propiedad Métodos de mosaico permitidos. | String |
order_field (Opcional) |
Elija el campo predeterminado a usar al ordenar rásteres usando el método de mosaico Por atributo. La lista de campos incluye aquellos campos en la tabla de atributos que son enteros y del tipo metadatos. Esta lista puede incluir, pero no se limita a:
Si su campo es un campo numérico o de fecha, es necesario fijar el parámetro Orden básico. Este parámetro no es necesario si Por atributo no es un método de mosaico permitido. | String |
order_base (Opcional) |
Las imágenes se ordenan con base en la diferencia entre este valor o los otros valores en el Campo de orden de la tabla de atributos. En el caso de utilizar el atributo Fecha, debería hacerlo con uno de los formatos siguientes:
Este parámetro no es necesario si Por atributo no es un método de mosaico permitido. | String |
sorting_order (Opcional) |
Elija si desea ordenar sus rásteres en orden ascendente o descendente.
Este parámetro no es necesario si Por atributo no es un método de mosaico permitido. | Boolean |
mosaic_operator (Opcional) |
Elija qué operador de mosaico usar para resolver las celdas que se sobreponen.
| String |
blend_width (Opcional) |
Define la distancia en píxeles (en escala de visualización) que usa el operador de Combinación de mosaicos. | Long |
view_point_x (Opcional) | Define un desplazamiento x que se utiliza para calcular en dónde está el centro de la pantalla. Este valor se calcula en la unidad del sistema de referencia espacial del dataset de mosaico. Este valor se usará cuando se utiliza el método de mosaico Más cercano al punto de visualización. | Double |
view_point_y (Opcional) | Define un desplazamiento y, utilizado para calcular en dónde está el centro de la pantalla. Este valor se calcula en la unidad del sistema de referencia espacial del dataset de mosaico. Este valor se usará cuando se utiliza el método de mosaico Más cercano al punto de visualización. | Double |
max_num_per_mosaic (Opcional) |
El número máximo de rásteres que se pueden utilizar para crear la imagen en mosaico. | Long |
cell_size_tolerance (Opcional) |
Especifique el factor de tolerancia del tamaño de celda. El factor de tolerancia debe ser mayor o igual que 0,0. Un factor de 0,1 significa que todos los valores LowPS que sean 10 por ciento mayores que el tamaño de píxel más pequeño se consideran ser el mismo, para herramientas y operaciones que usan tamaños de píxel (celda). | Double |
cell_size (Opcional) | Especifique el tamaño de celda de salida. Puede elegir una capa como la plantilla del tamaño de celda, o puede especificar el tamaño real de la celda. Si especifica el tamaño de celda, puede utilizar un valor único para un tamaño de celda cuadrado, o los valores X e Y para un tamaño de celda rectangular. | Cell Size XY |
metadata_level (Opcional) |
Elija el nivel de metadatos a exponer desde el servidor al cliente al publicar el dataset de mosaico.
| String |
transmission_fields [transmission_fields,...] (Opcional) |
Elija los campos a los que los usuarios pueden obtener acceso. Esta lista puede incluir campos que no se agregan por predeterminación a la tabla de atributos del dataset de mosaico. Por predeterminación, la lista incluye:
| String |
use_time (Opcional) |
Especifique si desea que el dataset de mosaico sea dependiente del tiempo. Si se activa el tiempo, entonces debe especificar los campos de inicio y final y el formato de hora.
| Boolean |
start_time_field (Opcional) |
Especifique el campo en la tabla de atributo a usar como el tiempo de inicio. | String |
end_time_field (Opcional) |
Especifique el campo en la tabla de atributo a usar como el tiempo de finalización. | String |
time_format (Opcional) |
Especifique el formato del campo de tiempo.
| String |
geographic_transform [geographic_transform,...] (Opcional) |
Elija qué transformaciones geográficas están asociadas al dataset de mosaico. | String |
max_num_of_download_items (Opcional) |
Elija la cantidad máxima de elementos que se pueden descargar por solicitud. | Long |
max_num_of_records_returned (Opcional) |
Elija la cantidad máxima de registros devueltos por solicitud. | Long |
Ejemplo de código
Esta es una muestra de Python para SetMosaicDatasetProperties.
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")
Esta es una muestra de la secuencia de comandos de Python para SetMosaicDatasetProperties.
#===========================
#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()