Résumé
Copie des entités de la couche ou de la classe d'entités en entrée dans une nouvelle classe d'entités.
Utilisation
Si l'entrée est une couche qui comporte une sélection, seules les entités sélectionnées sont copiées vers la classe d’entités en sortie.
La géométrie et les attributs des entités en entrée sont tous deux copiés dans la classe d'entités en sortie.
Cet outil permet également de convertir des données, car il peut lire de nombreux formats d’entités (tous ceux que vous pouvez ajouter à une carte) et les écrire dans un fichier de formes ou une géodatabase.
Syntaxe
arcpy.management.CopyFeatures(in_features, out_feature_class, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})
Paramètre | Explication | Type de données |
in_features | Entités à copier. | Feature Layer; Raster Catalog Layer |
out_feature_class | Classe d'entités qui sera créée et dans laquelle les entités seront copiées. | Feature Class |
config_keyword (Facultatif) | Mot-clé de configuration de la géodatabase à utiliser si la sortie est une géodatabase. | String |
spatial_grid_1 (Facultatif) |
Les paramètres Grille spatiale 1, 2 et 3 en sortie s'appliquent uniquement aux géodatabases fichier et à certaines classes d'entités de géodatabase d'entreprise. Si vous êtes peu familier avec la définition de tailles de grille, laissez les valeurs 0,0,0 pour ces options et ArcGIS calculera des tailles optimales pour vous. Pour plus d'informations sur ce paramètre, reportez-vous à la documentation relative à l'outil Ajouter un index spatial. | Double |
spatial_grid_2 (Facultatif) |
Taille de cellule du deuxième index spatial. Laissez la taille à 0 si vous souhaitez seulement une grille. Sinon, définissez la taille sur une valeur au moins trois fois supérieure à Grille spatiale 1. | Double |
spatial_grid_3 (Facultatif) |
Taille de cellule du troisième index spatial. Laissez la taille à 0 si vous souhaitez seulement deux grilles. Sinon, définissez la taille sur une valeur au moins trois fois supérieure à Grille spatiale 2. | Double |
Exemple de code
Exemple 1 d'utilisation de l'outil Copier des entités (fenêtre Python)
Le script de fenêtre Python suivant montre comment utiliser l'outil CopyFeatures en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("climate.shp", "C:/output/output.gdb/climate")
Exemple 2 d'utilisation de l'outil Copier des entités (script autonome)
Le script autonome suivant illustre l’utilisation de l’outil CopyFeatures pour copier des shapefiles d’un dossier vers une géodatabase fichier.
# 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)
Environnements
- Espace de travail courant
- Espace de travail temporaire
- Système de coordonnées en sortie
- Transformations géographiques
- Étendue
- Résolution XY
- Tolérance XY
- Valeurs M en sortie
- Résolution M
- Tolérance M
- Valeurs Z en sortie
- Valeur Z en sortie par défaut
- Résolution Z
- Tolérance Z
- Noms de champ qualifiés
- Mot-clé CONFIG en sortie
- Conserver les pièces jointes
- Validation automatique
- Grille spatiale 1 en sortie
- Grille spatiale 2 en sortie
- Grille spatiale 3 en sortie
- Domaine XY en sortie
- Domaine M en sortie
- Domaine Z en sortie
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui