---- UDFtoref, unique version 1.0, Summer 98 ----

An application to build one reflectivity data file starting from more 
Philips UDF files collected on the same sample using different attenuators.
The problem arise from the fact that near the total reflection angle
you cannot use the entire beam, but you have to decrease the intensity of
the beam using an attenuator. Going away from that angle you can remove 
partly or entirily the attenuator allowing more intensity to come to the 
detector. To build at end a unique file for the analysis it is important
to compute the attenuator factor. To do so, you have to provide the two or 
more original files having an overlapping region. The program use this
region to compute the attenuator factor to be applied in converting
and concatenating the files.
For more information about the purpose and use of the resulting file or
on how to collect the original data files refers to: 

Alain Gibaud
LPEC
Universite' du Maine
Le Mans - Cedex
France
E-mail: Alain.Gibaud@univ-lemans.fr

For questions about the program itself refer to:

Luca Lutterotti
Dipartimento di Ingegneria dei Materiali
Universita' di Trento
Trento
Italy

E-mail: Luca.Lutterotti@ing.unitn.it


------ Installation notes ---------

On windows and mac two istallers are provided that will setup all and build
an executable under the name UDFtoRef.
One installer (smaller in size) does not contain a Java VM and is designed 
for computers that already have one.
In case you are not sure of what you have in your computer, download the 
version containing the Java VM otherwise that program cannot run; again
the Java VM provided is the standard one and if you already have it at
least you will install also the last version available.
Another installer contains also the Java VM and will install this Java VM.
(The installers are in beta and will expire on December 1, 98; another not
expiring version will be provided in the future).
Double clicking the installer will install the program.

- Notes: 

On the Mac if you have Mac OS 8.0 or later you already have the Java VM
installed and you can use the Installer without VM.
For windows: only Windows 95/98/NT are supported. If you have only 3.x or
DOS you can try to download the JavaPC from Javasoft and use the other
pattforms installation. See also the notes about running the program below.

- How to run the program.

Double click the UDFtoref program icon or start it from the menu (the 
location of the alias or shortcut depends on the installation process and
options used) to launch the program.

- For others plattforms (any):

The program is written in Java and can run in any plattform supporting
Java 1.1 (Obviously you need the Java VM already installed). 
The only necessary file is the UDFtoref.jar archive. The command
line to run it can be (obviously you have to change it depending on
the particular java version you have): 
jre -cp UDFtoref.jar UDFtorefFrame

-----------------------------------------------------

- Program help:

An example is included. These guidelines will explain how to use the program
using the example.

- Run the program.
- On the window appearing select "add file" to add the three data files that 
  must be concatenated in one experimental reflection file. Add one by one 
  pressing any time the "add file" button the three files: OTS1P#.UDF (the 
  loading order is not important).
- If you load the wrong file you can select it by the mouse and press the 
  "remove" button to unload it.
- Selecting one of the files and pressing the "view data" button you can 
  preview the data file. Two windows, one exactly over the other will be
  displayed using a different scale (one normal the other a log scale).
- Press the "Convert" button to concatenate the files. A dialog box will
  appear asking for a confirmation of the computed attenuator factor. You can
  change it if you like. Press "ok" to continue. The "done" dialog advices 
  the end of the conversion.
- After conversion you can view the concatenation result pressing the button
  "View results". Also in this case two frames with two scales are availables.
- Save the concatenated file using the "Save as.." button. Warning: no result
  is saved until you use the save as button.
  
Other notes: in any plot window you can use the mouse to select a rectangle 
             for zooming. A double click on the graph will reset the zoom.
             You don't need to exit the program to change to another 
             translation, just change the input data files and press "Convert"
             again, also if you want to just use a different attenuator factor.