-
Notifications
You must be signed in to change notification settings - Fork 122
/
MERLIN_Parameters.xml
396 lines (335 loc) · 15.1 KB
/
MERLIN_Parameters.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
<?xml version="1.0" encoding="UTF-8" ?>
<parameter-file instrument = "MERLIN" valid-from = "2013-06-12T00:00:00">
<component-link name = "MERLIN">
<!-- files properties : -->
<!-- Specify that the detector positions should be taken from the data file -->
<parameter name="det-pos-source" type="string">
<value val="datafile"/>
</parameter>
<!-- The file which defines proper (calibrated) detector positions
if None - it is undefined -->
<parameter name="det_cal_file" type="string">
<value val="det_corr_123.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="one2one_125.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 4to1_124mod.msk-->
<parameter name="hard_mask_file" type="string">
<value val="None"/>
</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="mono_van_map.map"/>
</parameter>
<!-- RunNumber to use for diag instead of the input run number if none - use input run
if yes, will probably change from command line-->
<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="69633"/>
</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="1000"/>
</parameter>
<parameter name="norm-mon1-max">
<value val="2000"/>
</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="69634"/>
</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="69638"/>
</parameter>
<parameter name="ei_mon_spectra" type="string">
<value val="ei-mon1-spec:ei-mon2-spec"/>
</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="None"/>
</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="20"/>
</parameter>
<parameter name="wb-integr-max">
<value val="55"/>
</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="12000"/>
</parameter>
<parameter name="bkgd-range-max">
<value val="18000"/>
</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="1.5"/>
</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="bleed_pixels">
<value val="80"/>
</parameter>
<!-- the maximum framerate allowed in a tube -->
<parameter name="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.6"/>
</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.7"/>
</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="32.62"/>
</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 (nont 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 writteb by reducer. Three values are currently supported, namely spe, nxspe, and nexus (mantid workspace)
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 for 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;
ei-mon2-spec = test_ei2_mon_spectra;
ei_mon_spectra=test_mon_spectra_composite"
/>
</parameter>
<!-- -->
</component-link>
</parameter-file>