Блокноты в ArcGIS Pro

ArcGIS Notebooks построен на базе Jupyter Notebook – веб-приложении с открытым исходным кодом, которое позволяет создавать и публиковать документы, содержащие рабочий код Python, визуализации и описательный текст. С ArcGIS Notebooks, интегрированным в ArcGIS Pro, вы можете выполнять анализ и немедленно просматривать результаты в географическом контексте, взаимодействовать с появляющимися данными, документировать и автоматизировать свой рабочий процесс, а также сохранять его для последующего использования или делиться им. ArcGIS Notebooks может использоваться для очистки и преобразования данных, численного моделирования, статистического моделирования, машинного обучения, административных и других задач.

Вся функциональность Python в ArcGIS Pro доступна через ArcGIS Notebooks, включая базовые функции Python, стандартные библиотеки Python, ArcPy, ArcGIS API for Python, а также многие сторонние библиотеки, включенные в ArcGIS Pro, например, NumPy и pandas. ArcGIS Pro может быть расширен с помощью библиотек с открытым кодом через ArcGIS Pro Python Package Manager.

Хотя Jupyter Notebooks с открытым исходным кодом работают локально в приложении ArcGIS Pro, интегрированная Esri среда Jupyter Notebook также доступна на портале ArcGIS Enterprise с ArcGIS Notebook Server.

Более подробно о ArcGIS Notebooks

Если вам нужен интерактивный терминал Python для тестирования или запуска коротких фрагментов кода без расширенных функций Notebook, см. Окно Python.

Как использовать ArcGIS Notebooks в ArcGIS Pro

Чтобы создать блокнот, щелкните вкладку Вставка на ленте и щелкните кнопку Новый блокнот Новый блокнот. Или откройте панель Каталог, перейдите к директории проекта, щелкните правой кнопкой папку и выберите Новый > Блокнот Новый блокнот.

ArcGIS Notebooks, добавленные в проект, будут перечислены в папке Блокноты Блокноты на панели Каталог. Блокноты, созданные при помощи ArcGIS Pro, автоматически добавляются в ваш проект. Чтобы добавить в проект существующий блокнот, щелкните правой кнопкой мыши папку Блокноты и выберите Добавить блокнот Добавить блокнот или щелкните стрелку ниспадающего списка рядом с кнопкой Добавить блокнот на ленте Вставка и выберите Добавить блокнот.

Чтобы открыть существующий блокнот в проекте, перейдите к файлу блокнота на панели Каталог и либо дважды щелкните блокнот, либо щелкните блокнот правой кнопкой мыши и выберите Открыть блокнот.

Блокнот открывается в пользовательском интерфейсе, аналогичном стандартному Блокноту Jupyter, с кнопкой НовыйНовый блокнот, кнопкой Сохранить Сохранить и кнопкой Приостановить ядро Отмена, расположенными на вкладке Блокнот в ArcGIS Pro. Лента Notebook появляется автоматически при открытии вида Notebook. Обратитесь к документации пользовательского интерфейса Блокнот Jupyter за дополнительной информацией о том, как работать с Блокнотом Jupyter.

Чтобы экспортировать Блокнот, используйте ниспадающее меню Экспорт Скрипт, чтобы экспортировать блокнот в Python (.py) или файл HTML (.html).

Дополнительная справочная информация

В меню справки вида Блокнот есть тур по пользовательскому интерфейсу Jupyter Notebook, клавишам быстрого доступа, языку разметки и другим актуальным темам.

Функция заполнения при помощи клавиши tab в блокноте предоставляет контекстную справку, основанную на местоположении указателя. Методы и свойства можно просмотреть, нажав Tab после точки, следующей за именем объекта или библиотеки. Например, введите в ячейку arcpy.analysis и нажмите Tab, чтобы увидеть список возможных методов, доступных в модуле analysis. Когда список откроется, его можно отфильтровать, продолжая ввод. После выбора подходящего метода из списка, нажмите Enter, чтобы использовать его.

Используйте функцию заполнения при помощи клавиши tab для получения вариантов выбора в ArcGIS Notebook.

Все инструменты, модули, функции, классы и ключевые слова Python хранят документацию, которая предоставляет информацию о их применении. Документация может быть активирована в месте курсора, нажатием Shift+Tab. Ниже показана документация для инструмента Буфер:

Используйте Shift+Tab для доступа к справке инструмента.

Или доступ к той же документации можно получить при помощи встроенной функции Python help. Ниже показана справочная документация для arcpy.analysis.Buffer:

Использование функции справки Python для доступа к справочной документации инструмента.

Интеграция с ArcGIS Pro

Помимо окна Python, ArcGIS Notebooks в ArcGIS Pro обеспечивает доступ к содержанию карты, позволяя использовать интерактивные рабочие процессы:

  • Доступ к слоям и другим ресурсам карты в блокноте можно обеспечить по имени или с помощью пути к данным.
  • Результаты инструментов геообработки по умолчанию добавляются в активную карту проекта.
  • Инструменты геообработки учитывают выборки.
  • Учитываются глобальные настройки параметров среды геообработки, также они могут быть заменены настройками среды геообработки.
  • Рабочие процессы геообработки могут происходить во время текущего сеанса редактирования. Если инструмент геообработки непосредственно изменяет объект, редактируемый в сеансе редактирования (он не сохраняет результат геообработки как другой класс объектов), можно сохранить или удалить изменения с ленты Редактирование.
  • Если инструмент геообработки запущен из ArcGIS Notebook, итоговый журнал инструмента появится в истории геообработки.
Внимание:

ArcGIS Pro может запускать один экземпляр Python. Этот экземпляр Python используется каждым открытым блокнотом на одном экземпляре ArcGIS Pro. Если разные блокноты используют одно и то же имя переменной, это может привести к конфликтам имен переменных. Чтобы избежать возможных конфликтов имен переменных, рассмотрите следующие варианты:

  1. Открывайте по одному блокноту за раз.
  2. Запускайте блокноты на отдельных экземплярах ArcGIS Pro.
  3. Используйте уникальные имена переменных в параллельно работающих блокнотах.
  4. Выполните команду %reset -f, чтобы удалить все переменные в блокноте.

Внимание:

ArcGIS Notebooks размещенный с ArcGIS Enterprise, не поддерживается непосредственно в ArcGIS Pro. Чтобы использовать размещенный блокнот в ArcGIS Pro, загрузите файл .ipynb и используйте файл локально.

Примечание:
При использовании команды %matplotlib inline для отображения графиков необходимо нарисовать график с помощью функции show() из matplotlib.pyplot.

ArcGIS Notebooks в ArcGIS Pro поддерживает только Python, другие языки ядра (такие как R) не поддерживаются.

ArcGIS API for Python

В ArcGIS API for Python объект GIS используется для представления ГИС, с который вы работаете, например, ArcGIS Online или экземпляр ArcGIS Enterprise. Ваша ГИС может поддерживать множество схем аутентификации, обратитесь к разделу Работа с различными схемами аутентификации, чтобы узнать, как выполнять аутентификацию скриптов и блокнотов в различных схемах.

Например, чтобы подключиться к ArcGIS Online как анонимный пользователь, укажите gis = GIS(). Чтобы подключиться к активному порталу в ArcGIS Pro без ввода учетных данных, укажите gis = GIS("pro").