| 1 | .TH mcconvert 1 "" "McStas X.Y.Z, Month Day, Year" "USER COMMANDS" |
|---|
| 2 | .SH NAME |
|---|
| 3 | mcconvert \- Matlab/Scilab conversion tool of the McStas neutron ray-trace simulation package |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | .B mcconvert [\-\-format=FORMAT][\-\-indir=IN][\-\-outdir=OUT] [file] |
|---|
| 6 | .SH DESCRIPTION |
|---|
| 7 | The |
|---|
| 8 | .B mcconvert |
|---|
| 9 | command is the Matlab/Scilab conversion tool of the McStas package. It converts Matlab files into Scilab equivalents, and vice-versa. As it works by replacing functions calls, it can handle data sets with binary files, as well as parameter scan data sets. |
|---|
| 10 | .PP |
|---|
| 11 | .B McStas |
|---|
| 12 | is a general tool for simulating neutron scattering instruments and experiments. It is actively supported by |
|---|
| 13 | .I Risoe National Laboratory |
|---|
| 14 | and |
|---|
| 15 | .I ILL |
|---|
| 16 | |
|---|
| 17 | .PP |
|---|
| 18 | McStas is based on a compiler [mcstas(1)] that reads a high-level specification language defining the instrument to be simulated and produces C code that performs the Monte Carlo Simulation. The system is very fast in use, both when setting up the instrument definition and when doing calculations. |
|---|
| 19 | .PP |
|---|
| 20 | McStas supports triple-axis, time-of-flight instruments, and polarised neutrons. It comes with a comprehensive manual and a library of well-tested components that include most standard elements of neutron scattering instruments, including steady-state and pulsed sources, monochromators/analysers, guides, collimators, vanadium and powder samples, velocity selectors and choppers, and a variety of detectors. |
|---|
| 21 | .PP |
|---|
| 22 | The package consists of the following user commands: |
|---|
| 23 | .TP |
|---|
| 24 | mcgui(1) |
|---|
| 25 | is the graphical user interface. Then use the |
|---|
| 26 | .I Neutron Site |
|---|
| 27 | menu to select an example instrument, and access the whole documentation for the |
|---|
| 28 | .I Help |
|---|
| 29 | menu. It contains an instrument editor, methods to plot simulation results, and much more |
|---|
| 30 | .TP |
|---|
| 31 | mcrun(1) |
|---|
| 32 | is the command-line tool for building and running simulations |
|---|
| 33 | .TP |
|---|
| 34 | mcplot(1) |
|---|
| 35 | is the simulation results plotting tool |
|---|
| 36 | .TP |
|---|
| 37 | mcdisplay(1) |
|---|
| 38 | is the instrument geometry and neutron trajectory viewer |
|---|
| 39 | .TP |
|---|
| 40 | mcdoc(1) |
|---|
| 41 | is the documentation tool |
|---|
| 42 | .TP |
|---|
| 43 | mcstas(1) |
|---|
| 44 | is the instrument compiler |
|---|
| 45 | .TP |
|---|
| 46 | .B mcconvert(1) |
|---|
| 47 | can convert Matlab data files into Scilab data files, and vice-versa. It also handles data sets with binary encoding. It also handles parameter scan results. |
|---|
| 48 | .TP |
|---|
| 49 | mcformat(1) |
|---|
| 50 | can transform any text data set from one format to an other. It does not support conversion from binary data sets. It can also merge equivalent results. |
|---|
| 51 | .PP |
|---|
| 52 | We encourage users to refer to the User and Component Manuals, which are available with the command |
|---|
| 53 | .B |
|---|
| 54 | mcdoc |
|---|
| 55 | .P |
|---|
| 56 | .SH OPTIONS |
|---|
| 57 | .TP |
|---|
| 58 | \-\-format=FORMAT |
|---|
| 59 | Specifies wanted output format, i.e. Matlab or Scilab |
|---|
| 60 | .TP |
|---|
| 61 | \-\-outdir=DIR |
|---|
| 62 | Specifies wanted output directory |
|---|
| 63 | .TP |
|---|
| 64 | \-\-indir=DIR |
|---|
| 65 | Specifies wanted input directory. Default is current directory. |
|---|
| 66 | .TP |
|---|
| 67 | \-\-quiet |
|---|
| 68 | Suppress status info (e.g. 'mcstas.m \-> mcstas.sci') |
|---|
| 69 | .SH EXAMPLES |
|---|
| 70 | .TP |
|---|
| 71 | Typical usage |
|---|
| 72 | .B mcconvert |
|---|
| 73 | \-\-format=Matlab \-\-indir=SciData \-\-outdir=MatData |
|---|
| 74 | .SH BUGS |
|---|
| 75 | McStas is a large package, and bugs might be found. If so, please report to |
|---|
| 76 | .B http://mcstas.org/McZilla/ |
|---|
| 77 | and the mailing list |
|---|
| 78 | .B neutron-mc@risoe.dk |
|---|
| 79 | .SH AUTHOR |
|---|
| 80 | Peter Kjaer Willendrup, Emmanuel FARHI, Kim Lefmann, and Klaus Lieutenant |
|---|
| 81 | .SH SEE ALSO |
|---|
| 82 | mcstas(1), mcrun(1), mcdisplay(1), mcplot(1), mcgui(1), mcdoc(1), mcformat(1), mcconvert(1) |
|---|
| 83 | .P |
|---|
| 84 | web site: <http://www.mcstas.org> |
|---|
| 85 | .P |
|---|
| 86 | mailing list: <mailto:neutron-mc@risoe.dk> |
|---|
| 87 | .P |
|---|
| 88 | matlab(1), idl(1), scilab(1), octave(1), vitess(1), NISP(1), restrax(1), mcnp(1), tripoli(1) |
|---|
