Changes for page The FLASH HDF5 structure

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

From version 97.2
edited by sndueste
on 2025-05-19 17:20
Change comment: There is no comment for this version
To version 68.1
edited by sndueste
on 2023-01-26 15:17
Change comment: There is no comment for this version

Summary

Details

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