Что такое arcpy.mp?
Arcpy.mp – это внутренний модуль Python, входящий в пакет ArcPy. Он устанавливается одновременно с ArcGIS Pro и доступен для всех уровней лицензий. В основном, он был разработан для обработки содержания существующих проектов (.aprx) и файлов слоев ((.lyr или .lyrx). Он также содержит функции для автоматизации печати и экспорта. Arcpy.mp можно использовать для автоматизации создания карт; он необходим для создания полных атласов, так как содержит функции для экспорта, создания и обработки PDF-документов.
Легче узнать возможности Arcpy.mp по описаниям сценариев работы. Ниже приведен перечень всего лишь нескольких из множества сценариев, которые может выполнить скрипт Python arcpy.mp:
- Создать отчет по информации, содержащейся в проектах, такой как слои и их источники данных, слои с поврежденными источниками данных, экстент отображаемых данных, или свойства элемента слоя.
- Обновить, восстановить или заменить источники данных слоя на карте или в файле слоя.
- Найти и заменить текстовую строку для всех компоновок в проекте.
- Автоматизировать элементы проекта для общего доступа таким образом, чтобы они размещались для вашей организации онлайн.
- Создать географические данные пакетно с использованием команд экспорта карт, например, серию изображений в формате GeoTIFF, основанную на перечне объектов на карте.
- Создать различные атласы PDF, например, справочный атлас или тематический атлас с титульным листом, несколькими страницами карт и любым количеством дополнительных страниц с вспомогательной информацией, например, с табличными отчетами и списками контактов.
Для кого предназначен arcpy.mp? Зачем он создан?
Arcpy.mp был создан для профессиональных ГИС-аналитиков и для разработчиков. Обычно, сценарии, перечисленные выше, реализовались с помощью ArcObjects, и часто это было связано с очень трудной в изучении средой программирования для обычных ГИС-специалистов. Arcpy.mp – это более укрупненная объектная модель, т. е. функции модуля разработаны так, что одна функция arcpy.mp может заменить множество строк кода ArcObjects. Далее представлен простой пример использования arcpy.mp для указания ссылки на существующую компоновку в проекте и экспорта его в документ PDF с помощью всего трех строк кода.
import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
lyt = aprx.listLayouts("Main Attractions*")[0]
lyt.exportToPDF(r"C:\Project\YosemiteNP\Output\Yosemite.pdf", resolution = 300)Первая строка загружает модуль arcpy и необходима для всех скриптов, которые запускаются извне ArcGIS Pro. Вторая строка ссылается на проект ArcGIS Pro на диске. Третья строка находит первую компоновку (используя индекс, начинающийся с нуля), с именем, начинающимся со слов Основные достопримечательности. Последняя строка кода экспортирует эту компоновку в файл PDF с выходным разрешением 300.
Лучшие способы для начала работы
- Используйте Руководство по началу работы с arcpy.mp.
- Ознакомьтесь с Руководством по использованию arcpy.mp
- Если вы использовали модуль arcpy.mapping в ранних версиях программного обеспечения, и используете ArcGIS Pro, ознакомьтесь с Переход с arcpy.mapping на ArcGIS Pro.
- Изучите разделы Алфавитный список функций модуля arcpy.mp и Алфавитный список классов модуля arcpy.mp, чтобы получить представление о доступных функциях. Их также удобно иметь в распечатанном виде при написании скриптов с использованием arcpy.mp.
- Все разделы справки по функциям и классам arcpy.mp содержат подробное описание и фрагменты кода, которые можно скопировать и вставить непосредственно в окне Python.