Ticket #9082: LET_Parameters.xml

<?xml version="1.0" encoding="UTF-8" ?>
<parameter-file instrument = "LET" valid-from = "2013-06-12T00:00:00">

<component-link name = "LET">

<!-- files properties : -->

<!-- The file which defines proper (calibrated) detector positions 
     if None - it is undefined -->
<parameter name="det_cal_file" type="string">
   <value val="det_LET_cycle12-3.dat"/>
</parameter>
<!-- The file which defines detectors to spectra mapping; File extension has to be specified here but filepath not
     if None - one2one map is used  -->
<parameter name="map_file" type="string">
   <value val="LET_one2one_123.map"/>
</parameter>

<!-- Extension of the data files obtained from DAE -->
<parameter name="data_file_ext" type="string">
   <value val=".raw"/>
</parameter>
<!-- The name of the hard mask file to use together with diag masking -->
<parameter name="hard_mask_file" type="string">
    <value val="hard.msk"/>
</parameter>
<!-- The map file used when calculating absolute units conversion integrals 
     This map usually groups together large areas of detectors to obtain proper vanadium statistics  -->
<parameter name="monovan_mapfile" type="string">
   <value val="LET_rings_123.map"/>
</parameter>


<!-- RunNumber to use for diag instead of the input run number if none - use input run -->
<parameter name="mask_run" type="string">
   <value val="None"/>
</parameter>

<!-- Energy conversion mode direct/indirect/elastic (the one the reducer understands) -->
<parameter name="deltaE-mode" type="string">
  <value val="direct"/>
</parameter>

<!-- Monitor used to estimate total current on the sample.  -->
<parameter name="norm-mon1-spec">
  <value val="40961"/>
</parameter>
<!-- Time interval used for integration to estimate current on the sample 
    This interval is usually taken around the monitor peak-->
<parameter name="norm-mon1-min">
  <value val="10000"/>
</parameter>
<parameter name="norm-mon1-max">
  <value val="12000"/>
</parameter>
<parameter name="norm_mon_integration_range"  type="string">
  <value val="norm-mon1-min:norm-mon1-max"/>
</parameter>


<!-- First spectra number (monitor number) to use when measuring incident energy
    Should be spectra with well defined energy peak -->
<parameter name="ei-mon1-spec"  type="int">
  <value val="57350"/>
</parameter>
<!-- Second spectra number (monitor number) to use when measuring incident energy
     Should be spectra with well defined energy peak -->
<parameter name="ei-mon2-spec"  type="int">
  <value val="5506"/>
</parameter>
  
<!--if you use some detectors as monitors and work in event mode, one needs to specify the comma separated list of these detectors here 
    to copy detectors spectra to monitors spectra collected in histogram mode. If no such monitors are used "None" 
    (with brackets) has to be specified as the value
-->
<parameter name="spectra_to_monitors_list"  type="string">
  <value val="5506"/>
</parameter>
  
<parameter name="ei_mon_spectra"  type="string">
  <value val="ei-mon1-spec:ei-mon2-spec"/>
</parameter>


<parameter name="scale-factor">
  <value val="1.7016e8"/>
</parameter>

<parameter name="wb-scale-factor">
  <value val="1000"/>
</parameter>

<!-- Remove the count rate seen in the regions of the histograms defined as the background regions -->
<parameter name="check_background"  type="bool">
   <value val="False"/>
</parameter>

<!--  detector_van_range- integratin in E(mev) for detector(white beam) vanadium data [20,100] -->
<parameter name="wb-integr-min">
  <value val="0.5"/>
</parameter>
<parameter name="wb-integr-max">
  <value val="200"/>
</parameter>
<parameter name="wb_integr_range"   type="string">
    <value val="wb-integr-min:wb-integr-max"/>
</parameter>



<!-- integration range for background tests  (in TOF) - composite property 
  Used in test to reject high backgound (FlatBackground) and in High Background tests integration in Diagnostics
  if diag_background_test_range is not set -->
<parameter name="bkgd-range-min"> 
  <value val="90000"/>
</parameter>
<parameter name="bkgd-range-max">
  <value val="95000"/>
</parameter>
<parameter name="background_range"  type="string">
      <value val="bkgd-range-min:bkgd-range-max"/>
</parameter>

<!-- ******************************** DIAGNOSTICS DEFAILTS **************************************** -->

<!-- Perform diag by bank. These are the spectrum numbers -->
<parameter name="diag_spectra" type="string">
  <value val="None"/>
</parameter>

<!-- Absolute lo threshold for vanadium diag (tiny) -->
<parameter name="diag_tiny">
  <value val="1e-10"/>
</parameter>

<!-- Absolute hi threshold for vanadium diag (large) -->
<parameter name="diag_huge">
  <value val="1e10"/>
</parameter>

<!-- Setting diag to reject zero backgrounds; If true then zeroes in (vanadium) data are masked as fail  -->
<parameter name="diag_samp_zero"  type="bool">
  <value val="False"/>
</parameter>

<!-- Fraction of median to consider counting low for the white beam diag (diag_van_median_rate_limit_hi sv_lo)-->
<parameter name="diag_samp_lo">
  <value val="0.0"/>
</parameter>
<!-- Fraction of median to consider counting high for the white beam diag (sv_hi)-->
<parameter name="diag_samp_hi">
  <value val="1.5"/>
</parameter>

<!-- Error criterion as a multiple of error bar for background (sv_sig) 
  i.e. to fail the test, the magnitude of the
  difference with respect to the median value must also exceed this number of error bars (default=3.3)
-->  
<parameter name="diag_samp_sig">
  <value val="3.3"/>
</parameter>

<!-- Lower bound defining outliers as fraction of median value (v_out_lo)-->
<parameter name="diag_van_out_lo">
  <value val="0.01"/>
</parameter>

<!-- Upper bound defining outliers as fraction of median value (v_out_hi) -->
<parameter name="diag_van_out_hi">
  <value val="100."/>
</parameter>

<!-- Fraction of median to consider counting low for the white beam diag (vv_lo)  vanlo=0.1  -->
<parameter name="diag_van_lo">
  <value val="0.1"/>
</parameter>

<!-- Fraction of median to consider counting high for the white beam diag (vv_hi) vanhi=1.5 -->
<parameter name="diag_van_hi">
  <value val="2.0"/>
</parameter>

<!-- Error criterion as a multiple of error bar     van_sig  "
    i.e. to fail the test, the magnitude of the difference with respect to the median value must also exceed this number of error bars (default=0.0)
-->
<parameter name="diag_van_sig">
  <value val="0.0"/>
</parameter>

<!-- Variation for ratio test with second white beam -->
<parameter name="diag_variation">
  <value val="1.1"/>
</parameter>
<!-- The range used in diagnostics and rejecting high background.
  If none, the diag background range uses background ranges from background_range. Has to be directly set otherwise -->
<parameter name="diag_background_test_range"  type="string" >
    <value val="None"/>
</parameter>


<!--  -->
<!--  Bleeding corrections   -->

<!--  the number of pixels ignored within the bleed test diagnostic -->
<parameter name="diag_bleed_pixels">
    <value val="80"/>
</parameter>
<!--  the maximum framerate allowed in a tube -->
<parameter name="diag_bleed_maxrate">
    <value val="0.01"/>
</parameter>
<!-- True if the bleed tests should be run use_bleeding-->
<parameter name="diag_bleed_test"  type="bool">
    <value val="True"/>
</parameter>

<!-- **************************************** DIAGNOSTICS DEFAILTS END ****************************************    -->


<!-- **************************************** ABSOLUTE UNITS CORRECTION DEFAULTS ********************************  -->
<!-- Absolute units conversion average -->
<parameter name="monovan_lo_bound">
  <value val="0.01"/>
</parameter>

<parameter name="monovan_hi_bound">
  <value val="100"/>
</parameter>

<!-- This property is the part of the composite definition for abs_units_van_range: 
 It specifies the relative to incident energy lower integration limit for monochromatic vanadium in the mono-vanadium integration -->
<parameter name="monovan_lo_frac">
  <value val="-0.8"/>
</parameter>

<!-- This property is the part of the composite definition for abs_units_van_range:
 It specifies the the lower limit of energy range in the monochromatic-vanadium integration 
 Used only if abs_units_van_range is set to val="monovan_lo_value,monovan_hi_value"-->
<parameter name="monovan_lo_value">
  <value val="-40."/>
</parameter>

<!-- This property is the part of the composite definition for abs_units_van_range
 It specifies the relative to incident energy higher integration limit for monochromatic vanadium in the mono-vanadium integration -->
<parameter name="monovan_hi_frac">
  <value val="0.8"/>
</parameter>
<!-- This property is the part of the composite definition for abs_units_van_range
 It specifies the the higher limit of energy range in the monochromatic-vanadium integration 
 Used only if abs_units_van_range is set to val="monovan_lo_value,monovan_hi_value"-->
<parameter name="monovan_hi_value">
  <value val="40."/>
</parameter>

<!-- energy range for integration calculating absolute units correction vanadium data. 
     if None, range is calculated from monovan_hi_frac/monovan_lo_frac 
     - providing the fractions of the incident energy      
     if one wants to specify the energy values here it has to be defined in the form:
    <value val="monovan_lo_value,monovan_hi_value"/>      -->    
<parameter name="abs_units_van_range"  type="string">
  <value val="None"/>
</parameter>
<!-- Sample mass used in absolute units normalization and should usually be changed by user-->
<parameter name="sample_mass">
  <value val="1"/>
</parameter>
<!-- Sample rmm used in absolute units normalization should usually be changed by user -->
<parameter name="sample_rmm">
  <value val="1"/>
</parameter>
<!-- Vanaduim mass used in absolute units normalization and is usually instrument specific (changes rarely) -->
<parameter name="vanadium-mass">
  <value val="20.79"/>
</parameter>
<!-- if this value set to true, modo-vanadium run is not analyzed and masks obtained for arbitrary units are used for mono-vanadium -->
<parameter name="use_sam_msk_on_monovan" type = "bool">
  <value val="False"/>
</parameter>

<!-- if this value is provided (not None) it is string reperesentation of the number used instead of calculating mono-vanadium based normalization factor 
   one does not need to provide mono-vanadium run if this value is provided as it will be used instead
  -->
<parameter name="mono_correction_factor" type="string">
  <value val="None"/>
</parameter>
  
<!-- **************************************** ABSOLUTE UNITS CORRECTION DEFAULTS END ****************************  -->

<!-- normalise_method normalistion. Availible values are: none (-largely meaningles), monitor-1, current 
     the acceptable values are defined in DirectEnergyConversion init routine as recognized by direct energy conversion normalize method
     these three are currently disabled/unknown: monitor-2, uamph peak-->
<parameter name="normalise_method" type="string">
    <value val="monitor-1"/>
</parameter>

<!-- if defined to true, fix incident energy to this value and do not calculate the energy from the run -->
<parameter name="fixei"  type="bool">
    <value val="False"/>
</parameter>

<!--  ****************************************  Workflow control **************************** -->

<!-- This parameter controls the format of output data written by reducer. 
    Three values are currently supported, namely .spe, .nxspe, and nexus (mantid workspace) (.nxs)
     Three possible values for this are defined inin DirectEnergyConversion init routine as recognized by save method 
     If None is there, no internal script saving occurs and one needs to use external save operations -->  
<parameter name="save_format" type="string">
   <value val="None"/>
</parameter>

<!-- If one wants to sum runs. By default no, as in addition to the key word one has to provide list of input run-numbers
     but presence of this key here allows to propagate this key-word to the reducer   -->
<parameter name="sum_runs"  type="bool">
   <value val="False"/>
</parameter>

<!-- # Run Detector Efficiency Correction -->
<parameter name="apply_detector_eff"  type="bool">
   <value val="True"/>
</parameter>
<!-- # Multiply result by ki/kf value -->
<parameter name="apply_kikf_correction"  type="bool">
   <value val="True"/>
</parameter>

<!-- The if true, use only hard mask file specified above and do not run diagnostics procedures -->
<parameter name="use_hard_mask_only" type="bool">
    <value val="False"/>
</parameter>
  
<!-- Parameter specifies if one wants to run diagnostics (which include applying hard mask file) or not-->
<parameter name="run_diagnostics" type="bool">
    <value val="True"/>
</parameter>



<!-- If this parameter is set to true, dgreduce will try to load mask from the mask file
     correspondent to the run if finds it and uses this mask as hard mask only (does not run diagnostics). 
     If such file has not been found, it will run diagnostics and save the masks into mask file for reuse 
     Hard Mask file, provided separately or as additional hard mask file is ignored in this case -->
<parameter name="save_and_reuse_masks"  type="bool">
   <value val="False"/>
</parameter>


<!-- List of the words which can be used as a command line arguments to define reducer keywords
     the form is reducer_keword1=synonim1=synonim2=synonim3;reducer_keword1=synonim1a, so, 
     the reducer keywords are the leftmost values of the keyword assignements below
     Each keyword met in command line or file above are converted into reducer keyword as below
-->  
<parameter name="synonims" type="string">
   <value val="normalise_method=norm_method;
       fix_ei=fixei;
       sum_runs=sum;
       wb_integr_range=detector_van_range;
       van_mass=vanadium-mass;
       check_background = background;       
       mon1_norm_spec=norm-mon1-spec;
       scale_factor=scale-factor;
       wb_scale_factor=wb-scale-factor;
       monovan_integr_range=abs_units_van_range;
       monovan_lo_value = monovan-integr-min;
       monovan_hi_value = monovan-integr-max;       
       use_hard_mask_only=hardmaskOnly;
       bkgd_range = background_range;
       background_test_range = diag_background_test_range;
       hard_mask_file=hard_mask  =hardmaskPlus;       
       van_out_lo = diag_van_median_rate_limit_lo=diag_van_out_lo;
       van_out_hi = diag_van_median_rate_limit_hi=diag_van_out_hi;
       van_lo     = diag_van_median_sigma_lo=diag_van_lo;
       van_hi     = diag_van_median_sigma_hi=diag_van_hi;
       van_sig    = diag_van_median_sigma=diag_van_sig;
       tiny       = diag_tiny;
       huge       = diag_huge=large;
       samp_zero  = diag_remove_zero=diag_samp_zero;
       samp_lo    = diag_samp_median_sigma_lo=diag_samp_lo;
       samp_hi    = diag_samp_median_sigma_hi=diag_samp_hi;
       samp_sig   = diag_samp_median_sigma=diag_samp_sig;
       variation  = diag_variation;
       bleed_test = bleed = diag_bleed_test;
       bleed_maxrate = diag_bleed_maxrate;
       bleed_pixels  = diag_bleed_pixels"
    />
</parameter>
 
  <!-- -->
</component-link>

</parameter-file>