Wiki source code of The FLASH HDF5 structure

Version 6.1 by sndueste on 2019/09/16 10:29
Show last authors
1 == Contents ==
2
3 \\
4
5 * [[General information about HDF5>>doc:||anchor="General information about HDF5"]]
6 * [[FLASH HDF5 structure>>doc:||anchor="FLASH HDF5 structure"]]
7 * [[Most popular FLASH parameters and their names in HDF5>>doc:||anchor="Most popular FLASH parameters and their names in HDF5"]]
8 ** [[FLASH1>>doc:||anchor="FLASH1"]]
9 *** [[Beamline info (FLASH1)>>doc:||anchor="Beamline info (FLASH1)"]]
10 *** [[Photon Diagnostics SASE / Spectrometer (FLASH1)>>doc:||anchor="Photon Diagnostics SASE / Spectrometer (FLASH1)"]]
11 *** [[Electron Beam properties (FLASH1)>>doc:||anchor="Electron Beam properties (FLASH1)"]]
12 *** [[Timing information, rep rate etc.(FLASH1)>>doc:||anchor="Timing information, rep rate etc.(FLASH1)"]]
13 *** [[Pump Probe Laser (FLASH1)>>doc:||anchor="Pump Probe Laser (FLASH1)"]]
14 *** [[User Data (FLASH1)>>doc:||anchor="User Data (FLASH1)"]]
15 ** [[FLASH2>>doc:||anchor="FLASH2"]]
16 ** [[HDF5 structure revisions>>doc:||anchor="HDF5 structure revisions"]]
17 * [[Example code showing how to access HDF5 files>>doc:||anchor="Example code showing how to access HDF5 files"]]
18 ** [[Samples how to read HDF5 with Matlab>>doc:||anchor="Samples how to read HDF5 with Matlab"]]
19 ** [[How to read HDF5 with Python via FLASHH5>>doc:||anchor="How to read HDF5 with Python via FLASHH5"]]
20 * [[HDF5 and DOOCS>>doc:||anchor="HDF5 and DOOCS"]]
21
22 \\
23
24 \\
25
26 == General information about HDF5 ==
27
28 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://www.hdfgroup.org/HDF5/||shape="rect"]]
29
30 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://support.hdfgroup.org/products/java/hdfview/index.html||shape="rect"]]
31
32 For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :
33 {{code language="none"}}> module load xray{{/code}}
34 {{code language="none"}}> hdfview{{/code}}
35
36 [[Contents>>doc:||anchor="Contents"]]
37
38 == FLASH HDF5 structure ==
39
40 The photon diagnostic, electron diagnostic and beamline information as well as the information about the pump-probe laser and the infrastructure offered for users (GHz/MHz ADCs) can be included in one HDF5 file which is organised according to train IDs. The general structure is:
41
42 * Electron Diagnostic
43 * Photon Diagnostics
44 * Beamlines
45 * Experiment
46 * Timing
47 [[~[~[image:url:http://hasfweb.desy.de/pub/Setup/HDF5main/HDF5_structure.jpg~|~|alt="HDF5_structure.jpg" width="700" height="500"~]~]>>attach:HDF5_structure.jpg]]
48
49 A detailled description of (most) channels can be found in the lower part of the hdf5 viewer:
50 [[~[~[image:url:http://hasfweb.desy.de/pub/Setup/HDF5main/HDF5_structure_desc.jpg~|~|alt="HDF5_structure_desc.jpg" width="341" height="413"~]~]>>attach:HDF5_structure_desc.jpg]]
51
52 [[Contents>>doc:||anchor="Contents"]]
53
54 \\
55
56 == Most popular FLASH parameters and their names in HDF5 ==
57
58 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"]].
59 The most common and often used ones are summarized below:
60
61 Note, the HDF group and data set names apply to our HDF tree version since vers. 0.3.0.
62
63 \\
64
65 === FLASH1 ===
66
67 \\
68
69 ==== Beamline info (FLASH1) ====
70
71 {{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}
72 //always saved (PBD)//
73 DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
74 DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
75 desc: set pressure in the gas attenuator
76 units: mbar
77 \\
78
79 {{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
80 //always saved (PBD)//
81 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
82 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
83 desc: BL Beamline Fast shutter state
84 units: none
85 \\
86
87 {{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
88 //always saved (PBD)//
89 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
90 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
91 desc: PG Beamline Fast shutter state
92 units: none
93 \\
94
95 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
96 //always saved (PBD)//
97 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
98 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
99 desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
100 units: degree
101 \\
102
103 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
104 //always saved (PBD)//
105 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
106 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
107 desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
108 units: degree
109 \\
110
111 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
112 //always saved (PBD)//
113 DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
114 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
115 desc: Position of the PG filter wheel 1
116 units: degree
117 \\
118
119 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
120 //always saved (PBD)//
121 DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
122 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
123 desc: Position of the PG filter wheel 2
124 units: degree
125 \\
126
127 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
128 //always saved (PBD)//
129 DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
130 DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
131 desc: Position of the PG filter wheel 3
132 units: degree
133 \\
134
135 [[Contents>>doc:||anchor="Contents"]]
136
137 ==== Photon Diagnostics SASE / Spectrometer (FLASH1) ====
138
139 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
140 //always saved (PBD)//
141 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}}
142 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}
143 desc : calibrated average SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)
144 units : microJ
145
146 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
147 //always saved (PBD)//
148 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
149 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
150 desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
151 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
152
153 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
154 //always saved (PBD)//
155 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
156 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
157 desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
158 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
159
160 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
161 //always saved (PBD)//
162 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
163 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
164 desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
165 units : microJ
166
167 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
168 //always saved (PBD)//
169 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
170 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
171 desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
172 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
173
174 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
175 //always saved (PBD)//
176 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
177 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
178 desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
179 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
180
181 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
182 //always saved (PBD)//
183 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
184 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
185 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, x=horizontal)
186 units : mm
187
188 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
189 //always saved (PBD)//
190 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
191 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
192 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, y=vertical)
193 units : mm
194
195 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
196 //always saved (PBD)//
197 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
198 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
199 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, x=horizontal)
200 units : mm
201
202 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
203 //always saved (PBD)//
204 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
205 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
206 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, y=vertical)
207 units : mm
208
209 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
210 _always saved (when Spectrum is measured !!) (PBD) _
211 DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}
212 DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}
213 desc : XUV Spectrum measured with the "tunnel spectrometer"
214 units :
215
216 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}
217 _always saved (when Spectrum is measured !!) (PBD) _
218 DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
219 DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
220 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
221 units : nm
222
223 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}
224 _always saved (when Spectrum is measured !!) (PBD) _
225 DOOCS prop : ==
226 DAQ channel: ==
227 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
228 units : nm
229
230 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}
231 //saved on DEMAND (PBD spectrometer stream)//
232 DOOCS prop : ==
233 DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}
234 desc : XUV Spectrum in eV measured with the "PG2 spectrometer"
235 units :
236
237 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}
238 //saved on DEMAND (PBD spectrometer stream)//
239 DOOCS prop : ==
240 DAQ channel: ==
241 desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
242 units : eV
243
244 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}
245 //saved on DEMAND (PBD spectrometer stream)//
246 DOOCS prop : ==
247 DAQ channel: ==
248 desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
249 units : eV
250
251 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}
252 //saved on DEMAND (PBD spectrometer stream)//
253 DOOCS prop : ==
254 DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}
255 desc : XUV Spectrum in nm measured with the "PG2 spectrometer"
256 units :
257
258 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}
259 //saved on DEMAND (PBD spectrometer stream)//
260 DOOCS prop : ==
261 DAQ channel: ==
262 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
263 units : nm
264
265 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}
266 //saved on DEMAND (PBD spectrometer stream)//
267 DOOCS prop : ==
268 DAQ channel: ==
269 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
270 units : nm
271
272 [[Contents>>doc:||anchor="Contents"]]
273
274 ==== Electron Beam properties (FLASH1) ====
275
276 ===== bunch charge =====
277
278 {{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
279 //always saved (PBD)//
280 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
281 DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
282 desc: electron bunch charge (FLASH1)
283 units: nC
284
285 =====
286 arrival time =====
287
288 {{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
289 //always saved (PBD)//
290 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
291 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
292 desc: Electron bunch arrival time measured with the BAM (more or less) before the undulator (pulse resolved data)
293 units: ps (bigger numbers indicate later arrivaltime of the electrons)
294 note: besides the arivaltime from FLASH1 there is also the FLASH2/3 electron arrival time saved. [[LINK to detailled 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"]] and to a recent  [[talk about the working principle of the BAM>>url:https://confluence.desy.de/download/attachments/134216957/BAM-basics_and_outlook-2018_DESY-template_16-9Format.pdf?version=1&modificationDate=1565162143328&api=v2||shape="rect"]]
295
296 ===== electron beam profile =====
297
298 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
299 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
300 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
301 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
302 desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
303 units: pixel
304 \\
305
306 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
307 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
308 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
309 DAQ channel: = PBD.BEAM.PROF.ML/CCT=
310 desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
311 units: fs per pixel
312 \\
313
314 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
315 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
316 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
317 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
318 desc: rms pulse width of the measures TDS electron bunch profile
319 units: fs
320
321 ===== electron bunch energy =====
322
323 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
324 _always saved (PBD)
325 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
326 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
327 desc: electron bunch energy (average over the bunch train)
328 units: (% class="twikiNewLink" %)MeV(%%)
329 \\
330
331 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
332 _always saved (PBD)
333 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
334 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
335 desc: electron bunch energy bunch resolved
336 units: (% class="twikiNewLink" %)MeV
337
338 \\
339
340 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
341 _always saved (PBD)
342 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
343 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
344 desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
345 units: nm
346 \\
347
348 [[Contents>>doc:||anchor="Contents"]]
349
350 \\
351
352 ==== Timing information, rep rate etc.  (FLASH1) ====
353
354 ===== bunch repetition rate =====
355
356 {{code language="none"}}/FL1/Timing/repetition rate{{/code}}
357 //always saved (PBD)//
358 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
359 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
360 desc: repetition rate of the bunches / pulses within the burst (FLASH1)
361 units: kHz
362 \\
363
364 ===== set number of pulses =====
365
366 {{code language="none"}}/FL1/Timing/set number of bunches{{/code}}
367 //always saved (PBD)//
368 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH1{{/code}}
369 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_NUM{{/code}}
370 desc: Number of pulses set at the gun (FLASH1)
371 units:
372
373 ===== actual number of pulses =====
374
375 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
376 //always saved (PBD)//
377 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
378 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
379 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)
380 units:
381 \\
382
383 ===== actual pulse pattern recorded after the undulator =====
384
385 {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
386 //always saved (PBD)//
387 DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
388 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
389 desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH1)
390 units:
391 \\
392
393 ===== Train ID =====
394
395 {{code language="none"}}/Timing/train ID{{/code}}
396 //always saved (PBD)//
397 DOOCS prop : {{code language="none"}}none{{/code}}
398 DAQ channel: {{code language="none"}}none{{/code}}
399 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 !)
400 units:
401 \\
402
403 ===== Train time =====
404
405 {{code language="none"}}/Timing/train time{{/code}}
406 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
407 units: d h min s cs
408 \\
409
410 {{code language="none"}}/Timing/time stamp{{/code}}
411 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
412 second column: microseconds
413 third column: Train ID of FLASH
414 \\
415
416 [[Contents>>doc:||anchor="Contents"]]
417
418 \\
419
420 ==== Pump Probe Laser (FLASH1) ====
421
422 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser attenuation{{/code}}
423
424 //always saved (PBD)//
425 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
426 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
427 desc: attenuation of the PPLaser (rotation of a waveplate)
428 units : 0 no transmission , 1: full transmission
429
430 \\
431
432 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}
433 //always saved (PBD)//
434 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
435 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
436 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
437 units : ps ( pos delay means IR comes later)
438
439 \\
440
441 {{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}
442 //always saved (PBD)//
443 DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}
444 DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}
445 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
446 units : ps ( pos delay means IR comes later)
447
448 \\
449
450 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}
451 //always saved (PBD)//
452 DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
453 DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
454 desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
455
456 \\
457
458 {{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}
459 //always saved (PBD)//
460 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
461 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
462 desc: delaytime between the optical laser and the FEL units: ps
463
464 \\
465
466 [[Contents>>doc:||anchor="Contents"]]
467
468 \\
469
470 ==== User Data (FLASH1) ====
471
472 ===== GHz ADCs =====
473
474 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]]
475 //saved on DEMAND in the user DAQ//
476 \\The HDF5 names for the ADC traces are depending on the beamline :
477 \\PG Beamline:
478 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}
479 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}
480 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}
481 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}
482
483 BL Beamlines:
484 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}
485 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}
486 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}
487 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}
488 \\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}
489 {{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}
490 \\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}
491 {{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}
492
493 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
494 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.
495 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
496
497 in addition there are also additional parameters saved like:
498
499 * sample frequency (in MHz)
500 * error (state)
501 * offset
502
503 ~|
504
505 ===== MHz ADCs =====
506
507 similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
508 {{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}
509 DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
510 DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
511
512 \\
513
514 [[Contents>>doc:||anchor="Contents"]]
515
516 === FLASH2 ===
517
518 \\
519
520 ==== Beamline info (FLASH1) ====
521
522 {{code language="none"}}/FL2/Beamlines/Attenuator/pressure{{/code}}
523 //always saved (PBD)//
524 DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
525 DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
526 desc: set pressure in the gas attenuator
527 units: mbar
528 \\
529
530 {{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
531 //always saved (PBD)//
532 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
533 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
534 desc: BL Beamline Fast shutter state
535 units: none
536 \\
537
538 {{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
539 //always saved (PBD)//
540 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
541 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
542 desc: PG Beamline Fast shutter state
543 units: none
544 \\
545
546 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
547 //always saved (PBD)//
548 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
549 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
550 desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
551 units: degree
552 \\
553
554 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
555 //always saved (PBD)//
556 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
557 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
558 desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
559 units: degree
560 \\
561
562 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
563 //always saved (PBD)//
564 DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
565 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
566 desc: Position of the PG filter wheel 1
567 units: degree
568 \\
569
570 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
571 //always saved (PBD)//
572 DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
573 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
574 desc: Position of the PG filter wheel 2
575 units: degree
576 \\
577
578 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
579 //always saved (PBD)//
580 DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
581 DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
582 desc: Position of the PG filter wheel 3
583 units: degree
584 \\
585
586 [[Contents>>doc:||anchor="Contents"]]
587
588 \\
589
590 \\
591
592 (% class="wrapped" %)
593 |=(((
594 DAQ name
595 )))|=(((
596 HDF5 name
597 )))
598 |(((
599 FLASH.UTIL/FL2.UND.MOTOR/FL2SASE3/GAP
600 )))|(((
601 /FL2/Electron Diagnostic/Undulator setting/SASE03 gap
602 )))
603 |(((
604 FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP
605 )))|(((
606 /FL2/Electron Diagnostic/Undulator setting/SASE14 gap
607 )))
608 |(((
609 TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH
610 )))|(((
611 /FL2/Electron Diagnostic/Undulator setting/set wavelength
612 )))
613 |(((
614 FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX.UJ
615 )))|(((
616 /FL2/Photon Diagnostic/GMD/Average energy/hall
617 )))
618 |(((
619 FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX
620 )))|(((
621 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
622 )))
623 |(((
624 FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ
625 )))|(((
626 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
627 )))
628 |(((
629 FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX
630 )))|(((
631 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
632 )))
633 |(((
634 FLASH.FEL/XGM.POSMON/FL2.HALL/IX.POS
635 )))|(((
636 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
637 )))
638 |(((
639 FLASH.FEL/XGM.POSMON/FL2.HALL/IY.POS
640 )))|(((
641 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
642 )))
643 |(((
644 FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS
645 )))|(((
646 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
647 )))
648 |(((
649 FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS
650 )))|(((
651 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
652 )))
653 |(((
654 FLASH.FEL/XGM.BPM/FL2.HALL:0
655 )))|(((
656 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
657 )))
658 |(((
659 FLASH.FEL/XGM.BPM/FL2.HALL:1
660 )))|(((
661 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
662 )))
663 |(((
664 FLASH.FEL/XGM.BPM/FL2.TUNNEL:0
665 )))|(((
666 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
667 )))
668 |(((
669 FLASH.FEL/XGM.BPM/FL2.TUNNEL:1
670 )))|(((
671 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
672 )))
673 |(((
674 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:1
675 )))|(((
676 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy aux tunnel
677 )))
678 |(((
679 FLASH.FEL/XGM.INTENSITY/FL2.HALL
680 )))|(((
681 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
682 )))
683 |(((
684 FLASH.FEL/XGM.INTENSITY/FL2.HALL:0
685 )))|(((
686 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
687 )))
688 |(((
689 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL
690 )))|(((
691 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
692 )))
693 |(((
694 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:0
695 )))|(((
696 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
697 )))
698 |(((
699 FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042
700 )))|(((
701 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean phtoton energy
702 )))
703 |(((
704 FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040
705 )))|(((
706 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelengt
707 )))
708 |(((
709 FLASH.FEL/ADC.ADQ/OPIS1.CH02
710 )))|(((
711 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Raw data/CH02
712 )))
713 |(((
714 FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2
715 )))|(((
716 /FL2/Electron Diagnostic/Bunch charge/after undulator
717 )))
718 |(((
719 FLASH.DIAG/PBD2.TOROID.ML/3GUN/CHARGE.FLASH2
720 )))|(((
721 /FL2/Electron Diagnostic/Bunch charge/at gun
722 )))
723 |(((
724 FLASH.FEL/FL20T.PH.MOTOR/MOTOR1.MOT1/FPOS
725 )))|(((
726 /FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal
727 )))
728 |(((
729 FLASH.FEL/FL20T.PH.MOTOR/MOTOR2.MOT1/FPOS
730 )))|(((
731 /FL2/Beamlines/Tunnel Apertures/position aperture1 vertical
732 )))
733 |(((
734 FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER
735 )))|(((
736 /FL2/Beamlines/FL20/Shutter/channel 0
737 )))
738 |(((
739 FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00
740 )))|(((
741 /FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD
742 )))
743 |(((
744 FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH00
745 )))|(((
746 /FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH0/TD
747 )))
748 |(((
749 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
750 )))|(((
751 /FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS
752 )))
753 |(((
754 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/LOCK_STATUS.VALUE.RD
755 )))|(((
756 /FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO
757 )))
758 |(((
759 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD
760 )))|(((
761 /FL2/Experiment/Pump probe laser/laser delay readback
762 )))
763 |(((
764 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION_SET.WR
765 )))|(((
766 /FL2/Experiment/Pump probe laser/laser delay set value
767 )))
768 |(((
769 FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
770 )))|(((
771 /FL2/Experiment/Pump probe laser/FL24/attenuator position
772 )))
773 |(((
774 FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS
775 )))|(((
776 /FL2/Experiment/Pump probe laser/FL24/polarization position
777 )))
778
779 \\
780
781 [[Contents>>doc:||anchor="Contents"]]
782
783 === HDF5 structure revisions ===
784
785 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:
786
787 \\
788
789 * All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.
790 * 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".
791 * A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.
792
793 \\
794
795 (% class="wrapped" %)
796 |=(((
797 earlier HDF path (vers. 0.2)
798 )))|=(((
799 is now (vers. 0.3)
800 )))
801 |(((
802 /Photon Diagnostic/GMD/Beam position/position BDA x
803 )))|(((
804 /FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal
805 )))
806 |(((
807 /Photon Diagnostic/GMD/Beam position/position BDA y
808 )))|(((
809 /FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical
810 )))
811 |(((
812 /Photon Diagnostic/GMD/Beam position/position tunnel x
813 )))|(((
814 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal
815 )))
816 |(((
817 /Photon Diagnostic/GMD/Beam position/position tunnel y
818 )))|(((
819 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical
820 )))
821 |(((
822 /Experiment/Pump probe laser/BPM/position x
823 )))|(((
824 /FL1/Experiment/Pump probe laser/BPM/position horizontal
825 )))
826 |(((
827 /Experiment/Pump probe laser/BPM/position y
828 )))|(((
829 /FL1/Experiment/Pump probe laser/BPM/position vertical
830 )))
831 |(((
832 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal
833 )))|(((
834 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
835 )))
836 |(((
837 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical
838 )))|(((
839 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
840 )))
841 |(((
842 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal
843 )))|(((
844 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
845 )))
846 |(((
847 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical
848 )))|(((
849 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
850 )))
851 |(((
852 /FL2/Photon Diagnostic/GMD/Average energy/hall
853 )))|(((
854 /FL2/Photon Diagnostic/GMD/Average energy/energy hall
855 )))
856 |(((
857 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
858 )))|(((
859 /FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)
860 )))
861 |(((
862 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
863 )))|(((
864 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel
865 )))
866 |(((
867 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
868 )))|(((
869 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)
870 )))
871 |(((
872 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x
873 )))|(((
874 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
875 )))
876 |(((
877 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y
878 )))|(((
879 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
880 )))
881 |(((
882 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x
883 )))|(((
884 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
885 )))
886 |(((
887 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y
888 )))|(((
889 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
890 )))
891
892 \\
893
894 [[Contents>>doc:||anchor="Contents"]]
895
896 \\
897
898 == Example code showing how to access HDF5 files ==
899
900 \\
901
902 === Samples how to read HDF5 with Matlab ===
903
904 The examples apply to HDF files with HDF tree version before vers. 0.3.0.
905
906 (% style="color: rgb(0,128,0);" %)%% read in the needed data p=path; path(p,'D:\mess-daten\DAQ-data\hdf5\Gotthard') % add the actual folder to the path hdf5file='FLASH1_EXP-2016-03-16T1420.h5'; % data with Gotthard and VLS
907
908 (% style="color: rgb(0,128,0);" %)% h5disp(hdf5file,'/','min') % to get an idea what is in the file % h5info(hdf5file,'/Experiment/Gotthard1/BL.0') % get info about the individual channel
909
910 (% style="color: rgb(0,128,0);" %)% read a Number per 10 Hz pulse train:
911
912 (% class="code" %)
913 (((
914 FEL_Wavelength_energy_server=h5read(hdf5file,'/Photon Diagnostic/Wavelength/Calculated by energy/wavelength' );
915 )))
916
917 (% style="color: rgb(0,128,0);" %)% read in a 1D array (spectrum) %GMD data GMD_Spectrum=h5read(hdf5file,'/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA');
918
919 (% style="color: rgb(0,128,0);" %)% This reads in all the data . One can also limit the amount of data read to a subset of the data stored in the file. e.g. for image Data (Gotthard)
920
921 \\
922
923 (% class="code" %)
924 (((
925 Start_event= 500 ; % define the first 10 Hz event
926 Number_of_events = 20; % how many 10 Hz events to load
927 )))
928
929 (% style="color: rgb(0,128,0);" %)% read only part of the data:
930
931 (% class="code" %)
932 (((
933 Gotthard_data=h5read(hdf5file,'/Experiment/Gotthard1/BL.0',[2 650 Start_event],[50 85 Number_of_events]);
934 )))
935
936 (% style="color: rgb(0,128,0);" %)% start stop increment "manual" for 2 D data : [start bunch number in Gotthard data start pixelin spectrum start sample in 10 Hz trains], % [number of bunches in the Gotthard data number of points in the spectrum number of spectra ]
937
938 (% class="code" %)
939 (((
940 VLS_Spectrum=h5read(hdf5file,'/Photon Diagnostic/Wavelength/VLS online spectrometer/PCO.ROI.X',[400 Start_event],[200 Number_of_events] );
941
942 )))
943
944 (% style="color: rgb(0,128,0);" %)% start stop increment "manual" for 1D data : [start sample in the spectrum start sample in 10 Hz trains],[number of points in the spectrum number of spectra ]
945
946 (% style="color: rgb(0,128,0);" %)%GMD data
947
948 (% class="code" %)
949 (((
950 GMD_Spectrum=h5read(hdf5file,'/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA',[1 Start_event],[40 Number_of_events] );
951 )))
952
953 [[Contents>>doc:||anchor="Contents"]]
954
955 === How to read HDF5 with Python via FLASHH5 ===
956
957 With [[FlashH5>>doc:FLASHUSER.FLASHH5 for easier access of FLASH's HDF5 files]] we provide h5py based examples to access and evaluate FLASH's HDF5 files.
958
959 \\
960
961 == HDF5 and DOOCS ==
962
963 Here is an outdated [[list with the available properties that are always saved (PBD) for FLASH1 as>>attach:FLASH1__DaqChannel2HdfNamePbd.xlsx]] HDF5 names and the corresponding DOOCS names
964
965 [[Contents>>doc:||anchor="Contents"]]