enmodal is a browser-based service for transit planning and analysis. users can quickly mockup transit services (or “scenario plan” modifications to real-world systems) in their browser. enmodal runs server-side modeling algorithms to analyze the impact of different service modifications, using population and employment data.

Skip to: Windows, Mac, Ubuntu

Download this repository as a ZIP file (see Download options above) and unzip to a directory called enmodal. Alternatively, install Git and clone the repository:

git clone https://github.com/jpwright/enmodal.git

Install PostgreSQL with PostGIS functionality. I recommend following this tutorial.

Make note of the password you set for the admin (postgres) account.

Copy settings.cfg.example to a new file called settings.cfg, and open that file for editing. Most fields can be left at their default values, except:

• Set the sessions database password based on whatever you chose in the previous step.
• If you want support for reverse geocoding, you'll need to set up an account with either Mapbox or Google and supply an API key. (The Mapzen API is no longer functional.)

Install Python 2.7 using the Windows installer, or other distribution of your choice.

Make sure to select "Add Python to system PATH" when installing.

Open Command Prompt and navigate to the enmodal directory. (If you are unfamiliar with navigating directories in Command Prompt, an easy way to do this is to open the enmodal directory in Explorer, then in the field that shows you the folder path, type cmd and hit Enter.)

Run the following commands to set up the Python environment:

pip install virtualenv
virtualenv venv
venv\Scripts\activate.bat
pip install -r requirements.txt

Leave Command Prompt open as you'll need it future steps.

In your Command Prompt window:

"C:\Program Files\PostgreSQL\10\bin\createdb" -U postgres dggrid
"C:\Program Files\PostgreSQL\10\bin\createdb" -U postgres sessions
"C:\Program Files\PostgreSQL\10\bin\psql" -U postgres -d dggrid -c "CREATE EXTENSION postgis;"

Use the password you set during PostgreSQL installation when requested.

In the same Command Prompt window, run:

python tools\set_up_db.py

python server.py

Navigate to http://localhost:5050 in your browser and get started!

Download this repository as a ZIP file (see Download options above) and unzip to a directory called enmodal. Alternatively, install Git and clone the repository:

git clone https://github.com/jpwright/enmodal.git

Note: enmodal requires python 2.7 and is not compatible with python 3. Fortunately, your Mac comes with a copy of python 2.7 installed, so you're good.

Open up a Terminal, navigate to the directory in which you unzipped enmodal (recommend this tutorial if navigating through directories in Terminal is unfamiliar to you), and run the following commands:

sudo easy_install pip
sudo pip install virtualenv

virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

Recommend using Postgres.app to accomplish this.

Install Postgres.app and open the application. Click "Initialize" then "Start" to start the Postgres server. Double click on any of the databases shown in the window.

A terminal window should appear. Run these commands:

CREATE DATABASE sessions;
CREATE DATABASE dggrid;

Now close the window and double click on the "dggrid" database that appears. Run these commands:

CREATE EXTENSION postgis;
CREATE EXTENSION postgis_topology;

Copy settings.cfg.example to a new file called settings.cfg. Most fields can be left at their default values, except:

• Set the dggrid user to your macOS username (this is the default value if you used Postgres.app)
• Set the dggrid password to be blank (this is the default value if you used Postgres.app)
• Set the sessions user to your macOS username (this is the default value if you used Postgres.app)
• Set the sessions password to be blank (this is the default value if you used Postgres.app)
• If you want support for reverse geocoding, you'll need to set up an account with either Mapbox or Google and supply an API key. (The Mapzen API is no longer functional.)

In your original Terminal window:

python tools/set_up_db.py

python server.py

Navigate to http://localhost:5050 in your browser and get started!

git clone https://github.com/jpwright/enmodal.git && cd enmodal

Note: enmodal requires python 2.7 and is not compatible with python 3.

sudo apt-get install python-setuptools python-dev build-essential
sudo easy_install pip
sudo pip install --upgrade virtualenv

pip install virtualenv
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

sudo add-apt-repository "deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main"
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install postgresql-9.6
sudo apt-get install postgresql-server-dev-9.6
sudo apt-get install postgresql-9.6-postgis-2.3 postgresql-9.6-postgis-scripts

sudo su -
sudo -u postgres psql postgres

Then within the psql command:

\password postgres

Set a password and use it in your settings.cfg file below.

Copy settings.cfg.example to a new file called settings.cfg. Most fields can be left at their default values, except:

• Set the sessions database password based on whatever you chose in the previous step.
• If you want support for reverse geocoding, you'll need to set up an account with either Mapbox or Google and supply an API key. (The Mapzen API is no longer functional.)

python tools/set_up_db.py

sudo -u postgres psql -c "CREATE EXTENSION postgis; CREATE EXTENSION postgis_topology;" dggrid

sudo apt-get install nodejs-legacy npm
npm install grunt grunt-contrib-jshint grunt-contrib-watch grunt-contrib-copy grunt-contrib-concat grunt-contrib-uglify --save-dev
sudo npm install -g grunt-cli
sudo npm install
grunt --force

python server.py

Navigate to http://localhost:5050 in your browser and get started!

Generating the dggrid database (which contains the hexagonal bins of population and employment data) is cumbersome and not yet documented. A copy of the database will eventually be made available for download. The scripts to generate the database yourself are in the tools directory.