This is the README file for the experimental version of the ANA, AVE and ROD
programs.

----------------------------------------------------------------------
  CVS information:

  $Id: README.txt,v 1.12 2007/09/19 13:15:19 wilcke Exp $
----------------------------------------------------------------------


Version experimental 1.4 19/09/2007
-----------------------------------

This version is based on "version standard 1.2". All changes made there have
been incorporated into the "version experimental 1.3"; in particular the
adaptive simulated annealing (ASA) for ROD has been included and the cooldown
method (COOL) been removed.

The following additional changes have been made since version experimental 1.3:

* ROD:  - implement simplified functional form of Lennard-Jones potential.
        - add code to edit the ROD input files with an online editor and read
          the modified values back into the program.
        - automatically recognize and read input files written using different
          extension features of ROD. These extensions can write additional
          parameters to the output files. They will now be read back correctly
          to the corresponding variables.


Version experimental 1.3 31/03/2006
-----------------------------------

This version is based on "version standard 1.1". All changes made there have
been incorporated into the "version experimental 1.3"; with the exception of
the adaptive simulated annealing (ASA) for ROD, which is not yet included.

The following additional changes have been made since version experimental 1.2:

* ANA:  - add new geometry "ID32_k" (k geometry, simulating 2 + 2 vertical).
        - 3 new fit functions: with 4 and 5 Gaussian peaks, and with a combined
          Gaussian-Lorentzian peak.
        - modify background calculations for fits: add a quadratic background
          function, allow user to choose between linear and quadratic
          background, and add possibility to fit a spectrum with the background
          function only.

* ROD:  - add slab model.
        - add flag to multiply Fsurf by bulk roughness factor.
        - add scattering factors for Cl-, Ga3+, Mn, O-, Rh, V.
        - new "occ" profile for extended model.
        - modify code to deal with complex atomic scattering factors.
        - add code for the deformation of groups.
        - add occupancy four groups.


Version experimental 1.2
----------------------------------

This version is based on "version standard 1.0". The following changes 
have been made by Elias Vlieg since version experimental 1.1:

* ANA:  - Linear gamma: flag to denote whether gamma circle (on 6-circle
          diffractometer) is implemented as linear table.
        - Transin: Transmission of incoming beam.
        - Transout: Transmission of outgoing beam.
        - Fit: Now uses FWHM instead of HWHM.
        - Despike: Try to remove spikes from a spectrum.
          Spikes are single points that are several standard deviations 
          higher/lower than their neighboring background points.
        - Level: Try to level the sloping background of a spectrum. 
          Four points on either side of the spectrum are used to 
          determine the slope in the background.
        - Added Spec file of DUBBLE type.
        - Added (2+3) diffractometer corrections.
        - Small changes in menu help texts.

* AVE:  - Introduced the possibility to make weight file with scan-number 
          column and extension .wgt (still possible to make an
	  ordinary weight file).
	- Added the possibility to average Friedel pairs.
        - Small changes in menu help texts.

* ROD:  - Added structure factors for Nd.

Changes common to ANA, AVE and ROD:

- Modified (for UNIX and CYGWIN) the main programs of ANA, AVE and ROD as
  well as the interrupt handlers in MENU to allow the correct use of
  CTRL-C interrupts.
- Added "autoplot blank" command. This will produce a blank plot - 
  useful for laying out plots on a page.
- Added new plot menu items "pushconfig" and "popconfig" that can
  temporarily save and restore the configuration of the plot.

There have been also changes to the ROD extensions, please consult the
documentation available at the ANA-ROD web site for more details.


Version experimental 1.1
----------------------------------

* This version contains extensions to ANA written by Rainer Wilcke 
  (wilcke@esrf.fr) and extensions to ROD written by Olof Svensson 
  (svensson@esrf.fr) and Chris Walker (cjw20@leicester.ac.uk). 
  The extensions written by Rainer and Olof have been ported from the
  "beta" version 2.4. Therefore the "beta" version has been
  removed from the download pages with the release of this version. 
  There's for the moment little documentation available about these 
  extensions, however we hope to be able to provide more documentation
  during the autumn 2000. Please consult the project web pages at 
  http://www.esrf.fr/computing/scientific/joint_projects/ANA-ROD
  for the latest updates of the documentation.

* There are no extensions to AVE, therefore the version of AVE is
  standard 0.93.

* Modified (for UNIX and CYGWIN) the main programs of ANA and ROD to
  allow the correct use of CTRL-C interrupts. Note: MENU in the standard
  version has been changed as well for this to work.

* ANA has been slightly modified in order to allow macros to be called
  from within a loop. However, this modification could have some
  unwanted effects when using the loop command, so please inform 
  Olof (svensson@esrf.fr) if you notice such unwanted effects.

* The "autoplot" command in ANA has been fixed.

  If one uses the subcommands "title" or "scannumber" once and then plots
  a whole sequence of scans with repeated subcommands "data" or "fit", then
  the plots will have the correct filename and/or scan number.

  Moreover, if one uses the "autoplot title" or "autoplot scannumber" command
  and then does the plotting directly with a "plot" command, the plot will
  have the correct filename and/or scan number. However, if one wants to plot
  a whole sequence of scans this way, the "autoplot title" or "autoplot
  scannumber" command has to be given before each "plot" command.

  Finally, a new "autoplot usertitle" command has been added. This allows to
  plot a user-defined title with the "autoplot data" or "autoplot fit" commands.
  For this to work, the "plot title" command should be used to define the
  title, then "autoplot usertitle" should be issued, and then the plot(s) can
  be plotted with "autoplot data" or "autoplot fit". All these plots will have
  the title as defined by the "plot title" command.

* A bug has been fixed in ROD that prevented fitting of SCALE2.

* The maximum number of many lists has been increased in ROD since 
  there's no problem any more with the MS-DOS 640 kB limit. The
  limits are now:

    MAXTYPES     14         /* Maximum number of element types */
    MAXATOMS     1000       /* Maximum number of atoms in model */
    MAXDATA      3000       /* Maximum number of data points */
    MAXTHEO      3000       /* Maximum number of theor. data points */
    MAXPAR       300        /* Maximum number of theoretical
                            // parameters of given type */
    MAXFIT       500        /* Maximum total number of fit parameters */

* The length of buffers containing file names has been set to 
  the macro FILENAME_MAX, which avoids problems encountered
  when using filenames longer than 30 characters. Note that on
  some systems this parameter is very small (e.g. 14 on HP-UX),
  but it will be redefined internally by ANAROD to be at least 1024.

* The version number is now defined in the Makefile and passed on via the
  C-preprocessor to the programs, where it is compiled into the version
  string of "ana", "rod" and "ave".

* The Makefile now allows for the possibility that there are no
  "lib", "bin" and "runtime" directories in the "experimental" version.
  If this is the case, it creates them and - for the "runtime" directory -
  copies the auxiliary files needed for ANAROD (e.g. the plot server) over
  from the "standard" version.


Version experimental 1.0
----------------------------------

This is the first experimental version. It contains one extension,
written by Odile Robach at the ESRF (robach@esrf.fr). Please consult
the project web pages at 
http://www.esrf.fr/computing/scientific/joint_projects/ANA-ROD
for the latest documentation of this extension. 

The experimental distribution of the ANA, AVE and ROD programs is based on 
the standard version, so the following points are common to both the
standard and the experimental versions:

* The menu functions are now based on NCURSES. This means that unless
  the programs find the "terminfo" directory they input/output will
  not work properly. On Windows 9X/NT this is set up automatically
  during the "Installshield" installation, however the programs must
  be started using the ".bat" batch files instead of the ".exe"
  files. This should be transparent since the ".bat" batch files
  are installed in the "WINDIR" and are linked to the "Start" menu.
  Under UNIX, if the terminal can handle programs like "vi" or "emacs"
  then the ANA, AVE and ROD programs should work. If there is a 
  problem with the formatting of the input/output or if certain
  keys don't work the problem is most probably incorrect setting
  of the TERM environmental variable.

* The plotting functions are based on PGPlot. On Windows 9X/NT,
  as for the menu functions mentioned above, the plotting is set up 
  automatically during the "Installshield" installation and the 
  programs must be started using the ".bat" batch files instead 
  of the ".exe" files. On UNIX the environmental variable
  PGPLOT_DIR must be set to the installation directory of the
  ANA, AVE and ROD programs.
