Mit der Image Analyst-Lizenz verfügbar.
Zusammenfassung
Generiert mit dem vom Werkzeug Veränderungen mit CCDC analysieren oder Änderungen mit LandTrendr analysieren ausgegebenen Veränderungsanalyse-Raster ein Raster, das Pixeländerungsinformationen enthält.
Verwendung
Bei diesem Werkzeug wird ein Veränderungsanalyse-Raster verwendet, das mit dem Werkzeug Veränderungen mit CCDC analysieren oder dem Werkzeug Veränderungen mit LandTrendr analysieren erstellt wurde, um ein Raster mit Informationen zu geänderten Punkten zu erstellen.
Veränderungsanalyse-Raster enthalten Modellinformationen dazu, wie sich jedes Pixel im Laufe der Zeit verändert hat. Diese Informationen werden mit diesem Werkzeug analysiert.
Durch den Parameter Art der Änderung wird angegeben, welche Informationen erstellt werden. Die Informationen werden aus dem Veränderungsanalyse-Raster extrahiert.
Bei Ausführung des Werkzeugs für die Ausgabe des Werkzeugs Veränderungen mit CCDC analysieren können Sie eine der folgenden Optionen auswählen:
- Zeit der letzten Veränderung: Datum und Uhrzeit, zu denen ein Pixel zuletzt als verändert gekennzeichnet wurde
- Zeit der ersten Veränderung: Datum und Uhrzeit, zu denen ein Pixel das erste Mal als verändert gekennzeichnet wurde
- Zeit der größten Veränderung: Datum und Uhrzeit, zu denen die berechnete Veränderung die größte Signifikanz für ein Pixel aufwies
- Anzahl an Veränderungen: Die Gesamtzahl der Veränderungen an einem Pixel
Weitere Informationen finden Sie unter Funktionsweise von "Veränderungen mit CCDC analysieren".
Bei Ausführung des Werkzeugs für die Ausgabe des Werkzeugs Veränderungen mit LandTrendr analysieren stehen die folgenden zusätzlichen Optionen zur Verfügung:
- Zeit der längsten Änderung: Datum, zu dem ein Pixel als geändert gekennzeichnet wurde, am Anfang oder Ende des längsten Änderungszeitraums
- Zeit der kürzesten Änderung: Datum, zu dem ein Pixel als geändert gekennzeichnet wurde, am Anfang oder Ende des kürzesten Änderungszeitraums
- Zeit der schnellsten Änderung: Datum, zu dem ein Pixel als geändert gekennzeichnet wurde, am Anfang oder Ende des Zeitraums der schnellsten Änderung
- Zeit der langsamsten Änderung: Datum, zu dem ein Pixel als geändert gekennzeichnet wurde, am Anfang oder Ende des Zeitraums der langsamsten Änderung
Weitere Informationen finden Sie unter Funktionsweise von "Veränderungen mit LandTrendr analysieren".
Ausgegeben wird ein Multiband-Raster, dessen Bänder in Abhängigkeit des ausgewählten Änderungstyps und der angegebenen maximalen Anzahl an Änderungen Änderungsinformationen enthalten. Wenn beispielsweise der Parameter Art der Änderung auf Zeit der ersten Änderung und der Parameter Maximale Anzahl an Änderungen auf 2 festgelegt wird, berechnet das Werkzeug jeweils die zwei ersten Änderungen, die in der Zeitserie für die Pixel vorliegen. Ausgegeben wird ein Raster mit zwei Bändern, wobei das erste Band das Datum der ersten Veränderung jedes Pixels enthält und das zweite Band das Datum der zweitältesten Veränderung je Pixel.
Bei Ausführung dieses Werkzeugs für die Ausgabe des Werkzeugs Veränderungen mit LandTrendr analysieren können Sie optional mit dem Parameter Segmentdatum das Datum extrahieren, das den Anfang oder das Ende einer Veränderung markiert. Wenn Sie beispielsweise wissen möchten, wie die letzte Änderung in der Zeitserie begonnen hat, legen Sie den Parameter Art der Änderung auf Zeit der letzten Änderung und den Parameter Segmentdatum auf Anfang des Segments fest.
Verwenden Sie die folgenden Filterparameter, um spezifischere Datumsangaben zu Veränderungen aus dem Veränderungsanalyse-Raster zu extrahieren:
- Nach Jahr filtern: Hiermit identifizieren Sie Veränderungen, die innerhalb eines bestimmten Zeitraums eingetreten sind, z. B., wenn Sie nach Veränderungen in einer Landschaft während einer fünf Jahre andauernden Trockenheit suchen.
- Nach Dauer filtern: Hiermit identifizieren Sie Veränderungen, die über eine bestimmte Anzahl von Jahren hinweg eingetreten sind, z. B., wenn Sie nach abrupten Veränderungen über einen Zeitraum von einem oder zwei Jahren suchen. Die Dauer, für die Sie sich interessieren, können Sie mit der Formel end year - start year +1 berechnen. Lücken in der Zeitserie werden berücksichtigt.
- Nach Magnitude filtern: Hiermit identifizieren Sie Veränderungen einer bestimmten Magnitude, z. B., wenn Sie nur nach großen Veränderungen im Vegetationsindex NDVI suchen. Da die Magnitude ein absoluter Wert ist, dürfen der Minimal- und Maximalwert nicht negativ sein. Verwenden Sie zum Festlegen einer Richtungsänderung den Parameter Richtung der Änderung.
Syntax
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})
Parameter | Erklärung | Datentyp |
in_change_analysis_raster | Das Veränderungsanalyse-Raster, das mit dem Werkzeug Veränderungen mit CCDC analysieren oder dem Werkzeug Veränderungen mit LandTrendr analysieren erstellt wurde | Raster Dataset; Raster Layer; Image Service |
change_type (optional) | Gibt an, welche Änderungsdaten für jedes Pixel berechnet werden sollen.
| String |
max_number_changes (optional) | Die zu berechnende maximale Anzahl von Veränderungen pro Pixel. Diese Anzahl entspricht der Anzahl an Bändern im Ausgabe-Raster. Der Standardwert ist 1, wobei ein Änderungsdatum berechnet wird und das Ausgabe-Raster nur ein Band enthält. Dieser Parameter nicht verfügbar, wenn für den Parameter change_type die Option NUM_OF_CHANGES festgelegt wurde. | Long |
segment_date (optional) | Gibt an, ob das Datum am Anfang oder am Ende eines Veränderungssegments extrahiert werden soll. Dieser Parameter ist nur verfügbar, wenn das als Eingabe verwendete Veränderungsanalyse-Raster die Ausgabe des Werkzeugs Veränderungen mit LandTrendr analysieren ist.
| String |
change_direction (optional) | Gibt die Richtung der Veränderung an, die in die Analyse einbezogen werden soll. Dieser Parameter ist nur verfügbar, wenn das als Eingabe verwendete Veränderungsanalyse-Raster die Ausgabe des Werkzeugs Veränderungen mit LandTrendr analysieren ist.
| String |
filter_by_year (optional) | Gibt an, dass nach einem bestimmten Zeitraum von mehreren Jahren gefiltert werden soll.
| Boolean |
min_year (optional) | Das früheste Jahr, das zum Filtern der Ergebnisse verwendet werden soll. Dieser Parameter ist erforderlich, wenn der Parameter filter_by_year auf FILTER_BY_YEAR festgelegt ist. | Long |
max_year (optional) | Das späteste Jahr, das zum Filtern der Ergebnisse verwendet werden soll. Dieser Parameter ist erforderlich, wenn der Parameter filter_by_year auf FILTER_BY_YEAR festgelegt ist. | Long |
filter_by_duration (optional) | Gibt an, dass nach der Dauer der Veränderung gefiltert werden soll. Dieser Parameter ist nur verfügbar, wenn das als Eingabe verwendete Veränderungsanalyse-Raster die Ausgabe des Werkzeugs Veränderungen mit LandTrendr analysieren ist.
| Boolean |
min_duration (optional) | Die Mindestanzahl aufeinanderfolgender Jahre, die in die Ergebnisse aufgenommen werden sollen. Dieser Parameter ist erforderlich, wenn der Parameter filter_by_duration auf FILTER_BY_DURATION festgelegt ist. | Double |
max_duration (optional) | Die maximale Anzahl aufeinanderfolgender Jahre, die in die Ergebnisse aufgenommen werden sollen. Dieser Parameter ist erforderlich, wenn der Parameter filter_by_duration auf FILTER_BY_DURATION festgelegt ist. | Double |
filter_by_magnitude (optional) | Gibt an, dass nach der Magnitude der Veränderung gefiltert werden soll.
Gibt an, dass nach der Magnitude der Veränderung gefiltert werden soll.
| Boolean |
min_magnitude (optional) | Die Minimalmagnitude, die in die Ergebnisse aufgenommen werden soll. Dieser Parameter ist erforderlich, wenn der Parameter filter_by_magnitude auf FILTER_BY_DURATION festgelegt ist. | Double |
max_magnitude (optional) | Die Minimalmagnitude, die in die Ergebnisse aufgenommen werden sollen. Dieser Parameter ist erforderlich, wenn der Parameter filter_by_duration auf FILTER_BY_DURATION festgelegt ist. | Double |
Rückgabewert
Name | Erklärung | Datentyp |
out_raster | Das Ausgabe-Raster mit Informationen zu den erkannten Veränderungen | Raster |
Codebeispiel
Bei diesem Beispiel wird das Enddatum des längsten Zeitraums der NDVI-Wiederherstellung (steigende Werte) zurückgegeben, wobei die Veränderung eine Magnitude zwischen 0,25 und 2 aufwies.
# 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")
Bei diesem Beispiel wird für die Pixel die Gesamtzahl an Veränderungen in einer Landsat-Zeitserie zurückgegeben.
# 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")
Umgebungen
Lizenzinformationen
- Basic: Erfordert Image Analyst
- Standard: Erfordert Image Analyst
- Advanced: Erfordert Image Analyst