Lots of additional doc strings in panoptes.py.  Tried to add a description of what conditions need to be met in each state and what needs to be met to transition to another state.  This is a rough draft and is probably full of errors and definitely needs proofreading.