Generar una memoria caché para elementos de un dataset de mosaico (Administración de datos)

Resumen

Inserta la función Ráster almacenado en caché como paso final en todas las cadenas de funciones dentro de un dataset de mosaico.

Uso

  • La función Ráster almacenado en caché se inserta en la parte superior de cada cadena de funciones; por lo tanto, es la última función implementada en la cadena.

  • Si no activa el parámetro Generar caché (generate_cache establecido en GENERATE_CACHE en Python) para generar la caché, puede utilizar la herramienta Sincronizar dataset de mosaico para generar la caché.

  • La caché no se mueve con el dataset de mosaico cuando este se comparte (publica) en el servidor. Si va a crear la caché para un dataset de mosaico que se publicará como un servicio de imágenes, puede que desee ejecutar esta herramienta en el dataset de mosaico después de que se haya compartido. Además, asegúrese de que la ruta de la caché sea accesible para el servidor. Si crea la caché antes de publicar el dataset de mosaico, puede mover la caché al servidor y actualizar la ruta de la caché almacenada en el dataset de mosaico.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de mosaico

El dataset de mosaico en el que desea aplicar la función de caché.

Mosaic Layer
Definición de consulta
(Opcional)

Expresión SQL para seleccionar datasets ráster específicos en el dataset de mosaico en el que desea crear la caché de elementos.

SQL Expression
Definir caché
(Opcional)

Activar edición en las propiedades de Caché

  • Activado: se agrega la función Ráster almacenado en caché a los elementos seleccionados. Si un elemento ya tiene esta función, no se agregará otra. Esta es la opción predeterminada.
  • Desactivada: no se definirá ninguna caché de ráster.
Boolean
Generar Caché
(Opcional)

Elija generar los archivos de caché según las propiedades definidas en la función Ráster almacenado en memoria caché, como, por ejemplo, la ubicación y la compresión de la memoria caché.

  • Activada: se generará la caché. Esta es la opción predeterminada.
  • Desactivada: no se generará la caché.
Boolean
Ruta de caché
(Opcional)

Elija sobrescribir la ubicación predeterminada para guardar la caché. Si el dataset de mosaico está incluido en una geodatabase de archivos, de forma predeterminada la caché se guarda en una carpeta con el mismo nombre que la geodatabase y la extensión .cache. Si el dataset de mosaico está incluido en una geodatabase corporativa, de forma predeterminada la caché se guardará dentro de esa geodatabase. Una vez creada, la caché siempre se guardará en la misma ubicación. Si desea guardar la caché en otra ubicación, primero debe utilizar la herramienta Reparar dataset de mosaico para especificar una ubicación nueva y ejecutar de nuevo esta herramienta.

Una vez que se crea una caché para elementos, volver a generar una caché de elementos en una ubicación diferente no es posible especificando una ruta de caché distinta y volviendo a ejecutar esta herramienta. La caché para elementos se seguirá generando en la ubicación donde se generó la primera vez. Sin embargo, puede quitar esta función e insertar una nueva con la nueva ruta o utilizar la herramienta Reparar dataset de mosaico para modificar la ruta de la caché y ejecutar esta herramienta para generar la caché para elementos en una ubicación diferente.

Workspace
Método de compresión
(Opcional)

Elija cómo desea comprimir los datos para transmitirlos más rápidamente.

  • LOSSLESS Mantiene los valores de cada píxel al generar la caché. La compresión sin pérdida de información tiene una ratio aproximado de 2:1.
  • LOSSY Esta opción es adecuada cuando las imágenes solo se utilizan como telón de fondo. La compresión con pérdida de información tiene el ratio más elevado (20:1), pero agrupa valores de píxeles similares para conseguir una compresión más elevada.
  • NONE No se comprimen imágenes. Con esta opción las imágenes se transmitirán más lentamente, pero se dibujarán más rápido porque no es necesario descomprimirlas al visualizarlas.
String
Calidad de compresión
(Opcional)

Establecer una calidad de compresión cuando se utiliza el método de compresión con pérdida de información. El valor de la calidad de compresión está entre el 1 y el 100 por cien, donde el valor 100 corresponde a la menor compresión.

Long
Cantidad máxima de filas permitidas
(Opcional)

Limita el tamaño del dataset de la caché por el número de filas. Si el valor es superior al número de filas del dataset, no se generará la caché.

Long
Cantidad máxima de columnas permitidas
(Opcional)

Limita el tamaño del dataset de la caché por el número de columnas. Si el valor es superior al número de columnas del dataset, no se generará la caché.

Long
Tipo tamaño de solicitud
(Opcional)

Puede remuestrear la caché siguiendo uno de estos dos métodos:

  • PIXEL_SIZE_FACTOR Permite establecer un factor de escala en relación con el tamaño de píxel. Si no desea volver a muestrear la caché, elija Factor de tamaño de píxel y establezca el parámetro Tamaño de solicitud en 1.
  • PIXEL_SIZE Permite especificar un tamaño de píxel para el ráster almacenado en caché.
String
Solicitar tamaño
(Opcional)

Defina un valor para aplicarlo al Tipo tamaño de solicitud.

Double

Salida derivada

EtiquetaExplicaciónTipo de datos
Dataset de mosaico actualizado

El dataset de mosaico actualizado.

Capa de mosaico

arcpy.management.BuildMosaicDatasetItemCache(in_mosaic_dataset, {where_clause}, {define_cache}, {generate_cache}, {item_cache_folder}, {compression_method}, {compression_quality}, {max_allowed_rows}, {max_allowed_columns}, {request_size_type}, {request_size})
NombreExplicaciónTipo de datos
in_mosaic_dataset

El dataset de mosaico en el que desea aplicar la función de caché.

Mosaic Layer
where_clause
(Opcional)

Expresión SQL para seleccionar datasets ráster específicos en el dataset de mosaico en el que desea crear la caché de elementos.

SQL Expression
define_cache
(Opcional)

Elija definir la caché del dataset de mosaico. Una función Ráster almacenado en caché se insertará en los elementos seleccionados. Si un elemento ya tiene una función Ráster almacenado en caché, no se podrá agregar otra.

  • DEFINE_CACHESe agregará la función Ráster almacenado en caché a los elementos seleccionados. Si un elemento ya tiene esta función, no se agregará otra. Esta es la opción predeterminada.
  • NO_DEFINE_CACHENo se definirá ninguna caché de ráster.
Boolean
generate_cache
(Opcional)

Elija generar los archivos de caché según las propiedades definidas en la función Ráster almacenado en memoria caché, como, por ejemplo, la ubicación y la compresión de la memoria caché.

  • GENERATE_CACHESe generará la caché. Esta es la opción predeterminada.
  • NO_GENERATE_CACHENo se generará la caché.
Boolean
item_cache_folder
(Opcional)

Elija sobrescribir la ubicación predeterminada para guardar la caché. Si el dataset de mosaico está incluido en una geodatabase de archivos, de forma predeterminada la caché se guarda en una carpeta con el mismo nombre que la geodatabase y la extensión .cache. Si el dataset de mosaico está incluido en una geodatabase corporativa, de forma predeterminada la caché se guardará dentro de esa geodatabase. Una vez creada, la caché siempre se guardará en la misma ubicación. Si desea guardar la caché en otra ubicación, primero debe utilizar la herramienta Reparar dataset de mosaico para especificar una ubicación nueva y ejecutar de nuevo esta herramienta.

Una vez que se crea una caché para elementos, volver a generar una caché de elementos en una ubicación diferente no es posible especificando una ruta de caché distinta y volviendo a ejecutar esta herramienta. La caché para elementos se seguirá generando en la ubicación donde se generó la primera vez. Sin embargo, puede quitar esta función e insertar una nueva con la nueva ruta o utilizar la herramienta Reparar dataset de mosaico para modificar la ruta de la caché y ejecutar esta herramienta para generar la caché para elementos en una ubicación diferente.

Workspace
compression_method
(Opcional)

Elija cómo desea comprimir los datos para transmitirlos más rápidamente.

  • LOSSLESS Mantiene los valores de cada píxel al generar la caché. La compresión sin pérdida de información tiene una ratio aproximado de 2:1.
  • LOSSY Esta opción es adecuada cuando las imágenes solo se utilizan como telón de fondo. La compresión con pérdida de información tiene el ratio más elevado (20:1), pero agrupa valores de píxeles similares para conseguir una compresión más elevada.
  • NONE No se comprimen imágenes. Con esta opción las imágenes se transmitirán más lentamente, pero se dibujarán más rápido porque no es necesario descomprimirlas al visualizarlas.
String
compression_quality
(Opcional)

Establecer una calidad de compresión cuando se utiliza el método de compresión con pérdida de información. El valor de la calidad de compresión está entre el 1 y el 100 por cien, donde el valor 100 corresponde a la menor compresión.

Long
max_allowed_rows
(Opcional)

Limita el tamaño del dataset de la caché por el número de filas. Si el valor es superior al número de filas del dataset, no se generará la caché.

Long
max_allowed_columns
(Opcional)

Limita el tamaño del dataset de la caché por el número de columnas. Si el valor es superior al número de columnas del dataset, no se generará la caché.

Long
request_size_type
(Opcional)

Puede remuestrear la caché siguiendo uno de estos dos métodos:

  • PIXEL_SIZE_FACTOR Permite establecer un factor de escala en relación con el tamaño de píxel. Si no desea volver a muestrear la caché, elija PIXEL_SIZE_FACTOR y establezca el parámetro request_size en 1.
  • PIXEL_SIZE Permite especificar un tamaño de píxel para el ráster almacenado en caché.
String
request_size
(Opcional)

Defina un valor para aplicarlo al request_size_type.

Double

Salida derivada

NombreExplicaciónTipo de datos
out_mosaic_dataset

El dataset de mosaico actualizado.

Capa de mosaico

Muestra de código

Ejemplo 1 de BuildMosaicDatasetItemCache (ventana de Python)

Esta es una muestra de Python para BuildMosaicDatasetItemCache.

import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
     "C:/Workspace/itemcache.gdb/md",  "#", "DEFINE_CACHE", 
     "NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY", 
     "80", "#", "#")
Ejemplo 2 de BuildMosaicDatasetItemCache (ventana independiente)

Esta es una muestra de script de Python para BuildMosaicDatasetItemCache.

#Define mosaic dataset item cache without generating the cache file

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

mdname = "itemcache.gdb/md"
query = "#"
definecache = "DEFINE_CACHE"
generatecache = "NO_GENERATE_CACHE"
cachepath = "C:/workspace/itemcache"
compression = "LOSSY"
compquality = "80"
maxrow = "#"
maxcolumn = "#"

arcpy.BuildMosaicDatasetItemCache_management(
     mdname, query, definecache, generatecache, cachepath, compression, 
     compquality, maxrow, maxcolumn)