This document defines the syntax for the 'DMNN', or
'D'ifference 'M'ap number 'NN', portion of the 
EDI_PISO 'aux' and 'log' filenames.  Note that NN can
range from 00 to 99. This document also describes the defaults
as well as the possible values which comprise the
'DM03' map.  

As of July, 2003, THIS map is the 
one which is set up for
the production of the prime parameters by the
German Cluster Data Center.  It should also be used by
by anyone running the software outside of MPE (Mark
Chutter at UNH, Scott Bounds at UIowa).  The setting
of this map is done in ep_control.csh (or ep_control_gcdc.csh
or ep_control_sprod.csh) by setting the environment
variable EDI_PISO_DM.  All EDI_PISO software versions
greater than or equal to v2_37 will have this
variable set to DM03.

This file is only used for definitions.  
THE ACTUAL ASSIGNMENT OF THESE VARIABLES IS DONE
IN ep_DM03_defaults.txt!!!  IF YOU ADD A NEW VARIABLE,
YOU NEED TO ASSIGN IT IN ep_DM03_defaults.txt, AND
THEN ADD IT TO THE COMMON BLOCK IN ep_envar_con.pro
(there are two places, the variable name itself, and
the variable name with '_def' on the end).

If every EDI_PISO control environment variable in 
the ep_control.csh script is set to its default value, the
filenames will contain this string:
	      '_DM03_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 within the ep_control.csh script), then
the variable number (see below) and it's value appear in the
filenames after the '_DM03_' string.  For example, 
	       '_DM03_p1_2_p7_1'
indicates that pp_nchunk=2 (instead of 1) and pp_gunid=1 (instead of 0).

Variable  Variable	      Possible		     Default   Format
   #	   Name		       Values		      Value    Restrict.
--------  --------	      --------		     --------  -----
1	  pp_nchunk	       1,2,4			1	i2
2	  pp_method	       0,1,2,3,4,5,6,7,8,9	9	i2
3	  pp_curve_traj	       0,1			1	i2
4	  pp_order_assign      NOT USED ANYMORE 14.03.2002	i2
5	  pp_acfir_assign      0,1,2			1	i2
6	  pp_acfir	       Any angle, degrees	1.0	f4.1
7	  pp_gunid	       0,1,2			0	i2
8	  pp_nbeam_min	       2,3,4,...		4	i2
9	  pp_qual_min	       1,2,3			2	i2
10	  pp_maxorder	       1,2,3,...		3	i2
11	  pp_maxchan_min       1,2,3,...15		6	i2
12	  pp_maxchan_max       1,2,3,...15		8	i2
13	  pp_outlier_removal   0,1			1	i2
14	  pp_outlier_maxperc   Any percent		20	i3
15	  pp_outlier_nbeam_min NOT USED ANYMORE 11.06.2001      i2
16	  pp_cg_phires	       Any angle, degrees	3.0	f4.1
17	  pp_fg_phires	       Any angle, degrees	1.0	f4.1
18	  pp_cg_minresr	       centimeters		5.0	f4.1
19	  pp_fg_minresr	       centimeters		1.0	f4.1
20	  pp_cg_acgdu	       NOT USED ANYMORE 11.06.2001      f4.1
21	  pp_fg_acgdu	       NOT USED ANYMORE 11.06.2001      f4.1
22	  pp_cg_logpr	       Any percent		30	i3
23	  pp_fg_logpr	       Any percent		1	i3
24	  pp_actof_con	       CURRENTLY NOT USED	8.0	f4.1
25        pp_acgdu             centimeters              2.0     f4.1
26        pp_order_use_unrun1  NOT USED ANYMORE 29.08.2001      i2
27        pp_order_use_unrun2  NOT USED ANYMORE 29.08.2001      i2
28        pp_order_use_hrb     0,1                      1       i2
29        pp_maxorder_runest   1,2,3,...                6       i2
30        pp_para_anglim       Any angle, degrees       10.0    f4.1
31        pp_dtof_ambiguity_factor                              f4.1
32        pp_qstat_minperc     Any percent              10      i3
33        pp_tofclass_nbeam_min  2,3,4,...              2       i2
34        pp_rchi2_abortlim                             100     i3
35        pp_rchi2_outlim                               50      i3
36        pp_bmag_toflim       nT                       100     i3
37        pp_reorder_anglim    Any angle, degrees       2.0     f4.1
38        pp_noclassc_pmt      NOT USED ANYMORE 15.07.2003      i2
39        pp_pmt_dtof_error    0,1,2,3                  1       i2
40        pp_noclassc_tri      NOT USED ANYMORE 15.07.2003      i2
41	  pp_runest_sfac       f4.2 float, 0-1          0       f4.2
42	  pp_dt_smt	       milliseconds		300	i3
43	  pp_npair_min_smt     2,3,4,...		2	i3
44	  pp_smt_dtof_error    0,1,2,3                  1       i2
45        pp_rmax              meters                   0       i3
46        pp_noclassc_rmt      NOT USED ANYMORE 15.07.2003      i2
47        pp_rmt_dtof_error    0,1,2,3                  1       i2
48        pp_runest_smooth     1,2,3,...                5       i2
49        pp_bmag_trilim       NOT USED ANYMORE 15.07.2003      i3
50	  pp_ediefw_out        0,1                      0       i2
51	  pp_runner_penalty_meth 0,1,2                  1       i2
52	  pp_qual_assign_meth  0,1,2,3,...              0       i2
53	  pp_qa_nbeam_min      4,5,6,7,...              7       i2
54	  pp_qa_drat_cb        Any percent              100     i3
55	  pp_qa_drat_gc        Any percent              30      i3
56        pp_qa_dlim           centimeters              33      i3
57        pp_qa_deld_cb        centimeters              33      i3
58        pp_qa_deld_gc        centimeters              10      i3
59	  pp_edidsi_out        0,1                       0      i2
60        pp_edidsi_inertial_out  0,1                    0      i2

Follows is a detailed description of each variable:
=======================================================================
1) pp_nchunk = 1    4 sec. resolution (default)
             = 2    2 sec. resolution
             = 4    1 sec. resolution
=======================================================================
2) pp_method = 0  Bestarg Triangulation only will be run/output (it's forced)
             = 1  Bestarg Tri. OR PMT/SMT TOF will be run, depending
                  on internal decisions about which is best.
		  These decisions are made by ep_method_logic1.pro
             = 2  Poorman's TOF only will be run/output (it's forced)
	     = 3  Bestarg Tri. OR PMT/SMT TOF will be run, according
		  to ep_method_logic2.pro
	     = 4  Bestarg Tri. OR PMT/SMT TOF will be run, according
		  to ep_method_logic3.pro
             = 5  Simultan TOF only will be run/output (it's forced)
             = 6  Both Poorman's TOF and Simultan TOF are run, Simultan
                  result is output if successful, otherwise the Poorman's
                  result is output.
	     = 7  Bestarg Tri. OR RMT (Richman's) TOF will be run, according
		  to ep_method_logic_rmt_sa.pro 
             = 8  Richman's TOF only will be run/output (it's forced)
             = 9  Force TRI AND RMT both (default)
                  Output both results to the aux file (if written)
                  Output the 'winner' to the IFFALL file for the GCDC
                  Output both results (i.e. the winners and the losers)
		  to the new EDI Archive CDF file
=======================================================================
3) pp_curve_traj = 0  Straight-line beam trajectories
                 = 1  Curved beam trajectories (default)
=======================================================================
4) pp_order_assign NOT USED ANYMORE
=======================================================================
5) pp_acfir_assign = 0  Constant firing angle accuracy used (uses pp_acfir)
                = 1  Hans' beamwidth.pro used for sigfir in bestarg.pro (def.)
                = 2  Craig K.'s sigma_angle.pro used for sigfir in bestarg.pro
=======================================================================
6) pp_acfir = Accuracy of the beam firing (in degrees). Only used if
           pp_acfir_assign = 0
=======================================================================
7) pp_gunid = 0  Beams from both guns used in analysis (default)
         = 1  Gun 1 only
         = 2  Gun 2 only
=======================================================================
8) 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.)
=======================================================================
9) 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...)
=======================================================================
10) pp_maxorder = Maximum runner order considered by analysis WHEN
              BESTARG IS ON ITS OWN!  Look to pp_maxorder_runest
              to see the max. runner order under consideration for
              the case when Hans' runest.pro is trying to figure out
              the order of the beam.
=======================================================================
11) pp_maxchan_min = Minimum maxchan value considered by analysis
=======================================================================
12) pp_maxchan_max = Maximum maxchan value considered by analysis
=======================================================================
13) pp_outlier_removal = 0  No removal of outlier beams
                   = 1  bestarg.pro will perform removal
                        of those beams statistically determined
                        to be outliers. (default)
=======================================================================
14) pp_outlier_maxperc = Maximum percentage of the total # of beams in an
                     interval that are allowed to be removed by the
                     outlier removal method. (default=20%)  NOTE:
                     This is only checked when pp_outlier_removal=1.
=======================================================================
15) pp_outlier_nbeam_min = NOT USED ANYMORE
=======================================================================
16) pp_cg_phires = Resolution (in degrees) of the coarse grid in phi.
=======================================================================
17) pp_fg_phires = Resolution (in degrees) of the fine grid in phi.
=======================================================================
18) 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.
=======================================================================
19) 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.
=======================================================================
20) pp_cg_acgdu = NOT USED ANYMORE
=======================================================================
21) pp_fg_acgdu = NOT USED ANYMORE
=======================================================================
22) pp_cg_logpr = (Bin width)/(Bin center) for the
              logarithmic portion (if any) of the coarse grid
=======================================================================
23) pp_fg_logpr = (Bin width)/(Bin center) for the
              logarithmic portion (if any) of the fine grid
=======================================================================
24) 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.
=======================================================================
25) 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.
=======================================================================
26) pp_order_use_unrun1 NOT USED ANYMORE
=======================================================================
27) pp_order_use_unrun2 NOT USED ANYMORE
=======================================================================
28) pp_order_use_hrb (Only checked when pp_order_assign = 1)
		 = 0  Send spin-res. FGM data to Hans' runest.pro
                 = 1  Send high-res. FGM data to Hans' runest.pro (default)
=======================================================================
29) pp_maxorder_runest = Maximum runner order considered by analysis FOR
              HANS' RUNEST PROGRAM!  Look to pp_maxorder
              to see the max. runner order under consideration for
              the case when ep_assign_order.pro is on its own
              (i.e. no help from runest.pro).
=======================================================================
30) pp_para_anglim = Used by the parallelism test (which is post-
                     nonrobust-coarse grid, when method=1 or 2).
                     To pass this test, the standard deviation of
                     the beam angle-spread must be less than
                     pp_para_anglim.  See ep_calc_para.pro.
=======================================================================
31) pp_dtof_ambiguity_factor = Undefined
=======================================================================
32) pp_qstat_minperc = Each 10 minute interval of each hour of the day
                       is examined by Hans' qstat program.  The % of
                       'good' spins in each of these 10 minute intervals
                       is reported.  For each hour, if at least one of these 6
                       percentages is greater than or equal to
                       pp_qstat_minperc, then this hour of data will
                       be processed.  If not, this hour of data is
                       skipped.
=======================================================================
33) pp_tofclass_nbeam_min = When Poorman's Tof analysis is run,
                            the times of flight are put into two classes:
                            towards and away.  Each class must have
                            at least pp_tofclass_nbeam_min in them,
                            otherwise, the analysis is aborted. No output.
=======================================================================
34) pp_rchi2_abortlim = The nonrobust, coarse grid rchi2
                        is checked and if greater than pp_rchi2_abortlim,
                        the triangulation analysis goes no further
                        (no fine grid analysis).  No output.
=======================================================================
35) pp_rchi2_outlim = The fine grid rchi2 for the triangulation analysis
                      is examined. If it is greater than pp_rchi2_outlim,
                      this solution is discarded and there is no output.
=======================================================================
36) pp_bmag_toflim = This is examined in the 'ToF Regime' test.
                     If the parallelism test is satisfied, and
                     B_mag is less than pp_bmag_toflim, then this
                     data interval is considered to be in the 'ToF'
                     regime.
=======================================================================
37) pp_reorder_anglim = Using the target (target2) determined from the
                        non-robust coarse grid, beams of the B and C
                        category are examined to see if their order
                        should be bumped down if it is ambiguous.
                        "Ambiguous" is defined to be when the 
                        difference between the firing angle and the
                        target which is one order lower than the
                        nominally assigned target is
                        greater than pp_reorder_anglim degrees.
                        If this is the case, the beam is reassigned
                        to be one order lower.  This is done 
                        recursively downwards to the single-runner
                        target (if necessary).
=======================================================================
38) pp_noclassc_pmt = NOT USED ANYMORE 15.07.2003
=======================================================================
39) pp_pmt_dtof_error = Defines which error on the delta ToF returned
                        from Hans' toferror.pro will be used to assess
                        the significance of the difference
                     0 = Use t-scaled, 68% confidence
		     1 = Use t-scaled, 90% confidence (default)
                     2 = Use t-scaled, 95% confidence
                     3 = Use Numerical Recipes Formula
=======================================================================
40) pp_noclassc_tri = NOT USED ANYMORE 15.07.2003
=======================================================================
41) pp_runest_sfac = Factor used by RunEst.pro.  Ask Hans about the
		     meaning (hav@mpe.mpg.de) Default: 0, which tells
                     RunEst.pro to determine SFAC by itself.
=======================================================================
42) pp_dt_smt = Defines how close in time a towards and away
	        firing pair need to be in order to be classified
		by ep_simultan_tof.pro as a simultaneous pair.
		Default: 300 milliseconds.
=======================================================================
43) pp_npair_min_smt = Minimum # of simultaneous pairs required by
		       the simultaneous ToF analysis in
		       ep_simultan_tof.pro
=======================================================================
44) pp_smt_dtof_error = See pp_pmt_dtof_error
=======================================================================
45) pp_rmax = Radial extent of the coarse grid, in meters.
              Default: pp_rmax=0 means that the routine whatech.pro
              will determine the radial extent of the coarse grid, which
              has always been done in the past.
=======================================================================
46) pp_noclassc_rmt = NOT USED ANYMORE 15.07.2003
=======================================================================
47) pp_rmt_dtof_error = Defines which error on the delta ToF returned
                        from Hans' toferror.pro will be used to assess
                        the significance of the difference (RMT)
                     0 = Use t-scaled, 68% confidence
		     1 = Use t-scaled, 90% confidence (default)
                     2 = Use t-scaled, 95% confidence
                     3 = Use Numerical Recipes Formula
=======================================================================
48) pp_runest_smooth = 1  No smoothing of the gyrotime by RunEst.pro
                     = n (>1) means n is sent to the IDL "smooth" 
                       function when smoothing the gyrotime, i.e.
                       bd_bmag = smooth(bd_bmag, n)
                       Default: 5
=======================================================================
49) pp_bmag_trilim = NOT USED ANYMORE 15.07.2003
=======================================================================
50) pp_ediefw_out = Flag for writing out data to a file for
		    EDI/EFW comparison paper
                    0 = do not write out the file (default)
		    1 = write the file
=======================================================================
51) pp_runner_penalty_meth
                 = 0 No runner penalty when normalizing chi2
                 = 1 Penalty based on # of "legal" orders available
                     to each beam.  A "legal" order is one that has
                     probability > 1/e^2 (i.e. it's flag is set) (default)
                 = 2 Penalty based on runner probabilities being
                     an e-folding away from the max probability
                     Note:  This method could be inconsistent within
                     itself...We might have a case where there are
                     3 probabilities all within an e-folding of
                     eachother (i.e. the penalty is 3), BUT the
                     number of "legal" orders is only 2...Must investigate
                     this further.
=======================================================================
52) pp_qual_assign_meth
                 = 0 Assign output quality (Good/Caution/Bad)
                     according to prescription in
                     ep_assign_quality_0.pro  (default)
                     This routine uses the next 6 control parameters
                     (53-58).  If you change ANY of these parameters,
                     please be careful!  Changing one and not
                     taking care for the others could produce some
                     inconsistencies in the quality assignments

		 ne 0  The old logic is used.  See ep_prep_iff_data_write.pro

53) pp_qa_nbeam_min - See pp_qual_assign_meth
54) pp_qa_drat_cb - See pp_qual_assign_meth
55) pp_qa_drat_gc - See pp_qual_assign_meth
56) pp_qa_dlim - See pp_qual_assign_meth
57) pp_qa_deld_cb - See pp_qual_assign_meth
58) pp_qa_deld_gc - See pp_qual_assign_meth
=======================================================================
59) pp_edidsi_out = Flag for writing out data in DSI (despun saltellite inverted,
                    satellite frame)
		    coordinates (this is for work with merging EFW and EDI data)
                    0 = do not write out the file (default)
		    1 = write the file
=======================================================================
60) pp_edidsi_inertial_out = Flag for writing out data in DSI (despun saltellite inverted,
                    inertial fram)
		    coordinates (this is for work with merging EFW and EDI data)
                    0 = do not write out the file (default)
		    1 = write the file
