Wiki source code of The FLASH HDF5 structure

Version 40.1 by sndueste on 2021/02/09 14:35

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