updated documentation and plots