Résumé
Permet de créer une classe d'entités contenant des entités linéaires géodésiques construites à partir des valeurs d'un champ de coordonnées x, d'un champ de coordonnées y, d'un champ de relèvement et d'un champ de distance d'une table.
Illustration
Utilisation
Si vous utilisez des fichiers texte et des fichiers .csv en entrée, veillez à ce qu’ils suivent respectent la structure de fichier spécifiée dans la rubrique Sources de données tabulaires.
Chaque ligne géodésique est construite à l'aide d'un jeu de valeurs de champs particulier représentant les coordonnées x et y d'un point de départ, la distance à partir du point de départ et l'angle de relèvement mesuré à partir du Nord. Ces champs et valeurs sont inclus dans la sortie.
Une ligne géodésique est une courbe à la surface de la Terre. Une entité linéaire géodésique n’est cependant pas stockée en tant que courbe paramétrique (vraie) en sortie ; au lieu de cela, elle est stockée en tant que polyligne densifiée représentant la trajectoire de la ligne géodésique. Si la longueur d’une ligne géodésique est relativement courte, elle peut être représentée par une ligne droite dans la sortie. Au fur et à mesure que la ligne s'allonge, des sommets supplémentaires permettent de représenter la trajectoire.
Lorsque la sortie est une classe d’entités dans une géodatabase fichier ou personnelle, les valeurs du champ Shape_Length sont toujours exprimées dans les unités du système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale) et elles représentent les longueurs planaires des polylignes. Pour mesurer une distance ou une longueur géodésique, utilisez l’outil ArcMap Measure (Mesurer) et choisissez l’option Geodesic (Géodésique), Loxodrome (Loxodromie), ou Great Elliptic (Grande elliptique), selon le cas, avant d’effectuer une mesure.
Syntaxe
arcpy.management.BearingDistanceToLine(in_table, out_featureclass, x_field, y_field, distance_field, {distance_units}, bearing_field, {bearing_units}, {line_type}, {id_field}, {spatial_reference})
Paramètre | Explication | Type de données |
in_table | Table en entrée. Il peut s’agir d’un fichier texte, CSV, Excel, d’une table dBASE ou d’une table de géodatabase. | Table View |
out_featureclass | Classe d'entités en sortie contenant les lignes géodésiques densifiées. | Feature Class |
x_field | Champ numérique de la table en entrée contenant les coordonnées x (ou longitudes) des points de départ des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference. | Field |
y_field | Champ numérique de la table en entrée contenant les coordonnées y (ou latitudes) des points de départ des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference. | Field |
distance_field | Champ numérique dans la table en entrée contenant les distances à partir des points de départ permettant de créer les lignes en sortie. | Field |
distance_units (Facultatif) | Spécifie les unités des valeurs du paramètre distance_field.
| String |
bearing_field | Champ numérique dans la table en entrée contenant les valeurs d'angle de relèvement pour la rotation des lignes en sortie. Les angles sont mesurés dans le sens horaire à partir du Nord. | Field |
bearing_units (Facultatif) | Spécifie les unités des valeurs du paramètre bearing_field.
| String |
line_type (Facultatif) | Spécifie le type de ligne géodésique à construire.
| String |
id_field (Facultatif) | Un champ de la table en entrée. Ce champ et les valeurs sont inclus dans la sortie et peuvent être utilisés pour joindre les entités en sortie aux enregistrements de la table en entrée. | Field |
spatial_reference (Facultatif) | Référence spatiale de la classe d’entités en sortie. Une référence spatiale peut être spécifiée de l’une des manières suivantes :
| Spatial Reference |
Exemple de code
Exemple d'utilisation de l'outil BearingDistanceToLine (script autonome)
Convertit les informations de relèvement et de distance en une ligne.
# Import system modules
import arcpy
from arcpy import env
# Local variables
input_table = r"c:\workspace\LOBtraffic.dbf"
output_fc = r"c:\workspace\SOPA.gdb\lob_traf001"
#BearingDistanceToLine
arcpy.BearingDistanceToLine_management(input_table, output_fc, "X", "Y",
"NAUTICAL_MILES", "azim", "DEGREES", "GEODESIC","recnum")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui