Administrar ráster multidimensional (Multidimensión)

Resumen

Edita un ráster multidimensional agregando o eliminando variables o dimensiones.

Uso

  • Use esta herramienta para editar un ráster multidimensional. Esta herramienta no genera ningún dataset nuevo, sino que modifica el ráster multidimensional. Para crear un dataset, use las herramientas Ráster multidimensional de subconjunto o Copiar ráster antes de editar más con esta herramienta.

  • Los rásteres de destino y de entrada deben tener el Formato de ráster de nube (CRF). En la actualidad no se admite ningún otro formato en esta herramienta. Para convertir un dataset de mosaico multidimensional o una capa ráster multidimensional en un archivo .crf, use la herramienta Copiar ráster, elija CRF como formato de salida y opte por procesar el dataset como multidimensional.

  • El parámetro Administrar modo define el tipo de operación de edición que se realizará. El parámetro admite las siguientes opciones:

    • Agregar dimensión: agregar una dimensión al dataset. Se deben proporcionar el nombre, la descripción y la unidad de la dimensión. Tras agregar la dimensión, es posible incorporar divisiones de otro dataset multidimensional con la misma dimensión.

      Nota:

      Si un dataset CRF de entrada no es un ráster multidimensional, no se puede utilizar la herramienta Administrar ráster multidimensional para crear un ráster multidimensional. En su lugar, utilice la herramienta Establecer propiedades de ráster para crear un ráster multidimensional.

    • Quitar dimensión: quita las dimensiones del dataset. Cada dimensión que se va a eliminar solo puede contener un único valor.
    • Incorporar divisiones: agrega divisiones desde uno o varios rásteres multidimensionales de entrada al final de la pila de divisiones en el ráster multidimensional de destino. Los nombres de dimensión y variable de los rásteres multidimensionales deben coincidir exactamente y no puede haber valores de dimensión superpuestos entre los rásteres. Las divisiones incorporadas deben tener valores de dimensión que sean posteriores al final de los valores de dimensión del ráster multidimensional de destino.
    • Sustituir divisiones: elimina divisiones del ráster multidimensional de destino y las sustituye por divisiones de otro ráster multidimensional. Los nombres de dimensión y variable de los rásteres multidimensionales deben coincidir exactamente y solo se sustituirán las divisiones superpuestas.
    • Incorporar variables: agrega todas las variables desde uno o varios rásteres multidimensionales de entrada al final de la lista de variables en el ráster multidimensional de destino. Si el nombre de la variable ya existe en el ráster multidimensional de destino, no se agregará. Si hay varios rásteres multidimensionales de entrada que contienen una variable con el mismo nombre, la variable del primer ráster de entrada que aparezca se agregará al ráster multidimensional de destino.
    • Eliminar variables: elimina una o varias variables y las divisiones correspondientes del ráster multidimensional de destino. Debe quedar al menos una variable en el ráster multidimensional.

  • Los datos de entrada deben tener exactamente la misma referencia espacial, extensión espacial y tamaño de celda para utilizar las opciones Incorporar divisiones, Sustituir divisiones e Incorporar variables del parámetro Administrar modo.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster multidimensional de destino

El ráster multidimensional en CRF que se va a modificar.

Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
Administrar modo
(Opcional)

Especifica el tipo de modificación que se realizará en el ráster de destino.

  • Agregar dimensiónSe agregará una dimensión al ráster multidimensional de entrada.
  • Incorporar divisionesLas divisiones de los rásteres multidimensionales de entrada se agregarán al final de las divisiones de una dimensión. Esta es la opción predeterminada.
  • Incorporar variablesSe agregarán las variables de los rásteres multidimensionales de entrada.
  • Sustituir divisionesLas divisiones existentes se sustituirán por divisiones de otro ráster multidimensional con valores de dimensión específicos.
  • Eliminar variablesUna o varias variables se eliminarán del ráster multidimensional.
  • Eliminar dimensiónUn ráster multidimensional con una sola división se convertirá en un ráster sin dimensión.
String
Variables
(Opcional)

Las variables que se modificarán en el ráster multidimensional de destino. Este parámetro es obligatorio si la operación que se realiza es una modificación de una variable existente.

Si no se especifica ninguna variable, se modificará la primera variable del ráster multidimensional de destino.

String
Rásteres multidimensionales de entrada
(Opcional)

Los datasets ráster multidimensionales que contienen las divisiones o variables que se agregarán al ráster multidimensional de destino. Este parámetro es obligatorio si el parámetro Administrar modo se define como Incorporar divisiones, Sustituir divisiones o Incorporar variables.

Raster Layer; Image Service
Nombre de dimensión
(Opcional)

Nombre de la dimensión que se agregará o eliminará de las propiedades de ráster. Este parámetro es necesario si el parámetro Administrar modo se ha definido como Agregar dimensión. Si el parámetro Administrar modo se establece en Eliminar dimensión, la dimensión especificada puede contener un valor único solamente. Si el parámetro Nombre de dimensión no se especifica y la entrada solo contiene una división, se eliminarán todas las dimensiones.

String
Valor de dimensión
(Opcional)

El valor de la dimensión que se va a agregar. El valor puede ser un valor único o un rango de valores. Para un rango de valores, proporcione los valores mínimo y máximo separados por una coma. Por ejemplo, para una nueva dimensión de altura, introduzca 0,10 para generar una dimensión en la que la primera división contenga información sobre los primeros 10 metros de altura.

Este parámetro es necesario si el parámetro Administrar modo se ha definido como Agregar dimensión.

String
Descripción de dimensión
(Opcional)

La descripción de la nueva dimensión que se agregará a las propiedades de ráster con fines de metadatos. Este parámetro está activo cuando el parámetro Administrar modo se establece en Agregar dimensión.

String
Unidad de dimensión
(Opcional)

La unidad de la nueva dimensión que se agregará a las propiedades de ráster con fines de metadatos. Este parámetro está activo cuando el parámetro Administrar modo se establece en Agregar dimensión.

String
Actualizar estadística
(Opcional)

Especifica si se recalcularán las estadísticas correspondientes a cada dataset ráster multidimensional.

  • Activado: se recalcularán las estadísticas. Esta es la opción predeterminada.
  • Desactivado: las estadísticas no se recalcularán.
Boolean
Actualizar transposición
(Opcional)

Especifica si se regenerará la transposición de cada dataset ráster multidimensional.

  • Activado: la transposición se regenerará. Si no existe transposición, se generará una transposición nueva. Esta es la opción predeterminada.
  • Desactivado: la transposición no se regenerará.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster multidimensional de destino

El ráster multidimensional modificado.

Raster Layer

arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose})
NombreExplicaciónTipo de datos
target_multidimensional_raster

El ráster multidimensional en CRF que se va a modificar.

Raster Dataset; Mosaic Dataset; Raster Layer; Mosaic Layer; Image Service; File
manage_mode
(Opcional)

Especifica el tipo de modificación que se realizará en el ráster de destino.

  • ADD_DIMENSIONSe agregará una dimensión al ráster multidimensional de entrada.
  • APPEND_SLICESLas divisiones de los rásteres multidimensionales de entrada se agregarán al final de las divisiones de una dimensión. Esta es la opción predeterminada.
  • APPEND_VARIABLESSe agregarán las variables de los rásteres multidimensionales de entrada.
  • REPLACE_SLICESLas divisiones existentes se sustituirán por divisiones de otro ráster multidimensional con valores de dimensión específicos.
  • DELETE_VARIABLESUna o varias variables se eliminarán del ráster multidimensional.
  • REMOVE_DIMENSIONUn ráster multidimensional con una sola división se convertirá en un ráster sin dimensión.
String
variables
[variables,...]
(Opcional)

Las variables que se modificarán en el ráster multidimensional de destino. Este parámetro es obligatorio si la operación que se realiza es una modificación de una variable existente.

Si no se especifica ninguna variable, se modificará la primera variable del ráster multidimensional de destino.

String
in_multidimensional_rasters
[in_multidimensional_rasters,...]
(Opcional)

Los datasets ráster multidimensionales que contienen las divisiones o variables que se agregarán al ráster multidimensional de destino. Este parámetro es obligatorio si el parámetro manage_mode se define como APPEND_SLICES, REPLACE_SLICES o APPEND_VARIABLES.

Raster Layer; Image Service
dimension_name
(Opcional)

Nombre de la dimensión que se agregará o eliminará de las propiedades de ráster. Este parámetro es obligatorio si manage_mode se establece en ADD_DIMENSION. Si el parámetro manage_mode se establece en REMOVE_DIMENSION, la dimensión especificada puede contener un valor único solamente. Si el parámetro dimension_name no se especifica y la entrada solo contiene una división, se eliminarán todas las dimensiones.

String
dimension_value
(Opcional)

El valor de la dimensión que se va a agregar. El valor puede ser un valor único o un rango de valores. Para un rango de valores, proporcione los valores mínimo y máximo separados por una coma. Por ejemplo, para una nueva dimensión de altura, introduzca 0,10 para generar una dimensión en la que la primera división contenga información sobre los primeros 10 metros de altura.

Este parámetro es obligatorio si el parámetro manage_mode se define como ADD_DIMENSION.

String
dimension_description
(Opcional)

La descripción de la nueva dimensión que se agregará a las propiedades de ráster con fines de metadatos. Este parámetro está habilitado cuando el parámetro manage_mode tiene el valor ADD_DIMENSION.

String
dimension_unit
(Opcional)

La unidad de la nueva dimensión que se agregará a las propiedades de ráster con fines de metadatos. Este parámetro está habilitado cuando el parámetro manage_mode se establece en ADD_DIMENSION.

String
update_statistics
(Opcional)

Especifica si se recalcularán las estadísticas correspondientes a cada dataset ráster multidimensional.

  • UPDATE_STATISTICSLas estadísticas se recalcularán. Esta es la opción predeterminada.
  • NO_UPDATE_STATISTICSLas estadísticas no se recalcularán.
Boolean
update_transpose
(Opcional)

Especifica si se regenerará la transposición de cada dataset ráster multidimensional.

  • UPDATE_TRANSPOSELa transposición se regenerará. Si no existe transposición, se generará una transposición nueva. Esta es la opción predeterminada.
  • NO_UPDATE_TRANSPOSELa transposición no se regenerará.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
updated_target_multidimensional_raster

El ráster multidimensional modificado.

Raster Layer

Muestra de código

Ejemplo 1 de ManageMultidimensionalRaster (ventana de Python)

En este ejemplo se incorporan divisiones al final de un ráster multidimensional y se actualizan las estadísticas.

# Import system modules
import arcpy

# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
	"C:/data/temp1980_1990.crf", "APPEND_SLICES", "Temp", 
	["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"],None,
	None,None, None, "UPDATE_STATISTICS")
Ejemplo 2 de ManageMultidimensionalRaster (script independiente)

En este ejemplo se sustituyen divisiones y se agrega una variable y una dimensión al ráster multidimensional de destino.

# Import system modules
import arcpy

# Define input parameters
target_multidimensional_raster = "C:/data/hycom.crf"
manage_mode_replace = "REPLACE_SLICES"
manage_mode_append = "APPEND_VARIABLES"
manage_mode_newDimension = "ADD_DIMENSION"
variables = "water_temp"
replace_multidimensional_rasters = "C:/new_data/new_hycom1985.crf"
salinity_multidimensional_raster = "C:/data/salinity.crf"
dimension_name = "Depth"
dimension_value = "0,5"
dimension_description = "Depth at 5m increments"
dimension_unit = "meter"
update_stats = "UPDATE_STATISTICS"
update_transpose = "UPDATE_TRANSPOSE"


# Replace existing slices with new slices
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster,manage_mode_replace, 
	variables, replace_multidimensional_rasters)

# Append salinity variable
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_append,
	'', salinity_multidimensional_raster)
	
# Add a new dimension, depth, for the water temperature variable
# Depth will be measured in 5 meter increments
arcpy.md.ManageMutidimensionalRaster(target_multidimensional_raster, manage_mode_newDimension,
	variables, None, dimension_name, dimension_value, dimension_description, dimension_unit,
	update_stats, update_transpose)
Ejemplo 3 de ManageMultidimensionalRaster (script independiente)

En este ejemplo se eliminan las dimensiones de un ráster multidimensional con una sola división.

# Import system modules
import arcpy

# Define input parameters
target_multidimensional_raster = "C:/data/precip.crf"
manage_mode = "REMOVE_DIMENSION"

# Remove dimension to make input data dimensionless
arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster,
	manage_mode)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados