==========================================================================
                Help File for ephin_lev1.ped
==========================================================================

NAME
----
	ephin_lev1.ped :

            This pipe mainly uses the task ephin_calc_rate1 that combines 
        the science coincidence counters in the EPHIN L0 product with the 
        geometric factors to obtain 13 science coincidence countrate for 
        the EPHIN L1 product.

            13 EPHIN coincidence count rates have 4 for electrons, 4 for
        protons, 4 for helium, and 1 for high energy of all species.
        EPHIN stands for Electron Proton Helium Instrument.  It is
        used to detect high energy particles.  These count rates will
        be used in the Mission Time Line for Good Time Interval
        determinations.


USAGE
-----
        flt_run_pipe -r <root_name> -i <indir> -o <outdir> -t ephin_lev1.ped 
                     -a revision=<revision_number>
        
                where  <root_name> = root name of infile
                       <indir>     = directory of infile
                       <outdir>    = directory of outfile

DESCRIPTION
-----------
        This is a list of the task name and what each task does relative to the
        pipelines needs. Please refer to documentation for each task if more
        information is required.

        ephin_lev1_calib - collects the geomfile from the CALDB
        ephin_calc_rate1 - computes 13 EPHIN coincidence count rates
        update_revision  - calls dmhedit to update the value of revision
        add_caldbver     - calls caldb_update_version to add CALDBVER

INPUTS/OUTPUTS
--------------
      1) Input files for the pipeline

	 EPHIN L0 products ------> ephin<root>_hkp0.lis
		  list of Level 0 EPHIN housekeeping files 
                  ( eg. ephin*_hkp0.fits )

	 NOTE: If there is more than one file in ephin<root>_hkp0.lis,
	       the files must be from the same observation and they
	       should be arranged in an ordered time sequence.

      2) Output files from the pipeline

	 pctr profile, log --------------> <root>.ped
					   <root>.ped.log

	 EPHIN L1 product ---------------> ephin<root>_lc1.fits
	          which contains a set of 13 EPHIN coincidence count rates 


PARAMETERS
----------
  Input Parameter File Name: ephin_lev1.par

        The parameter file sets the 'EPHIN geometric infile' for the task
        'ephin_calc_rate1'. It also sets verbose and clobber for all tasks.

#--------------------------------------------------------------------------
#
#       ephin_lev1.par     Parameter file for EPHIN LEVEL 1 PIPELINE
#
#--------------------------------------------------------------------------
#-----------------------------------------------------------------------
#general parameters for the pipeline
#-----------------------------------------------------------------------
verbose,i,h,1,,,"Level of verbose. 0=none, 5=most"
clobber,b,h,yes,,,"Clobber any existing output?"
#-----------------------------------------------------------------------
#       EPHIN LEVEL ONE:ephin_calc_rate1 parameters
#-----------------------------------------------------------------------
geomfile,s,h,"/data/CALDB/data/chandra/ephin/bcf/geom/ephinD1999-07-22geomN0001.fits",,,"EPHIN geometric infile"
mode,s,h,"ql",,,


EXAMPLE
-------
        % flt_run_pipe -r f123456789N000  -i in_dir  -o out_dir 
                       -t ephin_lev1.ped  -a revision=1


NOTES
-----
        See the tool documentation and help files for specifics on
        each tool in the pipeline.

        See help on flt_run_pipe (flt_run_pipe -help), flt_pctr and
        pbuilder.pl for information on the pipelines.


SEE ALSO
--------
        ephin_calc_rates1 


DATE
----
        Date last modified: August 2000 ; initial version 12/11/98