Crear capa ráster multidimensional (Multidimensional)

Resumen

Crea una capa ráster a partir de un dataset ráster multidimensional o una capa ráster multidimensional dividiendo los datos en variables y dimensiones definidas.

Uso

  • Esta herramienta crea una capa ráster multidimensional a partir de un dataset de mosaico o ráster multidimensional extrayendo un subconjunto de variables. Por ejemplo, tiene un dataset de mosaico con 30 años de datos de precipitaciones mensuales, y solo desea extraer datos de cada enero para ver cómo han cambiado las precipitaciones ese mes.

  • Entre los datasets ráster multidimensionales admitidos se incluyen los archivos de formato ráster de nube (CRF), datasets de mosaico multidimensionales o capas ráster multidimensionales generados por archivos de formato netCDF, GRIB o HDF.

  • Esta herramienta genera una capa temporal que no se conservará a menos que se guarde en el disco.

  • Use el parámetro Definición de dimensión para dividir las dimensiones por un intervalo, un valor o un rango de valores. Por ejemplo, si cuenta con 10 años de datos de salinidad del océano que se han recopilado mensualmente y a cada 2 metros de profundidad hasta llegar a los 500 metros, puede usar las distintas opciones de definición de dimensión en los siguientes escenarios:

    • Extraer los datos de salinidad para el mes de enero durante el período de 10 años. Elija Por valores, cambie Dimensión a StdTime y cambie Valores a Enero.
    • Dividir los datos de salinidad en un rango de profundidad de 0 a 150 metros. Elija Por rangos, cambie Dimensión a StdZ y cambie Valor mínimo a -150 y Valor máximo a 0.
    • Extraer los datos de salinidad de los primeros 10 días de enero durante un periodo de 10 años. Elija Por iteración, cambie Dimensión a StdTime, cambie Inicio de la primera iteración y Fin de la primera iteración para el inicio y el fin correspondientes del periodo de iteración, cambie Paso a 1 y cambie Unidad a Años.

  • Para crear una capa que no sea multidimensional con datos de una única porción del ráster multidimensional, elija Por valores para el parámetro Definición de dimensión, seleccione un único valor de dimensión y active el parámetro Sin dimensión.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster multidimensional de entrada

El dataset ráster multidimensional de entrada.

Las entradas admitidas son archivos netCDF, GRIB, HDF, CRF y Zarr, un dataset de mosaico multidimensional, un servicio de imágenes multidimensional, una URL de OPeNDAP o una capa ráster multidimensional.

Nota:

Un archivo Zarr debe tener la extensión .zarr y un archivo .zgroup en la carpeta.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Capa ráster multidimensional de salida

La capa ráster multidimensional de salida.

Raster Layer
Variables
(Opcional)

Las variables que se incluirán en la capa ráster multidimensional de salida. Si no se especifica ninguna variable, se utilizará la primera variable.

String
Definición de dimensión
(Opcional)

Especifica el método que se utilizará para dividir la dimensión.

  • TodoSe utilizará el rango completo para cada dimensión. Esta es la opción predeterminada.
  • Por rangosLa dimensión se dividirá mediante un rango o una lista de rangos.
  • Por iteraciónLa dimensión se dividirá a lo largo de un tamaño de intervalo especificado.
  • Por valoresLa dimensión se dividirá mediante una lista de valores de dimensión.
String
Rango
(Opcional)

El rango o la lista de rangos para la dimensión especificada.

Los datos se dividirán en función del nombre de la dimensión y los valores mínimo y máximo del rango. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por rangos.

Value Table
Valores
(Opcional)

Una lista de valores para la dimensión especificada. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por valores.

Value Table
Dimensión
(Opcional)

La dimensión a lo largo de la cual se dividirán las variables. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por iteración.

String
Inicio de la primera iteración
(Opcional)

El inicio del primer intervalo. Este intervalo se utilizará para iterar por el dataset. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por iteración.

String
Final de la primera iteración
(Opcional)

El final del primer intervalo. Este intervalo se utilizará para iterar por el dataset. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por iteración.

String
Paso
(Opcional)

La frecuencia por la que se dividirán los datos. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por iteración.

Double
Unidad
(Opcional)

Especifica la unidad de iteración que se utilizará. Este parámetro es necesario si el parámetro Definición de dimensión tiene el valor Por iteración y el parámetro Dimensión tiene el valor StdTime.

  • HorasSe usarán las horas como unidad de tiempo especificada.
  • DíasSe usarán los días como unidad de tiempo especificada.
  • SemanasSe usarán las semanas como unidad de tiempo especificada.
  • MesesSe usarán los meses como unidad de tiempo especificada.
  • AñosSe usarán los años como unidad de tiempo especificada.
String
Extensión
(Opcional)

La extensión (cuadro de delimitación) de la capa. Elija la opción de Extensión adecuada para la capa.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de dibujo Draw Extent: la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.
    Nota:

    Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

    Nota:

    Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.

    Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasArea from Selected Features: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Area from Selected Features y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Portapapeles Pegar: la extensión puede copiarse y pegarse desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Usar Pegar extensión Pegar: pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
    Nota:

    Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.
    Precaución:

    El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent
Sin dimensión
(Opcional)

Especifica si la capa tendrá valores de dimensión. Este parámetro solo está activo si se selecciona una única porción para crear una capa.

  • Activado: la capa no tendrá valores de dimensión.
  • Desactivado: la capa tendrá valores de dimensión. Esta es la opción predeterminada.

Boolean
Referencia espacial
(Opcional)

Sistema de coordenadas del valor del parámetro Capa ráster multidimensional de salida. Este parámetro solo se aplica cuando el valor del parámetro Ráster multidimensional de entrada tiene el formato Zarr. Utilice este parámetro para definir la referencia espacial si falta en los datos.

Coordinate System

arcpy.management.MakeMultidimensionalRasterLayer(in_multidimensional_raster, out_multidimensional_raster_layer, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit}, {template}, {dimensionless}, {spatial_reference})
NombreExplicaciónTipo de datos
in_multidimensional_raster

El dataset ráster multidimensional de entrada.

Las entradas admitidas son archivos netCDF, GRIB, HDF, CRF y Zarr, un dataset de mosaico multidimensional, un servicio de imágenes multidimensional, una URL de OPeNDAP o una capa ráster multidimensional.

Nota:

Un archivo Zarr debe tener la extensión .zarr y un archivo .zgroup en la carpeta.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
out_multidimensional_raster_layer

La capa ráster multidimensional de salida.

Raster Layer
variables
[variables,...]
(Opcional)

Las variables que se incluirán en la capa ráster multidimensional de salida. Si no se especifica ninguna variable, se utilizará la primera variable.

String
dimension_def
(Opcional)

Especifica el método que se utilizará para dividir la dimensión.

  • ALLSe utilizará el rango completo para cada dimensión. Esta es la opción predeterminada.
  • BY_RANGESLa dimensión se dividirá mediante un rango o una lista de rangos.
  • BY_ITERATIONLa dimensión se dividirá a lo largo de un tamaño de intervalo especificado.
  • BY_VALUELa dimensión se dividirá mediante una lista de valores de dimensión.
String
dimension_ranges
[dimension_ranges,...]
(Opcional)

El rango o la lista de rangos para la dimensión especificada.

Los datos se dividirán en función del nombre de la dimensión y los valores mínimo y máximo del rango. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_RANGES.

Value Table
dimension_values
[dimension_values,...]
(Opcional)

Una lista de valores para la dimensión especificada. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_VALUE.

Value Table
dimension
(Opcional)

La dimensión a lo largo de la cual se dividirán las variables. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_ITERATION.

String
start_of_first_iteration
(Opcional)

El inicio del primer intervalo. Este intervalo se utilizará para iterar por el dataset. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_ITERATION.

String
end_of_first_iteration
(Opcional)

El final del primer intervalo. Este intervalo se utilizará para iterar por el dataset. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_ITERATION.

String
iteration_step
(Opcional)

La frecuencia por la que se dividirán los datos. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_ITERATION.

Double
iteration_unit
(Opcional)

Especifica la unidad de iteración que se utilizará. Este parámetro es obligatorio si el parámetro dimension_def se define como BY_ITERATION y el parámetro dimension se define como StdTime.

  • HOURSSe usarán las horas como unidad de tiempo especificada.
  • DAYSSe usarán los días como unidad de tiempo especificada.
  • WEEKSSe usarán las semanas como unidad de tiempo especificada.
  • MONTHSSe usarán los meses como unidad de tiempo especificada.
  • YEARSSe usarán los años como unidad de tiempo especificada.
String
template
(Opcional)

La extensión (cuadro de delimitación) de la capa. Elija la opción de Extensión adecuada para la capa.

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent
dimensionless
(Opcional)

Especifica si la capa tendrá valores de dimensión. Este parámetro solo está habilitado si se selecciona una única porción para crear una capa.

  • NO_DIMENSIONSLa capa no tendrá valores de dimensión.
  • DIMENSIONSLa capa tendrá valores de dimensión. Esta es la opción predeterminada.
Boolean
spatial_reference
(Opcional)

Sistema de coordenadas para el valor del parámetro out_multidimensional_raster_layer.. Este parámetro solo se aplica cuando el valor del parámetro in_multidimensional_raster tiene el formato Zarr. Utilice este parámetro para definir la referencia espacial si falta en los datos.

Coordinate System

Muestra de código

Ejemplo 1 de MakeMultidimensionalRasterLayer (ventana de Python)

Extraer un subconjunto de variables a partir de un ráster multidimensional con el método BY_RANGES.

# Import system modules
import arcpy

# Execute
MakeMultidim = MakeMultidimensionalRasterLayer("C:\data\Ocean_Data.crf", "salinity", "BY_RANGES", "StdZ -500 -100", "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414")


# Save Output
MakeMultidim.save("C:\data\Salinity_MultidimLayer.crf")
Ejemplo 2 de MakeMultidimensionalRasterLayer (script independiente)

Extraer la variable de temperatura del agua a partir de un ráster multidimensional para obtener valores de profundidad concretos con el método BY_VALUE.

# Import system modules
import arcpy

# Define input parameters
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster_layer = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"
template = "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414"

#Execute

arcpy.md.MakeMultidimensionalRasterLayer(
	in_multidimensional_raster, out_multidimensional_raster_layer, variables, 
	dimension_def, dimension_values, template)
Ejemplo 3 de MakeMultidimensionalRasterLayer (script independiente)

Extraer la variable de salinidad a partir de un ráster multidimensional con el método BY_ITERATION.

# Import system modules
import arcpy
 
# Set local variables
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster_layer =  r"C:\data\salinity_slice.crf"
variables = "salinity"
dimension_def = "BY_ITERATION"
dimension = "StdTime"
start_of_first_iteration = "2009-01-01"
end_of_first_iteration = "2009-01-10"
iteration_step = "1"
iteration_unit = "YEARS"
template = "120.084279939743 0.914964278021376 139.524470909773 21.1231086159414"
 
#Execute
 
arcpy.md.MakeMultidimensionalRasterLayer(in_multidimensional_raster, out_multidimensional_raster_layer, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit, template)