Générer une couche d'événements XY (Gestion des données)

Synthèse

Crée une couche d’entités ponctuelles à partir des coordonnées x et y définies dans une table. Si la table source contient des coordonnées Z (valeurs d’altitude), ce champ peut également être spécifié dans la création de la couche d’événement. La couche créée par cet outil est temporaire.

Utilisation

• La couche d’entités ponctuelles en sortie créée par cet outil est temporaire et ne sera pas conservée à l’issue de la session. Vous pouvez exporter cette couche d’événements vers une classe d’entités sur le disque à l’aide des outils Copy Features (Copier des entités), Feature To Point (Entité vers point) ou Export Features (Exporter des entités).

• Vous ne pouvez pas déplacer de façon interactive les points de la couche en sortie à l’aide des commandes de modification, car les couches d’événements ne sont pas modifiables. Une alternative consiste à modifier les attributs de coordonnées X et Y dans la table en entrée et à recréer la couche d'événements ou l’enregistrer dans une classe d’entités sur le disque, puis à apporter les modifications dans la classe d’entités.

• 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 la table en entrée n’a pas de champ ObjectID, vous ne pouvez pas faire de sélections, ni ajouter de jointures à la couche résultante.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table XY	Table contenant les coordonnées X et Y qui définissent les emplacements des entités ponctuelles qui seront créées.	Table View
Champ X	Champ de la table en entrée contenant les coordonnées X (ou longitude).	Field
Champ Y	Champ de la table en entrée contenant les coordonnées Y (ou latitude).	Field
Nom de la couche	Nom de la couche d'événements ponctuels en sortie.	Feature Layer
Référence spatiale (Facultatif)	La référence spatiale des coordonnées spécifiées dans les paramètres X Field (Champ X) et Y Field (Champ Y). Ce sera la référence spatiale 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

Python

arcpy.management.MakeXYEventLayer(table, in_x_field, in_y_field, out_layer, {spatial_reference}, {in_z_field})

Nom	Explication	Type de données
table	Table contenant les coordonnées X et Y qui définissent les emplacements des entités ponctuelles qui seront créées.	Table View
in_x_field	Champ de la table en entrée contenant les coordonnées X (ou longitude).	Field
in_y_field	Champ de la table en entrée contenant les coordonnées Y (ou latitude).	Field
out_layer	Nom de la couche d'événements ponctuels en sortie.	Feature Layer
spatial_reference (Facultatif)	La référence spatiale des coordonnées spécifiées dans les paramètres in_x_field et in_y_field. Ce sera la référence spatiale 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 l'outil MakeXYEventLayer (fenêtre Python)

Le script de la fenêtre Python ci-après 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 Python autonome ci-dessous illustre l’utilisation de la fonction MakeXYEventLayer.

# Description: Creates an XY layer and exports 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
spRef = r"NAD_1983_UTM_Zone_11N"

# Make the XY event layer...
arcpy.management.MakeXYEventLayer(in_Table, x_coords, y_coords, out_Layer, 
                                  spRef, z_coords)

# Save to a layer file
arcpy.management.SaveToLayerFile(out_Layer, saved_Layer)

Environnements

Espace de travail courant