map sizes and documentation

 * map size parameters automatically set for nbviewer
 * docstrings added