Coordinate Table To Line Of Bearing (Defense)

Summary

Creates lines of bearing from coordinates stored in a table.

Usage

• The output line feature class will have fields for both bearing and distance values.

Syntax

CoordinateTableToLineOfBearing(in_table, out_feature_class, x_or_lon_field, bearing_field, distance_field, in_coordinate_format, {bearing_units}, {distance_units}, {y_or_lat_field}, {line_type}, {coordinate_system})

Parameter	Explanation	Data Type
in_table	The table containing the source coordinates.	Table View
out_feature_class	The feature class containing the output lines of bearing.	Feature Class
x_or_lon_field	The field in the input table containing the x or longitude coordinates.	Field
bearing_field	The field in the input table containing the bearing values.	Field
distance_field	The field in the input table containing the distance values.	Field
in_coordinate_format	Specifies the format of the input table coordinates. DD_1 —Coordinates will be formatted in a decimal degrees coordinate pair stored in a single field with coordinates separated by a space, comma, or slash. DD_2 —Coordinates will be formatted in a decimal degrees coordinate pair stored in two table fields. This is the default. DDM_1 —Coordinates will be formatted in a degrees and decimal minutes coordinate pair stored in a single table field with coordinates separated by a space, comma, or slash. DDM_2 —Coordinates will be formatted in a degrees and decimal minutes coordinate pair stored in two table fields. DMS_1 —Coordinates will be formatted in a degrees, minutes, and seconds coordinate pair stored in a single table field with coordinates separated by a space, comma, or slash. DMS_2 —Coordinates will be formatted in a degrees, minutes, and seconds coordinate pair stored in two table fields. GARS —Coordinates will be formatted in Global Area Reference System. GEOREF — Coordinates will be formatted in World Geographic Reference System. UTM_BANDS —Coordinates will be formatted in Universal Transverse Mercator coordinate bands. UTM_ZONES —Coordinates will be formatted in Universal Transverse Mercator coordinate zones. USNG —Coordinates will be formatted in United States National Grid. MGRS —Coordinates will be formatted in Military Grid Reference System.	String
bearing_units (Optional)	Specifies the unit of measurement for the bearing angles. DEGREES —The angle will be degrees. This is the default. MILS —The angle will be mils. RADS —The angle will be radians. GRADS —The angle will be gradians.	String
distance_units (Optional)	Specifies the units of measurement for the distance. METERS —The unit will be meters. This is the default. KILOMETERS —The unit will be kilometers. MILES —The unit will be miles. NAUTICAL_MILES —The unit will be nautical miles. FEET —The unit will be feet. US_SURVEY_FEET —The unit will be U.S. survey feet.	String
y_or_lat_field (Optional)	The field in the input table containing the y or latitude coordinates. The y_or_lat_field parameter is used when the in_coordinate_format parameter is set to DD_2, DDM_2, or DMS_2.	Field
line_type (Optional)	Specifies the output line type. GEODESIC —The shortest distance between any two points on the earth's spheroidal surface (ellipsoid) will be used. This is the default. GREAT_CIRCLE —The line on a spheroid (ellipsoid) defined by the intersection of a plane passing through the center of the spheroid will be used. RHUMB_LINE —A line of constant bearing or azimuth will be used. NORMAL_SECTION —A normal plane to the earth's ellipsoidal surface containing the start and end points will be used.	String
coordinate_system (Optional)	The spatial reference of the output feature class. The default is GCS_WGS_1984.	Spatial Reference

Code sample

CoordinateTableToLineOfBearing example 1 (Python window)

The following Python window script demonstrates how to use the CoordinateTableToLineOfBearing function.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.CoordinateTableToLineOfBearing_defense(r"C:CSV/TableToLineOfBearing.csv",
                                             "LOB",
                                             "x",
                                             "Orientation",
                                             "Distance",
                                             "DD_2",
                                             "DEGREES",
                                             "KILOMETERS",
                                             "y")

CoordinateTableToLineOfBearing example 2 (stand-alone script)

The following example uses the CoordinateTableToLineOfBearing function in an example workflow script.

# Description: Create lines of bearing from tabular data and then create 
#              bounding envelopes around each line.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.env.overwriteOutput = True

# Create lines of bearing
input_table = r"C:/CSV/TableToLineOfBearing.csv"
result_line = "Output_LOB"
arcpy.CoordinateTableToLineOfBearing_defense(input_table,
                                             result_line,
                                             "x",
                                             "Orientation",
                                             "Distance",
                                             "DD_2",
                                             "DEGREES",
                                             "KILOMETERS",
                                             "y")

# Create envelopes
result_envelope = "Output_Envelope"
arcpy.FeatureEnvelopeToPolygon_management(result_line, result_envelope)

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes