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

Sintaxis

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})
ParámetroExplicaciónTipo 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).

  • NONENo se usará ninguna compresión.
  • JPEGSe usará la compresión JPEG.
  • LZWSe usará la compresión LZW.
  • LERCSe utilizará la Compresión de ráster de error limitada.
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.

  • NEARESTSe utiliza el método de remuestreo de vecino más cercano.
  • BILINEARSe utiliza el método de remuestreo de interpolación bilineal.
  • CUBICSe utiliza el método de remuestreo de convolución cúbica.
  • MAJORITYSe utiliza el método de remuestreo de mayoría.
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.

  • NOT_CLIPNo sujetar el ráster a la huella. Esta es la opción predeterminada.
  • CLIPSujetar los rásters a la huella.
Boolean
footprints_may_contain_nodata
(Opcional)

Especifique si las huellas del dataset de mosaico contiene píxeles de NoData.

  • FOOTPRINTS_MAY_CONTAIN_NODATASus huellas contienen píxeles de NoData. Marque esta opción para garantizar que no hay agujeros en el dataset de mosaico. Esta es la opción predeterminada.
  • FOOTPRINTS_DO_NOT_CONTAIN_NODATASus huellas no contienen píxeles de NoData. Si especifica esta configuración, puede tener un pequeño beneficio de rendimiento. Sin embargo, si realmente existen píxeles de NoData en sus huellas, verá los agujeros en el dataset de mosaico.
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.

  • CLIP Sujetar la imagen en mosaico al límite. Esta es la opción predeterminada.
  • NOT_CLIPNo sujetar la imagen en mosaico al límite.
Boolean
color_correction
(Opcional)

Elija si habilitar la corrección de color que se ha establecido para el dataset de mosaico.

  • NOT_APPLYMantener la corrección de color apagada. Esta es la opción predeterminada.
  • APPLYUsar 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.

  • BasicEstán permitidos los cálculos de área, centroide, punto y distancia.
  • Altura base a parte superiorEstán permitidas las mediciones de la altura desde la base a la parte superior. Para realizar las mediciones de la Altura de la base a parte superior, es necesaria la información de coeficientes polinómicos racionales (RPC).
  • Altura de la base a la sombra de la parte superiorEstán permitidas las mediciones de la altura de la base a la sombra de la parte superior. Para realizar las mediciones de la Altura de la base a la sombra de la parte superior, es necesaria la información de elevación del sol y acimut del sol.
  • Altura de la parte superior a la sombra de la parte superiorEstán permitidas las mediciones de la altura de la parte superior a la sombra de la parte superior. Para realizar esta medición, es necesaria la información de acimut del sol, elevación del sol y coeficientes polinómicos racionales (RPC).
  • 3DEstán permitidas las mediciones 3D cuando está disponible un DEM.
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.

  • CentrarPermite ordenar los rásteres sobre la base de un orden predeterminado en el que los rásteres cuyos centros están más cercanos al centro de la vista se colocan al principio.
  • NoroestePermite ordenar los rásteres de una manera independiente de la vista, donde los rásteres con los centros en dirección noroeste se visualizan en la parte superior.
  • LockRasterPermite al usuario bloquear la visualización de uno o varios rásteres de acuerdo con el ObjectID.
  • ByAttributePermite ordenar los rásteres de acuerdo con un atributo de metadatos definido y con su diferencia con un valor base.
  • NadirPermite ordenar los rásteres por la distancia entre la posición del nadir y el centro de la vista. Es parecido al método Más cerca del centro, solo que utiliza el punto de nadir en un ráster, que puede ser diferente al centro, especialmente en imágenes oblicuas.
  • Punto de visualizaciónOrdena los rásteres según una ubicación definida por el usuario y una ubicación nadir para los rásteres con la herramienta Punto de visualización.
  • Línea de uniónCorta los rásteres utilizando la forma de línea de unión predefinida para cada ráster utilizando la difuminación opcional en las uniones. El orden se define previamente durante la generación de la línea de unión. El operador de mosaico ÚLTIMO no es válido con este método de mosaico.
  • NingunoOrdena los rásteres basado en el orden (Id. de objeto) en la tabla de atributos del 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:

  • Nombre
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Etiqueta
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

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:

  • AAAA/MM/DD HH:mm:ss.s
  • AAAA/MM/DD HH:mm:ss
  • AAAA/MM/DD HH:mm
  • AAAA/MM/DD HH
  • AAAA/MM/DD
  • AAAA/MM
  • AAAA

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.

  • ASCENDINGUsar un orden ascendente para sus rásteres. Esta es la configuración predeterminada.
  • DESCENDINGUsar un orden descendente para sus rásteres.

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.

  • FIRSTLas áreas superpuestas contienen las celdas del primer dataset ráster que se enumeró en la fuente.
  • LASTLas áreas superpuestas contienen las celdas del último dataset ráster que se enumeró en la fuente.
  • MINLas áreas superpuestas contienen los valores de celda mínimos de todas las celdas superpuestas.
  • MAXLas áreas superpuestas contienen los valores de celda máximos de todas las celdas superpuestas.
  • MEANLas áreas superpuestas contienen los valores de celda medios de todas las celdas superpuestas.
  • BLENDLas áreas que se superponen serán una mezcla de los valores de celda que se superponen a lo largo del borde de cada dataset de ráster en la imagen en mosaico. Por defecto, el borde lo define la huella o línea de unión de cada ráster.
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.

  • FULLSe transmitirán todos los metadatos, incluyendo la información de dataset ráster básica y los detalles de la cadena de funciones. Esta es la opción predeterminada.
  • NONENo se expondrá ningún metadato al cliente.
  • BASICSe transmitirá el nivel de información de dataset ráster, tal como las columnas y filas, tamaño de celda e información de referencia espacial.
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:

  • Nombre
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Etiqueta
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

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.

  • DISABLEDEl dataset de mosaico no dependerá del tiempo. Esta es la opción predeterminada.
  • ENABLEDEl dataset de mosaico dependerá del tiempo. Esto le permite al cliente usar el Control deslizante del tiempo.
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.

  • AAAAAño
  • AAAAMMAño y mes
  • AAAA/MMAño y mes
  • AAAA-MMAño y mes
  • AAAAMMDDAño, mes y día
  • AAAA/MM/DDAño, mes y día
  • AAAA-MM-DDAño, mes y día
  • AAAAMMDDhhmmssAño, mes, día, hora, minuto y segundos
  • AAAA/MM/DD hh:mm:ssAño, mes, día, hora, minuto y segundos
  • AAAA-MM-DD hh:mm:ssAño, mes, día, hora, minuto y segundos
  • AAAAMMDDhhmmss.sAño, mes, día, hora, minuto y segundos y fracción de segundos
  • AAAA/MM/DD hh:mm:ss.sAño, mes, día, hora, minuto y segundos y fracción de segundos
  • AAAA-MM-DD hh:mm:ss.sAño, mes, día, hora, minuto y segundos y fracción de segundos
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

Ejemplo 1 de SetMosaicDatasetProperties (ventana de Python)

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")
Ejemplo 2 de SetMosaicDatasetProperties (secuencia de comandos independiente)

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Temas relacionados

9/11/2013