Table vers ellipses (Gestion des données)

Résumé

Crée une classe d’entités contenant des entités d’ellipse 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 grand axe, d’un champ de petit axe et d’un champ azimut d’une table.

Illustration

Illustration graphique de l’outil Table vers ellipse (Table vers ellipses)
Les paramètres de construction de l’ellipse sont affichés.

Utilisation

  • Chaque ellipse 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 central, les longueurs du grand axe et du petit axe, ainsi que l'angle azimutal mesuré à partir du nord. Ces champs et valeurs sont inclus dans la sortie.

  • Une ellipse géodésique est une courbe à la surface de la Terre. Toutefois, l'entité d'ellipse géodésique n'est pas stockée en tant que courbe paramétrique (vraie) dans la sortie, mais plutôt comme une polyligne densifiée représentant le chemin de l'ellipse géodésique.

  • Si vous spécifiez le même champ pour Champ grand rayon et Champ petit rayon, ou si 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.

  • Le cas échéant, vous pouvez utiliser l'outil Feature To Polygon (Entités vers polygones) pour convertir les polylignes en sortie en polygones.

Syntaxe

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})
ParamètreExplicationType 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 ellipses géodésiques stockées en tant que polylignes densifiées.

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 des 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 du 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 écrits dans la classe d’entités en sortie.

  • NO_ATTRIBUTESLes champs en entrée restants ne sont pas écrits dans la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • ATTRIBUTESLes champs en entrée restants sont inclus 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 TableToEllipse (script autonome)

Créez des entités polylignes 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"
# Table To Ellipse
arcpy.TableToEllipse_management(input_table, output_ellipse, "lond", "latd", 
                                "mjerr", "mnerr", "KILOMETERS", "orient", 
                                "DEGREES", "LinkID")

Informations de licence

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

Rubriques connexes