Coordinate Table To Line Of Bearing (Defense Tools)

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.

Parameters

Dialog
Python

Label	Explanation	Data type
Input Table	The table containing the source coordinates.	Table View
Output Bearing Lines Feature Class	The feature class containing the output lines of bearing.	Feature Class
X Field (longitude, UTM, MGRS, USNG, GARS, GEOREF)	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
Input Coordinate Format	Specifies the format of the input table coordinates. Decimal Degrees - One Field—Coordinates will be formatted in a decimal degrees coordinate pair stored in a single field with coordinates separated by a space, comma, or slash. Decimal Degrees - Two Fields—Coordinates will be formatted in a decimal degrees coordinate pair stored in two table fields. This is the default. Degrees and Decimal Minutes - One Field—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. Degrees and Decimal Minutes - Two Fields—Coordinates will be formatted in a degrees and decimal minutes coordinate pair stored in two table fields. Degrees, Minutes, and Seconds - One Field—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. Degrees, Minutes, and Seconds - Two Fields—Coordinates will be formatted in a degrees, minutes, and seconds coordinate pair stored in two table fields. Global Area Reference System—Coordinates will be formatted in Global Area Reference System. World Geographic Reference System—Coordinates will be formatted in World Geographic Reference System. Universal Transverse Mercator Bands—Coordinates will be formatted in Universal Transverse Mercator coordinate bands. Universal Transverse Mercator Zones—Coordinates will be formatted in Universal Transverse Mercator coordinate zones. United States National Grid—Coordinates will be formatted in United States National Grid. Military Grid Reference System—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. Radians—The angle will be radians. Gradians—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 Field (latitude) (Optional)	The field in the input table containing the y or latitude coordinates. The Y Field (latitude) parameter is used when the Input Coordinate Format parameter is set to Decimal Degrees - Two Fields, Degrees and Decimal Minutes - Two Fields, or Degrees Minutes and Seconds - Two Fields.	Field
Line Type (Optional)	Specifies the output line type. Geodesic line—The shortest distance between any two points on the earth's spheroidal surface (ellipsoid) will be used. This is the default. Great circle line—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
Output Coordinate System (Optional)	The spatial reference of the output feature class. The default is GCS_WGS_1984.	Spatial Reference

arcpy.defense.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})

Name	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.defense.CoordinateTableToLineOfBearing(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.defense.CoordinateTableToLineOfBearing(input_table,
                                             result_line,
                                             "x",
                                             "Orientation",
                                             "Distance",
                                             "DD_2",
                                             "DEGREES",
                                             "KILOMETERS",
                                             "y")

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

Environments

Output Coordinate System, Geographic Transformations, Current Workspace, Scratch Workspace

Licensing information