Wiki source code of The FLASH HDF5 structure

Version 44.1 by cpassow on 2021/02/10 09:30

Show last authors
1 {{layout}}
2 {{layout-section ac:type="single"}}
3 {{layout-cell}}
4 == Contents ==
5
6
7
8 {{toc/}}
9
10 \\
11
12 == General information about HDF5 ==
13
14 HDF5 is a data format maintained by the HDF group. For detailed general information see [[here~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://portal.hdfgroup.org/display/support||shape="rect"]]
15
16 To download the HDF5 Viewer click [[here~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://portal.hdfgroup.org/display/support/Download+HDFView||shape="rect"]]
17
18 For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :
19 {{code language="none"}}> module load xray{{/code}}
20 {{code language="none"}}> hdfview{{/code}}
21
22 [[Contents>>doc:||anchor="Contents"]]
23
24 == The new (starting 2021) HDF5 format ==
25
26 \\
27
28 FLASH provides a conversion of its data acquisition (DAQ) to the commonly used [[HDF5>>url:https://www.hdfgroup.org/solutions/hdf5/||shape="rect"]] format. Correlated  data are mapped by a primary index called **train ID**. Every data set has an individual index of train IDs to identify the data even when data are missing or deviate in update rate.If the data set of choice contains gaps,  users have to decide how to treat missing values. DAQ channels are spread across various files with one file name pattern for each DAQ. This means users have to assemble data from different files if necessary.
29
30 The hierarchy is realized using a human readable named HDF tree with each DAQ channel containing the data sets "//value//" and "//index//". Additionally, the HDF group //zraw// contains a tree of the original DAQ channel names.
31
32 Reference implementation, which follows the concept of Python libraries like Pandas, Xarray, or Dask, is given below.
33
34 \\
35
36 {{expand title="Discontinued HDF formats"}}
37 == Comparison to FLASH's deprecated HDF formats ==
38
39 Before 2021, FLASH provided two different HDF formats formally known as //near-online// and //offline// HDF files.
40
41 All data sets were aligned by the same global index by filling in missing data. Fast DAQ channels  (pulse synchronous data - update 10 Hz) are filled in by NaN or 0, slow channels (not pulse synchronous data - update e.g. 1 Hz ) are interpolated by the DAQs libraries, by keeping the value constant up to the next change.
42
43 While the near-online HDF files were converted live during the beamtime, the offline HDF files were manually compiled weeks/months later. Near-online HDF files were used by a provided API [[BeamtimeDaqAccess>>url:https://confluence.desy.de/display/FLASHUSER/Near-Online+data+analysis#Near-Onlinedataanalysis-BriefUserGuidetoBeamtimeDAQAccess||shape="rect"]], which also searches for DAQ channels in files. With assembled files "by run", all DAQ channels were existing in the same HDF file. While shorter runs usually fitted into one file, longer runs still had to be aggregated over several files. The creation of the assembled type of files still involves the use of fairly unstable DAQ Mex-functions As the environment required for using the Mex-functions is already deprecated, its continued existence is uncertain.
44
45 The HDF hierarchy is almost identical in all formats. While in the the recent format each DAQ channel contains the data sets "value" and "index", the deprecated format had one data set for each DAQ channel. The deprecated formats supplies no time axis parameters for spectra data types.
46 {{/expand}}
47
48 === HDF excerpt: ===
49 {{/layout-cell}}
50 {{/layout-section}}
51
52 {{layout-section ac:type="three_equal"}}
53 {{layout-cell}}
54 * ADC data as example for **fast** **data** (10 Hz):           
55
56 \\
57
58 [[image:attach:image2020-11-16_15-26-28.png||height="250"]]
59 {{/layout-cell}}
60
61 {{layout-cell}}
62 * The //average// FEL pulse energy as example for the **slow** **data** (different e.g. 1 Hz):
63
64 ( every 10th train ID is listed in the HDF group "index")
65
66 \\
67
68 [[image:attach:image2020-11-16_15-31-45.png||height="250"]]
69 {{/layout-cell}}
70
71 {{layout-cell}}
72 * (((
73 //zraw// group contains the **original DAQ (DOOCS) names**
74 )))
75
76 of the properties saved in the DESY internal raw format. (For experts)
77
78 \\
79
80 [[image:attach:image2020-11-16_16-26-3.png||height="400"]]
81 {{/layout-cell}}
82 {{/layout-section}}
83
84 {{layout-section ac:type="single"}}
85 {{layout-cell}}
86 {{info title="Sample scripts in python"}}
87 === Reference implementation (Python) ===
88
89 [[~[~[image:attach:binder_badge.png~|~|thumbnail="true" width="120"~]~]>>url:https://mybinder.org/v2/git/https%3A%2F%2Fgitlab.desy.de%2Fchristopher.passow%2Fflash-daq-hdf/master||shape="rect"]]
90
91 (% class="Object" %)[[https:~~/~~/gitlab.desy.de/christopher.passow/flash-daq-hdf>>url:https://gitlab.desy.de/christopher.passow/flash-daq-hdf||shape="rect"]]
92 {{/info}}
93 {{/layout-cell}}
94 {{/layout-section}}
95
96 {{layout-section ac:type="single"}}
97 {{layout-cell}}
98 == The discontinued (till 2021) FLASH HDF5 structure ==
99
100 The photon diagnostic, electron diagnostic and beamline information as well as the information about the pump-probe laser and the infrastructure offered for users (GHz/MHz ADCs) can be included in one HDF5 file which is organized according to train IDs. The general structure is:
101
102 * Electron Diagnostic
103 * Photon Diagnostics
104 * Beamlines
105 * Experiment
106 * Timing
107 [[image:attach:HDF5_structure.jpg||height="400"]]
108
109 A detailed description of (most) channels can be found in the lower part of the hdf5 viewer:
110 [[image:attach:HDF5_structure_desc.jpg||thumbnail="true" height="250"]]
111
112 [[Contents>>doc:||anchor="Contents"]]
113
114 \\
115
116 === HDF5 example files (old format) ===
117
118 Here we have a few HDF5 samples (User data combined with Photon diagnostics data) from a few beamtimes showing the different kind options.
119
120 [[image:attach:image2019-10-21_17-2-50.png||thumbnail="true" width="300"]] [[download HDF5 (Images @ FL2)>>url:https://desycloud.desy.de/index.php/s/nyEgeCWJFC4gao2||shape="rect"]]
121
122 \\
123
124 [[~[~[image:attach:image2019-10-22_10-52-27.png~|~|thumbnail="true" width="300"~]~]download HDF5 (GHz ADC and OPIS @ FL2)>>url:https://desycloud.desy.de/index.php/s/AeA2kPNNnZgX95A||shape="rect"]]
125
126 \\
127
128 \\
129
130 [[Contents>>doc:||anchor="Contents"]]
131
132 \\
133
134 == Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
135
136 {{id name="DOOCSparameters"/}}
137
138 The complete list for the relation between DOOCS names and HDF5 names for the recordable parameters can be found in [[DESY's Repository~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://stash.desy.de/projects/CS/repos/pah/browse/src/camp/data/channel2HdfName.dat||shape="rect"]].
139 The most common and often used ones are summarized below:
140
141 Note, the HDF group and data set names apply to our HDF tree version since vers. 0.3.0.
142
143 \\
144
145 === FLASH1 ===
146
147 \\
148
149 ==== Beamline info (FLASH1) ====
150
151 {{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}
152 //always saved (PBD)//
153 DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
154 DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
155 desc: set pressure in the gas attenuator
156 units: mbar
157 \\
158
159 {{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
160 //always saved (PBD)//
161 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
162 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
163 desc: BL Beamline Fast shutter state
164 units: none
165 \\
166
167 {{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
168 //always saved (PBD)//
169 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
170 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
171 desc: PG Beamline Fast shutter state
172 units: none
173 \\
174
175 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
176 //always saved (PBD)//
177 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
178 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
179 desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
180 units: degree
181 \\
182
183 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
184 //always saved (PBD)//
185 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
186 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
187 desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
188 units: degree
189 \\
190
191 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
192 //always saved (PBD)//
193 DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
194 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
195 desc: Position of the PG filter wheel 1
196 units: degree
197 \\
198
199 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
200 //always saved (PBD)//
201 DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
202 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
203 desc: Position of the PG filter wheel 2
204 units: degree
205 \\
206
207 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
208 //always saved (PBD)//
209 DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
210 DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
211 desc: Position of the PG filter wheel 3
212 units: degree
213
214 \\
215
216
217 NOTE: Aperture positions in the beamline as well as the positions of the beam steering mirrors are also saved. For more Info contact your local contact
218
219 [[Contents>>doc:||anchor="Contents"]]
220
221 \\
222
223 ==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]]) ====
224
225 \\
226
227 (% style="color: rgb(0,0,0);" %)**Discontinued GMD data recording / evaluation  (VME + PhotonFlux ML server)**
228
229 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
230 //always saved (PBD)//
231
232 (% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}} (%%)
233 (% style="color: rgb(0,0,0);" %)DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}(%%)
234 desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator (ion current)
235 units : microJ
236
237 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
238 //always saved (PBD)//
239
240 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
241 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
242 desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
243 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
244
245 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
246 //always saved (PBD)//
247 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
248 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
249 desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
250 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
251
252 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
253 //always saved (PBD)//
254
255 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
256 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
257 desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
258 units : microJ
259
260 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
261 //always saved (PBD)//
262
263 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
264 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
265 desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
266 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
267
268 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
269 //always saved (PBD)//
270 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
271 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
272 desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
273 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
274
275 \\
276
277 (% style="color: rgb(0,0,0);" %)**NEW (2021) GMD data recording / evaluation  (MTCA, analog to FLASH2 and XFEL)**
278
279 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
280 //always saved (PBD)//
281 (% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}} (%%)
282 (% style="color: rgb(0,0,0);" %)DAQ channel: {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}
283
284 desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator
285 units : microJ
286
287 \\
288
289 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
290 //always saved (PBD)//
291
292 (% style="color: rgb(0,0,0);" %)DOOCS prop : 
293 {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}
294
295 desc : Energy per pulse measured in the Tunnel.  In addition measurement errors and beam position are included for EACH pulse in the pulse train  !! (see below)
296 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
297
298 {{info title="GMD pulse resolved data structure"}}
299 For every pulse in the pulse train the information is saved:
300
301
302 1. **Intensity per pulse** (a.u. (more or less µJ ))
303 1. Intensity per pulse (auxillary GMD) - not used
304 1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
305 1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
306 1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color: rgb(0,0,0);" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
307 1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
308 1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
309 1. Combined warning and error flags
310
311 The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this 
312 file
313
314
315 [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
316
317 \\
318 {{/info}}
319
320 All values for the GMD are also available for the** BDA GMD **which is located in the experimental hall down stream the gas attenuator. If the attenuator is on the ratio between BDA and Tunnel signal shows the attenuation. **BUT NOTE** that the filter units  are downstream the GMD. So if filters  are used this influence is NOT measured by the GMD BDA !
321
322 \\
323
324 Besides  pulse energy the GMD also provides information about the beam position
325
326 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
327 //always saved (PBD)//
328 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
329 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
330 desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
331 units : mm
332
333 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
334 //always saved (PBD)//
335 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
336 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
337 desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
338 units : mm
339
340 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
341 //always saved (PBD)//
342 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
343 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
344 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
345 units : mm
346
347 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
348 //always saved (PBD)//
349 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
350 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
351 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
352 units : mm
353
354 \\
355
356 ==== Spectrometer (FLASH1) ====
357
358 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
359 _always saved (when Spectrum is measured !!) (PBD) _
360 DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}
361 DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}
362 desc : XUV Spectrum measured with the "tunnel spectrometer"
363 units :
364
365 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}
366 _always saved (when Spectrum is measured !!) (PBD) _
367 DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
368 DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
369 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
370 units : nm
371
372 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}
373 _always saved (when Spectrum is measured !!) (PBD) _
374 DOOCS prop : ==
375 DAQ channel: ==
376 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
377 units : nm
378
379 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}
380 //saved on DEMAND (PBD spectrometer stream)//
381 DOOCS prop : ==
382 DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}
383 desc : XUV Spectrum in eV measured with the "PG2 spectrometer"
384 units :
385
386 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}
387 //saved on DEMAND (PBD spectrometer stream)//
388 DOOCS prop : ==
389 DAQ channel: ==
390 desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
391 units : eV
392
393 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}
394 //saved on DEMAND (PBD spectrometer stream)//
395 DOOCS prop : ==
396 DAQ channel: ==
397 desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
398 units : eV
399
400 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}
401 //saved on DEMAND (PBD spectrometer stream)//
402 DOOCS prop : ==
403 DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}
404 desc : XUV Spectrum in nm measured with the "PG2 spectrometer"
405 units :
406
407 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}
408 //saved on DEMAND (PBD spectrometer stream)//
409 DOOCS prop : ==
410 DAQ channel: ==
411 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
412 units : nm
413
414 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}
415 //saved on DEMAND (PBD spectrometer stream)//
416 DOOCS prop : ==
417 DAQ channel: ==
418 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
419 units : nm
420
421 [[Contents>>doc:||anchor="Contents"]]
422
423 ==== Electron Beam properties (FLASH1) ====
424
425 ===== bunch charge =====
426
427 {{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
428 //always saved (PBD)//
429 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
430 DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
431 desc: electron bunch charge (FLASH1)
432 units: nC
433
434 =====
435 arrival time =====
436
437 {{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
438 //always saved (PBD)//
439 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
440 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
441 desc: Electron bunch arrival time measured with the BAM inside the accelerator - however shows a very good correlation to the arrivaltime  of the XUV pulses in the experiment (pulse resolved data).
442 units: ps (bigger numbers indicate later arrivaltime of the electrons)
443
444 {{code language="none"}}/FL1/Electron Diagnostic/BAM/1SFELC/electron bunch arrival time (low charge){{/code}}
445 //always saved (PBD)//
446 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/1SFELC/LOW_CHARGE_ARRIVAL_TIME{{/code}}
447 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/1SFELC.LOW_CHARGE_ARRIVAL_TIME{{/code}}
448 desc: Electron bunch arrival time measured with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.
449 units: ps (bigger numbers indicate later arrivaltime of the electrons)
450
451 {{info title="BAM hints"}}
452 * besides the arrivaltime from FLASH1 there is also the FLASH2/3 electron arrival time saved.In case of doubt ask your local contact
453 * [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments >>doc:FLASHUSER.Additional helpful things.FLASH beamlines and instruments references.WebHome]]
454 * [[LINK to detailed infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]]
455 * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
456 {{/info}}
457
458 \\
459
460 ===== electron beam profile =====
461
462 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
463 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
464 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
465 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
466 desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
467 units: pixel
468 \\
469
470 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
471 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
472 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
473 DAQ channel: = PBD.BEAM.PROF.ML/CCT=
474 desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
475 units: fs per pixel
476 \\
477
478 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
479 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
480 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
481 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
482 desc: rms pulse width of the measures TDS electron bunch profile
483 units: fs
484
485 ===== electron bunch energy =====
486
487 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
488 //always saved (PBD)//
489 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
490 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
491 desc: electron bunch energy (average over the bunch train)
492 units: (% class="twikiNewLink" %)MeV(%%)
493 \\
494
495 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
496 //always saved (PBD)//
497 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
498 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
499 desc: electron bunch energy bunch resolved
500 units: (% class="twikiNewLink" %)MeV
501
502 \\
503
504 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
505 //always saved (PBD)//
506 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
507 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
508 desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
509 units: nm
510 \\
511
512 [[Contents>>doc:||anchor="Contents"]]
513
514 \\
515
516 ==== Timing information, rep rate etc.  (FLASH1) ====
517
518 ===== bunch repetition rate =====
519
520 {{code language="none"}}/FL1/Timing/repetition rate{{/code}}
521 //always saved (PBD)//
522 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
523 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
524 desc: repetition rate of the bunches / pulses within the burst (FLASH1)
525 units: kHz
526 \\
527
528 ===== set number of pulses =====
529
530 {{code language="none"}}/FL1/Timing/set number of bunches{{/code}}
531 //always saved (PBD)//
532 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH1{{/code}}
533 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_NUM{{/code}}
534 desc: Number of pulses set at the gun (FLASH1)
535 units:
536
537 ===== actual number of pulses =====
538
539 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
540 //always saved (PBD)//
541 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
542 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
543 desc: Number of bunches measured BEHIND the undulator. If pulses are used for diagnostic of the protection system of the accelerator limits the number of bunches to be accelerated this is the actual number that created XUV radiation.The number is calculated by the DAQ middle layer server, (FLASH1)
544 units:
545 \\
546
547 ===== actual pulse pattern recorded after the undulator =====
548
549 {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
550 //always saved (PBD)//
551 DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
552 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
553 desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH1)
554 units:
555 \\
556
557 ===== Train ID =====
558
559 {{code language="none"}}/Timing/train ID{{/code}}
560 //always saved (PBD)//
561 DOOCS prop : {{code language="none"}}none{{/code}}
562 DAQ channel: {{code language="none"}}none{{/code}}
563 desc: Each 10 Hz burst has its unique train ID. For the HDF5 data set the ID is the same for all parameters with the same index (note camera images may be shifted by 1 ID - talk to the experts !)
564 units:
565 \\
566
567 ===== Train time =====
568
569 {{code language="none"}}/Timing/train time{{/code}}
570 desc:Local time as array of day, hour, minute, second, and centisecond. This data set is meant for visualization purposes only. For correlations use the train ID or the Unix time of the time stamp
571 units: d h min s cs
572 \\
573
574 {{code language="none"}}/Timing/time stamp{{/code}}
575 desc:first column: Local time in unix time. To get day, hour, minute, second you can use unix: e.g. date ~-~-date='@1553617729' or matlab, python etc
576 second column: microseconds
577 third column: Train ID of FLASH
578 \\
579
580 [[Contents>>doc:||anchor="Contents"]]
581
582 \\
583
584 ==== Pump Probe Laser (FLASH1) ====
585
586 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser attenuation{{/code}}
587
588 //always saved (PBD)//
589 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
590 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
591 desc: attenuation of the PPLaser (rotation of a waveplate)
592 units : 0 no transmission , 1: full transmission
593
594 \\
595
596 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}
597 //always saved (PBD)//
598 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
599 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
600 desc: delay of the Pump probe laser - measured by the read back position of the motor. only read out every secound ... better use the encoder
601 units : ps ( pos delay means IR comes later)
602
603 \\
604
605 {{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}
606 //always saved (PBD)//
607 DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}
608 DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}
609 subsystem: {{code language="none"}}DELLINE.ENC{{/code}} desc : delay of the Pump probe laser - measured by an encoder. The position is read out with 10Hz train synchronized and should be used to determine the actual laser delay (the motor position is only read out about every second
610 units : ps ( pos delay means IR comes later)
611
612 \\
613
614 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}
615 //always saved (PBD)//
616 DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
617 DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
618 desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
619
620 \\
621
622 {{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}
623 //always saved (PBD)//
624 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
625 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
626 desc: delaytime between the optical laser and the FEL units: ps
627
628 \\
629
630 [[Contents>>doc:||anchor="Contents"]]
631
632 \\
633
634 ==== User Data (FLASH1) ====
635
636 The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.
637
638 NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
639
640 The most common and permanently installed device used by experiment are our ADCs:
641
642 ===== GHz ADCs =====
643
644 ADC traces of the (SPDevices 412) GHZ ADCs available for the users . More information about the ADCs can be found** [[here>>doc:FLASHUSER.Data Acquisition and controls.Controls (DOOCS, jDDD,\.\.\.).MTCA ADCs.WebHome]]**
645 //saved on DEMAND in the user DAQ//
646 \\The HDF5 names for the ADC traces are depending on the beamline :
647 \\PG Beamline:
648 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}
649 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}
650 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}
651 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}
652
653 BL Beamlines:
654 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}
655 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}
656 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}
657 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}
658 \\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}
659 {{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}
660 \\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}
661 {{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}
662
663 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
664 here the {{code language="none"}}CH00.TD{{/code}} is the full ADC trace as it is sampled ( typically several 100.000 samples per pulse train) while the {{code language="none"}}CH00.DAQ.TD{{/code}} trace only has the number of samples which are sent to the DAQ OR if //grouping// is activated the {{code language="none"}}CH00.DAQ.TD{{/code}} conatins only the grouped spectra. To read the ADC trace with an online analysis program the {{code language="none"}}CH00.DAQ.TD{{/code}} is used preferablly.
665 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
666
667 In addition there are also additional parameters saved like:
668
669 * {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
670 * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
671 * {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
672
673 ===== MHz ADCs =====
674
675 similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
676 {{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}
677 DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
678 DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
679
680 In addition there are also additional parameters saved like:
681
682 * {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
683 * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
684
685 [[Contents>>doc:||anchor="Contents"]]
686
687 \\
688
689 \\
690
691 \\
692
693 === FLASH2 ===
694
695 There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs
696
697 ==== Beamline info (FLASH2) ====
698
699 {{code language="none"}}/FL2/Beamlines/Attenuator/pressure  {{/code}}
700 (% style="color: rgb(0,0,0);" %)//always saved (PBD2)// (%%)
701 (% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
702 (% style="color: rgb(0,0,0);" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
703 (% style="color: rgb(0,0,0);" %)desc: set pressure in the gas attenuator (%%)
704 (% style="color: rgb(0,0,0);" %)units: mbar(%%)
705 \\
706
707 {{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
708 //always saved (PBD2)//
709 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER/CH00.TD{{/code}}
710 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER{{/code}}
711 desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
712 units: none
713
714
715 {{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 1{{/code}}
716 //always saved (PBD2)//
717 DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}
718 DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
719 desc: Position of the BL filter wheel 1 - to correlate with the filter material please look **[[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]**
720 units: degree
721 \\
722
723 /FL2/Beamlines/Filter wheel/position wheel 2
724 always saved (PBD2)
725 DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
726 DAQ channel: {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
727 desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
728 units: degree
729
730 \\
731
732 NOTE: Aperture positions in the beamline as well as the positions of the beam steering mirrors are also saved. for more Info contact your local contact
733
734 [[Contents>>doc:||anchor="Contents"]]
735
736 \\
737
738 \\
739
740 ==== Photon Diagnostics SASE ([[XGMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]] - FLASH2) ====
741
742 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
743 //always saved (PBD2)//
744 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
745 DAQ channel:{{code language="none"}} FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
746 desc : calibrated average ( ~~ 20 sec averaging time ) SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)
747 units : microJ
748
749 \\
750
751 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
752 //always saved (PBD2)//
753 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
754 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
755 desc : Energy per pulse measured in the Tunnel  (in front of the gas attenuator and the apertures in the Hall) In addition measurement errors and beam position are included for EACH pulse in the pulse train  !! (see below)
756 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
757
758 {{info title="GMD pulse resolved data structure"}}
759 For every pulse in the pulse train the information is saved:
760
761
762 1. **Intensity per pulse** (a.u. (more or less µJ ))
763 1. Intensity per pulse (auxillary GMD) - not used
764 1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
765 1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
766 1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color: rgb(0,0,0);" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
767 1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
768 1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
769 1. Combined warning and error flags
770
771 The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this 
772 file
773
774
775 [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
776
777 \\
778 {{/info}}
779
780 \\
781
782 All values for the GMD are also available for the** HALL GMD **which is located in the experimental hall down stream the gas attenuator. If the attenuator is on the ratio between Hall and Tunnel signal shows the attenuation. **BUT NOTE** that the filter unit and the Aperture 4 are downstream the GMD. So if filters and aperture are used this influence is NOT measured by the GMD hall !
783
784 \\
785
786 Besides  pulse energy the GMD also provides information about the beam position
787
788 \\
789
790 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel horizontal{{/code}}
791 //always saved (PBD2)//
792 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
793 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
794 desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
795 units : mm
796
797 \\
798
799 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel vertical{{/code}}
800 //always saved (PBD2)//
801 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
802 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
803 desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
804 units : mm
805
806 \\
807
808 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel x
809 always saved (PBD2)
810 DOOCS prop : FLASH.FEL/XGM.BPM/FL2.HALL/X.TD
811 DAQ channel: FLASH.FEL/XGM.BPM/FL2.HALL:2
812 desc: Besides the well calibrated averaged beam position information there is also the option to measure the beam position on a single bunch level. HOWEVER this methide needs a perfectly adjusted signal level (talk to your local contact !!) and also then the signal to noise is rather small and one needs some averaging ... BUT with this option one can determine if there was a spatial slope on a burst (say forst bunches were lower than the last ones or so ...)
813 units : mm   
814
815 (x=horizontal, y = vertial)
816
817 again the same parameter set is available for the **HALL GMD**
818
819 \\
820
821 \\
822
823 ==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
824
825 for more info see:** [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]**
826
827 (The OPIS hall is not installed yet ...)
828
829 \\
830
831 {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean photon energy{{/code}}
832 // saved opon request (PBD2)//
833 DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
834 DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
835 desc : mean photon energy ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
836 units : eV
837
838 \\
839
840 {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelength{{/code}}
841 // saved opon request (PBD2)//
842 DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
843 DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
844 desc : meanwavelength ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
845 units : nm
846
847 \\
848
849 {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/number of analyzed bunch        (in older version this can be found in OPIS tunnel/Expert stuff/General operation parameters/){{/code}}
850 // saved opon request (PBD2)//
851 DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
852 DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
853 desc : The bunch number of the bunch used for the wavelength calculation
854 units :
855
856 \\
857
858 If Opis is running typically on the the averaged data is saved. For several experiments it may make sense to save the information for each single bunch. This is up to now done by savng the compleate ADC trace of the TOF setup. This is a huge amount of data and needs processing. This has to be performed after the beamtime in close contact to [[Markus Braune>>mailto:markus.braune@desy.de||shape="rect"]] ( respobsible for [[OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]])
859
860 \\
861
862 In case OPIS was not operating there is still informaton about the **set wavelength** for the undulators (see below) which may differ by up to 5 % from the actual wavelength due to different settings in the FEL ...
863
864 \\
865
866 \\
867
868 ==== Electron Beam properties (FLASH2) ====
869
870 ===== bunch charge =====
871
872 {{code language="none"}}/FL2/Electron Diagnostic/Bunch charge/after undulator{{/code}}
873 //always saved (PBD2)//
874 DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
875 DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
876 desc: electron bunch charge FLASH2 (average value for each bunchtrain).
877 units: nC
878
879 \\
880
881 ===== undulator settings =====
882
883 {{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/set wavelength{{/code}}
884 //always saved (PBD2)//
885 DOOCS prop : {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
886 DAQ channel:  {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
887 desc: Set value for the anticipated wavelength . This parameter is used to set the undulator gap. It may however deviate from the actual wavelength by several % ...
888 units: nm
889
890 {{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/SASE14 gap{{/code}}
891 //always saved (PBD2)//
892 DOOCS prop : {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
893 DAQ channel:  {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
894 desc: gap value of the undulators. This can be used to follow up how many undulators were closed and if there was a taper
895 units: mm
896
897 The gap values are saved for all 12 undulators (Nr 3 to 14). Undulator 14 is the one closest to the experimental hall.
898
899 =====
900 arrival time =====
901
902 {{code language="none"}}/FL2/Electron Diagnostic/BAM/8FL2XTDS/electron bunch arrival time (low charge){{/code}}
903 //always saved (PBD2)//
904 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/8FL2XTDS/LOW_CHARGE_ARRIVAL_TIME{{/code}}
905 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/8FL2XTDS.LOW_CHARGE_ARRIVAL_TIME{{/code}}
906 desc: Electron bunch arrival time measured with the BAM after the FLASH2 undulator (pulse resolved data)
907 units: ps (bigger numbers indicate later arrivaltime of the electrons)
908
909 **FL1**{{code language="none"}}//Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
910 //always saved (PBD2)//
911 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
912 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
913 desc: Electron bunch arrival time measured with the BAM  in the accelerator  (pulse resolved data)
914 units: ps (bigger numbers indicate later arrivaltime of the electrons)
915
916 \\
917
918 {{info title="BAM hints"}}
919 * The BAM 4DBC3 measures the arrivaltime of** FLASH 1 and FLASH2** in the same data set (thus also sorted in at /FL1/ !).
920 * The BAM 8FL2XTDS measures only for FLASH2 BUT has the same data structure as the other BAMS ... thus there are also (random) values in in the  FLASH1 time slot 
921 ** Structure: The first values are for FLASH1 bunches. After a gap of about 70 micros ( 70 colums)  with  as entry for the switching between FLASH 1 and 2 the values for the electrons used in FLASH2 start.  The start time of FLASH2 is also recorded in the DAQ. FLASH1 start time is for historic reasons 700. thus if e.g. the start time of FLASH2 ( property name see below) is 1200 it means that FLASH starts at column 500 (1200-700) ... .In case of doubt ask your local contact
922 * [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments >>doc:FLASHUSER.Additional helpful things.FLASH beamlines and instruments references.WebHome]]
923 * [[LINK to detailed infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]]
924 * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
925 {{/info}}
926
927
928 [[Contents>>doc:||anchor="Contents"]]
929
930 \\
931
932 ==== Timing information, rep rate etc.  (FLASH2) ====
933
934 ===== start time of FLASH2 =====
935
936 {{code language="none"}}/FL2/Timing/start time flash2{{/code}}
937 //always saved (PBD2)//
938 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
939 DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
940 desc: The max 600 µs acceleration time of FLASH is devided between FLASH1 and FLASH2. This 600 µs window starts with FLASH1 (up to now)  at a time"label" of 700 µs (for historic reasons). Thus the first bunch of FLASH 1 comes at "700" and the last possibel bunch comes at 1300 (700+600). After FLASH1 train is over ther is a about 70µs switching time with no bunches. Then comes the first FLASH2 bunch.  Thus if e.g. the start time of FLASH2 is 1200 it means that FLASH2 starts at column 500 (1200-700)  in the HDF5 files. (However for yet unknown reasons this may change by 2-3 colums ...)
941 units: µs
942
943 ===== bunch repetition rate =====
944
945 {{code language="none"}}/FL2/Timing/repetition rate{{/code}}
946 //always saved (PBD2)//
947 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
948 DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
949 desc: repetition rate of the bunches / pulses within the burst (FLASH2)
950 units: kHz
951
952 ===== actual number of pulses =====
953
954 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
955 //always saved (PBD2)//
956 DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
957 DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
958 desc: Number of bunches measured BEHIND the undulator. If pulses are used for diagnostic of the protection system of the accelerator limits the number of bunches to be accelerated this is the actual number that created XUV radiation.The number is calculated by the DAQ middle layer server, (FLASH2)
959 units:
960 \\
961
962 ===== actual pulse pattern recorded after the undulator =====
963
964 {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
965 //always saved (PBD2)//
966 DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
967 DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
968 desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH2)
969 units:
970 \\
971
972 ===== Train ID =====
973
974 {{code language="none"}}/Timing/train ID{{/code}}
975 //always saved (PBD2)//
976 DOOCS prop : {{code language="none"}}none{{/code}}
977 DAQ channel: {{code language="none"}}none{{/code}}
978 desc: Each 10 Hz burst has its unique train ID. For the HDF5 dataset the ID is the same for all parameters with the same index (note camera images may be shifted by 1 ID - talk to the experts !)
979 units:
980 \\
981
982 ===== Train time =====
983
984 //always saved (PBD2)
985 //{{code language="none"}}/Timing/train time{{/code}}
986 desc:Local time as array of day, hour, minute, second, and centisecond. This dataset is meant for visualisation purposes only. For correlations use the train ID or the Unix time of the time stamp
987 units: d h min s cs
988 \\
989
990 {{code language="none"}}/Timing/time stamp{{/code}}
991
992 //always saved (PBD2)//
993 desc: first column: Local time in unix time. To get day, hour, minute, second you can use unix: e.g. date ~-~-date='@1553617729' or matlab, python etc
994 second column: microseconds
995 third column: Train ID of FLASH
996 \\
997
998 [[Contents>>doc:||anchor="Contents"]]
999
1000 \\
1001
1002 ==== User Data (FLASH2) ====
1003
1004 The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.
1005
1006 NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
1007
1008 The most common and permanently installed device used by experiment are our ADCs:
1009
1010 ===== GHz ADCs =====
1011
1012 ADC traces of the (SPDevices 412) GHZ ADCs available for the users . More information about the ADCs can be found** [[here>>doc:FLASHUSER.Data Acquisition and controls.Controls (DOOCS, jDDD,\.\.\.).MTCA ADCs.WebHome]]**
1013 //saved on DEMAND in the user DAQ//
1014 \\Up to now there are 4 channels available at FL24
1015 \\\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD{{/code}}
1016 {{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH01/TD{{/code}}
1017 \\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH02/TD{{/code}}{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH03/TD{{/code}}
1018
1019 \\
1020
1021 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
1022 here the {{code language="none"}}CH00.TD{{/code}} is the full ADC trace as it is sampled ( typically several 100.000 samples per pulse train) while the {{code language="none"}}CH00.DAQ.TD{{/code}} trace only has the number of samples which are sent to the DAQ OR if //grouping// is activated the {{code language="none"}}CH00.DAQ.TD{{/code}} conatins only the grouped spectra. To read the ADC trace with an online analysis program the {{code language="none"}}CH00.DAQ.TD{{/code}} is used preferablly.
1023 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
1024
1025 In addition there are also additional parameters saved like:
1026
1027 * {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
1028 * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
1029 * {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
1030 * {{code language="none"}}/CH0-CH3/offset{{/code}}: To use the full dynamic range of the ADC one can shift the base line . This offset is saved here.
1031
1032 ===== MHz ADCs =====
1033
1034 similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
1035 {{code language="none"}}/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH2/TD{{/code}}
1036 DOOCS prop : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02/CH00.TD
1037 DAQ channel: : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02
1038
1039 In addition there are also additional parameters saved like:
1040
1041 * {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
1042 * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
1043
1044 [[Contents>>doc:||anchor="Contents"]]
1045
1046 \\
1047
1048 \\
1049
1050 ==== Pump Probe Laser (FLASH2) ====
1051
1052 There may be more information available from the "Laser DAQ". laese contact your Laser Local Contact.
1053
1054
1055 {{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}//always saved (PBD2)//
1056 DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1057 DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1058 desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1059 units : deg.
1060
1061 \\
1062
1063
1064 {{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/polarization position{{/code}}//always saved (PBD2)//
1065 DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1066 DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1067 desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1068 units : deg.
1069
1070 \\
1071
1072 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay readback{{/code}}
1073 //always saved (PBD2)//
1074 DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1075 DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1076 desc: delay of the Pump probe laser - measured by the read back position of the motor. There is also the set value available ( upto now these values are only updating every 1-2 seconds. There is no fast encoder property as on FLASH1 available)
1077 units : ps )
1078
1079 \\
1080
1081 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
1082 //always saved (PBD)//
1083 DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1084 DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1085 desc: rms jitter of the fs-Oscillator
1086 units: fs
1087
1088 [[Contents>>doc:||anchor="Contents"]]
1089
1090 \\
1091
1092 === "/uncategorized/" ===
1093
1094 If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with their DOOCS names
1095
1096 \\
1097
1098 === HDF5 structure revisions ===
1099
1100 Starting with Beamblock 4, August 2018, the hierarchy of the HDF group names have been adapted to reflect the new situation at FLASH. FLASH2 is operating for users quite some time now. Therefore, both accelerators appear equally in their respective HDF groups, namely "/FL1" and "/FL2". The root group of proper, by run organised HDF files have an attribute called "version". This version attribute has changed from "0.2.x" to "0.3.x". The changes in detail:
1101
1102 \\
1103
1104 * All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.
1105 * The ambigious term "pulse" has been replaced by "train" to refer to "pulse train". Most notably, the dataset "/Timing/pulse ID" has changed to "/Timing/train ID".
1106 * A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.
1107
1108 \\
1109
1110 |=(((
1111 earlier HDF path (vers. 0.2)
1112 )))|=(((
1113 is now (vers. 0.3)
1114 )))
1115 |(((
1116 /Photon Diagnostic/GMD/Beam position/position BDA x
1117 )))|(((
1118 /FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal
1119 )))
1120 |(((
1121 /Photon Diagnostic/GMD/Beam position/position BDA y
1122 )))|(((
1123 /FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical
1124 )))
1125 |(((
1126 /Photon Diagnostic/GMD/Beam position/position tunnel x
1127 )))|(((
1128 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal
1129 )))
1130 |(((
1131 /Photon Diagnostic/GMD/Beam position/position tunnel y
1132 )))|(((
1133 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical
1134 )))
1135 |(((
1136 /Experiment/Pump probe laser/BPM/position x
1137 )))|(((
1138 /FL1/Experiment/Pump probe laser/BPM/position horizontal
1139 )))
1140 |(((
1141 /Experiment/Pump probe laser/BPM/position y
1142 )))|(((
1143 /FL1/Experiment/Pump probe laser/BPM/position vertical
1144 )))
1145 |(((
1146 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal
1147 )))|(((
1148 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
1149 )))
1150 |(((
1151 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical
1152 )))|(((
1153 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
1154 )))
1155 |(((
1156 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal
1157 )))|(((
1158 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
1159 )))
1160 |(((
1161 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical
1162 )))|(((
1163 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
1164 )))
1165 |(((
1166 /FL2/Photon Diagnostic/GMD/Average energy/hall
1167 )))|(((
1168 /FL2/Photon Diagnostic/GMD/Average energy/energy hall
1169 )))
1170 |(((
1171 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
1172 )))|(((
1173 /FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)
1174 )))
1175 |(((
1176 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
1177 )))|(((
1178 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel
1179 )))
1180 |(((
1181 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
1182 )))|(((
1183 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)
1184 )))
1185 |(((
1186 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x
1187 )))|(((
1188 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
1189 )))
1190 |(((
1191 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y
1192 )))|(((
1193 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
1194 )))
1195 |(((
1196 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x
1197 )))|(((
1198 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
1199 )))
1200 |(((
1201 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y
1202 )))|(((
1203 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
1204 )))
1205
1206 \\
1207
1208 [[Contents>>doc:||anchor="Contents"]]
1209
1210 \\
1211
1212 == HDF5 and DOOCS ==
1213
1214 Here is an outdated [[list with the available properties that are always saved (PBD) for FLASH1 as>>attach:FLASH1__DaqChannel2HdfNamePbd.xlsx]] HDF5 names and the corresponding DOOCS names
1215
1216 [[Contents>>doc:||anchor="Contents"]]
1217
1218 \\
1219 {{/layout-cell}}
1220 {{/layout-section}}
1221 {{/layout}}