----- file created by makedoc on: Tue Mar  3 17:24:56 2009
----- Documentation for /scisoft/xop2.3/extensions/shadowvui/src/vui/xsh_transmit.pro -----


   ===========================  XSh_transmit   =========================

   XSh_transmit is a widget based graphical interface to calculate 
   the transmission in terms of energy vs flux or power of an x-ray
   beamline. Source is generated by XSh_SRComp, XSh_Wiggler_Spectrum or
   eneterd from external files [called XSH_SRCOMPE (eV,#Phot/sec/0.1%bw)
   and SRCPMPW (eV, Watts/eV)].
   The reflectivity and transmission coefficients are obtained from
   the Fresnel equations.
   XSh_transmit is an interface for the program transmit, available
   in the SHADOW ray-tracing package.

   The main window contains four buttons:

	QUIT: to exit from the program

	SET PARAMETERS: to define the parameters for the calculation
	   these parameters are the following
		NUMBER OF OPTICAL ELEMENTS to be used for the calculation.
		min=1, max=5
		RESULTS IN: Select Flux or Power for the presentation 
		of results.
		
		Then 5 lines, one for each optica element [mirror or 
		filter]. Lines are hidden when not used. Each line has
			KIND OF ELEMENT: Filter or Mirror
			SYMBOL OF ELEMENT: Capitalized, 2 letters.
			FILTER THICKNESS in microns [if filter is selected].
			INCIDENCE ANGLE in degrees [if mirror is selected].

	SHOW:	Produces a graphic with the selected option
		These options are:
		SOURCE a graph of the source spectrum.
		DATA show a list of important parameters of the 
		optical elements in use.
		LOCAL PROPERTIES [Reflectivity for mirrors and 
		Transmission for filters] of each defined element.
		The selection of each oe. is done inside the Xplot
		graphical window.
		CUMULATIVE PROPERTIES or the flux or power of the source
		after being reduced by the optical elements to the actual
		one.
		The selection of each oe. is done inside the Xplot
		graphical window.
		Is therefore possible to use XPLOT's overplotting capacities 
		to generate graphics containing all the curves. 

	HELP:	Shows this text

 -----------------------------------------------------------------------
	Author: M. Sanchez del Rio (srio@esrf.fr) , ESRF, Jan 1994
	Modification history:
		94/03/02 MSR removes the DENSITY entry. Uses the 
		tabulated values in p_table. Also removes the limitation
		in the chemical element symbols that had to duplicate
		the letter in the symbols with only one character.
		94/10/27 MSR removes common blocks, call xop_defaults
		95/11/07 MSR adds file in/out. Adapts to xop 1.3b
        Date     | Name  | Description
 ----------------+-------+-----------------------------------------------------
 07-AUG-1995     | RJD   | Modified the help text.
 ----------------+-------+-----------------------------------------------------
 17-JAN-1996     | MSR   | Modified the help text.
 ----------------+-------+-----------------------------------------------------
 19-JAN-1996     | MSR   | Makes the oe. selection inside xplot.
                 |       | Changes the help text.
 ----------------+-------+-----------------------------------------------------
	97/01/16 srio@esrf.fr adapts for Windows95.
	97/10/01 srio@esrf.fr renames read_ascii by rascii. Uses
		shadow_defaults instead of xop_defaults. Uses SDEP().
	97/10/02 srio@esrf.fr makes use of xop_wd,/default
	97/12/05 srio@esrf.fr adapts for SHADOW-GUI. version 1.1


