Changes for page The FLASH HDF5 structure

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

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