Changes for page The FLASH HDF5 structure

Last modified by sndueste on 2025/02/06 10:55

From version 36.1
edited by sndueste
on 2020/11/16 10:21
Change comment: There is no comment for this version
To version 14.1
edited by sndueste
on 2019/09/17 17:52
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -8,9 +8,9 @@
8 8  
9 9  == General information about HDF5 ==
10 10  
11 -HDF5 is a data format maintained by the HDF group. For detailed general information see [[here~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://portal.hdfgroup.org/display/support||shape="rect"]]
11 +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"]]
12 12  
13 -To download the HDF5 Viewer click [[here~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://portal.hdfgroup.org/display/support/Download+HDFView||shape="rect"]]
13 +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"]]
14 14  
15 15  For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :
16 16  {{code language="none"}}> module load xray{{/code}}
... ... @@ -18,9 +18,9 @@
18 18  
19 19  [[Contents>>doc:||anchor="Contents"]]
20 20  
21 -== The current FLASH HDF5 structure ==
21 +== FLASH HDF5 structure ==
22 22  
23 -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 organized according to train IDs. The general structure is:
23 +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:
24 24  
25 25  * Electron Diagnostic
26 26  * Photon Diagnostics
... ... @@ -27,45 +27,17 @@
27 27  * Beamlines
28 28  * Experiment
29 29  * Timing
30 -[[image:attach:HDF5_structure.jpg||height="400"]]
30 +[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/HDF5main/HDF5_structure.jpg~|~|alt="HDF5_structure.jpg" width="700" height="500"~]~]>>attach:HDF5_structure.jpg]]
31 31  
32 -A detailed description of (most) channels can be found in the lower part of the hdf5 viewer:
33 -[[image:attach:HDF5_structure_desc.jpg||thumbnail="true" height="250"]]
32 +A detailled description of (most) channels can be found in the lower part of the hdf5 viewer:
33 +[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/HDF5main/HDF5_structure_desc.jpg~|~|alt="HDF5_structure_desc.jpg" width="341" height="413"~]~]>>attach:HDF5_structure_desc.jpg]]
34 34  
35 35  [[Contents>>doc:||anchor="Contents"]]
36 36  
37 37  \\
38 38  
39 -=== HDF5 example files ===
39 +== Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
40 40  
41 -Here we have a few HDF5 samples (User data combined with Photon diagnostics data) from a few beamtimes showing the different kind options.
42 -
43 -[[image:attach:image2019-10-21_17-2-50.png||thumbnail="true" width="300"]] [[download HDF5 (Images @ FL2)>>url:https://desycloud.desy.de/index.php/s/nyEgeCWJFC4gao2||shape="rect"]]
44 -
45 -\\
46 -
47 -[[~[~[image:attach:image2019-10-22_10-52-27.png~|~|thumbnail="true" width="300"~]~]download HDF5 (GHz ADC and OPIS @ FL2)>>url:https://desycloud.desy.de/index.php/s/AeA2kPNNnZgX95A||shape="rect"]]
48 -
49 -\\
50 -
51 -\\
52 -
53 -[[Contents>>doc:||anchor="Contents"]]
54 -
55 -\\
56 -
57 -== The new (starting 2021) HDF5 format ==
58 -
59 -Here is [[some documentation on the changes of the HDF5 format>>doc:FLASHUSER.The new (starting 2021) HDF5 format]] that well be available in 2021 (work in progress)
60 -
61 -\\
62 -
63 -\\
64 -
65 -== Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
66 -
67 -{{id name="DOOCSparameters"/}}
68 -
69 69  The complete list for the relation between DOOCS names and HDF5 names for the recordable parameters can be found in [[DESY's Repository~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://stash.desy.de/projects/CS/repos/pah/browse/src/camp/data/channel2HdfName.dat||shape="rect"]].
70 70  The most common and often used ones are summarized below:
71 71  
... ... @@ -107,7 +107,7 @@
107 107  //always saved (PBD)//
108 108  DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
109 109  DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
110 -desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
82 +desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
111 111  units: degree
112 112  \\
113 113  
... ... @@ -115,7 +115,7 @@
115 115  //always saved (PBD)//
116 116  DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
117 117  DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
118 -desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
90 +desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
119 119  units: degree
120 120  \\
121 121  
... ... @@ -145,7 +145,7 @@
145 145  \\
146 146  
147 147  
148 -NOTE: Aperture positions in the beamline as well as the positions of the beam steering mirrors are also saved. For more Info contact your local contact
120 +NOTE: Aperture positions in the beamline as well as the positions of the beam steering mirrors are also saved. for more Info contact your local contact
149 149  
150 150  [[Contents>>doc:||anchor="Contents"]]
151 151  
... ... @@ -155,24 +155,17 @@
155 155  
156 156  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
157 157  //always saved (PBD)//
158 -(% style="color: rgb(165,173,186);" %)New MTCA Version: DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}} (%%)
159 -(% style="color: rgb(165,173,186);" %)New MTCA Version: DAQ channel: {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}
160 -
161 -(% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}} (%%)
162 -(% style="color: rgb(0,0,0);" %)DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}(%%)
163 -desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator (ion current)
130 +DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}}
131 +DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}
132 +desc : calibrated average SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)
164 164  units : microJ
165 165  
166 166  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
167 -//always saved (PBD)//
168 -
169 -(% style="color: rgb(193,199,208);" %)New MTCA Version: DOOCS prop : 
170 -{{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}New MTCA Version: DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}
171 -
136 +//always saved (PBD)//
172 172  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
173 173  DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
174 174  desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
175 -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]]**
140 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
176 176  
177 177  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
178 178  //always saved (PBD)//
... ... @@ -179,14 +179,10 @@
179 179  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
180 180  DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
181 181  desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
182 -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]]**
147 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
183 183  
184 184  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
185 -//always saved (PBD)//
186 -
187 -(% style="color: rgb(165,173,186);" %)New MTCA Version: DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.BDA/PHOTONFLUX.UJ{{/code}} (%%)
188 -(% style="color: rgb(165,173,186);" %)New MTCA Version: DAQ channel: {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.BDA/PHOTONFLUX.UJ{{/code}}
189 -
150 +//always saved (PBD)//
190 190  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
191 191  DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
192 192  desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
... ... @@ -193,14 +193,11 @@
193 193  units : microJ
194 194  
195 195  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
196 -//always saved (PBD)//
197 -
198 -(% style="color: rgb(193,199,208);" %)New MTCA Version: DOOCS prop : 
199 -{{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.BDA/INTENSITY.TD{{/code}}New MTCA Version: DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.BDA/INTENSITY.TD{{/code}}(%%)
157 +//always saved (PBD)//
200 200  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
201 201  DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
202 202  desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
203 -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]]**
161 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
204 204  
205 205  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
206 206  //always saved (PBD)//
... ... @@ -207,15 +207,13 @@
207 207  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
208 208  DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
209 209  desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
210 -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]]**
168 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
211 211  
212 -\\
213 -
214 214  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
215 215  //always saved (PBD)//
216 216  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
217 217  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
218 -desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
174 +desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, x=horizontal)
219 219  units : mm
220 220  
221 221  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
... ... @@ -222,7 +222,7 @@
222 222  //always saved (PBD)//
223 223  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
224 224  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
225 -desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
181 +desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, y=vertical)
226 226  units : mm
227 227  
228 228  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
... ... @@ -229,7 +229,7 @@
229 229  //always saved (PBD)//
230 230  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
231 231  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
232 -desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
188 +desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, x=horizontal)
233 233  units : mm
234 234  
235 235  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
... ... @@ -236,7 +236,7 @@
236 236  //always saved (PBD)//
237 237  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
238 238  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
239 -desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
195 +desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, y=vertical)
240 240  units : mm
241 241  
242 242  {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
... ... @@ -322,25 +322,10 @@
322 322  //always saved (PBD)//
323 323  DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
324 324  DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
325 -desc: Electron bunch arrival time measured with the BAM inside the accelerator - however shows a very good correlation to the arrivaltime  of the XUV pulses in the experiment (pulse resolved data).
326 -units: ps (bigger numbers indicate later arrivaltime of the electrons)
281 +desc: Electron bunch arrival time measured with the BAM (more or less) before the undulator (pulse resolved data)
282 +units: ps (bigger numbers indicate later arrivaltime of the electrons)
283 +note: besides the arivaltime from FLASH1 there is also the FLASH2/3 electron arrival time saved. [[LINK to detailled infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]] and to a recent  [[talk about the working principle of the BAM>>url:https://confluence.desy.de/download/attachments/134216957/BAM-basics_and_outlook-2018_DESY-template_16-9Format.pdf?version=1&modificationDate=1565162143328&api=v2||shape="rect"]]
327 327  
328 -{{code language="none"}}/FL1/Electron Diagnostic/BAM/1SFELC/electron bunch arrival time (low charge){{/code}}
329 -//always saved (PBD)//
330 -DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/1SFELC/LOW_CHARGE_ARRIVAL_TIME{{/code}}
331 -DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/1SFELC.LOW_CHARGE_ARRIVAL_TIME{{/code}}
332 -desc: Electron bunch arrival time measured with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.
333 -units: ps (bigger numbers indicate later arrivaltime of the electrons)
334 -
335 -{{info title="BAM hints"}}
336 -* besides the arrivaltime from FLASH1 there is also the FLASH2/3 electron arrival time saved.In case of doubt ask your local contact
337 -* [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments >>doc:FLASHUSER.Additional helpful things.FLASH beamlines and instruments references.WebHome]]
338 -* [[LINK to detailed infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]]
339 -* a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
340 -{{/info}}
341 -
342 -\\
343 -
344 344  ===== electron beam profile =====
345 345  
346 346  {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
... ... @@ -444,7 +444,7 @@
444 444  //always saved (PBD)//
445 445  DOOCS prop : {{code language="none"}}none{{/code}}
446 446  DAQ channel: {{code language="none"}}none{{/code}}
447 -desc: Each 10 Hz burst has its unique train ID. For the HDF5 data set the ID is the same for all parameters with the same index (note camera images may be shifted by 1 ID - talk to the experts !)
388 +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 !)
448 448  units:
449 449  \\
450 450  
... ... @@ -451,7 +451,7 @@
451 451  ===== Train time =====
452 452  
453 453  {{code language="none"}}/Timing/train time{{/code}}
454 -desc:Local time as array of day, hour, minute, second, and centisecond. This data set is meant for visualization purposes only. For correlations use the train ID or the Unix time of the time stamp
395 +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
455 455  units: d h min s cs
456 456  \\
457 457  
... ... @@ -517,15 +517,9 @@
517 517  
518 518  ==== User Data (FLASH1) ====
519 519  
520 -The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.
521 -
522 -NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
523 -
524 -The most common and permanently installed device used by experiment are our ADCs:
525 -
526 526  ===== GHz ADCs =====
527 527  
528 -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]]**
463 +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]]
529 529  //saved on DEMAND in the user DAQ//
530 530  \\The HDF5 names for the ADC traces are depending on the beamline :
531 531  \\PG Beamline:
... ... @@ -548,12 +548,14 @@
548 548  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.
549 549  DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
550 550  
551 -In addition there are also additional parameters saved like:
486 +in addition there are also additional parameters saved like:
552 552  
553 -* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
554 -* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
555 -* {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
488 +* sample frequency (in MHz)
489 +* error (state)
490 +* offset
556 556  
492 +~|
493 +
557 557  ===== MHz ADCs =====
558 558  
559 559  similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
... ... @@ -561,19 +561,10 @@
561 561  DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
562 562  DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
563 563  
564 -In addition there are also additional parameters saved like:
501 +\\
565 565  
566 -* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
567 -* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
568 -
569 569  [[Contents>>doc:||anchor="Contents"]]
570 570  
571 -\\
572 -
573 -\\
574 -
575 -\\
576 -
577 577  === FLASH2 ===
578 578  
579 579  There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs
... ... @@ -581,11 +581,11 @@
581 581  ==== Beamline info (FLASH2) ====
582 582  
583 583  (% style="color: rgb(255,153,0);" %)(not yet available){{code language="none"}}/FL2/Beamlines/Attenuator/pressure  {{/code}}(%%)
584 -(% style="color: rgb(193,199,208);" %)//always saved (PBD2)// (%%)
585 -(% style="color: rgb(193,199,208);" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
586 -(% style="color: rgb(193,199,208);" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
587 -(% style="color: rgb(193,199,208);" %)desc: set pressure in the gas attenuator (%%)
588 -(% style="color: rgb(193,199,208);" %)units: mbar(%%)
512 +//always saved (PBD2)//
513 +DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}}
514 +DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}}
515 +desc: set pressure in the gas attenuator
516 +units: mbar
589 589  \\
590 590  
591 591  {{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
... ... @@ -600,13 +600,13 @@
600 600  //always saved (PBD2)//
601 601  DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}
602 602  DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
603 -desc: Position of the BL filter wheel 1 - to correlate with the filter material please look **[[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]**
531 +desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
604 604  units: degree
605 605  \\
606 606  
607 607  
608 608  //always saved (PBD2)//
609 -\\\\**[[here>>doc:FLASHUSER.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]**
537 +\\\\[[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
610 610  {{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 2 DOOCS prop : FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS desc: Position of the BL filter wheel 2 - to correlate with the filter material please look units: degree{{/code}}
611 611  
612 612  \\
... ... @@ -648,7 +648,7 @@
648 648  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
649 649  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
650 650  desc : Energy per pulse measured in the Tunnel  (in fromt of the gas attenuator and the apertures in the Hall)
651 -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]]**
579 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]
652 652  
653 653  \\
654 654  
... ... @@ -676,7 +676,7 @@
676 676  //always saved (PBD2)//
677 677  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
678 678  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
679 -desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
607 +desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (tunnel, x=horizontal)
680 680  units : mm
681 681  
682 682  \\
... ... @@ -685,7 +685,7 @@
685 685  //always saved (PBD2)//
686 686  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
687 687  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
688 -desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
616 +desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (tunnel, x=horizontal)
689 689  units : mm
690 690  
691 691  \\
... ... @@ -703,9 +703,9 @@
703 703  
704 704  \\
705 705  
706 -==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
634 +==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
707 707  
708 -for more info see:** [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]**
636 +for more info see: [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]
709 709  
710 710  (The OPIS hall is not installed yet ...)
711 711  
... ... @@ -742,7 +742,7 @@
742 742  
743 743  \\
744 744  
745 -In case OPIS was not operating there is still informaton about the **set wavelength** for the undulators (see below) which may differ by up to 5 % from the actual wavelength due to different settings in the FEL ...
673 +In case OPIS was not operating there is still informaton about the set wavelength for the undulators (see below) which may differ by up to 5 % from the actual wavelength due to different settings in the FEL ...
746 746  
747 747  \\
748 748  
... ... @@ -756,7 +756,7 @@
756 756  //always saved (PBD2)//
757 757  DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
758 758  DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
759 -desc: electron bunch charge FLASH2 (average value for each bunchtrain).
687 +desc: electron bunch charge (FLASH2)
760 760  units: nC
761 761  
762 762  \\
... ... @@ -774,71 +774,74 @@
774 774  //always saved (PBD2)//
775 775  DOOCS prop : {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
776 776  DAQ channel:  {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
777 -desc: gap value of the undulators. This can be used to follow up how many undulators were closed and if there was a taper
705 +desc: Sgap value of the Undulators. this can be used to follow up how many undulators were closed and if there was a taper
778 778  units: mm
779 779  
780 -The gap values are saved for all 12 undulators (Nr 3 to 14). Undulator 14 is the one closest to the experimental hall.
708 +The gap values are saved for all 12 undulators (Nr 3 to 14)
781 781  
782 782  =====
783 783  arrival time =====
784 784  
785 -{{code language="none"}}/FL2/Electron Diagnostic/BAM/8FL2XTDS/electron bunch arrival time (low charge){{/code}}
786 -//always saved (PBD2)//
787 -DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/8FL2XTDS/LOW_CHARGE_ARRIVAL_TIME{{/code}}
788 -DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/8FL2XTDS.LOW_CHARGE_ARRIVAL_TIME{{/code}}
789 -desc: Electron bunch arrival time measured with the BAM after the FLASH2 undulator (pulse resolved data)
790 -units: ps (bigger numbers indicate later arrivaltime of the electrons)
791 -
792 792  **FL1**{{code language="none"}}//Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
793 793  //always saved (PBD2)//
794 794  DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
795 795  DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
796 -desc: Electron bunch arrival time measured with the BAM  in the accelerator  (pulse resolved data)
717 +desc: Electron bunch arrival time measured with the BAM (more or less) before the undulator (pulse resolved data)
797 797  units: ps (bigger numbers indicate later arrivaltime of the electrons)
798 798  
720 +The BAM measures the arrivaltime of FLASH 1 and FLASH2 in the same data set (thus also sorted in at /FL1/ !). The first values are for FLASH1 bunches.
721 +
799 799  \\
800 800  
801 -{{info title="BAM hints"}}
802 -* The BAM 4DBC3 measures the arrivaltime of** FLASH 1 and FLASH2** in the same data set (thus also sorted in at /FL1/ !).
803 -* The BAM 8FL2XTDS measures only for FLASH2 BUT has the same data structure as the other BAMS ... thus there are also (random) values in in the  FLASH1 time slot 
804 -** Structure: The first values are for FLASH1 bunches. After a gap of about 70 micros ( 70 colums)  with  as entry for the switching between FLASH 1 and 2 the values for the electrons used in FLASH2 start.  The start time of FLASH2 is also recorded in the DAQ. FLASH1 start time is for historic reasons 700. thus if e.g. the start time of FLASH2 ( property name see below) is 1200 it means that FLASH starts at column 500 (1200-700) ... .In case of doubt ask your local contact
805 -* [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments >>doc:FLASHUSER.Additional helpful things.FLASH beamlines and instruments references.WebHome]]
806 -* [[LINK to detailed infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]]
807 -* a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
808 -{{/info}}
724 +first bunch of FLASH2 ... how to calculate ..
809 809  
726 +\\
810 810  
811 -[[Contents>>doc:||anchor="Contents"]]
728 +\\
812 812  
730 +Docu:  [[LINK to detailled infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]] and to a recent  [[talk about the working principle of the BAM>>url:https://confluence.desy.de/download/attachments/134216957/BAM-basics_and_outlook-2018_DESY-template_16-9Format.pdf?version=1&modificationDate=1565162143328&api=v2||shape="rect"]]
731 +
813 813  \\
814 814  
815 -==== Timing information, rep rate etc.  (FLASH2) ====
734 +\\
816 816  
817 -===== start time of FLASH2 =====
736 +\\
818 818  
819 -{{code language="none"}}/FL2/Timing/start time flash2{{/code}}
820 -//always saved (PBD2)//
821 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
822 -DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
823 -desc: The max 600 µs acceleration time of FLASH is devided between FLASH1 and FLASH2. This 600 µs window starts with FLASH1 (up to now)  at a time"label" of 700 µs (for historic reasons). Thus the first bunch of FLASH 1 comes at "700" and the last possibel bunch comes at 1300 (700+600). After FLASH1 train is over ther is a about 70µs switching time with no bunches. Then comes the first FLASH2 bunch.  Thus if e.g. the start time of FLASH2 is 1200 it means that FLASH2 starts at column 500 (1200-700)  in the HDF5 files. (However for yet unknown reasons this may change by 2-3 colums ...)
824 -units: µs
825 825  
739 +\\
740 +
741 +[[Contents>>doc:||anchor="Contents"]]
742 +
743 +\\
744 +
745 +==== Timing information, rep rate etc.  (FLASH1) ====
746 +
826 826  ===== bunch repetition rate =====
827 827  
828 -{{code language="none"}}/FL2/Timing/repetition rate{{/code}}
829 -//always saved (PBD2)//
830 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
831 -DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
832 -desc: repetition rate of the bunches / pulses within the burst (FLASH2)
749 +{{code language="none"}}/FL1/Timing/repetition rate{{/code}}
750 +//always saved (PBD)//
751 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
752 +DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
753 +desc: repetition rate of the bunches / pulses within the burst (FLASH1)
833 833  units: kHz
755 +\\
834 834  
757 +===== set number of pulses =====
758 +
759 +{{code language="none"}}/FL1/Timing/set number of bunches{{/code}}
760 +//always saved (PBD)//
761 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH1{{/code}}
762 +DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_NUM{{/code}}
763 +desc: Number of pulses set at the gun (FLASH1)
764 +units:
765 +
835 835  ===== actual number of pulses =====
836 836  
837 837  {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
838 -//always saved (PBD2)//
839 -DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
840 -DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
841 -desc: Number of bunches measured BEHIND the undulator. If pulses are used for diagnostic of the protection system of the accelerator limits the number of bunches to be accelerated this is the actual number that created XUV radiation.The number is calculated by the DAQ middle layer server, (FLASH2)
769 +//always saved (PBD)//
770 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
771 +DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
772 +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)
842 842  units:
843 843  \\
844 844  
... ... @@ -845,10 +845,10 @@
845 845  ===== actual pulse pattern recorded after the undulator =====
846 846  
847 847  {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
848 -//always saved (PBD2)//
849 -DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
850 -DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
851 -desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH2)
779 +//always saved (PBD)//
780 +DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
781 +DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
782 +desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH1)
852 852  units:
853 853  \\
854 854  
... ... @@ -855,7 +855,7 @@
855 855  ===== Train ID =====
856 856  
857 857  {{code language="none"}}/Timing/train ID{{/code}}
858 -//always saved (PBD2)//
789 +//always saved (PBD)//
859 859  DOOCS prop : {{code language="none"}}none{{/code}}
860 860  DAQ channel: {{code language="none"}}none{{/code}}
861 861  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 !)
... ... @@ -864,16 +864,13 @@
864 864  
865 865  ===== Train time =====
866 866  
867 -//always saved (PBD2)
868 -//{{code language="none"}}/Timing/train time{{/code}}
798 +{{code language="none"}}/Timing/train time{{/code}}
869 869  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
870 870  units: d h min s cs
871 871  \\
872 872  
873 -{{code language="none"}}/Timing/time stamp{{/code}}
874 -
875 -//always saved (PBD2)//
876 -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
803 +{{code language="none"}}/Timing/time stamp{{/code}}
804 +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
877 877  second column: microseconds
878 878  third column: Train ID of FLASH
879 879  \\
... ... @@ -882,102 +882,209 @@
882 882  
883 883  \\
884 884  
885 -==== User Data (FLASH2) ====
813 +\\
886 886  
887 -The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.
888 -
889 -NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
890 -
891 -The most common and permanently installed device used by experiment are our ADCs:
892 -
893 -===== GHz ADCs =====
894 -
895 -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]]**
896 -//saved on DEMAND in the user DAQ//
897 -\\Up to now there are 4 channels available at FL24
898 -\\\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD{{/code}}
899 -{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH01/TD{{/code}}
900 -\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH02/TD{{/code}}{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH03/TD{{/code}}
901 -
902 902  \\
903 903  
904 -DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
905 -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.
906 -DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
907 -
908 -In addition there are also additional parameters saved like:
909 -
910 -* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
911 -* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
912 -* {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
913 -* {{code language="none"}}/CH0-CH3/offset{{/code}}: To use the full dynamic range of the ADC one can shift the base line . This offset is saved here.
914 -
915 -===== MHz ADCs =====
916 -
917 -similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
918 -{{code language="none"}}/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH2/TD{{/code}}
919 -DOOCS prop : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02/CH00.TD
920 -DAQ channel: : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02
921 -
922 -In addition there are also additional parameters saved like:
923 -
924 -* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
925 -* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
926 -
927 -[[Contents>>doc:||anchor="Contents"]]
928 -
929 929  \\
930 930  
931 931  \\
932 932  
933 -==== Pump Probe Laser (FLASH2) ====
934 -
935 -There may be more information available from the "Laser DAQ". laese contact your Laser Local Contact.
936 -
937 -
938 -{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}//always saved (PBD2)//
939 -DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
940 -DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
941 -desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
942 -units : deg.
943 -
944 944  \\
945 945  
946 -
947 -{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/polarization position{{/code}}//always saved (PBD2)//
948 -DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
949 -DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
950 -desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
951 -units : deg.
952 -
953 953  \\
954 954  
955 -{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay readback{{/code}}
956 -//always saved (PBD2)//
957 -DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
958 -DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
959 -desc: delay of the Pump probe laser - measured by the read back position of the motor. There is also the set value available ( upto now these values are only updating every 1-2 seconds. There is no fast encoder property as on FLASH1 available)
960 -units : ps )
825 +(% class="wrapped" %)
826 +|=(((
827 +DAQ name
828 +)))|=(((
829 +HDF5 name
830 +)))
831 +|(((
832 +FLASH.UTIL/FL2.UND.MOTOR/FL2SASE3/GAP
833 +)))|(((
834 +/FL2/Electron Diagnostic/Undulator setting/SASE03 gap
835 +)))
836 +|(((
837 +FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP
838 +)))|(((
839 +/FL2/Electron Diagnostic/Undulator setting/SASE14 gap
840 +)))
841 +|(((
842 +TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH
843 +)))|(((
844 +/FL2/Electron Diagnostic/Undulator setting/set wavelength
845 +)))
846 +|(((
847 +FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX.UJ
848 +)))|(((
849 +/FL2/Photon Diagnostic/GMD/Average energy/hall
850 +)))
851 +|(((
852 +FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX
853 +)))|(((
854 +/FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
855 +)))
856 +|(((
857 +FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ
858 +)))|(((
859 +/FL2/Photon Diagnostic/GMD/Average energy/tunnel
860 +)))
861 +|(((
862 +FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX
863 +)))|(((
864 +/FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
865 +)))
866 +|(((
867 +FLASH.FEL/XGM.POSMON/FL2.HALL/IX.POS
868 +)))|(((
869 +/FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
870 +)))
871 +|(((
872 +FLASH.FEL/XGM.POSMON/FL2.HALL/IY.POS
873 +)))|(((
874 +/FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
875 +)))
876 +|(((
877 +FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS
878 +)))|(((
879 +/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
880 +)))
881 +|(((
882 +FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS
883 +)))|(((
884 +/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
885 +)))
886 +|(((
887 +FLASH.FEL/XGM.BPM/FL2.HALL:0
888 +)))|(((
889 +/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
890 +)))
891 +|(((
892 +FLASH.FEL/XGM.BPM/FL2.HALL:1
893 +)))|(((
894 +/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
895 +)))
896 +|(((
897 +FLASH.FEL/XGM.BPM/FL2.TUNNEL:0
898 +)))|(((
899 +/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
900 +)))
901 +|(((
902 +FLASH.FEL/XGM.BPM/FL2.TUNNEL:1
903 +)))|(((
904 +/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
905 +)))
906 +|(((
907 +FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:1
908 +)))|(((
909 +/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy aux tunnel
910 +)))
911 +|(((
912 +FLASH.FEL/XGM.INTENSITY/FL2.HALL
913 +)))|(((
914 +/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
915 +)))
916 +|(((
917 +FLASH.FEL/XGM.INTENSITY/FL2.HALL:0
918 +)))|(((
919 +/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
920 +)))
921 +|(((
922 +FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL
923 +)))|(((
924 +/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
925 +)))
926 +|(((
927 +FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:0
928 +)))|(((
929 +/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
930 +)))
931 +|(((
932 +FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042
933 +)))|(((
934 +/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean phtoton energy
935 +)))
936 +|(((
937 +FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040
938 +)))|(((
939 +/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelengt
940 +)))
941 +|(((
942 +FLASH.FEL/ADC.ADQ/OPIS1.CH02
943 +)))|(((
944 +/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Raw data/CH02
945 +)))
946 +|(((
947 +FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2
948 +)))|(((
949 +/FL2/Electron Diagnostic/Bunch charge/after undulator
950 +)))
951 +|(((
952 +FLASH.DIAG/PBD2.TOROID.ML/3GUN/CHARGE.FLASH2
953 +)))|(((
954 +/FL2/Electron Diagnostic/Bunch charge/at gun
955 +)))
956 +|(((
957 +FLASH.FEL/FL20T.PH.MOTOR/MOTOR1.MOT1/FPOS
958 +)))|(((
959 +/FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal
960 +)))
961 +|(((
962 +FLASH.FEL/FL20T.PH.MOTOR/MOTOR2.MOT1/FPOS
963 +)))|(((
964 +/FL2/Beamlines/Tunnel Apertures/position aperture1 vertical
965 +)))
966 +|(((
967 +FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER
968 +)))|(((
969 +/FL2/Beamlines/FL20/Shutter/channel 0
970 +)))
971 +|(((
972 +FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00
973 +)))|(((
974 +/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD
975 +)))
976 +|(((
977 +FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH00
978 +)))|(((
979 +/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH0/TD
980 +)))
981 +|(((
982 +FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
983 +)))|(((
984 +/FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS
985 +)))
986 +|(((
987 +FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/LOCK_STATUS.VALUE.RD
988 +)))|(((
989 +/FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO
990 +)))
991 +|(((
992 +FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD
993 +)))|(((
994 +/FL2/Experiment/Pump probe laser/laser delay readback
995 +)))
996 +|(((
997 +FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION_SET.WR
998 +)))|(((
999 +/FL2/Experiment/Pump probe laser/laser delay set value
1000 +)))
1001 +|(((
1002 +FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
1003 +)))|(((
1004 +/FL2/Experiment/Pump probe laser/FL24/attenuator position
1005 +)))
1006 +|(((
1007 +FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS
1008 +)))|(((
1009 +/FL2/Experiment/Pump probe laser/FL24/polarization position
1010 +)))
961 961  
962 962  \\
963 963  
964 -{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
965 -//always saved (PBD)//
966 -DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
967 -DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
968 -desc: rms jitter of the fs-Oscillator
969 -units: fs
970 -
971 971  [[Contents>>doc:||anchor="Contents"]]
972 972  
973 -\\
974 -
975 -=== "/uncategorized/" ===
976 -
977 - If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with their DOOCS names
978 -
979 -\\
980 -
981 981  === HDF5 structure revisions ===
982 982  
983 983  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: