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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# 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, которые можно вставить в блокнот и вызывать в нем. Фрагмент кода также можно редактировать после добавления в блокнот.

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

  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 как векторный слой