Program name: abrefr	Version: 1.7 (November 1999)
===================================================

Author:  Petr Mikulik
Address: Department of Solid State Physics and
	   Laboratory of Thin Films and Nanostructures
	 Faculty of Science, Masaryk University
	 Brno
	 Czech Republic

E-mail: mikulik@physics.muni.cz
Author's Web Page and this program location: http://www.sci.muni.cz/~mikulik/

Description: 
============

This program can be of interest of X-ray scattering (reflectivity, diffraction)
scientists, since it calculates

  - refractive index, mean susceptibility, forward structure factor,
  - critical angle, 
  - mass density,
  - Bragg angles,
  - interplanar distances,
  - interplanar angular distances (angles between crystallographic planes)

for any crystal system (Bravais lattice) given. 
  Polynomial approximation of the atomic scattering factors and dispersion 
corrections for some wavelengths, needed for the calculation of the structure 
factor, are taken from the "International Tables for X-Ray Crystallography" 
(1974).


This program is freeware (open source, source code included). It is distributed
under the copying policy of the GNU General Public License; see the file
COPYING for more details.


Operating system supported: 
  any with a decent C++ compiler (compiles fine under OS/2, DOS, VMS, Unix).
  Enclosed are several makefiles for various compilers, see Makefile or
  Make*.def

Executable file "abrefr.exe" for OS/2 and DOS enclosed. For running, it 
requires (an experienced programmer have surely already installed, mainly 
if he uses emtex or gcc/emx or rsx):
  - OS/2: nothing special
  - plain DOS: requires extender emx.exe (see emxrt.zip at hobbes.nmsu.edu) 
  - DOS with DPMI server (DOS box of OS/2 or Windows, OpenDOS/Novell DOS/QEMM 
    DPMI servers) requester externder rsx.exe (see rsx???.zip at 
    hermes.hrz.uni-bielefeld.de)
  - WinDOwS NoTechnology: there is rsx???nt.zip at the above-mentioned site


Compilation: 
============

1. The compilers under Unix or VMS prefer to use extension .cxx instead of 
   .cpp. "Makefile" runs "sh cpp2cxx" automatically, but on VMS please type 
   "ren *.cpp *.cxx".

2. Please edit "Makefile" and comment out "include"-ing Make?.def for the 
   used compiler; default is GNU C/C++ (g++) under Unix.

3. Run command "make" (or "gmake" for GNU make, if your machine's default 
   "make" fails).



Usage: 
======

1. Calculation of the refractive index, mean susceptibility, forward structure 
   factor, critical angle, mass density: run the program by
	"abrefr -r"

2. Calculation of the Bragg angles: run the program by
	"abrefr -b"

3. Calculation of the interplanar distances and interplanar angular distances:
	"abrefr -a"


History:
========
  o version 1.6, November 1999
	- improved error detection on user input
	- can change wavelength during calculation of Bragg angles
	- accepts input of both wavelength and energy
  o version 1.5, February 1999
	- "refraction index" must be "refractive index"
	- updated for g++ 2.8.1 and HP CC compilers
  o version 1.4, October 1996
	some minor changes
  o version 1.3, spring 1996
	bugfix release
  o version x.y, April 1995
	first released version
