Détecter les changements à l’aide du raster d’analyse des changements (Image Analyst)

Disponible avec une licence Image Analyst.

Synthèse

Génère un raster contenant des informations sur les modifications des valeurs en pixels à l’aide du raster d’analyse des changements en sortie de l’outil Analyser les modifications avec l’algorithme CCDC ou Analyser les changements avec l’algorithme LandTrendr.

Utilisation

  • Cet outil utilise un raster d’analyse des changements produit par l’outil Analyser les changements avec l’algorithme CCDC ou l’outil Analyser les changements avec l’algorithme LandTrendr pour générer un raster comprenant des informations sur les points de changement.

    Les rasters d’analyse des changements contiennent des informations propres au modèle et relatives aux variations de chaque pixel au fil du temps. Cet outil analyse cette information.

  • Le paramètre Change Type (Type de changement) indique les informations qui seront générées. Les informations sont extraites du raster d’analyse des changements.

    Lorsque cet outil est exécuté sur la sortie de l’outil Analyser les changements avec CCDC, vous pouvez effectuer un choix parmi les options suivantes :

    • Time of latest change (Heure du dernier changement) : la date et l’heure les plus récentes auxquelles un pixel a été marqué comme modifié.
    • Time of earliest change (Heure du premier changement) : la date et l’heure les plus anciennes auxquelles un pixel a été marqué comme modifié.
    • Time of largest change (Heure du changement le plus important) : la date et l’heure auxquelles le changement calculé était le plus important pour un pixel.
    • Number of Changes (Nombre de changements) : le nombre total de fois où le pixel a été modifié.

    Pour plus d’informations, reportez-vous à la rubrique Fonctionnement de l’outil Analyser les changements avec CCDC.

    Lorsque cet outil est exécuté sur la sortie de l’outil Analyser les changements avec LandTrendr, les options supplémentaires suivantes sont disponibles :

    • Time of longest change (Heure du changement le plus long) : la date et l’heure auxquelles un pixel a été signalé comme modifié, au début ou à la fin de la période de changement la plus longue.
    • Time of shortest change (Heure du changement le plus court) : la date et l’heure auxquelles un pixel a été signalé comme modifié, au début ou à la fin de la période de changement la plus courte.
    • Time of fastest change (Heure du changement le plus rapide) : la date et l’heure auxquelles un pixel a été signalé comme modifié, au début ou à la fin de la période de changement la plus rapide.
    • Time of slowest change (Heure du changement le plus lent) : la date et l’heure auxquelles un pixel a été signalé comme modifié, au début ou à la fin de la période de changement la plus lente.
    • Filter by Start Value (Filtrer par valeur de départ) : filtre les résultats par valeur de départ de façon à ce que seuls les changements d’une valeur de départ donnée soient inclus dans la sortie.
    • Filter by End Value (Filtrer par valeur de fin) : filtre les résultats selon la valeur de fin de façon à ce que seuls les changements d’une valeur de fin donnée soient inclus dans la sortie.

  • Les paramètres Filter by Start Value (Filtrer par valeur de départ) et Filter by End Value (Filtrer par valeur de fin) utilisent les valeurs ajustées de la réflectance de surface du raster d’analyse des changements contenant les coefficients du modèle. Les valeurs ajustées indiquent le moment où un changement s’est produit par une rupture du segment linéaire de la valeur ajustée lorsqu’il est tracé dans un graphique de profil temporel.

    Pour plus d’informations, reportez-vous à la rubrique Fonctionnement de l’outil Analyser les changements avec LandTrendr.

  • La sortie désigne un raster multicanal dans lequel chaque canal contient des informations de changement selon le type de changement sélectionné et le nombre maximal de changements spécifiés. Par exemple, si le paramètre Change Type (Type de changement) est défini sur Time of earliest change (Heure du premier changement) et le paramètre Maximum Number of Changes (Nombre maximal de changements) sur 2, la fonction calcule les deux dates les plus anciennes du changement tout au long de la série chronologique pour chaque pixel. Le résultat est un raster dans lequel le premier canal contient les dates du premier changement par pixel, et le second canal contient les dates du deuxième changement le plus ancien par pixel.

  • Lors de l’exécution de cet outil sur la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr, vous pouvez extraire la date marquant le début d’un changement ou la fin d’un changement à l’aide du paramètre Segment Date (Date de segment). Par exemple, pour comprendre comment le changement le plus récent dans la chronologie a commencé, définissez le paramètre Change Type (Type de changement) sur Time of latest change (Heure du dernier changement) et le paramètre Segment Date (Date de segment) sur Beginning of segment (Début du segment).

  • Utilisez les paramètres de filtrage suivants pour extraire d’autres dates de changement spécifiques du raster d’analyse des changements :

    • Filter by year (Filtrer par année) : identifiez les changements survenus au cours d’une période spécifique ; par exemple, lorsque vous recherchez les changements survenus dans un paysage au cours de 5 années de sécheresse.
    • Filter by duration (Filtrer par durée) : identifiez les changements survenus sur un nombre d’années spécifique ; par exemple, des changements soudains survenus sur un ou deux ans. Vous pouvez calculer la durée à l’aide de la formule suivante : end year - start year +1. Les discontinuités dans la chronologie seront incluses.
    • Filter by magnitude (Filtrer par magnitude) : identifiez les changements d’une magnitude donnée ; par exemple, des changements importants dans l’indice de végétation NDVI. La magnitude étant une valeur absolue, les valeurs minimale et maximale ne peuvent pas être négatives. Pour spécifier le changement directionnel, utilisez le paramètre Change Direction (Changer de direction).

Paramètres

ÉtiquetteExplicationType de données
Raster d’analyse des changements en entrée

Raster d’analyse des changements généré par l’outil Analyser les changements avec l’algorithme CCDC ou l’outil Analyser les changements avec l’algorithme LandTrendr.

Raster Dataset; Raster Layer; Image Service
Modifier le type
(Facultatif)

Spécifie les informations de changement qui seront calculées pour chaque pixel.

  • Heure du changement le plus récentChaque pixel comprend la date de son changement le plus récent dans la série chronologique. Il s’agit de l’option par défaut.
  • Heure du premier changementChaque pixel comprend la date de son premier changement dans la série chronologique.
  • Heure du changement le plus importantChaque pixel comprend la date de son changement le plus significatif dans la série chronologique.
  • Nombre de changementsChaque pixel comprend le nombre total de fois qu’il a changé dans la série chronologique.
  • Heure du changement le plus longChaque segment comprend la date du changement au début ou à la fin du segment de transition le plus long dans la série chronologique.
  • Heure du changement le plus courtChaque segment comprend la date du changement au début ou à la fin du segment de transition le plus court dans la série chronologique.
  • Heure du changement le plus rapideChaque segment comprend la date du changement au début ou à la fin de la transition ayant eu lieu de plus rapidement.
  • Heure du changement le plus lentChaque segment comprend la date du changement au début ou à la fin de la transition ayant eu lieu de plus lentement.
String
Nombre maximal de changements
(Facultatif)

Le nombre maximal de changements par pixel qui sera calculé. Ce nombre correspond au nombre de canaux dans le raster en sortie. Par défaut, la valeur est 1. Autrement dit, une seule date de changement est calculée, et le raster en sortie ne comprend qu’un seul canal.

Ce paramètre n’est pas actif lorsque le paramètre Change Type (Type de changement) est défini sur Number of changes (Nombre de changements).

Long
Date de segment
(Facultatif)

Spécifie si la date sera extraite au début ou à la fin d’un segment de changement.

Ce paramètre n’est disponible que si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec LandTrendr.

  • Début du segmentLa date au début d’un segment de changement sera extraite. Il s’agit de l’option par défaut.
  • Fin du segmentLa date à la fin d’un segment de changement sera extraite.
String
Modifier la direction
(Facultatif)

Spécifie la direction du changement qui sera incluse dans l’analyse.

Ce paramètre n’est disponible que si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec LandTrendr.

  • Toutes les directionsToutes les directions de changement seront incluses dans la sortie. Il s’agit de l’option par défaut.
  • CroissanteSeuls les changements dont la direction est positive ou croissante seront inclus dans la sortie.
  • DécroissanteSeuls les changements dont la direction est négative ou décroissante seront inclus dans la sortie.
String
Filtrer par année
(Facultatif)

Spécifie si le filtrage de la sortie s’effectuera sur un certain nombre d’années.

  • Activé : les résultats seront filtrés de façon à ce que seuls les changements survenus pendant un certain nombre d’années soient inclus dans la sortie.
  • Désactivé : les résultats ne seront pas filtrés par année. Il s’agit de l’option par défaut.

Boolean
Valeur minimale
(Facultatif)

L’année la plus ancienne qui sera utilisée pour filtrer les résultats. Ce paramètre est obligatoire si le paramètre Filter by Year (Filtrer par année) est activé.

Long
Valeur maximale
(Facultatif)

L’année la plus récente qui sera utilisée pour filtrer les résultats.

Ce paramètre est obligatoire si le paramètre Filter by Year (Filtrer par année) est activé.

Long
Filtrer par durée
(Facultatif)

Spécifie si les résultats seront filtrés en fonction de la durée des changements.

Ce paramètre est actif uniquement si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr.

  • Activé : les résultats seront filtrés par durée, de façon à ce que seuls les changements ayant une durée donnée soient inclus dans la sortie.
  • Désactivé : les résultats ne seront pas filtrés par durée. Il s’agit de l’option par défaut.

Boolean
Durée minimale (en années)
(Facultatif)

Nombre minimal d’années consécutives à inclure dans les résultats.

Ce paramètre est obligatoire si le paramètre Filter by Duration (Filtrer par durée) est activé.

Double
Durée maximale (en années)
(Facultatif)

Nombre maximum d’années consécutives à inclure dans les résultats.

Ce paramètre est obligatoire si le paramètre Filter by Duration (Filtrer par durée) est activé.

Double
Filtrer par magnitude
(Facultatif)

Spécifie si les résultats seront filtrés en fonction de la magnitude des changements..

  • Activé : les résultats seront filtrés par magnitude, de façon à ce que seuls les changements ayant une magnitude donnée soient inclus dans la sortie.
  • Désactivé : les résultats ne seront pas filtrés par magnitude. Il s’agit de l’option par défaut.

Spécifie si les résultats seront filtrés en fonction de la magnitude des changements..

  • FILTER_BY_MAGNITUDELes résultats seront filtrés par magnitude, de façon à ce que seuls les changements ayant une magnitude donnée soient inclus dans la sortie.
  • NO_FILTER_BY_MAGNITUDELes résultats ne seront pas filtrés par magnitude. Il s’agit de l’option par défaut.
Boolean
Magnitude minimale
(Facultatif)

La magnitude minimum à inclure dans les résultats.

Ce paramètre est requis si le paramètre Filter by Magnitude (Filtrer par magnitude) est sélectionné.

Double
Magnitude maximale
(Facultatif)

La magnitude maximum à inclure dans les résultats.

Ce paramètre est obligatoire si le paramètre Filter by Duration (Filtrer par durée) est activé.

Double
Filtrer par valeur de départ
(Facultatif)

Spécifie si les résultats seront filtrés selon la valeur de départ.

Ce paramètre est actif uniquement si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr.

  • Activé : les résultats seront filtrés selon la valeur de départ, de façon à ce que seuls les changements ayant une valeur de départ donnée soient inclus dans la sortie.
  • Désactivé : les résultats ne seront pas filtrés par valeur de départ. Il s’agit de l’option par défaut.

Boolean
Valeur de départ minimale
(Facultatif)

La valeur de départ minimale à inclure dans les résultats.

Ce paramètre est requis si le paramètre Filter by Start Value (Filtrer par valeur de départ) est sélectionné.

Double
Valeur de départ maximale
(Facultatif)

La valeur de départ maximum à inclure dans les résultats.

Ce paramètre est requis si le paramètre Filter by Start Value (Filtrer par valeur de départ) est sélectionné.

Double
Filtrer par valeur de fin
(Facultatif)

Spécifie si les résultats seront filtrés selon la valeur de fin.

Ce paramètre est actif uniquement si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr.

  • Activé : les résultats seront filtrés selon la valeur de fin, de façon à ce que seuls les changements ayant une valeur de fin donnée soient inclus dans la sortie.
  • Désactivé : les résultats ne seront pas filtrés par valeur de fin. Il s’agit de l’option par défaut.

Boolean
Valeur de fin minimale
(Facultatif)

La valeur de fin minimale à inclure dans les résultats.

Ce paramètre est requis si le paramètre Filter by End Value (Filtrer par valeur de fin) est sélectionné.

Double
Valeur de fin maximale
(Facultatif)

La valeur de fin maximale à inclure dans les résultats.

Ce paramètre est requis si le paramètre Filter by End Value (Filtrer par valeur de fin) est sélectionné.

Double

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie contenant les informations de changement détectées.

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})
NomExplicationType de données
in_change_analysis_raster

Raster d’analyse des changements généré par l’outil Analyser les changements avec l’algorithme CCDC ou l’outil Analyser les changements avec l’algorithme LandTrendr.

Raster Dataset; Raster Layer; Image Service
change_type
(Facultatif)

Spécifie les informations de changement qui seront calculées pour chaque pixel.

  • TIME_OF_LATEST_CHANGEChaque pixel comprend la date de son changement le plus récent dans la série chronologique. Il s’agit de l’option par défaut.
  • TIME_OF_EARLIEST_CHANGEChaque pixel comprend la date de son premier changement dans la série chronologique.
  • TIME_OF_LARGEST_CHANGEChaque pixel comprend la date de son changement le plus significatif dans la série chronologique.
  • NUM_OF_CHANGESChaque pixel comprend le nombre total de fois qu’il a changé dans la série chronologique.
  • TIME_OF_LONGEST_CHANGEChaque segment comprend la date du changement au début ou à la fin du segment de transition le plus long dans la série chronologique.
  • TIME_OF_SHORTEST_CHANGEChaque segment comprend la date du changement au début ou à la fin du segment de transition le plus court dans la série chronologique.
  • TIME_OF_FASTEST_CHANGEChaque segment comprend la date du changement au début ou à la fin de la transition ayant eu lieu de plus rapidement.
  • TIME_OF_SLOWEST_CHANGEChaque segment comprend la date du changement au début ou à la fin de la transition ayant eu lieu de plus lentement.
String
max_number_changes
(Facultatif)

Le nombre maximal de changements par pixel qui sera calculé. Ce nombre correspond au nombre de canaux dans le raster en sortie. Par défaut, la valeur est 1. Autrement dit, une seule date de changement est calculée, et le raster en sortie ne comprend qu’un seul canal.

Ce paramètre n’est pas activé lorsque le paramètre change_type est défini sur NUM_OF_CHANGES.

Long
segment_date
(Facultatif)

Spécifie si la date sera extraite au début ou à la fin d’un segment de changement.

Ce paramètre n’est disponible que si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec LandTrendr.

  • BEGINNING_OF_SEGMENTLa date au début d’un segment de changement sera extraite. Il s’agit de l’option par défaut.
  • END_OF_SEGMENTLa date à la fin d’un segment de changement sera extraite.
String
change_direction
(Facultatif)

Spécifie la direction du changement qui sera incluse dans l’analyse.

Ce paramètre n’est disponible que si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec LandTrendr.

  • ALLToutes les directions de changement seront incluses dans la sortie. Il s’agit de l’option par défaut.
  • INCREASESeuls les changements dont la direction est positive ou croissante seront inclus dans la sortie.
  • DECREASESeuls les changements dont la direction est négative ou décroissante seront inclus dans la sortie.
String
filter_by_year
(Facultatif)

Spécifie si le filtrage de la sortie s’effectuera sur un certain nombre d’années.

  • FILTER_BY_YEARLes résultats seront filtrés de façon à ce que seuls les changements survenus pendant un certain nombre d’années soient inclus dans la sortie.
  • NO_FILTER_BY_YEARLes résultats ne seront pas filtrés par année. Il s’agit de l’option par défaut.
Boolean
min_year
(Facultatif)

L’année la plus ancienne qui sera utilisée pour filtrer les résultats. Ce paramètre est requis si le paramètre filter_by_year est défini sur FILTER_BY_YEAR.

Long
max_year
(Facultatif)

L’année la plus récente qui sera utilisée pour filtrer les résultats.

Ce paramètre est requis si le paramètre filter_by_year est défini sur FILTER_BY_YEAR.

Long
filter_by_duration
(Facultatif)

Spécifie si les résultats seront filtrés en fonction de la durée des changements.

Ce paramètre est activé uniquement si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr.

  • FILTER_BY_DURATIONLes résultats seront filtrés par durée, de façon à ce que seuls les changements ayant une durée donnée soient inclus dans la sortie.
  • NO_FILTER_BY_DURATIONLes résultats ne seront pas filtrés par durée. Il s’agit de l’option par défaut.
Boolean
min_duration
(Facultatif)

Nombre minimal d’années consécutives à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_duration est défini sur FILTER_BY_DURATION.

Double
max_duration
(Facultatif)

Nombre maximum d’années consécutives à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_duration est défini sur FILTER_BY_DURATION.

Double
filter_by_magnitude
(Facultatif)

Spécifie si les résultats seront filtrés en fonction de la magnitude des changements..

  • Activé : les résultats seront filtrés par magnitude, de façon à ce que seuls les changements ayant une magnitude donnée soient inclus dans la sortie.
  • Désactivé : les résultats ne seront pas filtrés par magnitude. Il s’agit de l’option par défaut.

Spécifie si les résultats seront filtrés en fonction de la magnitude des changements..

  • FILTER_BY_MAGNITUDELes résultats seront filtrés par magnitude, de façon à ce que seuls les changements ayant une magnitude donnée soient inclus dans la sortie.
  • NO_FILTER_BY_MAGNITUDELes résultats ne seront pas filtrés par magnitude. Il s’agit de l’option par défaut.
Boolean
min_magnitude
(Facultatif)

La magnitude minimum à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_magnitude est défini sur FILTER_BY_MAGNITUDE.

Double
max_magnitude
(Facultatif)

La magnitude maximum à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_magnitude est défini sur FILTER_BY_MAGNITUDE.

Double
filter_by_start_value
(Facultatif)

Spécifie si les résultats seront filtrés selon la valeur de départ.

Ce paramètre est activé uniquement si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr.

  • FILTER_BY_START_VALUELes résultats seront filtrés selon la valeur de départ, de façon à ce que seuls les changements ayant une valeur de départ donnée soient inclus dans la sortie.
  • NO_FILTER_BY_START_VALUELes résultats ne seront pas filtrés par valeur de départ. Il s’agit de l’option par défaut.
Boolean
min_start_value
(Facultatif)

La valeur de départ minimale à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_start_value est défini sur FILTER_BY_START_VALUE.

Double
max_start_value
(Facultatif)

La valeur de départ maximum à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_start_value est défini sur FILTER_BY_START_VALUE.

Double
filter_by_end_value
(Facultatif)

Spécifie si les résultats seront filtrés selon la valeur de fin.

Ce paramètre est activé uniquement si le raster d’analyse des changements en entrée est la sortie de l’outil Analyser les changements avec l’algorithme LandTrendr.

  • FILTER_BY_END_VALUELes résultats seront filtrés selon la valeur de fin, de façon à ce que seuls les changements ayant une valeur de fin donnée soient inclus dans la sortie.
  • NO_FILTER_BY_END_VALUELes résultats ne seront pas filtrés par valeur de fin. Il s’agit de l’option par défaut.
Boolean
min_end_value
(Facultatif)

La valeur de fin minimale à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_end_value est défini sur FILTER_BY_END_VALUE.

Double
max_end_value
(Facultatif)

La valeur de fin maximale à inclure dans les résultats.

Ce paramètre est requis si le paramètre filter_by_end_value est défini sur FILTER_BY_END_VALUE.

Double

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie contenant les informations de changement détectées.

Raster

Exemple de code

Exemple 1 d’utilisation de l’outil DetectChangeUsingChangeAnalysisRaster (fenêtre Python)

Cet exemple renvoie la date de fin de la plus longue période de récupération NDVI (valeurs croissantes) dans laquelle la magnitude des changements était comprise entre 0,25 et 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")
Exemple 2 d’utilisation de l’outil DetectChangeUsingChangeAnalysisRaster (script autonome)

Cet exemple renvoie le nombre total de fois que les pixels ont changé dans une chronologie 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")

Rubriques connexes