[mcxtrace-users] McXtrace v3.2 is released
Peter Kjær Willendrup
pkwi at fysik.dtu.dk
Fri Jul 7 18:24:06 CEST 2023
Hello again,
Unfortunately a minor annoyance in the new 3.2 release of McXtrace has been found:
Many of the component information headers will not render correctly in mxdoc / the html documentation.
To fix the problem locally on your machine, please:
1) Replace your McXtrace 3.2 $MCXTRACE/tools/Python/mccodelib/utils.py by the one available on mccode-3 on GitHub at https://raw.githubusercontent.com/McStasMcXtrace/McCode/a51267381588b8c29fd06e89d436a1d0d40341ca/tools/Python/mccodelib/utils.py
2) Run mxdoc -i (with needed admin credentials if needed)
The command replaces the html files in $MCXTRACE.
A fresh McXtrace release will be spun out later in the summer or early fall.
Best and sorry for the inconvenience,
Peter
Peter Kjær Willendrup
Forskningsingeniør, Specialkonsulent
DTU Physics
[image001.gif]
Technical University of Denmark
[image002.gif]
Department of Physics
Fysikvej
Building 307
DK-2800 Kongens Lyngby
Main office at
ESS DMSC
COBIS, Ole Maaløes vej 3, 2200 København N, Denmark
Direct +45 2125 4612
Mobil +45 2125 4612
Fax +45 4593 2399
pkwi at fysik.dtu.dk
On 6 Jul 2023, at 11.14, Peter Kjær Willendrup <pkwi at fysik.dtu.dk> wrote:
McXtrace 3.2 released
[06/07/2022]Dear all, The new 3.2 release of McXtrace is now out:
McXtrace "next-generation", v. 3.2 is built and ready for download!
Download and installation instructions are available via our GitHub INSTALL-doc pages<https://github.com/McStasMcXtrace/McCode/blob/master/INSTALL-McXtrace-3.x/README.md>.
Selected highligts from the releases are listed below. The full list of changes for both releases is also available at our CHANGES_McXtrace<https://github.com/McStasMcXtrace/McCode/tree/master/CHANGES_McXtrace> document
!!! Please start your migration to 3.x: !!!The earlier McXtrace 1.7.1 was the "finals update" to the 1.x series, sharing a subset of tool features with McXtrace 3.1. The Wiki has a dedicated section on McXtrace 1.x -> McXtrace 3.x conversion<https://github.com/McStasMcXtrace/McCode/wiki#migrating-from-mcstas-2x-to-3x-and-mcxtrace-1x-to-3x> that includes:
* An overview of differences<https://github.com/McStasMcXtrace/McCode/wiki/Overview-of-differences-in-%22classic-McStas-McXtrace%22-and-the-3.x-versions>
* A nomenclature list containing short descriptions of new concepts and important keywords in McXtrace 3.x<https://github.com/McStasMcXtrace/McCode/wiki/McStas-McXtrace-3-and-GPU-terminology-%28table%29> and OpenACC / CUDA code in general.
* A document outlining the most importand differences between 1.x and 3.x.<https://github.com/McStasMcXtrace/McCode/wiki/Overview-of-differences-in-%22classic-McStas-McXtrace%22-and-the-3.x-versions>
* A guide for 1.x -> 3.x instrument conversion.<https://github.com/McStasMcXtrace/McCode/wiki/HOWTO%3A-Modifying-a-McStas-2-instrument-for-use-under-McStas-3>
* A guide for 2.x -> 3.x component conversion.<https://github.com/McStasMcXtrace/McCode/wiki/HOWTO%3A-Modifying-a-McStas-2-component-for-use-under-McStas-3>
- If you are still in trouble, please write us a GitHub issue or an email to mcxtrace-users at mcxtrace.org<mailto:mcxtrace-users at mcxtrace.org>
Release highligts
* McXtrace 3.2 is the third official release in the 3.x series, with a modernised code-generator and support for GPU acceleration on NVIDIA cards.
* Thanks to all members of the joint McStas-McXtrace team, you guys ROCK!
* Fixes of issues from last 3.x release:
* A large number of issues from 3.1 were addressed, see the relevant GitHub issues<https://github.com/McStasMcXtrace/McCode/issues?q=is%3Aissue+is%3Aclosed+label%3Amcxtrace-3.1> for details
* Documentation & guides:
* Inline component documentation has been given an overhaul, most component doc pages should now render in a meaningful way
* Installation:
* As usual, our install docs are available on the McCode GitHub page<https://github.com/McStasMcXtrace/McCode/tree/master/INSTALL-McXtrace>
* The meta-packages for Debian/Ubuntu and Fedora are named e.g. mcxtrace-suite-python-ng 'next generation' for 3.x and mcxtrace-suite-python for the 1.x series packages.
* OpenACC GPU (and CPU multicore) acceleration is at the time of release still ONLY supported on Linux systems, as this is the only platform targeted by the NVIDIA HPC package. Versions 20.x-23.x should all work. On Windows 64bit systems, support is expected to arrive "later", but you may run on your GPU via the so-called "Windows Subsystem for Linux" (WSL). macOS is unfortunately not supported by NVIDIA HPC acceleration.
* McXtrace 3.2 enables further components and instruments GPU. Effectively all functionality has been ported to 3.x.
* Interoperability with other codes:
* McXtrace now ships with a "python-aware" code generator for generating "McStasScript" code, example:
* mcxtrace-pygen Instrument.instr --> generates Instrument_generated.py
* Using 'jupytext' this file may easily be converted to a notebook:
* jupytext --to ipynb Instrument_generated.py --> generates Instrument_generated.ipynb
* See https://github.com/PaNOSC-ViNYL/McStasScript for more information on McStasScript, that also works for X-rays even though being labed McStas for our "neutron sibling".
* Thanks to the work of José Robledo (FZJ), we now have a better interface to the Small-Angle Scattering models from SASview, aka. SASmodels.
Due to the big number of included models that each correspond to a McXtrace component, these are now found in the "sasmodels" folder of your McXtrace installation.
* Tools:
* mxplot (-pyqtgraph) has received a couple of bugfixes relating to plotting in log-mode.
* mxrun has now a number of --optimize options to Optimize beam-line parameters. Specify min,max or min,start,max for parameters to vary. the default optimizer is Powell from SciPy. You may choose the monitor to optimize, or all. Use mxrun -h for more help.
* mxgui Run dialogue now allows to Optimize beam-line parameters. Specify min,max or min,start,max for parameters to vary. the default optimizer is Powell from SciPy. You may choose the monitor to optimize, or all.
* Components and Instruments:
* As mentioned above, SASmodels now come in the form of 94 (!) components in the sasmodels folder.
* The Isotropic_Sqw sample by Emmanuel Farhi has received a number of updates.
* The Fluorescence sample by Emmanuel Farhi has received a number of updates.
* PowderN and Single_crystal may now use material definition from a CIF file, calls the cif2hkl tool behind the scenes, work done by Emmanuel Farhi.
* New instrument SOLEIL_CASSIOPEE.instr from Emmanuel Farhi.
* Many updates to SOLEIL_ instruments.
* Core simulation framework / code-generator:
* McXtrace will now issue a warning if you generate GROUPS of a single component, as this may lead to unphysical results. (GROUPS are intended for 2 or more components in an "exclusive-or" setup.
* Platforms:
* We still support 64bit Windows 10/11 on Intel, all recent 64bit macOS including 13.0 Ventura and later on both Intel and Apple Silicon/M1 processors. Debian-based distros on Intel and Arm, Fedora on Intel.
* On macOS and Windows we now bundle a Mambaforge Python with the installation.
We hope you will enjoy this new release!!!
Greetings and hopes for happy simulating,
Emmanuel Farhi & Peter Willendrup
(current McXtrace team)
Peter Kjær Willendrup
Forskningsingeniør, Specialkonsulent
DTU Physics
<image001.gif>
Technical University of Denmark
<image002.gif>
Department of Physics
Fysikvej
Building 307
DK-2800 Kongens Lyngby
Main office at
ESS DMSC
COBIS, Ole Maaløes vej 3, 2200 København N, Denmark
Direct +45 2125 4612
Mobil +45 2125 4612
Fax +45 4593 2399
pkwi at fysik.dtu.dk
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman2.mcxtrace.org/pipermail/mcxtrace-users/attachments/20230707/6905e960/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.gif
Type: image/gif
Size: 58 bytes
Desc: image001.gif
URL: <http://mailman2.mcxtrace.org/pipermail/mcxtrace-users/attachments/20230707/6905e960/attachment-0002.gif>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.gif
Type: image/gif
Size: 1055 bytes
Desc: image002.gif
URL: <http://mailman2.mcxtrace.org/pipermail/mcxtrace-users/attachments/20230707/6905e960/attachment-0003.gif>
More information about the mcxtrace-users
mailing list