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á. Existen seis 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.

      Si el ráster de destino es un archivo de ráster .crf estándar, agregar una dimensión convertirá el destino en un ráster multidimensional y agregará la Información multidimensional en las propiedades de ráster.

    • Eliminar dimensión: eliminar una dimensión del dataset. Si solo hay una dimensión, solo puede haber una división en el dataset.
    • Incorporar divisiones: agregar 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: eliminar divisiones del ráster multidimensional de destino y sustituirlas 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: agregar 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: eliminar 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 la opción Incorporar divisiones, Sustituir divisiones o Incorporar variables.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster multidimensional de destino

El ráster multidimensional en Formato de ráster de nube (.crf) que se debe 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ón —Se agregará una dimensión al ráster multidimensional de entrada.
  • Incorporar divisiones —Las 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 variables —Se agregarán las variables de los rásteres multidimensionales de entrada.
  • Sustituir divisiones —Las divisiones existentes se sustituirán por divisiones de otro ráster multidimensional con valores de dimensión específicos.
  • Eliminar variables —Una o varias variables se eliminarán del ráster multidimensional.
  • Eliminar dimensión —Un 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 Administrar modo se define como Incorporar divisiones, Sustituir divisiones o Incorporar variables.

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

El nombre de la nueva dimensión que se agregará a las propiedades de ráster. Este parámetro es obligatorio si Administrar modo está definido como Agregar dimensión.

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 obligatorio si Administrar modo está 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á activado si Administrar modo está definido como 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á activado si Administrar modo está definido como 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.

Capa ráster

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 Formato de ráster de nube (.crf) que se debe 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 manage_mode se define como APPEND_SLICES, REPLACE_SLICES o APPEND_VARIABLES.

Raster Layer; Image Service
dimension_name
(Opcional)

El nombre de la nueva dimensión que se agregará a las propiedades de ráster. Este parámetro es obligatorio si manage_mode está definido como ADD_DIMENSION.

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 manage_mode está definido 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 si manage_mode está definido como 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 si manage_mode está definido como 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.

Capa ráster

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.ManageMultidimensionalRaster_md(target_multidimensional_raster,
	manage_mode)

Información de licenciamiento

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

Temas relacionados