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 puede utilizar esta herramienta 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.
  • Truncar valores de dimensión: modifica los valores de dimensión truncando los valores de fecha o seleccionando los valores de inicio y finalización si los valores de dimensión son rangos.
  • Eliminar divisiones: elimina una división o un rango de divisiones de un ráster multidimensional.

• El parámetro Unidad de truncamiento especifica la unidad de truncamiento de fecha y hora que se utilizará. Este parámetro es necesario si el parámetro manage_mode está configurado en TRUNCATE_DIMENSION_VALUES y el parámetro Nombre de dimensión está configurado en StdTime.

• El parámetro Unidad de truncamiento tiene las siguientes opciones para truncar valores de fecha: Año, Mes, Día, Hora, Minuto y Segundo. Por ejemplo, si el valor de la dimensión de tiempo es 2013-03-19T12:30:00, la opción Hora truncará los valores posteriores a la hora, lo que resultará en un valor de dimensión de 2013-03-19T12:00:00. Si se usa la opción Mes, el valor de dimensión será 2013-03-01T00:00:00. Este parámetro solo es aplicable cuando el valor del parámetro Nombre de dimensión se basa en el tiempo.

• Todos 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.

• Eliminar divisiones de un CRF implica costosas operaciones de archivo. El rendimiento de la eliminación de divisiones de un CRF almacenado en la nube puede verse afectado.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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ó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. Truncar valores de dimensión—Los valores de dimensión se modificarán truncando los valores de fecha o seleccionando los valores de inicio y finalización si los valores de dimensión son rangos. Eliminar divisiones—Se eliminará una división, o un rango de divisiones, del ráster multidimensional de entrada.	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 Dataset; Raster Layer; Image Service
Nombre de dimensión (Opcional)	El 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 configurado en Agregar dimensión, Truncar valores de dimensión o Eliminar divisiones. Si el parámetro Administrar modo se establece en Eliminar dimensión, la dimensión especificada puede contener un valor único solamente. Si no se especifica ningún valor para este parámetro y la entrada solo contiene una única división, se eliminarán todas las dimensiones.	String
Valor de dimensión (Opcional)	El valor de la dimensión que se agregará o eliminará. 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 cuando el parámetro Administrar modo está establecido en Agregar dimensión o Eliminar divisiones y el parámetro Definición de dimensión está establecido en Por valores. Si el parámetro Administrar modo está establecido en Eliminar divisiones, el valor debe ser un valor único.	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
Unidad de truncamiento (Opcional)	Especifica la unidad de truncamiento de fecha y hora que se utilizará. Este parámetro es necesario si el parámetro Administrar modo está configurado en Truncar valores de dimensión y el parámetro Nombre de dimensión está configurado en StdTime. Segundo—La unidad de tiempo de truncamiento especificada será segundos. Minuto—La unidad de tiempo de truncamiento especificada será minutos. Hora—La unidad de tiempo de truncamiento especificada será horas. Día—La unidad de tiempo de truncamiento especificada será días. Mes—La unidad de tiempo de truncamiento especificada será meses. Año—La unidad de tiempo de truncamiento especificada será años.	String
Palabra clave de inicio/final (Opcional)	Especifica cómo se truncarán los valores de las dimensiones. Este parámetro está activo cuando el parámetro Administrar modo se establece en Truncar valores de dimensión. Arranque—El valor de dimensión se truncará en el valor inicial. Fin—El valor de dimensión se truncará en el valor final. Ambos—El valor de dimensión se truncará tanto en el valor inicial como en el final.	String
Definición de dimensión (Opcional)	Especifica cómo se dividirá la dimensión. Por valores—La dimensión se dividirá mediante una lista de valores de dimensión. Esta es la opción predeterminada. Por rangos—La dimensión se dividirá mediante un rango.	String
Valor mínimo (Opcional)	El valor mínimo del rango de divisiones que se eliminarán. Este parámetro está activo si el parámetro Definición de dimensión tiene el valor Por rangos.	String
Valor Máximo (Opcional)	El valor máximo del rango de divisiones que se eliminarán. Este parámetro está activo si el parámetro Definición de dimensión tiene el valor Por rangos.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Ráster multidimensional de destino	El ráster multidimensional modificado.	Raster Layer

Python

arcpy.md.ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit}, {update_statistics}, {update_transpose}, {truncation_unit}, {startEnd_keyword}, {dimension_def}, {min_value}, {max_value})

Nombre	Explicación	Tipo 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_DIMENSION—Se agregará una dimensión al ráster multidimensional de entrada. APPEND_SLICES—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. APPEND_VARIABLES—Se agregarán las variables de los rásteres multidimensionales de entrada. REPLACE_SLICES—Las divisiones existentes se sustituirán por divisiones de otro ráster multidimensional con valores de dimensión específicos. DELETE_VARIABLES—Una o varias variables se eliminarán del ráster multidimensional. REMOVE_DIMENSION—Un ráster multidimensional con una sola división se convertirá en un ráster sin dimensión. TRUNCATE_DIMENSION_VALUES—Los valores de dimensión se modificarán truncando los valores de fecha o seleccionando los valores de inicio y finalización si los valores de dimensión son rangos. REMOVE_SLICES—Se eliminará una división, o un rango de divisiones, del ráster multidimensional de entrada.	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 Dataset; Raster Layer; Image Service
dimension_name (Opcional)	El nombre de la dimensión que se agregará o eliminará de las propiedades de ráster. Este parámetro es obligatorio si el parámetro manage_mode se define como ADD_DIMENSION, TRUNCATE_DIMENSION_VALUES o REMOVE_SLICES. Si el parámetro manage_mode se establece en REMOVE_DIMENSION, la dimensión especificada puede contener un valor único solamente. Si no se especifica ningún valor para este parámetro y la entrada solo contiene una única división, se eliminarán todas las dimensiones.	String
dimension_value (Opcional)	El valor de la dimensión que se agregará o eliminará. 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 cuando el parámetro manage_mode se establece en ADD_DIMENSION o REMOVE_SLICES cuando el parámetro dimension_def se establece en BY_VALUES. Si el parámetro manage_mode se establece en REMOVE_SLICES, el valor debe ser un valor único.	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_STATISTICS—Las estadísticas se recalcularán. Esta es la opción predeterminada. NO_UPDATE_STATISTICS—Las estadísticas no se recalcularán.	Boolean
update_transpose (Opcional)	Especifica si se regenerará la transposición de cada dataset ráster multidimensional. UPDATE_TRANSPOSE—La transposición se regenerará. Si no existe transposición, se generará una transposición nueva. Esta es la opción predeterminada. NO_UPDATE_TRANSPOSE—La transposición no se regenerará.	Boolean
truncation_unit (Opcional)	Especifica la unidad de truncamiento de fecha y hora que se utilizará. Este parámetro es obligatorio si el parámetro manage_mode se define como TRUNCATE_DIMENSION_VALUES y el parámetro dimension_name se define como STDTIME. SECOND—La unidad de tiempo de truncamiento especificada será segundos. MINUTE—La unidad de tiempo de truncamiento especificada será minutos. HOUR—La unidad de tiempo de truncamiento especificada será horas. DAY—La unidad de tiempo de truncamiento especificada será días. MONTH—La unidad de tiempo de truncamiento especificada será meses. YEAR—La unidad de tiempo de truncamiento especificada será años.	String
startEnd_keyword (Opcional)	Especifica cómo se truncarán los valores de las dimensiones. Este parámetro se activa cuando el parámetro manage_mode se establece en TRUNCATE_DIMENSION_VALUES. START—El valor de dimensión se truncará en el valor inicial. END—El valor de dimensión se truncará en el valor final. BOTH—El valor de dimensión se truncará tanto en el valor inicial como en el final.	String
dimension_def (Opcional)	Especifica cómo se dividirá la dimensión. BY_VALUES—La dimensión se dividirá mediante una lista de valores de dimensión. Esta es la opción predeterminada. BY_RANGES—La dimensión se dividirá mediante un rango.	String
min_value (Opcional)	El valor mínimo del rango de divisiones que se eliminarán. Este parámetro se activa cuando el parámetro dimension_def se establece en BY_RANGES.	String
max_value (Opcional)	El valor máximo del rango de divisiones que se eliminarán. Este parámetro se activa cuando el parámetro dimension_def se establece en BY_RANGES.	String

Salida derivada

Nombre	Explicación	Tipo 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)

Entornos

Factor de procesamiento en paralelo

Información de licenciamiento

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