Hallar estadísticas de argumentos (Image Analyst)

Disponible con licencia de Image Analyst.

Resumen

Extrae el valor de dimensión o el índice de banda en el que se consigue una determinada estadística para cada píxel de un ráster multidimensional o multibanda.

Uso

• Utilice la herramienta Hallar estadísticas de argumentos para extraer el valor de dimensión (por ejemplo, la fecha, altura o profundidad) a la que se alcanza una estadística específica en la pila de rásteres en un dataset ráster multidimensional. También puede encontrar el número de banda a la que se alcanza la estadística en un ráster multibanda.

  Por ejemplo, puede ver el mes en el que cada píxel alcanzó la temperatura de la superficie del mar más alta en 30 años de captura de datos. Otro ejemplo es cuando tiene una imagen de teledetección de ocho bandas y desea conocer la banda en la que se alcanzó el valor de reflectancia mínimo para cada píxel.

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

• Si el ráster multidimensional de entrada contiene solo una dimensión, la salida será un dataset ráster de banda única. Si el ráster multidimensional de entrada contiene varias dimensiones, el ráster multidimensional de salida incluirá las dimensiones que no se incluyeron en el análisis.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster multibanda o multidimensional de entrada	El ráster multibanda o multidimensional de entrada que se va a analizar.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Dimensión (Opcional)	La dimensión de la que se extraerá la estadística. Si el ráster de entrada no es un ráster multidimensional, este parámetro no se requiere.	String
Definición de dimensión (Opcional)	Especifica cómo se extraerá la estadística de la dimensión. Todas—Se extraerá la estadística de todas las dimensiones. Esta es la opción predeterminada. Palabra clave de intervalo—La estadística se extraerá de la dimensión de tiempo de acuerdo con la palabra clave de intervalo.	String
Intervalo de palabra clave (Opcional)	La unidad de tiempo para la que se extraerá la estadística. Por ejemplo, dispone de cinco años de datos de la temperatura diaria de la superficie del mar y desea saber el año en el que se observó la temperatura máxima. Establezca Tipo de estadísticas en Argumento del máximo, establezca Definición de dimensión en Palabra clave de intervalo y establezca Intervalo de palabra clave en Anualmente. Como alternativa, si desea saber el mes en el que se detectó sistemáticamente la temperatura máxima, establezca Tipo de estadísticas en Argumento del máximo, establezca Definición de dimensión en Palabra clave de intervalo e Intervalo de palabra clave en Recurrente mensualmente. Así se generará un ráster en el que cada píxel contiene el mes en el que se alcanzó la estadística en todo el registro de cinco años (por ejemplo, 18/08/2018, 25/08/2016, 07/08/2013). Este parámetro es obligatorio si el parámetro Dimensión se define como StdTime y el parámetro Definición de dimensión se define como Intervalo de palabra clave. Recurrente diariamente—Se extraerá la estadística de días. Recurrente semanalmente—Se extraerá la estadística de semanas. Recurrente mensualmente—Se extraerá la estadística de meses. Recurrente trimestralmente—Se extraerá la estadística de trimestres. Cada hora—Se extraerá la estadística de la hora en la que se alcanzó la estadística. Diariamente—Se extraerá la estadística del día en el que se alcanzó la estadística. Semanalmente—Se extraerá la estadística de la semana en la que se alcanzó la estadística. Mensualmente—Se extraerá la estadística del mes en el que se alcanzó la estadística. Trimestralmente—Se extraerá la estadística del trimestre el que se alcanzó la estadística. Anualmente—Se extraerá la estadística del año en el que se alcanzó la estadística.	String
Variables [Información de dimensión] (Descripción) (Opcional)	Las variables que se van a analizar. Si el ráster de entrada no es multidimensional, los valores de píxel del ráster multibanda se consideran la variable. Si el ráster de entrada es multidimensional y no se especifica ninguna variable, se analizarán todas las variables con la dimensión seleccionada. Por ejemplo, para encontrar los años en los que los valores de temperatura fueron los más altos, especifique la temperatura como la variable que se va a analizar. Si no especifica ninguna variable y cuenta con variables de temperatura y precipitaciones, se analizarán ambas variables y el ráster multidimensional de salida incluirá ambas variables.	String
Tipo de estadísticas (Opcional)	Especifica la estadística que se extraerá de las variables a lo largo de la dimensión proporcionada. Argumento del mínimo—Se extraerá el valor de dimensión en el que se alcanza el valor mínimo de la variable. Esta es la opción predeterminada. Argumento del máximo—Se extraerá el valor de dimensión en el que se alcanza el valor máximo de la variable. Argumento de la mediana—Se extraerá el valor de dimensión en el que se alcanza el valor mediano de la variable. Duración—Se extraerá el valor de duración de dimensión más largo entre los valores de variable mínimo y máximo. Argumento del valor—Se extraerá el valor de dimensión en el que se alcanza el valor de variable especificado.	String
Valor mínimo (Opcional)	El valor mínimo de la variable que se utilizará para extraer la duración. Este parámetro es obligatorio si el parámetro Tipo de estadísticas se define como Duración.	Double
Valor Máximo (Opcional)	El valor máximo de la variable que se utilizará para extraer la duración. Este parámetro es obligatorio si el parámetro Tipo de estadísticas se define como Duración.	Double
Valor de ocurrencia múltiple (Opcional)	El valor de píxel que se utilizará para indicar que se alcanzó una estadística de argumento determinada más de una vez en el dataset ráster de entrada. Si no se especifica, el valor de píxel será el valor de la dimensión especificado por el parámetroOcurrencia, ya sea la primera o la última ocurrencia.	Long
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 no hay valores NoData para los píxeles a lo largo de la dimensión determinada.	Boolean
Valor de argumento (Opcional)	El valor con el que se realizará una comparación para extraer el valor de dimensión. Este parámetro es obligatorio cuando el parámetro Tipo de estadísticas se define como Argumento del valor. El valor con el que se realizará una comparación para extraer el valor de dimensión. Este parámetro es obligatorio si el parámetro statistics_type se define como ARGUMENT_VALUE.	Long
Comparación (Opcional)	Especifica el tipo de comparación que se utilizará para extraer el valor de dimensión. Igual—La dimensión extraída es igual al valor especificado. Esta es la opción predeterminada. Mayor que—La dimensión extraída es mayor que el valor especificado. Menor que—La dimensión extraída es menor que el valor especificado.	String
Ocurrencia (Opcional)	Especifica si el valor de la dimensión se devolverá la primera vez o la última vez que se alcance la estadística del argumento. Primera ocurrencia—El valor de la dimensión se devolverá la primera vez que se alcance la estadística del argumento. Esta es la opción predeterminada. Última ocurrencia—El valor de la dimensión se devolverá la última vez que se alcance la estadística del argumento.	String

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El dataset ráster de salida.	Raster

Python

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})

Nombre	Explicación	Tipo de datos
in_raster	El ráster multibanda o multidimensional de entrada que se va a analizar.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension (Opcional)	La dimensión de la que se extraerá la estadística. Si el ráster de entrada no es un ráster multidimensional, este parámetro no se requiere.	String
dimension_def (Opcional)	Especifica cómo se extraerá la estadística de la dimensión. ALL—Se extraerá la estadística de todas las dimensiones. Esta es la opción predeterminada. INTERVAL_KEYWORD—La estadística se extraerá de la dimensión de tiempo de acuerdo con la palabra clave de intervalo.	String
interval_keyword (Opcional)	La unidad de tiempo para la que se extraerá la estadística. Por ejemplo, dispone de cinco años de datos de la temperatura diaria de la superficie del mar y desea saber el año en el que se observó la temperatura máxima. Establezca Tipo de estadísticas en Argumento del máximo, establezca Definición de dimensión en Palabra clave de intervalo y establezca Intervalo de palabra clave en Anualmente. Como alternativa, si desea saber el mes en el que se detectó sistemáticamente la temperatura máxima, establezca Tipo de estadísticas en Argumento del máximo, establezca Definición de dimensión en Palabra clave de intervalo e Intervalo de palabra clave en Recurrente mensualmente. Así se generará un ráster en el que cada píxel contiene el mes en el que se alcanzó la estadística en todo el registro de cinco años (por ejemplo, 18/08/2018, 25/08/2016, 07/08/2013). Este parámetro es obligatorio si el parámetro dimension se define como StdTime y el parámetro dimension_def se define como INTERVAL_KEYWORD. RECURRING_DAILY—Se extraerá la estadística de días. RECURRING_WEEKLY—Se extraerá la estadística de semanas. RECURRING_MONTHLY—Se extraerá la estadística de meses. RECURRING_QUARTERLY—Se extraerá la estadística de trimestres. HOURLY—Se extraerá la estadística de la hora en la que se alcanzó la estadística. DAILY—Se extraerá la estadística del día en el que se alcanzó la estadística. WEEKLY—Se extraerá la estadística de la semana en la que se alcanzó la estadística. MONTHLY—Se extraerá la estadística del mes en el que se alcanzó la estadística. QUARTERLY—Se extraerá la estadística del trimestre el que se alcanzó la estadística. YEARLY—Se extraerá la estadística del año en el que se alcanzó la estadística.	String
variables [variables,...] (Opcional)	Las variables que se van a analizar. Si el ráster de entrada no es multidimensional, los valores de píxel del ráster multibanda se consideran la variable. Si el ráster de entrada es multidimensional y no se especifica ninguna variable, se analizarán todas las variables con la dimensión seleccionada. Por ejemplo, para encontrar los años en los que los valores de temperatura fueron los más altos, especifique la temperatura como la variable que se va a analizar. Si no especifica ninguna variable y cuenta con variables de temperatura y precipitaciones, se analizarán ambas variables y el ráster multidimensional de salida incluirá ambas variables.	String
statistics_type (Opcional)	Especifica la estadística que se extraerá de las variables a lo largo de la dimensión proporcionada. ARGUMENT_MIN—Se extraerá el valor de dimensión en el que se alcanza el valor mínimo de la variable. Esta es la opción predeterminada. ARGUMENT_MAX—Se extraerá el valor de dimensión en el que se alcanza el valor máximo de la variable. ARGUMENT_MEDIAN—Se extraerá el valor de dimensión en el que se alcanza el valor mediano de la variable. DURATION—Se extraerá el valor de duración de dimensión más largo entre los valores de variable mínimo y máximo. ARGUMENT_VALUE—Se extraerá el valor de dimensión en el que se alcanza el valor de variable especificado.	String
min (Opcional)	El valor mínimo de la variable que se utilizará para extraer la duración. Este parámetro es obligatorio si el parámetro statistics_type se define como DURATION.	Double
max (Opcional)	El valor máximo de la variable que se utilizará para extraer la duración. Este parámetro es obligatorio si el parámetro statistics_type se define como DURATION.	Double
multiple_occurrence (Opcional)	El valor de píxel que se utilizará para indicar que se alcanzó una estadística de argumento determinada más de una vez en el dataset ráster de entrada. Si no se especifica, el valor de píxel será el valor de la dimensión especificado por el parámetro occurrence, ya sea la primera o la última ocurrencia.	Long
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 no hay valores NoData para los píxeles a lo largo de la dimensión determinada.	Boolean
value (Opcional)	El valor con el que se realizará una comparación para extraer el valor de dimensión. Este parámetro es obligatorio cuando el parámetro Tipo de estadísticas se define como Argumento del valor.	Long
comparison (Opcional)	Especifica el tipo de comparación que se utilizará para extraer el valor de dimensión. EQUAL_TO—La dimensión extraída es igual al valor especificado. Esta es la opción predeterminada. GREATER_THAN—La dimensión extraída es mayor que el valor especificado. SMALLER_THAN—La dimensión extraída es menor que el valor especificado.	String
occurrence (Opcional)	Especifica si el valor de la dimensión se devolverá la primera vez o la última vez que se alcance la estadística del argumento. FIRST_OCCURRENCE—El valor de la dimensión se devolverá la primera vez que se alcance la estadística del argumento. Esta es la opción predeterminada. LAST_OCCURRENCE—El valor de la dimensión se devolverá la última vez que se alcance la estadística del argumento.	String

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El dataset ráster de salida.	Raster

Muestra de código

Ejemplo 1 de FindArgumentStatistics (ventana de Python)

En este ejemplo se buscan los valores mínimos mensuales de precipitación y temperatura en un ráster multidimensional de serie temporal. Si se encuentra el mismo valor mínimo varias veces, el valor de píxel será 99999.

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

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# get the date when the minimal precipitation was observed in each year
# as well as the date when the minimal temperature was observed in each year
argStatOutput = FindArgumentStatistics("prcp_temp_time_series.crf", "StdTime", "INTERVAL_KEYWORD", "YEARLY",
	"prcp;temp", "ARGUMENT_MIN", None, None, 0, "DATA")
	
# Save output
argStatOutput.save("C:/data/yearly_min_temp_precip.crf")

Ejemplo 2 de FindArgumentStatistics (script independiente)

En este ejemplo se encuentra el intervalo de tiempo más largo en el que la salinidad cae entre 10 y 15 unidades de medida en el ráster multidimensional.

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

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Define input parameters
inFile = "C:/data/salinity.crf"
dimensionName = "Time"
dimensiondef = "ALL"
intervalkeyword = ''
variables = "temp"
arg_statistics_type = "DURATION"
min_value = 20
max_value = 25
multiple_occurrances_value = None
ignore_nodata = "NODATA"

# Execute 
# get the number of continous slices that have temperature value between 20 and 25
argStatOutput = FindArgumentStatistics(inFile, dimensionName, dimensiondef, intervalkeyword,
	variables, arg_statistics_type, min_value, max_value, multiple_occurrances_value, ignore_nodata)
	
# Save output
argStatOutput.save("C:/data/arg_statistics_output2.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
• Standard: Requiere Image Analyst
• Advanced: Requiere Image Analyst