Доступно с лицензией 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 (Дополнительный) | Указывает информацию об изменении для вычисления для каждого пиксела.
| String |
max_number_changes (Дополнительный) | Максимальное количество изменений на пиксел, которое необходимо вычислить. Это число соответствует количеству каналов выходного растра. Значение по умолчанию - 1. Это означает, что будет рассчитана только одна дата изменения, а выходной растр будет содержать только один канал. Этот параметр недоступен, если для параметра change_type задано значение NUM_OF_CHANGES. | Long |
segment_date (Дополнительный) | Указывает, следует ли извлекать дату в начале сегмента изменений или в конце. Этот параметр доступен только в том случае, если входной растр анализа изменений является результатом инструмента Анализ изменений с помощью LandTrendr.
| String |
change_direction (Дополнительный) | Указывает направление изменения, которое следует включить в анализ. Этот параметр доступен только в том случае, если входной растр анализа изменений является результатом инструмента Анализ изменений с помощью LandTrendr.
| String |
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.
| Boolean |
min_duration (Дополнительный) | Минимальное количество последовательных лет, которое будет включено в результаты. Этот параметр является обязательным, если для параметра filter_by_duration задано значение FILTER_BY_DURATION. | Double |
max_duration (Дополнительный) | Максимальное количество последовательных лет, которое будет включено в результаты. Этот параметр является обязательным, если для параметра filter_by_duration задано значение FILTER_BY_DURATION. | Double |
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 |
Пример кода
Этот пример возвращает дату окончания самого длительного периода восстановления 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")В этом примере возвращается общее количество раз, когда пикселы изменялись во временном ряду 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")Environments
Информация о лицензиях
- Basic: Требуется Image Analyst
- Standard: Требуется Image Analyst
- Advanced: Требуется Image Analyst