Извлечь объекты, используя модели ИИ (GeoAI)

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

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

Запускает одну или несколько предварительно обученных моделей глубокого обучения для входного растра с целью извлечения объектов и автоматизации постобработки полученных выходных данных.

Подробнее о работе инструмента Извлечь объекты, используя модели ИИ

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

  • Этому инструменту требуются предварительно обученные модели ArcGIS из ArcGIS Living Atlas of the World или пакеты пользовательских моделей глубокого обучения (файлов .dlpk).

  • Вы должны установить соответствующую среду глубокого обучения для Python в ArcGIS AllSource.

    Узнайте, как установить среду глубокого обучения для ArcGIS

  • Время, необходимое инструменту для получения выходных данных, зависит от следующих факторов:

    • Область интереса для получения вывода
    • Число выбранных моделей

  • Чтобы запустить этот инструмент, нужен компьютер с GPU. Если у вас несколько графических процессоров, вместо этого задайте параметр среды GPU ID.

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

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

Параметры

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

Входной обрабатываемый растр.

Если для параметра Режим задано значение Только постобработка, для этого параметра требуется растр с бинарной классификацией.

Raster Layer; Raster Dataset; Mosaic Layer
Режим

Определяет режим, используемый для обработки входного растра.

  • Вывод и постобработкаОбъекты будут извлечены из изображения и постобработаны. Это значение по умолчанию
  • Только постобработкаВходной растр будет сразу постобработан. Для этого варианта необходим одноканальный растр с бинарной классификацией.
String
Выходное местоположение

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

Workspace
Префикс выходных данных

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

String
Область интереса
(Дополнительный)

Географический экстент, который будет использоваться для извлечения объектов. Извлечены будут только объекты внутри области интереса.

Feature Set
Предварительно обученные модели
(Дополнительный)

Предварительно обученные модели ArcGIS из ArcGIS Living Atlas of the World, которые можно использовать для указанного входного растра. Для этого параметра необходимо подключение к интернету, чтобы загрузить предварительно обученные модели.

String
Дополнительные модели
(Дополнительный)

Модели глубокого обучения, которые можно использовать для указанного входного растра, и рабочий процесс постобработки, который будет использоваться для дополнительных файлов моделей (.dlpk и .emd). Допустим следующий рабочий процесс постобработки:

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

Value Table
Пороговое значение достоверности
(Дополнительный)

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

Double
Сохранить промежуточные выходные данные
(Дополнительный)

Указывает, будут ли промежуточные выходные данные сохраняться в выходном местоположении. Термин «промежуточные выходные данные» относится к результатам, полученным после вывода модели.

  • Отмечено - промежуточные выходные данные будут сохраняться в выходном местоположении.
  • Не отмечено - промежуточные выходные данные не будут сохраняться. Это значение по умолчанию
Boolean
Увеличение времени тестирования
(Дополнительный)

Определяет, объединит ли конечный результат прогнозы по перевернутым и повернутым вариантам входного изображения.

  • Отмечено - конечный результат объединит прогнозы по перевернутым и повернутым вариантам входного изображения.
  • Не отмечено - конечный результат не будет объединять прогнозы по перевернутым и повернутым вариантам входного изображения. Это значение по умолчанию

Boolean
Буферное расстояние
(Дополнительный)

Расстояние, которое будет использоваться для буферизации полилинейных объектов перед их использованием в постобработке. Значение по умолчанию - 15 метров.

Linear Unit
Длина растяжения
(Дополнительный)

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

Linear Unit
Допуск сглаживания
(Дополнительный)

Допуск, который используется алгоритмом Полиномиальная аппроксимация с экспоненциальным ядром (PAEK). Значение по умолчанию - 30 метров.

Linear Unit
Длина висячей линии
(Дополнительный)

Длина, на которую сегменты линии, которые не касаются другой линии в обеих конечных точках (висячие), будут обрезаны. По умолчанию 5 метров.

Linear Unit
Входные объекты дорог
(Дополнительный)

Класс объектов дорог, который будет использоваться для уточнения участков. Входной класс может быть классом полилинейных или полигональных объектов.

Feature Layer; Feature Class
Ширина буфера дорог
(Дополнительный)

Буферное расстояние, которое будет использоваться для Входных объектов дорог. Значение по умолчанию - 5 метров для полилиний и 0 для полигонов.

Linear Unit
Упорядочить участки
(Дополнительный)

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

  • Отмечено - извлеченные участки будут нормализованы. Это значение по умолчанию
  • Не отмечено - извлеченные участки не будут нормализованы.
Boolean
Рабочий процесс постобработки
(Дополнительный)

Определяет, какой рабочий процесс постобработки будет использоваться.

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

Класс объектов, содержащий выходные данные постобработки.

Feature Class
Допуск между смежными участками
(Дополнительный)

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

Linear Unit
Метод упорядочивания
(Дополнительный)

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

  • Прямые углыБудут построены формы, состоящие из углов 90° между смежными ребрами. Это значение по умолчанию
  • Прямые углы и диагоналиБудут построены формы, состоящие из углов 45° и 90° между смежными ребрами.
  • Любые углыБудут построены формы, состоящие из любых углов между смежными ребрами.
  • ОкружностьБудет использовано максимальное расстояние от границ обрабатываемого объекта.
String
Допуск
(Дополнительный)

Максимальное расстояние, на которые упорядоченный контур может отступать от границы его исходного объекта. По умолчанию 1 метр.

Linear Unit

arcpy.geoai.ExtractFeaturesUsingAIModels(in_raster, mode, out_location, out_prefix, {area_of_interest}, {pretrained_models}, {additional_models}, {confidence_threshold}, {save_intermediate_output}, {test_time_augmentation}, {buffer_distance}, {extend_length}, {smoothing_tolerance}, {dangle_length}, {in_road_features}, {road_buffer_width}, {regularize_parcels}, {post_processing_workflow}, {out_features}, {parcel_tolerance}, {regularization_method}, {poly_tolerance})
ИмяОписаниеТип данных
in_raster

Входной обрабатываемый растр.

Если для параметра mode задано значение Only Postprocess, для этого параметра требуется растр с бинарной классификацией.

Raster Layer; Raster Dataset; Mosaic Layer
mode

Определяет режим, используемый для обработки входного растра.

  • Infer and PostprocessОбъекты будут извлечены из изображения и постобработаны. Это значение по умолчанию
  • Only PostprocessВходной растр будет сразу постобработан. Для этого варианта необходим одноканальный растр с бинарной классификацией.
String
out_location

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

Workspace
out_prefix

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

String
area_of_interest
(Дополнительный)

Географический экстент, который будет использоваться для извлечения объектов. Извлечены будут только объекты внутри области интереса.

Feature Set
pretrained_models
[pretrained_models,...]
(Дополнительный)

Предварительно обученные модели ArcGIS из ArcGIS Living Atlas of the World, которые можно использовать для указанного входного растра. Для этого параметра необходимо подключение к интернету, чтобы загрузить предварительно обученные модели.

String
additional_models
[additional_models,...]
(Дополнительный)

Модели глубокого обучения, которые можно использовать для указанного входного растра, и рабочий процесс постобработки, который будет использоваться для дополнительных файлов моделей (.dlpk и .emd). Допустим следующий рабочий процесс постобработки:

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

Value Table
confidence_threshold
(Дополнительный)

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

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

Указывает, будут ли промежуточные выходные данные сохраняться в выходном местоположении. Термин «промежуточные выходные данные» относится к результатам, полученным после вывода модели.

  • TRUEПромежуточные выходные данные будут сохраняться в выходном местоположении.
  • FALSEПромежуточные выходные данные не будут сохраняться. Это значение по умолчанию
Boolean
test_time_augmentation
(Дополнительный)

Определяет, объединит ли конечный результат прогнозы по перевернутым и повернутым вариантам входного изображения.

  • TRUEКонечный результат объединит прогнозы по перевернутым и повернутым вариантам входного изображения.
  • FALSEКонечный результат не будет объединять прогнозы по перевернутым и повернутым вариантам входного изображения. Это значение по умолчанию
Boolean
buffer_distance
(Дополнительный)

Расстояние, которое будет использоваться для буферизации полилинейных объектов перед их использованием в постобработке. Значение по умолчанию - 15 метров.

Linear Unit
extend_length
(Дополнительный)

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

Linear Unit
smoothing_tolerance
(Дополнительный)

Допуск, который используется алгоритмом Полиномиальная аппроксимация с экспоненциальным ядром (PAEK). Значение по умолчанию - 30 метров.

Linear Unit
dangle_length
(Дополнительный)

Длина, на которую сегменты линии, которые не касаются другой линии в обеих конечных точках (висячие), будут обрезаны. По умолчанию 5 метров.

Linear Unit
in_road_features
(Дополнительный)

Класс объектов дорог, который будет использоваться для уточнения участков. Входной класс может быть классом полилинейных или полигональных объектов.

Feature Layer; Feature Class
road_buffer_width
(Дополнительный)

Буферное расстояние, которое будет использоваться для Входных объектов дорог. Значение по умолчанию - 5 метров для полилиний и 0 для полигонов.

Linear Unit
regularize_parcels
(Дополнительный)

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

  • TRUEИзвлеченные участки будут нормализованы. Это значение по умолчанию
  • FALSEИзвлеченные участки не будут нормализованы.
Boolean
post_processing_workflow
(Дополнительный)

Определяет, какой рабочий процесс постобработки будет использоваться.

  • Line RegularizationИз одноканального растра с бинарной классификацией извлекаются линейные объекты, после уточнения которых формируется класс линейных объектов.
  • Parcel RegularizationИз одноканального растра с бинарной классификацией извлекаются участки, после уточнения которых формируется класс полигиональных объектов.
String
out_features
(Дополнительный)

Класс объектов, содержащий выходные данные постобработки.

Feature Class
parcel_tolerance
(Дополнительный)

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

Linear Unit
regularization_method
(Дополнительный)

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

  • Right AnglesБудут построены формы, состоящие из углов 90° между смежными ребрами. Это значение по умолчанию
  • Right Angles and DiagonalsБудут построены формы, состоящие из углов 45° и 90° между смежными ребрами.
  • Any AnglesБудут построены формы, состоящие из любых углов между смежными ребрами.
  • CircleБудет использовано максимальное расстояние от границ обрабатываемого объекта.
String
poly_tolerance
(Дополнительный)

Максимальное расстояние, на которые упорядоченный контур может отступать от границы его исходного объекта. По умолчанию 1 метр.

Linear Unit

Пример кода

ExtractFeaturesUsingAIModels (окно Python)

Это пример использования функции ExtractFeaturesUsingAIModels.


# Name: ExtractFeaturesUsingAIModels.py
# Description: Extract features using pretrained deep learning models on imagery data.
  
# Import system modules
import arcpy

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Set local variables
datapath = "path_to_training_data" 
out_gdb = "path_to_gdb"
predictions = "output_prefix"

# Run Extract Features Using AI Models
arcpy.geoai.ExtractFeaturesUsingAIModels(in_raster=datapath, 
                                         mode="Infer and Postprocess", 
                                         out_location=out_gdb, 
                                         out_prefix=predictions, 
                                         pretrained_models="'Building Footprint Extraction - USA'", 
                                         save_intermediate_output="TRUE", 
                                         buffer_distance="15 Meters", 
                                         extend_length="25 Meters", 
                                         smoothing_tolerance="30 Meters", 
                                         dangle_length="5 Meters",
                                         regularization_method="Right Angles",
                                         poly_tolerance="1 Meters")

Параметры среды