Generate optimal school bus routes for an existing set of students, stops and school locations. Routes are optimized for minimal bus drive time and can be constrained to limit maximum student ride time. This tool uses uses OpenTripPlanner to generate route costs and OptaPlanner as a constraint solver.

BusPlan is a collaborative effort to help reduce public school budgets and increase the quality of life for students, supported by the following organizations:

Download Open Street Map extract(s) for your city of interest from Mapzen

Open sbt console and OpenTripPlanner project from the root directory:

$ sbt

> project otp

Generate graphs, run e.g.

> run ./osm_metro_extract.osm.pbf output_metro_area_graph.obj

Select the GenerateRouteGraph option.

This will create two graphs: one that allows highway access (for buses without any passengers) and one that doesn't (for buses transporting students).

Next, create a cost matrix with the travel times/distances (i.e. costs) among all nodes (i.e. garages, bus stops, schools).

Prepare a csv of nodes in the following fields:

• id: uuid
• count: count of students picked up or dropped off at location
• X: latitude
• Y: longitude
• type: type of node (e.g. one of 'garage', 'stop', or 'school')
• time: unix timestamp of five minutes prior to school bell time (value of 0 for all non-school nodes)

Generate cost matrix CSV from nodes:

run ./cost_matrix_nodes.csv ./graph_withStudents.obj ./graph_withoutStudents.obj ./cost_matrix_output.csv

Choose the number corresponding to the GenerateCostMatrix class.

Next prepare an additional dataset of "student nodes" with the locations of all students in the problem. This dataset should be in the form of a csv with the following fields:

• id: uuid
• grade: student's grade level
• X: latitude
• Y: longitude
• type: in this case all 'student'
• time: unix timestamp of five minutes prior to school bell time (value of 0 for all non-school nodes)
• stop_id: the uuid (from main cost matrix nodes dataset) of the stop that the student is currently assigned to

Generate a CSV of stops within a mile radius of each student, e.g.

$ python ./data-prep/find-eligible-stops.py ./cost_matrix_nodes.csv ./student_nodes.csv ./student_candidate_stops.csv

Back in the sbt console, otp project, find the walk distances for ech student to nearby bus stops

run ./cost_matrix_nodes.csv ./student_nodes.csv ./student_candidate_stops.csv ./graph_withStudents.obj ./student_stop_eligibility.ser ./student_stop_eligibility.csv

Select the GenerateStudentToStopMatrix option when prompted.

This will write four files with comma-separated lists of students and the bus stops that each is allowed to walk to at four different maximum student walk distance thresholds.

Create a CSV of garages that buses will originate at in the plan. It should have the following fields:

• uuid: uuid that matches cost matrix
• maximum: the maximum number of buses that can originate at the garage

Switch to the sbt planner project

> project planner

Run solver:

> run ./cost_matrix.csv ./student_dataset.csv ./student_stop_eligibility.csv ./garage_count.csv ./solver_routes.csv ./solver_student_assignment.csv

Select the number corresponding to the BusPlanner class.

This will generate two csvs: a dataset with ordered lists of stops in each route (solver_routes.csv), and a set of comma-separated lists of student uuids that are assigned to each unique combination of route and stop (solver_student_assignment.csv)

Switch back to the Open Trip Planner project

> project otp

Convert dataset of stop sequences into actual mappable routes, e.g.

> run cost_matrix_nodes.csv ./solver_routes.csv ./solver_student_assignment.csv ./graph_withStudents.obj ./graph_withoutStudents.obj ./router_output.csv

When prompted, select the number associated with GenerateRoutesFromSolver

Exit sbt console

Find ride times for each student

$ python ./analysis/get-student-ride-times.py ./router_output.csv ./solver_student_assignment.csv ./ride_time_csv

Open up jupyter route analysis jupyter notebook

$ jupyter notebook ./analysis/Bus_Plan_Analyis.ipynb

Follow instructions in notebook.