----- file created by makedoc on: Tue Feb 11 14:15:25 2003

----- Documentation for /scisoft/IDL/scisoft/xaid/src//xaid_mu2chi.pro -----
 =================================  xaid_mu2chi ===============================



   The documentation for XAID (the XOP's XAFS toolbox) can be found at:
   http://www.esrf.fr/computing/scientific/xop/xaid/doc/

   xaid_mu2chi is a widget based graphical interface to perform the
   XAFS background substraction. Among several different  operations 
   xaid_mu2chi may extract the Eo value from the maximum of the derivative, 
   get automatically or manually the Jump value, perform polynomial 
   and multispline fits, and allows three methods of normalization.
   
   The main window contains the following controls

	FILE Menu:
	  LOAD FILE: To Load a File with Data. The file must contain 
		the data in ascii formatted in two columns. It
		may content comments becoming by a non-numeric (nor + - .)
		character. The program stores the data and reads 
		automatically all the points and columns
	  SAVE FILE: wites an ASCII file with the current data on the
		display. The file may contain one or two data sets
		depending on the number of curves plotted.
	  PRINT:  Send a copy of the current set data to the printer.
	  QUIT:	Exit or Quit the program

	VIEW Menu:
	  REFRESH: Updates the graphic display with the current data sets.
	  DATA: shows the data set[s] numerical values.
	  XPLOT: Send the data in the graphical display to the XPLOT
		application, which allows more sophisticated analysis.

	OPERATION 1 Menu:
	  Must be called when only one curve is present in the display.
	  These operations apply to a SINGLE CURVE
	  CUT: Permits to reduce the horizontal limits of the data
	  DERIVATIVES: Shows at the same plot the signal and
		its two first derivatives
	  INTERP: Allows Linear or Spline interpolation. (See IDL doc)
	  GET Eo: Gets the Eo from the maximum of the derivative, and 
		allows the user to change it or input another one.
	  JUMP: Gets an initial Jump value and allows the user to 
		change it.
	  FIT POLYNOMIAL: Allows Least Squares od Singular Value 
		Descomposition polynomial fits. (See IDL doc)
	  FIT MULTISPLINE: allows multi-spline polynomial fits.
	  FOURIER FILETERING: Performs Fourier Filtering by using the
		xaid_ff application.

	OPERATIONS 2 Menu:
	  Makes operations between TWO data sets on the display
	  SUBSTITUTE: Puts the set2 as set1 and deletes the set1
	  SUBSTRACTION: performs the substractin of the ordinates
		of the set1 minus the set2 and places the result
		as a new set1. Set2 is deleted.
	  EXTRACTION: Three tipes of EXAFS extraction or normalization.

	TOOLS Menu: Calls several GUI applications (including this one).
       HELP:   Shows documentation to several related XAFS routines.

		
 ======== Non-interactive use of XAID_Mu2CHI ====================

	NAME:
		XAID_MU2CHI
	PURPOSE:
		 X user interface for cnpick. To analyse EXAFS data
 	CATEGORY:
		Widgets. XAFS data analysis.
	CALLING SEQUENCE:
		XAID_MU2CHI [,filename] 
	OPTIONAL INPUT PARAMETERS:
		filename: a string containing the file name to be
		plotted or an idl variable [fltarr(2,n_points]
		with data. The file must be ascii data arranged in 
		columns. Lines starting with characters [except . + -]
		are comments and not considered for the plot.
	KEYWORD PARAMETERS:
		GROUP = The widget ID of the widget that calls Xplot.
		When this ID is specified, a death of the caller results 
		in a death of XAID_Mu2Chi.
		NO_BLOCK = If set, starts Xmanager with the No_Block keyword.
		WSIZE = The initial size of the graphical display in pixels
	OUTPUTS:
		Open a widget utility and present a graphic.
	COMMON BLOCKS:
		None
	SIDE EFFECTS:
		If not active, starts Xmanager
	RESTRICTIONS:
		Unknown.
	PROCEDURE:
		Uses XAID data analysis IDL library.
	MODIFICATION HISTORY:
		Written by  Manuel Sanchez del Rio. ESRF. 11 October 1994
		96-08-22 MSR creates a new version from the old xcnpick.
		97-01-14 MSR fixes for Windows.
		97-09-08 MSR adds NO_BLOCK keyword
		97-09-30 srio@esrf.fr READ_ASCII renamed to RASCII
		97-10-25 srio@esrf.fr small fixed in main window.
		98-10-01 srio@esrf.fr adapts for delia. Use of catch.
		99-02-18 srio@esrf.fr adapts XOP 2.0
		00-02-15 srio@esrf.fr adapts for Exodus. Centers 
			the screens. Adds *1000 and :1000 operations.
			Allows to load a spline.


