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

Disponible avec une licence Image Analyst.

Résumé

Génère un raster contenant les informations de modification de pixel à l’aide du raster d’analyse de modification en sortie depuis l’outil Analyser les modifications avec l’algorithme CCDC ou Analyser les modifications avec l’algorithme LandTrendr.

Utilisation

  • Cet outil utilise un raster d’analyse des changements généré via l’outil Analyser les changements avec CCDC ou l’outil Analyser les changements avec LandTrendr afin de générer un raster contenant des informations de point de changement.

    Les rasters d’analyse des changements contiennent des informations de modèle sur la manière dont chaque pixel a changé au fil du temps et cet outil analyse ces informations.

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

    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.

  • Lorsque cet outil est exécuté sur la sortie de l’outil Analyser les changements avec LandTrendr, vous pouvez choisir d’extraire ou non la date marquant le début 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 des dates de changement plus spécifiques de votre raster d’analyse des changements :

    • Filter by year (Filtrer par année) : identifiez les changements qui se sont produits dans une période spécifique (par exemple, si vous recherchez les changements qui se sont produits dans un paysage pendant cinq années de sécheresse).
    • Filter by duration (Filtrer par durée) : identifiez les changements qui se sont produits sur une plage d’années spécifique (par exemple, si vous recherchez les changements abrupts s’étant produits sur un ou deux ans). Vous pouvez calculer la durée qui vous intéresse à l’aide de la formule 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, si vous ne recherchez que les changements importants dans les données NDVI de l’indice de végétation). 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).

Syntaxe

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})
ParamètreExplicationType de données
in_change_analysis_raster

Le raster d’analyse des changements généré à partir de l’outil Analyser les changements avec CCDCou de l’outil Analyser les changements avec LandTrendr.

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

Spécifie les informations de changement à calculer 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)

Nombre maximal de changements par pixel à calculer. 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 disponible lorsque le paramètre change_type est défini sur NUM_OF_CHANGES.

Long
segment_date
(Facultatif)

Indique d’extraire ou non la date au début d’un segment de changement ou à la fin.

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_SEGMENTExtrait la date au début d’un segment de changement. Il s’agit de l’option par défaut.
  • END_OF_SEGMENTExtrait la date à la fin d’un segment de changement.
String
change_direction
(Facultatif)

Spécifiez la direction du changement à inclure 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 sont incluses dans la sortie. Il s’agit de l’option par défaut.
  • INCREASESeul un changement dans la direction positive ou croissante est inclus dans la sortie.
  • DECREASESeul un changement dans la direction négative ou décroissante est inclus dans la sortie.
String
filter_by_year
(Facultatif)

Indique de filtrer ou non selon une plage d’années.

  • FILTER_BY_YEARFiltrez les résultats de sorte que seuls les changements s’étant produits dans une plage d’années spécifique sont inclus dans la sortie.
  • NO_FILTER_BY_YEARNe pas filtrer les résultats par année. Il s’agit de l’option par défaut.
Boolean
min_year
(Facultatif)

La première année à utiliser pour filtrer les résultats. Ce paramètre est obligatoire si le paramètre filter_by_year est défini sur FILTER_BY_YEAR.

Long
max_year
(Facultatif)

La dernière année à utiliser pour filtrer les résultats.

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

Long
filter_by_duration
(Facultatif)

Indique de filtrer ou non selon la durée du 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.

  • FILTER_BY_DURATIONFiltre les résultats par durée de sorte que seuls les changements ayant duré un laps de temps donné sont inclus dans la sortie.
  • NO_FILTER_BY_DURATIONNe filtre pas les résultats 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 obligatoire si le paramètre filter_by_duration est défini sur FILTER_BY_DURATION.

Double
max_duration
(Facultatif)

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

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

Double
filter_by_magnitude
(Facultatif)

Indique de filtrer ou non selon la magnitude du changement.

  • Sélectionné : filtre les résultats par magnitude de sorte que seuls les changements d’une magnitude donnée sont inclus dans la sortie.
  • Non sélectionné : ne filtre pas les résultats par magnitude. Il s’agit de l’option par défaut.

Indique de filtrer ou non selon la magnitude du changement.

  • FILTER_BY_MAGNITUDEFiltre les résultats par magnitude de sorte que seuls les changements d’une magnitude donnée sont inclus dans la sortie.
  • NO_FILTER_BY_MAGNITUDENe filtre pas les résultats par magnitude. Il s’agit de l’option par défaut.
Boolean
min_magnitude
(Facultatif)

Magnitude minimale à inclure dans les résultats.

Ce paramètre est obligatoire si le paramètre filter_by_magnitude est défini sur FILTER_BY_DURATION.

Double
max_magnitude
(Facultatif)

Magnitude maximale à inclure dans les résultats.

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

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) où le changement présentait une magnitude 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
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")
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")

Informations de licence

  • Basic: Requiert Image Analyst
  • Standard: Requiert Image Analyst
  • Advanced: Requiert Image Analyst

Rubriques connexes