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

  • 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

EtiquetaExplicaciónTipo 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.

  • TodasSe extraerá la estadística de todas las dimensiones. Esta es la opción predeterminada.
  • Palabra clave de intervaloLa 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 diariamenteSe extraerá la estadística de días.
  • Recurrente semanalmenteSe extraerá la estadística de semanas.
  • Recurrente mensualmenteSe extraerá la estadística de meses.
  • Recurrente trimestralmenteSe extraerá la estadística de trimestres.
  • Cada horaSe extraerá la estadística de la hora en la que se alcanzó la estadística.
  • DiariamenteSe extraerá la estadística del día en el que se alcanzó la estadística.
  • SemanalmenteSe extraerá la estadística de la semana en la que se alcanzó la estadística.
  • MensualmenteSe extraerá la estadística del mes en el que se alcanzó la estadística.
  • TrimestralmenteSe extraerá la estadística del trimestre el que se alcanzó la estadística.
  • AnualmenteSe 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ínimoSe 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áximoSe extraerá el valor de dimensión en el que se alcanza el valor máximo de la variable.
  • Argumento de la medianaSe extraerá el valor de dimensión en el que se alcanza el valor mediano de la variable.
  • DuraciónSe extraerá el valor de duración de dimensión más largo entre los valores de variable mínimo y máximo.
  • Argumento del valorSe 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 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.

  • IgualLa dimensión extraída es igual al valor especificado. Esta es la opción predeterminada.
  • Mayor queLa dimensión extraída es mayor que el valor especificado.
  • Menor queLa 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 ocurrenciaEl 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 ocurrenciaEl valor de la dimensión se devolverá la última vez que se alcance la estadística del argumento.
String

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El dataset ráster de salida.

Raster

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})
NombreExplicaciónTipo 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.

  • ALLSe extraerá la estadística de todas las dimensiones. Esta es la opción predeterminada.
  • INTERVAL_KEYWORDLa 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_DAILYSe extraerá la estadística de días.
  • RECURRING_WEEKLYSe extraerá la estadística de semanas.
  • RECURRING_MONTHLYSe extraerá la estadística de meses.
  • RECURRING_QUARTERLYSe extraerá la estadística de trimestres.
  • HOURLYSe extraerá la estadística de la hora en la que se alcanzó la estadística.
  • DAILYSe extraerá la estadística del día en el que se alcanzó la estadística.
  • WEEKLYSe extraerá la estadística de la semana en la que se alcanzó la estadística.
  • MONTHLYSe extraerá la estadística del mes en el que se alcanzó la estadística.
  • QUARTERLYSe extraerá la estadística del trimestre el que se alcanzó la estadística.
  • YEARLYSe 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_MINSe 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_MAXSe extraerá el valor de dimensión en el que se alcanza el valor máximo de la variable.
  • ARGUMENT_MEDIANSe extraerá el valor de dimensión en el que se alcanza el valor mediano de la variable.
  • DURATIONSe extraerá el valor de duración de dimensión más largo entre los valores de variable mínimo y máximo.
  • ARGUMENT_VALUESe 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.

  • DATAEl 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.
  • NODATAEl análisis dará como resultado NoData si 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_TOLa dimensión extraída es igual al valor especificado. Esta es la opción predeterminada.
  • GREATER_THANLa dimensión extraída es mayor que el valor especificado.
  • SMALLER_THANLa 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_OCCURRENCEEl 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_OCCURRENCEEl valor de la dimensión se devolverá la última vez que se alcance la estadística del argumento.
String

Valor de retorno

NombreExplicaciónTipo 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")

Información de licenciamiento

  • Basic: Requiere Image Analyst
  • Standard: Requiere Image Analyst
  • Advanced: Requiere Image Analyst

Temas relacionados