Issue209 pump records: added validation model documentation and figure

Also made 'per' replaceable.

Please let me know in case of any remarks!