README.md

Routemaster

Route generator software for CHIditarod

Warning, this code is uggggly. Somehow, every year, I'm able to get it to run. YMMV.

Basically it is a traveling salesman solver. There is a starting line, a finish line, and a configurable amount of checkpoints in-between. You first add the various checkpoints, add the distances between them all, set a few params like # of teams, the # of checkpoints, etc, then hit go, and it figures out the best routes.

The codebase is written in Python, and it uses an old version of the Django web framework.

To Install

Read INSTALL.md

Usage

1. Activate the python virtual environment

    cd path/to/routemaster/repo
    . ~/.python/Virtualenvs/routemaster/bin/activate 
   

2. Run Locally

    python manage.py runserver
   

3. Visit URLs

   • http://localhost:8000/admin - Configure the races, checkpoints, etc
   • http://localhost:8000/races - Run the calculations

TODO

Rewrite this in something fun.

etc

How to install a new pip module

$ bin/pip-install

Run Local Django Console

cd path/to/routemaster
python manage.py shell

print settings

from django.conf import settings
print settings.<tab>

Users

devin / mush