Skip to main content

Utiliser ArcPy dans un notebook

Plusieurs modules ArcPy sont disponibles dans ArcGIS Notebooks grâce au runtime de notebook avancé.

Le paquetage de site ArcPy permet d’effectuer des tâches d’analyse, de conversion et de gestion des données géographiques. ArcPy vous permet d’exécuter par programmation tous les outils de géotraitement ArcGIS standard et propose des fonctions et des classes d’assistance.

En savoir plus sur ArcPy

Pour utiliser ArcPy dans un notebook, vous devez disposer de la licence ArcGIS Notebook Server Advanced et les utilisateurs doivent posséder le privilège de création et d’exécution des notebooks ArcPy.

Prise en main d’ArcPy dans un notebook

Pour utiliser ArcPy dans un notebook, importez sa bibliothèque en exécutant une cellule avec les lignes suivantes :

import arcpy
arcpy.GetInstallInfo()['Version']

Pour accéder à du contenu ou le partager dans votre organisation, vous devez être connecté. Dans ArcGIS Notebooks, vous pouvez vous connecter à votre organisation sans indiquer explicitement une URL, un nom d’utilisateur ou un mot de passe. Pour cela, utilisez le code suivant :

arcpy.SignInToPortal("notebook")

Conseil :

Bien que la plupart des outils ArcPy fonctionnent avec des chemins de type Linux, il est recommandé d’utiliser des chemins au format Windows pour les fichiers et répertoires lors de l’exécution de notebooks dans un conteneur Windows. C:\arcgis\home, par exemple. Cela garantit le bon fonctionnement des outils et processus ArcPy.

Le chemin à l’espace de travail peut également être créé dynamiquement. Par exemple :

import os
import arcpy
drive = os.path.splitdrive(os.getcwd())[0]
home_dir = os.path.join(drive + os.sep, "arcgis", "home")
arcpy.env.workspace = home_dir

Modules ArcPy

Les modules indiqués ci-dessous sont inclus avec ArcPy dans ArcGIS Notebooks.

  • Le module d’accès aux données (arcpy.da) permet de contrôler la session d’édition, l’opération d’édition, la prise en charge améliorée du curseur (y compris des performances plus rapides), les fonctions de conversion des tables et des classes d’entités depuis et vers des tableaux NumPy, et la prise en charge des processus de versionnement, de réplicas, de domaines et de sous-types.

  • Le module de géocodage, arcpy.geocoding, vous permet d’effectuer diverses opérations de géocodage, notamment la recherche de la localisation d’un lieu ou d’une adresse, la recherche du lieu ou de l’adresse la plus proche d’une localisation donnée, ou la génération d’un ensemble de suggestions renseignées automatiquement en cas de saisie partielle.

  • Le module Analyse d’image, arcpy.ia, permet de gérer et de traiter des données d’imagerie et raster. Le module inclut également des fonctions d’automatisation du géotraitement et du traitement raster fournies par l’extension ArcGIS Image Analyst.

  • Le module de cartographie, arcpy.mp, vous permet de manipuler le contenu de projets (.aprx) et de fichiers de couche (.lyrx) existants, ainsi que de créer et modifier des cartes, des mises en page et des rapports.

  • Le module de métadonnées, arcpy.metadata, vous permet d’explorer les informations décrivant vos cartes et données, et d’automatiser vos processus, notamment pour la gestion des métadonnées géospatiales normalisées.

  • Le module Network Analyst, arcpy.nax, est prévu pour utiliser la fonctionnalité d’analyse de réseau fournie par l’extension ArcGIS Network Analyst.

    Le module hérité arcpy.na n’est pas inclus dans ArcGIS Notebooks.

  • Le module de partage, arcpy.sharing, permet d’automatiser le partage des processus. Utilisez-le pour créer un brouillon de partage, à savoir un ensemble de propriétés configurables pour une couche Web, un outil Web et un service de géotraitement, un service de carte ou un service d’imagerie.

  • Le module Spatial Analyst, arcpy.sa, permet d'accéder à tous les outils de géotraitement disponibles dans la boîte d'outils Spatial Analyst ainsi qu'aux autres fonctions et classes qui vous aident à automatiser les processus de traitement raster.

Fonctions ArcPy

ArcPy propose plusieurs fonctions pour mieux gérer les processus utilisant Python. En plus des groupes de fonctions répertoriés dans cette rubrique, tous les outils de géotraitement sont disponibles sous forme de fonctions ArcPy.

Pour plus d’informations sur les fonctions incluses dans chaque groupe, reportez-vous à la rubrique Aperçu des fonctions ArcPy dans la documentation d’ArcGIS Pro.

Les groupes de fonctions suivants sont inclus avec ArcGIS Notebooks :

  • Fonctions d’ArcGIS Online / de portail

  • Fonctions de stockage de données

  • Fonctions de description des données

  • Fonctions liées à l’environnement

  • Fonctions de champ

  • Fonctions générales, sauf ListPrinterNames

  • Fonctions de données générales

  • Fonctions de géométrie

  • Fonctions de licence et d’installation

  • Fonctions d’énumération de données, sauf ListVersions

  • Fonctions de journalisation

  • Fonctions d’empaquetage

  • Fonctions de boîtes de dialogue d’avancement

  • Fonctions raster

  • Fonctions de référence spatiale et de transformation