Coordinate Table To Polyline (Defense)

Summary

Creates a polyline feature class from coordinates stored in a table.

Usage

  • Fields from the input table will not be copied to the output polyline feature class.

Parameters

LabelExplanationData Type
Input Table

The table containing the source coordinates.

Table View
Output Polyline Feature Class

The feature class containing the output polyline features.

Feature Class
X Field (Longitude, UTM, MGRS, USNG, GARS, GeoRef)

The field in the input table containing the x or longitude coordinates.

Field
Input Coordinate Format

Specifies the format of the input table coordinates.

  • Decimal Degrees - One FieldCoordinates 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 FieldsCoordinates will be formatted in a decimal degrees coordinate pair stored in two table fields. This is the default.
  • Degrees and Decimal Minutes - One FieldCoordinates 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 FieldsCoordinates will be formatted in a degrees and decimal minutes coordinate pair stored in two table fields.
  • Degrees, Minutes, and Seconds - One FieldCoordinates 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 FieldsCoordinates will be formatted in a degrees, minutes, and seconds coordinate pair stored in two table fields.
  • Global Area Reference SystemCoordinates will be formatted in Global Area Reference System.
  • World Geographic Reference System Coordinates will be formatted in World Geographic Reference System.
  • Universal Transverse Mercator BandsCoordinates will be formatted in Universal Transverse Mercator coordinate bands.
  • Universal Transverse Mercator ZonesCoordinates will be formatted in Universal Transverse Mercator coordinate zones.
  • United States National GridCoordinates will be formatted in United States National Grid.
  • Military Grid Reference SystemCoordinates will be formatted in Military Grid Reference System.
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 Grouping Field
(Optional)

The field in the input table field used to create unique polylines. A polyline will be created for each unique value.

Field
Sort Field
(Optional)

The field in the input table used to order the polyline vertices. The field must be numeric.

Field
Output Coordinate System
(Optional)

The spatial reference of the output feature class. The default is GCS_WGS_1984.

Spatial Reference

arcpy.defense.CoordinateTableToPolyline(in_table, out_feature_class, x_or_lon_field, in_coordinate_format, {y_or_lat_field}, {line_group_field}, {sort_field}, {coordinate_system})
NameExplanationData Type
in_table

The table containing the source coordinates.

Table View
out_feature_class

The feature class containing the output polyline features.

Feature Class
x_or_lon_field

The field in the input table containing the x or longitude coordinates.

Field
in_coordinate_format

Specifies the format of the input table coordinates.

  • DD_1Coordinates will be formatted in a decimal degrees coordinate pair stored in a single field with coordinates separated by a space, comma, or slash.
  • DD_2Coordinates will be formatted in a decimal degrees coordinate pair stored in two table fields. This is the default.
  • DDM_1Coordinates 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_2Coordinates will be formatted in a degrees and decimal minutes coordinate pair stored in two table fields.
  • DMS_1Coordinates 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_2Coordinates will be formatted in a degrees, minutes, and seconds coordinate pair stored in two table fields.
  • GARSCoordinates will be formatted in Global Area Reference System.
  • GEOREF Coordinates will be formatted in World Geographic Reference System.
  • UTM_BANDSCoordinates will be formatted in Universal Transverse Mercator coordinate bands.
  • UTM_ZONESCoordinates will be formatted in Universal Transverse Mercator coordinate zones.
  • USNGCoordinates will be formatted in United States National Grid.
  • MGRSCoordinates will be formatted in Military Grid Reference System.
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_group_field
(Optional)

The field in the input table field used to create unique polylines. A polyline will be created for each unique value.

Field
sort_field
(Optional)

The field in the input table used to order the polyline vertices. The field must be numeric.

Field
coordinate_system
(Optional)

The spatial reference of the output feature class. The default is GCS_WGS_1984.

Spatial Reference

Code sample

CoordinateTableToPolyline example 1 (Python window)

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.CoordinateTableToPolyline_defense(r"C:/CSV/TableToPolyline.csv", 
                                        "Out_Polyline", "POINT_X", "DD_2", 
                                        "POINT_Y", "Group_")
CoordinateTableToPolyline example 2 (stand-alone script)

The following Python example shows how to use the CoordinateTableToPolyline function in a sample workflow.

# Description: Create polylines from tabular data and find a representative 
#              center point of each line.

# Import system modules
import arcpy

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

# Create polylines
input_table = r"C:/CSV/TableToPolyline.csv"
result_line = "Output_Polyline"
arcpy.CoordinateTableToPolyline_defense(input_table, result_line, "POINT_X", 
                                        "DD_2", "POINT_Y", "Group_")

# Find representative center point
result_center = "Output_Centers"
arcpy.FeatureToPoint_management(result_line, result_center)