Créer une classe d’entités (Gestion des données)

Synthèse

Crée une classe d’entités vide dans une base de données ou un shapefile dans un dossier.

Utilisation

  • La valeur du paramètre Feature Class Location (Emplacement de la classe d’entités) (géodatabase ou dossier) doit déjà exister.

  • Cet outil ne crée que des classes d’entités simples (classes d’entités ponctuelles, multi-points, surfaciques et polylignes).

  • Lorsque vous utilisez cet outil pour créer un shapefile, celui-ci possède un champ de type entier nommé ID. Le champ ID n’est pas créé lorsque vous fournissez une valeur de paramètre Jeu de données modèle.

Paramètres

ÉtiquetteExplicationType de données
Emplacement de la classe d’entités

Géodatabase d’entreprise ou fichier, ou dossier, dans lequel la classe d’entités en sortie sera créée. Cet espace de travail doit déjà exister.

Workspace; Feature Dataset
Nom de la classe d’entités

Nom de la classe d'entités à créer.

String
Type de géométrie
(Facultatif)

Spécifie le type de géométrie de la classe d’entités en sortie.

  • PointLe type de géométrie est Point.
  • Multi-pointLe type de géométrie est Multi-point.
  • PolygoneLe type de géométrie est Polygone.
  • PolyligneLe type de géométrie est Polyligne.
  • MultipatchLa géométrie est de type multipatch.
String
Jeux de données modèles
(Facultatif)

Jeu de données existant ou liste de jeux de données utilisé comme modèle pour définir les champs attributaires de la nouvelle classe d’entités.

Table View
Contient des valeurs M
(Facultatif)

Détermine si la classe d’entités contient des valeurs de mesure linéaire (valeurs m).

  • NonLa classe d’entités en sortie ne contiendra pas de valeurs M. Il s’agit de l’option par défaut.
  • OuiLa classe d’entités en sortie contiendra des valeurs M.
  • Identique à la classe d’entités modèleLa classe d’entités en sortie contiendra des valeurs M si le jeu de données spécifié dans le paramètre Classe d’entités modèle (paramètre template dans Python) en comporte.
String
Comporte des valeurs Z
(Facultatif)

Détermine si la classe d’entités contient des valeurs d’altitude (valeurs z).

  • NonLa classe d’entités en sortie ne contiendra pas de valeurs Z. Il s’agit de l’option par défaut.
  • OuiLa classe d’entités en sortie contiendra des valeurs Z.
  • Identique à la classe d’entités modèleLa classe d’entités en sortie contiendra des valeurs Z si le jeu de données spécifié dans le paramètre Classe d’entités modèle (paramètre template dans Python) en comporte.
String
Système de coordonnées
(Facultatif)

Référence spatiale du jeu de classes d’entités en sortie. Dans la boîte de dialogue Propriétés de la référence spatiale, vous pouvez sélectionner, importer ou créer un système de coordonnées. Pour définir les caractéristiques de la référence spatiale, tels que les domaines x, y, z ou m, la résolution ou la tolérance, utilisez la boîte de dialogue Environnements.

Si aucune référence spatiale n'est attribuée, la classe d'entités a une référence spatiale inconnue.

Remarque :

La référence spatiale de la valeur Classe d’entités modèle n’a aucun impact sur la référence spatiale en sortie. Si vous souhaitez que la sortie se trouve dans le système de coordonnées de la valeur Classe d’entités modèle, définissez le paramètre Système de coordonnées sur la référence spatiale de la valeur Classe d’entités modèle.

Spatial Reference
Mot-clé de configuration
(Facultatif)

Le mot-clé de configuration ne s’applique qu’aux données des géodatabases d’entreprise. Il détermine les paramètres de stockage de la table de base de données.

String
Grille 1 en sortie
(Facultatif)

Ce paramètre n’est pas pris en charge. Toutes les valeurs fournies sont ignorées.

Double
Grille 2 en sortie
(Facultatif)

Ce paramètre n’est pas pris en charge. Toutes les valeurs fournies sont ignorées.

Double
Grille 3 en sortie
(Facultatif)

Ce paramètre n’est pas pris en charge. Toutes les valeurs fournies sont ignorées.

Double
Alias de la classe d’entités
(Facultatif)

Nom secondaire de la classe d’entités en sortie qui sera créée.

String
Type d’OID
(Facultatif)

Indique si le champ ID d’objet en sortie est sur 32 ou 64 bits.

  • Identique au modèleLe type du champ ID d’objet en sortie (32 bits ou 64 bits) est identique à celui du champ ID d’objet du premier jeu de données modèle. Il s’agit de l’option par défaut.
  • 64 bitsLe champ ID d’objet en sortie est sur 64 bits.
  • 32 bitsLe champ ID d’objet en sortie est sur 32 bits.
String

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités en sortie

Nouvelle classe d’entités.

Feature Class

arcpy.management.CreateFeatureclass(out_path, out_name, {geometry_type}, {template}, {has_m}, {has_z}, {spatial_reference}, {config_keyword}, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3}, {out_alias}, {oid_type})
NomExplicationType de données
out_path

Géodatabase d’entreprise ou fichier, ou dossier, dans lequel la classe d’entités en sortie sera créée. Cet espace de travail doit déjà exister.

Workspace; Feature Dataset
out_name

Nom de la classe d'entités à créer.

String
geometry_type
(Facultatif)

Spécifie le type de géométrie de la classe d’entités en sortie.

  • POINTLe type de géométrie est Point.
  • MULTIPOINTLe type de géométrie est Multi-point.
  • POLYGONLe type de géométrie est Polygone.
  • POLYLINELe type de géométrie est Polyligne.
  • MULTIPATCHLa géométrie est de type multipatch.
String
template
[template,...]
(Facultatif)

Jeu de données existant ou liste de jeux de données utilisé comme modèle pour définir les champs attributaires de la nouvelle classe d’entités.

Table View
has_m
(Facultatif)

Détermine si la classe d’entités contient des valeurs de mesure linéaire (valeurs m).

  • DISABLEDLa classe d’entités en sortie ne contiendra pas de valeurs M. Il s’agit de l’option par défaut.
  • ENABLEDLa classe d’entités en sortie contiendra des valeurs M.
  • SAME_AS_TEMPLATELa classe d’entités en sortie contiendra des valeurs M si le jeu de données spécifié dans le paramètre Classe d’entités modèle (paramètre template dans Python) en comporte.
String
has_z
(Facultatif)

Détermine si la classe d’entités contient des valeurs d’altitude (valeurs z).

  • DISABLEDLa classe d’entités en sortie ne contiendra pas de valeurs Z. Il s’agit de l’option par défaut.
  • ENABLEDLa classe d’entités en sortie contiendra des valeurs Z.
  • SAME_AS_TEMPLATELa classe d’entités en sortie contiendra des valeurs Z si le jeu de données spécifié dans le paramètre Classe d’entités modèle (paramètre template dans Python) en comporte.
String
spatial_reference
(Facultatif)

Référence spatiale du jeu de classes d’entités en sortie. Vous pouvez spécifier la référence spatiale de plusieurs façons :

  • En fournissant le chemin d’accès à un fichier .prj (C:/workspace/watershed.prj, par exemple).
  • En référençant une classe d’entités ou un jeu de classes d’entités dont vous souhaitez appliquer la référence spatiale (C:/workspace/myproject.gdb/landuse/grassland, par exemple).
  • En définissant avant d’utiliser cet outil un objet de référence spatiale (sr = arcpy.SpatialReference("Sinusoidal (Africa)"), par exemple), que vous pouvez ensuite utiliser en tant que paramètre de référence spatiale.

Si aucune référence spatiale n'est attribuée, la classe d'entités a une référence spatiale inconnue.

Remarque :

La référence spatiale de la valeur Classe d’entités modèle n’a aucun impact sur la référence spatiale en sortie. Si vous souhaitez que la sortie se trouve dans le système de coordonnées de la valeur Classe d’entités modèle, définissez le paramètre Système de coordonnées sur la référence spatiale de la valeur Classe d’entités modèle.

Spatial Reference
config_keyword
(Facultatif)

Le mot-clé de configuration ne s’applique qu’aux données des géodatabases d’entreprise. Il détermine les paramètres de stockage de la table de base de données.

String
spatial_grid_1
(Facultatif)

Ce paramètre n’est pas pris en charge. Toutes les valeurs fournies sont ignorées.

Double
spatial_grid_2
(Facultatif)

Ce paramètre n’est pas pris en charge. Toutes les valeurs fournies sont ignorées.

Double
spatial_grid_3
(Facultatif)

Ce paramètre n’est pas pris en charge. Toutes les valeurs fournies sont ignorées.

Double
out_alias
(Facultatif)

Nom secondaire de la classe d’entités en sortie qui sera créée.

String
oid_type
(Facultatif)

Indique si le champ ID d’objet en sortie est sur 32 ou 64 bits.

  • SAME_AS_TEMPLATELe type du champ ID d’objet en sortie (32 bits ou 64 bits) est identique à celui du champ ID d’objet du premier jeu de données modèle. Il s’agit de l’option par défaut.
  • 64_BITLe champ ID d’objet en sortie est sur 64 bits.
  • 32_BITLe champ ID d’objet en sortie est sur 32 bits.
String

Sortie obtenue

NomExplicationType de données
out_feature_class

Nouvelle classe d’entités.

Feature Class

Exemple de code

Exemple d’utilisation de l’outil CreateFeatureclass (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction CreateFeatureclass en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CreateFeatureclass("C:/output", "habitatareas.shp", "POLYGON", 
                                    "study_quads.shp", "DISABLED", "DISABLED", 
                                    "C:/workspace/landuse.shp")
Exemple 2 d'utilisation de l'outil CreateFeatureclass (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction CreateFeatureclass dans un script autonome.

# Description: Create a feature class to store the gnatcatcher habitat zones

# Import system modules
import arcpy

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

# Set local variables
out_path = "C:/output"
out_name = "habitatareas.shp"
geometry_type = "POLYGON"
template = "study_quads.shp"
has_m = "DISABLED"
has_z = "DISABLED"

# Use Describe to get a SpatialReference object
spatial_ref = arcpy.Describe("C:/workspace/studyarea.shp").spatialReference

# Run CreateFeatureclass
arcpy.management.CreateFeatureclass(out_path, out_name, geometry_type, template, 
                                    has_m, has_z, spatial_ref)

Rubriques connexes