A tool for public transit planners to help them visualize and better understand their networks.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
images
src
.gitignore
README.md

README.md

Team Me0w

Every day public transit networks (PTNs) play a critical role in the lives of millions of people. Because of their importance, one developing trend is the use of numerical graph methods in order to examine different aspects of a PTN, such as equity, transit frequency, and vulnerability. Our team hopes to help public transit planners by providing a free, user-friendly web application for analyzing PTNs based on publicly available GTFS data. Besides providing users with the ability to build aggregate networks from multiple transit types (e.g., combining Caltrain, BART, and Muni), Transitcat also makes it easy to visualize them and understand real-world usability through the use of isochrone maps. We're just three cat lovers hoping to improve the world, one public transit stop at a time.

Getting Transitcat Running

You'll need to follow these steps once to set up the project:

  1. Download a local copy of this entire repository. Be sure to follow the instructions for setting up your directory structure.
  2. Install Postgres on your machine. An easy way to do this is using Homebrew with the command brew install postgres.
  3. In your Terminal, run the commmand postgres -D /usr/local/var/postgres to start Postgres.
  4. In a new Terminal tab/window, open the Postgres prompt by typing psql. Next create your user using the username and password of your choice by typing CREATE USER sample_user WITH PASSWORD 'sample_password';. Finish by typing CREATE DATABASE transitcat WITH OWNER sample_user;, which creates a database called transitcat and gives your user access. Exit by typing /q.
  5. Update your settings.py file so that Transitcat can find your database. Scroll down to the section that says:
DATABASES = {
    "default": {
    "ENGINE": "django.db.backends.postgresql_psycopg2",
    ...

Replace "YOUR_USERNAME_HERE" and "YOUR_PASSWORD_HERE" with the values you assigned to your Postgres user.

  1. Navigate to the directory containing manage.py and run the following command: python manage.py migrate.
  2. Apply for free, personal API keys for Yelp and Google Maps.
  • Add your Yelp API key to yelp.py. Do so by scrolling down to the section that says:
# TODO: Uncomment the line below and add your Yelp API key.
# HEADERS={"Authorization":"Bearer YOUR_KEY_HERE"}
<script async defer
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY_HERE&callback=initMap">
</script>

Now every time you want to run Transitcat, simply do the following:

  1. In your Terminal, run the commmand postgres -D /usr/local/var/postgres.
  2. In a new Terminal tab/window, navigate to the directory containing manage.py and run the following command: python manage.py runserver.
  3. Point your web browser to http://127.0.0.1:8000/snapData/, and you're off!

Team Members

Member Photograph Email
Aaron Aquino (aaron33) Aaron Aquino aquino@cs.stanford.edu
Tracey Lin (traceyl) Tracey Lin traceylin@alumni.stanford.edu
Erik Raucher (eraucher) Erik Raucher eraucher@yahoo.com