É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 qui seront créées. | 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 |
Synthèse
Crée une classe d’entités ponctuelles à partir des coordonnées x, y et z d’une table.
Utilisation
Les champs attributaires de la valeur du paramètre de table en entrée sont transférés dans la 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 WGS84. 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).
Lorsque la valeur du paramètre Champ Z est spécifiée, le système de coordonnées par défaut comprend également le système de coordonnées verticales WGS84. 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.
Les valeurs 0 ou Null pour les coordonnées x et y sont considérées comme valides et sont incluses dans la sortie. Les coordonnées de valeur 0 représentent l’emplacement des entités ponctuelles en sortie, tandis que les coordonnées de valeur Null ont une géométrie vide.
Dans un système de coordonnées géographiques, les valeurs des coordonnées x et y sont considérées comme non valides si elles sont inférieures à -400 ou supérieures à 400. Aucun enregistrement n’est créé en sortie et un message d’avertissement est inclus dans les messages de l’outil pour indiquer l’ID en entrée non valide.
Les champs de coordonnées x, y et z doivent être des champs numériques. Seules des valeurs de coordonnées aux formats suivants doivent être utilisées en entrée dans cet outil :
- Degrés décimaux dans un système de coordonnées géographiques
- Mesures linéaires dans un système de coordonnées projetées utilisant des nombres pour indiquer la position avec un décalage x et y par rapport à un emplacement d’origine
Il est possible d’utiliser d’autres formats ou notations de coordonnées en entrée dans l’outil Convertir la notation des coordonnées.
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.
Paramètres
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 qui seront créées. | 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
Le script suivant 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))
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.management.GetCount(out_feature_class))
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?