Table To Ellipse (Data Management)

License Level:BasicStandardAdvanced

Summary

Creates a new feature class containing geodetic ellipse features constructed based on the values in an x-coordinate field, y-coordinate field, major-axis field, minor-axis field, and azimuth field of a table.

Illustration

Table To Ellipse overview graphic
Ellipse construction parameters

Usage

Syntax

TableToEllipse_management (in_table, out_featureclass, x_field, y_field, major_field, minor_field, distance_units, {azimuth_field}, {azimuth_units}, {id_field}, {spatial_reference})
ParameterExplanationData Type
in_table

The input table that can be a text file, CSV file, Excel file, dBASE table, or geodatabase table.

Table View
out_featureclass

The output feature class containing geodetic ellipses as densified polylines.

Feature Class
x_field

A numerical field in the input table containing the x coordinates (or longitudes) of the center points of ellipses to be positioned in the output coordinate system specified by the spatial_reference parameter.

Field
y_field

A numerical field in the input table containing the y coordinates (or latitudes) of the center points of ellipses to be positioned in the output coordinate system specified by the spatial_reference parameter.

Field
major_field

A numerical field in the input table containing major axis lengths of the ellipses.

Field
minor_field

A numerical field in the input table containing minor axis lengths of the ellipses.

Field
distance_units

The units for the values in Major Field and Minor Field.

  • METERSValues in meters; this is the default.
  • KILOMETERSValues in kilometers.
  • MILESValues in miles.
  • NAUTICAL_MILESValues in nautical miles.
  • FEETValues in International feet.
  • US_SURVEY_FEETValues in U.S. Survey feet.
String
azimuth_field
(Optional)

A numerical field in the input table containing azimuth angle values for the major axis rotations of the output ellipses. The values are measured clockwise from North.

Field
azimuth_units
(Optional)

The units of the values in the Azimuth Field.

  • DEGREESValues in decimal degrees; this is the default.
  • MILSValues in mils.
  • RADSValues in radians.
  • GRADSValues in gradians.
String
id_field
(Optional)

A field in the input table; this field and the values are included in the output and can be used to join the output features with the records in the input table.

Field
spatial_reference
(Optional)

The spatial reference of the output feature class. You can specify the spatial reference in several ways:

  • By entering the path to a .prj file, such as C:/workspace/watershed.prj.
  • By referencing a feature class or feature dataset whose spatial reference you want to apply, such as C:/workspace/myproject.gdb/landuse/grassland.
  • By defining a spatial reference object prior to using this tool, such as sr = arcpy.SpatialReference("C:/data/Africa/Carthage.prj"), which you then use as the spatial reference parameter.

Spatial Reference

Code Sample

TableToEllipse example (stand-alone script)

Creates polyline ellipse features from a table.

# Import system modules
import arcpy
from arcpy import env

# 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")

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
11/18/2013