Skip to content

mrcagney/gtfs_kit

Repository files navigation

GTFS Kit

GTFS Kit is a Python library for analyzing General Transit Feed Specification (GTFS) data in memory without a database. It uses Pandas and GeoPandas to do the heavy lifting.

Installation

Install it from PyPI with UV, say, via uv add gtfs_kit.

Examples

In the Jupyter notebook notebooks/examples.ipynb.

Authors

  • Alex Raichev (2019-09), maintainer

Documentation

The documentation is built via Sphinx from the source code in the docs directory then published to Github Pages at mrcagney.github.io/gtfs_kit_docs.

Notes

  • This project's development status is Alpha. I use GTFS Kit for work and change it breakingly to suit my needs.
  • This project uses semantic versioning.
  • I aim for GTFS Kit to handle the current GTFS. In particular, i avoid handling GTFS extensions. That is the most reasonable scope boundary i can draw at present, given this project's tiny budget. If you would like to fund me to expand that scope, feel free to email me.
  • Thanks to MRCagney for periodically donating to this project.
  • Constructive feedback and contributions are welcome. Please issue pull requests from a feature branch into the develop branch and include tests.
  • GTFS time is measured relative noon minus 12 hours, which can mess things up when crossing into daylight savings time. I don't think this issue causes any bugs in GTFS Kit, but you and i have been warned. Thanks to user derhuerst for bringing this to my attention in closed Issue 8.
  • I'll probably remove the GTFS validation module validators.py to avoid duplicating the work of what is now the canonical feed validator (written in Java).