Skip to main content

Verwenden von ArcPy in einem Notebook

Über die Advanced Notebook-Runtime in ArcGIS Notebooks werden verschiedene ArcPy-Module zur Verfügung gestellt.

Mit dem ArcPy-Site-Paket können Sie geographische Informationen analysieren, konvertieren und verwalten. ArcPy ermöglicht die programmgesteuerte Ausführung standardmäßiger Geoverarbeitungswerkzeuge von ArcGIS und bietet Hilfsfunktionen und Klassen.

Weitere Informationen zu ArcPy

Zur Verwendung von ArcPy in einem Notebook muss ArcGIS Notebook Server mit der Advanced-Lizenz lizenziert sein, und Benutzern muss die Berechtigung zum Erstellen und Ausführen von ArcPy-Notebooks zugewiesen sein.

Erste Schritte mit ArcPy in einem Notebook

Zur Verwendung von ArcPy in einem Notebook müssen Sie zunächst die Bibliothek importieren, indem Sie eine Zelle mit den folgenden Zeilen ausführen:

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

Um auf Inhalte in Ihrer Organisation zuzugreifen oder Inhalte in Ihrer Organisation freizugeben, müssen Sie angemeldet sein. In ArcGIS Notebooks können Sie sich bei Ihrer Organisation anmelden, ohne explizit eine URL, einen Benutzernamen oder ein Kennwort anzugeben, indem Sie den folgenden Code verwenden:

arcpy.SignInToPortal("notebook")

Tipp:

Obwohl die meisten ArcPy-Werkzeuge mit Pfaden im Linux-Format arbeiten, wird empfohlen, bei der Ausführung von Notebooks in einem Windows-Container Dateipfade im Windows-Format zu verwenden. Beispiel C:\arcgis\home. Dadurch wird sichergestellt, dass ArcPy-Werkzeuge und -Workflows erfolgreich ausgeführt werden.

Der Workspace-Pfad kann auch dynamisch erstellt werden. Beispiel:

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

ArcPy-Module

Die nachstehenden Module sind mit ArcPy in ArcGIS Notebooks enthalten.

  • Das Data Access-Modul (arcpy.da) ermöglicht die Steuerung der Editiersitzung und von Bearbeitungsvorgängen, bietet bessere Unterstützung von Cursorn (u. a. bessere Performance), Funktionen zum Konvertieren von Tabellen und Feature-Classes in und aus NumPy-Arrays sowie Unterstützung von Workflows für Versionierung, Replikate, Domänen und Subtypes.

  • Mit dem Geokodierungsmodul (arcpy.geocoding) können Sie verschiedene Geokodierungsvorgänge durchführen, darunter das Auffinden der Position eines Ortes oder einer Adresse, das Auffinden des nächstgelegenen Ortes oder der nächstgelegenen Adresse zu einer bestimmten Position sowie das Generieren einer Reihe von Vorschlägen zur automatischen Vervollständigung bei unvollständiger Eingabe.

  • Das Bildanalysemodul (arcpy.ia) ermöglicht das Verwalten und Analysieren von Bild- und Raster-Daten. Das Modul umfasst zudem die Funktionen zur Automatisierung der Verarbeitung von Geodaten und Raster-Daten, die von der Erweiterung "ArcGIS Image Analyst" bereitgestellt werden.

  • Mit dem Mapping-Modul (arcpy.mp) können Sie den Inhalt vorhandener Projekte (.aprx) und Layer-Dateien (.lyrx) bearbeiten sowie Karten, Layouts und Berichte erstellen und ändern.

  • Mit dem Metadaten-Modul (arcpy.metadata) können Sie Informationen zur Beschreibung Ihrer Karten und Daten einsehen und Ihre Workflows automatisieren, insbesondere bei der Verwaltung standardkonformer räumlicher Metadaten.

  • Mit dem Network Analyst-Modul (arcpy.nax) können Sie die Netzwerkanalysefunktionen nutzen, die mit der Erweiterung "ArcGIS Network Analyst" bereitgestellt werden.

    Das Legacy-Modul arcpy.na ist nicht in ArcGIS Notebooks enthalten.

  • Das Freigabemodul ist ein arcpy.sharing-Modul, mit dem Sie Freigabe-Workflows automatisieren können. Verwenden Sie es zum Erstellen eines Freigabeentwurfs. Dabei handelt es sich um einen konfigurierbaren Satz von Eigenschaften für einen Web-Layer, ein Web-Werkzeug und einen Geoverarbeitungsservice, einen Kartenservice oder einen Image-Service.

  • Das Spatial Analyst-Modul (arcpy.sa) bietet Zugriff auf alle Geoverarbeitungswerkzeuge in der Toolbox "Spatial Analyst" sowie auf weitere Funktionen und Klassen, die eine Automatisierung von Workflows für die Raster-Verarbeitung ermöglichen.

ArcPy-Funktionen

Für eine bessere Unterstützung von Workflows mit Python bietet ArcPy eine Reihe von Funktionen. Zusätzlich zu den in diesem Thema aufgeführten Funktionsgruppen können alle Geoverarbeitungswerkzeuge als ArcPy-Funktionen aufgerufen werden.

Weitere Informationen zu den in den einzelnen Gruppen enthaltenen Funktionen finden Sie unter Überblick über ArcPy-Funktionen in der ArcGIS Pro-Dokumentation.

ArcGIS Notebooks enthält die folgenden Funktionsgruppen:

  • ArcGIS Online-/Portal-Funktionen

  • Data-Store-Funktionen

  • Funktionen zum Beschreiben von Daten

  • Umgebungsfunktionen

  • Feldfunktionen

  • Allgemeine Funktionen, außer ListPrinterNames

  • Allgemeine Datenfunktionen

  • Geometriefunktionen

  • Lizenz- und Installationsfunktionen

  • Funktionen zum Auflisten von Datenfunktionen, außer ListVersions

  • Protokollfunktionen

  • Paketfunktionen

  • Funktionen des Fortschrittsdialogfeldes

  • Raster-Funktionen

  • Funktionen zum Raumbezug und zur Transformation