===============================================================================
		      HELP FILE for ephem_lev1 pipeline
===============================================================================

NAME:     ephem_lev1.ped:
		This pipeline runs on the tasks needed to take the level 0
	product of ephemeris and create the output viewing angles geometry
	This pipeline will need to run AFTER the Ephemeris level 0 is
	run on solar, lunar and spacecraft data, and after the aspect Level 1
	is completed. The aspect solution is required for this pipeline.


USAGE
	   1. Build the pipeline with pbuilder.pl and then run with
	      flt_pctr.
	
		a)build the pipeline
	
		pbuilder.pl -t $ASCDS_SYS_PROF/ephem_lev1.ped -r <root>
		-i <indir> -o <outdir> -a <options> > <pedout>
	
		b)run the pipeline
	 
		flt_pctr -prof <pedout> -log <othername> -showlog


		   <nameroot>:          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
		   <options>:		discussed below
	           <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 flt_run_pipe which builds and runs the pipeline in one step.
	
	     flt_run_pipe -r <root> -i <indir> -o <outdir> -t ephem_lev1.ped 
		-a "<options>"
	
	  3. options: 
		 tstart= time to start calculation
		 tstop= time to stop calculation	
		 revision= output revision		  	
		This option reflects the processing revision for the
		output files.

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

	ephem_calc_vg_angles- calculate the viewing angles from the
		level 0 products. Among the information produced is
		the pointing-solar angles, pointing-lunar angles,
		pointing-earth angles, sun-earth angles, pointing-ram
		angle, and sat-earth distance (from Earth center).
	
	update_revision-adds the revision number to the header of the output.

	INPUTS/OUTPUTS:
	1)Input files for the pipeline
	    Orbital Ephemeris--> orbit<root>_eph0.lis > list of ephemeris files
	    Solar Ephemeris ---> solar<root>_eph0.lis > list of solar files
	    Lunar Ephemeris ---> lunar<root>_eph0.lis > list of lunar files
	    aspect solution ---> pcad<root>_asol1.lis > list of aspect files
	    

	2) Output files from the pipeline
		pctr profile, log ------>	<root>_lev0.ped        
						<root>_lev0.ped.log    
		viewing_angles file ----->angles<root>_eph1.fits

		root=f<tstart>N(processing)
	
	3) Output Data Files for Archive
		viewing_angles file ----->angles<root>_eph1.fits

PARAMETERS
	Input Parameter file name:  ephem_lev1.par
	
	verbose-  Will be sent to each tool in the pipeline. This
		  allows the user to set the amount of textual
		  information from the tool execution. Allowed range of
		  values is 0-5. Set to 0, verbose is silent. Set to 5
		  is the maximum amount of information.

	kernel-  Will be sent to each tool in the pipeline. This is
		 defaulted to FITS and specifies the output file format.
		 Allowed values are "FITS".

	interval- Sent to ephem_calc_vg_angles. This allows the user
		  to determine the interval that the angles are calculated on.
		  Allowed range is from 0 to 30 minutes.

EXAMPLES
	run_pipe -r <root_name> -i <in directory> -o <out directory> 
	-t ephem_lev1.ped -a "tstart=<tstart> tstop=<tstop> revision=<revision>"

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

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

SEE ALSO
	pctr, run_pipe, pbuilder.pl, ephem_calc_vg_angles,dmhedit

DATE
	last modified: 1 June 1999