Определить изменения, используя растр анализа изменений (Image Analyst)

Доступно с лицензией Image Analyst.

Сводка

Создает растр, содержащий информацию об изменении значений пикселов, используя выходной растр анализа изменений из инструмента Анализ изменений с помощью CCDC или Анализ изменений с помощью LandTrendr.

Использование

  • Этот инструмент использует растр анализа изменений, созданный из инструмента Анализировать изменения с помощью CCDC или инструмента Анализировать изменения с помощью LandTrendr, чтобы создать растр, содержащий информацию о точке изменения.

    Растры анализа изменений содержат модельную информацию о том, как каждый пиксел изменялся с течением времени, а упомянутый выше инструмент анализирует эту информацию.

  • Параметр Тип изменений определяет информацию, которая будет генерироваться. Информация извлекается из растра анализа изменений.

    При выполнении этого инструмента на выходных данных от инструмента Анализировать изменения с помощью CCDC можно выбрать одну из следующих опций:

    • Время последнего изменения – самая последняя дата и время, когда пиксел был помечен как измененный.
    • Время первого изменения – самая ранняя дата и время, когда пиксел был помечен как измененный.
    • Время наибольшего изменения – дата и время, когда рассчитанное изменение оказалось для пиксела наиболее значительным.
    • Число изменений – общее число случаев, года пиксел изменялся.

    Для получения дополнительной информации см. Как работает анализ изменений с помощью CCDC.

    При выполнении этого инструмента на выходных данных инструмента Анализировать изменения с помощью LandTrendr доступны следующие дополнительные возможности:

    • Время самого продолжительного изменения – Дата, когда пиксел был помечен как измененный, в начале или в конце самого продолжительного периода изменения.
    • Время самого короткого изменения – Дата, когда пиксел был помечен как измененный, в начале или в конце самого короткого периода изменения.
    • Время самого быстрого изменения – Дата, когда пиксел был помечен как измененный, в начале или в конце самого быстрого периода изменения.
    • Время самого медленного изменения – Дата, когда пиксел был помечен как измененный, в начале или в конце самого медленного периода изменения.

    Для получения дополнительной информации см. Как работает анализ изменений с помощью LandTrendr.

  • На выходе получается многоканальный растр, в котором каждый канал содержит информацию об изменениях в зависимости от выбранного типа изменения и максимального количества указанных изменений. Например, если для параметра Тип изменений задано значение Время первого изменения, а для параметра Максимальное количество изменений задано значение 2, инструмент рассчитает две самые ранние даты, когда произошло изменение во всем временном ряду для каждого пиксела. В результате получается растр, в котором первый канал содержит даты самого раннего изменения пикселов, а второй - даты второго по времени изменения пикселов.

  • При выполнении этого инструмента на выходных данных инструмента Анализ изменений с помощью LandTrendr вы можете указать, какую дату извлекать – начало изменения или окончание изменения, используя для этого параметр Дата сегмента. Например, чтобы понять, как началось самое последнее изменение во временном ряду, установите для параметра Тип изменения значение Время последнего изменения, а для параметра Дата сегмента – значение Начало сегмента.

  • Используйте следующие параметры фильтрации, чтобы извлечь другие конкретные даты изменений из растра анализа изменений:

    • Фильтр по годам – определяет изменения, произошедшие в течение определенного периода времени, например, если вы ищете изменения ландшафта в течение пяти лет засухи.
    • Фильтр по длительности – определяет изменения, произошедшие в течение определенного периода времени (лет), например, если вы ищете только резкие изменения, произошедшие в течение 1 или 2 лет. Вы можете рассчитать интересующую вас продолжительность, используя формулу end year - start year +1. Разрывы во временных рядах будут включены.
    • Фильтр по величине – определяет изменения заданной величины, например, если вы ищете только большие изменения вегетационного индекса. Величина является абсолютной величиной, поэтому минимальное и максимальное значения не могут быть отрицательными. Чтобы задать изменение направления, используйте параметр Изменить направление.

Синтаксис

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ОбъяснениеТип данных
in_change_analysis_raster

Растр анализа изменений, созданный с помощью инструмента Анализировать изменения с помощью CCDC или инструмента Анализировать изменения с помощью LandTrendr.

Raster Dataset; Raster Layer; Image Service
change_type
(Дополнительный)

Указывает информацию об изменении для вычисления для каждого пиксела.

  • TIME_OF_LATEST_CHANGEКаждый пиксел будет содержать дату его самого последнего изменения во временном ряду. Это значение по умолчанию
  • TIME_OF_EARLIEST_CHANGEКаждый пиксел будет содержать дату его самого первого изменения во временном ряду.
  • TIME_OF_LARGEST_CHANGEКаждый пиксел будет содержать дату его самого значительного изменения во временном ряду.
  • NUM_OF_CHANGESКаждый пиксел будет содержать общее количество раз, когда он изменялся во временном ряду.
  • TIME_OF_LONGEST_CHANGEКаждый пиксел будет содержать дату изменения в начале или конце самого длинного переходного сегмента во временном ряду.
  • TIME_OF_SHORTEST_CHANGEКаждый пиксел будет содержать дату изменения в начале или конце самого короткого переходного сегмента во временном ряду.
  • TIME_OF_FASTEST_CHANGEКаждый пиксел будет содержать дату изменения в начале или конце перехода, который произошел наиболее быстро.
  • TIME_OF_SLOWEST_CHANGEКаждый пиксел будет содержать дату изменения в начале или конце перехода, который произошел медленнее всего.
String
max_number_changes
(Дополнительный)

Максимальное количество изменений на пиксел, которое необходимо вычислить. Это число соответствует количеству каналов выходного растра. Значение по умолчанию - 1. Это означает, что будет рассчитана только одна дата изменения, а выходной растр будет содержать только один канал.

Этот параметр недоступен, если для параметра change_type задано значение NUM_OF_CHANGES.

Long
segment_date
(Дополнительный)

Указывает, следует ли извлекать дату в начале сегмента изменений или в конце.

Этот параметр доступен только в том случае, если входной растр анализа изменений является результатом инструмента Анализ изменений с помощью LandTrendr.

  • BEGINNING_OF_SEGMENTИзвлекать дату в начале сегмента изменений. Это значение по умолчанию
  • END_OF_SEGMENTИзвлекать дату в конце сегмента изменений.
String
change_direction
(Дополнительный)

Указывает направление изменения, которое следует включить в анализ.

Этот параметр доступен только в том случае, если входной растр анализа изменений является результатом инструмента Анализ изменений с помощью LandTrendr.

  • ALLВ результат включаются все направления изменения. Это значение по умолчанию
  • INCREASEВ выходной результат включается только изменение в положительном или возрастающем направлении.
  • DECREASEВ выходной результат включается только изменение в отрицательном или убывающем направлении.
String
filter_by_year
(Дополнительный)

Указывает, следует ли использовать фильтр по диапазону лет.

  • FILTER_BY_YEARФильтрует результатов так, чтобы в выходные данные включались только те изменения, которые произошли в определенном диапазоне лет.
  • NO_FILTER_BY_YEARНе фильтрует результаты по годам. Это значение по умолчанию
Boolean
min_year
(Дополнительный)

Первый год, который будет использоваться для фильтрации результатов. Этот параметр является обязательным, если для параметра filter_by_year задано значение FILTER_BY_YEAR.

Long
max_year
(Дополнительный)

Последний год, который будет использоваться для фильтрации результатов.

Этот параметр является обязательным, если для параметра filter_by_year задано значение FILTER_BY_YEAR.

Long
filter_by_duration
(Дополнительный)

Указывает, следует ли использовать фильтр по длительности изменения.

Этот параметр доступен только в том случае, если входной растр анализа изменений является результатом инструмента Анализ изменений с помощью LandTrendr.

  • FILTER_BY_DURATIONФильтрует результаты по длительности, чтобы в выходные данные включались только изменения, длившиеся определенное количество времени.
  • NO_FILTER_BY_DURATIONНе фильтрует результаты по длительности. Это значение по умолчанию
Boolean
min_duration
(Дополнительный)

Минимальное количество последовательных лет, которое будет включено в результаты.

Этот параметр является обязательным, если для параметра filter_by_duration задано значение FILTER_BY_DURATION.

Double
max_duration
(Дополнительный)

Максимальное количество последовательных лет, которое будет включено в результаты.

Этот параметр является обязательным, если для параметра filter_by_duration задано значение FILTER_BY_DURATION.

Double
filter_by_magnitude
(Дополнительный)

Указывает, следует ли использовать фильтр по величине.

  • Отмечено – фильтрует результаты по величине так, чтобы в выходные данные включались только изменения заданной величины.
  • Не отмечено – не фильтрует результаты по величине. Это значение по умолчанию

Указывает, следует ли использовать фильтр по величине.

  • FILTER_BY_MAGNITUDEФильтрует результаты по величине так, чтобы в выходные данные включались только изменения заданной величины.
  • NO_FILTER_BY_MAGNITUDEНе фильтрует результаты по величине. Это значение по умолчанию
Boolean
min_magnitude
(Дополнительный)

Минимальная величина, которая должна быть включена в результаты.

Этот параметр является обязательным, если для параметра filter_by_magnitude задано значение FILTER_BY_DURATION.

Double
max_magnitude
(Дополнительный)

Максимальная величина, которая должна быть включена в результаты.

Этот параметр является обязательным, если для параметра filter_by_duration задано значение FILTER_BY_DURATION.

Double

Значение отраженного сигнала

NameОбъяснениеТип данных
out_raster

Выходной растр, который содержит информацию о выявленных изменениях.

Raster

Пример кода

DetectChangeUsingChangeAnalysisRaster, пример 1 (окно Python)

Этот пример возвращает дату окончания самого длительного периода восстановления NDVI (увеличивающиеся значения), в котором изменение составило величину от 0,25 до 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")
DetectChangeUsingChangeAnalysisRaster, пример 2 (автономный скрипт)

В этом примере возвращается общее количество раз, когда пикселы изменялись во временном ряду 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")

Информация о лицензиях

  • Basic: Требуется Image Analyst
  • Standard: Требуется Image Analyst
  • Advanced: Требуется Image Analyst

Связанные разделы