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, чтобы использовать его.
Все инструменты, модули, функции, классы и ключевые слова Python хранят документацию, которая предоставляет информацию о их применении. Документация может быть активирована в месте курсора, нажатием Shift+Tab. Ниже показана документация для инструмента Буфер:
Или доступ к той же документации можно получить при помощи встроенной функции Python help. Ниже показана справочная документация для arcpy.analysis.Buffer:
Интеграция с ArcGIS Pro
Помимо окна Python, ArcGIS Notebooks в ArcGIS Pro обеспечивает доступ к содержанию карты, позволяя использовать интерактивные рабочие процессы:
- Доступ к слоям и другим ресурсам карты в блокноте можно обеспечить по имени или с помощью пути к данным.
- Результаты инструментов геообработки по умолчанию добавляются в активную карту проекта.
- Инструменты геообработки учитывают выборки.
- Учитываются глобальные настройки параметров среды геообработки, также они могут быть заменены настройками среды геообработки.
- Рабочие процессы геообработки могут происходить во время текущего сеанса редактирования. Если инструмент геообработки непосредственно изменяет объект, редактируемый в сеансе редактирования (он не сохраняет результат геообработки как другой класс объектов), можно сохранить или удалить изменения с ленты Редактирование.
- Если инструмент геообработки запущен из ArcGIS Notebook, итоговый журнал инструмента появится в истории геообработки.
Внимание:
ArcGIS Pro может запускать один экземпляр Python. Этот экземпляр Python используется каждым открытым блокнотом на одном экземпляре ArcGIS Pro. Если разные блокноты используют одно и то же имя переменной, это может привести к конфликтам имен переменных. Чтобы избежать возможных конфликтов имен переменных, рассмотрите следующие варианты:
- Открывайте по одному блокноту за раз.
- Запускайте блокноты на отдельных экземплярах ArcGIS Pro.
- Используйте уникальные имена переменных в параллельно работающих блокнотах.
- Выполните команду %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").