/*******************************************************************************
- McStas, neutron ray-tracing package
- Copyright 1997-2004, All rights reserved
- Risoe National Laboratory, Roskilde, Denmark
- Institut Laue Langevin, Grenoble, France *
- Documentation: README *
- %Identification
- Written by: KN, KL, PEO, EF, PW
- Date: 1997
- Origin: Risoe
- Release: all McStas
- Version: all *
- This file is part of McStas.
- It details the installation procedure *
- %Link
- <a href="http://neutron.risoe.dk/mcstas">Official site</a>
- <a href="http://www.ill.fr/tas/mcstas">Mirror site</a> *
- %End *******************************************************************************/
This is McStas version 1.8, released March 4th, 2004 Copyright (C) Risoe National Laboratory, 1997-2004. All rights reserved. See the file COPYING for conditions on use. This software is covered by the GNU General Public License. User instrument files generated by McStas, output data or papers based on these use is NOT considered "derived work" but is considered normal usage of the software. The random number algorithm used by default in McStas is the "Mersenne Twister", by Makoto Matsumoto and Takuji Nishimura (see http://www.math.keio.ac.jp/~matumoto/emt.html). This code is included in the file lib/mcstas-r.c and is distributed under the terms of the GNU Library General Public License, see the file lib/LGPL.
If you wish to use McStas in ways that contradict the conditions, contact us and chances are that we will be able to make a suitable arrangement.
Installation instructions are in the install_docs directory.
Changes from previous versions are in the file CHANGES. Please read that !
To get started, some example instrument definitions have been supplied in the examples/ directory. To run a simulation, the command `mcrun' is used. For example:
mcrun prisma2 -n2e6 TT=-30 PHA=22 PHA1=-3 PHA2=-2 PHA3=-1 PHA4=0 PHA5=1 PHA6=2 PHA7=3 TTA=44
This will first compile the instrument definition (if necessary) and subsequently run it. It is also possible to run simulations from the graphical user interface `mcgui', or to compile and run simulations manually.
The output files will be put in the current directory by default. The file tas1-scans in the example directory is a script that will run a series of simulations that constitute a line-up experiment of the TAS1 spectrometer at Risø.
To fully utilize McStas, you will need a copy of the McStas manual. It may be found in the lib/doc directory of the distribution. The manual, along with much other information, is available from the McStas WWW home page:
http://neutron.risoe.dk/mcstas/
and
http://www.ill.fr/tas/mcstas/
Contacts for McStas are:
Kim Lefmann <kim.lefmann@risoe.dk> (KL)
Emmanuel Farhi <farhi@ill.fr> (EF)
Peter Kjear Willendrup <peter.willendrup@risoe.dk> (PW)
Previous authors are:
Kristian Nielsen, email <kristian.nielsen@risoe.dk> (KN)
Per-Olof Åstrand <per-olof.aastrand@risoe.dk> (PEO)
Feel free to direct any comments or questions to this address. It is an important goal of the McStas project to have the program used also outside of Risø, so if you have a reasonable request there is a good chance that we will be willing to help you out.
Some parts of McStas require additional software to be installed in order to work. The needed software packages are all freely distributable, and can be found on the McStas WWW home page or on the McStas CD-Rom distribution.
- The 'mcstas' base program only requires a C compiler, which is usually provided with most Unix/Linux systems. For Windows, the Dev-C++ compiler from Bloodshed may be installed freely.
- The `mcrun' and `gscan' front-ends requires Perl version 5 or later, which is available on most Unix-like systems, and may installed for Windows as well.
- The `mcdisplay' front-end requires Perl version 5 or later, and one
of the following:
1- the PGPLOT graphics Fortran library, and the PgPerl interface
between Perl and PGPLOT 2- Matlab 3- Scilab and its Plotlib
- The `mcplot' front-end requires Perl version 5 or later, and one
of the following:
1- the PGPLOT graphics Fortran library, and the PgPerl interface
between Perl and PGPLOT, and the PDL scientific data extension for Perl. 2- Matlab 3- Scilab
- The `mcgui' front-end requires Perl version 5 or later, the perl/tk
perl extension, and one of the following:,
1- the PGPLOT graphics library, the PgPerl interface between Perl
and PGPLOT, and the PDL scientific data extension for Perl. 2- Matlab 3- Scilab and its Plotlib
Information on Perl may be found on
http://language.perl.com/index.html Information on Tcl/Tk may be found on
http://tcl.tk.com/
and
http://www.activestate.com/
Information on perl/tk may be found on
http://w4.lns.cornell.edu/~pvhp/ptk/ptkFAQ.html Information on Scilab may be found on
http://www-rocq.inria.fr/scilab/
and the Plotlib will be available at
http://www.dma.utc.fr/~mottelet/myplot.html
Information on PGPLOT may be found on
http://astro.caltech.edu/~tjp/pgplot/index.html Information on PgPerl may be found on
http://www.aao.gov.au/local/www/kgb/pgperl/ Information on PDL may be found on
http://www.aao.gov.au/local/www/kgb/perldl/ Information on Dev-C++ for Windows may be found on
http://www.bloodshed.net/dev/devcpp.html Information on Matlab may be found on (commercial)