McStas logo McStas - A neutron ray-trace simulation package ILL; PSI; ESS Niels Bohr Institute DTU Physics NEXMAP

McStas

About McStas
 Conditions of use
 Authors/Contacts
 Project funding
 Screenshots

Download
 Components
 Linux Install (deb/rpm)
 Mac OS X Install
 Unix Install (src code)
 Windows Install
 Other Downloads (share)

Mailing list

Search web/mailinglist

Documentation
 McStas manual
 FAQ
 Known problems
 Publications
 C Compilers
 Other
 Tools
 Tutorial

Workshops/conferences

Developments

Links

Report bugs

Git

McStas Ubuntu live-dvd


McStas: quick installation instructions

!!WARNING: OBSOLETE- McStas 2.0 specific!!


Getting McStas

Before you install McStas, you may try it from our Ubuntu Live-DVD. Just burn the DVD and reboot your machine. The local system is not affected, all runs from the disk.

Get the binary distributions for your system or source code from the Download page.
McStas is licensed under a GPL2. You can also get it from our nightly build webpage.

Requirements

Linux Debian and RPM based systems

The dependency packages are automatically installed when selecting the mcstas-suite package below.
If you wish to install manually the required dependencies prior to the mcstas package, just do:
sudo apt-get install libtk-codetext-perl gcc openmpi-dev openmpi-bin
sudo apt-get install perl perl-tk pdl pgplot5 gnuplot-x11 libpgplot-perl bash
sudo apt-get install python python-chaco python-matplotlib python-yaml
sudo apt-get-install whitedune
Optionally, you can install the NeXus format libraries to be able to export data files in HDF5.

Linux (other)

You will need to install a C compiler (e.g. gcc), and openmpi if you wish to use multi-processing.
For the McStas Perl tools:
perl, perl-Tk and perl-dl (pdl) with PGPLOT hooks.
We also recommend Gnuplot and a VRML/X3D plotter such as Freewrl or InstantReality.
For the McStas Python tools:
python, python-chaco, python-matplotlib, python-yaml
You will also need CMake to install from source code.
Optionally, you can install the NeXus format libraries to be able to export data files in HDF5.

Windows

  • Download and install a Strawberry Perl 5.16 for your system from http://strawberryperl.com
  • Download this zip file (rightclik, save as)
  • Unzip the Zip file and using a command window, cd to the folder
  • Run the enclosed
    postsetup.bat
  • Download and install Python(x,y).
  • Optionally install iFit to visualize results using a Matlab environment (for free, no license needed).
  • Optionally install a VRML/X3D plotter such as Freewrl or InstantReality.
  • Optionally install Gnuplot.
  • Optionally, you can install the NeXus format libraries to be able to export data files in HDF5.

MacOSX

You need to install Xcode, e.g. from the App store (or installation medium or from here - old but functional).
You also need to install Command Line Tools inside Xcode (Xcode -> Preferences-> Downloads -> Components) and also allow installation of third party software (System Preferences -> Security & Privacy -> General -> Allow applications downloaded from: Anywhere) - can be reset after installation of SciPDL etc. from the DMG.

On MacOSX 10.8 (Mountain Lion), install XQuartz (X11).

Python: Install either one of:
Then install python-yaml by launching a terminal and :
sudo easy_install pyyaml
  • Optionally install iFit to visualize results using a Matlab environment (for free, no license needed).
  • Optionally install a VRML/X3D plotter such as Freewrl or InstantReality.
  • Optionally install Gnuplot.
  • Optionally install the NeXus format libraries to be able to export data files in HDF5.

Installation


Linux Debian and RPM based systems

On Debian based systems (Debian, Ubuntu, Mint...)

Just install our Debian repository, and then the mcstas-suite package:

sudo apt-add-repository 'deb http://packages.mccode.org/debian stable main'
sudo apt-get update
sudo apt-get install mcstas-suite libtk-codetext-perl
You may optionally install iFit to visualize results using a Matlab environment (for free, no license needed).
sudo apt-get install ifit MCRInstaller
On RPM based systems

Just install our RPM repository, and then the mcstas-suite package:

cd /etc/yum.repos.d
sudo wget http://packages.mccode.org/rpm/mccode.repo
sudo yum update
sudo yum install mcstas-suite

Linux (other)

Get the source package, and follow the build instructions on the SVN page (for e.g. mcstas-2.0):
tar xzf mcstas-2.0-src.tar.gz
cd mcstas-2.0-src
mkdir build && cd build
cmake ..
make
sudo make install
You will need to repeat this procedure for all packages (or only the mcstas-comps and the Perl one), e.g.
mcstas-comps
mcstas-tools-perl
mcstas-tools-python-mcrun
mcstas-tools-python-mcplot-chaco
mcstas-tools-python-mcplot-matplotlib

Windows

Install the McStas packages in this order:
  • McStas core package (mcstas-NSIS-2.0-*.exe)
  • McStas component package (mcstas-comps-NSIS-2.0-*.exe)
  • McStas Perl tool package (mcstas-tools-perl-NSIS-2.0-*.exe)
  • - then the optional Python packages if wanted
Once everything is installed, use the new links on your desktop for either starting mcgui directly or starting a "mcstas environment shell" with mcrun, mcplot, mcgui etc.

MacOSX

Install the packages in this order:
Tk-804
SciPDL
McStas
mcstas-comps
mcstas-tools-perl
mcstas-tools-python-mcrun
mcstas-tools-python-mcplot-chaco
mcstas-tools-python-mcplot-matplotlib

Configuration

Linux

To build the McStas library documentation after installation (if missing), use e.g.:
cd /usr/local/lib/mcstas-2.0
sudo mcdoc -t


You may have a look at the FAQ page in case of troubles.


Last modified: Fri Oct 18 16:25:25 CEST 2013


Last Modified: Monday, 10-Mar-2014 11:38:02 CET
Search website mailinglist archive GitHub repos