Copier des entités (Gestion des données)
Récapitulatif
Copie des entités de la couche ou de la classe d'entités en entrée dans une nouvelle classe d'entités. Si l'entrée est une couche qui comporte une sélection, seules les entités sélectionnées sont copiées. Si l'entrée est une classe d'entités de géodatabase ou un fichier de formes, toutes les entités sont copiées.
Utilisation
-
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 à ArcMap) et les écrire dans un fichier de formes ou une géodatabase (fichier, personnelle ou ArcSDE).
-
Si la classe d'entités en sortie existe déjà, elle est remplacée. Pour contrôler le remplacement dans une application, désactivez l'option Remplacer les résultats des opérations de géotraitement accessible en sélectionnant Géotraitement > Options de géotraitement...ou, dans un script, utilisez la propriété OverwriteOutput sur l'objet géoprocesseur. Pour ajouter des entités en entrée à une classe d'entités existante sans la remplacer, utilisez l'outil Ajouter.
Syntaxe
| 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. Si la classe d'entités en sortie existe déjà et que l'option de remplacement est définie sur True, la sortie est supprimée en premier. Si la classe d'entités en sortie existe déjà et que l'option de remplacement est définie sur False, l'opération échoue. | Feature Class |
config_keyword (Facultatif) |
Mot-clé de configuration de la géodatabase à utiliser lorsque la sortie est une géodatabase ArcSDE ou une géodatabase fichier. | String |
spatial_grid_1 (Facultatif) |
Les paramètres Grille spatiale 1, 2 et 3 s'appliquent uniquement aux géodatabases fichier et à certaines classes d'entités de géodatabase ArcSDE. 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
Le script de fenêtre Python suivant illustre l'utilisation de l'outil Copier des entités en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyFeatures_management("climate.shp", "C:/output/output.gdb/climate")
Le script autonome suivant illustre l'utilisation de l'outil Copier des entités pour copier des fichiers de formes d'un dossier dans une géodatabase fichier.
# Name: CopyFeatures_Example2.py
# Description: Convert all shapefiles in a folder to geodatabase feature classes
# Requirements: os module
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
import os
# Set environment settings
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)