finished comparison plot, added docs and examples