restore outcommented example tests

see Test/Examples/CMakeLists.txt

added Example test labels

mentioned in issue #243 (closed)

mentioned in commit 08d0dc03

mentioned in merge request !792 (merged)

mentioned in commit 44e8b10b

closed with merge request !792 (merged)

Status after closing:

Brief update on examples and their test coverage:

• I have been working on Python scripts in directory Examples, subdirectories ff, scater2d, specular, varia. Coverage of fit-related subdirectories is postponed (#260 (closed)).
• Almost all examples now use bp.parse_args to process command-line arguments. This allows us to overwrite behavior when running the scripts from ctest or make figures.
• Tests/Examples/CMakeLists.txt provides two levels of testing:
  • run_example checks whether a script runs through. This includes execution of all matplotlib commands except the final plt.show(). Under CI, the entire plot section of the script can be skipped if the environment variable NOPLOT is set.
  • test_example additionally stores simulated data to .int.gz files, and compares them to reference data in Tests/ReferenceData/ExamplesMini
• The command make figures regenerates all figures in hugo/static/img/auto.
  • In the doc pages, these figures are typically included using our shortcode figscg, like in {{< figscg src="/img/auto/specular/AlternatingLayers.png" width="500" class="center">}}. I suspect this can be replaced by the direct html tag img src="/img/auto/specular/AlternatingLayers.png" width="60%".
• Some work remains to be done.
  • Figures with multiple plot frames, or multiple curves in one frame, are done in very different, and mostly very complicated, ways. This needs to be simplified, then standardized. Simulation needs to be decoupled from plotting.
  • The interplay of direct matplotlib commands and our own commands from ba_plot is somewhat unclear. None of the remaining work is urgent. What's important is that we have ensured reproducibility of all figures in the webdocs.