Wiki source code of The FLASH HDF5 structure

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