Zusammenfassung
Kopiert Features aus der Eingabe-Feature-Class oder dem Layer in eine neue Feature-Class. Wenn es sich bei der Eingabe um einen Layer mit einer Auswahl handelt, werden nur die ausgewählten Features kopiert. Wenn die Eingabe eine Geodatabase-Feature-Class oder ein Shapefile ist, werden alle Features kopiert.
Verwendung
Sowohl die Geometrie als auch die Attribute der Eingabe-Features werden in die Ausgabe-Feature-Class kopiert.
Dieses Werkzeug kann für die Datenkonvertierung verwendet werden, da es viele Feature-Formate (darunter alle, die einer Karte hinzugefügt werden können) lesen und in ein Shapefile oder eine Geodatabase schreiben kann.
Syntax
CopyFeatures_management (in_features, out_feature_class, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})
Parameter | Erläuterung | Datentyp |
in_features | Die zu kopierenden Features. | Feature Layer; Raster Catalog Layer |
out_feature_class | Die zu erstellende Feature-Class, in die die Features kopiert werden. | Feature Class |
config_keyword (optional) | Geodatabase-Konfigurationsschlüsselwort, das angewendet wird, wenn die Ausgabe eine Geodatabase ist. | String |
spatial_grid_1 (optional) |
Die Parameter Räumliches Gitter 1, 2 und 3 der Ausgabe gelten nur für File-Geodatabases und bestimmte Feature-Class einer Enterprise-Geodatabase. Sollten Sie mit der Festlegung von Gittergrößen nicht vertraut sein, behalten Sie für diese Optionen "0,0,0" bei. ArcGIS berechnet dann die optimalen Größen für Sie. Weitere Informationen zu diesem Parameter finden Sie in der Dokumentation des Werkzeugs Räumlichen Index hinzufügen. | Double |
spatial_grid_2 (optional) |
Zellengröße des zweiten räumlichen Gitters. Lassen Sie die Größe 0 unverändert, wenn Sie nur ein Gitter verwenden möchten. Legen Sie die Größe andernfalls auf einen Wert fest, der dreimal größer als der für Räumliches Gitter 1 der Ausgabe ist. | Double |
spatial_grid_3 (optional) |
Zellengröße des dritten räumlichen Gitters. Lassen Sie die Größe 0 unverändert, wenn Sie nur zwei Gitter verwenden möchten. Legen Sie die Größe andernfalls auf einen Wert fest, der dreimal größer als der für Räumliches Gitter 2 der Ausgabe ist. | Double |
Codebeispiel
CopyFeatures – Beispiel (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie das Werkzeug CopyFeatures im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("climate.shp", "C:/output/output.gdb/climate")
CopyFeatures – Beispiel 2 (eigenständiges Skript)
Mit dem folgenden eigenständigen Skript wird veranschaulicht, wie Sie CopyFeatures zum Kopieren der Shapefiles in einem Ordner in eine File-Geodatabase verwenden.
# Name: CopyFeatures_Example2.py
# Description: Convert all shapefiles in a folder to geodatabase feature classes
# Import system modules
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
out_workspace = "c:/output/output.gdb"
# Use ListFeatureClasses to generate a list of shapefiles in the workspace
# shown above.
fc_list = arcpy.ListFeatureClasses()
# Execute CopyFeatures for each input shapefile
for shapefile in fc_list:
# Determine the new output feature class path and name
out_featureclass = os.path.join(out_workspace,
os.path.splitext(shapefile)[0])
arcpy.CopyFeatures_management(shapefile, out_featureclass)
Umgebungen
- Aktueller Workspace
- Scratch-Workspace
- Ausgabe-Koordinatensystem
- Geographische Transformationen
- Ausdehnung
- XY-Auflösung
- XY-Toleranz
- Ausgabe hat M-Werte
- M-Auflösung
- M-Toleranz
- Ausgabe hat Z-Werte
- Standard-Ausgabe-Z-Werte
- Z-Auflösung
- Z-Toleranz
- Qualifizierte Feldnamen
- Ausgabe-CONFIG-Schlüsselwort
- Anlagen beibehalten
- Auto-Commit
- Räumliches Gitter 1 der Ausgabe
- Räumliches Gitter 2 der Ausgabe
- Räumliches Gitter 3 der Ausgabe
- Ausgabe-XY-Domäne
- Ausgabe-M-Domäne
- Ausgabe-Z-Domäne
Lizenzinformationen
- ArcGIS Desktop Basic: Ja
- ArcGIS Desktop Standard: Ja
- ArcGIS Desktop Advanced: Ja