Краткая информация
Предоставляет ссылку на проект ArcGIS (.aprx), хранящийся на диске, или на проект, загруженный в данный момент в ArcGIS Pro, используя ключевое слово CURRENT.
Обсуждение
Существует два способа создания объекта ArcGISProject с помощью функции ArcGISProject. Первый наиболее рекомендуемый метод состоит в указании системного пути к расположению файла проекта (.aprx) на диске. Этот способ наиболее универсален, так как такой скрипт можно будет запускать вне приложения ArcGIS Pro. Указание ссылки на конкретный проект на диске предоставляет больше возможностей для контроля за выполнением скрипта, так как данный скрипт может работать не со всеми проектами. Эти проекты открываются в памяти, и внесенные изменения можно увидеть только в том случае, если вы экспортируете результаты или сохраните проект, откроете его и подтвердите изменения.
Второй метод использует ключевое слово CURRENT в качестве входного параметра для функции ArcGISProject. Этот метод работает только внутри приложения ArcGIS Pro, так как объект ArcGISProject ссылается на проект, загруженный в данный момент в приложении. Ключевое слово CURRENT может быть использовано в окне Python, блокноте или в инструментах-скриптах геообработки.
Примечание:
Если вы запускаете скрипт в приложении и ссылаетесь на проект, используя путь вместо ключевого слова CURRENT, изменения в текущем приложении не произойдут. Если вы хотите сразу увидеть изменения после работы скрипта, вы должны быть в приложении и использовать ключевое слово CURRENT.
Примечание:
На проекты можно ссылаться несколько раз, но только первая ссылка может быть сохранена напрямую с помощью метода save класса ArcGISProject. Другие ссылки на проект будут открыты только для чтения. У класса ArcGISProject есть свойство isReadOnly, которое можно использовать для определения состояния чтения/записи проекта.
Более полное описание и примеры кода см. в справке к классу ArcGISProject.
Синтаксис
ArcGISProject (aprx_path)
| Параметр | Описание | Тип данных |
aprx_path | The full system path and file name of an existing ArcGIS project (.aprx) or the CURRENT keyword. | String |
| Тип данных | Описание |
| ArcGISProject | Объект ArcGISProject обеспечивает доступ к свойствам и методам проекта. Ссылка на этот объект существенна для большинства операций скриптов arcpy.mp. |
Пример кода
Следующая строка кода ссылается на проект на диске и может быть запущена вне сеанса ArcGIS Pro (например, из среды IDE Python).
import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")Следующую строку кода необходимо запустить из приложения ArcGIS Pro, поскольку в ней используется ключевое слово CURRENT. Этот пример будет работать в окне Python или с помощью инструмента-скрипта геообработки.
aprx = arcpy.mp.ArcGISProject("CURRENT")