Aktualisieren (Analysis Tools)

Zusammenfassung

Hiermit werden der geometrische Schnittpunkt der Eingabe-Features und Update-Features berechnet. Die Attribute und die Geometrie der Eingabe-Features werden durch die Update-Features in der Ausgabe-Feature-Class aktualisiert.

Abbildung

Abbildung "Aktualisieren"

Verwendung

Sowohl der Parameterwert Eingabe-Features als auch der Parameterwert Update-Features müssen Polygone sein.
Die Feldnamen der Eingabe-Feature-Class und der Update-Feature-Class müssen übereinstimmen. Wenn in der Update-Feature-Class eines oder mehrere der Felder in der Eingabe-Feature-Class fehlen, wird der Feldwert der Eingabe-Feature-Class für die fehlenden Felder aus der Ausgabe-Feature-Class entfernt.
Die Eingabe-Feature-Class wird nicht geändert. Die Ergebnisse werden in einer neuen Feature-Class gespeichert.
Wenn der Parameter Grenzen deaktiviert ist, werden die Polygongrenzen am äußeren Rand der Update-Features gelöscht. Die Attribute der Update-Features, die Eingabe-Features überlagern, werden den Polygonen in der Ausgabe-Feature-Class zugeordnet, auch wenn die Außenkanten einiger Update-Polygone verworfen werden.
Die Attributwerte der Eingabe-Feature-Classes werden in die Ausgabe-Feature-Class kopiert. Wenn es sich bei der Eingabe jedoch um Layer handelt, die mit dem Werkzeug Feature-Layer erstellen erstellt wurden, und die Option Verhältnismethode verwenden eines Feldes aktiviert ist, wird ein Verhältnis zum Eingabe-Attributwert berechnet. Ist die Option Verhältnismethode verwenden aktiviert, stellen die Attribute des resultierenden Features bei jeder Teilung eines Features in einem Überlagerungsvorgang ein Verhältnis des Attributwertes des Eingabe-Features dar. Der Ausgabewert basiert auf dem Verhältnis, in dem die Eingabe-Feature-Geometrie geteilt wurde. Wenn die Geometrie beispielsweise in gleiche Teile geteilt wurde, wird dem Attributwert jedes neuen Features der halbe Wert des Attributwertes des Eingabe-Features zugewiesen. Verhältnismethode verwenden gilt nur für numerische Feldtypen.

Achtung:

Geoverarbeitungswerkzeuge berücksichtigen die Teilungsmethoden von Geodatabase-Feature-Class- oder -Tabellenfeldern nicht.
Dieses Werkzeug wendet einen Kachelungsvorgang an, um beim Verarbeiten großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter "Gekachelte Verarbeitung großer Datasets".
Dieses Werkzeug kann selbst dann Multipart-Features in der Ausgabe erstellen, wenn es sich bei allen Eingaben um Singlepart-Features handelt. Wenn Sie keine Multipart-Features erhalten möchten, verwenden Sie für die Ausgabe-Feature-Class das Werkzeug Multipart in Singlepart.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer. Der Geometrietyp muss "Polygon" lauten.	Feature Layer
Update-Features	Die Features, die zum Aktualisieren der Eingabe-Features verwendet werden. Der Geometrietyp muss "Polygon" lauten.	Feature Layer
Ausgabe-Feature-Class	Die Feature-Class, die die Ergebnisse enthält.	Feature Class
Grenzen (Optional)	Hiermit geben Sie an, ob die Grenze der Update-Polygon-Features beibehalten wird. Aktiviert—Die Außenkanten des Parameterwertes Update-Features werden im Parameterwert Ausgabe-Feature-Class beibehalten. Dies ist die Standardeinstellung. Deaktiviert—Die Außenkanten des Parameterwertes Update-Features werden nach dem Einfügen in den Parameterwert Eingabe-Features nicht beibehalten. Die Feldwerte des Parameterwertes Update-Features haben Priorität vor den Attributen des Parameterwerts Eingabe-Features.	Boolean
XY-Toleranz (Optional)	Die Mindestentfernung zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit

arcpy.analysis.Update(in_features, update_features, out_feature_class, {keep_borders}, {cluster_tolerance})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer. Der Geometrietyp muss "Polygon" lauten.	Feature Layer
update_features	Die Features, die zum Aktualisieren der Eingabe-Features verwendet werden. Der Geometrietyp muss "Polygon" lauten.	Feature Layer
out_feature_class	Die Feature-Class, die die Ergebnisse enthält.	Feature Class
keep_borders (Optional)	Hiermit geben Sie an, ob die Grenze der Update-Polygon-Features beibehalten wird. `BORDERS`—Die Außenkanten des Parameterwertes `update_features` werden im Parameterwert `out_feature_class` beibehalten. Dies ist die Standardeinstellung. `NO_BORDERS`—Die Außenkanten des Parameterwertes `update_features` werden nach dem Einfügen in `in_features` beibehalten. Die Feldwerte des Parameterwertes `update_features` haben Priorität vor den Attributen des Parameterwertes `in_features`.	Boolean
cluster_tolerance (Optional)	Die Mindestentfernung zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit

Codebeispiel

Update: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.analysis.Update("city_lots.shp", "data.gdb/flood_levels",
                      "data.gdb/low_lots", "NO_BORDERS")

Update: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript zeigt, wie Sie die Funktion Update bei der Skripterstellung verwenden.

# Name: UpdateZones.py
# Purpose: Update the "lots" feature class with features from "cutzones"

# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "c:/data/city.gdb"

# Set local parameters
inFeatures = "lots"
updateFeatures = "cutzones"
outFeatures = "futurecut"

# Process: Update
arcpy.analysis.Update(inFeatures, updateFeatures, outFeatures, "NO_BORDERS")

Umgebungen

Auto-Commit, Vollständig qualifizierte Feldnamen beibehalten, Standard-Ausgabe-Z-Werte, M-Auflösung, M-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Geographische Transformationen, Ausdehnung, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Faktor für parallele Verarbeitung, Geodatabase-Feldeigenschaften übertragen

Sonderfälle

Faktor für parallele Verarbeitung

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

Lizenzierungsinformationen

Basic: Nein
Standard: Nein
Advanced: Ja