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