Générer une couche d’événements XY (Outils de gestion des données)

Résumé

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 Copy Features (Copier des entités), Feature To Point (Entités vers points) ou Export Features (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.

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	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 (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})

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 (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 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: 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)

Environnements

Espace de travail courant

Informations de licence