| Подпись | Описание | Тип данных |
Входной растр | Входной обрабатываемый растр. Если для параметра Режим задано значение Только постобработка, для этого параметра требуется растр с бинарной классификацией. | 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 |
Метод упорядочивания (Дополнительный) | Указывает метод упорядочивания, используемый для постобработки.
| String |
Допуск (Дополнительный) | Максимальное расстояние, на которые упорядоченный контур может отступать от границы его исходного объекта. По умолчанию 1 метр. | Linear Unit |
Доступно с лицензией Image Analyst.
Краткая информация
Запускает одну или несколько предварительно обученных моделей глубокого обучения для входного растра с целью извлечения объектов и автоматизации постобработки полученных выходных данных.
Подробнее о работе инструмента Извлечь объекты, используя модели ИИ
Использование
Этому инструменту требуются предварительно обученные модели ArcGIS из ArcGIS Living Atlas of the World или пакеты пользовательских моделей глубокого обучения (файлов .dlpk).
Вы должны установить соответствующую среду глубокого обучения для Python в ArcGIS AllSource.
Время, необходимое инструменту для получения выходных данных, зависит от следующих факторов:
- Область интереса для получения вывода
- Число выбранных моделей
Чтобы запустить этот инструмент, нужен компьютер с GPU. Если у вас несколько графических процессоров, вместо этого задайте параметр среды GPU ID.
Потенциальные варианты использования этого инструмента включают создание базовой карты с применением нескольких моделей и постобработку выходных данных модели с использованием алгоритмов очистки извлеченных объектов.
Информацию о требованиях к запуску этого инструмента и проблемах, с которыми вы можете столкнуться, см. в разделе Часто задаваемые вопросы по глубокому обучению.
Параметры
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 | Определяет режим, используемый для обработки входного растра.
| 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 (Дополнительный) | Указывает, будут ли промежуточные выходные данные сохраняться в выходном местоположении. Термин «промежуточные выходные данные» относится к результатам, полученным после вывода модели.
| Boolean |
test_time_augmentation (Дополнительный) | Определяет, объединит ли конечный результат прогнозы по перевернутым и повернутым вариантам входного изображения.
| 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 (Дополнительный) | Определяет, будут ли извлеченные участки нормализованы путем исключения нежелательных артефактов в их геометрии.
| Boolean |
post_processing_workflow (Дополнительный) | Определяет, какой рабочий процесс постобработки будет использоваться.
| String |
out_features (Дополнительный) | Класс объектов, содержащий выходные данные постобработки. | Feature Class |
parcel_tolerance (Дополнительный) | Минимальное расстояние между координатами, прежде чем они будут считаться равными. Этот параметр предназначен для удаления осколочных полигонов между извлеченными участками. Значение по умолчанию — 3 метра. | Linear Unit |
regularization_method (Дополнительный) | Указывает метод упорядочивания, используемый для постобработки.
| String |
poly_tolerance (Дополнительный) | Максимальное расстояние, на которые упорядоченный контур может отступать от границы его исходного объекта. По умолчанию 1 метр. | Linear Unit |
Пример кода
Это пример использования функции 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")