Table vers ellipses (Gestion des données)

Synthèse

Crée une classe d’entités contenant des ellipses géodésiques ou planaires à partir des valeurs d’un champ de coordonnées x, d’un champ de coordonnées y, de champs de grand axe et de petit axe, et d’un champ azimut d’une table.

Illustration

Illustration de l'outil Table vers ellipses

Utilisation

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

    • Les coordonnées x et y d’un point central
    • Les longueurs du grand axe et du petit axe
    • L’angle azimutal
    Les champs et leurs valeurs sont inclus dans la sortie.

  • Lorsque les ellipses en sortie sont géodésiques, les coordonnées x et y et les longueurs du grand axe et du petit axe sont mesurées à la surface de la Terre, et l’angle azimutal est mesuré à partir du Nord. Lorsque les ellipses en sortie sont planaires, les coordonnées x et y et les longueurs du grand axe et du petit axe sont mesurées sur le plan projeté, et l’angle azimutal est mesuré dans le sens horaire à partir du Nord du quadrillage (vertical haut sur la carte).

  • Une ellipse géodésique est une courbe à la surface de la Terre. Une entité ellipse géodésique n’est toutefois pas stockée en tant que courbe paramétrique (vraie) en sortie ; elle est stockée en tant que polyligne densifiée représentant la trajectoire de l’ellipse géodésique.

  • Si vous spécifiez le même champ pour les paramètres Champ grand rayon et Champ petit rayon ou que les valeurs des deux champs sont identiques, les entités en sortie représentent des cercles géodésiques.

  • 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 Pro 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.

  • Par défaut, la sortie sera une classe d'entités linéaires. Pour créer une classe d’entités surfaciques, spécifiez Polygone comme valeur du paramètre Type de géométrie.

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 qui contiendra les ellipses géodésiques ou planaires.

Feature Class
Champ X

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

Field
Champ Y

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

Field
Champ grand rayon

Champ numérique dans la table en entrée contenant les longueurs du grand axe des ellipses.

Field
Champ petit rayon

Champ numérique dans la table en entrée contenant les longueurs du petit axe des ellipses.

Field
Unités de distance

Spécifie les unités à utiliser pour les paramètres Champ grand rayon et Champ petit rayon.

  • MètresL’unité sera le mètre.
  • KilomètresL’unité sera le kilomètre
  • MilesL'unité sera le mile.
  • Milles nautiquesL’unité sera le mille nautique.
  • PiedsL’unité sera le pied.
  • Pieds d’arpentage USL’unité sera le pied d’arpentage U.S.
String
Champ azimut
(Facultatif)

Champ numérique dans la table en entrée contenant les valeurs d'angle azimutal pour les rotations du grand axe des ellipses en sortie. Les valeurs sont mesurées dans le sens horaire à partir du Nord.

Field
Unités azimut
(Facultatif)

Spécifie les unités utilisées pour le paramètre Champ azimut.

  • Degrés décimaux L’unité sera le degré décimal. Il s’agit de l’option par défaut.
  • MilsL'unité sera le mils.
  • RadiansL’unité sera le radian.
  • GradesL’unité sera le grade.
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
Type de géométrie
(Facultatif)

Spécifie le type de géométrie pour la classe d’entités en sortie.

  • LigneUne classe d’entités polylignes en sortie est créée. Il s’agit de l’option par défaut.
  • PolygoneUne classe d'entités surfaciques en sortie est créee.
String
Méthode
(Facultatif)

Indique si l’ellipse est générée en fonction de mesures géodésiques ou planaires.

  • GéodésiqueUne ellipse géodésique est générée. L’ellipse représente avec précision la forme à la surface de la Terre. Il s’agit de l’option par défaut.
  • PlanaireUne ellipse planaire est générée sur le plan projeté. Elle ne représente généralement pas précisément la forme à la surface de la Terre, comme le fait l’ellipse géodésique. Cette option n’est pas disponible pour les systèmes de coordonnées géographiques.
String

arcpy.management.TableToEllipse(in_table, out_featureclass, x_field, y_field, major_field, minor_field, distance_units, {azimuth_field}, {azimuth_units}, {id_field}, {spatial_reference}, {attributes}, {geometry_type}, {method})
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 qui contiendra les ellipses géodésiques ou planaires.

Feature Class
x_field

Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points centraux des ellipses à 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 centraux des ellipses à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.

Field
major_field

Champ numérique dans la table en entrée contenant les longueurs du grand axe des ellipses.

Field
minor_field

Champ numérique dans la table en entrée contenant les longueurs du petit axe des ellipses.

Field
distance_units

Spécifie les unités utilisées pour les paramètres major_field et minor_field.

  • METERSL’unité sera le mètre.
  • KILOMETERSL’unité sera le kilomètre
  • MILESL'unité sera le mile.
  • NAUTICAL_MILESL’unité sera le mille nautique.
  • FEETL’unité sera le pied.
  • US_SURVEY_FEETL’unité sera le pied d’arpentage U.S.
String
azimuth_field
(Facultatif)

Champ numérique dans la table en entrée contenant les valeurs d'angle azimutal pour les rotations du grand axe des ellipses en sortie. Les valeurs sont mesurées dans le sens horaire à partir du Nord.

Field
azimuth_units
(Facultatif)

Spécifie les unités utilisées pour le paramètre azimuth_field.

  • DEGREES L’unité sera le degré décimal. Il s’agit de l’option par défaut.
  • MILSL'unité sera le mils.
  • RADSL’unité sera le radian.
  • GRADSL’unité sera le grade.
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
geometry_type
(Facultatif)

Spécifie le type de géométrie pour la classe d’entités en sortie.

  • LINEUne classe d’entités polylignes en sortie est créée. Il s’agit de l’option par défaut.
  • POLYGONUne classe d'entités surfaciques en sortie est créee.
String
method
(Facultatif)

Indique si l’ellipse est générée en fonction de mesures géodésiques ou planaires.

  • GEODESICUne ellipse géodésique est générée. L’ellipse représente avec précision la forme à la surface de la Terre. Il s’agit de l’option par défaut.
  • PLANARUne ellipse planaire est générée sur le plan projeté. Elle ne représente généralement pas précisément la forme à la surface de la Terre, comme le fait l’ellipse géodésique. Cette option n’est pas disponible pour les systèmes de coordonnées géographiques.
String

Exemple de code

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

Créer une entité polyligne d'ellipse à partir d'une table.

# Import system modules
import arcpy

# Set local variables
input_table = r'c:\workspace\SGS\eltop.gdb\elret'
output_ellipse = r'c:\workspace\SGS\eltop.gdb\Eplyln_001'

# Run Table To Ellipse
arcpy.management.TableToEllipse(input_table, output_ellipse, 'lond', 'latd', 
                                'mjerr', 'mnerr', 'KILOMETERS', 'orient', 
                                'DEGREES', 'LinkID')

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes