No description, website, or topics provided.
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A database of the built environment in Chicago using open data, forked from Edifice

Installation and dependencies

  • PostgreSQL (9.0.x or later; 9.1.x+ preferred)
  • PostGIS (2.0.x or later)
  • Python (2.7.x or later)

Using pip:

pip install -r requirements.txt

Using easy_install:

easy_install wget
easy_install psycopg2
easy_install PyYAML

Copy over the example setup.cfg:

cp setup.cfg.example setup.cfg

Using is used to recreate the benefice database on a system with a PostgreSQL database installed (with PostGIS 2.0.x+ support).

Drop and recreate from scratch a base_postgis template database, using the 'postgres' admin user.

python --create_template

Drop and recreate from scratch an benefice database struture, using the 'benefice' user.

python --create

Download (~165mb), unzip, and import City of Chicago data into the benefice database. [NOTE: WORK IN PROGRESS]

python --data

Optional flags:

  • --bindir [DIRNAME]: specify the location of PostgreSQL binaries such as pg_config, psql, etc.
  • --user [USERNAME]: use a username other than 'benefice' as the owner of the main database.
  • --database [DBNAME]: use a name other than 'benefice' for the main database.
  • --delete_downloads: delete downloaded zip and csv files after import
  • --help: provide usage info

Data Sources

Google Doc of data sources we are using

QGIS and TileMill

Once you are done setting up your Benefice database, you can use the following tools (including psql) to explore the datasets.

QGIS is a free, open-source GIS application that can connect directly to a PostGIS database and display and analyze geographic data.

TileMill is a map-design studio that can also connect directly to a PostGIS datastore and create interactive web maps using OpenStreetMap as the base layer.