Feld berechnen (Data Management)

Zusammenfassung

Hiermit werden die Werte eines Feldes für eine Feature-Class, einen Feature-Layer oder ein Raster berechnet.

Verwendung

    Vorsicht:

    Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge, die Eingabedaten ändern oder aktualisieren.

  • Weitere Informationen über Python-Ausdrücke finden Sie unter Feld berechnen – Python-Beispiele.

    Weitere Informationen über Arcade-Ausdrücke finden Sie unter ArcGIS Arcade in der Developer-Hilfe.

    Weitere Informationen zu SQL-Ausdrücken finden Sie unter Berechnen von Feldwerten.

    Weitere Informationen über VBScript-Ausdrücke finden Sie unter Feld berechnen – VBScript-Beispiele.

  • In den Arcade-Ausdrücken dieses Werkzeugs wird das Arcade-Profil "Feldberechnung" verwendet. Ein Arcade-Profil ist ein Kontext, in dem ein Arcade-Ausdruck ausgewertet und verstanden wird. Wenn ein Arcade-Ausdruck ausgewertet wird, wird der Rückgabewert in den Feldtyp des Ausgabewerts umgewandelt.

  • Bei Verwendung mit einem ausgewählten Feature-Satz, wie zum Beispiel den mit einer Abfrage im Werkzeug Feature-Layer erstellen oder Layer nach Attributen auswählen erstellten Features, werden nur die ausgewählten Datensätze aktualisiert.

  • Sie können die Berechnung jeweils nur für ein Feld durchführen. Für mehrere Berechnungen verwenden Sie das Werkzeug Felder berechnen.

  • Vorhandene Feldwerte werden überschrieben. Um die ursprünglichen Werte beizubehalten, erstellen Sie eine Kopie der Eingabetabelle als Sicherung, oder verwenden Sie die Option Rückgängig aktivieren im Bereich Geoverarbeitung.

  • Bei Berechnungen mit Python müssen Feldnamen in Ausrufezeichen eingeschlossen werden (z. B. !fieldname!).

    Bei Berechnungen mit Arcade müssen Feldnamen das Präfix $feature. (beispielsweise $feature.fieldname) erhalten.

  • Hinweis:

    Um Zeitwerte zwischen Feldtypen (Datum, Nur Datum, Nur Zeit, Zeitstempelversatz und Text) zu übertragen, verwenden Sie stattdessen das Werkzeug Zeitfeld konvertieren.

  • Wenn Sie eine Zeichenfolge für ein Text- oder Zeichenfeld berechnen möchten, muss die Zeichenfolge im Dialogfeld in doppelte Anführungszeichen (z. B. "Zeichenfolge") gesetzt werden, in Skripten dagegen muss die Zeichenfolge zusätzlich in einfache Anführungszeichen eingeschlossen werden (z. B. '"string"').

  • Wenn Sie einen numerischen Wert für ein Feld berechnen möchten, geben Sie im Parameter Ausdruck nur den numerischen Wert ohne Anführungszeichen an.

  • Vorversion:

    arcgis.rand() wird ab ArcGIS Pro 2.0 nicht mehr unterstützt. Stattdessen sollten vergleichbare Funktionen unter Verwendung des random-Moduls von Python verwendet werden. Um das random-Modul erfolgreich zu verwenden, fügen Sie es als Import in den Parameter Code-Block ein.

  • Sie können komplexe Ausdrücke mit dem Parameter Code-Block erstellen. Geben Sie den Codeblock direkt im Dialogfeld oder als Zeichenfolge bei der Skripterstellung ein. Der Ausdruck und der Code-Block sind miteinander verbunden. Der Code-Block muss zurück auf den Ausdruck verweisen. Das Ergebnis des Code-Blocks muss an den Ausdruck übergeben werden.

    Der Parameter Code-Block wird nur für Python-Ausdrücke unterstützt.

  • Sie können das Python-Modul math und die Formatierung im Code-Block verwenden. Sie können auch weitere Module importieren. Das Modul math enthält neben zahlentheoretischen und Repräsentationsfunktionen auch Potenz- und Logarithmusfunktionen sowie trigonometrische Funktionen, Winkelkonvertierungsfunktionen, hyperbolische Funktionen und mathematische Konstanten. Weitere Informationen zum Modul math finden Sie in der Hilfe von Python.

  • Zum Berechnen von Geometrieinformationen in Python verwenden Sie Geometry-Objekteigenschaften. Verwenden Sie beispielsweise zum Berechnen der Anzahl der Stützpunkte in einem Feature den Ausdruck !shape.pointCount!.

    Hinweis:

    Das Werkzeug Geometrieattribute berechnen unterstützt ähnliche Berechnungen.

    Zum Berechnen der Fläche und Länge in Python verwenden Sie die Methoden getArea und getLength mit einer Methode und einem Einheitstyp.

    • Zum Berechnen der geodätischen Fläche von Polygonen in Quadratkilometern verwenden Sie den folgenden Ausdruck:
      !shape.getArea('GEODESIC', 'SQUAREKILOMETERS')!
    • Zum Berechnen der planaren Länge von Polylinien (oder Polygonen) in Yards verwenden Sie den folgenden Ausdruck:
      !shape.getLength('PLANAR', 'YARDS')

    Weitere Informationen finden Sie in den Abschnitten zu ArcPy Polygon- und Polyline-Objekten.

    Weitere Informationen zu Geoverarbeitungswerkzeugen und linearen Einheiten sowie Flächeneinheiten

  • ArcGIS-Anwendungen verwenden UTF-16-LE-Codierung zum Lesen und Schreiben von .cal-Dateien. Andere Anwendungen (z. B. Notepad) können zum Erstellen oder Ändern von .cal-Dateien verwendet werden, solange die Datei mit UTF-16-LE-Codierung geschrieben wird. Eine Datei mit einer anderen Codierung wird im Codeblock nicht geladen.

  • Beim Arbeiten mit verbundenen Daten können Sie nur Felder aus der Quelltabelle aktualisieren. Sie können keine Felder aus der verbundenen Tabelle aktualisieren. Zum Durchführen einer Berechnung für die verbundene Tabelle führen Sie die Berechnung direkt für die Tabelle durch.

  • Python-Ausdrücke, bei denen versucht wird, Zeichenfolgenfelder, die NULL enthalten oder einen durch Null geteilten Wert, zu verbinden, geben NULL für diesen Feldwert zurück.

  • SQL-Ausdrücke ermöglichen schnellere Berechnungen für Feature-Services und Enterprise-Geodatabases. Statt Features oder Zeilen einzeln nacheinander zu berechnen, wird eine einzelne Anforderung an den Server oder die Datenbank gesendet. Dies führt zu schnelleren Berechnungen.

    Nur Feature-Services und Enterprise-Geodatabases unterstützen SQL-Ausdrücke. Verwenden Sie für andere Formate Python- oder Arcade-Ausdrücke.

    Die Verwendung der Option SQL des Parameters Ausdruckstyp unterliegt den folgenden Beschränkungen:

    • Die Option wird nur für Db2-, Oracle-, PostgreSQL-, SAP HANA- und SQL Server-Enterprise-Geodatabases unterstützt.
    • Die Berechnung von Feldwerten in verbundenen Tabellen wird nicht unterstützt.
    • Versionierte und archivierte Enterprise-Geodatabase-Daten werden nicht unterstützt.
    • Das Rückgängigmachen von Geoverarbeitungsvorgängen wird nicht unterstützt.

    Hilfe zu SQL-Ausdrücken finden Sie in der Dokumentation Ihres Datenbankanbieters.

  • Der Parameter Ausdruck im Dialogfeld des Werkzeugs enthält eine Dropdown-Liste Werte einfügen, in der Sie Feldwerte aus dem ausgewählten Feld in der Liste Felder oder Domänenwerte aus der Domäne des ausgewählten Feldes hinzufügen können. Verwenden Sie die Domänenwerte, um sicherzustellen, dass nur gültige Werte für die Felddomäne in das Feld eingefügt werden.

Parameter

BeschriftungErläuterungDatentyp
Eingabetabelle

Die Tabelle, die das Feld enthält, das mit der neuen Berechnung aktualisiert wird.

Mosaic Layer; Raster Layer; Table View
Feldname (vorhanden oder neu)

Das Feld, das durch die neue Neuberechnung aktualisiert wird.

Wenn unter dem angegebenen Namen kein Feld in der Eingabetabelle vorhanden ist, wird ein entsprechendes Feld hinzugefügt.

Field
Ausdruck

Der einfache Berechnungsausdruck zum Generieren des Wertes, der in die ausgewählten Zeilen eingefügt wird.

SQL Expression
Ausdruckstyp
(optional)

Gibt den zu verwendenden Ausdruckstyp an.

Wenn die Eingabe ein Feature-Service ist, lautet der Standardausdruckstyp SQL. Für alle anderen Eingabearten lautet der Standardausdruckstyp Python.

Weitere Informationen über Python-Ausdrücke finden Sie unter Feld berechnen – Python-Beispiele.

Weitere Informationen über Arcade-Ausdrücke finden Sie unter ArcGIS Arcade in der Developer-Hilfe.

Weitere Informationen zu SQL-Ausdrücken finden Sie unter Berechnen von Feldwerten.

SQL-Ausdrücke ermöglichen schnellere Berechnungen für Feature-Services und Enterprise-Geodatabases. Statt Features oder Zeilen einzeln nacheinander zu berechnen, wird eine einzelne Anforderung an den Server oder die Datenbank gesendet. Dies führt zu erheblich schnelleren Berechnungen.

Nur Feature-Services und Enterprise-Geodatabases unterstützen SQL-Ausdrücke. Verwenden Sie für andere Formate Python- oder Arcade-Ausdrücke.

Weitere Informationen über VBScript-Ausdrücke finden Sie unter Feld berechnen – VBScript-Beispiele.

  • PythonEs wird der Ausdruckstyp "Python" verwendet.
  • ArcadeEs wird der Ausdruckstyp "Arcade" verwendet.
  • SQLEs wird der SQL-Ausdruckstyp verwendet.
  • VBScriptEs wird der Ausdruckstyp "VBScript" verwendet.
String
Code-Block
(optional)

Ein Code-Block, der für komplexe Python- oder VBScript-Ausdrücke verwendet wird.

String
Feldtyp
(optional)

Gibt den Feldtyp des neuen Feldes an. Dieser Parameter wird nur verwendet, wenn der Feldname nicht in der Eingabetabelle vorhanden ist.

Wenn es sich bei dem Feld um ein Textfeld handelt, umfasst es 512 Zeichen, es sei denn, die Eingabe ist ein Shapefile oder eine dBASE-Datei. In diesem Fall beträgt die Länge 254 Zeichen. Sie können die Länge mit dem Werkzeug Feld ändern.

  • Short (16-Bit-Integer)Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • Long (32-Bit-Integer)Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • Big Integer (64-Bit-Ganzzahl)Der Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(253) und 253.
  • Float (32-Bit-Gleitkomma)Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.
  • Double (64-Bit-Gleitkomma)Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • TextDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • DatumDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • Datum (hohe Genauigkeit)Der Feldtyp ist ein Datum mit hoher Genauigkeit. Datumsfelder mit hoher Genauigkeit unterstützen Datums- und Zeitwerte mit Millisekundenzeit.
  • Nur DatumDer Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte.
  • Nur ZeitDer Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.
  • ZeitstempelversatzDer Feldtyp ist "Zeitstempelversatz". Felder des Typs "Zeitstempelversatz" unterstützen ein Datum, eine Uhrzeit und einen Versatz vom UTC-Wert.
  • BLOB (Binärdaten)Der Feldtyp ist "BLOB". BLOB-Felder unterstützen Daten, die als lange Abfolge von binären Zahlen gespeichert sind. Sie benötigen ein spezielles Programm zum Laden und Anschauen oder eine Anwendung eines Drittanbieters, um Objekte in ein BLOB-Feld zu laden bzw. den Inhalt in einem BLOB-Feld anzuzeigen.
  • GUID (Globally Unique Identifier)Der Feldtyp ist "GUID". In GUID-Feldern werden Zeichenfolgen aus 36 Zeichen gespeichert (ähnlich denen in der Registrierung), die in geschweifte Klammern eingeschlossen sind.
  • RasterDer Feldtyp ist "Raster". In Raster-Feldern können Raster-Daten innerhalb oder zusammen mit der Geodatabase gespeichert werden. Es können zwar alle von der ArcGIS-Software unterstützten Raster-Dataset-Formate gespeichert werden, es wird jedoch empfohlen, nur kleine Bilder zu verwenden.
String
Domänen erzwingen
(optional)

Gibt an, ob Felddomänenregeln erzwungen werden.

  • Aktiviert: Felddomänenregeln werden erzwungen. Wenn ein Feld nicht aktualisiert werden kann, bleibt der Feldwert unverändert, und das Werkzeug gibt eine Warnmeldung aus.
  • Deaktiviert: Felddomänenregeln werden nicht erzwungen. Hierbei handelt es sich um die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabetabelle

Die aktualisierte Tabelle.

Table View; Raster Layer; Mosaic Layer

arcpy.management.CalculateField(in_table, field, expression, {expression_type}, {code_block}, {field_type}, {enforce_domains})
NameErläuterungDatentyp
in_table

Die Tabelle, die das Feld enthält, das mit der neuen Berechnung aktualisiert wird.

Mosaic Layer; Raster Layer; Table View
field

Das Feld, das durch die neue Neuberechnung aktualisiert wird.

Wenn unter dem angegebenen Namen kein Feld in der Eingabetabelle vorhanden ist, wird ein entsprechendes Feld hinzugefügt.

Field
expression

Der einfache Berechnungsausdruck zum Generieren des Wertes, der in die ausgewählten Zeilen eingefügt wird.

SQL Expression
expression_type
(optional)

Gibt den zu verwendenden Ausdruckstyp an.

  • PYTHON3Es wird der Ausdruckstyp "Python" verwendet.
  • ARCADEEs wird der Ausdruckstyp "Arcade" verwendet.
  • SQLEs wird der SQL-Ausdruckstyp verwendet.
  • VBEs wird der Ausdruckstyp "VBScript" verwendet.

Wenn die Eingabe ein Feature-Service ist, lautet der Standardausdruckstyp SQL. Für alle anderen Eingabearten lautet der Standardausdruckstyp PYTHON3.

Weitere Informationen über Python-Ausdrücke finden Sie unter Feld berechnen – Python-Beispiele.

Weitere Informationen über Arcade-Ausdrücke finden Sie unter ArcGIS Arcade in der Developer-Hilfe.

Weitere Informationen zu SQL-Ausdrücken finden Sie unter Berechnen von Feldwerten.

SQL-Ausdrücke ermöglichen schnellere Berechnungen für Feature-Services und Enterprise-Geodatabases. Statt Features oder Zeilen einzeln nacheinander zu berechnen, wird eine einzelne Anforderung an den Server oder die Datenbank gesendet. Dies führt zu erheblich schnelleren Berechnungen.

Nur Feature-Services und Enterprise-Geodatabases unterstützen SQL-Ausdrücke. Verwenden Sie für andere Formate Python- oder Arcade-Ausdrücke.

Weitere Informationen über VBScript-Ausdrücke finden Sie unter Feld berechnen – VBScript-Beispiele.

String
code_block
(optional)

Ein Code-Block, der für komplexe Python- oder VBScript-Ausdrücke verwendet wird.

String
field_type
(optional)

Gibt den Feldtyp des neuen Feldes an. Dieser Parameter wird nur verwendet, wenn der Feldname nicht in der Eingabetabelle vorhanden ist.

Wenn es sich bei dem Feld um ein Textfeld handelt, umfasst es 512 Zeichen, es sei denn, die Eingabe ist ein Shapefile oder eine dBASE-Datei. In diesem Fall beträgt die Länge 254 Zeichen. Sie können die Länge mit dem Werkzeug Feld ändern.

  • SHORTDer Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • LONGDer Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • BIGINTEGERDer Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(253) und 253.
  • FLOATDer Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.
  • DOUBLEDer Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • TEXTDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • DATEDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • DATEHIGHPRECISIONDer Feldtyp ist ein Datum mit hoher Genauigkeit. Datumsfelder mit hoher Genauigkeit unterstützen Datums- und Zeitwerte mit Millisekundenzeit.
  • DATEONLYDer Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte.
  • TIMEONLYDer Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.
  • TIMESTAMPOFFSETDer Feldtyp ist "Zeitstempelversatz". Felder des Typs "Zeitstempelversatz" unterstützen ein Datum, eine Uhrzeit und einen Versatz vom UTC-Wert.
  • BLOBDer Feldtyp ist "BLOB". BLOB-Felder unterstützen Daten, die als lange Abfolge von binären Zahlen gespeichert sind. Sie benötigen ein spezielles Programm zum Laden und Anschauen oder eine Anwendung eines Drittanbieters, um Objekte in ein BLOB-Feld zu laden bzw. den Inhalt in einem BLOB-Feld anzuzeigen.
  • GUIDDer Feldtyp ist "GUID". In GUID-Feldern werden Zeichenfolgen aus 36 Zeichen gespeichert (ähnlich denen in der Registrierung), die in geschweifte Klammern eingeschlossen sind.
  • RASTERDer Feldtyp ist "Raster". In Raster-Feldern können Raster-Daten innerhalb oder zusammen mit der Geodatabase gespeichert werden. Es können zwar alle von der ArcGIS-Software unterstützten Raster-Dataset-Formate gespeichert werden, es wird jedoch empfohlen, nur kleine Bilder zu verwenden.
String
enforce_domains
(optional)

Gibt an, ob Felddomänenregeln erzwungen werden.

  • ENFORCE_DOMAINSFelddomänenregeln werden erzwungen.
  • NO_ENFORCE_DOMAINSFelddomänenregeln werden nicht erzwungen. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_table

Die aktualisierte Tabelle.

Table View; Raster Layer; Mosaic Layer

Codebeispiel

CalculateField: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateField im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.AddField("vegtable.dbf", "VEG_TYP2", "TEXT", "", "", "20")
arcpy.management.CalculateField("vegtable.dbf", "VEG_TYP2", 
                                '!VEG_TYPE!.split(" ")[-1]', "PYTHON3")
CalculateField: Beispiel 2 (eigenständiges Skript)

Weisen Sie Schwerpunktwerte mithilfe der Funktion CalculateField neuen Feldern zu.

# Name: CalculateField_centroids.py

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "parcels"
fieldName1 = "xCentroid"
fieldName2 = "yCentroid"
fieldPrecision = 18
fieldScale = 11
 
# Add fields
arcpy.management.AddField(inFeatures, fieldName1, "DOUBLE", 
                          fieldPrecision, fieldScale)
arcpy.management.AddField(inFeatures, fieldName2, "DOUBLE", 
                          fieldPrecision, fieldScale)
 
# Calculate centroid
arcpy.management.CalculateField(inFeatures, fieldName1, 
                                "!SHAPE.CENTROID.X!",
                                "PYTHON3")
arcpy.management.CalculateField(inFeatures, fieldName2, 
                                "!SHAPE.CENTROID.Y!",
                                "PYTHON3")
CalculateField: Beispiel 3 (eigenständiges Skript)

Verwenden Sie die Funktion CalculateField mit einem Code-Block, um auf Bereichen basierende Werte zu berechnen.

# Name: CalculateField_ranges.py

# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inTable = "parcels"
fieldName = "areaclass"
expression = "getClass(float(!SHAPE.area!))"

codeblock = """
def getClass(area):
    if area <= 1000:
        return 1
    if area > 1000 and area <= 10000:
        return 2
    else:
        return 3"""
 
# Run AddField
arcpy.management.AddField(inTable, fieldName, "SHORT")
 
# Run CalculateField 
arcpy.management.CalculateField(inTable, fieldName, expression, "PYTHON3", 
                                codeblock)
CalculateField: Beispiel 4 (eigenständiges Skript)

Weisen Sie Zufallswerte mithilfe der Funktion CalculateField zu einem neuen Feld zu.

# Name: CalculateField_Random.py

# Import system modules
import arcpy
import random
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
  
# Set local variables
inFeatures = "parcels"
fieldName = "RndValue"
expression = "random.randint(0, 10)"
code_block = "import random"
 
# Run AddField
arcpy.management.AddField(inFeatures, fieldName, "LONG")
 
# Run CalculateField 
arcpy.management.CalculateField(inFeatures, fieldName, expression, "PYTHON3", 
                                code_block)
CalculateField: Beispiel 5 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateField mit Arcade im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/fgdb.gdb"
arcpy.management.CalculateField("data", "new_value", "$feature.value1 + $feature.value2", "ARCADE")
CalculateField: Beispiel 6 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateField mit SQL im unmittelbaren Modus verwendet wird.

import arcpy
feature_service = "<a feature service url>"
arcpy.management.CalculateField("data", "NEW_VALUE", "SAMPLE * (BASELINE - 40)", "SQL")

Umgebungen

Sonderfälle

Felddomänen-Beschreibungen übertragen

Ist diese Umgebungseinstellung aktiviert, werden alle Felder mit zugeordneter Domäne die Domänenbeschreibung statt des Feldwertes verwenden. Werte aus Feldern, die über keine Domäne verfügen, bleiben unverändert.

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen