brianolson/redistricter

This is Open Source software to create impartial optimally compact district maps for US State Legislatures and Congressional districts.

Results can be seen here:
http://bdistricting.com/2010/

And with analysis of partisan outcomes models here:
https://projects.fivethirtyeight.com/redistricting-maps/#algorithmic-compact


DEPENDENCIES:
	C++ compiler (GCC or CLANG)
	Java 1.8+
	Python 3.6+
	Go 1.16+
	png library
	zlib compression library
	google protocol buffers http://code.google.com/p/protobuf/

BUILDING:

There's no ./configure because autoconf is hard. :-(

Instead, Makefile includes makeopts/`uname`.pre early on to set variables. See the Darwin and Linux examples.

So, if you're lucky, all you have to do is:
	make all

There is no `make install` because this is a tool for an experimenter. The binaries just live here where they're compiled.

If you want to leave makeopts/* alone, create a file localvars.make which gets included after that and before anything else. A good place to put your own settings.



RUNNING:

Setup a python environment:

# your Python version may vary, run `python3 --version` to check
python3 -m venv ve
# this assumes bash or sh-like shell, to source a script into your session
. ve/bin/activate
pip install -r python/requirements.txt
(cd python && pip install -e .)

Make a directory, which I traditionally call "data", to hold the Census data, and fetch a state of data into it, run preprocessing:

mkdir data
./bin/setupstatedata --data=data CT

Run from local data:

(cd runner && make)
runner/runner -data data -http :8080

The -http argument is optional, but runs a handy HTTP server on that port (e.g. http://localhost:8080/ ) which nicely displays status and results.

Lots of other options are available on both ./setupstatedata and runner/runner and there is --help available for them.


---
* Setting up protobuf
# Here's the cheat sheet for building this quickly.
./configure

# then build C and optionally python
make
make check
sudo make install

# while Python virtual environment setup above is active:
cd ../python
python setup.py test
python setup.py install


DEVELOPMENT:

data.txt description of files and data bundles involved in running the system