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

EtiquetaExplicaciónTipo 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 recienteCada 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 tempranoCada píxel contendrá la fecha de su cambio más temprano en la serie temporal.
  • Hora del cambio más grandeCada píxel contendrá la fecha de su cambio más significativo en la serie temporal.
  • Número de cambiosCada píxel contendrá el número total de veces que cambió en la serie temporal.
  • Hora del cambio más largoCada 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 cortoCada 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ápidoCada 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 lentoCada 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 segmentoSe extraerá la fecha al principio de un segmento de cambio. Esta es la opción predeterminada.
  • Fin de segmentoSe 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 indicacionesTodas las direcciones de cambio se incluirán en la salida. Esta es la opción predeterminada.
  • CrecienteSolo se incluirá en la salida un cambio en la dirección positiva o creciente.
  • DecrecienteSolo 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_MAGNITUDELos resultados se filtrarán por magnitud de modo que solo se incluyan en la salida los cambios de una magnitud determinada.
  • NO_FILTER_BY_MAGNITUDELos 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

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida que contiene la información de cambio detectada.

Raster

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})
NombreExplicaciónTipo 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_CHANGECada píxel contendrá la fecha de su cambio más reciente en la serie temporal. Esta es la opción predeterminada.
  • TIME_OF_EARLIEST_CHANGECada píxel contendrá la fecha de su cambio más temprano en la serie temporal.
  • TIME_OF_LARGEST_CHANGECada píxel contendrá la fecha de su cambio más significativo en la serie temporal.
  • NUM_OF_CHANGESCada píxel contendrá el número total de veces que cambió en la serie temporal.
  • TIME_OF_LONGEST_CHANGECada 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_CHANGECada 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_CHANGECada 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_CHANGECada 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_SEGMENTSe extraerá la fecha al principio de un segmento de cambio. Esta es la opción predeterminada.
  • END_OF_SEGMENTSe 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.

  • ALLTodas las direcciones de cambio se incluirán en la salida. Esta es la opción predeterminada.
  • INCREASESolo se incluirá en la salida un cambio en la dirección positiva o creciente.
  • DECREASESolo 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_YEARLos 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_YEARLos 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_DURATIONLos 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_DURATIONLos 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_MAGNITUDELos resultados se filtrarán por magnitud de modo que solo se incluyan en la salida los cambios de una magnitud determinada.
  • NO_FILTER_BY_MAGNITUDELos 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_VALUELos 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_VALUELos 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_VALUELos 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_VALUELos 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

NombreExplicaciónTipo 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
dateOfLatestChange = arcpy.ia.DetectChangeUsingChangeAnalysis(
	"Monthly_NDVI_Change_Analysis.crf", "TIME_OF_LATEST_CHANGE", 1)

# Save output
dateOfLatestChange.save(r"C:\data\NDVI_LatestChanges.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")