AggieMaps

A routing web application for the Texas A&M Bus System.

Welcome to AggieMaps

AggieMaps is an open source web application created to increase the usability of the Texas A&M Bus System.

The web app is written in Python, HTML, and JavaScript, and is hosted on the Google App Engine and Heroku.

Try it now! AggieMaps

Program Flow

1. User enters starting and ending location
2. Program finds the first and second closest bus stops to the starting and ending location
3. Dijkstra's shortest-path algorithm is used to find 4 shortest routes:
   • stop closest to starting point ➡️ stop closest to ending point
   • stop 2nd closest to starting point ➡️ stop closest to ending point
   • stop closest to starting point ➡️ stop 2nd closest to ending point
   • stop 2nd closest to starting point ➡️ stop 2nd closest to ending point
4. Program returns the best path as a JSON object

Getting Started

The following instructions give potential contributors insight to how AggieMaps was created.

coordinates.csv

This file contains the geographical coordinates of each bus stop. Coordinates were collected manually using the TAMU Transportation website and Google Maps.

[Route Name]	[Latitude in Decimal Degrees]	[Longitude in Decimal Degrees]

Coordinate Collecters

• Michael Abreo
• Alexander Labbane
• Joseph Nguyen Ho

routes.csv

This file contains the stops and timing information for each bus route. Stops and times were collected manually using the TAMU Transportation website.

[Route Name]
[Initial Stop]	[Minutes to Stop 1]
[Stop 1 Name]	[Minutes to 2 Stop]
[Stop 2 Name]	[Minutes to Initial Stop]
[Initial Stop]

walk.csv

This file contains a list of all the bus stops that should be connected by walking. Coordinates were collected manually using the TAMU Transportation website.

[Stop 1]	[Stop 2]	[Minutes to walk between stops]

 The coordinates and routes files are used to populate the graph representing the bus system 
 They provide a user-friendly interface for updating bus stop locations, routes, and timings

verifydata.py

This python script checks the coordinates.csv and routes.csv files for correctness. It detects extraneous bus stops, omitted bus stops, and duplicate coordinates.

To check your changes

• Place the coordinates.csv, routes.csv, and verifydata.py files in the same directory.
• Please make sure you use Python 3.x., Python 2.x is not supported currently.
• Run verifydata.py.

generategraph.py

This python script uses coordinates.csv, walk.csv and routes.csv to generate a graph representing the bus system. It first creates a graph with only bussed connections, and then adds walking connections.

The graph consists of a dictionary, whose key is a stop name and value is a dictionary. The keys of this dictionary are stop names and the values are a list whose first element is the time it takes to get between the two stops and latter elements are the busses that serve that route.

To generate a graph

• Place the coordinates.csv, routes.csv, walk.csv, and generategraph.py files in the same directory.
• Please make sure you use Python 3.x., Python 2.x is not supported currently.
• Run generategraph.py.