McXtrace logo

McXtrace - An X-ray ray-trace simulation package

ESRF; SAXSLAB Niels Bohr Institute DTU Physics


Project Status
 Project Partners
 Project People

 Mac OSX Installation
 Windows Installation

Mailing List



Minutes of Meetings

McXtrace Art

About McXtrace




Mac OSX Installation Instructions

To install McXtrace on a computer running Mac OSX you first need to allow installation of third party software (System Preferences -> Security & Privacy -> General -> Allow applications downloaded from: Anywhere) - can be reset after the installation of the McXtrace bundle. You must also install XCode from the App store (or installation medium), and in particular the Xcode command line tools. For 10.9 or later these are included by defualt in the Xcode installation. For the purpose of just running McXtrace full installation of Xcode is not necessary. You may instead issue the command
sudo xcode-select --install
inside a terminal, to get only the Xcode command line tools.

You may furhter install either Intel C (commercial product) or the version of gcc available from, as they both work much better than the Apple-provided llvm and llvm-gcc compilers. On MacOSX 10.8 and above (Mountain Lion, Mavericks), also install XQuartz (X11). If on Yosemite, there's an in Applications->Utilities which will take you directly to the Xquartz-website

Afterwards, unzip your downloaded McXtrace bundle corresponding to your version of Mac OS X (we currently provide packages for 10.9 Maverics and 10.10 Yosemite) and run it. We can of course generate packages for older versions of Mac OSX if necessary. Please let us know and we'll try to support your platform as well.

Apart from the dependencies mentioned above, the defaults of the installation bundle includes everything you need for a base installation of McXtrace, namely

  • McXtrace code generator, components, instruments and datafiles
  • The "classic" McXtrace Perl tools configured for use on your version of Mac OS X
  • PGPLOT graphical backend for mxplot/mxdisplay
  • McXtrace-specific extensions to Perl
  • Tk widgets for Perl
The installation procedure is shown in the images below.

When the installation process is started you are greeted with this screen:

The next step mentions the dependencies of McXtrace.

Thirdly, you are asked to read and accept the Gnu public License under which McXtrace is distributed.

Next, you are asked to choose which additional modules (if any) to install. A minimal McXtrace installation is already selected for you. Importantly - to enable running McXtrace in parallel using openmpi, check the box in front of the mcxtrace-openmpi-1.2 module.

Lastly - you are asked to confirm that you really do want to install McXtrace.

If all goes well you should now see this screen.


  • In case you, instead of the last screen, get an error message saying that packages could not be validated, please check that you have installed Xquartz.

Last Modified: Friday, 15-Dec-2017 15:05:27 CET
Search website mailinglist archive SVN repos McCode Trac