added documentation, improved plot readability (questionablegm)