consistency fixes and completed the experiment section. fixes #32