Wiki source code of The FLASH HDF5 structure
Version 3.1 by sndueste on 2019/08/06 15:06
Show last authors
author | version | line-number | content |
---|---|---|---|
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>>doc:FLASHUSER.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 filterwheel 2 - to correlate with the filter material please look [[here>>doc:FLASHUSER.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 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>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]] | ||
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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]] | ||
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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]] | ||
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:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]] | ||
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:FLASHUSER.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:FLASHUSER.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:FLASHUSER.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:FLASHUSER.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 | \\ | ||
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(%%) | ||
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(%%) | ||
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(%%) 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>>doc:FLASHUSER.Data Acquisition and controls.Controls (DOOCS, jDDD,\.\.\.).MTCA ADCs.WebHome]] | ||
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 | (% class="wrapped" %) | ||
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 | |||
740 | (% class="wrapped" %) | ||
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>>doc:FLASHUSER.FLASHH5 for easier access of FLASH's HDF5 files]] 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>>attach:FLASH1__DaqChannel2HdfNamePbd.xlsx]] HDF5 names and the corresponding DOOCS names |