Merge branch 'off_file_mesh_component' of https://github.com/mccode-dev/McCode into off_file_mesh_component

Author: Lomholy

INSTALL-McStas/Docker/README.md

@@ -1,4 +1,4 @@
-# Running McStas and McXtrace 3.5.38 in Docker / podman etc.
+# Running McStas and McXtrace 3.5.40 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
 

INSTALL-McStas/Linux/README.md

@@ -1,4 +1,4 @@
-# Install McStas 3.5.38 on Linux and Unix.
+# Install McStas 3.5.40 on Linux and Unix.
 
 * We provide Debian packages, RedHat packages, and tar.gz's of "preconfigured" source code.
 

INSTALL-McStas/Linux/debian/README.md

@@ -1,4 +1,4 @@
-## Install McStas 3.5.38 On Debian class systems (including Ubuntu, mint etc.):
+## Install McStas 3.5.40 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.5.38 with tools (mcrun/mcplot etc.) by
+allows you to install mcstas 3.5.40 with tools (mcrun/mcplot etc.) by
 the simple apt-get command
 ```bash
 sudo apt-get install mcstas-suite-python

INSTALL-McStas/README.md

@@ -1,4 +1,4 @@
-# Installation instructions for McStas 3.5.38
+# Installation instructions for McStas 3.5.40
 
 Please consult the individual platform instructions:
 

INSTALL-McStas/Windows/README.md

@@ -1,14 +1,16 @@
-# Installation of McStas 3.5.38 on Windows 64 bit Intel systems (some support for arm64)
+# Installation of McStas 3.5.40 on Windows 64 bit Intel systems (some support for arm64)
 ## *IMPORTANT: active internet connection required during installation*
 
 * Please use either of:
   1. **Recommended:**
-    * Install [Visual Studio including c/c++ support](https://learn.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-170#download-and-install-the-tools). Any recent version of Visual Studio itself should work. Please install at minumum "Desktop development with c++" selecting VS2019 build tools. You can also use newer VS2022 build tools, but VS2019 must be present also. 
+    * Install [Visual Studio including c/c++ support](https://learn.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-170#download-and-install-the-tools). Any
+      recent version of Visual Studio itself should work. Use the
+      "Visual Studio Installer" and [modify settings](install-screenshot1.png) to selecect at minumum "Desktop development with c++" specifying to [include VS2019 build tools and CLI support](install-screenshot2.png). (It is OK to include build tools such as VS2022 or VS2026, but VS2019 **must** be present also. 
     * Use the [mcstas-conda](mcstas-conda.bat) batch script to install the latest mcstas from `conda-forge` 
     * Once install has completed, please use the `mcstas-shell` shortcut on the desktop - issue terminal command `mcgui` to start the McStas GUI. 
     * Option 1 *may* function `arm64` Windows, but will require installation of Visual Studio including both arm64 and x64_64 build tools for c++.
   2. **Legacy:**
-    * install the legacy-style MinGW based [McStas 3.5.38 metapackage](https://download.mcstas.org/mcstas-3.5.38/Windows/McStas-Metapackage-3.5.38-win64.exe)
+    * install the legacy-style MinGW based [McStas 3.5.40 metapackage](https://download.mcstas.org/mcstas-3.5.40/Windows/McStas-Metapackage-3.5.40-win64.exe)
     * Option 2 should be fully functional on `arm64` processors.
   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. 

INSTALL-McStas/Windows/WSL/README.md

@@ -1,4 +1,4 @@
-# Installation of McStas 3.5.38 on Windows 64 bit systems - using WSL
+# Installation of McStas 3.5.40 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.5.38 Debian packages
+## Install the McStas 3.5.40 Debian packages
 * Follow the
   [normal Debian installation instructions](../../Linux/debian/README.md)
   - essentially a matter of sudo apt-get install mcstas-suite-python

INSTALL-McStas/Windows/install-screenshot1.png

@@ -1,6 +1,6 @@
-# Install McStas 3.5.38 through conda-forge (macOS, Linux or Windows host)
+# Install McStas 3.5.40 through conda-forge (macOS, Linux or Windows host)
 
-* We a set of conda-packages for installing McStas 3.5.38.x through conda
+* We a set of conda-packages for installing McStas 3.5.40.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 McStas users to start from an open-source entry-point such as

INSTALL-McStas/Windows/install-screenshot2.png

@@ -1,4 +1,4 @@
-# Installation of McStas 3.5.38 on macOS 
+# Installation of McStas 3.5.40 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.5.38 for macOS](https://download.mcstas.org/mcstas-3.5.38/macOS/mcstas-3.5.38-macOS-conda.tar.gz)
+  [McStas 3.5.40 for macOS](https://download.mcstas.org/mcstas-3.5.40/macOS/mcstas-3.5.40-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.5.38.app to /Applications and right-click + open to start the app:<br/>
+* Drag the McStas-3.5.40.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.5.38" was not opened<br/>
+  - Initial warning that "McStas-3.5.40" 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.5.38.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.5.40.app`
 
-* McStas 3.5.38 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.5.40 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"