************************************************************************
NEW in RESTRAX 4.8.2 (July 2005) 
************************************************************************
Changes in the code structure - preparations for GUI.
No new functionality except:

#) Submenu commands can be called directly, 
e.g. MFIT RUN 5 ... makes 5 fit iterations and returns back to the main menu

#) Plot of 2D data in horizontal plane (flat-cone) prompts on a string caption 
and scale factor (i.e. relative size of the reciprocal space area to show, default=1)

************************************************************************
NEW in RESTRAX 4.8.0 (December 2004) 
************************************************************************
#) Perl script for automatic source documentation - res2html. Creates html
   image of source files and a project summary with cross-links. Documentation 
   is created by <make srcdoc> in the ./doc subdirectory.

#) PLOT command is changed. It calls a "human-readible"  submenu. When called
   with arguments, the arguments are processed as the PLOT submenu commands.
   Old behaviour of PLOT command with obscure integer arguments is preserved.

#) Possible problems with energy units are solved: RESTRAX works in meV.
   Data in THz are converted to meV when loaded.

#) Added command OMEXC [h k l], returns excitation energies and S(Q,E) from the EXCI module.
   
#) Added version control for EXCI libraries (only warning is issued). 
   The module version number is set in exci.inc.

#) Command PROF was canceled. It used to be just a synonymum for MFIT.

#) Command GENDT .. generates simulated data for given TAS setting and scattering model (EXCI module). 

#) Added examples for EXCI models:
- flatcone 
- phonons in Si
- data fitting with damped oscillators model
When selected from startup menu, commented batch files start and
guide through the session.

#) restrax.ini file can contain a directive to run a batch file on startup:
JOB=<jobfile name>

#) Improved memory management for event storage. Avoids frequent memory 
re-allocation, which may cause high memory volume attributed to 
the process by some memory managers (observed on i686/Linux 2.6.5).

#) Extended search for configuration files (*.cfg,*.res,lookup tables etc.).
These files are searched in the directories in following order:
1) current directory
2) directory passed as -dir=<filename> argument or by CPATH command
3) <installation directory>/setup

#) Command CPATH .. permits to change the path to the configuration files
at runtime (normally passed as command-line argument -dir=<filename>.

#) Command SIMFC: creates empty datasets for multianalyzer. 
Channel distance is defined by DA4, the 1st channel is defiend by 
current QH,QK,QL,EN values. Subsequent use of FIT/MFIT commands will 
simulate scans with multianalyzer (i.e. with flatcone if AMOD=1).

#) Command PLOT -5 shows the simulated resolution functions for all 
channels and for middle and limit A3 values. The simulated scan actually 
consists of 91 steps by DA3.

#) Commands PAUSE and ECHO are treated by command line interpreter:
PAUSE .. waits for <RETURN> and continues  (<Q><RETURN> will stop 
batch file execution)
ECHO .. prints any input to the output untill the input starts with END.
Useful in batch files.

#) EXCI library is loaded dynamically t runtime, can have any name
#) Command EXCI was added to load another library 

#) Plot 2-dimensional map of S(Q) map in E=const. plane (use commands 
mfit/mapsq) ASCII data are stored in the file sqmap_2d.dat.

#) Building and installation scripts were updated. For supported
systems, compilation and installation is performed in following steps:
% configure <system> -all
% make
% make excilib 
% Install <target directory>

#) Starting scripts for RESTRAX were improved to permit selection from
scattering (EXCI) models on startup by making appropriate link to *.so
library.

#) Config. file is NOT READ automatically before each command !!!
 Reload the file by the command CFG when needed.

#) Max. number of free parameters increased to 64 (recompilation of
EXCI library is required, library name has changed to libres_exci.so).

#) Command INIT added in fitting dialog: reads parameters from file and
initializes EXCI

#) Added new scattering models:
... Damped oscillators (quadratic form of dispersion, up to 6 branches)
... Damped oscillators with free dispersion gradient
... Phonons in Si, Ge, ... (bond charge model)
... incommensurate satellites (1..6), infinite in energy

    !! Damped oscillators are newly compiled in RESTRAX as the default model !!

#) DATA dialog extended:
   - open, add, delete multiple data (range of data filenames given as numbers)
   - create new data sets without actually loading data - used to simulate data 
     instead of fitting real experimental results

#) New variable DA3 determine scans in A3 (sample rotation) 
   - scans in A3 are recognised in ILL data format
   - scans in A3 (i.e. non-linear in QHKL,E!) are handled by all routines 
     generating scan profiles (FIT, PHON, MFIT, MPHON)

#) Flate-cone analyzer: 
   - switch on/off the flat-cone mode by AMOD command
   - added new options for plotting res. functions and data in flat-cone mode
     (plotting 2-dim maps for all channels and full range in A3)
   - new variable DA4 is used to define step in scattering angle
   - each channel is handled as one data set (up to 64 channels can be used)


************************************************************************
NEW in RESTRAX 4.7.6 (September 2003) 
************************************************************************
1) Added SHELL command: executes any system shell command from RESTRAX, e.g. 
   >SHELL
   >ls -l

2) When setting PATH to data files and loading the FILE, current value
   is offered as a default (accepted by <ENTER>). e.g.
   >FILE
   >Name of a parameter or data file [default.res] : 


************************************************************************
NEW in RESTRAX 4.7.5 (Dec 2002) 
************************************************************************
EXCI library renamed to lib_res_exci.so !!

Older EXCI libraries must be recompiled !!
Use template res_exci.f with new include files (const.inc inout.inc exci.inc) found in the
./exci directory. Old templates may not work properly, but conversion to the new one should be easy. Look in the template for
comments or send mail with the old EXCI source file(s) to saroun@ujf.cas.cz.


************************************************************************
NEW in RESTRAX 4.7.3 (September 2002) 
************************************************************************

1) Dimension of free parameter array increased to 64. 

!!! OLDER VERSIONS OF EXCI HAVE TO BE RECOMPILED WITH NEW "const.inc" , "inout.inc" and "exci.inc" !!!


2) Source temperature can be set different from the default value (300 K) in the *.cfg file as the 5th number in the "source" line, e.g. 

    source (shape,diameter,width,height,temp):
    0   21.   6.    12.    25


3) RESOL command retired. Instead, 
   
   RES  [1..4] does the same as the former RESOL [1..4] 
   MRES [1..4] does the same as RES, but using M.C. result instead of TRAX
   
4) commands added:
   MFWHM [h k l]      ....  as FWHM, but using Monte Carlo resolution matrix
   MFIT               ....  as FIT or PROF, using Monte Carlo resolution matrix
   
   In summary:
   RES,BRAG,FWHM,FIT      ....  use analytical (TRAX) resolution func.
   MRES,MBRAG,MFWHM,MFIT  ....  use Monte-Carlo generated resolution func.


5) minor changes in the output file format (for clarity)
 


************************************************************************
NEW in RESTRAX 4.7.2 (April 2002) 
************************************************************************

1) The fitting dialog have been upgraded. Since this version, PROF and FIT commands are  synonyms 

2) New EXCI library template: res47_exc.f.
EXCI have been simplified - it doesn't need to take care about the input of free model parameters! 
Declarations in "exci.inc" include file also changed. It provides now more information about current spectrometer setting. 

!!! OLDER VERSIONS OF EXCI HAVE TO BE RECOMPILED WITH NEW "exci.inc" !!!



************************************************************************
NEW in RESTRAX 4.7 
************************************************************************

LSCFG command: lists available configuration files with descriptions (=text on 
the 2nd line of the *.cfg files) 



************************************************************************
NEW in RESTRAX 4.6 
************************************************************************

Command interpreter: 
--------------------

Type ? to get hints on available commands.
Abbreviated commands are accepted (if not ambiguous).

String arguments are now accepted, e.g. 
FILE filename
CFG filename etc...

The number of events required for the M.C. simulation (x1000) 
can be passed as the second argument of the commands calling
Monte Carlo (PHON 2, PROF 2, FIT 2, MBRAG, PLOT 3 etc..)

Example:  FIT 2 2.5 accumulates 2500 events and use them 
subsequently in the fitting procedure.

By default, the last number of events is used in any new simulation, 
until a new number is specified as the second argument.


Multiple data fitting:
----------------------

Use the command DATA to switch to the data manager. It permits to 
- load/delete multiple experimantal data
- start Monte Carlo to get (Q,omega) events for all configurations
- tag/untag items to be included/excluded from fitting
- select current data

(type ? for hints and 'quit' to return to ResTrax)
After return, the selected data set is used for visualisation and other 
'conventional' tasks, including BRAG, PHON and othe commands.
The Restrax prompt then informs you about the item number of the
current data set.

Command FIT performes the fitting for all tagged data.


New TAS configuration file (*.cfg) format !!
--------------------------------------------
(refer to README)


************************************************************************
NEW in RESTRAX 4.46 
************************************************************************

AMOD  [n]     - permits to turn the analyzer part up (SA=1) or down (SA=-1)
                from the scattering plane, instead of conventional horizontal 
                arrangement. If argument is missing, current state is printed.

! NOTICE !  This configuration is considered by Monte Carlo simulation only. 
            TRAX results (like BRAG or PHON) take only conventional setting
            into account.  

Values in BET1..4 now influence Monte Carlo results: if 0<BET<500, 
then appropriate number of vertical lamellae is considered. Combination with
0<ALFi<500 is possible. However, if ALFi=0, the collimator is ignored as before.

MBRAG [n]     - does the same as BRAG, but with resolution matrix calculated 
                from Monte Carlo events

************************************************************************
NEW in RESTRAX 4.45 
************************************************************************

FWHM h k l    - prints Bragg and 'vanad' widths in given direction (h,k,l)
                (can be non-integer)
                
BRAG [2] commands print now more information, which includes both Brag and 
'vanad' widths in all units (A^-1, r.l.u, scan steps)                



************************************************************************
NEW in RESTRAX 4.44 
************************************************************************

GRFDEV               set graphics device string for PGPLOT 


************************************************************************
NEW in RESTRAX 4.43 
************************************************************************

MAG  M A	    - set M(A) <>0 to force monochromator (analyzer)  
		      to reflect only neutrons with spin up (down) 

FLIP fM fA	    - flip neutron spin before (after) the sample
SPIN  si sf         - set si,sf to select only events corresponding to
                      given spin transfer 
                      e.g. SPIN 1 -1 means that only |up> --> |down> 
                      events are selected. Type SPIN 0 to select all.


************************************************************************
NEW in RESTRAX 4.41 
************************************************************************
CFG       - set name of the configuration file (default='restrax4.cfg')
OUT       - redirection of output to a file
BAT       - ALL following commands will be taken from a given batch file
EMOD  n   - set on (n=1) or off (n=0) the elastic scattering mode,
            when only the section at EN=0 is simulated
            (only for the arrangement without analyzer, SA=0)
            EMOD without parameter informs about current mode 
SCAN n    - plot the profile of the resolution function in dependence on 
            the specified coordinate and integrated over the others
            n=1 (or no parameter), scan along Qx
            n=2                    .......... Qy
            n=3                    .......... Qz
            n=4                    .......... E
            n=5                    .......... Kf                                    

