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
Чтобы создать блокнот, перейдите на вкладку Анализ и нажмите кнопку Python . Или откройте панель Каталог, перейдите к директории проекта, щелкните правой кнопкой папку и выберите Новый > Блокнот . Чтобы открыть существующий блокнот, нажмите кнопку Добавить блокнот на ленте Вставка и выберите Открыть блокнот или перейдите к расположению файла блокнота на панели Каталог и либо дважды щелкните файл блокнота, либо щелкните правой кнопкой мыши и выберите Открыть блокнот.
ArcGIS Notebooks, добавленные в проект, будут перечислены в узле Блокноты на панели Каталог. Блокноты, созданные при помощи ArcGIS Pro, автоматически добавляются в ваш проект. Для добавления существующего блокнота в проект, перейдите к директории проекта через панель Каталог, щелкните правой кнопкой файл Notebook и выберите Добавить в проект.
Интерфейс блокнота похож на стандартный интерфейс Jupyter Notebook, с небольшими отличиями. Кнопки Новый , Сохранить и Приостановить ядро находятся на вкладке ArcGIS Pro Notebook. Лента Notebook появляется автоматически при открытии вида Notebook. Обратитесь к официальной документации пользовательского интерфейса Jupyter Notebook за дополнительной информацией о том, как работать с Jupyter Notebook.
Дополнительная справочная информация
В меню справки вида Notebook представлен тур по пользовательскому интерфейсу 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 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").