RouteModel

Prerequisite: Read the RouteElevation documentation first to understand what a polygonal chain is and how it's used to represent a route

RouteModel will probably work best with CoordinateElevation since RouteModel is able to find the coordinates in the route

Introduction

RouteModel is a model that consumes a polygonal chain representation of a route and returns an interpolated route

User Guide

When using this, there are only 4 things that you need to know:

• The object initialization

• The get_data() method

• The get_csv() method

• Dataframe values

The object initialization

Initializing the object requires 2 required parameters, coordinate_lst_input: a polygonal chain representation of the route, and interval_upper_bound: an uppper bound for the distance between coordinates

The get_data() method

Returns a pandas dataframe of the interpolated route

The get_csv() method

Consumes a string, filename, and saves a csv of the interpolated route as <filename>.csv in current directory

Dataframe fields

• polyline_point_index: The polygonal chain point index of the coordinate,

• latitude: Latitude,

• longitude: Longitude,

• dist_to_next_coordinate: Distance to next coordinate (in meters)

• true_bearing_to_next: True north bearing to next coordinate

• bearing_to_next_360: True north bearing to next coordinate in 360 degrees

• true_bearing_to_prev: True north bearing to previous coordinate

• bearing_to_prev_360: True north bearing to previous coordinate in 360 degrees

• general_travel_direction: General direction of car at current coordinate

• turn_bearing: Relative turn bearing for car at current coordinate

• turn_type: Type of turn for the car

• relative_turn_angle: Formatted relative turn angle for car at current coordinate

Sample code