Anhängen

Zusammenfassung

Hängt mehrere Eingabe-Datasets an ein bereits vorhandenes Ziel-Dataset an. Bei den Eingabe-Datasets kann es sich um Point-, Line- oder Polygon-Feature-Classes, Tabellen, Raster, Raster-Kataloge, Annotation-Feature-Classes oder Dimension-Feature-Classes handeln.

Verwenden Sie das Werkzeug Zusammenführen (Merge), um Eingabe-Datasets mit einem neuen Ausgabe-Dataset zu kombinieren.

Abbildung

Verwendung

• Mithilfe dieses Werkzeugs können Sie einem vorhandenen Dataset neue Features oder andere Daten aus verschiedenen Datasets hinzufügen. Mit diesem Werkzeug können Point-, Line- oder Polygon-Feature-Classes, Tabellen, Raster, Raster-Kataloge, Annotation-Feature-Classes oder Dimension-Feature-Classes an ein vorhandenes Dataset desselben Typs angehängt werden. Es können beispielsweise mehrere Tabellen an eine vorhandene Tabelle oder mehrere Raster an ein vorhandenes Raster-Dataset angefügt werden; es kann jedoch keine Line-Feature-Class an eine Point-Feature-Class angefügt werden.

• Das Steuerelement Feldzuordnung des Werkzeugs Anhängen kann verwendet werden, um zu steuern, wie die Attributinformationen aus den Eingabe-Dataset-Feldern in das Ziel-Dataset übertragen werden. Das Steuerelement "Feldzuordnung" kann nur verwendet werden, wenn als Schematyp "NO_TEST" angegeben ist.

• Mit diesem Werkzeug werden Features nicht geteilt, wenn sie dem Ziel-Dataset hinzugefügt werden. Alle Features der Eingabe-Feature-Class und der Ziel-Feature-Class bleiben nach dem Anfügen bestehen, selbst wenn sich Features überschneiden. Wenn Sie Feature-Geometrien zusammenführen oder teilen möchten, können Sie dies mit dem Werkzeug Vereinigen tun.

• Wenn als Schematyp "TEST" angegeben ist, muss das Schema (die Felddefinitionen) der Eingabe-Datasets dem des Ziel-Datasets entsprechen, damit die Features angehängt werden können. Wenn als Schematyp "NO_TEST" ausgewählt ist, muss das Schema (bzw. die Felddefinitionen) des Eingabe-Datasets nicht mit dem Schema der Ziel-Datasets übereinstimmen. Felder der Eingabe-Datasets, die nicht mit den Feldern des Ziel-Datasets übereinstimmen, werden jedoch dem Ziel-Dataset nicht zugeordnet, es sei denn, die Zuordnung wird im Steuerelement "Feldzuordnung" explizit festgelegt.

• Da die Daten der Eingabe-Datasets in ein vorhandenes Ziel-Dataset geschrieben werden, das ein vordefiniertes Schema (Felddefinitionen) hat, werden vom Steuerelement "Feldzuordnung" keine Felder zugelassen, die dem Ziel-Dataset hinzugefügt oder daraus entfernt werden sollen.

• Wenn die Raumbezüge einer Eingabe- und Ziel-Feature-Class nicht zusammenpassen, projiziert das Werkzeug "Anhängen" die Features in der Eingabe-Feature-Class in das von der Ziel-Feature-Class verwendete Koordinatensystem.

• Mit diesem Werkzeug wird kein Kantenabgleich durchgeführt; eine Anpassung an die Geometrie von Features findet demnach nicht statt.

• Karten-Layer können als Eingabe-Datasets verwendet werden. Wenn für einen Layer eine Auswahl getroffen wurde, werden nur die selektierten Datensätze (Features oder Tabellenzeilen) im Werkzeug "Anhängen" verwendet.

• Mehrere Eingabe-Layer mit demselben Namen können für dieses Werkzeug nicht verwendet werden. Obwohl Layer mit demselben Namen in ArcMap angezeigt werden können, dürfen diese Layer nicht verwendet werden. Sie können diese Einschränkung umgehen, indem Sie über die Schaltfläche "Durchsuchen" im Dialogfeld des Werkzeugs nach dem vollständigen Pfad der einzelnen Eingabe-Datasets suchen.

• Wenn Sie den Parameter Subtype verwenden möchten, muss das Ziel-Dataset ein definiertes Subtype-Feld und zugewiesene Subtype-Codes aufweisen. Geben Sie im Parameter Subtype eine Subtype-Beschreibung ein, um allen neuen Daten, die an das Ziel-Dataset angefügt werden, diesen Subtype zuzuweisen.

Syntax

Append_management (inputs, target, {schema_type}, {field_mapping}, {subtype})

Parameter	Erläuterung	Datentyp
inputs [inputs,...]	Die Eingabe-Datasets, deren Daten an das Ziel-Dataset angehängt werden. Bei den Eingabe-Datasets kann es sich um Point-, Line- oder Polygon-Feature-Classes, Tabellen, Raster, Raster-Kataloge, Annotation-Feature-Classes oder Dimension-Feature-Classes handeln. Jedes Eingabe-Dataset muss mit dem Datentyp des Ziel-Datasets übereinstimmen.	Table View; Raster Layer
target	Das vorhandene Dataset, an das die Daten des Eingabe-Datasets angehängt werden. Jedes Eingabe-Dataset muss mit dem Datentyp des Ziel-Datasets übereinstimmen.	Table View; Raster Layer
schema_type (optional)	Gibt an, ob das Schema (Felddefinitionen) der Eingabe-Datasets dem des Ziel-Datasets entsprechen muss, damit die Daten angehängt werden können. TEST —Das Eingabe-Dataset-Schema (Felddefinitionen) muss mit dem Schema des Ziel-Datasets übereinstimmen. Wenn die Schemas nicht übereinstimmen, wird ein Fehler zurückgegeben. NO_TEST —Das Eingabe-Dataset-Schema (Felddefinitionen) muss nicht mit dem Schema des Ziel-Datasets übereinstimmen. Felder der Eingabe-Datasets, die nicht mit den Feldern des Ziel-Datasets übereinstimmen, werden dem Ziel-Dataset nicht zugeordnet, es sei denn, die Zuordnung wird im Steuerelement "Feldzuordnung" explizit festgelegt.	String
field_mapping (optional)	Legt fest, wie die Attributinformationen in den Feldern von Eingabe-Datasets an das Ziel-Dataset übertragen werden. Dieser Parameter kann nur verwendet werden, wenn als Schematyp "NO_TEST" angegeben ist. Da die Daten der Eingabe-Datasets an ein vorhandenes Ziel-Dataset angehängt werden, das ein vordefiniertes Schema (Felddefinitionen) hat, können dem Ziel-Dataset keine Felder hinzugefügt oder daraus entfernt werden. Mit Vereinigungsregeln geben Sie an, wie Werte aus zwei oder mehr Eingabefeldern zu einem einzigen Ausgabewert zusammengeführt bzw. kombiniert werden. Es gibt mehrere Vereinigungsregeln, anhand derer festgelegt wird, wie das Ausgabefeld mit Werten gefüllt wird. Erste(r) – Der erste Wert des Eingabefeldes wird verwendet. Letzte(r) – Der letzte Wert des Eingabefeldes wird verwendet. Verbinden – Führt die Werte der Eingabefelder zusammen (verbindet sie). Summe – Berechnet den Gesamtbetrag der Werte der Eingabefelder. Mittelwert – Berechnet den Mittelwert (Durchschnitt) der Werte der Eingabefelder. Mittelwert – Berechnet den Medianwert (Mittelwert) der Werte der Eingabefelder. Modus – Verwendet den Wert mit der größten Häufigkeit. Min – Verwendet den Minimalwert der Werte aller Eingabefelder. Max – Verwendet den Maximalwert der Werte aller Eingabefelder. Standardabweichung – Wendet die Klassifizierungsmethode "Standardabweichung" auf die Werte aller Eingabefelder an. Anzahl – Gibt die Anzahl der Datensätze zurück, die in der Berechnung enthalten sind.	Field Mapping
subtype (optional)	Eine Subtype-Beschreibung, um allen neuen Daten, die an das Ziel-Dataset angefügt werden, diesen Subtype zuzuweisen.	String

Codebeispiel

Append – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie das Werkzeug "Anhängen" im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"], "wholecity.shp", "TEST","","")

Append – Beispiel 2 (eigenständiges Python-Skript)

Das folgende Skript veranschaulicht, wie das Werkzeug "Append" verwendet wird.

# Name: Append.py
# Description: Use the Append tool to combine several shapefiles

# import system modules 
import arcpy
import os

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
outLocation = "C:/Output"
emptyFC = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""

try:
    # Process:  Create a new empty feature class to append shapefiles into
    arcpy.CreateFeatureclass_management(outLocation, emptyFC, "POLYGON", "amherst.shp")

    # All polygon FCs in the workspace are MA town shapefiles, we want to append these to the empty FC
    fcList = arcpy.ListFeatureClasses("","POLYGON")
    # list will resemble ["amherst.shp", "hadley.shp", "pelham.shp", "coldspring.shp"] 

    # Process: Append the feature classes into the empty feature class
    arcpy.Append_management(fcList, outLocation + os.sep + emptyFC, schemaType, fieldMappings, subtype)

except Exception as err:
    print(err.args[0])

Umgebungen

• Ausdehnung
• Aktueller Workspace

Lizenzinformationen

• ArcGIS Desktop Basic: Ja
• ArcGIS Desktop Standard: Ja
• ArcGIS Desktop Advanced: Ja