Это руководство покажет вам некоторые стандартные рабочие процессы arcpy.mp и познакомит с рядом важных концепций. Оно предназначено для помощи пользователям, которые совсем не знакомы с написанием скриптов Python и с arcpy.mp. Действия, описанные здесь, подходят для работы с любыми данными и всеми уровнями лицензии.
Примечание:
Шаги ниже представляют высокоуровневый обзор arcpy.mp. В этом руководстве указаны ссылки на подробные разделы справки, которые предоставляют больше сведений о применяемых концепциях, а практически во всех случаях в этих разделах содержатся примеры кода.
Учебная установка
Вам необходимо настроить базовый проект, который содержит отдельную карту и компоновку.
- Откройте новый пустой проект.
- На закладке Вставить в группе Проект щелкните Новая карта и снова выберите Новая карта из ниспадающего меню.
- На вкладке Вставка щелкните Новая компоновка и выберите компоновку из галереи.
- На закладке Вставка в группе Фреймы карты выберите карту из вашего проекта в ниспадающем меню фреймов карты и добавьте ее в компоновку.
- На вкладке Проект щелкните Сохранить.
Окно Python
Самый простой способ научиться работать с arcpy.mp – использовать окно Python. Это позволит вам выполнять небольшие рабочие процессы на основе Python и разобраться в концепциях непосредственно в приложении, перед тем, как настраивать скрипты больших размеров. Окно Python является частью платформы приложений ArcGIS Pro и предоставляет возможности автоисправления, автозавершения и синтаксиса командной строки, чтобы вы могли легко вводить соответствующую информацию для параметров в нужном порядке.
- На вкладке Анализ щелкните Python.
- Щелкните область кода, где написано Введите код Python здесь.
По умолчанию окно Python отображается прикрепленным в нижней части приложения.
Ссылка на существующий проект
Обычно одной из первых операций, выполняемых с помощью скрипта arcpy.mp, является ссылка на существующий проект () или файл слоя (.lyrx или .lyr), с которым требуется что-то сделать. В этом разделе вы будете создавать ссылку на проект.
Существует два способа ссылаться на проект. Первый – ссылка на документ на диске, предоставляющая путь к файлу .aprx. Если вы создаете скрипт, который будет выполняться за пределами среды ArcGIS, ссылку на проект необходимо указать с помощью полного системного пути. Второй способ – это сослаться на проект, загруженный в данный момент в приложение ArcGIS Pro. При работе в окне Python указание ссылки на загруженный проект более удобно, так как внесенные в него изменения можно видеть непосредственно в приложении. Следующие шаги показывают, как указать ссылку на проект, загруженный в ArcGIS Pro.
- В окне Python введите следующую строку кода и нажмите клавишу Ввод: Необходимо учитывать, что синтаксис Python чувствителен к регистру.
- В окне Python введите следующее:
- В окне Python продолжайте вводить следующую строку и нажмите клавишу Ввод. Вам также может потребоваться предоставить свой путь к существующей базе геоданных.
- Чтобы увидеть изменения, внесенные в проект, щелкните закладку Проект и выберите Опции.
- Щелкните Отмена.
- В окне Python введите следующую строку и нажмите клавишу Ввод.
- В окне Python введите следующую строку и нажмите клавишу Ввод.
>>> aprx = arcpy.mp.ArcGISProject("CURRENT")
>>> aprx.
>>> aprx.defaultGeodatabase = r"path to a geodatabase of yours" #### for example, aprx.defaultGeodatabase = r"C:\Projects\YosemiteNP\Data\Yosemite.gdb")
>>> aprx.save()
Проверьте временную отметку файла. Она должна совпадать с текущей датой и временем.
У метода save() нет параметров, но, поскольку он является методом, необходимо указать скобки. Чтобы проверить расположение сохраненного проекта, выполните следующее:>>> print(aprx.filePath)
Добавить файл слоя на карту
Теперь, когда у вас есть ссылка на проект, добавьте файл слоя (.lyr или .lyrx) на карту. Сначала добавьте ссылку на карту в проект, а также ссылку на файл слоя на диске; далее, добавьте файл слоя на карту.
Примечание:
Для выполнения следующих действий найдите существующий файл слоя. Если у вас нет файла слоя, его нужно создать.- В окне Python введите следующее:
- В окне Python введите следующее:
- В окне Python нажмите клавишу Backspace, чтобы удалить метод addLayer, введите следующую строку и нажмите клавишу Ввод:
- В окне Python введите следующую строку и нажмите клавишу Ввод.
>>> m = aprx.listMaps("Map")[0]
>>> m.addLayer(
>>> lyrFile = arcpy.mp.LayerFile(r"path to a layer file") ### for example, lyrFile = arcpy.mp.LayerFile(r"C:\Projects\YosemiteNP\LYRS\rivers.lyrx")
>>> m.addLayer(lyrFile, "TOP")
Экспорт компоновки в PDF
Экспорт компоновки в PDF требует всего пары строк кода. Сначала, укажите ссылку на компоновку, которую вы хотите экспортировать, и вызовите метод exportToPDF.
- В окне Python введите следующую строку и нажмите клавишу Ввод.
- В окне Python введите следующую строку и нажмите клавишу Enter. Указанный путь, скорее всего, будет отличаться от примера, приведенного ниже.
>>> lyt = aprx.listLayouts("Layout")[0]
>>> lyt = aprx.listLayouts()[0]
>>> lyt.exportToPDF(r"C:\Projects\YosemiteNP\Output\Page1.pdf")
Вы выполнили распространенный рабочий процесс с использованием arcpy.mp. Далее вы должны применить этот рабочий процесс к собственным проектам и слоям. Также ознакомьтесь с разделами справки arcpy.mp. В конце каждого из разделов представлены десятки небольших примеров кода, которые легко можно скопировать и вставить в окне Python.