Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/associatedpress/geomancer

Open source tool to help journalists easily mash up data based on shared geography.
https://github.com/associatedpress/geomancer

Last synced: 5 days ago
JSON representation

Open source tool to help journalists easily mash up data based on shared geography.

Host: GitHub
URL: https://github.com/associatedpress/geomancer
Owner: associatedpress
License: mit
Archived: true
Created: 2014-07-17T21:10:46.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2015-06-05T15:28:10.000Z (over 9 years ago)
Last Synced: 2024-08-02T12:46:53.980Z (3 months ago)
Language: Python
Homepage:
Size: 1.75 MB
Stars: 59
Watchers: 25
Forks: 12
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-starred - associatedpress/geomancer - Open source tool to help journalists easily mash up data based on shared geography. (others)

README

# Geomancer

Geomancer is a project with a simple goal: to create a prototype tool that will help journalists easily mash up data based on shared geography. It’s such a common task for data-savvy journalists that it’s easy to underestimate the difficulty. But on deadline, it can become daunting. It requires locating the right data set to provide context, getting it into shape and into place to join it with the data in hand and then merging the two data sets — all before the reporter can even get started with the analysis.

We aim to take some of that complexity out of the way by providing an intuitive interface to discover available data sets for a given geography and supplement the data in hand with the relevant values. We’ll know it’s working when it appears too easy.

Read more: [AP wins Knight grant to build data journalism tool](http://www.ap.org/content/press-release/2013/ap-wins-knight-grant-to-build-data-journalism-tool)

### Setup

**Install OS level dependencies:**

* Python 2.7
* [Redis](http://redis.io/)
* libxml2
* libxml2-dev
* libxslt1-dev
* zlib1g-dev

**Install app requirements**

We recommend using [virtualenv](http://virtualenv.readthedocs.org/en/latest/virtualenv.html) and [virtualenvwrapper](http://virtualenvwrapper.readthedocs.org/en/latest/install.html) for working in a virtualized development environment. [Read how to set up virtualenv](http://docs.python-guide.org/en/latest/dev/virtualenvs/).

Once you have virtualenvwrapper set up,

```bash
mkvirtualenv geomancer
git clone https://github.com/associatedpress/geomancer.git
cd geomancer
pip install -r requirements.txt
cp geomancer/app_config.py.example geomancer/app_config.py
```

NOTE: Mac users might need this [lxml workaround](http://stackoverflow.com/questions/22313407/clang-error-unknown-argument-mno-fused-madd-python-package-installation-fa).

Afterwards, whenever you want to work on geomancer,

```bash
workon geomancer
```

### Running Geomancer

There are three components that should be running simultaneously for the app to work: Redis, the Flask app, and the worker process that appends to the spreadsheets. For debugging purposes, it is useful to run these three processes in separate terminal sessions.

``` bash
redis-server # This command may differ depending on your OS
python runworker.py # starts the worker for processing files
python runserver.py # starts the web server
```

Open your browser and navigate to `http://localhost:5000`

## DataMade Team

* [Eric van Zanten](https://github.com/evz)
* [Cathy Deng](https://github.com/cathydeng)
* [Derek Eder](https://github.com/derekeder)

## Errors / Bugs

If something is not behaving intuitively, it is a bug, and should be reported.
Report it here: https://github.com/associatedpress/geomancer/issues

## Note on Patches/Pull Requests

* Fork the project.
* Make your feature addition or bug fix.
* Commit, do not mess with version or history.
* Send a pull request. Bonus points for topic branches.

## Copyright