Agregar ráster multidimensional (Herramientas de Image Analyst)

Resumen

Genera un dataset ráster multidimensional al combinar variables de ráster multidimensional existentes a lo largo de una dimensión.

Uso

Use el parámetro Definición de agregación para elegir un intervalo con una palabra clave, un valor o un rango de valores. Por ejemplo, si cuenta con 30 años de datos de temperatura de la superficie del mar que se han recopilado diariamente cada 5 metros de profundidad hasta llegar a los 100 metros, puede utilizar las distintas opciones de intervalos en estos escenarios:
- Agregue datos de temperatura diarios en datos mensuales, en los cuales el resultado es un ráster multidimensional con 12 periodos de tiempo, y cada periodo es la agregación de cada mes a lo largo de los años. Seleccione Palabra clave de intervalo y establezca la palabra clave en Recurrente mensualmente.
- Agregue datos de temperatura diarios en datos mensuales, en los cuales el resultado es un ráster multidimensional con 360 periodos, o bien 12 periodos de tiempo por año (30 años x 12 meses = 360 periodos). Elija Palabra clave de intervalo y establezca la palabra clave en Mensualmente.
- Agregue datos de temperatura mensuales en intervalos de 4 meses. Elija Valor de intervalo, establezca Valor de intervalo en 4 y Unidad en Meses.
- Consolide datos de temperatura de 0 a 25 metros, después de 25 a 50 metros, por último, de 50 a 100 metros. Seleccione Rangos de intervalos y especifique las profundidades mínima y máxima como 0 25; 25 50; 50 100.
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.
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 de compresión.

Etiqueta	Explicación	Tipo de datos
Ráster multidimensional de entrada	El dataset ráster multidimensional de entrada.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Dimensión	La dimensión de consolidación. Esta es la dimensión a lo largo de la cual se consolidan las variables.	String
Método de consolidación (Opcional)	Especifica el método matemático que se utilizará para combinar las porciones agregadas en un intervalo. Cuando el método se configura como Personalizado, el parámetro Función de agregación pasa a estar activo. Valor medio—El valor medio de los valores de un píxel se calculará en todas las porciones del intervalo. Esta es la opción predeterminada. Máximo—El valor máximo de un píxel se calculará en todas las porciones del intervalo. Mayoría—El valor de píxel que se produce con más frecuencia se calculará en todas las porciones del intervalo. Mínimo—El valor mínimo de un píxel se calculará en todas las porciones del intervalo. Minoría—El valor de píxel que se produce con menos frecuencia se calculará en todas las porciones del intervalo. Mediana—La mediana de un píxel se calculará en todas las porciones del intervalo. Percentil—El percentil de valores de un píxel se calculará en todas las porciones del intervalo. El 90 percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro Valor de percentil. Rango—El rango de valores de un píxel se calculará en todas las porciones del intervalo. Desviación estándar—La desviación estándar de los valores de un píxel se calculará en todas las porciones del intervalo. Suma—La suma de los valores de un píxel se calculará en todas las porciones del intervalo. Variedad—La cantidad de valores únicos de un píxel se calculará en todas las porciones del intervalo. Personalizado—El valor de un píxel se calculará según una función ráster personalizada.	String
Variables [Información de dimensión] (Descripción) (Opcional)	Las variables que se agregarán a lo largo de la dimensión determinada. Si no se especifica ninguna variable, se agregarán todas las variables con la dimensión seleccionada. Por ejemplo, para agregar datos de temperatura diarios en valores promedio mensuales, especifique la temperatura como la variable que se agregará. Si no especifica ninguna variable y no cuenta con variables de temperatura y precipitaciones diarias, ambas variables se agregarán en promedios mensuales y estarán incluidas en el ráster multidimensional de salida.	String
Definición de consolidación (Opcional)	Especifica el intervalo de dimensión en el que se agregarán los datos. Todo—Los valores de datos se consolidarán en todas las porciones. Esta es la opción predeterminada. Palabra clave de intervalo—Los datos variables se consolidarán con un intervalo comúnmente conocido. Valor de intervalo—Los datos variables se consolidarán con un intervalo y una unidad especificados por el usuario. Rangos de intervalos—Los datos variables se consolidarán entre pares de valores o fechas especificados.	String
Intervalo de palabra clave (Opcional)	Especifica el intervalo de palabra clave que se usará al agregar a lo largo de la dimensión. Este parámetro es obligatorio cuando el parámetro Definición de agregación está configurado como Palabra clave de intervalo y la agregación debe realizarse a lo largo del tiempo. Cada hora—Los valores de datos se agregarán en periodos de tiempo horarios y el resultado incluirá todas las horas de las series temporales. Diariamente—Los valores de datos se agregarán en periodos de tiempo diarios y el resultado incluirá todos los días de las series temporales. Semanalmente—Los valores de datos se agregarán en periodos de tiempo semanales y el resultado incluirá todas las semanas de las series temporales. Cada década—Los valores de datos se agregarán en 3 periodos de 10 días cada uno. El último periodo puede contener más o menos de 10 días. La salida incluirá 3 periodos para cada mes. Cada lustro—Los valores de datos se agregarán en 6 periodos de 5 días cada uno. El último periodo puede contener más o menos de 5 días. La salida incluirá 6 periodos para cada mes. Mensualmente—Los valores de datos se agregarán en periodos de tiempo mensuales y el resultado incluirá todos los meses de las series temporales. Trimestralmente—Los valores de datos se agregarán en periodos de tiempo trimestrales y el resultado incluirá todos los trimestres de las series temporales. Anualmente—Los valores de datos se agregarán en periodos de tiempo anuales y el resultado incluirá todos los años de las series temporales. Recurrente diariamente—Los valores de datos se agregarán en periodos de tiempo diarios y el resultado incluirá un valor agregado por día juliano. La salida incluirá, al menos, 366 periodos de tiempo diarios. Recurrente semanalmente—Los valores de datos se agregarán en periodos de tiempo semanales y el resultado incluirá un valor agregado por semana. La salida incluirá, al menos, 53 periodos de tiempo semanales. Recurrente mensualmente—Los valores de datos se agregarán en periodos de tiempo mensuales y el resultado incluirá un valor agregado por mes. La salida incluirá, al menos, 12 periodos de tiempo mensuales. Recurrente trimestralmente—Los valores de datos se agregarán en periodos de tiempo trimestrales y el resultado incluirá un valor agregado por trimestre. La salida incluirá, al menos, 4 periodos de tiempo trimestrales.	String
Intervalo de valor (Opcional)	El tamaño del intervalo que se utilizará para la agregación. Este parámetro es obligatorio cuando el parámetro Definición de agregación está configurado como Valor de intervalo. Por ejemplo, para agregar 30 años de datos de temperatura mensuales en incrementos de 5 años, introduzca 5 como el Intervalo de valor y especifique la Unidad como Años.	Double
Unidad (Opcional)	Unidad que se usará para el parámetro Intervalo de valor. Este parámetro es obligatorio cuando el parámetro Dimensión es un campo de tiempo y el parámetro Definición de agregación está establecido en Valor de intervalo. Si agrega algo que no sea tiempo, esta opción no estará disponible y la unidad del valor de intervalo coincidirá con la unidad de variable de los datos ráster multidimensionales de entrada. Horas—Los valores de datos se consolidarán en periodos de tiempo horarios en el intervalo proporcionado. Días—Los valores de datos se consolidarán en periodos de tiempo diarios en el intervalo proporcionado. Semanas—Los valores de datos se consolidarán en periodos de tiempo semanales en el intervalo proporcionado. Meses—Los valores de datos se consolidarán en periodos de tiempo mensuales en el intervalo proporcionado. Años—Los valores de datos se consolidarán en periodos de tiempo anuales en el intervalo proporcionado.	String
Rango (Opcional)	Se usarán los rangos de intervalos especificados en una tabla de valores para consolidar grupos de valores. La tabla de valores consiste en pares de valores de rango mínimo y máximo, siendo el tipo de datos Doble o Fecha. Este parámetro es obligatorio cuando el parámetro Definición de agregación está establecido en Rangos de intervalos. Columnas de la tabla de valores: Minimum Value—The minimum value for a range. Maximum Value—The maximum value for a range.	Value Table
Función de agregación (Opcional)	Una función ráster personalizada que se usará para calcular los valores de píxel de los rásteres consolidados. La entrada es un objeto JSON de función ráster, un archivo `.rft.xml` creado a partir de una cadena de función o una función ráster de Python personalizada. Este parámetro es obligatorio cuando el parámetro Método de agregación se define como Personalizado.	File; String
Ignorar NoData (Opcional)	Especifica si los valores NoData se ignorarán en el análisis. Activado—El análisis incluirá todos los píxeles válidos a lo largo de una dimensión determinada y se ignorarán los píxeles NoData. Esta es la opción predeterminada. Desactivado—El análisis dará como resultado NoData si hay valores NoData para los píxeles a lo largo de la dimensión determinada.	Boolean
Sin dimensión (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. Activado—La capa no tendrá valores de dimensión. Desactivado—La capa tendrá valores de dimensión. Esta es la opción predeterminada.	Boolean
Valor de percentil (Opcional)	El percentil que se calcula. El valor predeterminado es 90, que indica el 90.º percentil. Los valores pueden variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística mediana. Este parámetro solo está disponible si el parámetro Tipo de estadísticas está establecido en Percentil.	Double
Tipo de interpolación de percentil (Opcional)	Especifica el método de interpolación percentil que se utilizará si el número de valores del ráster de entrada calculado es par. Más cercano—Se utilizará el valor disponible más cercano para el percentil deseado. En este caso, el tipo de píxel de salida será el mismo que el del ráster de valor de entrada. Lineal—Se utilizará la media ponderada de los dos valores circundantes del percentil deseado. En este caso, el tipo de píxel de salida será un punto flotante.	String

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster multidimensional de salida	El dataset ráster multidimensional de formato de ráster de nube (CRF) de salida.	Raster

AggregateMultidimensionalRaster(in_multidimensional_raster, dimension, {aggregation_method}, {variables}, {aggregation_def}, {interval_keyword}, {interval_value}, {interval_unit}, {interval_ranges}, {aggregation_function}, {ignore_nodata}, {dimensionless}, {percentile_value}, {percentile_interpolation_type})

Nombre	Explicación	Tipo de datos
in_multidimensional_raster	El dataset ráster multidimensional de entrada.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension	La dimensión de consolidación. Esta es la dimensión a lo largo de la cual se consolidan las variables.	String
aggregation_method (Opcional)	Especifica el método matemático que se utilizará para combinar las porciones agregadas en un intervalo. Cuando `aggregation_method` se configura como `CUSTOM`, el parámetro `aggregation_function` pasa a estar disponible. `MEAN`—El valor medio de los valores de un píxel se calculará en todas las porciones del intervalo. Esta es la opción predeterminada. `MAXIMUM`—El valor máximo de un píxel se calculará en todas las porciones del intervalo. `MAJORITY`—El valor de píxel que se produce con más frecuencia se calculará en todas las porciones del intervalo. `MINIMUM`—El valor mínimo de un píxel se calculará en todas las porciones del intervalo. `MINORITY`—El valor de píxel que se produce con menos frecuencia se calculará en todas las porciones del intervalo. `MEDIAN`—La mediana de un píxel se calculará en todas las porciones del intervalo. `PERCENTILE`—El percentil de valores de un píxel se calculará en todas las porciones del intervalo. El 90 percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro `percentile_value`. `RANGE`—El rango de valores de un píxel se calculará en todas las porciones del intervalo. `STD`—La desviación estándar de los valores de un píxel se calculará en todas las porciones del intervalo. `SUM`—La suma de los valores de un píxel se calculará en todas las porciones del intervalo. `VARIETY`—La cantidad de valores únicos de un píxel se calculará en todas las porciones del intervalo. `CUSTOM`—El valor de un píxel se calculará según una función ráster personalizada.	String
variables [variables,...] (Opcional)	Las variables que se agregarán a lo largo de la dimensión determinada. Si no se especifica ninguna variable, se agregarán todas las variables con la dimensión seleccionada. Por ejemplo, para agregar datos de temperatura diarios en valores promedio mensuales, especifique la temperatura como la variable que se agregará. Si no especifica ninguna variable y no cuenta con variables de temperatura y precipitaciones diarias, ambas variables se agregarán en promedios mensuales y estarán incluidas en el ráster multidimensional de salida.	String
aggregation_def (Opcional)	Especifica el intervalo de dimensión en el que se agregarán los datos. `ALL`—Los valores de datos se consolidarán en todas las porciones. Esta es la opción predeterminada. `INTERVAL_KEYWORD`—Los datos variables se consolidarán con un intervalo comúnmente conocido. `INTERVAL_VALUE`—Los datos variables se consolidarán con un intervalo y una unidad especificados por el usuario. `INTERVAL_RANGES`—Los datos variables se consolidarán entre pares de valores o fechas especificados.	String
interval_keyword (Opcional)	Especifica el intervalo de palabra clave que se usará al agregar a lo largo de la dimensión. Este parámetro es obligatorio si el parámetro `aggregation_def` se define como `INTERVAL_KEYWORD` y la agregación debe realizarse a lo largo del tiempo. `HOURLY`—Los valores de datos se agregarán en periodos de tiempo horarios y el resultado incluirá todas las horas de las series temporales. `DAILY`—Los valores de datos se agregarán en periodos de tiempo diarios y el resultado incluirá todos los días de las series temporales. `WEEKLY`—Los valores de datos se agregarán en periodos de tiempo semanales y el resultado incluirá todas las semanas de las series temporales. `DEKADLY`—Los valores de datos se agregarán en 3 periodos de 10 días cada uno. El último periodo puede contener más o menos de 10 días. La salida incluirá 3 periodos para cada mes. `PENTADLY`—Los valores de datos se agregarán en 6 periodos de 5 días cada uno. El último periodo puede contener más o menos de 5 días. La salida incluirá 6 periodos para cada mes. `MONTHLY`—Los valores de datos se agregarán en periodos de tiempo mensuales y el resultado incluirá todos los meses de las series temporales. `QUARTERLY`—Los valores de datos se agregarán en periodos de tiempo trimestrales y el resultado incluirá todos los trimestres de las series temporales. `YEARLY`—Los valores de datos se agregarán en periodos de tiempo anuales y el resultado incluirá todos los años de las series temporales. `RECURRING_DAILY`—Los valores de datos se agregarán en periodos de tiempo diarios y el resultado incluirá un valor agregado por día juliano. La salida incluirá, al menos, 366 periodos de tiempo diarios. `RECURRING_WEEKLY`—Los valores de datos se agregarán en periodos de tiempo semanales y el resultado incluirá un valor agregado por semana. La salida incluirá, al menos, 53 periodos de tiempo semanales. `RECURRING_MONTHLY`—Los valores de datos se agregarán en periodos de tiempo mensuales y el resultado incluirá un valor agregado por mes. La salida incluirá, al menos, 12 periodos de tiempo mensuales. `RECURRING_QUARTERLY`—Los valores de datos se agregarán en periodos de tiempo trimestrales y el resultado incluirá un valor agregado por trimestre. La salida incluirá, al menos, 4 periodos de tiempo trimestrales.	String
interval_value (Opcional)	El tamaño del intervalo que se utilizará para la agregación. Este parámetro es obligatorio si el parámetro `aggregation_def` se define como `INTERVAL_VALUE`. Por ejemplo, para agregar 30 años de datos de temperatura mensuales en incrementos de 5 años, introduzca 5 como `interval_value` y establezca `interval_unit` en `YEARS`.	Double
interval_unit (Opcional)	La unidad que se usará para el parámetro `interval_value`. Este parámetro es obligatorio si el parámetro `dimension` se establece en un campo de tiempo y el parámetro `aggregation_def` se establece en `INTERVAL_VALUE`. Si agrega algo que no sea tiempo, esta opción no estará disponible y la unidad del valor de intervalo coincidirá con la unidad de variable de los datos ráster multidimensionales de entrada. `HOURS`—Los valores de datos se consolidarán en periodos de tiempo horarios en el intervalo proporcionado. `DAYS`—Los valores de datos se consolidarán en periodos de tiempo diarios en el intervalo proporcionado. `WEEKS`—Los valores de datos se consolidarán en periodos de tiempo semanales en el intervalo proporcionado. `MONTHS`—Los valores de datos se consolidarán en periodos de tiempo mensuales en el intervalo proporcionado. `YEARS`—Los valores de datos se consolidarán en periodos de tiempo anuales en el intervalo proporcionado.	String
interval_ranges [interval_ranges,...] (Opcional)	Se usarán los rangos de intervalos especificados en una tabla de valores para consolidar grupos de valores. La tabla de valores consiste en pares de valores de rango mínimo y máximo, siendo el tipo de datos Doble o Fecha. Este parámetro es obligatorio si el parámetro `aggregation_def` se define como `INTERVAL_RANGE`. Columnas de la tabla de valores: `Minimum Value`—The minimum value for a range. `Maximum Value`—The maximum value for a range.	Value Table
aggregation_function (Opcional)	Una función ráster personalizada que se usará para calcular los valores de píxel de los rásteres consolidados. La entrada es un objeto JSON de función ráster, un archivo `.rft.xml` creado a partir de una cadena de función o una función ráster de Python personalizada. Este parámetro es obligatorio si el parámetro `aggregation_method` se define como `CUSTOM`.	File; String
ignore_nodata (Opcional)	Especifica si los valores NoData se ignorarán en el análisis. `DATA`—El análisis incluirá todos los píxeles válidos a lo largo de una dimensión determinada y se ignorarán los píxeles NoData. Esta es la opción predeterminada. `NODATA`—El análisis dará como resultado NoData si hay valores NoData para los píxeles a lo largo de la dimensión determinada.	Boolean
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_DIMENSIONS`—La capa no tendrá valores de dimensión. `DIMENSIONS`—La capa tendrá valores de dimensión. Esta es la opción predeterminada.	Boolean
percentile_value (Opcional)	El percentil que se calcula. El valor predeterminado es 90, que indica el 90.º percentil. Los valores pueden variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística mediana. Este parámetro solo está disponible si el parámetro `statistics_type` está establecido en `PERCENTILE`.	Double
percentile_interpolation_type (Opcional)	Especifica el método de interpolación percentil que se utilizará si el número de valores del ráster de entrada calculado es par. `NEAREST`—Se utilizará el valor disponible más cercano para el percentil deseado. En este caso, el tipo de píxel de salida será el mismo que el del ráster de valor de entrada. `LINEAR`—Se utilizará la media ponderada de los dos valores circundantes del percentil deseado. En este caso, el tipo de píxel de salida será un punto flotante.	String

Valor de retorno

Nombre	Explicación	Tipo de datos
out_multidimensional_raster	El dataset ráster multidimensional de formato de ráster de nube (CRF) de salida.	Raster

Muestra de código

Ejemplo 1 de AggregateMultidimensionalRaster (ventana de Python)

Este ejemplo consolida datos de temperatura en datos anuales con los valores medios de temperatura.

# Import system modules
import arcpy
from arcpy.ia import *

aggMultidim = arcpy.ia.AggregateMultidimensionalRaster("climateData.crf",
    "StdTime", "MEAN", "temperature", "INTERVAL_KEYWORD", "YEARLY",
    None, "", None, "", "DATA")

aggMultidim.save("C:/data/YearlyTemp.crf")

Ejemplo 2 de AggregateMultidimensionalRaster (script independiente)

Este ejemplo consolida datos de temperatura y precipitaciones diarias en datos mensuales con los valores medios de temperatura y precipitación máxima.

# Import system modules
import arcpy
from arcpy.ia import *

# Define input parameters
inputFile = "C:/data/dailyclimateData.crf"
dimensionName = "StdTime"
aggregationMethod = "MAXIMUM"
variables = "temperature;precipitation"
aggregationDefinition = "INTERVAL_KEYWORD"
keyword = "MONTHLY"
ignore_nodata = "DATA"

# Run
aggMultidim = arcpy.ia.AggregateMultidimensionalRaster(inputFile, dimensionName,
    variables, aggregationMethod, aggregationDefinition, keyword, None, "", None, "",
    ignore_nodata)

# Save output
aggMultidim.save("C:/data/monthlymaxtemp.crf")

Entornos

Tamaño de celda, Compresión, Espacio de trabajo actual, Transformaciones geográficas, NoData, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Extensión, Factor de procesamiento en paralelo, Pirámide, Estadísticas de ráster, Método de remuestreo, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

Basic: Requiere Image Analyst o Spatial Analyst
Standard: Requiere Image Analyst o Spatial Analyst
Avanzado: Requiere Image Analyst o Spatial Analyst

Agregar ráster multidimensional (Herramientas de Image Analyst)

Resumen

Uso

Parámetros

Valor de retorno

Entornos

Información de licenciamiento

Temas relacionados