Résumé
Crée une nouvelle 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 Copier des entités, Entité vers point ou Classe d’entités vers classe d’entités.
Il n’est pas possible de 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. Vous pouvez également modifier les attributs de coordonnées X et Y dans la table en entrée et recréer ensuite 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.
Pour en savoir plus sur l'utilisation de fichiers texte à données tabulaires
Si la table en entrée n’a pas de champ ObjectID, vous ne pourrez pas faire de sélections, ni ajouter de jointures à la couche résultante. De nombreux fichiers texte délimités ou tables provenant de connexions OLE DS n’ont pas de champs ObjectID.
Syntaxe
MakeXYEventLayer_management (table, in_x_field, in_y_field, out_layer, {spatial_reference}, {in_z_field})| Paramètre | Explication | Type 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 (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) | Référence spatiale des coordonnées dans les champs X et Y définis plus haut. 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 fenêtre Python ci-dessous illustre l'utilisation de l'outil MakeXYEventLayer.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.MakeXYEventLayer_management("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 l'outil 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"Coordinate Systems\Projected Coordinate Systems\Utm\Nad 1983\NAD 1983 UTM Zone 11N.prj"
# Make the XY event layer...
arcpy.MakeXYEventLayer_management(in_Table, x_coords, y_coords, out_Layer, spRef, z_coords)
# Save to a layer file
arcpy.SaveToLayerFile_management(out_Layer, saved_Layer)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui