Changes for page The FLASH HDF5 structure

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

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