#	EPDM_DEF.txt,v 1.6 2001/07/11 15:25:55 ppq Exp	

This document defines the syntax for the 'EPDM', or
'EDI'_'P'ISO 'D'ifference 'M'ap, portion of the 
EDI_PISO 'aux' and 'log' filenames.

If every environment variable in the edi_piso_gcdc_script
(or edi_piso.csh) script is set to its default value, the
filenames will contain this string:
	      '_EPDM_0'
meaning there is no difference between the control
parameters set for this run, and the defaults.

If at least one of the environment variables is changed 
(which can be done at the very beginning of the
edi_piso_gcdc_script), then
the variable number (see below) and it's value appear in the
filenames after the '_EPDM_' string.  For example, 
	       '_EPDM_p1_2_p7_1'
indicates that pp_nchunk=2 (instead of 1) and pp_gunid=1 (instead of 0).

Variable  Variable	      Possible		     Default
   #	   Name		       Values		      Value
--------  --------	      --------		     --------
1	  pp_nchunk	       1,2,4			1	LONG
2	  pp_method	       0,1			0	LONG
3	  pp_curve_traj	       0,1			0	LONG
4	  pp_order_assign      0,1			0	LONG
5	  pp_acfir_assign      0,1,2			0	LONG
6	  pp_acfir	       Any angle, degrees	1.0	f3.1 or f4.1
7	  pp_gunid	       0,1,2			0	LONG
8	  pp_nbeam_min	       2,3,4,...		4	LONG
9	  pp_qual_min	       1,2,3			2	LONG
10	  pp_maxorder	       1,2,3,...		5	LONG
11	  pp_maxchan_min       1,2,3,...15		6	LONG
12	  pp_maxchan_max       1,2,3,...15		8	LONG
13	  pp_outlier_removal   0,1			0	LONG
14	  pp_outlier_maxperc   Any percent		100	LONG
15	  pp_outlier_nbeam_min NOT USED ANYMORE 11.06.2001
16	  pp_cg_phires	       Any angle, degrees	3.0	f3.1 or f4.1
17	  pp_fg_phires	       Any angle, degrees	1.0	f3.1 or f4.1
18	  pp_cg_minresr	       centimeters		5.0	f3.1 or f4.1
19	  pp_fg_minresr	       centimeters		1.0	f3.1 or f4.1
20	  pp_cg_acgdu	       NOT USED ANYMORE 11.06.2001
21	  pp_fg_acgdu	       NOT USED ANYMORE 11.06.2001
22	  pp_cg_logpr	       Any percent		30	LONG
23	  pp_fg_logpr	       Any percent		30	LONG
24	  pp_actof_con					8.0	f3.1 or f4.1
25        pp_acgdu             centimeters              2.0     f3.1 or f4.1
26        pp_order_use_unrun1  0,1                      1       LONG
27        pp_order_use_unrun2  0,1                      1       LONG
28        pp_order_use_hrb     0,1                      0       LONG

Follows is a detailed description of each variable:
=======================================================================
pp_nchunk = 1    4 sec. resolution (default)
          = 2    2 sec. resolution
          = 4    1 sec. resolution
NOTE: Only for pp_nchunk = 1 will the IFF file have the proper filename
as required by Traudl at the data center...The others will have pp_nchunk
as a part of the filename.
=======================================================================
pp_method = 0  Bestarg Triangulation only will be run (default)
          = 1  Bestarg Tri. AND Poorman's TOF will be run
=======================================================================
pp_curve_traj = 0  Straight-line beam trajectories (default)
              = 1  Curved beam trajectories
=======================================================================
pp_order_assign = 0  bestarg.pro makes the runner-order assignment (default)
		= 1  runest.pro makes attempt to assign order
=======================================================================
pp_acfir_assign = 0  Constant firing angle accuracy used (uses pp_acfir, def.)
                = 1  Hans Vaith's beamwidth.pro used for sigfir in bestarg.pro
                = 2  Craig K.'s sigma_angle.pro used for sigfir in bestarg.pro
=======================================================================
pp_acfir = Accuracy of the beam firing (in degrees). Only used if
           pp_acfir_assign = 0
=======================================================================
pp_gunid = 0  Beams from both guns used in analysis (default)
         = 1  Gun 1 only
         = 2  Gun 2 only
=======================================================================
pp_nbeam_min = Minimum # of beams per interval required for analysis
               (Note that this criteria is applied during the
                data selection, i.e. before any analysis, and ALSO
                after outlier removal (if desired) has been
                completed.)
=======================================================================
pp_qual_min = Minimum beam quality considered by analysis
              Note: pp_qual_min=0 is illegal (This quality
              of data doesn't even have angle track...)
=======================================================================
pp_maxorder = Maximum runner order considered by analysis
=======================================================================
pp_maxchan_min = Minimum maxchan value considered by analysis
=======================================================================
pp_maxchan_max = Maximum maxchan value considered by analysis
=======================================================================
pp_outlier_removal = 0  No removal of outlier beams
                   = 1  bestarg.pro will perform removal
                        of those beams statistically determined
                        to be outliers.
=======================================================================
pp_outlier_maxperc = Maximum percentage of the total # of beams in an
                     interval that are allowed to be removed by the
                     outlier removal method.
=======================================================================
pp_outlier_nbeam_min = NOT USED ANYMORE
=======================================================================
pp_cg_phires = Resolution (in degrees) of the coarse grid in phi.
=======================================================================
pp_fg_phires = Resolution (in degrees) of the fine grid in phi.
=======================================================================
pp_cg_minresr = Minimum resolution (in cm) of the coarse grid in r.
                This will be the resolution of the linear (if any) portion
                of the radial grid.  This, along with pp_cg_logpr, 
                determines the cross-over point from linear to logarithmic
                spacing of the r-grid.
=======================================================================
pp_fg_minresr = Minimum resolution (in cm) of the fine grid in r.
                This will be the resolution of the linear (if any) portion
                of the radial grid.  This, along with pp_fg_logpr, 
                determines the cross-over point from linear to logarithmic
                spacing of the r-grid.
=======================================================================
pp_cg_acgdu = NOT USED ANYMORE
=======================================================================
pp_fg_acgdu = NOT USED ANYMORE
=======================================================================
pp_cg_logpr = (Bin width)/(Bin center) for the
              logarithmic portion (if any) of the coarse grid
=======================================================================
pp_fg_logpr = (Bin width)/(Bin center) for the
              logarithmic portion (if any) of the fine grid
=======================================================================
pp_actof_con = What the chip length is divided by in order to 
               construct the error in the time of flight, i.e.
               actof = nmchip*2^(-23)/pp_actof_con*1e6, microsec.
	       This only matters when the time-of-flight portion of
	       bestarg.pro is running, which, currently, is not.
=======================================================================
pp_acgdu =    cm, Used along with firing angle accuracy to determine
              the total error in firing angle assigned to each beam
	      (which appears in the denominator of the triangulation
	      penalty function, see bestarg.pro for the exact form).
              The contribution from this term has something to do
	      with how the firing angle error will increase the
	      closer the target is to the beam's gun position.
=======================================================================
pp_order_use_unrun1 (Only checked when pp_order_assign = 1)
                    = 0  Don't use runorder=0, flagtot=0 beams (as 
                         determined by runest.pro, and as checked in
                         ep_prep_order.pro)
                    = 1  Do use the above beams; let bestarg find
                         find the best order since Hans' code
                         couldn't even guess (default)
=======================================================================
pp_order_use_unrun2 (Only checked when pp_order_assign = 1)
		    = 0  Don't use those beams that Hans' code
                         didn't even TRY to estimate order for
                         (because qual=1 or maxchan ne 7)
                    = 1  Do use the above beams; let bestarg find
                         find the best order since Hans' code
                         didn't even try (default)
=======================================================================
pp_order_use_hrb (Only checked when pp_order_assign = 1)
		 = 0  Send spin-res. FGM data to Hans' runest.pro (default)
                 = 1  Send high-res. FGM data to Hans' runest.pro
