• Introduction
• Installation
• Explore your data
• Inspecting for problems

Introduction

Schedule Viewer is a Python program for viewing the contents of a Google Transit Feed Spec feed on a map. It's a diagnostic program intended for those creating a feed, and as such doesn't include trip planning or other features that are useful to transit riders.

Installation

The Schedule Viewer is part of the Transit Feed Distribution. See the page about the transit feed distribution for instructions on installing either the Windows executable or python source.

To run you need:

• (Optional) If you want to access the schedule viewer from another machine you need <google_maps_api_key>, a Google Maps API key for your machine http://my-hostname:8765, available from the Google Maps API signup page
• <feed_file_or_directory> a transit feed file or a directory containing an expanded feed file. If you don't have a feed download one from the PublicFeeds page or read the Google Transit Feed Specification to create your own.

Running from source

python schedule_viewer.py [--key <google_maps_api_key>] --feed_filename <feed_file_or_directory>

On Windows the python executable is normally installed as C:\Python25\python

Running Windows exe

If you installed the Windows exe run the following command

schedule_viewer.exe [--key <google_maps_api_key>] --feed_filename <feed_file_or_directory>

If you run it from Start -> Run include the full path of schedule_viewer.exe and if you are in a command prompt change into the directory containing schedule_viewer.exe.

Explore your data

Once schedule_viewer has finished loading the feed file it prints a URL. Ignore that URL because it won't work with your Google Maps API key. Instead go to http://localhost:8765/ in your web browser and a page similar to the screen shot above should load.

Exploring stops

After you drag the map to a new location with your mouse it will display stops in the current area as transparent blue markers. If there are lots of stops in the map area only a sample will be displayed. To see all the stops you need to zoom in. The map zooms in when double clicked. If you click on a marker it opens a window listing the "stop_name (stop_id)" and the next trips to visit the stop after "Time:" (HH:MM at top left of screen). Click on a trip to display it.

The Find Station field (top left, below "Time:") will search for all stops that have a name or stop_id containing the string you enter.

Exploring routes

The left pane lists all the routes in the feed. Click on one of the route names to see the trip patterns (a group of trips that visit the same stops in the same order) for that route. The first trip will automatically be selected, and shown on the map. For each trip pattern the number of stops, number of trips and start times are displayed. For patterns that have many trips only a few start times are displayed. To see the start times of more trips edit "Time:" (HH:MM at top left of screen) and click on the route name again.

Viewing a trip

After you click on a trip in a stop marker's window or on a start time in the route list it is displayed in the map. Every stop of the trip is shown as a yellow marker. Timepoints have the time displayed on the map. Some of the source data for that trip and route will be displayed at the bottom of the window. Below the source data is a Marey Graph (CRI, Timetables people and Tufte and Graphical Timetables for BART).

In the Marey Graph time increases to the right and distance between stops is on the Y axis. The numbers above the graph are hours. All trips of a pattern are plotted on the same graph disregarding service periods. A steeper line represents faster movement. In the screen shot above you can see fairly fast service with stops far apart in the East Bay, followed by a big gap without stops in the tunnel under the bay, followed by frequent stops in the city of San Francisco. If you place your mouse over a trip the trip_id appears below the graph. You see the headway for this pattern is regular until about 9am.

Inspecting for problems

When you first load the schedule viewer the map is zoomed out to contain all stops. If this is much larger than your service area there is probably a stop in the wrong place. Move the service are out of displayed map area and the distant stop will probably appear.

Check the location of a stop by zooming in until you can see the street names. Click on the stop marker to open the window and make sure the marker is in the correct location. For rail stations you may see the real location more easily with satellite view. Repeat this for stops in different parts of the service area.

Click through all the routes. In each route look at one trip of each pattern. Watch out for unreasonably fast or slow legs. If the polyline has any jumps there may be a stop with the incorrect geo location or incorrect information in the stop_times table. If the agency has published a route map it can help you confirm that the trip in GTFS is correct.

Here are some examples of buggy data:

A stop with a bad geo location in stops.txt or using the wrong stop_id in stop_times.txt can cause a big jump.

Big jumps also stick out as a very fast (almost vertical) line in the Marey Graph. Note that a route with a long express section may look similar in the Marey Graph.

A zig-zag can be caused by bad geo locations in stops.txt or an incorrect sequence of stop_id values in stop_times.txt.

Someone familiar with BART may notice that this skips two stops.

Bugs and feature requests

Vote for known ScheduleViewer issues so the developers know what is important.

If you find an unreported bug or have a feature request please file a new issue and add the label App-ScheduleViewer.