Доступно с лицензией Image Analyst.
Краткая информация
Использует растр анализа изменений для создания растрового объекта, содержащего информацию о дате изменения.
Создается растр анализа изменений с помощью инструмента Анализировать изменения с помощью CCDC или Анализировать изменения с помощью LandTrendr.
Обсуждение
Более подробную информацию о том, как работает эта функция, см. растровую функцию Выявление изменений при помощи анализа изменений.
Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, вы можете вызвать метод растрового объекта save.
Синтаксис
DetectChangeUsingChangeAnalysis (raster, {change_type}, {max_number_of_changes}, {segment_date}, {change_direction}, {filter_by_year}, {min_year}, {max_year}, {filter_by_duration}, {min_duration}, {min_duration}, {filter_by_magnitude}, {min_magnitude}, {max_magnitude})
Параметр | Описание | Тип данных |
raster | Входной растр анализа изменений, созданный инструментом Анализировать изменения с помощью CCDC или Анализировать изменения с помощью LandTrendr. | Raster |
change_type | Определяет тип изменений, извлекаемых из растра анализа изменений.
(Значение по умолчанию — TIME_OF_LATEST_CHANGE) | String |
max_number_of_changes | Максимальное количество изменений на пиксел для расчета. Это число соответствует количеству каналов выходного растра. Значение по умолчанию - 1. Это означает, что будет рассчитана только одна дата изменения, а выходной растр будет содержать только один канал. Этот параметр недоступен, если для параметра change_type установлено значение NUM_OF_CHANGES. (Значение по умолчанию — 1) | Integer |
segment_date | Указывает, следует ли извлекать дату в начале сегмента изменения или в конце. Этот параметр доступен только в том случае, если растр анализа входных изменений является выходом инструмента Анализировать изменения с помощью LandTrendr.
(Значение по умолчанию — BEGINNING_OF_SEGMENT) | String |
change_direction | Задает направление изменения, которое необходимо включить в анализ. Этот параметр доступен только в том случае, если растр анализа входных изменений является выходом инструмента Анализировать изменения с помощью LandTrendr.
(Значение по умолчанию — ALL) | String |
filter_by_year | Указывает, следует ли выполнять фильтрацию по диапазону лет.
(Значение по умолчанию — False) | Boolean |
min_year | Самый ранний год для фильтрации результатов. Этот параметр является обязательным, если для параметра filter_by_year установлено значение True. (Значение по умолчанию — 1970) | Double |
max_year | Последний год для фильтрации результатов. Этот параметр является обязательным, если для параметра filter_by_year установлено значение True. (Значение по умолчанию — 2020) | Double |
filter_by_duration | Указывает, следует ли выполнять фильтрацию по продолжительности события изменения.
(Значение по умолчанию — False) | Boolean |
min_duration | Минимальное количество лет подряд для включения в результаты. Этот параметр является обязательным, если для параметра filter_by_duration установлено значение True. (Значение по умолчанию — 0) | Double |
min_duration | Максимальное количество лет подряд для включения в результаты. Этот параметр является обязательным, если для параметра filter_by_duration установлено значение True. (Значение по умолчанию — 50) | Double |
filter_by_magnitude | Указывает, следует ли выполнять фильтрацию по величине изменения.
(Значение по умолчанию — False) | Boolean |
min_magnitude | Минимальная величина изменения для включения в результаты. Этот параметр является обязательным, если для параметра filter_by_magnitude установлено значение True. (Значение по умолчанию — -50) | Double |
max_magnitude | Максимальная величина изменения, которую нужно включить в результаты. Этот параметр является обязательным, если для параметра filter_by_magnitude установлено значение True. (Значение по умолчанию — 50) | Double |
Тип данных | Описание |
Raster | Растровый объект, содержащий информацию о выявленных изменениях. |
Пример кода
Извлекает даты трех самых больших изменений из растра анализа изменений.
import arcpy
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst")
change_analysis_raster = arcpy.Raster('Landsat_CCDC.crf', True)
# Detect the dates of the three largest changes in pixel values over time
largest_change = arcpy.ia.DetectChangeUsingChangeAnalysis(
change_analysis_raster, "TIME_OF_LARGEST_CHANGE", 3)