Etiqueta | Explicación | Tipo de datos |
Ráster multidimensional de entrada | El dataset ráster multidimensional de entrada. Entre las entradas admitidas se incluyen archivos netCDF, GRIB, HDF o CRF, un dataset de mosaico multidimensional o una capa ráster multidimensional. | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File |
Ráster multidimensional de salida | El dataset ráster multidimensional de salida. | Raster Dataset |
Variables (Opcional) | Las variables que se incluirán en el ráster multidimensional de salida. Si no se especifica ninguna variable, se utilizarán todas. | String |
Definición de dimensión (Opcional) | Especifica el método que se utilizará para dividir la 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.
| String |
Resumen
Crea un subconjunto de un 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 produce un dataset ráster multidimensional en formato de ráster de nube (CRF). En este momento, no se admite ningún otro formato de salida.
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.
De forma predeterminada, la salida del ráster multidimensional se comprimirá con el tipo de compresión LZ77. Sin embargo, se recomienda que cambie el tipo de compresión a LERC y ajuste el valor de error máximo en función de los datos. Por ejemplo, si espera que los resultados del análisis sean precisos hasta tres decimales, use 0,001 como valor de error máximo. Evite requisitos de precisión innecesarios, puesto que aumentarán el tiempo de procesamiento y el tamaño de almacenamiento.
Para cambiar el tipo de compresión, modifique la Configuración del entorno.
Parámetros
arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit})
Nombre | Explicación | Tipo de datos |
in_multidimensional_raster | El dataset ráster multidimensional de entrada. Entre las entradas admitidas se incluyen archivos netCDF, GRIB, HDF o CRF, un dataset de mosaico multidimensional o una capa ráster multidimensional. | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File |
out_multidimensional_raster | El dataset ráster multidimensional de salida. | Raster Dataset |
variables [variables,...] (Opcional) | Las variables que se incluirán en el ráster multidimensional de salida. Si no se especifica ninguna variable, se utilizarán todas. | String |
dimension_def (Opcional) | Especifica el método que se utilizará para dividir la 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.
| String |
Muestra de código
Extraer un subconjunto de variables a partir de un ráster multidimensional con el método BY_RANGES.
# Import system modules
import arcpy
# Execute
arcpy.md.SubsetMultidimensionalRaster(
"C:\data\Ocean_Data.crf", "C:\data\Ocean_Data_Subset.crf",
"salinity", "BY_RANGES", "StdZ -500 -100")
Extraiga la variable de temperatura del agua a partir de un ráster multidimensional 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 = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"
#Execute
arcpy.md.SubsetMultidimensionalRaster(
in_multidimensional_raster, out_multidimensional_raster,
variables, dimension_def, dimension_values)
Extraiga 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 = 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"
#Execute
arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí