Wiki source code of The FLASH HDF5 structure

Version 40.1 by sndueste on 2021/02/09 14:35
Hide last authors
sendels 1.1 1 == Contents ==
2
3
4
sndueste 13.1 5 {{toc/}}
sendels 1.1 6
7 \\
8
9 == General information about HDF5 ==
10
sndueste 35.1 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"]]
sendels 1.1 12
sndueste 35.1 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"]]
sendels 1.1 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
sendels 4.1 19 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 20
sndueste 40.1 21 == The new (starting 2021) HDF5 format ==
sendels 1.1 22
sndueste 40.1 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
sndueste 35.1 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:
sendels 1.1 72
73 * Electron Diagnostic
74 * Photon Diagnostics
75 * Beamlines
76 * Experiment
77 * Timing
sndueste 35.1 78 [[image:attach:HDF5_structure.jpg||height="400"]]
sendels 1.1 79
sndueste 35.1 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"]]
sendels 1.1 82
sendels 4.1 83 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 84
85 \\
86
sndueste 35.1 87 === HDF5 example files ===
sndueste 25.1 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
sndueste 29.1 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"]]
sndueste 25.1 92
93 \\
94
sndueste 29.1 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"]]
sndueste 25.1 96
sndueste 28.1 97 \\
sndueste 27.1 98
sndueste 25.1 99 \\
100
101 [[Contents>>doc:||anchor="Contents"]]
102
103 \\
104
erkben 30.1 105 == Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
sendels 1.1 106
erkben 30.1 107 {{id name="DOOCSparameters"/}}
108
sndueste 5.1 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"]].
sendels 1.1 110 The most common and often used ones are summarized below:
111
sndueste 5.1 112 Note, the HDF group and data set names apply to our HDF tree version since vers. 0.3.0.
sendels 1.1 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}}
sndueste 24.1 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]]
sendels 1.1 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}}
sndueste 24.1 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]]
sendels 1.1 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}}
sndueste 5.1 166 desc: Position of the PG filter wheel 1
sendels 1.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}}
sndueste 5.1 174 desc: Position of the PG filter wheel 2
sendels 1.1 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}}
sndueste 5.1 182 desc: Position of the PG filter wheel 3
sendels 1.1 183 units: degree
sndueste 8.1 184
sendels 1.1 185 \\
186
sndueste 8.1 187
sndueste 34.1 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
sndueste 8.1 189
sendels 4.1 190 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 191
sndueste 8.1 192 \\
193
sndueste 39.1 194 ==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]]) ====
sendels 1.1 195
sndueste 39.1 196 \\
197
198 (% style="color: rgb(0,0,0);" %)**Discontinued GMD data recording / evaluation  (VME + PhotonFlux ML server)**
199
sendels 1.1 200 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
sndueste 40.1 201 //always saved (PBD)//
sndueste 34.1 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)
sendels 1.1 206 units : microJ
207
208 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
sndueste 34.1 209 //always saved (PBD)//
210
sendels 1.1 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
sndueste 23.1 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]]**
sendels 1.1 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
sndueste 23.1 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]]**
sendels 1.1 222
223 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
sndueste 34.1 224 //always saved (PBD)//
225
sendels 1.1 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}}
sndueste 34.1 232 //always saved (PBD)//
233
sendels 1.1 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
sndueste 23.1 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]]**
sendels 1.1 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
sndueste 23.1 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]]**
sendels 1.1 245
sndueste 34.1 246 \\
247
sndueste 39.1 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
sendels 1.1 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}}
sndueste 19.1 301 desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
sendels 1.1 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}}
sndueste 19.1 308 desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
sendels 1.1 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}}
sndueste 19.1 315 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
sendels 1.1 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}}
sndueste 19.1 322 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
sendels 1.1 323 units : mm
324
sndueste 39.1 325 \\
326
327 ==== Spectrometer (FLASH1) ====
328
sendels 1.1 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
sendels 4.1 392 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 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
sndueste 5.1 405 =====
406 arrival time =====
sendels 1.1 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}}
sndueste 33.1 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)
sendels 1.1 414
sndueste 33.1 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
sendels 1.1 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}}
sndueste 40.1 459 //always saved (PBD)//
sendels 1.1 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)
sendels 2.1 463 units: (% class="twikiNewLink" %)MeV(%%)
sendels 1.1 464 \\
465
466 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
sndueste 40.1 467 //always saved (PBD)//
sendels 1.1 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
sndueste 5.1 471 units: (% class="twikiNewLink" %)MeV
sendels 1.1 472
473 \\
474
475 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
sndueste 40.1 476 //always saved (PBD)//
sendels 1.1 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
sendels 4.1 483 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 484
485 \\
486
sndueste 5.1 487 ==== Timing information, rep rate etc.  (FLASH1) ====
sendels 1.1 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}}
sndueste 18.1 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 !)
sendels 1.1 535 units:
536 \\
537
538 ===== Train time =====
539
540 {{code language="none"}}/Timing/train time{{/code}}
sndueste 18.1 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
sendels 1.1 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
sendels 4.1 551 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 552
553 \\
554
555 ==== Pump Probe Laser (FLASH1) ====
556
sndueste 5.1 557 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser attenuation{{/code}}
558
559 //always saved (PBD)//
sendels 1.1 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
sndueste 5.1 565 \\
566
sendels 1.1 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
sndueste 5.1 574 \\
575
sendels 1.1 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
sndueste 5.1 583 \\
584
sendels 1.1 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}}
sendels 2.1 589 desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
sendels 1.1 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
sendels 4.1 601 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 602
603 \\
604
605 ==== User Data (FLASH1) ====
606
sndueste 18.1 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
sendels 1.1 613 ===== GHz ADCs =====
614
sndueste 18.1 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]]**
sendels 1.1 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
sndueste 18.1 638 In addition there are also additional parameters saved like:
sendels 1.1 639
sndueste 16.1 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
sendels 1.1 643
644 ===== MHz ADCs =====
645
sndueste 5.1 646 similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
sendels 1.1 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
sndueste 18.1 651 In addition there are also additional parameters saved like:
sendels 1.1 652
sndueste 18.1 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
sendels 4.1 656 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 657
sndueste 18.1 658 \\
659
660 \\
661
662 \\
663
sendels 1.1 664 === FLASH2 ===
665
sndueste 7.1 666 There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs
sendels 1.1 667
sndueste 7.1 668 ==== Beamline info (FLASH2) ====
sndueste 6.1 669
sndueste 40.1 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(%%)
sndueste 5.1 676 \\
677
sndueste 7.1 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 ...)
sndueste 6.1 683 units: none
sndueste 5.1 684
685
sndueste 7.1 686 {{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 1{{/code}}
sndueste 8.1 687 //always saved (PBD2)//
sndueste 7.1 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
sndueste 24.1 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]]**
sndueste 6.1 691 units: degree
692 \\
693
sndueste 40.1 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
sndueste 6.1 700
sndueste 8.1 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
sndueste 6.1 705 [[Contents>>doc:||anchor="Contents"]]
706
707 \\
708
709 \\
710
sndueste 10.1 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) ====
sndueste 8.1 712
713 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
714 //always saved (PBD2)//
sndueste 9.1 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)
sndueste 8.1 718 units : microJ
719
720 \\
721
722 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
sndueste 9.1 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}}
sndueste 38.1 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)
sndueste 23.1 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]]**
sndueste 8.1 728
sndueste 39.1 729 {{info title="GMD pulse resolved data structure"}}
sndueste 38.1 730 For every pulse in the pulse train the information is saved:
731
sndueste 8.1 732
sndueste 38.1 733 1. **Intensity per pulse** (a.u. (more or less µJ ))
734 1. Intensity per pulse (auxillary GMD) - not used
sndueste 39.1 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)
sndueste 38.1 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
sndueste 8.1 741
sndueste 38.1 742 The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this 
743 file
sndueste 8.1 744
sndueste 38.1 745
746 [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
sndueste 8.1 747
sndueste 39.1 748 \\
749 {{/info}}
sndueste 38.1 750
sndueste 39.1 751 \\
sndueste 8.1 752
sndueste 9.1 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 !
sndueste 8.1 754
sndueste 9.1 755 \\
sndueste 8.1 756
sndueste 9.1 757 Besides  pulse energy the GMD also provides information about the beam position
sndueste 8.1 758
sndueste 9.1 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}}
sndueste 19.1 765 desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
sndueste 8.1 766 units : mm
767
sndueste 9.1 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}}
sndueste 19.1 774 desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
sndueste 8.1 775 units : mm
776
777 \\
778
sndueste 40.1 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   
sndueste 8.1 785
sndueste 40.1 786 (x=horizontal, y = vertial)
sndueste 9.1 787
788 again the same parameter set is available for the **HALL GMD**
789
sndueste 8.1 790 \\
791
sndueste 9.1 792 \\
793
sndueste 15.1 794 ==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
sndueste 10.1 795
sndueste 19.1 796 for more info see:** [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]**
sndueste 10.1 797
798 (The OPIS hall is not installed yet ...)
799
sndueste 9.1 800 \\
801
sndueste 10.1 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
sndueste 9.1 809 \\
810
sndueste 10.1 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
sndueste 9.1 818 \\
819
sndueste 10.1 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}}
sndueste 11.1 824 desc : The bunch number of the bunch used for the wavelength calculation
825 units :
sndueste 10.1 826
sndueste 9.1 827 \\
828
sndueste 11.1 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
sndueste 9.1 831 \\
832
sndueste 15.1 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 ...
sndueste 12.1 834
sndueste 9.1 835 \\
836
837 \\
838
sndueste 12.1 839 ==== Electron Beam properties (FLASH2) ====
840
841 ===== bunch charge =====
842
843 {{code language="none"}}/FL2/Electron Diagnostic/Bunch charge/after undulator{{/code}}
sndueste 14.1 844 //always saved (PBD2)//
sndueste 12.1 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}}
sndueste 15.1 847 desc: electron bunch charge FLASH2 (average value for each bunchtrain).
sndueste 12.1 848 units: nC
849
sndueste 9.1 850 \\
851
sndueste 14.1 852 ===== undulator settings =====
sndueste 9.1 853
sndueste 14.1 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
sndueste 12.1 860
sndueste 14.1 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}}
sndueste 15.1 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
sndueste 14.1 866 units: mm
867
sndueste 15.1 868 The gap values are saved for all 12 undulators (Nr 3 to 14). Undulator 14 is the one closest to the experimental hall.
sndueste 14.1 869
sndueste 12.1 870 =====
871 arrival time =====
872
sndueste 33.1 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
sndueste 14.1 880 **FL1**{{code language="none"}}//Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
881 //always saved (PBD2)//
sndueste 12.1 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}}
sndueste 33.1 884 desc: Electron bunch arrival time measured with the BAM  in the accelerator  (pulse resolved data)
sndueste 14.1 885 units: ps (bigger numbers indicate later arrivaltime of the electrons)
sndueste 12.1 886
sndueste 33.1 887 \\
sndueste 14.1 888
sndueste 33.1 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}}
sndueste 10.1 897
sndueste 14.1 898
sndueste 15.1 899 [[Contents>>doc:||anchor="Contents"]]
sndueste 12.1 900
901 \\
902
sndueste 16.1 903 ==== Timing information, rep rate etc.  (FLASH2) ====
sndueste 12.1 904
sndueste 15.1 905 ===== start time of FLASH2 =====
sndueste 12.1 906
sndueste 15.1 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}}
sndueste 17.1 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 ...)
sndueste 15.1 912 units: µs
sndueste 12.1 913
914 ===== bunch repetition rate =====
915
sndueste 15.1 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)
sndueste 12.1 921 units: kHz
922
923 ===== actual number of pulses =====
924
925 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
sndueste 15.1 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)
sndueste 12.1 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}}
sndueste 15.1 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)
sndueste 12.1 940 units:
941 \\
942
943 ===== Train ID =====
944
945 {{code language="none"}}/Timing/train ID{{/code}}
sndueste 15.1 946 //always saved (PBD2)//
sndueste 12.1 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
sndueste 16.1 955 //always saved (PBD2)
956 //{{code language="none"}}/Timing/train time{{/code}}
sndueste 12.1 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
sndueste 16.1 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
sndueste 12.1 965 second column: microseconds
966 third column: Train ID of FLASH
967 \\
968
969 [[Contents>>doc:||anchor="Contents"]]
970
971 \\
972
sndueste 19.1 973 ==== User Data (FLASH2) ====
sndueste 18.1 974
sndueste 19.1 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
sndueste 18.1 981 ===== GHz ADCs =====
982
sndueste 19.1 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]]**
sndueste 18.1 984 //saved on DEMAND in the user DAQ//
sndueste 19.1 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}}
sndueste 18.1 989
sndueste 19.1 990 \\
sndueste 18.1 991
sndueste 19.1 992 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
sndueste 18.1 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.
sndueste 19.1 994 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
sndueste 18.1 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:
sndueste 19.1 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
sndueste 18.1 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
sndueste 12.1 1017 \\
1018
1019 \\
1020
sndueste 21.1 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
sndueste 22.1 1026 {{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}//always saved (PBD2)//
sndueste 21.1 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
sndueste 12.1 1032 \\
1033
sndueste 21.1 1034
sndueste 22.1 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}}
sndueste 21.1 1038 desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1039 units : deg.
1040
sndueste 12.1 1041 \\
1042
sndueste 21.1 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
sndueste 12.1 1050 \\
1051
sndueste 22.1 1052 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
sndueste 21.1 1053 //always saved (PBD)//
sndueste 22.1 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
sndueste 21.1 1058
1059 [[Contents>>doc:||anchor="Contents"]]
1060
1061 \\
1062
sndueste 23.1 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
sendels 1.1 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
sendels 2.1 1081 (% class="wrapped" %)
sendels 1.1 1082 |=(((
sendels 4.1 1083 earlier HDF path (vers. 0.2)
sendels 1.1 1084 )))|=(((
sendels 4.1 1085 is now (vers. 0.3)
sendels 1.1 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
sendels 4.1 1180 [[Contents>>doc:||anchor="Contents"]]
sendels 1.1 1181
1182 \\
1183
1184 == Example code showing how to access HDF5 files ==
1185
1186 \\
1187
1188 == HDF5 and DOOCS ==
1189
sndueste 3.1 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
sendels 4.1 1191
1192 [[Contents>>doc:||anchor="Contents"]]