----- file created by makedoc on: Tue Apr  1 15:29:57 2008

----- Documentation for /scisoft/xop2.3/extensions/shadowvui/src/vui/xsh_mlayer.pro -----

   ===========================  XSh_MLayer   =========================

   XSh_MLayer is a widget based graphical interface to use the code
   mlayer. Mlayer is part of the ray tracing code SHADOW and calculates
   the reflectivities and among other quantities of the multilayers.

   The main window contains four buttons:

	QUIT: to exit from the program

	SET PARAMETERS: to define the parameters for the calculation
		LAYER PERIODICITY: Multilayer may be periodic or
		aperiodic. In the first case you may define the number
		of layer pairs and the thickness of the two components 
		of the pair. In the secon case you must prepare a file 
		containing two columns and N rows, one row for each pair.
		The first element of the column is the thickness in A of 
		the odd element and the second column is the thickness
		of the even element.
		SCANNING VARIABLE: Grazing angle [deg] or Photon 
		Energy [eV]
		SUBSTRATE: Chamical symbol for the substrate.
		ODD LAYER MATERIAL's chemical symbol for the odd layer
		EVEN LAYER MATERIAL's chemical symbol for the even layer
		PHOTON ENERGY: in eV
		GRAZING ANGLE: in degrees
		SCANNING VARIABLE STEP: the spep in either Photon energy
		or grazing angle, depending on your choice.
		NUMBER OF SCANNING POINTS: obvious.
		THICKNESS FOR THE ODD MATERIAL in A, when periodic
		Mlayers are considered.
		THICKNESS FOR THE EVEN MATERIAL in A, when periodic
		Mlayers are considered.
		NUMBER OF LAYER PAIRS when periodic
		Mlayers are considered.
		FILE WITH LAYER THICKNESSES: file name with thicknesses
		as explained before, valid only when Individual layers
		are considered.

		
	SHOW: Produces a graphic of the selected option

	HELP:   Shows this text


 ----------------------------------------------------------------------
	Mlayer has been witten by J.H. Underwood at CXRO and is part 
	of the SHADOW package. M. Sanchez del Rio has modified it to
	directly call the SHADOW optics library, which gives correct
	values of refraction indeces when the energy is scanned.
	M. Sanchez del Rio (srio@esrf.fr) has writen this graphic 
	interface.

	MSR 94-03-02
       Modification history:
	  95-11-07 MSR adapts to xop 1.3b. Adds in/out input file.
	  97-01-21 MSR adapts to Windows95. Cosmetics. Version 1.1.
	  97-10-01 MSR renames read_ascii by rascii
	  97-10-02 MSR uses sdep(), xop_wd and other cosmetics.
	  97-10-06 MSR replaces xop_defaults() call by shadow_defaults()
		call and places xsh_mlayer.pro in the exrtensions/shadow dir.
	  97-12-05 MSR adapts for SHADOW-GUI. Version 1.2.


