Veränderung mit Veränderungsanalyse-Raster erkennen (Image Analyst)

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})
ParameterErklärungDatentyp
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.

  • TIME_OF_LATEST_CHANGEDie einzelnen Pixel enthalten das Datum der jeweils letzten Änderung in der Zeitserie. Dies ist die Standardeinstellung.
  • TIME_OF_EARLIEST_CHANGEDie einzelnen Pixel enthalten das Datum der jeweils ersten Veränderung in der Zeitserie.
  • TIME_OF_LARGEST_CHANGEDie einzelnen Pixel enthalten das Datum der jeweiligen Veränderung mit der größten Signifikanz in der Zeitserie.
  • NUM_OF_CHANGESDie einzelnen Pixel enthalten für das jeweilige Pixel die Gesamtzahl an Veränderungen in der Zeitserie.
  • TIME_OF_LONGEST_CHANGEDie einzelnen Pixel enthalten das Datum der Veränderung am Anfang und am Ende des längsten Übergangssegments in der Zeitserie.
  • TIME_OF_SHORTEST_CHANGEDie einzelnen Pixel enthalten das Datum der Veränderung am Anfang und am Ende des kürzesten Übergangssegments in der Zeitserie.
  • TIME_OF_FASTEST_CHANGEDie einzelnen Pixel enthalten das Datum der Veränderung am Anfang und am Ende des Übergangs, der am schnellsten erfolgt ist.
  • TIME_OF_SLOWEST_CHANGEDie einzelnen Pixel enthalten das Datum der Veränderung am Anfang und am Ende des Übergangs, der am langsamsten erfolgt ist.
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.

  • BEGINNING_OF_SEGMENTExtrahieren Sie das Datum am Anfang eines Veränderungssegments. Dies ist die Standardeinstellung.
  • END_OF_SEGMENTExtrahieren Sie das Datum am Ende eines Veränderungssegments.
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.

  • ALLAlle Änderungsrichtungen werden in die Ausgabe aufgenommen. Dies ist die Standardeinstellung.
  • INCREASENur eine Veränderung in der positiven Richtung bzw. der Richtung der Erhöhung ist in der Ausgabe enthalten.
  • DECREASENur eine Veränderung in der negativen Richtung bzw. der Richtung der Verringerung ist in der Ausgabe enthalten.
String
filter_by_year
(optional)

Gibt an, dass nach einem bestimmten Zeitraum von mehreren Jahren gefiltert werden soll.

  • FILTER_BY_YEARDie Ergebnisse werden so gefiltert, dass nur Veränderungen innerhalb eines bestimmten Zeitraums von mehreren Jahren in die Ausgabe aufgenommen werden.
  • NO_FILTER_BY_YEARErgebnisse werden nicht nach Jahr gefiltert. Dies ist die Standardeinstellung.
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.

  • FILTER_BY_DURATIONErgebnisse werden nach Dauer gefiltert, sodass nur Veränderungen, die eine bestimmte Zeit andauerten, in die Ausgabe aufgenommen werden.
  • NO_FILTER_BY_DURATIONErgebnisse werden nicht nach Dauer gefiltert. Dies ist die Standardeinstellung.
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.

  • Aktiviert: Ergebnisse werden nach Magnitude gefiltert, sodass nur Veränderungen einer bestimmten Magnitude in die Ausgabe aufgenommen werden.
  • Nicht aktiviert: Ergebnisse werden nicht nach Magnitude gefiltert. Dies ist die Standardeinstellung.

Gibt an, dass nach der Magnitude der Veränderung gefiltert werden soll.

  • FILTER_BY_MAGNITUDEErgebnisse werden nach Magnitude gefiltert, sodass nur Veränderungen einer bestimmten Magnitude in die Ausgabe aufgenommen werden.
  • NO_FILTER_BY_MAGNITUDEErgebnisse werden nicht nach Magnitude gefiltert. Dies ist die Standardeinstellung.
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

NameErklärungDatentyp
out_raster

Das Ausgabe-Raster mit Informationen zu den erkannten Veränderungen

Raster

Codebeispiel

DetectChangeUsingChangeAnalysisRaster – Beispiel 1 (Python-Fenster)

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")
DetectChangeUsingChangeAnalysisRaster – Beispiel 2 (eigenständiges Skript)

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")

Lizenzinformationen

  • Basic: Erfordert Image Analyst
  • Standard: Erfordert Image Analyst
  • Advanced: Erfordert Image Analyst

Verwandte Themen