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

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

Краткая информация

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

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

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

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

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

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

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

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

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

    • Время самого длительного изменения – дата, когда пиксел был помечен как измененный, в начале или в конце самого длительного периода изменения.
    • Время самого короткого изменения – дата, когда пиксел был помечен как измененный, в начале или в конце самого короткого периода изменения.
    • Время самого быстрого изменения – дата, когда пиксел был помечен как измененный, в начале или в конце самого быстрого периода изменения.
    • Время самого медленного изменения – дата, когда пиксел был помечен как измененный, в начале или в конце самого медленного периода изменения.
    • Фильтр по начальному значению - Результаты фильтра по начальному значению, так что только изменения данного начального значения включаются в выходные данные.
    • Фильтр по конечному значению - Результаты фильтра по конечному значению, так что только изменения данного конечного значения включаются в выходные данные.

  • Параметры Фильтр по начальному значению и Фильтр по конечному значению используют подходящие значения отражения поверхности из растра анализа изменений, содержащего коэффициенты модели. Подходящие значения показывают, когда изменения возникают из-за разрыва в сегменте линии подходящих значений при отображении временной диаграммы профиля.

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной растр анализа изменений

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

Raster Dataset; Raster Layer; Image Service
Тип изменения
(Дополнительный)

Задает информацию об изменении, которая будет рассчитана для каждого пиксела.

  • Время последнего измененияКаждый пиксел будет содержать дату своего последнего изменения во временном ряду. Используется по умолчанию.
  • Время самого раннего измененияКаждый пиксел будет содержать дату самого раннего изменения во временном ряду.
  • Время наибольшего измененияКаждый пиксел будет содержать дату своего наиболее значительного изменения во временном ряду.
  • Количество измененийКаждый пиксел будет содержать общее количество раз, которое он изменялся во временном ряду.
  • Время самого долгого измененияКаждый пиксел будет содержать дату изменения в начале или конце самого длинного переходного сегмента во временном ряду.
  • Время кратчайшего измененияКаждый пиксел будет содержать дату изменения в начале или конце самого короткого переходного сегмента во временном ряду.
  • Время самого быстрого измененияКаждый пиксел будет содержать дату изменения в начале или в конце перехода, который произошел наиболее быстро.
  • Время самого медленного измененияКаждый пиксел будет содержать дату изменения в начале или конце перехода, который произошел наиболее медленно.
String
Максимальное число изменений
(Дополнительный)

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

Этот параметр не активный, если для параметра Тип изменений задано Количество изменений.

Long
Дата сегмента
(Дополнительный)

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

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

  • Начало сегментаБудет извлечена дата в начале сегмента изменения. Используется по умолчанию.
  • Конец сегментаБудет извлечена дата в конце сегмента изменения.
String
Изменить направление
(Дополнительный)

Задает направление изменения, которое будет включено в анализ.

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

  • Все направленияВсе направления изменения будут включены в выходные данные. Используется по умолчанию.
  • ВозрастаниеВ выходные данные будет включено только изменение в положительном или возрастающем направлении.
  • УбываниеВ выходные данные будет включено только изменение в отрицательном или убывающем направлении.
String
Фильтр по году
(Дополнительный)

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

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

Boolean
Минимальное значение
(Дополнительный)

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

Long
Максимальное значение
(Дополнительный)

Самый поздний год для фильтрации результатов.

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

Long
Фильтр по продолжительности
(Дополнительный)

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

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

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

Boolean
Минимальная продолжительность (в годах)
(Дополнительный)

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

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

Double
Максимальная продолжительность (в годах)
(Дополнительный)

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

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

Double
Фильтр по величине
(Дополнительный)

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

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

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

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

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

Данный параметр является обязательным, если отмечен параметр Фильтр по величине.

Double
Максимальная величина
(Дополнительный)

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

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

Double
Фильтр по начальному значению
(Дополнительный)

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

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

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

Boolean
Минимальное начальное значение
(Дополнительный)

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

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

Double
Максимальное начальное значение
(Дополнительный)

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

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

Double
Фильтр по конечному значению
(Дополнительный)

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

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

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

Boolean
Минимальное конечное значение
(Дополнительный)

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

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

Double
Максимальное конечное значение
(Дополнительный)

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

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

Double

Возвращаемое значение

ПодписьОписаниеТип данных
Выходной растр

Выходной растр, содержащий информацию об обнаруженных изменениях.

Raster

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}, {filter_by_start_value}, {min_start_value}, {max_start_value}, {filter_by_end_value}, {min_end_value}, {max_end_value})
ИмяОписаниеТип данных
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_MAGNITUDE.

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

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

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

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

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

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

  • FILTER_BY_START_VALUEРезультаты будут отфильтрованы по начальному значению так, чтобы в выходные данные включались только изменения заданного начального значения.
  • NO_FILTER_BY_START_VALUEРезультаты не будут отфильтрованы по начальному значению. Используется по умолчанию.
Boolean
min_start_value
(Дополнительный)

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

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

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

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

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

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

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

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

  • FILTER_BY_END_VALUEРезультаты будут отфильтрованы по конечному значению так, чтобы в выходные данные включались только изменения заданного конечного значения.
  • NO_FILTER_BY_END_VALUEРезультаты не будут отфильтрованы по конечному значению. Используется по умолчанию.
Boolean
min_end_value
(Дополнительный)

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

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

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

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

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

Double

Возвращаемое значение

ИмяОписаниеТип данных
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
dateOfLatestChange = arcpy.ia.DetectChangeUsingChangeAnalysis(
	"Monthly_NDVI_Change_Analysis.crf", "TIME_OF_LATEST_CHANGE", 1)

# Save output
dateOfLatestChange.save(r"C:\data\NDVI_LatestChanges.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")