Version 2.1 by sendels on 2019/05/15 13:01
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}}
sendels 2.1 99 desc: Position of the BL filterwheel 1 - to correlate with the filter material please look [[here>>doc:FLASHUSER.Filter history (BL filterwheel 12)]]
sendels 1.1 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}}
sendels 2.1 107 desc: Position of the BL filterwheel 2 - to correlate with the filter material please look [[here>>doc:FLASHUSER.Filter history (BL filterwheel 12)]]
sendels 1.1 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
sendels 2.1 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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]
sendels 1.1 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
sendels 2.1 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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]
sendels 1.1 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
sendels 2.1 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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]
sendels 1.1 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
sendels 2.1 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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]
sendels 1.1 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}}
sendels 2.1 185 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASHUSER.Gas Monitor Detector]] (BDA, x=horizontal)
sendels 1.1 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}}
sendels 2.1 192 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASHUSER.Gas Monitor Detector]] (BDA, y=vertical)
sendels 1.1 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}}
sendels 2.1 199 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASHUSER.Gas Monitor Detector]] (TUNNEL, x=horizontal)
sendels 1.1 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}}
sendels 2.1 206 desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASHUSER.Gas Monitor Detector]] (TUNNEL, y=vertical)
sendels 1.1 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)
sendels 2.1 337 units: (% class="twikiNewLink" %)MeV(%%)
sendels 1.1 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
sendels 2.1 345 units: (% class="twikiNewLink" %)MeV(%%)
sendels 1.1 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}}
sendels 2.1 469 desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
sendels 1.1 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
sendels 2.1 491 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 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
sendels 2.1 537 (% class="wrapped" %)
sendels 1.1 538 |=(((
539 [[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"]]
540 )))|=(((
541 [[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"]]
542 )))
543 |(((
544 FLASH.UTIL/FL2.UND.MOTOR/FL2SASE3/GAP
545 )))|(((
546 /FL2/Electron Diagnostic/Undulator setting/SASE03 gap
547 )))
548 |(((
549 FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP
550 )))|(((
551 /FL2/Electron Diagnostic/Undulator setting/SASE14 gap
552 )))
553 |(((
554 TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH
555 )))|(((
556 /FL2/Electron Diagnostic/Undulator setting/set wavelength
557 )))
558 |(((
559 FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX.UJ
560 )))|(((
561 /FL2/Photon Diagnostic/GMD/Average energy/hall
562 )))
563 |(((
564 FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX
565 )))|(((
566 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
567 )))
568 |(((
569 FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ
570 )))|(((
571 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
572 )))
573 |(((
574 FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX
575 )))|(((
576 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
577 )))
578 |(((
579 FLASH.FEL/XGM.POSMON/FL2.HALL/IX.POS
580 )))|(((
581 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
582 )))
583 |(((
584 FLASH.FEL/XGM.POSMON/FL2.HALL/IY.POS
585 )))|(((
586 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
587 )))
588 |(((
589 FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS
590 )))|(((
591 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
592 )))
593 |(((
594 FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS
595 )))|(((
596 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
597 )))
598 |(((
599 FLASH.FEL/XGM.BPM/FL2.HALL:0
600 )))|(((
601 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
602 )))
603 |(((
604 FLASH.FEL/XGM.BPM/FL2.HALL:1
605 )))|(((
606 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
607 )))
608 |(((
609 FLASH.FEL/XGM.BPM/FL2.TUNNEL:0
610 )))|(((
611 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
612 )))
613 |(((
614 FLASH.FEL/XGM.BPM/FL2.TUNNEL:1
615 )))|(((
616 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
617 )))
618 |(((
619 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:1
620 )))|(((
621 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy aux tunnel
622 )))
623 |(((
624 FLASH.FEL/XGM.INTENSITY/FL2.HALL
625 )))|(((
626 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
627 )))
628 |(((
629 FLASH.FEL/XGM.INTENSITY/FL2.HALL:0
630 )))|(((
631 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
632 )))
633 |(((
634 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL
635 )))|(((
636 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
637 )))
638 |(((
639 FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:0
640 )))|(((
641 /FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
642 )))
643 |(((
644 FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042
645 )))|(((
646 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean phtoton energy
647 )))
648 |(((
649 FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040
650 )))|(((
651 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelengt
652 )))
653 |(((
654 FLASH.FEL/ADC.ADQ/OPIS1.CH02
655 )))|(((
656 /FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Raw data/CH02
657 )))
658 |(((
659 FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2
660 )))|(((
661 /FL2/Electron Diagnostic/Bunch charge/after undulator
662 )))
663 |(((
664 FLASH.DIAG/PBD2.TOROID.ML/3GUN/CHARGE.FLASH2
665 )))|(((
666 /FL2/Electron Diagnostic/Bunch charge/at gun
667 )))
668 |(((
669 FLASH.FEL/FL20T.PH.MOTOR/MOTOR1.MOT1/FPOS
670 )))|(((
671 /FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal
672 )))
673 |(((
674 FLASH.FEL/FL20T.PH.MOTOR/MOTOR2.MOT1/FPOS
675 )))|(((
676 /FL2/Beamlines/Tunnel Apertures/position aperture1 vertical
677 )))
678 |(((
679 FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER
680 )))|(((
681 /FL2/Beamlines/FL20/Shutter/channel 0
682 )))
683 |(((
684 FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00
685 )))|(((
686 /FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD
687 )))
688 |(((
689 FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH00
690 )))|(((
691 /FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH0/TD
692 )))
693 |(((
694 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
695 )))|(((
696 /FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS
697 )))
698 |(((
699 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/LOCK_STATUS.VALUE.RD
700 )))|(((
701 /FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO
702 )))
703 |(((
704 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD
705 )))|(((
706 /FL2/Experiment/Pump probe laser/laser delay readback
707 )))
708 |(((
709 FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION_SET.WR
710 )))|(((
711 /FL2/Experiment/Pump probe laser/laser delay set value
712 )))
713 |(((
714 FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
715 )))|(((
716 /FL2/Experiment/Pump probe laser/FL24/attenuator position
717 )))
718 |(((
719 FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS
720 )))|(((
721 /FL2/Experiment/Pump probe laser/FL24/polarization position
722 )))
723
724 \\
725
726 \\
727
728 === HDF5 structure revisions ===
729
730 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:
731
732 \\
733
734 * All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.
735 * 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".
736 * A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.
737
738 \\
739
sendels 2.1 740 (% class="wrapped" %)
sendels 1.1 741 |=(((
742 [[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"]]
743 )))|=(((
744 [[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"]]
745 )))
746 |(((
747 /Photon Diagnostic/GMD/Beam position/position BDA x
748 )))|(((
749 /FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal
750 )))
751 |(((
752 /Photon Diagnostic/GMD/Beam position/position BDA y
753 )))|(((
754 /FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical
755 )))
756 |(((
757 /Photon Diagnostic/GMD/Beam position/position tunnel x
758 )))|(((
759 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal
760 )))
761 |(((
762 /Photon Diagnostic/GMD/Beam position/position tunnel y
763 )))|(((
764 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical
765 )))
766 |(((
767 /Experiment/Pump probe laser/BPM/position x
768 )))|(((
769 /FL1/Experiment/Pump probe laser/BPM/position horizontal
770 )))
771 |(((
772 /Experiment/Pump probe laser/BPM/position y
773 )))|(((
774 /FL1/Experiment/Pump probe laser/BPM/position vertical
775 )))
776 |(((
777 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal
778 )))|(((
779 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
780 )))
781 |(((
782 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical
783 )))|(((
784 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
785 )))
786 |(((
787 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal
788 )))|(((
789 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
790 )))
791 |(((
792 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical
793 )))|(((
794 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
795 )))
796 |(((
797 /FL2/Photon Diagnostic/GMD/Average energy/hall
798 )))|(((
799 /FL2/Photon Diagnostic/GMD/Average energy/energy hall
800 )))
801 |(((
802 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
803 )))|(((
804 /FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)
805 )))
806 |(((
807 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
808 )))|(((
809 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel
810 )))
811 |(((
812 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
813 )))|(((
814 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)
815 )))
816 |(((
817 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x
818 )))|(((
819 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
820 )))
821 |(((
822 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y
823 )))|(((
824 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
825 )))
826 |(((
827 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x
828 )))|(((
829 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
830 )))
831 |(((
832 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y
833 )))|(((
834 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
835 )))
836
837 \\
838
839 \\
840
841 \\
842
843 == Example code showing how to access HDF5 files ==
844
845 \\
846
847 === Samples how to read HDF5 with Matlab ===
848
849 The examples apply to HDF files with HDF tree version before vers. 0.3.0.
850
851 (% 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
852
853 (% 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
854
855 (% style="color: rgb(0,128,0);" %)% read a Number per 10 Hz pulse train:
856
857 (% class="code" %)
858 (((
859 FEL_Wavelength_energy_server=h5read(hdf5file,'/Photon Diagnostic/Wavelength/Calculated by energy/wavelength' );
860 )))
861
862 (% 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');
863
864 (% 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)
865
866 \\
867
868 (% class="code" %)
869 (((
870 Start_event= 500 ; % define the first 10 Hz event
871 Number_of_events = 20; % how many 10 Hz events to load
872 )))
873
874 (% style="color: rgb(0,128,0);" %)% read only part of the data:
875
876 (% class="code" %)
877 (((
878 Gotthard_data=h5read(hdf5file,'/Experiment/Gotthard1/BL.0',[2 650 Start_event],[50 85 Number_of_events]);
879 )))
880
881 (% 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 ]
882
883 (% class="code" %)
884 (((
885 VLS_Spectrum=h5read(hdf5file,'/Photon Diagnostic/Wavelength/VLS online spectrometer/PCO.ROI.X',[400 Start_event],[200 Number_of_events] );
886
887 )))
888
889 (% 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 ]
890
891 (% style="color: rgb(0,128,0);" %)%GMD data
892
893 (% class="code" %)
894 (((
895 GMD_Spectrum=h5read(hdf5file,'/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA',[1 Start_event],[40 Number_of_events] );
896 )))
897
898 \\
899
900 === How to read HDF5 with Python via FLASHH5 ===
901
902 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.
903
904 \\
905
906 == HDF5 and DOOCS ==
907
908 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