updates to torus model: making things more configurable, cleaning up some code and adding instructions and common errors in README