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 y 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.
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 elegir si desea 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, si está buscando 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, si solo está buscando cambios abruptos que se produjeran en 1 o 2 años. Puede calcular la duración que le interese con 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, si solo está buscando 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.
Sintaxis
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})| Parámetro | Explicación | Tipo de datos |
in_change_analysis_raster | El ráster de análisis de cambios generado con la herramienta Analizar cambios usando CCDCo la herramienta Analizar cambios usando LandTrendr. | Raster Dataset; Raster Layer; Image Service |
change_type (Opcional) | Especifica la información de cambio que se va a calcular para cada píxel.
| 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á disponible 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 si el ráster de análisis de cambios de entrada es la salida de la herramienta Analizar cambios usando LandTrendr.
| String |
change_direction (Opcional) | Especifica la dirección del 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.
| String |
filter_by_year (Opcional) | Especifica si se filtrará por un rango de años.
| Boolean |
min_year (Opcional) | El año más antiguo que se debe usar 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 último año que se debe usar 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 se filtrará por la duración del cambio. 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.
| 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 se filtrará por la magnitud del cambio.
Especifica si se filtrará por la magnitud del cambio.
| 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_DURATION. | 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_duration se define como FILTER_BY_DURATION. | 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
Este ejemplo devuelve la fecha de finalización del periodo más largo de la recuperación NDVI (valores crecientes) donde el cambio era 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")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
Información de licenciamiento
- Basic: Requiere Image Analyst
- Standard: Requiere Image Analyst
- Advanced: Requiere Image Analyst