2. Quick start


At the ILL RESTRAX is accessible from all Linux workstation of the TAS group and possibly also from some other UNIX machines (click here for details).

Step 1

To start working, just call restrax from a terminal window:

% restrax

or try this if it doesn't work.

In the first menu, select the EXCI module (definition of the scattering function S(Q,E)) to be loaded initially. You can reload another module at runtime by the command EXCI. In absence of a better idea you can start with the default one (damped harmonic oscillators):

Start with model :
------------------
1 ... Damped oscillators
2 ... Damped oscillators with an adjustable dispersion gradient
3 ... Bond charge model (phonons in Si, Ge, ...)
4 ... Diffuse incommensurate fluctuations

In the next menu, the starting script offers a choice of available instrument configurations, select one of the instruments or a demo. The demo option would offer several examples starting with a tutorial-like session from a job file. You can also switch to the interactive mode from a job file execution by typing <Q><ENTER>.

Select instrument:
------------------
1 ... IN1
2 ... IN3
3 ... IN8
4 ... IN12
5 ... IN14
6 ... IN20
7 ... demo

RESTRAX then goes on with a series of prompts, press ENTER to accept the default answers:

Configurations will be searched in /home/tas/matroot/restrax/IN20
This message informs you about the path to configuration files.

Path to data files [/usr/illdata/data/in20] :
Here you can modiffy the path to your data files (or do it later using the command PATH).

Configuration file: /home/tas/matroot/restrax/IN20/in20_Heusler_3.cfg
This is information about the current TAS configuration being loaded, later on you will be able to change it with the command CFG.

Name of a parameter or data file [in20.res] :
Now you have to indicate some data or a parameter file (*.res).

ResTrax>
The session can start. Use ? to list available commands, or see to the commmands reference page.

Alternatively, if you have chosen the demo, RESTRAX would guide you through a typical session example. Check the corresponding jobfile to learn the commands used.

Step 2

In order to get correct results, the TAS configuration file has to describe your instrument correctly. For any of the instruments there may be several files available, corresponding to different configurations (monochromator and analyzer choice, beam collimation etc.). Try the command LSCFG to list *.cfg files in your search directory and the command CFG to load the required one.

You can also edit the *.cfg file by yourself. Copy to your current directory any of the existing *.cfg files as a template. Whenever you call it by the CFG command, it will override those in remote directories. Try to edit it as a text file (see help), or using the form on the RESTRAX server. Don't forget to save it in the editor and to update the configuration by calling the file with the CFG command.


If RESTRAX doesn't start

It is possible that there is a link missing on your workstation from the RESTRAX installation directory to a directory listed in your $PATH environment variable, e.g. /usr/local/bin. In such a case, look whether you can see the restrax starting script,

% ls /home/tas/matroot/restrax/start

If yes, call this script directly and/or add an alias to it in your .profile (or .login) file so that you can call it with a simple name:

% alias restrax /home/tas/matroot/restrax/start
% restrax

If not, then probably the automount system did not mount the /home/tas directory on your workstation. In such a case contact the .