Использование фрагментов кода Python

Представленный в ArcGIS Enterprise11.0, ArcGIS Notebook Server позволяет просматривать и вставлять в блокнот предварительно написанные фрагменты повторно используемого кода, известные как фрагменты кода.

Создание фрагмента кода

Вы можете создать фрагмент кода из своего блокнота. Создаваемые фрагменты можно использовать в том же или другом блокноте. Фрагменты кода, которые вы создаете, хранятся в элементах библиотеки фрагментов кода блокнота в ваших ресурсах, которые используются для организации ваших фрагментов и могут быть опубликованы.

Чтобы создать фрагмент кода, вы должны сначала создать библиотеку фрагментов кода блокнота, в которой будут храниться ваши фрагменты. Библиотека фрагментов кода может содержать не более 100 фрагментов.

Создание библиотеки фрагментов кода блокнота

Чтобы создать библиотеку фрагментов кода, выполните следующие действия:

1. Вверху ленты редактора блокнота щелкните Фрагменты кода.
2. Нажмите кнопку Добавить и выберите Создать элемент библиотеки.
3. Введите заголовок и краткую информацию о своей библиотеке и, при желании, добавьте теги, описывающие фрагменты кода, хранящиеся в библиотеке.
4. Нажмите Создать.

Добавление фрагмента кода

После создания библиотеки вы можете добавлять в нее фрагменты кода. Чтобы добавить фрагмент кода, сделайте следующее:

1. Вверху ленты редактора блокнота щелкните Фрагменты кода.
2. Нажмите кнопку Добавить и выберите Добавить фрагмент кода.
3. Введите заголовок фрагмента кода, выберите библиотеку, в которую хотите его добавить, и введите описание.

   В ниспадающем списке Выберите элемент библиотеки фрагментов кода отображаются библиотеки, в которые вы можете добавить свой фрагмент кода. В списке также указывается количество фрагментов в этой библиотеке, для которых общий доступ задан как Наследовать.

4. Добавьте код для фрагмента.
   1. Если блокнот использует среду выполнения версии 8.0 или более новой, выберите ячейку, которую вы хотите добавить в качестве фрагмента кода, и щелкните Копировать из активной ячейки.
   2. Если блокнот использует среду выполнения версии 7.0 или более ранней, введите код для фрагмента кода.

   Примечание:

   Для блокнотов, использующих среду выполнения версии 7.0 или более ранней, скопируйте и вставьте код из ячейки блокнота вместо ввода кода, чтобы избежать отступов или других синтаксических ошибок.

5. Щелкните Сохранить.

Вы можете внести изменения в свои фрагменты кода, нажав кнопку Дополнительные опции для фрагмента и нажав Редактировать.

Вставка фрагментов кода

Используя панель Фрагменты кода, выполните следующие действия, чтобы вставить фрагмент кода:

1. Вверху ленты редактора блокнота щелкните Фрагменты кода.
2. Перейдите к библиотеке фрагментов кода, содержащей фрагмент, который вы хотите вставить.
3. Нажмите Просмотреть подробности для фрагмента, чтобы увидеть предварительный просмотр кода.
4. Когда вы найдете фрагмент кода, который хотите вставить, нажмите кнопку Добавить на панели фрагментов кода или щелкните Добавить в блокнот на панели предварительного просмотра кода, чтобы вставить фрагмент кода в блокнот в виде новой ячейки.

Ниже приведен пример фрагмента кода, добавляемого в блокнот:

# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
    if "admin" in gis.__dict__:
        credits = gis.admin.credits.credits
        print(f"This ArcGIS Online organization has {credits} credits.")
    else:
        print("Please connect to the ArcGIS Online organization as an administrator to check credits.")

# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")

# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)

Фрагменты кода Esri

Все доступные фрагменты кода курируются Esri. Эти специально подобранные фрагменты кода позволяют реализовать стандартные рабочие процессы ГИС в ваших блокнотах. Фрагменты кода написаны в виде функций Python, которые можно вставить в блокнот и вызывать в нем. Фрагмент кода также можно редактировать после добавления в блокнот.

Примечание:

В версии 11.0 названия и описания подобранных фрагментов кода доступны только на английском языке.

Ниже приведены доступные фрагменты кода, которые можно вставить в блокнот:

1. Администрирование ГИС — фрагменты кода, выполняющие стандартные задачи администрирования ГИС.

   Примечание:

   Многие из этих фрагментов кода требуют подключения администратора.

   • Проверить оставшиеся кредиты (только ArcGIS Online).
   • Проверить кредиты определенного пользователя (только ArcGIS Online).
   • Получить базовый URL-адрес сервиса элемента слоя.
   • Запросить журналы портала и сохранить их как CSV (только ArcGIS Enterprise).
   • Вход на портал ArcPy.
2. Управление ресурсами — фрагменты кода, помогающие управлять ресурсами вашей ГИС и файлами в каталоге рабочей области блокнота.
   • Копировать базу геоданных в директорию рабочей области.
   • Создать файловую базу геоданных с пустым классом пространственных объектов.
   • Создать папку в директории рабочей области.
   • Загрузить элемент файла с портала в директорию рабочей области.
   • Список наборов данных.
   • Список файлов.
   • Удалить файловую базу геоданных из директории рабочей области.
   • Удалить папку в директории рабочей области.
   • Распаковать архивный файл в директорию рабочей области.
3. Наука о данных и анализ - фрагменты кода, которые можно реализовать в рабочих процессах обработки и анализа данных с помощью ArcGIS API for Python, ArcPy и других библиотек Python.

   Примечание:

   Используйте расширенную среду выполнения блокнота для запуска фрагментов кода, требующих ArcPy. Дополнительные сведения о среде выполнения блокнота см. в Задание среды выполнения блокнота.

   • Конвертировать класс пространственных объектов в векторный слой.
   • Конвертировать класс пространственных объектов в Spatially Enabled DataFrame.
   • Конвертировать векторный слой в Spatially Enabled DataFrame.
   • Конвертировать Spatially Enabled DataFrame в класс пространственных объектов.
   • Отобразить изображение по URL.
   • Отображение изображения из директории рабочей области.
   • Заполнить пропущенные значения.
   • Список полей в классе пространственных объектов.
   • Список полей в слое.
   • Список слоев в элементе.
   • Построить Spatially Enable DataFrame (быстрый старт).
   • Построить Spatially Enable DataFrame с помощью метода отображения по границам классов.
   • Построить Spatially Enable DataFrame с помощью простого метода отображения.
   • Построить Spatially Enable DataFrame с помощью метода отображения уникальные значения.
   • Опубликовать Spatially Enabled DataFrame как векторный слой.