Risø–R–1416(rev.ed.)(EN) User and Programmers Guide to the Neutron Ray-Tracing Package McStas, Version 1.12 Peter Willendrup, Erik Knudsen, Emmanuel Farhi and Kim Lefmann Risø DTU, Roskilde, Denmark May 2009 Abstract The software package McStas is a tool for carrying out Monte Carlo ray-tracing simulations of neutron scattering instruments with high complexity and precision. The simulations can compute all aspects of the performance of instruments and can thus be used to optimize the use of existing equipment, design new instrumentation, and carry out virtual experiments for e.g. training, experimental planning or data analysis. McStas is based on a unique design where an automatic compilation process translates high-level textual instrument descriptions into efficient ANSI-C code. This design makes it simple to set up typical simulations and also gives essentially unlimited freedom to handle more unusual cases. This report constitutes the reference manual for McStas, and, together with the manual for the McStas components, it contains full documentation of all aspects of the program. It covers the various ways to compile and run simulations, a descrip- tion of the meta-language used to define simulations, and some example simulations performed with the program. This report documents McStas version 1.12, released May, 2008 The authors are: Peter Kjær Willendrup <
[email protected]> Materials Research Department, Risø DTU, Roskilde, Denmark Emmanuel Farhi <
[email protected]> Institut Laue-Langevin, Grenoble, France Erik Knudsen <
[email protected]>