Wiki source code of The FLASH HDF5 structure

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