tf2tree converts FITS tables into ROOT TTrees and ROOT TGraphs
	and it can convert FITS images into ROOT histograms and ROOT TTrees.


Either all extensions in a FITS file or just one extension in a FITS file are
converted into ROOT - TTree(s), TGraphs or TH1x and TH2x.
Variable bin size columns are not converted. 
Each other column of a table is converted into a TBranch of a TTree. 

Two columns of a Table are used to build a TGraph, two further columns 
can be used to define the errors.

A one or a two dimensional FITS image can be converted into a ROOT histogram.

A n - dimensional FITS image can be converted into a ROOT TTree. One branch for
each dimension as well as one branch for the pixel value is created. One record
per pixel, which is not NULL, is written into the TTree with pixel value and 
location of the pixel in each axis.

The header is written as a TFIOElement into the same output file.


Program parameters:

  inFile   	input file name. It has to be a *.fits or a *.fits.gz file or
                one of the other accepted file formats with AstroROOT containers:
                *.root and *.asro


  all_data	if set to "yes" all extensions of the input file are converted.
                if set to "no" only the extension depending on the two following
                parameters are converted.

  element_name  the element name of the extension that should be converted.	
  		An error message is printed if this extension does not exit in the 
                input file.

  cycle		defines the "index" or cycle number of the table if more than
                one extension with the same element name exist in the input file.
                The first element has cycle 1 (not 0).
                The first extension in the file with name element_name will be 
                converted if cycle is set to 0.

  outFile  	output file name. It should be a *.root file

  table_to_tree FITS table(s) are converted to ROOT TTree(s) if this paraemter
  		is set to yes

  name_convert  the column names as well as the extension names can be converted
                to lower case or upper case. Accepted input strings are
                TO_LOWER, TO_UPPER and NONE

  convert_to_underline  one ore several characters in the table name as well
                        as in the column name can be converted to 
                        underline (_).

  table_to_graph	FITS table(s) are converted to ROOT TGraph(s) if this
  			parameter is set to yes

  x_column	defines the columns name to be used as X - Axis in the TGraph

  y_column	defines the columns name to be used as Y - Axis in the TGraph

  x_err_col	defines the columns name to be used as error for the X - Axis
  		The parameter may be empty.

  y_err_col	defines the columns name to be used as error for the Y - Axis
  		The parameter may be empty.

  image_to_histogram	FITS image(s) are converted to ROOT histogram(s) if 
  			this parameter is set to yes

  histogram_type	defines the output ROOT histogram. It can be one of
  			the following types:
                        TH1C TH1S TH1F TH1D TH2C TH2S TH2F or TH2D

  image_to_tree		FITS image(s) are converted to ROOT TTree(s) if 
  			this parameter is set to yes

Error Messages:
  
  error during reading parameters (-3003)
        This  message  shows  that  the program cannot read its	parameter file  
        tf2tree.par.  Properly the environment variable PFILES is not set. 
        PFILES should define the path  where  this parameter file is stored. 
        During installation  of  the AstroROOT package this parameter file is 
        copied to ${ISDC_ENV}/pfiles.
        See also in the installation guide at point 3 for an example to set 
	this environment variable.