comments and calibration

Signed-off-by: Owen Harris <owenllharris@gmail.com>