update docstrings
add experiment-specific cli options

--HG--
extra : amend_source : 6a71476c5a3c8244dd7df9d31d6b458b03a62629
export options and tests

--HG--
extra : amend_source : ff1a3d1af6f0b54f42b1cd7c456dcfec5365d114
tests and tweaks