Changes for page The FLASH HDF5 structure

Last modified by sndueste on 2025-11-19 14:51

From version 93.6
edited by sndueste
on 2025-05-19 16:49
Change comment: There is no comment for this version
To version 69.1
edited by sndueste
on 2023-02-08 14:59
Change comment: There is no comment for this version

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,0 @@
1 -FLASHUSER.Offline data analysis (DAQ).WebHome
Tags
... ... @@ -1,1 +1,0 @@
1 -favourite|data|hdf5|analysis|offline
Content
... ... @@ -7,23 +7,23 @@
7 7  
8 8  {{toc/}}
9 9  
10 +\\
10 10  
11 11  == General information about HDF5 ==
12 12  
13 -HDF5 is a data format maintained by the HDF group. For detailed general information see [[here>>url:https://portal.hdfgroup.org/display/support||shape="rect"]]
14 +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"]]
14 14  
15 -To download the HDF5 Viewer click [[here>>url:https://portal.hdfgroup.org/display/support/Download+HDFView||shape="rect"]]
16 +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"]]
16 16  
17 -For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :
18 -{{code language="none"}}> module load xray{{/code}}
18 +For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :
19 +{{code language="none"}}> module load xray{{/code}}
19 19  {{code language="none"}}> hdfview{{/code}}
20 20  
21 21  or you can use
22 22  
23 -{{code language="none"}}
24 -> silx view
25 -{{/code}}
24 +{{code language="none"}}> silx view{{/code}}
26 26  
26 +\\
27 27  
28 28  [[Contents>>doc:||anchor="Contents"]]
29 29  
... ... @@ -35,6 +35,8 @@
35 35  
36 36  Reference implementation, which follows the concept of Python libraries like Pandas, Xarray, or Dask, is given below.
37 37  
38 +\\
39 +
38 38  {{expand title="Discontinued HDF formats"}}
39 39  === Comparison to FLASH's deprecated HDF formats ===
40 40  
... ... @@ -46,6 +46,7 @@
46 46  
47 47  The HDF hierarchy is almost identical in all formats. While in the the recent format each DAQ channel contains the data sets "value" and "index", the deprecated format had one data set for each DAQ channel. The deprecated formats supplies no time axis parameters for spectra data types.
48 48  
51 +\\
49 49  
50 50  **HDF5 example files (old format)**
51 51  
... ... @@ -53,11 +53,13 @@
53 53  
54 54  [[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"]]
55 55  
59 +\\
56 56  
57 57  [[~[~[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"]]
58 58  
63 +\\
59 59  
60 -
65 +\\
61 61  {{/expand}}
62 62  
63 63  === HDF examples: ===
... ... @@ -66,16 +66,20 @@
66 66  
67 67  {{layout-section ac:type="three_equal"}}
68 68  {{layout-cell}}
69 -* ADC data as example for **fast** **data** (10 Hz):            
74 +* ADC data as example for **fast** **data** (10 Hz):           
70 70  
76 +\\
77 +
71 71  [[image:attach:image2020-11-16_15-26-28.png||height="250"]]
72 72  {{/layout-cell}}
73 73  
74 74  {{layout-cell}}
75 -* The //average// FEL pulse energy as example for the **slow** **data**. Here the data is not saved with 10 Hz  - thus not for every FEL pulse train.  The data is typically saved with 1 Hz if the values are changing (like the FEL energy) and every about 20 sec if there is no change for longer time ( e.g. motor set values). Thus to use the data together with the "fast" one, one has to interpolate the data as explained in the examples in the repos below show (e.g. {{code language="none"}}df['GMD_T_average'] = df['GMD_T_average'].interpolate(method='linear'){{/code}})
82 +* The //average// FEL pulse energy as example for the **slow** **data** (different e.g. 1 Hz):
76 76  
77 - ( as example only every 10th train ID is listed in the HDF group "index")
84 + ( every 10th train ID is listed in the HDF group "index")
78 78  
86 +\\
87 +
79 79  [[image:attach:image2020-11-16_15-31-45.png||height="250"]]
80 80  {{/layout-cell}}
81 81  
... ... @@ -86,6 +86,7 @@
86 86  
87 87   of the properties saved in the DESY internal raw format. (For experts)
88 88  
98 +\\
89 89  
90 90  [[image:attach:image2020-11-16_16-26-3.png||height="400"]]
91 91  {{/layout-cell}}
... ... @@ -94,12 +94,11 @@
94 94  {{layout-section ac:type="single"}}
95 95  {{layout-cell}}
96 96  {{info}}
97 -=== There are different options that help you to work with the FLASH HDF5 data in Python ===
107 +=== Reference implementation (Python) ===
98 98  
99 -* The currently developed option for large data sets: [[the FAB package>>url:https://hasfcpkg.desy.de/fab/fab.html||shape="rect"]] ... see below
100 -* and for smaller projects:  (% class="Object" %)[[https:~~/~~/gitlab.desy.de/christopher.passow/flash-daq-hdf>>url:https://gitlab.desy.de/christopher.passow/flash-daq-hdf||shape="rect"]]
109 +(imperative)  (% class="Object" %)[[https:~~/~~/gitlab.desy.de/christopher.passow/flash-daq-hdf>>url:https://gitlab.desy.de/christopher.passow/flash-daq-hdf||shape="rect"]]
101 101  
102 -(% class="Object" %)See also the collection of Demo data and sample scripts : [[doc:FS-FLASH USER tmp.Data Acquisition and controls 1.DAQ and controls overview.Offline data analysis (DAQ).Collection of HDF5 sample data from different beamlines.WebHome]] and [[doc:FS-FLASH USER tmp.Data Acquisition and controls 1.DAQ and controls overview.Offline data analysis (DAQ).DEMO - Working with FLASH data.WebHome]]
111 +(% class="Object" %)(object oriented) [[https:~~/~~/gitlab.desy.de/christopher.passow/fdh-builder>>url:https://gitlab.desy.de/christopher.passow/fdh-builder.git||shape="rect"]]
103 103  {{/info}}
104 104  {{/layout-cell}}
105 105  {{/layout-section}}
... ... @@ -110,79 +110,85 @@
110 110  
111 111  == Complete list of recordable parameters ==
112 112  
113 -The complete list for the relation between DOOCS names and HDF5 names for the recordable parameters can be found in [[DESY's Repository>>url:https://stash.desy.de/projects/CS/repos/pah/browse/src/camp/data/channel2HdfName.dat||shape="rect"]].
122 +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"]].
123 +\\
114 114  
115 -== Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
125 +== Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
116 116  
117 117  {{id name="DOOCSparameters"/}}
118 118  
129 +Note, the HDF group and data set names apply to our HDF tree version since vers. 0.3.0.
119 119  
131 +\\
132 +
120 120  === FLASH1 ===
121 121  
122 -
123 -In the Shutdown 2024 / 2025  the complete photon diagnostic and experiment control was renewed and thus the Doocs names and also some HDF5 names had to be changed. The new naming will be documented here as soon as the systems are online again.
124 -
125 -The previously used naming scheme (2024 and before) can be found here:
126 -
127 -
128 128  ==== Beamline info (FLASH1) ====
129 129  
130 -{{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}
131 -//always saved (PBD)//
132 -DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
133 -DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
134 -desc: set pressure in the gas attenuator
137 +{{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}
138 +//always saved (PBD)//
139 +DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
140 +DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
141 +desc: set pressure in the gas attenuator
135 135  units: mbar
143 +\\
136 136  
137 -{{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
138 -//always saved (PBD)//
139 -DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
140 -DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
141 -desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
145 +{{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
146 +//always saved (PBD)//
147 +DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
148 +DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
149 +desc: BL Beamline Fast shutter state
142 142  units: none
151 +\\
143 143  
144 -{{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
145 -//always saved (PBD)//
146 -DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
147 -DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
148 -desc: PG Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
153 +{{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
154 +//always saved (PBD)//
155 +DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
156 +DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
157 +desc: PG Beamline Fast shutter state
149 149  units: none
159 +\\
150 150  
151 -{{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
152 -//always saved (PBD)//
153 -DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
154 -DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
155 -desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
161 +{{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
162 +//always saved (PBD)//
163 +DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
164 +DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
165 +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]]
156 156  units: degree
167 +\\
157 157  
158 -{{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
159 -//always saved (PBD)//
160 -DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
161 -DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
162 -desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
169 +{{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
170 +//always saved (PBD)//
171 +DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
172 +DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
173 +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]]
163 163  units: degree
175 +\\
164 164  
165 -{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
166 -//always saved (PBD)//
167 -DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
168 -DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
169 -desc: Position of the PG filter wheel 1
177 +{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
178 +//always saved (PBD)//
179 +DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
180 +DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
181 +desc: Position of the PG filter wheel 1
170 170  units: degree
183 +\\
171 171  
172 -{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
173 -//always saved (PBD)//
174 -DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
175 -DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
176 -desc: Position of the PG filter wheel 2
185 +{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
186 +//always saved (PBD)//
187 +DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
188 +DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
189 +desc: Position of the PG filter wheel 2
177 177  units: degree
191 +\\
178 178  
179 -{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
180 -//always saved (PBD)//
181 -DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
182 -DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
183 -desc: Position of the PG filter wheel 3
193 +{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
194 +//always saved (PBD)//
195 +DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
196 +DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
197 +desc: Position of the PG filter wheel 3
184 184  units: degree
185 185  
200 +\\
186 186  
187 187  
188 188  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
... ... @@ -189,88 +189,92 @@
189 189  
190 190  [[Contents>>doc:||anchor="Contents"]]
191 191  
207 +\\
192 192  
193 193  ==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]]) ====
194 194  
195 195  {{expand title="Discontinued GMD format (used until 2021)"}}
196 -(% style="color:#000000" %)**Discontinued GMD data recording / evaluation  (VME + PhotonFlux ML server)**
212 +(% style="color: rgb(0,0,0);" %)**Discontinued GMD data recording / evaluation  (VME + PhotonFlux ML server)**
197 197  
198 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
214 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
199 199  //always saved (PBD)//
200 200  
201 -(% style="color:#000000" %)DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}} (%%)
202 -(% style="color:#000000" %)DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}(%%)
203 -desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator (ion current)
217 +(% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}} (%%)
218 +(% style="color: rgb(0,0,0);" %)DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}(%%)
219 +desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator (ion current)
204 204  units : microJ
205 205  
206 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
222 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
207 207  //always saved (PBD)//
208 208  
209 -DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
210 -DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
225 +DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
226 +DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
211 211  desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
212 -units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
228 +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]]**
213 213  
214 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
215 -//always saved (PBD)//
216 -DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
217 -DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
218 -desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
219 -units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
230 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
231 +//always saved (PBD)//
232 +DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
233 +DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
234 +desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
235 +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]]**
220 220  
221 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
237 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
222 222  //always saved (PBD)//
223 223  
224 -DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
225 -DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
240 +DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
241 +DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
226 226  desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
227 227  units : microJ
228 228  
229 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
245 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
230 230  //always saved (PBD)//
231 231  
232 -DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
233 -DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
248 +DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
249 +DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
234 234  desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
235 -units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
251 +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]]**
236 236  
237 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
238 -//always saved (PBD)//
239 -DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
240 -DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
241 -desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
242 -units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
253 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
254 +//always saved (PBD)//
255 +DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
256 +DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
257 +desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
258 +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]]**
243 243  {{/expand}}
244 244  
261 +\\
245 245  
246 -(% style="color:#000000; letter-spacing:0px" %)**NEW (since 2021) GMD data recording / evaluation  (same format as FLASH2 and XFEL)**
263 +(% style="letter-spacing: 0px; color: rgb(0, 0, 0)" %)**NEW (since 2021) GMD data recording / evaluation  (same format as FLASH2 and XFEL)**
247 247  
248 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
249 -//always saved (PBD)//
250 -(% style="color:#000000" %)DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}} (%%)
251 -(% style="color:#000000" %)DAQ channel: {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}
265 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
266 +//always saved (PBD)//
267 +(% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}} (%%)
268 +(% style="color: rgb(0,0,0);" %)DAQ channel: {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}
252 252  
253 -desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator
270 +desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator
254 254  units : microJ
255 255  
273 +\\
256 256  
257 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
275 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
258 258  //always saved (PBD)//
259 259  
260 -(% style="color:#000000" %)DOOCS prop : 
278 +(% style="color: rgb(0,0,0);" %)DOOCS prop : 
261 261  {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}
262 262  
263 263  desc : Energy per pulse measured in the Tunnel.  In addition measurement errors and beam position are included for EACH pulse in the pulse train  !! (see below)
264 -units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
282 +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]]**
265 265  
266 266  {{info title="GMD pulse resolved data structure"}}
267 -For every pulse in the pulse train the information is saved:
285 +For every pulse in the pulse train the information is saved:
286 +
268 268  
269 269  1. **Intensity per pulse** (a.u. (more or less µJ ))
270 270  1. Intensity per pulse (auxillary GMD) - not used
271 271  1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
272 272  1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
273 -1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color:#000000" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
292 +1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color: rgb(0,0,0);" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
274 274  1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
275 275  1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
276 276  1. Combined warning and error flags
... ... @@ -281,106 +281,108 @@
281 281  
282 282  [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
283 283  
284 -
303 +\\
285 285  {{/info}}
286 286  
287 -All values for the GMD are also available for the** BDA GMD **which is located in the experimental hall down stream the gas attenuator. If the attenuator is on the ratio between BDA and Tunnel signal shows the attenuation. **BUT NOTE** that the filter units  are downstream the GMD. So if filters  are used this influence is NOT measured by the GMD BDA !
306 +All values for the GMD are also available for the** BDA GMD **which is located in the experimental hall down stream the gas attenuator. If the attenuator is on the ratio between BDA and Tunnel signal shows the attenuation. **BUT NOTE** that the filter units  are downstream the GMD. So if filters  are used this influence is NOT measured by the GMD BDA !
288 288  
308 +\\
289 289  
290 290  Besides  pulse energy the GMD also provides information about the beam position
291 291  
292 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
293 -//always saved (PBD)//
294 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
295 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
296 -desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
312 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
313 +//always saved (PBD)//
314 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
315 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
316 +desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
297 297  units : mm
298 298  
299 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
300 -//always saved (PBD)//
301 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
302 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
303 -desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
319 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
320 +//always saved (PBD)//
321 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
322 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
323 +desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
304 304  units : mm
305 305  
306 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
307 -//always saved (PBD)//
308 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
309 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
310 -desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
326 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
327 +//always saved (PBD)//
328 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
329 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
330 +desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
311 311  units : mm
312 312  
313 -{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
314 -//always saved (PBD)//
315 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
316 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
317 -desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
333 +{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
334 +//always saved (PBD)//
335 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
336 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
337 +desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
318 318  units : mm
319 319  
340 +\\
320 320  
321 321  ==== Spectrometer (FLASH1) ====
322 322  
323 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
324 -_always saved (when Spectrum is measured !!) (PBD) _
325 -DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}
326 -DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}
327 -desc : XUV Spectrum measured with the "tunnel spectrometer"
344 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
345 +_always saved (when Spectrum is measured !!) (PBD) _
346 +DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}
347 +DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}
348 +desc : XUV Spectrum measured with the "tunnel spectrometer"
328 328  units :
329 329  
330 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}
331 -_always saved (when Spectrum is measured !!) (PBD) _
332 -DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
333 -DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
334 -desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
351 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}
352 +_always saved (when Spectrum is measured !!) (PBD) _
353 +DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
354 +DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
355 +desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
335 335  units : nm
336 336  
337 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}
338 -_always saved (when Spectrum is measured !!) (PBD) _
339 -DOOCS prop : ==
340 -DAQ channel: ==
341 -desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
358 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}
359 +_always saved (when Spectrum is measured !!) (PBD) _
360 +DOOCS prop : ==
361 +DAQ channel: ==
362 +desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
342 342  units : nm
343 343  
344 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}
345 -//saved on DEMAND (PBD spectrometer stream)//
346 -DOOCS prop : ==
347 -DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}
365 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}
366 +//saved on DEMAND (PBD spectrometer stream)//
367 +DOOCS prop : ==
368 +DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}
348 348  desc : XUV Spectrum in eV measured with the "PG2 spectrometer"
349 349  units :
350 350  
351 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}
352 -//saved on DEMAND (PBD spectrometer stream)//
353 -DOOCS prop : ==
354 -DAQ channel: ==
355 -desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
372 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}
373 +//saved on DEMAND (PBD spectrometer stream)//
374 +DOOCS prop : ==
375 +DAQ channel: ==
376 +desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
356 356  units : eV
357 357  
358 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}
359 -//saved on DEMAND (PBD spectrometer stream)//
360 -DOOCS prop : ==
361 -DAQ channel: ==
362 -desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
379 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}
380 +//saved on DEMAND (PBD spectrometer stream)//
381 +DOOCS prop : ==
382 +DAQ channel: ==
383 +desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
363 363  units : eV
364 364  
365 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}
366 -//saved on DEMAND (PBD spectrometer stream)//
367 -DOOCS prop : ==
368 -DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}
386 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}
387 +//saved on DEMAND (PBD spectrometer stream)//
388 +DOOCS prop : ==
389 +DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}
369 369  desc : XUV Spectrum in nm measured with the "PG2 spectrometer"
370 370  units :
371 371  
372 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}
373 -//saved on DEMAND (PBD spectrometer stream)//
374 -DOOCS prop : ==
375 -DAQ channel: ==
376 -desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
393 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}
394 +//saved on DEMAND (PBD spectrometer stream)//
395 +DOOCS prop : ==
396 +DAQ channel: ==
397 +desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
377 377  units : nm
378 378  
379 -{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}
380 -//saved on DEMAND (PBD spectrometer stream)//
381 -DOOCS prop : ==
382 -DAQ channel: ==
383 -desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
400 +{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}
401 +//saved on DEMAND (PBD spectrometer stream)//
402 +DOOCS prop : ==
403 +DAQ channel: ==
404 +desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
384 384  units : nm
385 385  
386 386  [[Contents>>doc:||anchor="Contents"]]
... ... @@ -389,18 +389,18 @@
389 389  
390 390  ===== bunch charge =====
391 391  
392 -{{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
393 -//always saved (PBD)//
394 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
395 -DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
396 -desc: electron bunch charge (FLASH1)
413 +{{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
414 +//always saved (PBD)//
415 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
416 +DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
417 +desc: electron bunch charge (FLASH1)
397 397  units: nC
398 398  
399 399  =====
400 400  arrival time (BAM) =====
401 401  
402 -{{info title="BAM information: updates 2022 (status 2025)"}}
403 -* see: [[Info collection about the BAMs and how to use the BAM data>>doc:FS-FLASH USER tmp.jddd-linked help pages.Info collection for the BAM.WebHome||shape="rect"]]
423 +{{info title="BAM information: updates 2022"}}
424 +* see: [[Info collection about the BAMs and how to use the BAM data>>url:https://confluence.desy.de/display/FLASHUSER/Info+collection+for+the+BAM||shape="rect"]]
404 404  * The data format of the BAM has been completely altered in the 2022 shutdown
405 405  * before 2022 BAMs were always saving the arrival time information for each 1µs bucked regardless if there were electrons in the accelerator or not. IN addition the arrival times for  FL1 and FL2 were saved in the same parameter ...
406 406  * THIS is now different. There are new parameters saving only the arrival times for pulses that go to FL1 and to FL2 (in detail: first time slot of the accelerator and second)
... ... @@ -407,223 +407,236 @@
407 407  * There has been also a renaming  (and relocation) of the BAMs.
408 408  ** acc:  4DBC3 → FL0.DBC2
409 409  ** FL1: 1SFELC →  FL1.SFELC
410 -** FL2: FL2XTDS → (% style="color:#172b4d" %)FL2.SEED5
411 -* for more Info: [[LINK to detailed infos from MSK>>doc:SDiag.How-to articles.BAM Data Structure.WebHome||shape="rect"]]
412 -* [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments>>doc:FS-FLASH USER tmp.Additional helpful things1.FLASH beamlines and instruments references.WebHome]]
431 +** FL2: FL2XTDS → (% style="color: rgb(23,43,77);" %)FL2.SEED5
432 +* for more Info: [[LINK to detailed infos from MSK>>url:https://confluence.desy.de/display/SDiagPublic/BAM+Data+Structure||shape="rect"]]
433 +* [[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]]
413 413  * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
414 414  {{/info}}
415 415  
437 +\\
438 +
416 416  {{expand title="Discontinued BAM format (used until end 2021)"}}
417 -(% style="color:#000000" %)**Discontinued BAM data recording **
440 +(% style="color: rgb(0,0,0);" %)**Discontinued BAM data recording **
418 418  
419 -{{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
420 -//always saved (PBD)//
421 -DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
422 -DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
423 -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).
442 +{{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
443 +//always saved (PBD)//
444 +DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
445 +DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
446 +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).
424 424  units: ps (bigger numbers indicate later arrivaltime of the electrons)
425 425  
449 +\\
426 426  
427 -{{code language="none"}}/FL1/Electron Diagnostic/BAM/1SFELC/electron bunch arrival time (low charge){{/code}}
428 -//always saved (PBD)//
429 -DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/1SFELC/LOW_CHARGE_ARRIVAL_TIME{{/code}}
430 -DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/1SFELC.LOW_CHARGE_ARRIVAL_TIME{{/code}}
431 -desc: Electron bunch arrival time measured with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.
451 +{{code language="none"}}/FL1/Electron Diagnostic/BAM/1SFELC/electron bunch arrival time (low charge){{/code}}
452 +//always saved (PBD)//
453 +DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/1SFELC/LOW_CHARGE_ARRIVAL_TIME{{/code}}
454 +DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/1SFELC.LOW_CHARGE_ARRIVAL_TIME{{/code}}
455 +desc: Electron bunch arrival time measured with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.
432 432  units: ps (bigger numbers indicate later arrival time of the electrons)
433 433  {{/expand}}
434 434  
435 435  ====== **BAM FL0.DBC2**{{code language="none"}}{{/code}} ======
436 436  
437 -(% style="color:#ff6600" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)(%%)
461 +(% style="color: rgb(255,102,0);" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)(%%)
438 438  //always saved (PBD)//
439 -{{code language="none"}}/FL1/Electron Diagnostic/BAM/ {{/code}}DOOCS prop : FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
440 -DAQ (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP (%%)
441 -desc: Electron bunch arrival time measured with the BAM inside the accelerator (after bunch compressor 2). The property contains only the arrival time of the bunches sent to FL1 (e.g. if there are 30 bunches in FL1 the first 30 values are the arrival time the remaining numbers  still may have arbitrary numbers looking like a signal which they are not ). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
463 +**FL0.DBC2**
464 +(% style="color: rgb(0,0,0);" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP (%%)
465 +{{code language="none"}}/FL1/Electron Diagnostic/BAM/ DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA1.COMPDAQ desc: Electron bunch arrival time measured with the BAM inside the accelerator (after bunch compressor 2). The property contains only the arrival time of the bunches sent to FL1 (e.g. if there are 30 bunches in FL1 the first 30 values are the arrival time the remaining numbers should be only 0). These are the same values as the "raw" data below - just "cleaned". The values{{/code}}(% style="font-family: SFMono-Medium , ~"SF Mono~" , ~"Segoe UI Mono~" , ~"Roboto Mono~" , ~"Ubuntu Mono~" , Menlo , Courier , monospace;letter-spacing: 0.0px;" %) show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
442 442  
443 -units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
467 +{{code language="none"}}units: fs (bigger numbers (typically) indicate later arrival times of the electrons).{{/code}}
444 444  
469 +\\
445 445  
446 -(% style="color:#ff6600" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
447 -//always saved (PBD)//
471 +(% style="color: rgb(255,102,0);" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
472 +//always saved (PBD)//
448 448  DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE
449 -DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE (%%)
474 +DAQ channel: (% style="color: rgb(0,0,0);" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE (%%)
450 450  desc: Electron bunch arrival time measured with the BAM inside the accelerator (after bunch compressor 2). Here the complete bunch train from the FEL is recorded (FLASH1 and FLASH2 pulses). Thus there are values from FLASH 1 in the first part. they may be separated by several "0" values if the reprate is different from 1 MHz ...  - It shows a very good correlation to the arrival time  of the XUV pulses in the experiment (see help). 
451 451  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
452 452  
478 +\\
453 453  
454 -(% style="color:#ff6600" %)DBC2/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
455 -//always saved (PBD)//
456 -DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E.bamError.1(%%)
457 -DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR.1(%%)
458 -desc:(% style="letter-spacing:0.0px" %) status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
480 +(% style="color: rgb(255,102,0);" %)DBC2/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
481 +//always saved (PBD)//
482 +DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color: rgb(0,0,0);" %)E.bamError(%%)
483 +DAQ channel: (% style="color: rgb(0,0,0);" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR(%%)
484 +desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
459 459  
486 +\\
460 460  
461 -(% style="color:#ff6600" %)DBC2/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
462 -//always saved (PBD)//
463 -DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E..bamStatus.//1//(%%)
464 -DAQ channel(% style="color:#000000" %): FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.1(%%)
465 -desc: (% style="letter-spacing:0.0px" %) status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
488 +(% style="color: rgb(255,102,0);" %)DBC2/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
489 +//always saved (PBD)//
490 +DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color: rgb(0,0,0);" %)E..bamStatus.//1//(%%)
491 +DAQ channel(% style="color: rgb(0,0,0);" %): FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.1(%%)
492 +desc: (% style="letter-spacing: 0.0px;" %) status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
466 466  
494 +\\
467 467  
468 468  ====== **BAM FL1.SFELC**{{code language="none"}}{{/code}} ======
469 469  
470 -(% style="font-family:SFMono-Medium,~"SF Mono~",~"Segoe UI Mono~",~"Roboto Mono~",~"Ubuntu Mono~",Menlo,Courier,monospace; letter-spacing:0.0px" %)/FL1/Electron Diagnostic/BAM/**SFELC**(% style="color:#ff6600" %)/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)
498 +(% style="font-family: SFMono-Medium , ~"SF Mono~" , ~"Segoe UI Mono~" , ~"Roboto Mono~" , ~"Ubuntu Mono~" , Menlo , Courier , monospace;letter-spacing: 0.0px;" %)/FL1/Electron Diagnostic/BAM/**SFELC**(% style="color: rgb(255,102,0);" %)/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)
471 471  
472 472  //always saved (PBD)//
473 -(% style="color:#172b4d" %)**FL1.SFELC**(%%)
474 -(% style="color:#000000" %)channel: FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
475 -{{code language="none"}} DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA1.COMPDAQ {{/code}}(% style="letter-spacing:0.0px" %)desc: Electron bunch arrival time measured  with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.. The property contains only the arrival time of the bunches sent to FL1 (e.g. if there are 30 bunches in FL1 the first 30 values are the arrival time the remaining numbers still may have arbitrary numbers looking like a signal which they are not). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
501 +(% style="color: rgb(23,43,77);" %)**FL1.SFELC**(%%)
502 +(% style="color: rgb(0,0,0);" %)channel: FLASH.SDIAG/BAM/(% style="color: rgb(0, 0, 0); color: rgb(23, 43, 77)" %)FL1.SFELC(% style="color: rgb(0,0,0);" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
503 +{{code language="none"}} DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA1.COMPDAQ {{/code}}(% style="letter-spacing: 0.0px;" %)desc: Electron bunch arrival time measured  with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.. The property contains only the arrival time of the bunches sent to FL1 (e.g. if there are 30 bunches in FL1 the first 30 values are the arrival time the remaining numbers should be only 0). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
476 476  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
477 477  
506 +\\
478 478  
508 +\\
479 479  
480 -(% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/electron bunch arrival time (raw) (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
481 -//always saved (PBD)//
482 -DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIME.ABSOLUTE
483 -DAQ channel:** **(% style="color:#000000" %)FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.ABSOLUTE (%%)
510 +(% style="color: rgb(23,43,77);" %)SFELC(% style="color: rgb(255,102,0);" %)/electron bunch arrival time (raw) (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
511 +//always saved (PBD)//
512 +DOOCS prop : FLASH.SDIAG/BAM/(% style="color: rgb(23,43,77);" %)FL1.SFELC(%%)/ARRIVAL_TIME.ABSOLUTE
513 +DAQ channel:** **(% style="color: rgb(0,0,0);" %)FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.ABSOLUTE (%%)
484 484  desc: Electron bunch arrival time measured  with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020. Here the complete bunch train from the FEL is recorded (FLASH1 and FLASH2 pulses). Thus there are values from FLASH 1 in the first part. they may be separated by several "0" values if the reprate is different from 1 MHz ...  - It shows a very good correlation to the arrival time  of the XUV pulses in the experiment (see help). 
485 485  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
486 486  
517 +\\
487 487  
488 -(% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
489 -//always saved (PBD)//
490 -DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color:#000000" %)E.bamError(%%)
491 -DAQ channel(% style="color:#000000" %): FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMERROR(%%)
519 +(% style="color: rgb(23,43,77);" %)SFELC(% style="color: rgb(255,102,0);" %)/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
520 +//always saved (PBD)//
521 +DOOCS prop : FLASH.SDIAG/BAM/(% style="color: rgb(23,43,77);" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color: rgb(0,0,0);" %)E.bamError(%%)
522 +DAQ channel(% style="color: rgb(0,0,0);" %): FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMERROR(%%)
492 492  desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
493 493  
525 +\\
494 494  
495 -(% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
496 -//always saved (PBD)//
497 -DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color:#000000" %)E..bamStatus.//1//(%%)
498 -DAQ chann(% style="color:#000000" %)el: FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMSTATUS.1(%%)
527 +(% style="color: rgb(23,43,77);" %)SFELC(% style="color: rgb(255,102,0);" %)/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
528 +//always saved (PBD)//
529 +DOOCS prop : FLASH.SDIAG/BAM/(% style="color: rgb(23,43,77);" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color: rgb(0,0,0);" %)E..bamStatus.//1//(%%)
530 +DAQ chann(% style="color: rgb(0,0,0);" %)el: FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMSTATUS.1(%%)
499 499  desc: status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
500 500  
533 +\\
501 501  
535 +\\
502 502  
503 503  ===== electron beam profile =====
504 504  
505 -{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
506 -//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
507 -DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
508 -DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
509 -desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
539 +{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
540 +//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
541 +DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
542 +DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
543 +desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
510 510  units: pixel
545 +\\
511 511  
512 -{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
513 -//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
514 -DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
515 -DAQ channel: = PBD.BEAM.PROF.ML/CCT=
516 -desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
547 +{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
548 +//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
549 +DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
550 +DAQ channel: = PBD.BEAM.PROF.ML/CCT=
551 +desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
517 517  units: fs per pixel
553 +\\
518 518  
519 -{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
520 -//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
521 -DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
522 -DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
523 -desc: rms pulse width of the measures TDS electron bunch profile
555 +{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
556 +//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
557 +DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
558 +DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
559 +desc: rms pulse width of the measures TDS electron bunch profile
524 524  units: fs
525 525  
526 526  ===== electron bunch energy =====
527 527  
528 -{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
529 -//always saved (PBD)//
530 -DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
531 -DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
532 -desc: electron bunch energy (average over the bunch train)
533 -units: (% class="twikiNewLink" %)MeV
564 +{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
565 +//always saved (PBD)//
566 +DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
567 +DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
568 +desc: electron bunch energy (average over the bunch train)
569 +units: (% class="twikiNewLink" %)MeV(%%)
570 +\\
534 534  
535 -{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
536 -//always saved (PBD)//
537 -DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
538 -DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
539 -desc: electron bunch energy bunch resolved
572 +{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
573 +//always saved (PBD)//
574 +DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
575 +DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
576 +desc: electron bunch energy bunch resolved
540 540  units: (% class="twikiNewLink" %)MeV
541 541  
579 +\\
542 542  
543 -{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
544 -//always saved (PBD)//
545 -DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
546 -DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
547 -desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
581 +{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
582 +//always saved (PBD)//
583 +DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
584 +DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
585 +desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
548 548  units: nm
587 +\\
549 549  
550 550  [[Contents>>doc:||anchor="Contents"]]
551 551  
591 +\\
552 552  
553 553  ==== Timing information, rep rate etc.  (FLASH1) ====
554 554  
555 555  ===== bunch repetition rate =====
556 556  
557 -{{code language="none"}}/FL1/Timing/repetition rate{{/code}}
558 -//always saved (PBD)//
559 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
560 -DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
597 +{{code language="none"}}/FL1/Timing/repetition rate{{/code}}
598 +//always saved (PBD)//
599 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
600 +DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
561 561  desc: repetition rate of the bunches / pulses within the burst (FLASH1)
562 562  units: kHz
603 +\\
563 563  
564 564  ===== set number of pulses =====
565 565  
566 -(% style="color:#ff6600" %)(HDF5 name not yet implemented - see zraw)(% style="color:#ff0000" %){{code language="none"}}/FL1/Timing/set number of bunches {{/code}}(%%)
567 -//always saved (PBD)//
568 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1 [4th number]{{/code}}
569 -DAQ channel: {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1 [4th number]{{/code}}
570 -desc: Number of bunches set in the control (timing) system.  The property contains 4 numbers. the last one is the number of pulses (see also [[doc:FLASH.Timing properties]] (internal link)).  If pulses are used for diagnostic of the protection system of the accelerator limits the number of bunches to be accelerated and thus the actual number of pulses may be smaller than the set one 
607 +{{code language="none"}}/FL1/Timing/set number of bunches{{/code}}
608 +//always saved (PBD)//
609 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH1{{/code}}
610 +DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_NUM{{/code}}
611 +desc: Number of pulses set at the gun (FLASH1)
571 571  units:
572 572  
573 573  ===== actual number of pulses =====
574 574  
575 -{{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
576 -//always saved (PBD)//
577 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
578 -DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
579 -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)
616 +{{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
617 +//always saved (PBD)//
618 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
619 +DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
620 +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)
580 580  units:
622 +\\
581 581  
582 582  ===== actual pulse pattern recorded after the undulator =====
583 583  
584 -{{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
585 -//always saved (PBD)//
586 -DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
587 -DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
588 -desc: The bunch pattern as function of time in a burst recorded by toroid diagnostic BEHIND the undulator. (FLASH1)
626 +{{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
627 +//always saved (PBD)//
628 +DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
629 +DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
630 +desc: The bunch pattern as function of time in a burst recorded by toroid diagnostic BEHIND the undulator. (FLASH1)
589 589  units:
632 +\\
590 590  
591 591  ===== Train ID =====
592 592  
593 -{{code language="none"}}/Timing/train ID{{/code}}
594 -//always saved (PBD)//
595 -DOOCS prop : {{code language="none"}}none{{/code}}
596 -DAQ channel: {{code language="none"}}none{{/code}}
597 -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 !)
636 +{{code language="none"}}/Timing/train ID{{/code}}
637 +//always saved (PBD)//
638 +DOOCS prop : {{code language="none"}}none{{/code}}
639 +DAQ channel: {{code language="none"}}none{{/code}}
640 +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 !)
598 598  units:
642 +\\
599 599  
600 -===== (% style="color:#e67e22" %)Train time(%%) =====
644 +===== Train time =====
601 601  
602 -(% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
603 -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
646 +{{code language="none"}}/Timing/train time{{/code}}
647 +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
604 604  units: d h min s cs
649 +\\
605 605  
606 -(% style="color:#e67e22" %){{code language="none"}}/Timing/time stamp{{/code}}
607 -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
608 -second column: microseconds
651 +{{code language="none"}}/Timing/time stamp{{/code}}
652 +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
653 +second column: microseconds
609 609  third column: Train ID of FLASH
655 +\\
610 610  
611 -currently it is saved as Unix time in : /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time
612 -
613 -{{expand expanded="false" title="Timestamp help for python"}}
614 - import time
615 -
616 -# epoch time is found in /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time #!!! a leading 1 has to be added !!!
617 -# The time and date of the start of the data taking in the HDF file is encoded in the filename - to roughly check the time
618 -epoch_time = 1709051499.17 # Replace with your epoch time
619 -
620 -formatted_time = time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime(epoch_time))
621 -print(formatted_time)
622 -{{/expand}}
623 -
624 -
625 625  [[Contents>>doc:||anchor="Contents"]]
626 626  
659 +\\
660 +
627 627  ==== Pump Probe Laser (FLASH1) ====
628 628  
629 629  **PIGLET (PG laser)**
... ... @@ -630,62 +630,87 @@
630 630  
631 631  **{{code language="none"}}/FL1/Experiment/Pump probe laser{{/code}}**
632 632  
633 -{{info width="30%"}}
634 -list of saved parameters status May 2024 (up to now the parameters can be found in /zraw/ ... )
667 +FLASH.LASER/FLACPUPGLASER1.PULSEENERGY/DIAG1out/PULSEENERGY.MEAN 
668 +FLASH.LASER/FLACPUPGLASER1.PULSEENERGY/PG1_incoupl/PULSEENERGY.MEAN 
669 +FLASH.LASER/FLACPUPGLASER1.PULSEENERGY/PG2_incoupl/PULSEENERGY.MEAN 
670 +FLASH.SYNC/LASER.LOCK.EXP/FLASH1.MOD1.PG.OSC/FMC0.MD22.1.ENCODER_POSITION.RD 
671 +FLASH.SYNC/LASER.LOCK.EXP/FLASH1.MOD1.PG.OSC/FMC0.MD22.1.ENCODER_POSITION_RAW.RD 
672 +FLASH.SYNC/LASER.LOCK.EXP/FLASH1.MOD1.PG.OSC/FMC0.MD22.1.POSITION.RD
635 635  
636 -Download the PDF:
674 +**BL - Hidra laser **
637 637  
638 -{{view-file att--filename="FSLADAQ-DAQParameterlistPiGLET.pdf"}}{{/view-file}}
676 +Property,Units,Description
677 +FLASH.LASER/MODBL.CAM/BL1.13.AC/DAQ_CHANNEL,'AU','FL1HIDRAPP1 Autocorrelation (IR) ROI readout'
678 +FLASH.LASER/MODBL.CAM/BL1.14.VF/DAQ_CHANNEL,'AU','FL1HIDRAPP1 Virtual Focus Camera (IR) ROI readout'
679 +FLASH.LASER/MODBL.SENSORBOARD/PDTRIG_CAMP/DAQ_CHANNEL,'au','FL1PPL Energy channels'
680 +FLASH.LASER/MODBL.SPECT/CAMP_IR/DAQ_CHANNEL,'au','FL1PPL BL Table Spectrum'
681 +FLASH.LASER/HIDRAPP1.SPECTRUM_ANALYSIS/CAMP_IR/DAQ_CHANNEL,'au','FL1PPL Spectrum Analysis'
682 +FLASH.SYNC/LASER.LOCK.EXP/F1.PPL.OSC/FMC0.MD22.1.POSITION.RD,'ps','FL1PPL Optical Delay Line (act)'
683 +FLASH.SYNC/LASER.LOCK.EXP/F1.PPL.OSC/FMC0.MD22.1.POSITION_SET.WR,'ps','FL1PPL Optical Delay Line (set)'
684 +FLASH.SYNC/LASER.LOCK.EXP/F1.PPL.OSC/FMC0.MD22.1.ENCODER_POSITION.RD,'ps','FL1PPL Optical Delay Line (Encoder Readback)'
685 +FLASH.FEL/FLAPPBEAMLINES.MOTOR/CAMP_Delayline/FPOS,'ps','FL1PPL NIR delay BL1 table (act)'
686 +FLASH.FEL/FLAPPBEAMLINES.MOTOR/CAMP_Delayline/FPOS.SET,'ps','FL1PPL NIR delay BL1 table (set)'
687 +FLASH.FEL/FLAPPBEAMLINES.MOTOR/CAMP.ATT/FPOS,'degree','FL1PPL Transmission degree (act)'
688 +FLASH.FEL/FLAPPBEAMLINES.MOTOR/CAMP.ATT/FPOS.SET,'degree','FL1PPL Transmission degree (set)'
689 +FLASH.FEL/FLAPPBEAMLINES.MOTOR/Camp_Focus_Lens/FPOS,'mm','FL1PPL Focus Mirror Stage Position (act)'
690 +FLASH.FEL/FLAPPBEAMLINES.MOTOR/Camp_Focus_Lens/FPOS.SET,'mm','FL1PPL Focus Mirror Stage Position (set)'
691 +FLASH.LASER/MODBL.FEEDFWD/BL1_Att/INPUT.Y,'%','FL1PPL Transmission rate'
692 +FLASH.SYNC/LASER.LOCK.EXP/F1.PPL.OSC/CURRENT_INPUT_JITTER.RD,'fs','FL1PPL Sync. Jitter'
693 +FLASH.SYNC/LASER.LOCK.EXP/F1.PPL.OSC/LOCK_STATUS.VALUE.RD,'au','FL1PPL Sync. Status'
639 639  
695 +\\
640 640  
641 -
642 -{{/info}}
697 +\\
643 643  
644 644  {{expand title="Parameters used until 2021"}}
645 -{{code language="none"}}
646 -/FL1/Experiment/Pump probe laser/laser attenuation
647 -{{/code}}
700 +{{code language="none"}}/FL1/Experiment/Pump probe laser/laser attenuation{{/code}}
648 648  
649 -//always saved (PBD)//
650 -DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
651 -DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
652 -desc: attenuation of the PPLaser (rotation of a waveplate)
702 +//always saved (PBD)//
703 +DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
704 +DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
705 +desc: attenuation of the PPLaser (rotation of a waveplate)
653 653  units : 0 no transmission , 1: full transmission
654 654  
708 +\\
655 655  
656 -{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}
657 -//always saved (PBD)//
658 -DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
659 -DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
660 -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
710 +{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}
711 +//always saved (PBD)//
712 +DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
713 +DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
714 +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
661 661  units : ps ( pos delay means IR comes later)
662 662  
717 +\\
663 663  
664 -{{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}
665 -//always saved (PBD)//
666 -DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}
667 -DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}
668 -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
719 +{{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}
720 +//always saved (PBD)//
721 +DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}
722 +DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}
723 +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
669 669  units : ps ( pos delay means IR comes later)
670 670  
726 +\\
671 671  
672 -{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}
673 -//always saved (PBD)//
674 -DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
675 -DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
728 +{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}
729 +//always saved (PBD)//
730 +DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
731 +DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
676 676  desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
677 677  
734 +\\
678 678  
679 -{{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}
680 -//always saved (PBD)//
681 -DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
682 -DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
736 +{{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}
737 +//always saved (PBD)//
738 +DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
739 +DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
683 683  desc: delay time between the optical laser and the FEL units: ps
684 684  {{/expand}}
685 685  
743 +\\
686 686  
687 687  [[Contents>>doc:||anchor="Contents"]]
688 688  
747 +\\
689 689  
690 690  ==== User Data (FLASH1) ====
691 691  
... ... @@ -697,26 +697,26 @@
697 697  
698 698  ===== GHz ADCs =====
699 699  
700 -ADC traces of the (SPDevices 412) GHZ ADCs available for the users . More information about the ADCs can be found** [[here>>doc:FS-FLASH USER tmp.Data Acquisition and controls 1.Controls (DOOCS, jDDD,\.\.\.).MTCA ADCs.WebHome]]**
701 -//saved on DEMAND in the user DAQ//
759 +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]]**
760 +//saved on DEMAND in the user DAQ//
702 702  \\The HDF5 names for the ADC traces are depending on the beamline :
703 -\\PG Beamline:
704 -{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}
705 -{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}
706 -{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}
762 +\\PG Beamline:
763 +{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}
764 +{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}
765 +{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}
707 707  {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}
708 708  
709 -BL Beamlines:
710 -{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}
711 -{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}
712 -{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}
713 -{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}
714 -\\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}
715 -{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}
716 -\\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}
768 +BL Beamlines:
769 +{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}
770 +{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}
771 +{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}
772 +{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}
773 +\\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}
774 +{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}
775 +\\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}
717 717  {{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}
718 718  
719 -DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
778 +DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
720 720  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}} contains only the grouped spectra. To read the ADC trace with an online analysis program the {{code language="none"}}CH00.DAQ.TD{{/code}} is used preferably.
721 721  DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
722 722  
... ... @@ -724,13 +724,13 @@
724 724  
725 725  * {{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.
726 726  * {{code language="none"}}number of samples{{/code}}: total number of samples recorded for each 10 Hz trigger
727 -* {{code language="none"}}error (ADC):{{/code}}0 indicates that there was no error
786 +* {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
728 728  
729 729  ===== MHz ADCs =====
730 730  
731 -similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
732 -{{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}
733 -DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
790 +similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
791 +{{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}
792 +DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
734 734  DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
735 735  
736 736  In addition there are also additional parameters saved like:
... ... @@ -740,8 +740,11 @@
740 740  
741 741  [[Contents>>doc:||anchor="Contents"]]
742 742  
802 +\\
743 743  
804 +\\
744 744  
806 +\\
745 745  
746 746  === FLASH2 ===
747 747  
... ... @@ -749,67 +749,74 @@
749 749  
750 750  ==== Beamline info (FLASH2) ====
751 751  
752 -{{code language="none"}}/FL2/Beamlines/Attenuator/pressure  {{/code}}
753 -(% style="color:#000000" %)//always saved (PBD2)// (%%)
754 -(% style="color:#000000" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
755 -(% style="color:#000000" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
756 -(% style="color:#000000" %)desc: set pressure in the gas attenuator (%%)
757 -(% style="color:#000000" %)units: mbar
814 +{{code language="none"}}/FL2/Beamlines/Attenuator/pressure  {{/code}}
815 +(% style="color: rgb(0,0,0);" %)//always saved (PBD2)// (%%)
816 +(% style="color: rgb(0,0,0);" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
817 +(% style="color: rgb(0,0,0);" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
818 +(% style="color: rgb(0,0,0);" %)desc: set pressure in the gas attenuator (%%)
819 +(% style="color: rgb(0,0,0);" %)units: mbar(%%)
820 +\\
758 758  
759 -{{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
760 -//always saved (PBD2)//
761 -DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER/CH00.TD{{/code}}
762 -DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER{{/code}}
763 -desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
822 +{{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
823 +//always saved (PBD2)//
824 +DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER/CH00.TD{{/code}}
825 +DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER{{/code}}
826 +desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
764 764  units: none
765 765  
766 766  
767 -{{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 1{{/code}}
768 -//always saved (PBD2)//
769 -DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}
770 -DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
771 -desc: Position of the BL filter wheel 1 - to correlate with the filter material please look **[[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]**
830 +{{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 1{{/code}}
831 +//always saved (PBD2)//
832 +DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}
833 +DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
834 +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]]**
772 772  units: degree
836 +\\
773 773  
774 -/FL2/Beamlines/Filter wheel/position wheel 2
775 -always saved (PBD2)
776 -DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
777 -DAQ channel: {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
778 -desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
838 +/FL2/Beamlines/Filter wheel/position wheel 2
839 +always saved (PBD2)
840 +DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
841 +DAQ channel: {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
842 +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]]
779 779  units: degree
780 780  
845 +\\
781 781  
782 782  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
783 783  
784 784  [[Contents>>doc:||anchor="Contents"]]
785 785  
851 +\\
786 786  
853 +\\
787 787  
788 788  ==== Photon Diagnostics SASE ([[XGMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]] - FLASH2) ====
789 789  
790 -{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
791 -//always saved (PBD2)//
792 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
793 -DAQ channel:{{code language="none"}} FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
794 -desc : calibrated average ( ~~ 20 sec averaging time ) SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)
857 +{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
858 +//always saved (PBD2)//
859 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
860 +DAQ channel:{{code language="none"}} FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
861 +desc : calibrated average ( ~~ 20 sec averaging time ) SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)
795 795  units : microJ
796 796  
864 +\\
797 797  
798 -{{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
799 -//always saved (PBD2)//
800 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
801 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
866 +{{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
867 +//always saved (PBD2)//
868 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
869 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
802 802  desc : Energy per pulse measured in the Tunnel  (in front of the gas attenuator and the apertures in the Hall) In addition measurement errors and beam position are included for EACH pulse in the pulse train  !! (see below)
803 -units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
871 +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]]**
804 804  
805 805  {{info title="GMD pulse resolved data structure"}}
806 -For every pulse in the pulse train the information is saved:
874 +For every pulse in the pulse train the information is saved:
875 +
807 807  
808 808  1. **Intensity per pulse** (a.u. (more or less µJ ))
809 809  1. Intensity per pulse (auxillary GMD) - not used
810 810  1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
811 811  1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
812 -1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color:#000000" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
881 +1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color: rgb(0,0,0);" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
813 813  1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
814 814  1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
815 815  1. Combined warning and error flags
... ... @@ -820,36 +820,41 @@
820 820  
821 821  [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
822 822  
823 -
892 +\\
824 824  {{/info}}
825 825  
895 +\\
826 826  
827 -All values for the GMD are also available for the** HALL GMD **which is located in the experimental hall down stream the gas attenuator. If the attenuator is on the ratio between Hall and Tunnel signal shows the attenuation. **BUT NOTE** that the filter unit and the Aperture 4 are downstream the GMD. So if filters and aperture are used this influence is NOT measured by the GMD hall !
897 +All values for the GMD are also available for the** HALL GMD **which is located in the experimental hall down stream the gas attenuator. If the attenuator is on the ratio between Hall and Tunnel signal shows the attenuation. **BUT NOTE** that the filter unit and the Aperture 4 are downstream the GMD. So if filters and aperture are used this influence is NOT measured by the GMD hall !
828 828  
899 +\\
829 829  
830 830  Besides  pulse energy the GMD also provides information about the beam position
831 831  
903 +\\
832 832  
833 -{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel horizontal{{/code}}
834 -//always saved (PBD2)//
835 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
836 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
837 -desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
905 +{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel horizontal{{/code}}
906 +//always saved (PBD2)//
907 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
908 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
909 +desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
838 838  units : mm
839 839  
912 +\\
840 840  
841 -{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel vertical{{/code}}
842 -//always saved (PBD2)//
843 -DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
844 -DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
845 -desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
914 +{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel vertical{{/code}}
915 +//always saved (PBD2)//
916 +DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
917 +DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
918 +desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
846 846  units : mm
847 847  
921 +\\
848 848  
849 -/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel x
923 +/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel x
850 850  always saved (PBD2)
851 851  DOOCS prop : FLASH.FEL/XGM.BPM/FL2.HALL/X.TD
852 -DAQ channel: FLASH.FEL/XGM.BPM/FL2.HALL:2
926 +DAQ channel: FLASH.FEL/XGM.BPM/FL2.HALL:2
853 853  desc: Besides the well calibrated averaged beam position information there is also the option to measure the beam position on a single bunch level. HOWEVER this methide needs a perfectly adjusted signal level (talk to your local contact !!) and also then the signal to noise is rather small and one needs some averaging ... BUT with this option one can determine if there was a spatial slope on a burst (say forst bunches were lower than the last ones or so ...)
854 854  units : mm   
855 855  
... ... @@ -857,7 +857,9 @@
857 857  
858 858  again the same parameter set is available for the **HALL GMD**
859 859  
934 +\\
860 860  
936 +\\
861 861  
862 862  ==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
863 863  
... ... @@ -865,75 +865,84 @@
865 865  
866 866  (The OPIS hall is not installed yet ...)
867 867  
944 +\\
868 868  
869 869  {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean photon energy{{/code}}
870 -// saved opon request (PBD2)//
871 -DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
872 -DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
947 +// saved opon request (PBD2)//
948 +DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
949 +DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
873 873  desc : mean photon energy ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
874 874  units : eV
875 875  
953 +\\
876 876  
877 877  {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelength{{/code}}
878 -// saved opon request (PBD2)//
879 -DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
956 +// saved opon request (PBD2)//
957 +DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
880 880  DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
881 881  desc : mean wavelength ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
882 882  units : nm
883 883  
962 +\\
884 884  
885 885  {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/number of analyzed bunch        (in older version this can be found in OPIS tunnel/Expert stuff/General operation parameters/){{/code}}
886 -// saved opon request (PBD2)//
887 -DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
965 +// saved opon request (PBD2)//
966 +DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
888 888  DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
889 889  desc : The bunch number of the bunch used for the wavelength calculation
890 890  units :
891 891  
971 +\\
892 892  
893 893  If Opis is running typically on the the averaged data is saved. For several experiments it may make sense to save the information for each single bunch. This is up to now done by saving the complete ADC trace of the TOF setup. This is a huge amount of data and needs processing. This has to be performed after the beamtime in close contact to [[Markus Braune>>mailto:markus.braune@desy.de||shape="rect"]] ( responsible for [[OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]])
894 894  
975 +\\
895 895  
896 896  In case OPIS was not operating there is still information 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 ...
897 897  
979 +\\
898 898  
981 +\\
899 899  
900 900  ==== Electron Beam properties (FLASH2) ====
901 901  
902 902  ===== bunch charge =====
903 903  
904 -{{code language="none"}}/FL2/Electron Diagnostic/Bunch charge/after undulator{{/code}}
905 -//always saved (PBD2)//
987 +{{code language="none"}}/FL2/Electron Diagnostic/Bunch charge/after undulator{{/code}}
988 +//always saved (PBD2)//
906 906  DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
907 -DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
908 -desc: electron bunch charge FLASH2 (average value for each bunchtrain).
990 +DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
991 +desc: electron bunch charge FLASH2 (average value for each bunchtrain).
909 909  units: nC
910 910  
994 +\\
911 911  
912 912  ===== electron bunch energy =====
913 913  
914 914  {{code language="none"}}/FL2/Electron Diagnostic/Electron energy/energy of first bunch/behind undulators{{/code}}
915 -//always saved (PBD2)//
999 +//always saved (PBD2)//
916 916  DOOCS prop : {{code language="none"}}FLASH.DIAG/BEAM_ENERGY_MEASUREMENT/FL2XTDS/ENERGY.FLASH2{{/code}}
917 -DAQ channel: (% style="color:#5e6c84" %)TTF2.DAQ/PBD2.BEAM.ENERGY.MEAS.ML.COPY/FL2XTDS.ENERGY.FLASH2{{code language="none"}}{{/code}}(%%)
918 -desc: electron bunch energy measured behind the undulator. Data is saved with 10 Hz - BUT (for computation reasons) only the energy of the FIRST bunch is recorded. The data is also available for (% style="color:#5e6c84" %)extraction and septum  in the beginning of FLASH2
1001 +DAQ channel: (% style="color: rgb(94,108,132);" %)TTF2.DAQ/PBD2.BEAM.ENERGY.MEAS.ML.COPY/FL2XTDS.ENERGY.FLASH2{{code language="none"}}{{/code}}(%%)
1002 +desc: electron bunch energy measured behind the undulator. Data is saved with 10 Hz - BUT (for computation reasons) only the energy of the FIRST bunch is recorded. The data is also available for (% style="color: rgb(94,108,132);" %)extraction and septum  in the beginning of FLASH2
919 919  
920 -(% style="letter-spacing:0.0px" %)units: (% class="twikiNewLink" %)MeV
1004 +(% style="letter-spacing: 0.0px;" %)units: (% class="twikiNewLink" %)MeV
921 921  
1006 +\\
922 922  
923 -(% style="color: rgb(94, 108, 132); font-weight: 600; letter-spacing: 0px;" %)
924 -===== undulator settings =====
1008 +(% style="color: rgb(94,108,132);font-weight: 600;letter-spacing: 0.0px;" %)
1009 +undulator settings
925 925  
926 -{{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/set wavelength{{/code}}
927 -//always saved (PBD2)//
1011 +{{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/set wavelength{{/code}}
1012 +//always saved (PBD2)//
928 928  DOOCS prop : {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
929 -DAQ channel:  {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
1014 +DAQ channel:  {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
930 930  desc: Set value for the anticipated wavelength . This parameter is used to set the undulator gap. It may however deviate from the actual wavelength by several % ...
931 931  units: nm
932 932  
933 -{{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/SASE14 gap{{/code}}
934 -//always saved (PBD2)//
1018 +{{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/SASE14 gap{{/code}}
1019 +//always saved (PBD2)//
935 935  DOOCS prop : {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
936 -DAQ channel:  {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
1021 +DAQ channel:  {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
937 937  desc: gap value of the undulators. This can be used to follow up how many undulators were closed and if there was a taper
938 938  units: mm
939 939  
... ... @@ -942,219 +942,201 @@
942 942  =====
943 943  arrival time (BAM) =====
944 944  
945 -{{info title="BAM information: updates 2022 (status 2025)"}}
946 -* see: [[Info collection about the BAMs and how to use the BAM data>>doc:FS-FLASH USER tmp.jddd-linked help pages.Info collection for the BAM.WebHome||shape="rect"]]
1030 +{{info title="BAM information: updates 2022"}}
1031 +* see: [[Info collection about the BAMs and how to use the BAM data>>url:https://confluence.desy.de/display/FLASHUSER/Info+collection+for+the+BAM||shape="rect"]]
947 947  * The data format of the BAM has been completely altered in the 2022 shutdown
948 -* before 2022 BAMs were always saving the arrival time information for each 1µs bucked regardless if there were electrons in the accelerator or not. IN addition the arrival times for  FL1 and FL2 were saved in the same parameter ...
1033 +* before 2022 BAMs were always saving the arrival time information for each 1µs bucked regardless if there were electrons in the accelerator or not. I addition the arrival times for  FL1 and FL2 were saved in the same parameter ...
949 949  * THIS is now different. There are new parameters saving only the arrival times for pulses that go to FL1 and to FL2 (in detail: first time slot of the accelerator and second)
950 950  * There has been also a renaming  (and relocation) of the BAMs.
951 951  ** acc:  4DBC3 → FL0.DBC2
952 952  ** FL1: 1SFELC →  FL1.SFELC
953 -** FL2: FL2XTDS → (% style="color:#172b4d" %)FL2.SEED5
954 -* for more Info: [[LINK to detailed infos from MSK>>doc:SDiag.How-to articles.BAM Data Structure.WebHome||shape="rect"]]
955 -* [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments>>doc:FS-FLASH USER tmp.Additional helpful things1.FLASH beamlines and instruments references.WebHome]]
1038 +** FL2: 8FL2XTDS → (% style="color: rgb(23,43,77);" %)FL2.SEED5
1039 +* for more Info: [[LINK to detailed infos from MSK>>url:https://confluence.desy.de/display/SDiagPublic/BAM+Data+Structure||shape="rect"]]
1040 +* [[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]]
956 956  * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
957 957  {{/info}}
958 958  
1044 +\\
1045 +
959 959  {{expand title="Discontinued BAM format (used until end 2021)"}}
960 -(% style="color:#000000" %)**Discontinued BAM data recording **
1047 +(% style="color: rgb(0,0,0);" %)**Discontinued BAM data recording **
961 961  
962 -{{code language="none"}}/FL2/Electron Diagnostic/BAM/8FL2XTDS/electron bunch arrival time (low charge){{/code}}
963 -//always saved (PBD2)//
964 -DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/8FL2XTDS/LOW_CHARGE_ARRIVAL_TIME{{/code}}
965 -DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/8FL2XTDS.LOW_CHARGE_ARRIVAL_TIME{{/code}}
966 -desc: Electron bunch arrival time measured with the BAM after the FLASH2 undulator (pulse resolved data)
1049 +{{code language="none"}}/FL2/Electron Diagnostic/BAM/8FL2XTDS/electron bunch arrival time (low charge){{/code}}
1050 +//always saved (PBD2)//
1051 +DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/8FL2XTDS/LOW_CHARGE_ARRIVAL_TIME{{/code}}
1052 +DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/8FL2XTDS.LOW_CHARGE_ARRIVAL_TIME{{/code}}
1053 +desc: Electron bunch arrival time measured with the BAM after the FLASH2 undulator (pulse resolved data)
967 967  units: ps (bigger numbers indicate later arrivaltime of the electrons)
968 968  
969 -**FL1**{{code language="none"}}//Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
970 -//always saved (PBD2)//
971 -DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
972 -DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
973 -desc: Electron bunch arrival time measured with the BAM  in the accelerator  (pulse resolved data)
1056 +**FL1**{{code language="none"}}//Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
1057 +//always saved (PBD2)//
1058 +DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
1059 +DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
1060 +desc: Electron bunch arrival time measured with the BAM  in the accelerator  (pulse resolved data)
974 974  units: ps (bigger numbers indicate later arrivaltime of the electrons)
975 975  
1063 +\\
1064 +
976 976  {{info title="BAM hints"}}
977 -* The BAM 4DBC3 measures the arrivaltime of** FLASH 1 and FLASH2** in the same data set (thus also sorted in at /FL1/ !).
1066 +* The BAM 4DBC3 measures the arrivaltime of** FLASH 1 and FLASH2** in the same data set (thus also sorted in at /FL1/ !).
978 978  * 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 
979 979  ** 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
980 -* [[Link a collection of papers related to the BAM and the analysis of pump-probe experiments >>doc:FS-FLASH USER tmp.Additional helpful things1.FLASH beamlines and instruments references.WebHome]]
981 -* [[LINK to detailed infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|height="12" width="13"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]]
1069 +* [[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]]
1070 +* [[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"]]
982 982  * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
983 983  {{/info}}
984 984  {{/expand}}
985 985  
1075 +\\
986 986  
987 987  ====== **BAM FL0.DBC2**{{code language="none"}}{{/code}} ======
988 988  
989 -(% style="color:#ff6600" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}
990 -
991 -{{code language="none"}}
992 -/zraw/FLASH.SDIAG/BAM.DAQ/FL0.DBC2.ARRIVAL_TIME.ABSOLUTE.SA2.COMP/dGroup/
993 -{{/code}}
994 -
1079 +(% style="color: rgb(255,102,0);" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)(%%)
995 995  //always saved (PBD)//
996 996  **FL0.DBC2**
997 -(% style="color:#000000" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA2.COMP
998 -{{code language="none"}} DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA2.COMPDAQ {{/code}}(% style="letter-spacing:0.0px" %)desc: Electron bunch arrival time measured with the BAM inside the accelerator (after bunch compressor 2). The property contains only the arrival time of the bunches sent to FL2 (e.g. if there are 30 bunches in FL2 the first 30 values are the arrival time the remaining numbers still may have arbitrary numbers looking like a signal which they are not0). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
1082 +(% style="color: rgb(0,0,0);" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA2.COMP
1083 +{{code language="none"}}/FL2/Electron Diagnostic/BAM/ DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA2.COMPDAQ {{/code}}(% style="letter-spacing: 0.0px;" %)desc: Electron bunch arrival time measured with the BAM inside the accelerator (after bunch compressor 2). The property contains only the arrival time of the bunches sent to FL2 (e.g. if there are 30 bunches in FL2 the first 30 values are the arrival time the remaining numbers should be only 0). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
999 999  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1000 1000  
1086 +\\
1001 1001  
1002 -(% style="color:#ff6600" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}
1003 -
1004 -{{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.DBC2.ARRIVAL_TIME.ABSOLUTE.SA2/dGroup/{{/code}}
1005 -//always saved (PBD)//
1088 +(% style="color: rgb(255,102,0);" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}(%%)
1089 +//always saved (PBD)//
1006 1006  {{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE{{/code}}
1007 -(% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel: {{/code}}(%%)
1091 +(% style="color: rgb(0,0,0);" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel: {{/code}}(%%)
1008 1008  desc: Electron bunch arrival time measured with the BAM inside the accelerator (after bunch compressor 2). Here the complete bunch train from the FEL is recorded (FLASH1 and FLASH2 pulses). Thus there are values from FLASH 2 in the second part. they may be separated by several "0" values if the reprate is different from 1 MHz ...  - It shows a very good correlation to the arrival time  of the XUV pulses in the experiment (see help). 
1009 1009  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1010 1010  
1095 +\\
1011 1011  
1012 -DBC2/error (% style="color:#f39c12" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1013 -//always saved (PBD)//
1014 -DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.bamError.2
1015 -DAQ channel: FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR.2
1016 -desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
1097 +(% style="color: rgb(255,102,0);" %)DBC2/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}(%%)
1098 +//always saved (PBD)//
1099 +(% style="color: rgb(0,0,0);" %)E.bamError{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM{{/code}}(%%)
1100 +(% style="color: rgb(0,0,0);" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR{{code language="none"}}DAQ channel: {{/code}}(%%)
1101 +desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
1017 1017  
1018 -DBC2/status  (% style="color:#e67e22" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1019 -//always saved (PBD)//
1020 -DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.bamStatus.//2//
1021 -DAQ channel: FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.2
1022 -desc:  status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
1103 +\\
1023 1023  
1105 +(% style="color: rgb(255,102,0);" %)DBC2/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}(%%)
1106 +//always saved (PBD)//
1107 +(% style="color: rgb(0,0,0);" %)E..bamStatus.//2//{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM{{/code}}(%%)
1108 +(% style="color: rgb(0,0,0);" %): FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.2{{code language="none"}}DAQ channel{{/code}}(%%)
1109 +desc: status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
1024 1024  
1111 +\\
1025 1025  
1026 1026  ====== **BAM FL2.SEED5**{{code language="none"}}{{/code}} ======
1027 1027  
1028 -/FL2/Electron Diagnostic/BAM/**SEED5**(% style="color:#ff6600" %)/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)
1115 +/FL2/Electron Diagnostic/BAM/**SEED5**(% style="color: rgb(255,102,0);" %)/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)
1029 1029  
1030 -(% style="color:#000000" %){{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.SEED5.ARRIVAL_TIME.ABSOLUTE.SA2.COMP/dGroup/{{/code}}
1031 -
1032 1032  //always saved (PBD)//
1033 -(% style="color:#172b4d" %)**FL2.SEED5**(%%)
1034 -(% style="color:#000000" %)channel: FLASH.SDIAG/BAM/(% style="color:#172b4d" %)**FL2.SEED5**(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
1035 -{{code language="none"}} DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA1.COMPDAQ {{/code}}(%%)desc: Electron bunch arrival time measured  with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.. The property contains only the arrival time of the bunches sent to FL2 (e.g. if there are 30 bunches in FL2 the first 30 values are the arrival time the remaining numbers still may have arbitrary numbers looking like a signal which they are not). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
1118 +(% style="color: rgb(23,43,77);" %)**FL2.SEED5**(%%)
1119 +(% style="color: rgb(0,0,0);" %)channel: FLASH.SDIAG/BAM/(% style="color: rgb(0, 0, 0); color: rgb(23, 43, 77)" %)**FL2.SEED5**(% style="color: rgb(0,0,0);" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
1120 +{{code language="none"}} DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE.SA1.COMPDAQ {{/code}}(%%)desc: Electron bunch arrival time measured  with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.. The property contains only the arrival time of the bunches sent to FL2 (e.g. if there are 30 bunches in FL2 the first 30 values are the arrival time the remaining numbers should be only 0). These are the same values as the "raw" data below - just "cleaned". The values show a very good correlation to the arrival time  of the XUV pulses in the experiment (see help).
1036 1036  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1037 1037  
1123 +\\
1038 1038  
1125 +\\
1039 1039  
1040 -(% style="color:#172b4d" %)SEED5(% style="color:#ff6600" %)/electron bunch arrival time (raw) (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}
1041 -
1042 -(% style="color:#000000" %){{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.SEED5.ARRIVAL_TIME.ABSOLUTE.SA2/dGroup/{{/code}}(%%)
1043 -//always saved (PBD)//
1044 -(% style="color:#172b4d" %)**FL2.SEED5**{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE{{/code}}(%%)
1045 -**~ **(% style="color:#000000" %)FLASH.SDIAG/BAM/(% style="color:#172b4d" %)**FL2.SEED5**(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel:{{/code}}(%%)
1127 +(% style="color: rgb(23,43,77);" %)SEED5(% style="color: rgb(255,102,0);" %)/electron bunch arrival time (raw) (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}(%%)
1128 +//always saved (PBD)//
1129 +(% style="color: rgb(23,43,77);" %)**FL2.SEED5**{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE{{/code}}(%%)
1130 +**~ **(% style="color: rgb(0,0,0);" %)FLASH.SDIAG/BAM/(% style="color: rgb(0, 0, 0); color: rgb(23, 43, 77)" %)**FL2.SEED5**(% style="color: rgb(0,0,0);" %)/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel:{{/code}}(%%)
1046 1046  desc: Electron bunch arrival time measured  with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020. Here the complete bunch train from the FEL is recorded (FLASH1 and FLASH2 pulses). Thus there are values from FLASH 2 in the second part. they may be separated by several "0" values if the reprate is different from 1 MHz ...  - It shows a very good correlation to the arrival time  of the XUV pulses in the experiment (see help). 
1047 1047  units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1048 1048  
1134 +\\
1049 1049  
1050 -FL2.SEED5/error (% style="color:#f39c12" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1051 -//always saved (PBD)//
1052 -DOOCS prop : FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.bamError.2
1053 -DAQ channel: FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.BAMERROR.2
1054 -desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
1136 +(% style="color: rgb(23,43,77);" %)SEED5(% style="color: rgb(255,102,0);" %)/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}(%%)
1137 +//always saved (PBD)//
1138 +(% style="color: rgb(23,43,77);" %)**FL2.SEED5**(% style="color: rgb(0,0,0);" %)E.bamError{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIM{{/code}}(%%)
1139 +(% style="color: rgb(0,0,0);" %): FLASH.SDIAG/BAM/(% style="color: rgb(0, 0, 0); color: rgb(23, 43, 77)" %)**FL2.SEED5**(% style="color: rgb(0,0,0);" %)/ARRIVAL_TIME.BAMERROR{{code language="none"}}DAQ channel{{/code}}(%%)
1140 +desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
1055 1055  
1056 -FL2.SEED5/status  (% style="color:#e67e22" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1057 -//always saved (PBD)//
1058 -DOOCS prop : FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.bamStatus.//2//
1059 -DAQ channel: FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.BAMSTATUS.2
1060 -desc:  status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
1142 +\\
1061 1061  
1144 +(% style="color: rgb(23,43,77);" %)SEED5(% style="color: rgb(255,102,0);" %)/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}(%%)
1145 +//always saved (PBD)//
1146 +(% style="color: rgb(23,43,77);" %)**FL2.SEED5**(% style="color: rgb(0,0,0);" %)E.bamStatus.//2//{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIM{{/code}}(%%)
1147 +(% style="color: rgb(0,0,0);" %)el: FLASH.SDIAG/BAM/(% style="color: rgb(0, 0, 0); color: rgb(23, 43, 77)" %)**FL2.SEED5**(% style="color: rgb(0,0,0);" %)/ARRIVAL_TIME.BAMSTATUS.2{{code language="none"}}DAQ chann{{/code}}(%%)
1148 +desc: status bit: 0 - data is valid; 1 - beam present; 2 - calibration ongoing; 3 - feedback enabled; 4 - feedback acting;  mostly check for bit 0 == 1 is sufficient
1062 1062  
1150 +\\
1151 +
1063 1063  [[Contents>>doc:||anchor="Contents"]]
1064 1064  
1154 +\\
1065 1065  
1066 1066  ==== Timing information, rep rate etc.  (FLASH2) ====
1067 1067  
1068 1068  ===== start time of FLASH2 =====
1069 1069  
1070 -{{code language="none"}}/FL2/Timing/start time flash2{{/code}}
1071 -//always saved (PBD2)//
1072 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
1073 -DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
1160 +{{code language="none"}}/FL2/Timing/start time flash2{{/code}}
1161 +//always saved (PBD2)//
1162 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
1163 +DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
1074 1074  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 ...)
1075 1075  units: µs
1076 1076  
1077 1077  ===== bunch repetition rate =====
1078 1078  
1079 -{{code language="none"}}/FL2/Timing/repetition rate{{/code}}
1080 -//always saved (PBD2)//
1081 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
1082 -DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
1169 +{{code language="none"}}/FL2/Timing/repetition rate{{/code}}
1170 +//always saved (PBD2)//
1171 +DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
1172 +DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
1083 1083  desc: repetition rate of the bunches / pulses within the burst (FLASH2)
1084 1084  units: kHz
1085 1085  
1086 -
1087 -===== set number of pulses =====
1088 -
1089 -(% style="color:#ff6600" %)(HDF5 name not yet implemented - see zraw)(% style="color:#ff0000" %){{code language="none"}}/FL2/Timing/set number of bunches {{/code}}(%%)
1090 -//always saved (PBD2)//
1091 -DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.2 [4th number]{{/code}}
1092 -DAQ channel: {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.2 [4th number]{{/code}}
1093 -desc: Number of bunches set in the control (timing) system.  The property contains 4 numbers. the last one is the number of pulses (see also [[doc:FLASH.Timing properties]] (internal link)).  If pulses are used for diagnostic of the protection system of the accelerator limits the number of bunches to be accelerated and thus the actual number of pulses may be smaller than the set one 
1094 -units:
1095 -
1096 1096  ===== actual number of pulses =====
1097 1097  
1098 -{{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
1099 -//always saved (PBD2)//
1100 -DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1101 -DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1102 -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)
1178 +{{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
1179 +//always saved (PBD2)//
1180 +DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1181 +DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1182 +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)
1103 1103  units:
1184 +\\
1104 1104  
1105 1105  ===== actual pulse pattern recorded after the undulator =====
1106 1106  
1107 -{{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
1108 -//always saved (PBD2)//
1109 -DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1110 -DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1111 -desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH2)
1188 +{{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
1189 +//always saved (PBD2)//
1190 +DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1191 +DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1192 +desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH2)
1112 1112  units:
1194 +\\
1113 1113  
1114 1114  ===== Train ID =====
1115 1115  
1116 -{{code language="none"}}/Timing/train ID{{/code}}
1117 -//always saved (PBD2)//
1118 -DOOCS prop : {{code language="none"}}none{{/code}}
1119 -DAQ channel: {{code language="none"}}none{{/code}}
1120 -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 !)
1198 +{{code language="none"}}/Timing/train ID{{/code}}
1199 +//always saved (PBD2)//
1200 +DOOCS prop : {{code language="none"}}none{{/code}}
1201 +DAQ channel: {{code language="none"}}none{{/code}}
1202 +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 !)
1121 1121  units:
1204 +\\
1122 1122  
1123 -===== (% style="color:#e67e22" %)Train time(%%) =====
1206 +===== Train time =====
1124 1124  
1125 -(% style="color:#e67e22" %)//always saved (PBD2)//(%%)
1126 -(% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
1127 -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
1208 +//always saved (PBD2)
1209 +//{{code language="none"}}/Timing/train time{{/code}}
1210 +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
1128 1128  units: d h min s cs
1212 +\\
1129 1129  
1130 -{{code language="none"}}
1131 -/Timing/time stamp
1132 -{{/code}}
1214 +{{code language="none"}}/Timing/time stamp{{/code}}
1133 1133  
1134 -(% style="color:#e67e22" %)//always saved (PBD2)//(%%)
1135 -(% style="color:#e67e22" %)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
1136 -second column: microseconds
1216 +//always saved (PBD2)//
1217 +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
1218 +second column: microseconds
1137 1137  third column: Train ID of FLASH
1220 +\\
1138 1138  
1139 -
1140 -(% id="cke_bm_2455529S" style="display:none" %) (%%)currently it is saved as Unix time in : /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time
1141 -
1142 -{{expand expanded="false" title="Timestamp help for python"}}
1143 - import time
1144 -
1145 -# epoch time is found in /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time #!!! a leading 1 has to be added !!!
1146 -# The time and date of the start of the data taking in the HDF file is encoded in the filename - to roughly check the time
1147 -epoch_time = 1709051499.17 # Replace with your epoch time
1148 -
1149 -formatted_time = time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime(epoch_time))
1150 -print(formatted_time)
1151 -{{/expand}}
1152 -
1153 -
1154 -
1155 -
1156 1156  [[Contents>>doc:||anchor="Contents"]]
1157 1157  
1224 +\\
1158 1158  
1159 1159  ==== User Data (FLASH2) ====
1160 1160  
... ... @@ -1166,15 +1166,16 @@
1166 1166  
1167 1167  ===== GHz ADCs =====
1168 1168  
1169 -ADC traces of the (SPDevices 412) GHZ ADCs available for the users . More information about the ADCs can be found** [[here>>doc:FS-FLASH USER tmp.Data Acquisition and controls 1.Controls (DOOCS, jDDD,\.\.\.).MTCA ADCs.WebHome]]**
1170 -//saved on DEMAND in the user DAQ//
1236 +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]]**
1237 +//saved on DEMAND in the user DAQ//
1171 1171  \\Up to now there are 4 channels available at FL24
1172 1172  \\\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD{{/code}}
1173 1173  {{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH01/TD{{/code}}
1174 1174  \\{{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}}
1175 1175  
1243 +\\
1176 1176  
1177 -DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
1245 +DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
1178 1178  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.
1179 1179  DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
1180 1180  
... ... @@ -1182,14 +1182,14 @@
1182 1182  
1183 1183  * {{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.
1184 1184  * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
1185 -* {{code language="none"}}error (ADC):{{/code}}0 indicates that there was no error
1253 +* {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
1186 1186  * {{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.
1187 1187  
1188 1188  ===== MHz ADCs =====
1189 1189  
1190 -similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
1191 -{{code language="none"}}/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH2/TD{{/code}}
1192 -DOOCS prop : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02/CH00.TD
1258 +similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
1259 +{{code language="none"}}/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH2/TD{{/code}}
1260 +DOOCS prop : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02/CH00.TD
1193 1193  DAQ channel: : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02
1194 1194  
1195 1195  In addition there are also additional parameters saved like:
... ... @@ -1199,405 +1199,144 @@
1199 1199  
1200 1200  [[Contents>>doc:||anchor="Contents"]]
1201 1201  
1270 +\\
1202 1202  
1272 +\\
1203 1203  
1204 1204  ==== Pump Probe Laser (FLASH2) ====
1205 1205  
1206 -{{info width="30%"}}
1207 -list of saved parameters status May 2024 (up to now the parameters can be found in /zraw/ ... )
1276 +There may be more information available from the "Laser DAQ". laese contact your Laser Local Contact.
1208 1208  
1209 -[[attach:FSLADAQ-DAQParameterlistULGAN-2.pdf||target="_blank"]]
1278 +\\
1210 1210  
1211 -[[attach:FSLADAQ-DAQParameterlistFL23-2.pdf||target="_blank"]]
1212 -
1213 -[[attach:FSLADAQ-DAQParameterlistFL24-2.pdf||target="_blank"]]
1214 -
1215 -
1216 -{{view-file att--filename="FSLADAQ-DAQParameterlistFL23-2.pdf"}}{{/view-file}}
1217 -
1218 -
1219 -{{view-file att--filename="FSLADAQ-DAQParameterlistFL23-2.pdf"}}{{/view-file}}
1220 -
1221 -
1222 -{{view-file att--filename="FSLADAQ-DAQParameterlistFL24-2.pdf"}}{{/view-file}}
1223 -
1224 -
1225 -{{/info}}
1226 -
1227 -{{expand title="Laser parameters used until 2023"}}
1228 -These are the parameters that can be saved in the FL2 User DAQ for the FL2 PP laser//** FOR BEAMLINE FL24**//
1229 -
1230 1230  **User delay**
1231 1231  
1232 1232  Delay (set value):
1233 1233  
1234 -{{code language="none"}}
1235 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR
1236 -{{/code}}
1284 +{{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR{{/code}}
1237 1237  
1238 -Delay (readback):
1286 +Delay (encoder readback):
1239 1239  
1240 -{{code language="none"}}
1241 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
1242 -{{/code}}
1288 +{{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD{{/code}}
1243 1243  
1244 -(% style="letter-spacing:0.0px" %)Delay (encoder readback):
1245 -
1246 -{{code language="none"}}
1247 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.ENCODER_POSITION.RD
1248 -{{/code}}
1249 -
1250 1250  OXC. jitter:
1251 1251  
1252 -{{code language="none"}}
1253 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
1254 -{{/code}}
1292 +{{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD{{/code}}
1255 1255  
1294 +\\
1256 1256  
1296 +**Pulse resolved energy:**
1257 1257  
1258 -**FL24 Pulse resolved energy:**
1298 +1a) OPCPA output:
1259 1259  
1260 -OPCPA output (photodiode signal raw ADC trace 16000 samples):
1300 +{{code language="none"}}FLASH.LASER/TAMC532DMA/ULGAN1/CH23.TD{{/code}}
1261 1261  
1262 -{{code language="none"}}
1263 -/zraw/FLASH.LASER/FLASH2CPUULGAN1.ADCSCOPE/CH23.TD/dGroup
1264 -{{/code}}
1302 +1b) OPCPA energy from PES (only fast channel):
1265 1265  
1266 -(% style="letter-spacing:0.0px" %)Upper breadboard Photodiode (THG) burst (photodiode signal raw ADC trace 16000 samples)::
1304 +FLASH.LASER/CPUULGAN1.PULSEENERGY/OPCPA_Output/DAQ_CHANNEL
1267 1267  
1268 -{{code language="none"}}
1269 -/zraw/FLASH.LASER/FLASH2CPUULGAN1.ADCSCOPE/CH26.TD/dGroup
1270 -{{/code}}
1306 +2a) Upper breadboard Photodiode (THG) burst:
1271 1271  
1272 -Upper breadboard Photodiode (THG) energy (analyzed signal. integration over pulses in the ADC trace. contains for each laser pulse the pulse energy in a.u.)
1308 +{{code language="none"}}FLASH.LASER/TAMC532DMA/ULGAN1/CH26.TD{{/code}}
1273 1273  
1274 -{{code language="none"}}
1275 -/zraw/FLASH.LASER/MOD24.PES/FL24_userPD/dGroup
1276 -{{/code}}
1310 +2b) Upper breadboard Photodiode (THG) energy (in-coupling user photodiode, fast)
1277 1277  
1312 +{{code language="none"}}FLASH.LASER/MOD24.PES/FL24_userPD/DAQ_CHANNEL{{/code}}
1278 1278  
1279 -**FL24 LAM (Laser Arrivaltime Monitor)  pulse resolved data:**
1314 +\\
1280 1280  
1281 -Signal of Photodiode1  - for experts only... (analyzed signal. integration over pulses in the ADC trace. )
1316 +**Attenuator angle:**
1282 1282  
1283 -{{code language="none"}}
1284 -/zraw/FLASH.LASER/MOD24.PES/LAM.PD1/dGroup
1285 -{{/code}}
1318 +{{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1286 1286  
1287 -Signal of Photodiode2  - for experts only...  (analyzed signal. integration over pulses in the ADC trace.)
1320 +**Polarization control:**
1288 1288  
1289 -{{code language="none"}}
1290 -/zraw/FLASH.LASER/MOD24.PES/LAM.PD2/dGroup
1291 -{{/code}}
1322 +{{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR14.FL24/FPOS{{/code}}
1292 1292  
1293 -"Actual" LAM Signal - to be calibrated ......  (analyzed signal. integration over pulses in the ADC trace.)
1294 -
1295 -{{code language="none"}}
1296 -/zraw/FLASH.LASER/MOD24.PES/LAM.PDBAL/dGroup
1297 -{{/code}}
1298 -
1299 -The delay feedback(% style="letter-spacing:0.0px" %)
1300 -
1301 -{{code language="none"}}
1302 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26 
1303 -{{/code}}
1304 -
1305 -The LAM delay feedback(% style="letter-spacing:0.0px" %) (the pulse energy signal, which is saved in the above but maybe it’s good to have this also as slow, in the case these two numbers are not the same the sysdc was active instead of the LAM):
1306 -
1307 -{{code language="none"}}
1308 -FLASH.LASER/MOD24.PES/LAM.PDBAL/PULSEENERGY.MEAN
1309 -{{/code}}
1310 -
1311 -LAM Delay line act:
1312 -
1313 -{{code language="none"}}FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.POSITION.RD{{/code}}
1314 -LAM Delay line set:
1315 -
1316 -{{code language="none"}}
1317 -FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.POSITION_SET.WR
1318 -{{/code}}
1319 -
1320 -LAM Delay line encoder:
1321 -
1322 -{{code language="none"}}
1323 -FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.ENCODER_POSITION.RD
1324 -{{/code}}
1325 -
1326 -Temperature feedback:
1327 -
1328 -{{code language="none"}}
1329 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE24
1330 -{{/code}}
1331 -
1332 -**Feedback mode** (if this is not =1 the delay FB is not active, then it’s either temp feedback controlled or failsave, maybe it’s good to have):
1333 -
1334 -{{code language="none"}}
1335 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.INTS/INTEGER30
1336 -{{/code}}
1337 -
1338 -
1339 -**FL24 Attenuator angle:**
1340 -
1341 -{{code language="none"}}
1342 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
1343 -{{/code}}
1344 -
1345 -**FL24 Polarization control:**
1346 -
1347 -{{code language="none"}}
1348 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR14.FL24/FPOS
1349 -{{/code}}
1350 -
1351 1351  **SysDC delay error:**
1352 1352  
1353 -{{code language="none"}}
1354 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26
1355 -{{/code}}
1326 +{{code language="none"}}FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26{{/code}}
1356 1356  
1328 +\\
1357 1357  
1358 1358  **Timing error: (these two need to be observed and both=0 means no error)**
1359 1359  
1360 -{{code language="none"}}
1361 -FLASH/CPUULGAN1.TIMING/ULGAN1/dT_alarm
1362 -{{/code}}
1332 +{{code language="none"}}FLASH/CPUULGAN1.TIMING/ULGAN1/dT_alarm{{/code}}
1363 1363  
1364 -{{code language="none"}}
1365 -FLASH/CPUULGAN1.TIMING/ULGAN1/dMPN
1366 -{{/code}}
1334 +{{code language="none"}}FLASH/CPUULGAN1.TIMING/ULGAN1/dMPN{{/code}}
1367 1367  
1368 1368  **Laser error status:**
1369 1369  
1338 +\\
1370 1370  
1371 -**FL24 Virtual camera X and Y history, beam size: (use slow data)**
1340 +**Virtual camera X and Y history, beam size: (use slow data)**
1372 1372  
1373 -{{code language="none"}}
1374 -FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.X
1375 -{{/code}}
1342 +{{code language="none"}}FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.X{{/code}}
1376 1376  
1377 -{{code language="none"}}
1378 -FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.Y
1379 -{{/code}}
1344 +{{code language="none"}}FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.Y{{/code}}
1380 1380  
1381 -{{code language="none"}}
1382 -FLASH.LASER/MOD24.CAM/UV.14.VF/ROI_SPECTRUM.X.SIG
1383 -{{/code}}
1346 +{{code language="none"}}FLASH.LASER/MOD24.CAM/UV.14.VF/ROI_SPECTRUM.X.SIG{{/code}}
1384 1384  
1348 +\\
1349 +
1385 1385  {{expand title="Parameters used until 2021"}}
1386 -//{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}always saved (PBD2)//
1387 -DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1388 -DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1389 -desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1351 +
1352 +{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}//always saved (PBD2)//
1353 +DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1354 +DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1355 +desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1390 1390  units : deg.
1391 1391  
1358 +\\
1392 1392  
1393 1393  
1394 -//{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/polarization position{{/code}}always saved (PBD2)//
1395 -DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1396 -DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1397 -desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1361 +{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/polarization position{{/code}}//always saved (PBD2)//
1362 +DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1363 +DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1364 +desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1398 1398  units : deg.
1399 1399  
1367 +\\
1400 1400  
1401 -{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay readback{{/code}}
1402 -//always saved (PBD2)//
1403 -DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1369 +{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay readback{{/code}}
1370 +//always saved (PBD2)//
1371 +DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1404 1404  DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1405 1405  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)
1406 1406  units : ps )
1407 1407  
1376 +\\
1408 1408  
1409 -{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
1410 -//always saved (PBD)//
1411 -DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1412 -DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1378 +{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
1379 +//always saved (PBD)//
1380 +DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1381 +DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1413 1413  desc: rms jitter of the fs-Oscillator
1414 1414  units: fs
1415 1415  {{/expand}}
1416 1416  
1386 +[[Contents>>doc:||anchor="Contents"]]
1417 1417  
1418 -==== FL 26 Pump Probe Laser (FLASH2) ====
1388 +\\
1419 1419  
1420 -These are the parameters that can be saved in the FL2 User DAQ for the FL2 PP laser//** FOR BEAMLINE FL26**//
1421 -
1422 -
1423 -**User delay**
1424 -
1425 -Delay (set value):
1426 -
1427 -{{code language="none"}}
1428 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR
1429 -{{/code}}
1430 -
1431 -Delay (readback):
1432 -
1433 -{{code language="none"}}
1434 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
1435 -{{/code}}
1436 -
1437 -Delay (encoder readback):
1438 -
1439 -{{code language="none"}}
1440 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.ENCODER_POSITION.RD
1441 -{{/code}}
1442 -
1443 -OXC. jitter:
1444 -
1445 -{{code language="none"}}
1446 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
1447 -{{/code}}
1448 -
1449 -
1450 -**Parameters for FL26**
1451 -
1452 -(% class="wrapped" %)
1453 -|(((
1454 -FL2PPL FL26 REMI Attenuation: HWP motor current position
1455 -)))|(((
1456 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR11.FL26B/FPOS
1457 -)))
1458 -|(((
1459 -FL2PPL FL26 REMI Polarization: linear polarization angle
1460 -)))|(((
1461 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR12.FL26B/FPOS
1462 -)))
1463 -|(((
1464 -FL2PPL FL26 REMI Diagnostics: NIR spectrum
1465 -)))|(((
1466 -FLASH.LASER/MOD26.SPECT/REMI/DAQ_CHANNEL
1467 -)))
1468 -|(((
1469 -FL2PPL FL26 REMI Diagnostics: photo diode input MOD2.6 - pulse energy mean
1470 -)))|(((
1471 -FLASH.LASER/MOD26.PES/RE_OUT/PULSEENERGY.MEAN
1472 -)))
1473 -|(((
1474 -FL2PPL FL26 REMI Diagnostics: photo diode input MOD2.6 - intra burst pulse energy
1475 -)))|(((
1476 -FLASH.LASER/MOD26.PES/RE_OUT/DAQ_CHANNEL
1477 -)))
1478 -|(((
1479 -FL2PPL FL26 REMI Diagnostics: photo diode input MOD2.6 - raw adc
1480 -)))|(((
1481 -FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH04.TD
1482 -)))
1483 -|(((
1484 -FL2PPL FL26 REMI Diagnostics: photo diode input REMI - pulse energy mean
1485 -)))|(((
1486 -FLASH.LASER/MOD26.PES/INC_BOX/PULSEENERGY.MEAN
1487 -)))
1488 -|(((
1489 -FL2PPL FL26 REMI Diagnostics: photo diode input REMI - intra burst pulse energy
1490 -)))|(((
1491 -FLASH.LASER/MOD26.PES/INC_BOX/DAQ_CHANNEL
1492 -)))
1493 -|(((
1494 -FL2PPL FL26 REMI Diagnostics: photo diode input REMI - raw adc
1495 -)))|(((
1496 -FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH05.TD
1497 -)))
1498 -|(((
1499 -FL2PPL FL26 REMI In coupling: filter wheel 1 position
1500 -)))|(((
1501 -FLASH/MOD26.FW1/FLASH2MOD26/pos
1502 -)))
1503 -|(((
1504 -FL2PPL FL26 REMI In coupling: filter wheel 2 position
1505 -)))|(((
1506 -FLASH/MOD26.FW2/FLASH2MOD26/pos
1507 -)))
1508 -|(((
1509 -FL2PPL FL26 REMI: Energy meter REMI incoupling breadboard
1510 -)))|(((
1511 -FLASH.LASER/MOD26.OPHIRE/REINC.54/DAQ_CHANNEL
1512 -)))
1513 -|(((
1514 -FL2PPL FL26 REMI Incoupling: focusing lens position
1515 -)))|(((
1516 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR3.FL26B/FPOS
1517 -)))
1518 -|(((
1519 -FL2PPL FL26 REMI Incoupling: nearfield
1520 -)))|(((
1521 -FLASH.LASER/MOD26.CAM/REINC.21.NF/DAQ_CHANNEL
1522 -)))
1523 -|(((
1524 -FL2PPL FL26 REMI Incoupling: focus
1525 -)))|(((
1526 -FLASH.LASER/MOD26.CAM/REINC.22.FF/DAQ_CHANNEL
1527 -)))
1528 -|(((
1529 -FL2PPL FL26 REMI Drift: relative arrival time intra burst LAM balanced - calb. in the PES
1530 -)))|(((
1531 -FLASH.LASER/MOD26.PES/LAM_DIFF/DAQ_CHANNEL
1532 -)))
1533 -|(((
1534 -FL2PPL FL26 REMI Drift: forward signal (PD1)  raw
1535 -)))|(((
1536 -FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH00.TD
1537 -)))
1538 -|(((
1539 -FL2PPL FL26 REMI Drift: backward signal (PD2) raw
1540 -)))|(((
1541 -FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH01.TD
1542 -)))
1543 -|(((
1544 -FL2PPL FL26 REMI Drift: mean relative burst arrival time - avarage of the calib value
1545 -)))|(((
1546 -FLASH.LASER/MOD26.PES/LAM_DIFF/PULSEENERGY.MEAN
1547 -)))
1548 -|(((
1549 -FL2PPL FL26 REMI Drift: delay line position (ODL of the LAM REMI)
1550 -)))|(((
1551 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR14.FL26B/FPOS
1552 -)))
1553 -|(((
1554 -FL2PPL FL26 Laser Hutch: delay line position (ODL of the osc. Sync / user delay)
1555 -)))|(((
1556 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
1557 -)))
1558 -|(((
1559 -FL2PPL FL26 REMI Drift: delay line encoder position (ODL REMI raw value)
1560 -)))|(((
1561 -FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.0.ENCODER_POSITION.RD
1562 -)))
1563 -|(((
1564 -Jiiter between oscillator and MLO (inloop jitter osc. Sync)
1565 -)))|(((
1566 -FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
1567 -)))
1568 -|(((
1569 -Temperature controlled fiber (PWM signal to the temperature controlled fiber delay sysdc)
1570 -)))|(((
1571 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE23
1572 -)))
1573 -|(((
1574 -Temperature controlled fiber (Temp of the fiber delay sysdc)
1575 -)))|(((
1576 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE24
1577 -)))
1578 -|(((
1579 -Sydc feedback data if LAM is not activated (sysdc delay)
1580 -)))|(((
1581 -FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26
1582 -)))
1583 -{{/expand}}
1584 -
1585 -
1586 -
1587 1587  === "/uncategorized/" ===
1588 1588  
1589 1589   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
1590 1590  
1394 +\\
1591 1591  
1592 1592  === HDF5 structure revisions ===
1593 1593  
1594 1594  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:
1595 1595  
1400 +\\
1596 1596  
1597 1597  * All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.
1598 1598  * 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".
1599 1599  * A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.
1600 1600  
1406 +\\
1407 +
1601 1601  (% class="wrapped" %)
1602 1602  |=(((
1603 1603  earlier HDF path (vers. 0.2)
... ... @@ -1695,9 +1695,11 @@
1695 1695  /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
1696 1696  )))
1697 1697  
1505 +\\
1506 +
1698 1698  [[Contents>>doc:||anchor="Contents"]]
1699 1699  
1700 -
1509 +\\
1701 1701  {{/layout-cell}}
1702 1702  {{/layout-section}}
1703 1703  {{/layout}}
BAM-basics and outlook-2018_DESY-template_16-9Format.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -3.7 MB
Content
FLASH1__DaqChannel2HdfNamePbd.xlsx
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -22.1 KB
Content
FSLADAQ-DAQParameterlistFL23-2.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -32.1 KB
Content
FSLADAQ-DAQParameterlistFL24-2.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -37.6 KB
Content
FSLADAQ-DAQParameterlistFL24.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -37.2 KB
Content
FSLADAQ-DAQParameterlistPPlaser.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -33.9 KB
Content
FSLADAQ-DAQParameterlistPiGLET-300424-1356-986.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -157.0 KB
Content
FSLADAQ-DAQParameterlistPiGLET.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -157.0 KB
Content
FSLADAQ-DAQParameterlistULGAN-2.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -34.8 KB
Content
FSLADAQ-FL23.pdf
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -28.6 KB
Content
HDF5_structure.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -194.1 KB
Content
HDF5_structure_desc.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -28.3 KB
Content
Screenshot 2024-05-17 094435.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -172.4 KB
Content
binder_badge.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -6.6 KB
Content
image2019-10-21_17-2-50.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -977.2 KB
Content
image2019-10-22_10-52-27.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -642.4 KB
Content
image2020-11-16_15-26-28.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -1.1 MB
Content
image2020-11-16_15-31-45.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -890.0 KB
Content
image2020-11-16_16-26-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -134.5 KB
Content
image2021-2-9_10-51-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.rangeadm
Size
... ... @@ -1,1 +1,0 @@
1 -1.1 MB
Content