refactored and standardised reporting - added tutorial and example notebooks with complimentary scripts