Table XY vers point (Gestion des données)—ArcGIS Pro

Synthèse

Crée une classe d’entités ponctuelles à partir des coordonnées x, y et z d’une table.

Utilisation

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.
Les champs attributaires du paramètre Input Table (Table en entrée) sont transférés au paramètre Output Feature Class (Classe d’entités en sortie).
Le système de coordonnées spécifié dans le paramètre Coordinate System (Système de coordonnées) sera appliqué à la sortie. Ce système de coordonnées détermine comment les coordonnées x, y et z de la table en entrée sont interprétées. Cet outil étant couramment utilisé avec les tables qui contiennent des valeurs de longitude et de latitude, le système de coordonnées par défaut est le système de coordonnées géographiques WGS 1984. Si les coordonnées x et y de la table en entrée contiennent des coordonnées projetées, spécifiez le système de coordonnées projetées approprié.
Si l’environnement Output Coordinate System (Système de coordonnées en sortie) a été défini, la classe d’entités en sortie sera reprojetée dans ce système de coordonnées à partir du système de coordonnées spécifié dans le paramètre Coordinate System (Système de coordonnées).
Lorsqu’un paramètre Champ Z est spécifié, le système de coordonnées par défaut comprend également le système de coordonnées verticales WGS 1984. Si les valeurs z ne sont pas exprimées en mètres, modifiez le système de coordonnées de façon à utiliser l’unité d’altitude appropriée.
Des valeurs 0 ou Null pour les champs des paramètres Champ X et Champ Y sont considérées comme valides et seront incluses dans la sortie. Des coordonnées de 0 représenteront l’emplacement des entités ponctuelles en sortie, tandis que des coordonnées de valeur NULL (nulles) auront une géométrie vide.
Dans un système de coordonnées géographiques, les valeurs des champs des paramètres Champ X et Champ Y sont considérées comme non valides si elles sont inférieures à -400 et supérieures à 400. Aucun enregistrement ne sera créé en sortie et un message d'avertissement sera inclus dans les messages de l'outil pour indiquer l'ID d'enregistrement non valide.

Paramètres

Étiquette	Explication	Type 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
Classe d’entités en sortie	Classe d’entités contenant les entités ponctuelles en sortie.	Feature Class
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
Champ Z (Facultatif)	Champ de la table en entrée contenant les coordonnées Z.	Field
Système de coordonnées (Facultatif)	Système de coordonnées des coordonnées x et y. Ce système de coordonnées sera également celui de la classe d’entités en sortie.	Spatial Reference

arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})

Nom	Explication	Type de données
in_table	Table contenant les coordonnées x et y qui définissent les emplacements des entités ponctuelles à créer.	Table View
out_feature_class	Classe d’entités contenant les entités ponctuelles en sortie.	Feature Class
x_field	Champ de la table en entrée contenant les coordonnées X (ou longitude).	Field
y_field	Champ de la table en entrée contenant les coordonnées Y (ou latitude).	Field
z_field (Facultatif)	Champ de la table en entrée contenant les coordonnées Z.	Field
coordinate_system (Facultatif)	Système de coordonnées des coordonnées x et y. Ce système de coordonnées sera également celui de la classe d’entités en sortie.	Spatial Reference

Exemple de code

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

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

import arcpy
arcpy.env.workspace = r"c:\output.gdb"
arcpy.management.XYTableToPoint(r"c:\data\tree.csv", "tree_points",
                                "longitude", "latitude", "elevation",
                                arcpy.SpatialReference(4759, 115700))

Exemple 2 d’utilisation de l’outil XYTableToPoint (script autonome)

Le script Python autonome ci-dessous illustre l'utilisation de la fonction XYTableToPoint.

# XYTableToPoint.py
# Description: Creates a point feature class from input table

# import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = r"c:\output.gdb"

# Set the local variables
in_table = r"c:\data\tree.csv"
out_feature_class = "tree_points"
x_coords = "longitude"
y_coords = "latitude"
z_coords = "elevation"

# Make the XY event layer...
arcpy.management.XYTableToPoint(in_table, out_feature_class,
                                x_coords, y_coords, z_coords,
                                arcpy.SpatialReference(4759, 115700))

# Print the total rows
print(arcpy.GetCount_management(out_feature_class))

Environnements

Espace de travail courant, Système de coordonnées en sortie, Étendue

Cas particuliers

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?