GUI interface for creating, editing, exporting of static GTFS data for a public transit authority
Clone or download
Latest commit e642fe7 Nov 11, 2018
Permalink
Failed to load latest commit information.
.github v3.2.0 Oct 25, 2018
config v3.3.0 Nov 11, 2018
db v3.2.1 docker-testing Nov 9, 2018
export/2018-11-01-backup-1336 v3.2.1 docker-testing Nov 9, 2018
extra_files v3.0.1 Oct 1, 2018
hydcsv_related v3.2.0 Oct 25, 2018
js v3.2.1 docker-testing Nov 9, 2018
lib v2.0.0 Sep 4, 2018
logs v3.3.0 Nov 11, 2018
pw v2.0.0 Sep 4, 2018
utilities v3.2.1 docker-testing Nov 9, 2018
xml_related v2.0.0 Sep 4, 2018
.dockerignore v3.2.1 docker-testing Nov 9, 2018
Dockerfile v3.3.0 Nov 11, 2018
GTFSManager.exe v3.3.0 Nov 11, 2018
GTFSManager.py v3.3.0 Nov 11, 2018
GTFSserverfunctions.py v3.2.1 docker-testing Nov 9, 2018
LICENSE License Apr 12, 2018
MacOS_docker_install.command v3.3.0 Nov 11, 2018
MacOS_docker_run.command v3.3.0 Nov 11, 2018
Procfile v1.4.2 readme update Apr 25, 2018
README.md v3.3.0 Nov 11, 2018
agency.html v3.2.0 Oct 25, 2018
calendar.html v3.2.0 Oct 25, 2018
deleteID.html v3.0.0 Sep 19, 2018
docker_install.sh v3.3.0 Nov 11, 2018
docker_run.sh v3.3.0 Nov 11, 2018
fares.html v3.2.0 Oct 25, 2018
favicon.ico 25.4.18 v1.4.2 Apr 25, 2018
frequencies.html v3.2.1 docker-testing Nov 9, 2018
hmrl.html v3.0.0 Sep 19, 2018
hydCSV2GTFS.py v3.0.1 Oct 1, 2018
index.html v3.2.0 Oct 25, 2018
kmrl.html v3.0.0 Sep 19, 2018
linux_GTFSManager_executable v3.3.0 Nov 11, 2018
renameID.html v3.0.0 Sep 19, 2018
requirements.txt v3.2.0 Oct 25, 2018
routes.html v3.0.0 Sep 19, 2018
runtime.txt v2.0.0 Sep 4, 2018
sequence.html v3.0.0 Sep 19, 2018
shapes.html v3.2.0 Oct 25, 2018
stops.html v3.0.1 Oct 1, 2018
translations.html v3.0.0 Sep 19, 2018
tripstimings.html v3.2.0 Oct 25, 2018
win_docker_install.bat v3.3.0 Nov 11, 2018
win_docker_run.bat v3.3.0 Nov 11, 2018
xml2GTFSfunction.py v3.2.0 Oct 25, 2018

README.md

static-GTFS-manager

GTFS Manager logo

Screenshot

A browser-based user interface for creating, editing, exporting of static GTFS (General Transit Feed Specification Reference) feeds for a public transit authority.

Development Status : V 3.3.0
Download from Releases page.

  • Windows binary is available in the repo itself, just double-click GTFSManager.exe to start the program.
  • Mac, Ubuntu users can run by first installing docker, then double-clicking two scripts. See Running with Docker on any OS

Intro

This project is the result of a collaboration between WRI (World Resources Institute) and KMRL (Kochi Metro Rail Limited).

Initially developed for use by KMRL, the source code has been open-sourced so it can grow and get better with community inputs and help for creating GTFS feeds for other transit agencies too.

The GTFS data pre-loaded in the program is of Kochi Metro, Kerala, India which on March 16, 2018 became India's first transit agency to release its schedules data in the global standard static GTFS format as free and open data.

See the KMRL open data portal and some news articles: 1, 2, 3, 4.

This program adheres to the static GTFS (General Transit Feed Specification Reference) open transit data specs as published by Google Transit here: https://developers.google.com/transit/gtfs/reference/
It also implements a GTFS extension for translations of stops and routes names to facilitate multilingual use of the data.

Lead programmer up till November 2018: Nikhil VJ from Pune, India.

See this and many more GTFS related resources listed on Awesome Transit, a one-stop community listing for all things GTFS.

Demo Videos

Run on your system

Psst! Password is program.

Windows standalone executable, Double-click and Go!

  1. (Updated, Oct 2018) Download the repo, unzip, and double-click GTFSManager.exe in the main program folder. It'll have an icon.

  2. That's it, that should start the program! A dos box should open up giving console messages, and in a few seconds a new tab should open in your system's default web browser with the program loaded.

  3. There will probably be a Windows Firewall popup. Click OK or cancel.. this program doesn't do any to-and-fro communication over internet, that's just a default question that comes up when a server is activated. (In our case we're creating a portable web server for the front-end and back-end partd of the program to communicate). It does need internet for loading the background tiles on web maps, but other than that the program can run without internet connection.

  4. More notes on this, including some troubleshooting and watchouts, on the wiki.

On Ubuntu / Linux OS, on Python 3

See on the project wiki: Running on Ubuntu OS

Running on Windows on Python 3

See on the project wiki: Running on Windows OS with Python 3

Running in Docker on all OS's (including Mac)

See Running with Docker on any OS

Changing the password

See on the project wiki: Changind the password


GTFS feed Export

The end output of this program is a gtfs.zip file having your transit agency's static GTFS data. See the Commit and Export GTFS section on the main page for the same.

GTFS feed Import

From the main page, you can import your GTFS feed in a .zip file. Structure of a feed zip must be as per standard GTFS specs.

gtfs.zip
 ˪ stops.txt
 ˪ routes.txt
 ˪ trips.txt
 ˪ stop_times.txt
 ˪ ...

Some requirements, s'il vous plait !

  1. Keep all your files with lowercase .txt extension
  2. Keep them up at root level in the zip archive, not inside any folders.
  3. The table in stop_times.txt must be sorted by trip_id (you can open it in LibreOffice, or rename as .csv and open in Excel) before importing.
  4. Similarly, the table in shapes.txt must be sorted by shape_id before importing.

Kindly validate your GTFS zip prior to importing so you know in advance if there are any issues with the feed. And no worries, this tool is made FOR fixing bad feeds, the system will import whatever you give it. If you need to delete a lot of junk data in the feed, the Tools > Delete ID section will be your favorite place to be.

In the import process, the program creates a backup ZIP of the current data and then imports your data into its database. You can see the backup listed later on under Past Commits section on the home page.


Improvements, Feedback

Please see the Issues section for seeing existing program improvement efforts, feedback, questions. Please make sure you search through all the issues (click here for full list) before filing a new one : it might already be covered in another.

Invitation: This project invites active participation from professionals in the coding and GTFS fields to join in to take it forward. Please feel free to fork, write your fixes/enhancements and submit a pull request.

Known limitations

  • Shapes are only accepted in .geojson format. The first entry in the file will be picked up and others will be discarded.
  • Extra files that are optional : If you've imported it, it'll be there in the DB, and will be there in the feed when you export again. Code contributions welcome in that regard.

Technical Overview

Moved to Wiki: Technical Overview


Gratitude for open source solutions

This project stands on the shoulders of several solutions that have been shared open source. Sharing mentions below.

Open source libraries used on Javascript side :

  • Leaflet.js and its various plugins for plotting information on maps and keeping things interactive
  • Tabulator.js for handling data in tabular form at the front-end
  • Bootstrap for general page design
  • Jquery and Jquery UI for UI components like accordions, event handlers and file upload.
  • Papa.parse for CSV parsing
  • Chosen.js for search-as-you-type dropdowns

Open source libraries used on Python side :

  • tornado for simple web server with asynchronous callback
  • pandas for handling practically all the data to-and-fro, and for very efficient functions like unpivoting.
  • HDF5 format support (tables) for enabling pandas to work with high compression and high read/write speed .h5 format files.
  • tinyDB for portable JSON database
  • pycryptodomex for providing password encryption without the hiccups
  • Many python modules for various operations: json, os, time, datetime, xmltodict, collections, zipfile, webbrowser, pycrptodomex, shutil, pathlib, math, json.decoder

Many snippets

In addition to this, there are several code snippets used throughout the program that were found from online forums like stackoverflow and on various tech blogs. The links to the sources of the snippets are mentioned in comments in the program files. Here is a shoutout to all the contributors on these forums and blogs : Thank You!

Personal mentions

Big thanks to :

  • Srinivas from Hyderabad, India for connecting folks together and sharing guidance
  • Devdatta from Pune, India for a sharing a very simple working example to learn about Tornado web server serving asynchronous requests
  • Tony Laidig from the global GTFS community for helping build a docker image
  • Sean Barbeau and other co-ordinators of the GTFS community for including this program on Awesome Transit and giving encouragement and feedback on the GTFS forum.