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 selektierten 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 (alle, die ArcMap hinzugefügt werden können) lesen und in ein Shapefile oder eine Geodatabase (File, Personal oder ArcSDE) 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. Wenn die Ausgabe-Feature-Class bereits vorhanden ist und die Option "Überschreiben" aktiviert ist, wird die Ausgabe zunächst gelöscht. Wenn die Ausgabe-Feature-Class bereits vorhanden ist und die Option "Überschreiben" deaktiviert ist, wird der Vorgang mit einem Fehler abgebrochen. | Feature Class |
config_keyword (optional) | Geodatabase-Konfigurationsschlüsselwort, das angewendet wird, wenn die Ausgabe eine ArcSDE-Geodatabase oder File-Geodatabase ist. | String |
spatial_grid_1 (optional) | Die Parameter Räumliches Gitter 1, 2 und 3 gelten nur für File-Geodatabases und bestimmte Feature-Classes von Workgroup- und Enterprise-Geodatabases. 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" 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. Verdreifachen Sie andernfalls die Größe um das Dreifache des "Räumliches Gitters 2". | Double |
Codebeispiel
CopyFeatures – Beispiel (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug "CopyFeatures" im unmittelbaren Modus verwenden.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("climate.shp", "C:/output/output.gdb/climate")
CopyFeatures – Beispiel 2 (eigenständiges Skript)
Das folgende eigenständige Skript 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
outWorkspace = "c:/output/output.gdb"
# Use ListFeatureClasses to generate a list of shapefiles in the
# workspace shown above.
fcList = arcpy.ListFeatureClasses()
# Execute CopyFeatures for each input shapefile
for shapefile in fcList:
# Determine the new output feature class path and name
outFeatureClass = os.path.join(outWorkspace, shapefile.strip(".shp"))
arcpy.CopyFeatures_management(shapefile, outFeatureClass)
Umgebung
- 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-Wert
- Z-Auflösung
- Z-Toleranz
- Qualifizierte Feldnamen
- Ausgabe-CONFIG-Schlüsselwort
- 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
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Ja
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja