Distance d’orientation vers lignes (Gestion des données)

Récapitulatif

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

Paramètres de construction relèvement et distance

Utilisation

• Si vous utilisez des fichiers texte et des fichiers .csv (valeurs séparées par des virgules) en entrée, veillez à ce qu'ils suivent la structure de fichier spécifiée dans About_tabular_data_sources.

• 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. Toutefois, une entité linéaire géodésique n'est pas stockée en tant que courbe paramétrique (vraie) dans la sortie, mais plutôt 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 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 Mesurer d'ArcMap. Veillez à choisir l'option Géodésique, Loxodromie ou Grande elliptique, selon le cas, avant d'effectuer une mesure.

Syntaxe

BearingDistanceToLine_management (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 pouvant être un fichier texte, un fichier CSV, un fichier Excel, une table dBASE ou 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 dans 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 dans 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)	Unités des valeurs du champ Distance. METERS —Valeurs en mètres, par défaut. KILOMETERS —Valeurs en kilomètres. MILES —Valeurs en miles. NAUTICAL_MILES —Valeurs en miles nautiques. FEET —Valeurs en pieds internationaux. US_SURVEY_FEET —Valeurs en pieds d'arpentage américain.	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)	Unités des valeurs du champ Relèvement. DEGREES —Valeurs en degrés décimaux, par défaut. MILS —Valeurs en miles. RADS —Valeurs en radians. GRADS —Valeurs en grades.	String
line_type (Facultatif)	Type de ligne géodésique à créer. GEODESIC — Type de ligne géodésique qui représente le plus précisément la distance la plus courte entre deux points sur la surface de la Terre. La définition mathématique de la ligne géodésique étant assez longue et complexe, nous ne la proposons pas dans ce document. Il s'agit du type de ligne par défaut. GREAT_CIRCLE —Type de ligne géodésique qui représente la trajectoire entre deux points le long de l'intersection entre la surface de la Terre et un plan qui passe par le centre de la Terre. Selon le système de coordonnées en sortie spécifié par le paramètre Référence spatiale, dans un système de coordonnées basé sur une sphéroïde, la ligne est une grande elliptique. Dans un système de coordonnées basé sur une sphère, la ligne est appelée un grand cercle, un cercle du rayon le plus grand sur la surface sphérique. RHUMB_LINE —Type de ligne géodésique, également appelée ligne de loxodromie, qui représente une trajectoire entre deux points sur la surface d'un sphéroïde défini par une courbe loxodromique à partir d'un pôle. Une loxodromie est identifiée comme une ligne droite dans la projection de Mercator. NORMAL_SECTION —Type de ligne géodésique qui représente une trajectoire entre deux points sur la surface d'un sphéroïde défini par l'intersection de la surface du sphéroïde et un plan qui traverse les deux points et qui est normal (perpendiculaire) à la surface du sphéroïde au point de départ des deux points. Ainsi, la ligne de section normale du point A au point B est différente de celle qui relie le point B et le point A.	String
id_field (Facultatif)	Champ dans 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. Vous pouvez spécifier la référence spatiale de plusieurs façons : En entrant le chemin d'accès à un fichier .prj (C:/workspace/watershed.prj, par exemple). En référençant une classe d'entités ou un jeu de données d'entité dont vous souhaitez appliquer la référence spatiale, (C:/workspace/myproject.gdb/landuse/grassland, par exemple). En définissant un objet de référence spatiale avant d'utiliser cet outil, tel que sr = arcpy.SpatialReference ("C:/data/Africa/Carthage.prj") que vous utilisez ensuite en tant que paramètre de référence spatiale.	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

Espace de travail courant, Espace de travail temporaire

Informations de licence

ArcGIS for Desktop Basic: Oui

ArcGIS for Desktop Standard: Oui

ArcGIS for Desktop Advanced: Oui