datamade/erikson-edi

Name: erikson-edi

Owner: datamade

Description: Interactive visualization for Erikson Institute to showcase, explore and share data collected from the Early Development Instrument (EDI)

Created: 2018-01-22 15:46:40.0

Updated: 2018-05-21 15:14:41.0

Pushed: 2018-05-18 20:56:38.0

Homepage: null

Size: 4964

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Erikson Early Development Instrument

An interactive visualization for Erikson Institute to showcase, explore and share data collected from the Early Development Instrument (EDI).

Setup

OS-level dependencies

Erikson EDI requires the following packages be installed on your operating system:

• Posix environment (macOS or Linux)
• Python 3
• PostgreSQL
• PostGIS
• Redis

Python requirements

Install Python requirements with pip:

install -U -r requirements.txt

Configs

Start by copying the example local settings file to the correct location:

di/settings_local.example.py edi/settings_local.py

You'll need to adjust a few variables for everything to work properly, including:

• GOOGLE_API_KEY (for geocoding in the admin interface)
• DATABASES (make sure the config matches your local DB)
• CELERY_BROKER_URL (the URL to access your Celery broker – we use Redis)

If you're on the Blackbox keyring for this repo, you can copy our Google API key from the configs directory:

kbox_cat configs/keys.py.gpg

Making the database

Create a new database for the app:

tedb edi

The database requires PostGIS, but the first migration takes care of setting up the extension for you. Run migrations:

on manage.py migrate

Make a superuser for your app so that you can access the admin interface:

on manage.py createsuperuser

Data imports

To view the data visualizations in this app, you'll need some EDI data in your database. The management commands that import data into this app expect that data to live in a directory called /data at the root level of this repository. Unfortunately, this data is restricted to DataMade staff members only, so it lives in a separate, private repo.

If you have access to that repo, copy it over from the private repo into the /data directory in this app. Next, use the management commands to import data and geographies for the app:

on manage.py import_data
on manage.py import_geographies

Running the app

Run the app with Django's standard management command:

on manage.py runserver

To upload data through the admin interface, you'll also need to run a Celery instance in a separate shell:

ry -A edi worker -l debug