Wiki source code of The FLASH HDF5 structure

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