fixes to plotting functions and documentations