Documentation for  xaid_ff.pro

----- Documentation for xaid_ff.pro -----
 =================================  xaid_ff ===============================

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

		
   xaid_ff is a widget based graphical interface to perform the
   XAFS Fourier Filetering. It presents in three windows the XAFS
   signal, the Fourier transform and the Back Fourier Transform, together
   with widget controls to change the transformation parameters and limits.
   
   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 signal, FT and BFT.
		It is written in ASCII with header keywords as in the
		SPEC data files in order to be read with XPLOT. 
		Use XPLOT with this saved file for printing.
		
	  QUIT:	Exit or Quit the program

       HELP:   Shows documentation to several related XAFS routines.

		
 LAST REVISION: msr/msr 2009/05/25

 ============= Non interactive use of xaid_ff ========================

	NAME:
		XAID_FF
	PURPOSE:
		 X user interface for Fourier Filtering. To analyse EXAFS data
 	CATEGORY:
		Widgets. XAFS data analysis.
	CALLING SEQUENCE:
		XAID_FF ,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.
		DELIAID = the structure with the widgets ids when xaid_ff is
		  called from the DELIA program.
	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. 96-08-26.
		97-09-08 MSR adds NO_BLOCK keyword
		97-09-30 srio@esrf.fr READ_ASCII renamed to RASCII
		98-10-02 use of catch. Adapts for delia.
		99-02-18 adapted for xop2.0
		05-03-14 srio@esrf.fr adapted for delia2.0
		2009-05-14 srio@esrf.eu improves communication with
                  exodus. xaid_ff_draw modified and renamed to xaid_ff_plot 


  

   Example of using of xaid_ff from external programs: 
	The Parent keyword permits to store the application id and 
	reuse it from other applications. Some routines allow the
	data manipulation:
		xaid_ff_loadfile,parent,set
		xaid_ff_plot,parent

  HELP FOR THE USE OF NON-INTERACTIVE ROUTINES: 



 
 xaid_ff_plot, parent, save=file, ft=setf

 setf: output array with FT (R,Modulus,Real,Imag)




 PRO xaid_ff_loadfile,id,file

 defaultfile: Used to initialize Dialog_Piackfile()
 path: kw passed to Dialog_Piackfile()

 2009-05-15 srio@esrf.eu adds defaultfile and path kw.

