----- file created by makedoc on: Fri May 31 15:22:20 2013
----- Documentation for /scisoft/xop2.3/extensions/shadowvui/src/lib/infosh.pro -----

 NAME:
	INFOSH
 PURPOSE:
	INFO about the selected SHADOW structure in IDL
 CATEGORY:
	SHADOW's utilities.
 CALLING SEQUENCE:
	infosh,  shadow_in,keyword_parameters
 INPUTS:
	shadow_in  may be:
          a SHADOW file (between quotes): eg. 'begin.dat' or
          an IDL-SHADOW structure (without quotes)
 KEYWORD PARAMETERS:
		NOLOST = consider losses
			0 all rays (default option)
			1 exclude losses;
			2 consider only losses;
               POLARIZATION = when set to 1 calculates the polarization 
                              parameters:
                              Is (total intensity for s-polarization)
                              Ip (total intensity for p-polarization)
                              S0-stokes = |Es|^2 + |Ep|^2
                              S1-stokes = |Es|^2 - |Ep|^2
                              S2-stokes = 2 |Es| |Ep| cos(phase_s-phase_p)
                              S3-stokes = 2 |Es| |Ep| sin(phase_s-phase_p)
		GROUP = When using widget output, this is the parent id
		NOWINDOW = when set to 1, eliminates the widget output
			which is the default with x windows
		ASK = when set to 1 presents a window to check the
		      parameters before starting infosh.
		_EXTRA = extra: other kwywords to be passed to XScrMenu (if ASK 
			is set).
 OUTPUTS:
	interactive info on the screen.
 PROCEDURE;
	Similar to SHADOW's original.
 MODIFICATION HISTORY:
	M. Sanchez del Rio. ESRF. Grenoble, May 1991
	1-Sep-1992 MSR change input file/structures
	30-Sep-1992 MSR introduces the polarization parameters
	02-Oct-1992 MSR adds GETPHASE to correct phases for stokes parameters
	10-Feb-1995 MSR makes a widget to display the results
	12-Nov-1997 MSR users "cd" instead of spawning "pwd". Sdep() also used.
	18-Mar-1998 MSR checks for the existence of the file.
	20-Mar-1998 MSR adds the ASK keyword.
	30-Jun-2000 MSR adds the _EXTRA keyword.
	24-Mar-2003 srio@esrf.fr adds the "intensity wiighted" options.
		Rewritten using readsh, xdisplayfile1, etc. 
	08-Mar-2012 srio@esrf.eu fixed a bug in results using intensity
                   (noticed by boesecke@esrf.eu).


