Detectar cambios con ráster de análisis de cambios (Image Analyst)

Disponible con licencia de Image Analyst.

Resumen

Genera un ráster que contiene información de cambios de píxel utilizando el ráster de análisis de cambios de salida de la herramienta Analizar cambios usando CCDC o la herramienta Analizar cambios usando LandTrendr.

Uso

• Esta herramienta utiliza un ráster de análisis de cambios generado con la herramienta Analizar cambios usando CCDC o la herramienta Analizar cambios usando LandTrendr para generar un ráster que contiene información de puntos de cambio.

  Los rásteres de análisis de cambios contienen información del modelo sobre cómo ha cambiado cada píxel a lo largo del tiempo. Esta herramienta analiza esa información.

• El parámetro Tipo de cambio indica la información que se generará. La información se extrae del ráster de análisis de cambios.

  Al ejecutar esta herramienta en la salida de la herramienta Analizar cambios usando CCDC, puede elegir entre las siguientes opciones:

  • Hora del cambio más reciente: la fecha y hora más recientes en las que un píxel se marcó como cambiado.
  • Hora del cambio más temprano: la fecha y hora más tempranas en las que un píxel se marcó como cambiado.
  • Hora del cambio más grande: la fecha y hora en las que el cambio calculado fue el más significativo para un píxel.
  • Número de cambios: el número total de veces que cambió el píxel.

  Para obtener más información, consulte Cómo funciona Analizar cambios usando CCDC.

  Al ejecutar esta herramienta en la salida de la herramienta Analizar cambios usando LandTrendr, están disponibles las siguientes opciones adicionales:

  • Hora del cambio más largo: la fecha en la que un píxel se marcó como cambiado, al principio o al final del periodo de cambio más largo.
  • Hora del cambio más corto: la fecha en la que un píxel se marcó como cambiado, al principio o al final del periodo de cambio más corto.
  • Hora del cambio más rápido: la fecha en la que un píxel se marcó como cambiado, al principio o al final del periodo de cambio más rápido.
  • Hora del cambio más lento: la fecha en la que un píxel se marcó como cambiado, al principio o al final del periodo de cambio más lento.
  • Filtrar por valor inicial: filtre los resultados por valor inicial para que solo se incluyan en la salida los cambios de un valor inicial determinado.
  • Filtrar por valor final: filtre los resultados por valor final para que solo se incluyan en la salida los cambios de un valor final determinado.

• Los parámetros Filtrar por valor inicial y Filtrar por valor final utilizan los valores ajustados de reflectancia de superficie del ráster de análisis de cambios que contiene los coeficientes del modelo. Los valores ajustados indican cuándo ha ocurrido un cambio por una división en el segmento de línea del valor ajustado cuando se representa en un gráfico de perfil temporal.

  Para obtener más información, consulte Cómo funciona Analizar cambios usando LandTrendr.

• La salida es un ráster multibanda en el que cada banda contiene información de cambios en función del tipo de cambio seleccionado y del número máximo de cambios especificado. Por ejemplo, si el parámetro Tipo de cambio está definido como Hora del cambio más temprano y el parámetro Número máximo de cambios está definido como 2, la herramienta calcula las dos fechas más tempranas en las que se produjeron cambios durante toda la serie temporal para cada píxel. El resultado es un ráster en el que la primera banda contiene las fechas del cambio más temprano por píxel y la segunda banda contiene las fechas del segundo cambio más temprano por píxel.

• Al ejecutar esta herramienta en la salida de la herramienta Analizar cambios usando LandTrendr, puede extraer la fecha que marca el inicio de un cambio o el final de un cambio con el parámetro Fecha de segmento. Por ejemplo, para entender cómo se inició el cambio más reciente en la serie temporal, establezca el parámetro Tipo de cambio en Hora del cambio más reciente y el parámetro Fecha de segmento en Inicio de segmento.

• Utilice los siguientes parámetros de filtrado para extraer fechas de cambio más específicas del ráster de análisis de cambios:

  • Filtrar por año: identifique los cambios que se produjeron en un periodo de tiempo específico, por ejemplo, cambios que se produjeran en un paisaje durante cinco años de sequía.
  • Filtrar por duración: identifique los cambios que se produjeron a lo largo de un rango determinado de años, por ejemplo, cambios abruptos que se produjeran en 1 o 2 años. Puede calcular la duración mediante la fórmula end year - start year +1. Se incluirán los huecos en las series temporales.
  • Filtrar por magnitud: identifique los cambios de una magnitud determinada, por ejemplo, cambios grandes en el índice de vegetación NDVI. La magnitud es un valor absoluto, por lo que los valores mínimo y máximo no pueden ser negativos. Para especificar el cambio direccional, utilice el parámetro Cambiar dirección.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de análisis de cambios de entrada	El ráster de análisis de cambios generado con la herramienta Analizar cambios usando CCDC o la herramienta Analizar cambios usando LandTrendr.	Raster Dataset; Raster Layer; Image Service
Cambiar tipo (Opcional)	Especifica la información de cambio que se calculará para cada píxel. Hora del cambio más reciente—Cada píxel contendrá la fecha de su cambio más reciente en la serie temporal. Esta es la opción predeterminada. Hora del cambio más temprano—Cada píxel contendrá la fecha de su cambio más temprano en la serie temporal. Hora del cambio más grande—Cada píxel contendrá la fecha de su cambio más significativo en la serie temporal. Número de cambios—Cada píxel contendrá el número total de veces que cambió en la serie temporal. Hora del cambio más largo—Cada píxel contendrá la fecha de cambio al principio o al final del segmento de transición más largo en la serie temporal. Hora del cambio más corto—Cada píxel contendrá la fecha de cambio al principio o al final del segmento de transición más corto en la serie temporal. Hora del cambio más rápido—Cada píxel contendrá la fecha de cambio al principio o al final de la transición que se produjo más rápido. Hora del cambio más lento—Cada píxel contendrá la fecha de cambio al principio o al final de la transición que se produjo más lento.	String
Número máximo de cambios (Opcional)	El número máximo de cambios por píxel que se calculará. Este número corresponde al número de bandas del ráster de salida. El valor predeterminado es 1, lo cual significa que solamente se calculará una fecha de cambio y que el ráster de salida contendrá una sola banda. Este parámetro no está activo si el parámetro Tipo de cambio se define como Número de cambios.	Long
Fecha de segmento (Opcional)	Especifica si la fecha se extrae al principio de un segmento de cambio o al final. Este parámetro solo está disponible cuando el ráster de análisis de cambio de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. Inicio de segmento—Se extraerá la fecha al principio de un segmento de cambio. Esta es la opción predeterminada. Fin de segmento—Se extraerá la fecha al final de un segmento de cambio.	String
Cambiar dirección (Opcional)	Especifica la dirección de cambio que se incluirá en el análisis. Este parámetro solo está disponible cuando el ráster de análisis de cambio de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. Todas las indicaciones—Todas las direcciones de cambio se incluirán en la salida. Esta es la opción predeterminada. Creciente—Solo se incluirá en la salida un cambio en la dirección positiva o creciente. Decreciente—Solo se incluirá en la salida un cambio en la dirección negativa o decreciente.	String
Filtrar por año (Opcional)	Especifica si la salida se filtrará por un rango de años. Activado: los resultados se filtrarán para que en la salida solo se incluyan los cambios que se han producido dentro de un rango específico de años. Desactivado: los resultados no se filtrarán por año. Esta es la opción predeterminada.	Boolean
Valor mínimo (Opcional)	El año más antiguo que se utilizará para filtrar los resultados. Este parámetro es obligatorio cuando el parámetro Filtrar por año está activado.	Long
Valor Máximo (Opcional)	El año más reciente que se utilizará para filtrar los resultados. Este parámetro es obligatorio cuando el parámetro Filtrar por año está activado.	Long
Filtrar por duración (Opcional)	Especifica si los resultados se filtrarán por la duración del cambio. Este parámetro solo está activo si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. Activado: los resultados se filtrarán por duración de modo que en la salida solo se incluyan los cambios que duraron una cantidad de tiempo determinada. Desactivado: los resultados no se filtrarán por duración. Esta es la opción predeterminada.	Boolean
Duración mínima (en años) (Opcional)	El número mínimo de años consecutivos que se incluirán en los resultados. Este parámetro es obligatorio cuando el parámetro Filtrar por duración está activado.	Double
Duración máxima (en años) (Opcional)	El número máximo de años consecutivos que se incluirán en los resultados. Este parámetro es obligatorio cuando el parámetro Filtrar por duración está activado.	Double
Filtrar por magnitud (Opcional)	Especifica si los resultados se filtrarán por magnitud de cambio. Activado: los resultados se filtrarán por magnitud de modo que solo se incluyan en la salida los cambios de una magnitud determinada. Desactivado: los resultados no se filtrarán por magnitud. Esta es la opción predeterminada. Especifica si los resultados se filtrarán por magnitud de cambio. FILTER_BY_MAGNITUDE—Los resultados se filtrarán por magnitud de modo que solo se incluyan en la salida los cambios de una magnitud determinada. NO_FILTER_BY_MAGNITUDE—Los resultados no se filtrarán por magnitud. Esta es la opción predeterminada.	Boolean
Magnitud mínima (Opcional)	La magnitud mínima que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro Filtrar por magnitud está activado.	Double
Magnitud máxima (Opcional)	La magnitud máxima que se incluirá en los resultados. Este parámetro es obligatorio cuando el parámetro Filtrar por duración está activado.	Double
Filtrar por valor inicial (Opcional)	Especifica si los resultados se filtrarán por valor inicial. Este parámetro solo está activo si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. Activado: los resultados se filtrarán por valor inicial para que solo se incluyan en la salida los cambios de un valor inicial determinado. Desactivado: los resultados no se filtrarán por valor inicial. Esta es la opción predeterminada.	Boolean
Valor inicial mínimo (Opcional)	El valor inicial mínimo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro Filtrar por valor inicial está activado.	Double
Valor inicial máximo (Opcional)	El valor inicial máximo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro Filtrar por valor inicial está activado.	Double
Filtrar por valor final (Opcional)	Especifica si los resultados se filtrarán por valor final. Este parámetro solo está activo si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. Activado: los resultados se filtrarán por valor final para que solo se incluyan en la salida los cambios de un valor final determinado. Desactivado: los resultados no se filtrarán por valor final. Esta es la opción predeterminada.	Boolean
Valor final mínimo (Opcional)	El valor final mínimo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro Filtrar por valor final está activado.	Double
Valor final máximo (Opcional)	El valor final máximo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro Filtrar por valor final está activado.	Double

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida que contiene la información de cambio detectada.	Raster

Python

DetectChangeUsingChangeAnalysisRaster(in_change_analysis_raster, {change_type}, {max_number_changes}, {segment_date}, {change_direction}, {filter_by_year}, {min_year}, {max_year}, {filter_by_duration}, {min_duration}, {max_duration}, {filter_by_magnitude}, {min_magnitude}, {max_magnitude}, {filter_by_start_value}, {min_start_value}, {max_start_value}, {filter_by_end_value}, {min_end_value}, {max_end_value})

Nombre	Explicación	Tipo de datos
in_change_analysis_raster	El ráster de análisis de cambios generado con la herramienta Analizar cambios usando CCDC o la herramienta Analizar cambios usando LandTrendr.	Raster Dataset; Raster Layer; Image Service
change_type (Opcional)	Especifica la información de cambio que se calculará para cada píxel. TIME_OF_LATEST_CHANGE—Cada píxel contendrá la fecha de su cambio más reciente en la serie temporal. Esta es la opción predeterminada. TIME_OF_EARLIEST_CHANGE—Cada píxel contendrá la fecha de su cambio más temprano en la serie temporal. TIME_OF_LARGEST_CHANGE—Cada píxel contendrá la fecha de su cambio más significativo en la serie temporal. NUM_OF_CHANGES—Cada píxel contendrá el número total de veces que cambió en la serie temporal. TIME_OF_LONGEST_CHANGE—Cada píxel contendrá la fecha de cambio al principio o al final del segmento de transición más largo en la serie temporal. TIME_OF_SHORTEST_CHANGE—Cada píxel contendrá la fecha de cambio al principio o al final del segmento de transición más corto en la serie temporal. TIME_OF_FASTEST_CHANGE—Cada píxel contendrá la fecha de cambio al principio o al final de la transición que se produjo más rápido. TIME_OF_SLOWEST_CHANGE—Cada píxel contendrá la fecha de cambio al principio o al final de la transición que se produjo más lento.	String
max_number_changes (Opcional)	El número máximo de cambios por píxel que se calculará. Este número corresponde al número de bandas del ráster de salida. El valor predeterminado es 1, lo cual significa que solamente se calculará una fecha de cambio y que el ráster de salida contendrá una sola banda. Este parámetro no está habilitado si el parámetro change_type se define como NUM_OF_CHANGES.	Long
segment_date (Opcional)	Especifica si la fecha se extrae al principio de un segmento de cambio o al final. Este parámetro solo está disponible cuando el ráster de análisis de cambio de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. BEGINNING_OF_SEGMENT—Se extraerá la fecha al principio de un segmento de cambio. Esta es la opción predeterminada. END_OF_SEGMENT—Se extraerá la fecha al final de un segmento de cambio.	String
change_direction (Opcional)	Especifica la dirección de cambio que se incluirá en el análisis. Este parámetro solo está disponible cuando el ráster de análisis de cambio de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. ALL—Todas las direcciones de cambio se incluirán en la salida. Esta es la opción predeterminada. INCREASE—Solo se incluirá en la salida un cambio en la dirección positiva o creciente. DECREASE—Solo se incluirá en la salida un cambio en la dirección negativa o decreciente.	String
filter_by_year (Opcional)	Especifica si la salida se filtrará por un rango de años. FILTER_BY_YEAR—Los resultados se filtrarán para que en la salida solo se incluyan los cambios que se han producido dentro de un rango específico de años. NO_FILTER_BY_YEAR—Los resultados no se filtrarán por año. Esta es la opción predeterminada.	Boolean
min_year (Opcional)	El año más antiguo que se utilizará para filtrar los resultados. Este parámetro es obligatorio si el parámetro filter_by_year se define como FILTER_BY_YEAR.	Long
max_year (Opcional)	El año más reciente que se utilizará para filtrar los resultados. Este parámetro es obligatorio si el parámetro filter_by_year se define como FILTER_BY_YEAR.	Long
filter_by_duration (Opcional)	Especifica si los resultados se filtrarán por la duración del cambio. Este parámetro solo está habilitado si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. FILTER_BY_DURATION—Los resultados se filtrarán por duración de modo que en la salida solo se incluyan los cambios que duraron una cantidad de tiempo determinada. NO_FILTER_BY_DURATION—Los resultados no se filtrarán por duración. Esta es la opción predeterminada.	Boolean
min_duration (Opcional)	El número mínimo de años consecutivos que se incluirán en los resultados. Este parámetro es obligatorio si el parámetro filter_by_duration se define como FILTER_BY_DURATION.	Double
max_duration (Opcional)	El número máximo de años consecutivos que se incluirán en los resultados. Este parámetro es obligatorio si el parámetro filter_by_duration se define como FILTER_BY_DURATION.	Double
filter_by_magnitude (Opcional)	Especifica si los resultados se filtrarán por magnitud de cambio. Activado: los resultados se filtrarán por magnitud de modo que solo se incluyan en la salida los cambios de una magnitud determinada. Desactivado: los resultados no se filtrarán por magnitud. Esta es la opción predeterminada. Especifica si los resultados se filtrarán por magnitud de cambio. FILTER_BY_MAGNITUDE—Los resultados se filtrarán por magnitud de modo que solo se incluyan en la salida los cambios de una magnitud determinada. NO_FILTER_BY_MAGNITUDE—Los resultados no se filtrarán por magnitud. Esta es la opción predeterminada.	Boolean
min_magnitude (Opcional)	La magnitud mínima que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro filter_by_magnitude se define como FILTER_BY_MAGNITUDE.	Double
max_magnitude (Opcional)	La magnitud máxima que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro filter_by_magnitude se define como FILTER_BY_MAGNITUDE.	Double
filter_by_start_value (Opcional)	Especifica si los resultados se filtrarán por valor inicial. Este parámetro solo está habilitado si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. FILTER_BY_START_VALUE—Los resultados se filtrarán por valor inicial para que solo se incluyan en la salida los cambios de un valor inicial determinado. NO_FILTER_BY_START_VALUE—Los resultados no se filtrarán por valor inicial. Esta es la opción predeterminada.	Boolean
min_start_value (Opcional)	El valor inicial mínimo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro filter_by_start_value se define como FILTER_BY_START_VALUE.	Double
max_start_value (Opcional)	El valor inicial máximo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro filter_by_start_value se define como FILTER_BY_START_VALUE.	Double
filter_by_end_value (Opcional)	Especifica si los resultados se filtrarán por valor final. Este parámetro solo está habilitado si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr. FILTER_BY_END_VALUE—Los resultados se filtrarán por valor final para que solo se incluyan en la salida los cambios de un valor final determinado. NO_FILTER_BY_END_VALUE—Los resultados no se filtrarán por valor final. Esta es la opción predeterminada.	Boolean
min_end_value (Opcional)	El valor final mínimo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro filter_by_end_value se define como FILTER_BY_END_VALUE.	Double
max_end_value (Opcional)	El valor final máximo que se incluirá en los resultados. Este parámetro es obligatorio si el parámetro filter_by_end_value se define como FILTER_BY_END_VALUE.	Double

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster de salida que contiene la información de cambio detectada.	Raster

Muestra de código

Ejemplo 1 de DetectChangeUsingChangeAnalysisRaster (ventana de Python)

Este ejemplo devuelve la fecha de finalización del periodo más largo de la recuperación NDVI (valores crecientes), donde el cambio tenía una magnitud entre 0,25 y 2.

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

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

# Execute
dateOfLongestChange = arcpy.ia.DetectChangeUsingChangeAnalysis(
	"LandTrendr_NDVI_Change_Analysis.crf", "TIME_OF_LONGEST_CHANGE", 1, "INCREASE", 
	"NO_FILTER_BY_YEAR",None,None,"NO_FILTER_BY_DURATION",None,None,"FILTER_BY_MAGNITUDE",
	0.25,2)

# Save output
dateOfLongestChange.save(r"C:\data\NDVI_LongestChange.crf")

Ejemplo 2 de DetectChangeUsingChangeAnalysisRaster (script independiente)

En este ejemplo se devuelve el número total de veces que los píxeles han cambiado en una serie temporal de Landsat.

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

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

# Define input parameters
in_change_analysis = r"C:\data\Landsat_ChangeAnalysis.crf"
change_type = "NUM_OF_CHANGES"

# Execute
number_of_changes = arcpy.ia.DetectChangeUsingChangeAnalysis(
	in_change_analysis, change_type)

# Save output
number_of_changes.save("C:/data/NumberOfChanges_Landsat.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, 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