Créer une couche d’événements XY (Gestion des données)

Synthèse

Crée une couche d’événements ponctuels à partir d’une table contenant des champs avec des valeurs de coordonnées x et y, et éventuellement des valeurs de coordonnées z (élévation).

Utilisation

  • La couche d’événements en sortie créée par cet outil est temporaire et n’est pas stockée sur disque ou dans une géodatabase. Vous pouvez exporter une couche d’événements vers une classe d’entités pour la stocker de manière permanente à l’aide de l’outil Copier des entités, Entités vers points ou Exporter des entités.

  • Si vous utilisez des données tabulaires qui se mettent souvent à jour, vous pouvez créer une couche d’évènements qui se met automatiquement à jour lorsque la table source est mise à jour. Cela peut s’avérer plus efficace que la conversion répétée de la table vers une nouvelle classe d’entités ponctuelles.

  • Les entités des couches d’événements ne sont pas modifiables. Vous pouvez copier ou exporter la couche d’événements vers une classe d’entités si vous devez la modifier.

  • Le séparateur standard pour les fichiers texte à données tabulaires dotés de l’extension .csv ou .txt est une virgule, et pour les fichiers dotés d’une extension .tab, une tabulation. Pour utiliser une table en entrée avec un séparateur non standard, vous devez spécifier d’abord le séparateur correct utilisé dans la table à l’aide d’un fichier schema.ini.

  • Si le format de fichier de la table en entrée ne possède pas de champ d’ID d’objet ou s’il s’agit d’une table de base de données sans clé principale, vous ne pouvez pas effectuer de sélections, appliquer des ensembles de définition ou d’autres filtres, ou ajouter des jointures ou des relations à la couche d’événements.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

Table contenant les coordonnées x et y qui définissent les emplacements des entités ponctuelles à créer.

Table View
Champ X

Champ de la table en entrée contenant les coordonnées x (longitude).

Field
Champ Y

Champ de la table en entrée contenant les coordonnées y (latitude).

Field
Nom de la couche en sortie

Nom de la couche d’événements en sortie.

Feature Layer
Système de coordonnées
(Facultatif)

Système des coordonnées spécifiées dans les paramètres X Field (Champ X) et Y Field (Champ Y). Il s’agit du système de coordonnées de la couche d’événements en sortie.

Spatial Reference
Champ Z
(Facultatif)

Champ de la table en entrée contenant les coordonnées Z.

Field

arcpy.management.MakeXYEventLayer(table, in_x_field, in_y_field, out_layer, {spatial_reference}, {in_z_field})
NomExplicationType de données
table

Table contenant les coordonnées x et y qui définissent les emplacements des entités ponctuelles à créer.

Table View
in_x_field

Champ de la table en entrée contenant les coordonnées x (longitude).

Field
in_y_field

Champ de la table en entrée contenant les coordonnées y (latitude).

Field
out_layer

Nom de la couche d’événements en sortie.

Feature Layer
spatial_reference
(Facultatif)

Système des coordonnées spécifiées dans les paramètres in_x_field et in_y_field. Il s’agit du système de coordonnées de la couche d’événements en sortie.

Spatial Reference
in_z_field
(Facultatif)

Champ de la table en entrée contenant les coordonnées Z.

Field

Exemple de code

Exemple d’utilisation de la fonction MakeXYEventLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction MakeXYEventLayer.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.MakeXYEventLayer("firestations.dbf", "POINT_X", "POINT_Y", 
                                  "firestations_points", "", "POINT_Z")
Exemple d’utilisation de l’outil MakeXYEventLayer (script autonome)

Le script autonome Python ci-dessous illustre l’utilisation de la fonction MakeXYEventLayer.

# Description: Create an XY layer and export it to a layer file.

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"
 
# Set the local variables
in_table = "firestations.dbf"
x_coords = "POINT_X"
y_coords = "POINT_Y"
z_coords = "POINT_Z"
out_layer = "firestations_layer"
saved_layer = r"c:\output\firestations.lyr"

# Set the spatial reference
spatial_ref = r"NAD_1983_UTM_Zone_11N"

# Make the XY event layer...
arcpy.management.MakeXYEventLayer(in_table, x_coords, y_coords, out_layer, 
                                  spatial_ref, z_coords)

# Save to a layer file
arcpy.management.SaveToLayerFile(out_layer, saved_layer)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes