Resumen
Edita un ráster multidimensional agregando o eliminando variables o dimensiones.
Uso
Use esta herramienta para editar un ráster multidimensional. 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 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.
- 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.
Los datos de entrada deben tener justo la misma referencia espacial, extensión espacial y tamaño de celda para utilizar Incorporar divisiones, Sustituir divisiones o Incorporar variables.
Sintaxis
ManageMultidimensionalRaster(target_multidimensional_raster, {manage_mode}, {variables}, {in_multidimensional_rasters}, {dimension_name}, {dimension_value}, {dimension_description}, {dimension_unit})| Parámetro | Explicación | Tipo de datos |
target_multidimensional_raster | El ráster multidimensional que se va a modificar. | Raster Dataset; Raster Layer |
manage_mode (Opcional) | Especifica el tipo de modificación que se realizará en el ráster de destino.
| 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 |
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 |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| updated_target_multidimensional_raster | El ráster multidimensional modificado. | Capa ráster |
Muestra de código
En este ejemplo se incorporan divisiones al final de un ráster multidimensional.
# Import system modules
import arcpy
# Append slices from two multidimensional rasters with temperature data
arcpy.md.ManageMutidimensionalRaster(
target = "C:/data/temp1980_1990.crf", manage_mode = "APPEND_SLICES",
variables = "Temp", in_multidimensional_rasters =
["C:/new_data/temp1991.crf", "C:/new_data/temp1992.crf"])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"
# 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)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.ManageMutidimensionalRaster_md(target_multidimensional_raster,
manage_mode)Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí