Mono bent complex string parsing

[Lomholy]

Free-form text area

Please describe what your PR is adding in terms of features or bugfixes:

Monochromator_bent_complex is updated regarding the changes to the parameter "plane_of_reflections". This is reflected in updates to the header as well. Other minor beauty changes are performed in the header, such as a mu being rendered with html char now, and linking to the article on monochromator_bent.

The plane_of_reflection parameter could previously only be a string of planes, delimited by a semicolon between each plane. With this update, the option of having a single plane of reflection for all crystals is added. E.g. a three crystal array could previously only be instantiated with <plane_of_reflection = "Si111;Si111;Si111"> but now it can also be instantiated by <plane_of_reflection = "Si111">.

---

Development OS / boundary conditions

Please describe what OS you developed and tested your additions on, and if any special dependencies are required:
Developed on MacOS Tahoe 26.3.1, and no special dependencies are required.

---

PR Checklist for contributing to McStas/McXtrace

For a coherent and useful contribution to McStas/McXtrace, please fill in relevant parts of the checklist:

• My contribution includes patches to an existing component file

  • I have used the mcdoc utility and rendered a reasonable documentation page for the component (please attach as screenshot in comments!)
  • I have ensured that basic use of the component is OK (e.g. an instrument using it compiles?)
  • I have used the mctest utility to test one or more instruments making use of the component (please attach mcviewtest report as screenshot in comments)
  • I have used the mccode-clangformat tool to apply the standard McCode component indentation scheme
  • I have used the mcrun --c-lint "linter" and followed advice to remove most / all warnings that are raised

• My contribution includes patches to an existing instrument file

  • I have used the mcdoc utility and rendered a reasonable documentation page for the instrument (please attach as screenshot in comments!)
  • I have used the mctest utility to test the instrument (please attach mcviewtest report as screenshot in comments)
  • I have used the mcrun --c-lint "linter" and followed advice to remove most / all warnings that are raised

---

[Lomholy]

There seems to be an error with the micro meter being parsed into the Description:

[Lomholy]

Test instrument mcdoc:

[willend]

I have no issue with micro meter here:

[Lomholy]

Ah yes it seems that I was using a slightly old version of McStas, and this what what caused it (Probably recent changes to the parsing tools). I now have no problem with micrometer:

[willend]

Don’t do that. ;-) Make a dedicated mcstas-dev conda env and make it routine to simply roll a new McStas for all the testing. Use the in-repo dev tools. :-)

[Lomholy]

I suppose you are right, and that is the proper way to do it. I will do it in the future, but currently I am in a bit of a phase where I am not quite comfortable with the whole conda dev and rolling out new McStas' whenever something should be tested 😅

[Lomholy]

I made a dedicated mcstas-dev conda env and rolled a new mcstas for testing as you suggested.

Then I ran mctest with:
mctest --comp=Monochromator_bent_complex --testdir=tmp

But the Test instrument Test_Monochromator_bent_complex.instr should have two tests to my mind (There are two %Examples), however only 1 is run:

[willend]

I think you might be picking up an older/earlier version?

I at least get both here:

mctest --instr=Test_Monochromator_bent_complex.instr
loading system configuration
Output of test will be placed in: /Users/peterwillendrup/tmp/mcstas-test_20260410_1130_23/
ncount is: 1e6
Testing: 3.99.99

Finding instruments in: /Users/peterwillendrup/micromamba/envs/mcstas-dev/share/mcstas/resources/examples
Copying instruments to: /Users/peterwillendrup/tmp/mcstas-test_20260410_1130_23/mcstas-3.99.99_Test_Monochromator_bent_complex.instr_Darwin

Compiling instruments [seconds]...
Test_Monochromator_bent_complex :   3.05

Running tests / getting status...
Test_Monochromator_bent_complex  :  19.63    [val: 0.000215074 / 0.000215194 = 100 %]
Test_Monochromator_bent_complex_2:  19.61    [val: 0.000215074 / 0.000215194 = 100 %]
======================================
Overall test result:
SUCCESS

[willend]

And the same is the case if you look within the “passed checks”, e.g. mcstas-conda-basictest:
https://github.com/mccode-dev/McCode/actions/runs/24234925832/job/70755008814?pr=2395, expanding the section “Check for changed instruments” and scroll toward the end:

[willend]

@Lomholy I think the state of the PR is good. Let me know if anything is still pending or you feel ready for me to push merge.

[Lomholy]

I was looking at an older version. I don't have anything pending, so you can go ahead and merge. Thank you for the help with this!