documented the notebook and code.  Included TODOs.
TODO: look into plotting display issue