Skip to content

Running on Ubuntu OS

Jump to bottom
Nikhil VJ edited this page Apr 25, 2018 · 11 revisions

  1. Open Terminal (linux command prompt) and clone this repo to your side:
    git clone https://github.com/WRI-Cities/static-GTFS-manager.git

  2. Navigate into the folder created.
    cd static-GTFS-manager

  3. Install virtualenv in your system if not already installed:
    pip install virtualenv --user

  4. Initiate a python3 virtual environment in /tmp and install the dependencies there

virtualenv -p python3 /tmp/VIRTUAL
source /tmp/VIRTUAL/bin/activate
which python3

  1. Last command shows from where the current python environment is running. It should come as /tmp/VIRTUAL/bin/python3

  2. Set pip package installer to 9.0.3 version. This is a temporary workaround because the latest one (10.0.1) has been observed to fail at installing pandas module in some systems. Around June 2018 onwards please skip this step; I expect things will be solved by then. If the next step doesn't work, come back here and try this.
    pip3 install pip==9.0.3

  3. Install the required python dependencies, in the virtual environment where it will not interfere with you system's main python: pip install -r requirements.txt

  4. Run GTFSManager.py in python3:
    python3 GTFSManager.py

  5. The program should load in a new web browser tab. You can now operate the program from your web browser. In case it doesn't load up, see the terminal for the URL, it is most likely http://localhost:5000/ or so.

  6. See the terminal for instructions and reporting of various processes. There are some recurring warnings which you can ignore, like WARNING:tornado.access:404 GET /favicon.ico (::1) 1.35ms

Note: there is a password input box at top right corner. It's a basic idiot-proofing measure. For any operation involving editing, import or export of data, the password should be typed in. Please scroll down to find ways to change the password or work around it.

Closing:
11. The program will keep running while you operate on the browser. To terminate the program, come back to the Terminal and press Ctrl+C or close the window.

  1. To get out of the python3 virtual environment, run: deactivate. To get back in, run source /tmp/VIRTUAL/bin/activate.

Note: During this whole time, we did create a virtual environment at /tmp/VIRTUAL/ but in the Terminal we stayed at the program's working folder only. We didn't navigate anywhere else.

All commands together

git clone https://github.com/WRI-Cities/static-GTFS-manager.git
cd static-GTFS-manager
pip install virtualenv --user
virtualenv -p python3 /tmp/VIRTUAL
source /tmp/VIRTUAL/bin/activate
which python3
pip3 install pip==9.0.3
pip install -r requirements.txt
python3 GTFSManager.py

After closing:
deactivate

Clone this wiki locally