Version 1.1 by sendels on 2019/05/15 12:57

Hide last authors
sendels 1.1 1 == Contents ==
2
3 \\
4
5 * General information about HDF5
6 * FLASH HDF5 structure
7 * Most popular FLASH parameters and their names in HDF5
8 ** FLASH1
9 *** Beamline info (FLASH1)
10 *** Photon Diagnostics: SASE / Spectrometer (FLASH1)
11 *** Electron Beam properties (FLASH1)
12 *** Timing information, rep rate etc.(FLASH1)
13 *** Pump Probe Laser (FLASH1)
14 *** User Data (FLASH1)
15 ** FLASH2
16 ** HDF5 structure revisions
17 * Example code showing how to access HDF5 files
18 ** Samples how to read HDF5 with Matlab
19 ** How to read HDF5 with Python via FLASHH5
20 * 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 \\
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"]]
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"]]
51
52 \\
53
54 \\
55
56 == Most popular FLASH parameters and their names in HDF5 ==
57
58 The compleate 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 dataset 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 filterwheel 1 - to correlate with the filter material please look [[here>>url:http://hasfweb.desy.de/bin/view/Setup/FilterHistory||shape="rect" class="twikiLink"]]
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 filterwheel 2 - to correlate with the filter material please look [[here>>url:http://hasfweb.desy.de/bin/view/Setup/FilterHistory||shape="rect" class="twikiLink"]]
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 filterwheel 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 filterwheel 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 filterwheel 3
132 units: degree
133 \\
134
135 \\
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>>url:http://hasfweb.desy.de/bin/view/Setup/CalibrateGMDSignals||shape="rect" class="twikiLink"]]
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>>url:http://hasfweb.desy.de/bin/view/Setup/CalibrateGMDSignals||shape="rect" class="twikiLink"]]
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>>url:http://hasfweb.desy.de/bin/view/Setup/CalibrateGMDSignals||shape="rect" class="twikiLink"]]
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>>url:http://hasfweb.desy.de/bin/view/Setup/CalibrateGMDSignals||shape="rect" class="twikiLink"]]
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>>url:http://hasfweb.desy.de/bin/view/Setup/GMD||shape="rect" class="twikiLink"]] (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>>url:http://hasfweb.desy.de/bin/view/Setup/GMD||shape="rect" class="twikiLink"]] (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>>url:http://hasfweb.desy.de/bin/view/Setup/GMD||shape="rect" class="twikiLink"]] (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>>url:http://hasfweb.desy.de/bin/view/Setup/GMD||shape="rect" class="twikiLink"]] (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 \\
273
274 ==== Electron Beam properties (FLASH1) ====
275
276 \\
277
278 ===== bunch charge =====
279
280 {{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
281 //always saved (PBD)//
282 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
283 DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
284 desc: electron bunch charge (FLASH1)
285 units: nC
286 \\
287
288 \\
289
290 ===== arrival time =====
291
292 {{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
293 //always saved (PBD)//
294 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
295 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
296 desc: Electron bunch arrival time measured with the BAM (more or less) before the undulator (pulse resolved data)
297 units: ps (bigger numbers indicate later arrivaltime of the electrons)
298 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://mskwiki/index.php?title=BAM-DAQ_Channels||shape="rect"]]
299
300 \\
301
302 ===== electron beam profile =====
303
304 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
305 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
306 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
307 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
308 desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
309 units: pixel
310 \\
311
312 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
313 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
314 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
315 DAQ channel: = PBD.BEAM.PROF.ML/CCT=
316 desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
317 units: fs per pixel
318 \\
319
320 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
321 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
322 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
323 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
324 desc: rms pulse width of the measures TDS electron bunch profile
325 units: fs
326 \\
327
328 \\
329
330 ===== electron bunch energy =====
331
332 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
333 _always saved (PBD)
334 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
335 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
336 desc: electron bunch energy (average over the bunch train)
337 units: (% class="twikiNewLink" %)[[MeV>>url:http://hasfweb.desy.de/bin/edit/Setup/MeV?topicparent=Setup.HDF5main;nowysiwyg=0||rel="nofollow" shape="rect"]](%%)
338 \\
339
340 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
341 _always saved (PBD)
342 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
343 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
344 desc: electron bunch energy bunch resolved
345 units: (% class="twikiNewLink" %)[[MeV>>url:http://hasfweb.desy.de/bin/edit/Setup/MeV?topicparent=Setup.HDF5main;nowysiwyg=0||rel="nofollow" shape="rect"]](%%)
346 \\
347
348 \\
349
350 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
351 _always saved (PBD)
352 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
353 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
354 desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
355 units: nm
356 \\
357
358 \\
359
360 \\
361
362 ==== Timing information, rep rate etc.(FLASH1) ====
363
364 \\
365
366 ===== bunch repetition rate =====
367
368 {{code language="none"}}/FL1/Timing/repetition rate{{/code}}
369 //always saved (PBD)//
370 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
371 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
372 desc: repetition rate of the bunches / pulses within the burst (FLASH1)
373 units: kHz
374 \\
375
376 \\
377
378 ===== set number of pulses =====
379
380 {{code language="none"}}/FL1/Timing/set number of bunches{{/code}}
381 //always saved (PBD)//
382 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH1{{/code}}
383 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_NUM{{/code}}
384 desc: Number of pulses set at the gun (FLASH1)
385 units:
386 \\
387
388 \\
389
390 ===== actual number of pulses =====
391
392 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
393 //always saved (PBD)//
394 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
395 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
396 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)
397 units:
398 \\
399
400 \\
401
402 ===== actual pulse pattern recorded after the undulator =====
403
404 {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
405 //always saved (PBD)//
406 DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
407 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
408 desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH1)
409 units:
410 \\
411
412 \\
413
414 ===== Train ID =====
415
416 {{code language="none"}}/Timing/train ID{{/code}}
417 //always saved (PBD)//
418 DOOCS prop : {{code language="none"}}none{{/code}}
419 DAQ channel: {{code language="none"}}none{{/code}}
420 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 !)
421 units:
422 \\
423
424 \\
425
426 ===== Train time =====
427
428 {{code language="none"}}/Timing/train time{{/code}}
429 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
430 units: d h min s cs
431 \\
432
433 {{code language="none"}}/Timing/time stamp{{/code}}
434 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
435 second column: microseconds
436 third column: Train ID of FLASH
437 \\
438
439 \\
440
441 \\
442
443 ==== Pump Probe Laser (FLASH1) ====
444
445 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser attenuation{{/code}} //always saved (PBD)//
446 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
447 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
448 desc: attenuation of the PPLaser (rotation of a waveplate)
449 units : 0 no transmission , 1: full transmission
450
451 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}
452 //always saved (PBD)//
453 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
454 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
455 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
456 units : ps ( pos delay means IR comes later)
457
458 {{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}
459 //always saved (PBD)//
460 DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}
461 DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}
462 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
463 units : ps ( pos delay means IR comes later)
464
465 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}
466 //always saved (PBD)//
467 DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
468 DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
469 desc: rms jitter of the GECCO (% class="twikiNewLink" %)[[TiSa>>url:http://hasfweb.desy.de/bin/edit/Setup/TiSa?topicparent=Setup.HDF5main;nowysiwyg=0||rel="nofollow" shape="rect"]](%%) Oscillator units: fs
470
471 \\
472
473 {{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}
474 //always saved (PBD)//
475 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
476 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
477 desc: delaytime between the optical laser and the FEL units: ps
478
479 \\
480
481 \\
482
483 \\
484
485 ==== User Data (FLASH1) ====
486
487 \\
488
489 ===== GHz ADCs =====
490
491 ADC traces of the (SPDevices 412) GHZ ADCs available for the users . More information about the ADCs can be found [[here>>url:http://hasfweb.desy.de/bin/view/Setup/MtcaAdc||shape="rect" class="twikiLink"]]
492 //saved on DEMAND in the user DAQ//
493 \\The HDF5 names for the ADC traces are depending on the beamline :
494 \\PG Beamline:
495 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}
496 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}
497 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}
498 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}
499
500 BL Beamlines:
501 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}
502 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}
503 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}
504 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}
505 \\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}
506 {{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}
507 \\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}
508 {{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}
509
510 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
511 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.
512 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
513
514 in addition there are also additional parameters saved like:
515
516 * sample frequency (in MHz)
517 * error (state)
518 * offset
519
520 ~|
521
522 ===== MHz ADCs =====
523
524 similar to the GHz ADCs the MHz ASDsa re saved with HDF5 names like:
525 {{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}
526 DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
527 DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
528
529 \\
530
531 \\
532
533 === FLASH2 ===
534
535 \\
536
537 |=(((
538 [[DAQ name>>url:http://hasfweb.desy.de/bin/view/Setup/HDF5main?sortcol=0;table=1;up=0#sorted_table||title="Sort by this column" rel="nofollow" shape="rect"]]
539 )))|=(((
540 [[HDF5 name>>url:http://hasfweb.desy.de/bin/view/Setup/HDF5main?sortcol=1;table=1;up=0#sorted_table||title="Sort by this column" rel="nofollow" shape="rect"]]
541 )))
542 |(((
543 FLASH.UTIL/FL2.UND.MOTOR/FL2SASE3/GAP
544 )))|(((
545 /FL2/Electron Diagnostic/Undulator setting/SASE03 gap
546 )))
547 |(((
548 FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP
549 )))|(((
550 /FL2/Electron Diagnostic/Undulator setting/SASE14 gap
551 )))
552 |(((
553 TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH
554 )))|(((
555 /FL2/Electron Diagnostic/Undulator setting/set wavelength
556 )))
557 |(((
558 FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX.UJ
559 )))|(((
560 /FL2/Photon Diagnostic/GMD/Average energy/hall
561 )))
562 |(((
563 FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX
564 )))|(((
565 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
566 )))
567 |(((
568 FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ
569 )))|(((
570 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
571 )))
572 |(((
573 FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX
574 )))|(((
575 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
576 )))
577 |(((
578 FLASH.FEL/XGM.POSMON/FL2.HALL/IX.POS
579 )))|(((
580 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
581 )))
582 |(((
583 FLASH.FEL/XGM.POSMON/FL2.HALL/IY.POS
584 )))|(((
585 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
586 )))
587 |(((
588 FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS
589 )))|(((
590 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
591 )))
592 |(((
593 FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS
594 )))|(((
595 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
596 )))
597 |(((
598 FLASH.FEL/XGM.BPM/FL2.HALL:0
599 )))|(((
600 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
601 )))
602 |(((
603 FLASH.FEL/XGM.BPM/FL2.HALL:1
604 )))|(((
605 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
606 )))
607 |(((
608 FLASH.FEL/XGM.BPM/FL2.TUNNEL:0
609 )))|(((
610 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
611 )))
612 |(((
613 FLASH.FEL/XGM.BPM/FL2.TUNNEL:1
614 )))|(((
615 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
616 )))
617 |(((
618 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:1
619 )))|(((
620 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy aux tunnel
621 )))
622 |(((
623 FLASH.FEL/XGM.INTENSITY/FL2.HALL
624 )))|(((
625 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
626 )))
627 |(((
628 FLASH.FEL/XGM.INTENSITY/FL2.HALL:0
629 )))|(((
630 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
631 )))
632 |(((
633 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL
634 )))|(((
635 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
636 )))
637 |(((
638 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:0
639 )))|(((
640 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
641 )))
642 |(((
643 FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042
644 )))|(((
645 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean phtoton energy
646 )))
647 |(((
648 FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040
649 )))|(((
650 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelengt
651 )))
652 |(((
653 FLASH.FEL/ADC.ADQ/OPIS1.CH02
654 )))|(((
655 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Raw data/CH02
656 )))
657 |(((
658 FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2
659 )))|(((
660 /FL2/Electron Diagnostic/Bunch charge/after undulator
661 )))
662 |(((
663 FLASH.DIAG/PBD2.TOROID.ML/3GUN/CHARGE.FLASH2
664 )))|(((
665 /FL2/Electron Diagnostic/Bunch charge/at gun
666 )))
667 |(((
668 FLASH.FEL/FL20T.PH.MOTOR/MOTOR1.MOT1/FPOS
669 )))|(((
670 /FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal
671 )))
672 |(((
673 FLASH.FEL/FL20T.PH.MOTOR/MOTOR2.MOT1/FPOS
674 )))|(((
675 /FL2/Beamlines/Tunnel Apertures/position aperture1 vertical
676 )))
677 |(((
678 FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER
679 )))|(((
680 /FL2/Beamlines/FL20/Shutter/channel 0
681 )))
682 |(((
683 FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00
684 )))|(((
685 /FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD
686 )))
687 |(((
688 FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH00
689 )))|(((
690 /FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH0/TD
691 )))
692 |(((
693 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
694 )))|(((
695 /FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS
696 )))
697 |(((
698 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/LOCK_STATUS.VALUE.RD
699 )))|(((
700 /FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO
701 )))
702 |(((
703 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD
704 )))|(((
705 /FL2/Experiment/Pump probe laser/laser delay readback
706 )))
707 |(((
708 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION_SET.WR
709 )))|(((
710 /FL2/Experiment/Pump probe laser/laser delay set value
711 )))
712 |(((
713 FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
714 )))|(((
715 /FL2/Experiment/Pump probe laser/FL24/attenuator position
716 )))
717 |(((
718 FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS
719 )))|(((
720 /FL2/Experiment/Pump probe laser/FL24/polarization position
721 )))
722
723 \\
724
725 \\
726
727 === HDF5 structure revisions ===
728
729 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:
730
731 \\
732
733 * All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.
734 * 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".
735 * A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.
736
737 \\
738
739 |=(((
740 [[earlier HDF path (vers. 0.2)>>url:http://hasfweb.desy.de/bin/view/Setup/HDF5main?sortcol=0;table=2;up=0#sorted_table||title="Sort by this column" rel="nofollow" shape="rect"]]
741 )))|=(((
742 [[is now (vers. 0.3)>>url:http://hasfweb.desy.de/bin/view/Setup/HDF5main?sortcol=1;table=2;up=0#sorted_table||title="Sort by this column" rel="nofollow" shape="rect"]]
743 )))
744 |(((
745 /Photon Diagnostic/GMD/Beam position/position BDA x
746 )))|(((
747 /FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal
748 )))
749 |(((
750 /Photon Diagnostic/GMD/Beam position/position BDA y
751 )))|(((
752 /FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical
753 )))
754 |(((
755 /Photon Diagnostic/GMD/Beam position/position tunnel x
756 )))|(((
757 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal
758 )))
759 |(((
760 /Photon Diagnostic/GMD/Beam position/position tunnel y
761 )))|(((
762 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical
763 )))
764 |(((
765 /Experiment/Pump probe laser/BPM/position x
766 )))|(((
767 /FL1/Experiment/Pump probe laser/BPM/position horizontal
768 )))
769 |(((
770 /Experiment/Pump probe laser/BPM/position y
771 )))|(((
772 /FL1/Experiment/Pump probe laser/BPM/position vertical
773 )))
774 |(((
775 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal
776 )))|(((
777 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
778 )))
779 |(((
780 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical
781 )))|(((
782 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
783 )))
784 |(((
785 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal
786 )))|(((
787 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
788 )))
789 |(((
790 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical
791 )))|(((
792 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
793 )))
794 |(((
795 /FL2/Photon Diagnostic/GMD/Average energy/hall
796 )))|(((
797 /FL2/Photon Diagnostic/GMD/Average energy/energy hall
798 )))
799 |(((
800 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
801 )))|(((
802 /FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)
803 )))
804 |(((
805 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
806 )))|(((
807 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel
808 )))
809 |(((
810 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
811 )))|(((
812 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)
813 )))
814 |(((
815 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x
816 )))|(((
817 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
818 )))
819 |(((
820 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y
821 )))|(((
822 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
823 )))
824 |(((
825 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x
826 )))|(((
827 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
828 )))
829 |(((
830 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y
831 )))|(((
832 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
833 )))
834
835 \\
836
837 \\
838
839 \\
840
841 == Example code showing how to access HDF5 files ==
842
843 \\
844
845 === Samples how to read HDF5 with Matlab ===
846
847 The examples apply to HDF files with HDF tree version before vers. 0.3.0.
848
849 (% 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
850
851 (% 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
852
853 (% style="color: rgb(0,128,0);" %)% read a Number per 10 Hz pulse train:
854
855 (% class="code" %)
856 (((
857 FEL_Wavelength_energy_server=h5read(hdf5file,'/Photon Diagnostic/Wavelength/Calculated by energy/wavelength' );
858 )))
859
860 (% 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');
861
862 (% 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)
863
864 \\
865
866 (% class="code" %)
867 (((
868 Start_event= 500 ; % define the first 10 Hz event
869 Number_of_events = 20; % how many 10 Hz events to load
870 )))
871
872 (% style="color: rgb(0,128,0);" %)% read only part of the data:
873
874 (% class="code" %)
875 (((
876 Gotthard_data=h5read(hdf5file,'/Experiment/Gotthard1/BL.0',[2 650 Start_event],[50 85 Number_of_events]);
877 )))
878
879 (% 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 ]
880
881 (% class="code" %)
882 (((
883 VLS_Spectrum=h5read(hdf5file,'/Photon Diagnostic/Wavelength/VLS online spectrometer/PCO.ROI.X',[400 Start_event],[200 Number_of_events] );
884
885 )))
886
887 (% 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 ]
888
889 (% style="color: rgb(0,128,0);" %)%GMD data
890
891 (% class="code" %)
892 (((
893 GMD_Spectrum=h5read(hdf5file,'/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA',[1 Start_event],[40 Number_of_events] );
894 )))
895
896 \\
897
898 === How to read HDF5 with Python via FLASHH5 ===
899
900 With [[FlashH5>>url:http://hasfweb.desy.de/bin/view/Setup/FlashH5||shape="rect" class="twikiLink"]] we provide h5py based examples to access and evaluate FLASH's HDF5 files.
901
902 \\
903
904 == HDF5 and DOOCS ==
905
906 Here is an outdated [[list with the available properties that are always saved (PBD) for FLASH1 as>>url:http://hasfweb.desy.de/pub/Setup/HDF5main/FLASH1__DaqChannel2HdfNamePbd.xlsx||shape="rect"]] HDF5 names and the corresponding DOOCS names