Перенести пикселы при помощи глубокого обучения (Инструменты Image Analyst)
Краткая информация
Запускает обученную модель глубокого обучения для преобразования пикселов внутри изображения.
Использование
Этот инструмент используется для преобразования пикселов изображения с использованием информации о модели глубокого обучения. Примеры преобразования включают увеличение разрешения пикселов, преобразование изображения в оттенках серого в цветное изображение и так далее.
Модель типа Super-resolution может использоваться для увеличения разрешения изображения.
Модель типа CycleGAN может использоваться для преобразования изображения, например, из оттенков серого в красный, зелёный, синий (RGB) цвет.
Модель типа Pix2Pix может использоваться для преобразования изображений, например, SAR в RGB.
Используйте пример ниже для файла JSON определения модели (.emd).
Вводное растровое изображение или изображения для преобразования.
Raster Dataset; Raster Layer; Mosaic Layer; Image Service; Map Server; Map Server Layer; Internet Tiled Layer; Folder; Feature Layer; Feature Class
Определение модели
Путь к JSON-файлу определения модели ('*.emd').
File; String
Аргументы
(Дополнительный)
Для заполнения этого параметра будет использоваться информация из параметра Определение модели. Эти аргументы меняются в зависимости от архитектуры модели. Ниже приведены поддерживаемые аргументы для моделей, обученных в ArcGIS. Предварительно обученные модели ArcGIS и пользовательские модели глубокого обучения могут иметь дополнительные аргументы, поддерживаемые инструментом.
batch_size—Количество листов изображений, обработанных на каждом этапе построения модели. Оно зависит от объема памяти вашего графического адаптера. Аргумент доступен для всех архитектур моделей.
direction—Изображение передается из одного домена в другой. Опции AtoB и BtoA. Аргумент доступен только для архитектуры CycleGAN. Для получения дополнительной информации об этом аргументе см. Как работает CycleGAN.
n_timestep—Число временных шагов, которые будут использованы. По умолчанию, 200. Можно увеличить или уменьшить это значение в зависимости от качества поколений. Этот аргумент поддерживается только для архитектуры Повышение разрешения с опорной моделью SR3.
padding—Количество пикселов на границе листов изображений, из которых складываются прогнозные данные для смежных листов. Чтобы сгладить результат при уменьшении артефактов, увеличьте значение. Максимальное значение padding может составлять половину значения размера листа. Аргумент доступен для всех архитектур моделей.
sampling_type—Тип выборки, который будет использован. Доступны два типа выборки: ddim (неявные модели диффузии с шумом) и ddpm (вероятностные модели диффузии с шумом). По умолчанию тип выборки ddim быстрее выдает результаты за меньшее количество шагов по сравнению с ddpm. Этот аргумент поддерживается только для архитектуры Повышение разрешения с опорной моделью SR3.
schedule—Тип расписания скорости обучения для использования; Эта опция будет использоваться для корректировки скорости обучения модели во время её обучения. Расписание по умолчанию такое же, на котором обучалась модель. Этот аргумент поддерживается только для архитектуры Повышение разрешения с опорной моделью SR3.
tile_size—Ширина и высота листов изображений, на которые разбивается изображение для прогнозирования. Аргумент доступен только для архитектуры CycleGAN.
Столбцы таблицы значений:
Имя–Имя аргумента функции.
Значение–Значение аргумента функции.
Value Table
Режим обработки
Задает как будут обработаны все растровые элементы в наборе данных мозаики или сервисе изображений. Этот параметр применяется только в том случае, если в качестве входных данных используется наборы данных мозаики или сервис изображений.
Обработка как мозаики изображений–Все растровые элементы в наборе данных мозаики или сервисе изображений будут объединены в мозаику и обработаны. Используется по умолчанию.
Обработка всех растровых элементов отдельно–Все растровые элементы в наборе данных мозаики или сервисе изображений будут обработаны как отдельные изображения.
String
Выходная папка
(Дополнительный)
Папка для хранения выходных растров.
Этот параметр необходим, если входной растр является папкой с изображениями или набором данных мозаики, в которых все элементы должны быть обработаны по отдельности. По умолчанию используется папка в папке проекта.
Folder
Выходные объекты
(Дополнительный)
Класс объектов, в котором будут сохранены выходные растры.
Этот параметр обязателен, если входной растр является классом объектов изображений.
Если класс объектов уже существует, то результаты будут добавлены в этот существующий класс объектов.
Feature Class
Перезаписать вложения
(Дополнительный)
Задает, будет ли существующее вложение с изображением перезаписано.
Этот параметр корректен, только когда значением параметра Входной растр является класс пространственных объектов с вложениями изображений.
Отмечено–Существующий класс объектов будет перезаписан с новыми обновленными вложениями.
Не отмечено–Существующие вложения с изображениями не будут перезаписаны, и новые вложения с изображениями будут храниться в новом классе объектов. Когда эта опция задана, параметр Выходные объекты должен содержать значение. Используется по умолчанию.
Boolean
Использование пиксельного пространства
(Дополнительный)
Задает, будет ли выполняться логический вывод для изображений в пиксельном пространстве. Пиксельное пространство — это координатное пространство x,y, определяемое количеством пикселей в области отображения, например, 1024 x 768.
Отмечено–Вывод будет выполнен в пиксельном пространстве, а выходные данные будут преобразованы обратно в пространство карты. Этот параметр полезен при использовании перспективных изображений или изображений панорам улиц, где объекты могут быть искажены из-за использования пространства карты.
Не отмечено–Вывод будет выполняться в пространстве карты. Используется по умолчанию.
Boolean
Возвращаемое значение
Подпись
Объяснение
Тип данных
Выходной набор растровых данных
Имя растра или набора данных мозаики, содержащего результат.
Вводное растровое изображение или изображения для преобразования.
Raster Dataset; Raster Layer; Mosaic Layer; Image Service; Map Server; Map Server Layer; Internet Tiled Layer; Folder; Feature Layer; Feature Class
in_model_definition
Путь к JSON-файлу определения модели ('*.emd').
File; String
arguments[arguments,...]
(Дополнительный)
Информация из параметра in_model_definition будет использоваться для задания значений по умолчанию для этого параметра. Эти аргументы меняются в зависимости от архитектуры модели. Ниже приведены поддерживаемые аргументы для моделей, обученных в ArcGIS. Предварительно обученные модели ArcGIS и пользовательские модели глубокого обучения могут иметь дополнительные аргументы, поддерживаемые инструментом.
batch_size—Количество листов изображений, обработанных на каждом этапе вывода модели. Оно зависит от объема памяти вашего графического адаптера. Аргумент доступен для всех архитектур моделей.
direction—Изображение передается из одного домена в другой. Опции AtoB и BtoA. Аргумент доступен только для архитектуры CycleGAN. Для получения дополнительной информации об этом аргументе см. Как работает CycleGAN.
n_timestep—Число временных шагов, которые будут использованы. По умолчанию, 200. Можно увеличить или уменьшить это значение в зависимости от качества поколений. Этот аргумент поддерживается только для архитектуры Повышение разрешения с опорной моделью SR3.
padding—Количество пикселов на границе листов изображений, из которых складываются прогнозные данные для смежных листов. Чтобы сгладить результат при уменьшении артефактов, увеличьте значение. Максимальное значение padding может составлять половину значения размера листа. Аргумент доступен для всех архитектур моделей.
sampling_type—Тип выборки, который будет использован. Доступны два типа дискретизации: ddim (неявные модели диффузии с шумом) и ddpm (вероятностные модели диффузии с шумом). По умолчанию тип выборки ddim быстрее выдает результаты за меньшее количество шагов по сравнению с ddpm. Этот аргумент поддерживается только для архитектуры Повышение разрешения с опорной моделью SR3.
schedule—Тип расписания скорости обучения для использования. Эта опция будет использоваться для корректировки скорости обучения модели во время её обучения. Расписание по умолчанию такое же, на котором обучалась модель. Этот аргумент поддерживается только для архитектуры Повышение разрешения с опорной моделью SR3.
tile_size—Ширина и высота листов изображений, на которые разбивается изображение для прогнозирования. Аргумент доступен только для архитектуры CycleGAN.
Столбцы таблицы значений:
Name–Имя аргумента функции.
Value–Значение аргумента функции.
Value Table
processing_mode
Задает как будут обработаны все растровые элементы в наборе данных мозаики или сервисе изображений. Этот параметр применяется только в том случае, если в качестве входных данных используется наборы данных мозаики или сервис изображений.
PROCESS_AS_MOSAICKED_IMAGE–Все растровые элементы в наборе данных мозаики или сервисе изображений будут объединены в мозаику и обработаны. Используется по умолчанию.
PROCESS_ITEMS_SEPARATELY–Все растровые элементы в наборе данных мозаики или сервисе изображений будут обработаны как отдельные изображения.
String
out_translated_folder
(Дополнительный)
Папка для хранения выходных растров.
Этот параметр необходим, если входной растр является папкой с изображениями или набором данных мозаики, в которых все элементы должны быть обработаны по отдельности. По умолчанию используется папка в папке проекта.
Folder
out_featureclass
(Дополнительный)
Класс объектов, в котором будут сохранены выходные растры.
Этот параметр обязателен, если входной растр является классом объектов изображений.
Если класс объектов уже существует, то результаты будут добавлены в этот существующий класс объектов.
Feature Class
overwrite_attachments
(Дополнительный)
Задает, будет ли существующее вложение с изображением перезаписано.
Этот параметр корректен, только если значением параметра in_raster является класс пространственных объектов с вложениями изображений.
OVERWRITE–Существующий класс объектов будет перезаписан с новыми обновленными вложениями.
NO_OVERWRITE–Существующие вложения с изображениями не будут перезаписаны, и новые вложения с изображениями будут храниться в новом классе объектов. Когда эта опция задана, у параметра out_featureclass должно быть значение. Используется по умолчанию.
Boolean
use_pixelspace
(Дополнительный)
Задает, будет ли выполняться логический вывод для изображений в пиксельном пространстве. Пиксельное пространство — это координатное пространство x,y, определяемое количеством пикселей в области отображения, например, 1024 x 768.
PIXELSPACE–Вывод будет выполнен в пиксельном пространстве, а выходные данные будут преобразованы обратно в пространство карты. Этот параметр полезен при использовании перспективных изображений или изображений панорам улиц, где объекты могут быть искажены из-за использования пространства карты.
NO_PIXELSPACE–Вывод будет выполняться в пространстве карты. Используется по умолчанию.
Boolean
Возвращаемое значение
Имя
Объяснение
Тип данных
out_raster
Имя растра или набора данных мозаики, содержащего результат.
Raster
Пример кода
TranslatePixelsUsingDeepLearning, пример 1 (окно Python)
В этом примере переводится изображение с использованием модели глубокого обучения.