McXtrace logo

McXtrace - An X-ray ray-trace simulation package

ESRF; SAXSLAB Niels Bohr Institute DTU Physics


 Linux Installation (deb/rpm)
 Mac OSX Installation
 Unix Install (src code)
 Windows Installation

Project Status
 Project Partners
 Project People

Mailing list



Minutes of Meetings

McXtrace Art

About McXtrace



McXtrace Installation on Windows

The distribution packages for McXtrace may be downloaded via

Installing Mcxtrace on Windows

We suggest you uninstall previous versions of McXtrace before installing McXtrace 1.5. The versions may interfere with each other on some systems. If you experience problems please don't hesitate to contact the development team (for instance through the mailing list) - we will help you out ASAP.

  1. Make sure you have strawberry perl installed. For instance by downloading and installing the INSTALL_FIRST_...-file from from here. This also includes the MinGW c-compiler for windows. Please note that it should be this version of strawberry perl, as you may experience internal dependencty problems otherwise. In particular regarding the plotting tools.
  2. Download and install the McXtrace 1.5 self extracting installer INSTALL_SECOND_AS_ADMIN_McXtrace-Metapackage-1.5-win64.exe from here. Please make sure you run this as Adminstrator. During the installation process you may choose to install optional packages.
In the extras directory you may additionally find MS MPI-libraries and and NeXus libraries. The former is the recommended way to run MPI on windows systems, the latter is necessary if you prefer to get output in the NeXus-format (The NeXus format) instead of in the default ascii-based format.

Ubuntu on Windows 10

As an alternative to the above approach, you can also run our Debian Linux binaries directly under Windows via the WSL (Windows 10 64bit and newer only). Description and recipe:
Partnering with Ubuntu Linux, Microsoft has released the (experimental) feature "Windows subsystem for Linux" (WSL), also known as "Bash on Ubuntu on Windows". Read more follwing these links
pcworld: bash on windows 10, howtogeek: bash on windows 10. It turns out that it is relatively straightforward to get McXtrace running under this new feature - thereby overcoming some of the annoyances of McXtrace on the Windows platform. To try it out, please follow the below steps
  1. Install a copy of Windows 10 64 bit.
  2. Update it beyond "Windows 10 Version 1607" - aka the "anniversary build".
  3. Enable "developer mode" in settings.
  4. Use "turn features on or off" to enable "Bash in windows".
  5. Start bash via the start icon / cmd+esc
  6. Install McXtrace as usual on a Debian systems. Also remember that you can easily install OpenMPI etc.
  7. Install and start the Xming X-server from here: Xming site.
  8. Turn back to your bash and execute:
    • export DISPLAY=localhost:0.0
    • mxgui & or mxgui-py & (or any of the usual McXtrace commands)

Last Modified: Tuesday, 28-Apr-2020 11:59:33 CEST
Search website mailinglist archive SVN repos McCode Trac