XY vers lignes (Gestion des données)

Synthèse

Crée une classe d’entités contenant des entités linéaires géodésiques ou planaires à partir des valeurs d’un champ de coordonnées x de départ, d’un champ de coordonnées y de départ, d’un champ de coordonnées x d’arrivée et d’un champ de coordonnées y d’arrivée dans une table.

Utilisation

  • Les lignes en sortie sont construites à partir de valeurs de champ. Les valeurs de champ sont notamment :

    • Les coordonnées x et y d’un point de départ
    • Les coordonnées x et y d’un point d’arrivée
    Les champs et leurs valeurs sont inclus dans la sortie.

  • Pour une ligne géodésique, les coordonnées x et y sont des localisations à la surface de la Terre. Pour une ligne planaire, les coordonnées sont des localisations sur un plan projeté.

  • 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 d’une géodatabase, 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 ArcGIS AllSource 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.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

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
Classe d’entités en sortie

Classe d’entités en sortie contenant les lignes géodésiques ou planaires.

Feature Class
Champ de X de début

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 (Référence spatiale).

Field
Champ de Y de début

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 (Référence spatiale).

Field
Fin du champ X

Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale).

Field
Fin du champ Y

Champ numérique dans la table en entrée contenant les coordonnées y (ou latitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale).

Field
Type de ligne
(Facultatif)

Spécifie le type de ligne à construire.

  • GéodésiqueUn type de ligne géodésique représentant le plus précisément la distance la plus courte entre deux points sur la surface du globe sera construit. Il s’agit de l’option par défaut.
  • Grand cercleUn type de ligne géodésique représentant la trajectoire entre deux points, quels qu’ils soient, le long de l’intersection entre la surface de la Terre et un plan qui passe par le centre de la Terre sera construit Si la valeur du paramètre Référence spatiale est un système de coordonnées basé sur une sphéroïde, la ligne est une grande elliptique. Si la valeur du paramètre Référence spatiale est un système de coordonnées basé sur une sphéroïde, la ligne est appelée uniquement un grand cercle, un cercle du rayon le plus grand sur la surface sphérique.
  • LoxodromieUn type de ligne géodésique, également appelée ligne de loxodromie, représentant une trajectoire entre deux points sur la surface d’un sphéroïde défini par une courbe loxodromique à partir d’un pôle sera construit. Une loxodromie est identifiée comme une ligne droite dans la projection de Mercator.
  • Section normaleUn type de ligne géodésique qui représente une trajectoire entre deux points, quels qu'ils soient, 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 sera construit. 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.
  • Ligne planaireLa ligne droite sur le plan projeté est utilisée. Une ligne planaire ne représente généralement pas précisément la distance la plus courte sur la surface de la Terre, comme le fait la ligne géodésique. Cette option n’est pas disponible pour les systèmes de coordonnées géographiques.
String
ID
(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
Référence spatiale
(Facultatif)

Référence spatiale de la classe d’entités en sortie. Valeur par défaut est GCS_WGS_1984 ou le système de coordonnées en entrée, s'il n'est pas Inconnu.

Spatial Reference
Conserver les attributs
(Facultatif)

Spécifie si les champs en entrée restants sont ajoutés dans la classe d’entités en sortie.

  • Désactivé : les champs en entrée restants ne sont pas ajoutés dans la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • Activé : les champs en entrée restants sont ajoutés dans la classe d’entités en sortie. Un nouveau champ, ORIG_FID, est également ajouté à la classe d’entités en sortie pour stocker les valeurs des identifiants d’entité en entrée.

Boolean

arcpy.management.XYToLine(in_table, out_featureclass, startx_field, starty_field, endx_field, endy_field, {line_type}, {id_field}, {spatial_reference}, {attributes})
NomExplicationType 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 ou planaires.

Feature Class
startx_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
starty_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
endx_field

Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.

Field
endy_field

Champ numérique dans la table en entrée contenant les coordonnées y (ou latitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.

Field
line_type
(Facultatif)

Spécifie le type de ligne à construire.

  • GEODESICUn type de ligne géodésique représentant le plus précisément la distance la plus courte entre deux points sur la surface du globe sera construit. Il s’agit de l’option par défaut.
  • GREAT_CIRCLEUn type de ligne géodésique représentant la trajectoire entre deux points, quels qu’ils soient, le long de l’intersection entre la surface de la Terre et un plan qui passe par le centre de la Terre sera construit Si la valeur du paramètre Référence spatiale est un système de coordonnées basé sur une sphéroïde, la ligne est une grande elliptique. Si la valeur du paramètre Référence spatiale est un système de coordonnées basé sur une sphéroïde, la ligne est appelée uniquement un grand cercle, un cercle du rayon le plus grand sur la surface sphérique.
  • RHUMB_LINEUn type de ligne géodésique, également appelée ligne de loxodromie, représentant une trajectoire entre deux points sur la surface d’un sphéroïde défini par une courbe loxodromique à partir d’un pôle sera construit. Une loxodromie est identifiée comme une ligne droite dans la projection de Mercator.
  • NORMAL_SECTIONUn type de ligne géodésique qui représente une trajectoire entre deux points, quels qu'ils soient, 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 sera construit. 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.
  • PLANARLa ligne droite sur le plan projeté est utilisée. Une ligne planaire ne représente généralement pas précisément la distance la plus courte sur la surface de la Terre, comme le fait la ligne géodésique. Cette option n’est pas disponible pour les systèmes de coordonnées géographiques.
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 :

  • Le chemin d'accès à un fichier .prj (C:/workspace/watershed.prj, par exemple).
  • Le chemin d’accès à 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).
  • Un objet SpatialReference, tel que arcpy.SpatialReference("C:/data/Africa/Carthage.prj")

Spatial Reference
attributes
(Facultatif)

Spécifie si les champs en entrée restants sont ajoutés dans la classe d’entités en sortie.

  • NO_ATTRIBUTESLes champs en entrée restants ne sont pas ajoutés dans la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • ATTRIBUTESLes champs en entrée restants sont ajoutés dans la classe d’entités en sortie. Un nouveau champ, ORIG_FID, est également ajouté à la classe d’entités en sortie pour stocker les valeurs des identifiants d’entité en entrée.
Boolean

Exemple de code

Exemple d'utilisation de l'outil XYToLine (script autonome)

Cet exemple convertit une table DBF en lignes géodésiques à deux points.


# Import system modules
import arcpy

# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"

# XY To Line
arcpy.XYToLine_management(input_table, out_lines, "LOND1", "LATD1", "LOND2",
                          "LATD2", "GEODESIC", "idnum")

Rubriques connexes