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ètre | Explication | Type 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.
| 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.
| 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.
| String |
filter_by_year (Facultatif) | Indique de filtrer ou non selon une plage d’années.
| 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.
| 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.
Indique de filtrer ou non selon la magnitude du changement.
| 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
Nom | Explication | Type de données |
out_raster | Raster en sortie contenant les informations de changement détectées. | Raster |
Exemple de code
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")
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")
Environnements
Informations de licence
- Basic: Requiert Image Analyst
- Standard: Requiert Image Analyst
- Advanced: Requiert Image Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?