code improvements (comments, better logging)

8 jobs for 241-new-flag-to-compute-metric-for-the-quality-of-the-stepcircleoptimizer in 120 minutes and 2 seconds (queued for 2 seconds)