mccode-dev · willend · Sep 10, 2026 · Sep 10, 2026 · Sep 10, 2026 · Sep 10, 2026
diff --git a/CHANGES_McStas b/CHANGES_McStas
@@ -64,13 +64,13 @@
 * Modified by: PW May 2026: version 3.7.1
 * Modified by: PW June 2026: version 3.7.6
 * Modified by: PW June/July 2026: version 3.7.9
-* Modified by: PW September 2026: version 3.8.2
+* Modified by: PW September 2026: version 3.8.3
 *
-* This file is part of McStas 3.8.2, released September 10th 2026.
+* This file is part of McStas 3.8.3, released September 11th 2026.
 * It gives a 'changes' list from the beginning of the project
 *
 *******************************************************************************/
-Changes in McStas/McXtrace 3.8.2
+Changes in McStas/McXtrace 3.8.3
 
 *Covers everything since the last full release, 3.7.9 (July 2, 2026), including all changes already shipped quietly via the intermediate conda-forge releases 3.7.10–3.7.25, and a ground-up rewrite of the McStas/McXtrace manuals.*
 
@@ -159,7 +159,7 @@ Changes in McStas/McXtrace 3.8.2
 * @mads-bertelsen-agentic made their first contribution in #2624
 * @MilanKlausz made their first contribution in #2638
 
-**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.2
+**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.3
 
 
 Changes in McStas/McXtrace 3.7.9, July 2nd, 2026

diff --git a/CHANGES_McXtrace b/CHANGES_McXtrace
@@ -15,7 +15,7 @@
 *
 * Documentation: CHANGES_McXtrace
 *************************************************************************/
-Changes in McStas/McXtrace 3.8.2
+Changes in McStas/McXtrace 3.8.3
 
 *Covers everything since the last full release, 3.7.9 (July 2, 2026), including all changes already shipped quietly via the intermediate conda-forge releases 3.7.10–3.7.25, and a ground-up rewrite of the McStas/McXtrace manuals.*
 
@@ -104,7 +104,7 @@ Changes in McStas/McXtrace 3.8.2
 * @mads-bertelsen-agentic made their first contribution in #2624
 * @MilanKlausz made their first contribution in #2638
 
-**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.2
+**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.3
 
 
 Changes in McStas/McXtrace 3.7.9, July 2nd, 2026

diff --git a/INSTALL-McStas/Docker/README.md b/INSTALL-McStas/Docker/README.md
@@ -1,4 +1,4 @@
-# Running McStas and McXtrace 3.8.2 in Docker / podman etc.
+# Running McStas and McXtrace 3.8.3 in Docker / podman etc.
 
 The container definition is available at [here](https://github.com/willend/jupyter-remote-desktop-proxy/tree/mcstas-mcxtrace-3.5) and is further on dockerhub under docker.io/mccode/mcstas-mcxtrace
 

diff --git a/INSTALL-McStas/Linux/README.md b/INSTALL-McStas/Linux/README.md
@@ -1,4 +1,4 @@
-# Install McStas 3.8.2 on Linux and Unix.
+# Install McStas 3.8.3 on Linux and Unix.
 
 * We provide Debian packages for `x86_64` an `arm64` and recommend our
 	[conda-forge](../conda/README.md) install mechanism for any other platform.

diff --git a/INSTALL-McStas/Linux/debian/README.md b/INSTALL-McStas/Linux/debian/README.md
@@ -1,4 +1,4 @@
-## Install McStas 3.8.2 On Debian class systems (including Ubuntu, mint etc.):
+## Install McStas 3.8.3 On Debian class systems (including Ubuntu, mint etc.):
 The packages have been tested to work correctly on Ubuntu 24.04.
 
 # Add the McCode repository
@@ -29,7 +29,7 @@ mcstas-tools-python-mcplot-pyqtgraph - python-tools-mcplot-pyqtgraph built using
 mcstas-tools-python-mcrun - python-tools-mcrun built using CMake
 ```
 The meta-package mcstas-suite-python (or mcstas-suite-python-ng)
-allows you to install mcstas 3.8.2 with tools (mcrun/mcplot etc.) by
+allows you to install mcstas 3.8.3 with tools (mcrun/mcplot etc.) by
 the simple apt-get command
 ```bash
 sudo apt-get install mcstas-suite-python

diff --git a/INSTALL-McStas/README.md b/INSTALL-McStas/README.md
@@ -1,4 +1,4 @@
-# Installation instructions for McStas 3.8.2
+# Installation instructions for McStas 3.8.3
 
 For a description of the release changes please consult the [McCode release notes](RELEASE_NOTES.md)
 

diff --git a/INSTALL-McStas/RELEASE_NOTES.md b/INSTALL-McStas/RELEASE_NOTES.md
@@ -1,4 +1,4 @@
-Changes in McStas/McXtrace 3.8.2
+Changes in McStas/McXtrace 3.8.3
 
 *Covers everything since the last full release, 3.7.9 (July 2, 2026), including all changes already shipped quietly via the intermediate conda-forge releases 3.7.10–3.7.25, and a ground-up rewrite of the McStas/McXtrace manuals.*
 
@@ -87,4 +87,4 @@ Changes in McStas/McXtrace 3.8.2
 * @mads-bertelsen-agentic made their first contribution in #2624
 * @MilanKlausz made their first contribution in #2638
 
-**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.2
+**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.3
diff --git a/INSTALL-McStas/Windows/README.md b/INSTALL-McStas/Windows/README.md
@@ -1,4 +1,4 @@
-# Installation of McStas 3.8.2 on Windows 64 bit Intel systems (some support for arm64)
+# Installation of McStas 3.8.3 on Windows 64 bit Intel systems (some support for arm64)
 ## *IMPORTANT: active internet connection required during installation*
 
 ###Please use either of:###
@@ -11,17 +11,17 @@
 
 **OPTION 2: New MSVC-bundle solution:**
 * As **Administrator**, run our new  [`install_msvc_for_conda.bat`](install_msvc_for_conda.bat) batch script to install MSVC and required packages to your system. Alternatively, [install MSVC manually](VScode_manual_install)
-* Please remove any existing MinGW-based version of McStas 3.8.2 before proceeding!
-* install the new MSVC based [McStas 3.8.2 MSVC metapackage](https://download.mcstas.org/mcstas-3.8.2/Windows/MSVC/McStas-Metapackage-3.8.2-MSVC-win64.exe)
+* Please remove any existing MinGW-based version of McStas 3.8.3 before proceeding!
+* install the new MSVC based [McStas 3.8.3 MSVC metapackage](https://download.mcstas.org/mcstas-3.8.3/Windows/MSVC/McStas-Metapackage-3.8.3-MSVC-win64.exe)
 * Option 2 should be fully functional on `arm64` processors.
 
 **OPTION 3: WSL**
 * Use the directions available in [WSL](WSL/README.md) to install the "Windows subsystem for Linux" and run the Linux Debian binaries there. 
 * Option 3 is fully functional on `arm64` processors.
 
 **OPTION 4: Legacy MinGW-bundle solution:**
-* Please remove any MSVC-based version of McStas 3.8.2 before proceeding!
-* install the legacy-style MinGW based [McStas 3.8.2 MinGW metapackage](https://download.mcstas.org/mcstas-3.8.2/Windows/MinGW/McStas-Metapackage-3.8.2-MinGW-win64.exe)
+* Please remove any MSVC-based version of McStas 3.8.3 before proceeding!
+* install the legacy-style MinGW based [McStas 3.8.3 MinGW metapackage](https://download.mcstas.org/mcstas-3.8.3/Windows/MinGW/McStas-Metapackage-3.8.3-MinGW-win64.exe)
 * Option 4 should be fully functional on `arm64` processors.
 
 If you are `conda-forge` knowledgable already, you may also simply install a new environment as explained in [conda-forge](../conda/README.md)

diff --git a/INSTALL-McStas/Windows/WSL/README.md b/INSTALL-McStas/Windows/WSL/README.md
@@ -1,4 +1,4 @@
-# Installation of McStas 3.8.2 on Windows 64 bit systems - using WSL
+# Installation of McStas 3.8.3 on Windows 64 bit systems - using WSL
 *(WSL is the Windows Subsystem for Linux, aka. bash on Ubuntu on Windows)*
 
 
@@ -11,7 +11,7 @@ available, but we recommend Ubuntu)
 * To open it again later, simply issue bash in a terminal or through
 the start menu
 
-## Install the McStas 3.8.2 Debian packages
+## Install the McStas 3.8.3 Debian packages
 * Follow the
   [normal Debian installation instructions](../../Linux/debian/README.md)
   - essentially a matter of sudo apt-get install mcstas-suite-python

diff --git a/INSTALL-McStas/conda/README.md b/INSTALL-McStas/conda/README.md
@@ -1,6 +1,6 @@
-# Install McStas 3.8.2 through conda-forge (macOS, Linux or Windows host)
+# Install McStas 3.8.3 through conda-forge (macOS, Linux or Windows host)
 
-* We a set of conda-packages for installing McStas 3.8.2.x through conda
+* We a set of conda-packages for installing McStas 3.8.3.x through conda
 
 ## Get yourself a conda / mamba / micromamba - we recommend micromamba!
 Due to the complex [licensing situation](https://discuss.scientific-python.org/t/response-to-anaconda-switch-to-paid-plans/1395) with the commercial Anaconda ecosystem, we clearly recommend McStas users to start from an open-source entry-point such as
@@ -9,11 +9,11 @@ Due to the complex [licensing situation](https://discuss.scientific-python.org/t
 ## Once micromamba is installed installed:
 * Initially, you may list mcstas versions available on conda-forge, just to be sure you pick them up:
 * ```micromamba search mcstas --channel conda-forge```, should give you many lines of the form
-* ```mcstas                         3.8.2      hc.31654_1  conda-forge   ```
+* ```mcstas                         3.8.3      hc.31654_1  conda-forge   ```
 * To install McStas with all needed dependencies in the environment `mcstas`, run
 * ```micromamba create --name mcstas --channel conda-forge --channel nodefaults mcstas```
 * The `--name` argument defines the environment to create for the mcstas installation
-* A specific version may be installed via e.g. ```micromamba create --name mcstas --channel conda-forge --channel nodefaults mcstas=3.8.2```
+* A specific version may be installed via e.g. ```micromamba create --name mcstas --channel conda-forge --channel nodefaults mcstas=3.8.3```
 * For some conda variants you may need an `env` in the  syntax like this: `conda env create ...` 
 
 ## Note for use on Windows

diff --git a/INSTALL-McStas/macOS/README.md b/INSTALL-McStas/macOS/README.md
@@ -1,4 +1,4 @@
-# Installation of McStas 3.8.2 on macOS 
+# Installation of McStas 3.8.3 on macOS 
 
 ## Supported macOS releases
 * macOS 11-15 (Big Sur and later, fully supported python tool set. Supported on both Intel and Apple Silicon,
@@ -7,16 +7,16 @@
 ## Steps to perform
 
 * Download the package:
-  [McStas 3.8.2 for macOS](https://download.mcstas.org/mcstas-3.8.2/macOS/mcstas-3.8.2-macOS-conda.tar.gz)
+  [McStas 3.8.3 for macOS](https://download.mcstas.org/mcstas-3.8.3/macOS/mcstas-3.8.3-macOS-conda.tar.gz)
  and unpack it (e.g. double-clicking should work).
 
 * Open the relevant folder for your local processor
 
-* Drag the McStas-3.8.2.app to /Applications and right-click + open to start the app:<br/>
+* Drag the McStas-3.8.3.app to /Applications and right-click + open to start the app:<br/>
 ![](screenshots/1_open-mcstas-from-Applications.png?raw=true)
 
 * Depending on your macOS version, security settings may initially prevent the app from opening, example from macOS 15 Sequoia:
-  - Initial warning that "McStas-3.8.2" was not opened<br/>
+  - Initial warning that "McStas-3.8.3" was not opened<br/>
   ![](screenshots/2_mcstas-not-opened.png?raw=true)
   - Next, go to System Preferences, Privacy and Security and select to
   "Open Anyway"<br/>
@@ -26,9 +26,9 @@
   - And finally give your password for installation to proceed<br/>
   ![](screenshots/5_admin-password.png?raw=true)
 
-* :warning: In case the last warning still does not allow to open the application, you may issue the following command in a Terminal: `sudo xattr -dr com.apple.quarantine /Applications/McStas-3.8.2.app`
+* :warning: In case the last warning still does not allow to open the application, you may issue the following command in a Terminal: `sudo xattr -dr com.apple.quarantine /Applications/McStas-3.8.3.app`
 
-* McStas 3.8.2 macOS app bundless are fully based on conda-forge and will "self-inject" all dependencies on first launch. Please follow any on-screen instructions given.
+* McStas 3.8.3 macOS app bundless are fully based on conda-forge and will "self-inject" all dependencies on first launch. Please follow any on-screen instructions given.
 
 * In case you have trouble accessing instrument files in certain areas
   of your disk, please give the McStas bundle "Full Disk Access"

diff --git a/INSTALL-McXtrace/Docker/README.md b/INSTALL-McXtrace/Docker/README.md
@@ -1,4 +1,4 @@
-# Running McStas and McXtrace 3.8.2 in Docker / podman etc.
+# Running McStas and McXtrace 3.8.3 in Docker / podman etc.
 
 The container definition is available at [here](https://github.com/willend/jupyter-remote-desktop-proxy/tree/mcstas-mcxtrace-3.5) and is further on dockerhub under docker.io/mccode/mcstas-mcxtrace
 

diff --git a/INSTALL-McXtrace/Linux/README.md b/INSTALL-McXtrace/Linux/README.md
@@ -1,4 +1,4 @@
-# Install McXtrace 3.8.2 on Linux and Unix.
+# Install McXtrace 3.8.3 on Linux and Unix.
 
 * We provide Debian packages for `x86_64` an `arm64` and recommend our
 	[conda-forge](../conda/README.md) install mechanism for any other platform.

diff --git a/INSTALL-McXtrace/Linux/debian/README.md b/INSTALL-McXtrace/Linux/debian/README.md
@@ -1,4 +1,4 @@
-## Install McXtrace 3.8.2 On Debian class systems (including Ubuntu, mint etc.):
+## Install McXtrace 3.8.3 On Debian class systems (including Ubuntu, mint etc.):
 The packages have been tested to work correctly on Ubuntu 24.04.
 
 # Add the McCode repository
@@ -28,7 +28,7 @@ mcxtrace-tools-python-mxplot-pyqtgraph - python-tools-mxplot-pyqtgraph built usi
 mcxtrace-tools-python-mxrun - python-tools-mxrun built using CMake
 ```
 The meta-package mcxtrace-suite-python (or mcxtrace-suite-python-ng)
-allows you to install mcxtrace 3.8.2 with tools (mcrun/mcplot etc.) by
+allows you to install mcxtrace 3.8.3 with tools (mcrun/mcplot etc.) by
 the simple apt-get command
 ```bash
 sudo apt-get install mcxtrace-suite-python

diff --git a/INSTALL-McXtrace/README.md b/INSTALL-McXtrace/README.md
@@ -1,4 +1,4 @@
-# Installation instructions for McXtrace 3.8.2
+# Installation instructions for McXtrace 3.8.3
 
 For a description of the release changes please consult the [McCode release notes](RELEASE_NOTES.md)
 

diff --git a/INSTALL-McXtrace/RELEASE_NOTES.md b/INSTALL-McXtrace/RELEASE_NOTES.md
@@ -1,4 +1,4 @@
-Changes in McStas/McXtrace 3.8.2
+Changes in McStas/McXtrace 3.8.3
 
 *Covers everything since the last full release, 3.7.9 (July 2, 2026), including all changes already shipped quietly via the intermediate conda-forge releases 3.7.10–3.7.25, and a ground-up rewrite of the McStas/McXtrace manuals.*
 
@@ -87,4 +87,4 @@ Changes in McStas/McXtrace 3.8.2
 * @mads-bertelsen-agentic made their first contribution in #2624
 * @MilanKlausz made their first contribution in #2638
 
-**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.2
+**Full Changelog**: https://github.com/mccode-dev/McCode/compare/v3.7.9...v3.8.3
diff --git a/INSTALL-McXtrace/Windows/README.md b/INSTALL-McXtrace/Windows/README.md
@@ -1,4 +1,4 @@
-# Installation of McXtrace 3.8.2 on Windows 64 bit Intel systems (some support for arm64)
+# Installation of McXtrace 3.8.3 on Windows 64 bit Intel systems (some support for arm64)
 ## *IMPORTANT: active internet connection required during installation*
 
 ###Please use either of:###
@@ -11,17 +11,17 @@
 
 **OPTION 2: New MSVC-bundle solution:**
 * As **Administrator**, run our new  [`install_msvc_for_conda.bat`](install_msvc_for_conda.bat) batch script to install MSVC and required packages to your system. Alternatively, [install MSVC manually](VScode_manual_install)
-* Please remove any MinGW-based version of McXtrace 3.8.2 before proceeding!
-* install the new MSVC based [McXtrace 3.8.2 MSVC metapackage](https://download.mcxtrace.org/mcxtrace-3.8.2/Windows/MSVC/McXtrace-Metapackage-3.8.2-MSVC-win64.exe)
+* Please remove any MinGW-based version of McXtrace 3.8.3 before proceeding!
+* install the new MSVC based [McXtrace 3.8.3 MSVC metapackage](https://download.mcxtrace.org/mcxtrace-3.8.3/Windows/MSVC/McXtrace-Metapackage-3.8.3-MSVC-win64.exe)
 * Option 2 should be fully functional on `arm64` processors.
 
 **OPTION 3: WSL**
 * Use the directions available in [WSL](WSL/README.md) to install the "Windows subsystem for Linux" and run the Linux Debian binaries there.  
 * Option 3 is fully functional on `arm64` processors.
 
 **OPTION 4: Legacy MinGW-bundle solution:**
-* Please remove any MSVC-based version of McXtrace 3.8.2 before proceeding!
-* install the legacy-style MinGW based [McXtrace 3.8.2 metapackage](https://download.mcxtrace.org/mcxtrace-3.8.2/Windows/MinGW/McXtrace-Metapackage-3.8.2-MinGW-win64.exe)
+* Please remove any MSVC-based version of McXtrace 3.8.3 before proceeding!
+* install the legacy-style MinGW based [McXtrace 3.8.3 metapackage](https://download.mcxtrace.org/mcxtrace-3.8.3/Windows/MinGW/McXtrace-Metapackage-3.8.3-MinGW-win64.exe)
 * Option 4 should be fully functional on `arm64` processors.
 
 If you are `conda-forge` knowledgable already, you may also simply install a new environment as explained in [conda-forge](../conda/README.md)

diff --git a/INSTALL-McXtrace/Windows/WSL/README.md b/INSTALL-McXtrace/Windows/WSL/README.md
@@ -1,4 +1,4 @@
-# Installation of McXtrace 3.8.2 on Windows 64 bit systems - using WSL
+# Installation of McXtrace 3.8.3 on Windows 64 bit systems - using WSL
 *(WSL is the Windows Subsystem for Linux, aka. bash on Ubuntu on Windows)*
 
 
@@ -11,7 +11,7 @@ available, but we recommend Ubuntu)
 * To open it again later, simply issue bash in a terminal or through
 the start menu
 
-## Install the McXtrace 3.8.2 Debian packages
+## Install the McXtrace 3.8.3 Debian packages
 * Follow the
   [normal Debian installation instructions](../../Linux/debian/README.md)
   - essentially a matter of sudo apt-get install mcxtrace-suite-python

diff --git a/INSTALL-McXtrace/conda/README.md b/INSTALL-McXtrace/conda/README.md
@@ -1,6 +1,6 @@
-# Install McXtrace 3.8.2 through conda-forge (macOS, Linux or Windows host)
+# Install McXtrace 3.8.3 through conda-forge (macOS, Linux or Windows host)
 
-* We a set of conda-packages for installing McXtrace 3.8.2.x through conda
+* We a set of conda-packages for installing McXtrace 3.8.3.x through conda
 
 ## Get yourself a conda / mamba
 Due to the complex [licensing situation](https://discuss.scientific-python.org/t/response-to-anaconda-switch-to-paid-plans/1395) with the commercial Anaconda ecosystem, we clearly recommend McXtrace users to start from an open-source entry-point such as
@@ -9,11 +9,11 @@ Due to the complex [licensing situation](https://discuss.scientific-python.org/t
 ## Once micromamba is installed installed:
 * Initially, you may list mcxtrace versions available on conda-forge, just to be sure you pick them up:
 * ```micromamba search mcxtrace --channel conda-forge```, should give you many lines of the form
-* ```mcxtrace                         3.8.2      hc.31654_1  conda-forge   ```
+* ```mcxtrace                         3.8.3      hc.31654_1  conda-forge   ```
 * To install McStas with all needed dependencies in the environment `mcxtrace`, run
 * ```micromamba create --name mcxtrace --channel conda-forge --channel nodefaults mcxtrace```
 * The `--name` argument defines the environment to create for the mcxtrace installation
-* A specific version may be installed via e.g. ```micromamba create --name mcxtrace --channel conda-forge --channel nodefaults mcxtrace=3.8.2```
+* A specific version may be installed via e.g. ```micromamba create --name mcxtrace --channel conda-forge --channel nodefaults mcxtrace=3.8.3```
 * For some conda variants you may need an `env` in the  syntax like this: `conda env create ...` 
 
 ## Note for use on Windows

diff --git a/INSTALL-McXtrace/macOS/README.md b/INSTALL-McXtrace/macOS/README.md
@@ -1,4 +1,4 @@
-# Installation of McXtrace 3.8.2 on macOS 
+# Installation of McXtrace 3.8.3 on macOS 
 
 ## Supported macOS releases
 * macOS 11-15 (Big Sur and later, fully supported python tool set. Supported on both Intel and Apple Silicon,
@@ -7,16 +7,16 @@
 ## Steps to perform
 
 * Download the package:
-  [McXtrace 3.8.2 for macOS](https://download.mcxtrace.org/mcxtrace-3.8.2/macOS/mcxtrace-3.8.2-macOS-conda.tar.gz)
+  [McXtrace 3.8.3 for macOS](https://download.mcxtrace.org/mcxtrace-3.8.3/macOS/mcxtrace-3.8.3-macOS-conda.tar.gz)
  and unpack it (e.g. double-clicking should work).
 
 * Open the relevant folder for your local processor
 
-* Drag the McXtrace-3.8.2.app to /Applications and right-click + open to start the app:<br/>
+* Drag the McXtrace-3.8.3.app to /Applications and right-click + open to start the app:<br/>
 ![](screenshots/1_open-mcxtrace-from-Applications.png?raw=true)
 
 * Depending on your macOS version, security settings may initially prevent the app from opening, example from macOS 15 Sequoia:
-  - Initial warning that "McXtrace-3.8.2" was not opened<br/>
+  - Initial warning that "McXtrace-3.8.3" was not opened<br/>
   ![](screenshots/2_mcxtrace-not-opened.png?raw=true)
   - Next, go to System Preferences, Privacy and Security and select to
   "Open Anyway"<br/>
@@ -26,9 +26,9 @@
   - And finally give your password for installation to proceed<br/>
   ![](screenshots/5_admin-password.png?raw=true)
 
-* :warning: In case the last warning still does not allow to open the application, you may issue the following command in a Terminal: `sudo xattr -dr com.apple.quarantine /Applications/McXtrace-3.8.2.app`
+* :warning: In case the last warning still does not allow to open the application, you may issue the following command in a Terminal: `sudo xattr -dr com.apple.quarantine /Applications/McXtrace-3.8.3.app`
 
-* McXtrace 3.8.2 macOS app bundles are fully based on conda-forge and will "self-inject" all dependencies on first launch. Please follow any on-screen instructions given.
+* McXtrace 3.8.3 macOS app bundles are fully based on conda-forge and will "self-inject" all dependencies on first launch. Please follow any on-screen instructions given.
 
 * In case you have trouble accessing instrument files in certain areas
   of your disk, please give the McXtrace bundle "Full Disk Access"