==========================================================================
		Help File for acis_lev2.ped
==========================================================================

NAME
----
	acis_lev2.ped --This pipeline is for Level 2 ACIS processing.


USAGE
_____
	1. Build the pipeline with pbuilder.pl and then run with pctr.

	   a) build the pipeline:
	    
              pbuilder.pl -t $ASCDS_SYS_PROF/acis_lev2.ped -r <root>
	      -i <indir> -o <outdir> > <pedout>

	   b) run the pipeline:
	   
	      pctr -prof <pedout> -log <othername> -showlog
	
	      <root>:			the data file prefix
	      <indir>/<outdir>		the directories containing the
                                        input and output
                                        files, respectively
	      <pedout>:	                the name of the PED file
					created from pbuilder.pl
              <othername>:              denotes the name of the log file 
					(<othername>.ped.log) If "-log
                                        <othername>" is omitted, then
                                        the default filename is "pedout.log".
               -showlog:	        displays log file during the running
                                        of the pipeline

	2. Use run_pipe which builds and runs the pipeline in one step.
 
           run_pipe -r <root> -i <indir> -o <outdir> -t acis_lev2.ped

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

	combine_events_stack - combine a stack of L1 ACIS event files from
			       the same observation to one single
			       file (L2 ACIS events file) using dmappend

	events_2_full - convert a L2 ACIS event file into a full fits image
		        file using dmcopy

	events_2_center_image - convert a L2 ACIS event file inot a fits
				image file that contains the center
				part of the data only

	celldetect - detect sources from the L2 ACIS events file

	
	INPUTS/OUTPUTS
	1)Input files for the pipeline
	   Root=<a letter><tstart of OBI>N<3 digit processing version>

	   acis L1 events --> acis<root>_evt1.lis (list of Level 1
                              ACIS event fits files)
	
	2)Output files from the pipeline
		pctr profile, log --------> <root>_lev1.ped
					    <root>_lev1.ped.log
		acis L2 events -----------> acis<root>_evt1.fits
		whole acis L2 image ------> acis<root>_full_img2.fits
		center acis L2 image -----> acis<root>_cntr_img2.fits
		source list --------------> acis<root>_src2.fits

	3)Output Data Files for Archive
		TBD

PARAMETERS
__________
	Input Parameter file name:	acis_lev2.par

	
	The parameter file is set to take most parameters for all of
	the tasks called by the pipeline.  Please see the
	documentation of each task for details.

#--------------------------------------------------------------------------
#
#       acis_lev2.par   Parameter file for ACIS LEVEL 2 PIPELINE
#
#--------------------------------------------------------------------------
clobber,b,h,no,,,"Clobber any existing output?"
verbose,i,h,0,0,5,"verbose level"
#--------------------------------------------------------------------------
#       ACIS LEVEL TWO: dmappend parameters
#--------------------------------------------------------------------------
lookupTab,s,h,"))echo ${ASCDS_CALIB}/dmappend_header_lookup.txt",,,"lookup table"
#--------------------------------------------------------------------------
#       ACIS LEVEL TWO: asphist parameters
#--------------------------------------------------------------------------
res_xy,r,h,30,,,"Aspect resolution x and y in arcsec"
res_roll,r,h,900,,,"Aspect resolution y in arcsec"
#--------------------------------------------------------------------------
#       ACIS LEVEL TWO: celldetect parameters
#--------------------------------------------------------------------------
thresh,r,h,3,,,"Source threshold"
findpeaks,b,h,yes,,,"Find local peaks?"
fixedcell,i,h,0,,,"Fixed cell size to use (0 for variable cell)"
eband,r,h,1.4967,,,"Energy band"
eenergy,r,h,0.8,,,"Encircled energy of PSF"
psftable,s,h,"))echo $ASCDS_CALIB/psfsize.fits",,,"Table of PSF size data"
mode,s,h,"ql",,,


EXAMPLES
________
	run_pipe -r <root> -i <indir> -o <outdir> -t acis_lev2.ped


NOTES
_____
	See the tool documentation and help files for specifics on
        each tool in the pipeline.  The tools that appear in the
	pipeline are:
	dmappend, dmcopy, celldetect

	See help on run_pipe (run_pipe -help), pctr and pbuilder.pl
        for information on the pipelines.


SEE ALSO
________


DATE
____
	last modified: March 1999