Skip to Content

Wiki source code of The FLASH HDF5 structure

Version 95.1 by sndueste on 2025/05/19 16:53
Show last authors
1 {{layout}}
2 {{layout-section ac:type="single"}}
3 {{layout-cell}}
4 == Contents ==
5
6
7
8 {{toc/}}
9
10
11 == General information about HDF5 ==
12
13 HDF5 is a data format maintained by the HDF group. For detailed general information see [[here>>url:https://portal.hdfgroup.org/display/support||shape="rect"]]
14
15 To download the HDF5 Viewer click [[here>>url:https://portal.hdfgroup.org/display/support/Download+HDFView||shape="rect"]]
16
17 For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :
18 {{code language="none"}}> module load xray{{/code}}
19 {{code language="none"}}> hdfview{{/code}}
20
21 or you can use
22
23 {{code language="none"}}
24 > silx view
25 {{/code}}
26
27
28 [[Contents>>doc:||anchor="Contents"]]
29
30 == The FLASH HDF5 format ==
31
32 FLASH provides a conversion of its data acquisition (DAQ) to the commonly used [[HDF5>>url:https://www.hdfgroup.org/solutions/hdf5/||shape="rect"]] format. Correlated  data are mapped by a primary index called **train ID**. Every data set has an individual index of train IDs to identify the data even when data are missing or deviate in update rate. If the data set of choice contains gaps,  users have to decide how to treat missing values. DAQ channels are spread across various files with one file name pattern for each DAQ. This means users have to assemble data from different files if necessary.
33
34 The hierarchy is realized using a human readable named HDF tree with each DAQ channel containing the data sets "//value//" and "//index//". Additionally, the HDF group //zraw// contains a tree of the original DAQ channel names.
35
36 Reference implementation, which follows the concept of Python libraries like Pandas, Xarray, or Dask, is given below.
37
38 {{expand title="Discontinued HDF formats"}}
39 === Comparison to FLASH's deprecated HDF formats ===
40
41 Before 2021, FLASH provided two different HDF formats formally known as //near-online// and //offline// HDF files.
42
43 All data sets were aligned by the same global index by filling in missing data. Fast DAQ channels  (pulse synchronous data - update 10 Hz) are filled in by NaN or 0, slow channels (not pulse synchronous data - update e.g. 1 Hz ) are interpolated by the DAQs libraries, by keeping the value constant up to the next change.
44
45 While the near-online HDF files were converted live during the beamtime, the offline HDF files were manually compiled weeks/months later. Near-online HDF files were used by a provided API [[BeamtimeDaqAccess>>url:https://confluence.desy.de/display/FLASHUSER/Near-Online+data+analysis#Near-Onlinedataanalysis-BriefUserGuidetoBeamtimeDAQAccess||shape="rect"]], which also searches for DAQ channels in files. With assembled files "by run", all DAQ channels were existing in the same HDF file. While shorter runs usually fitted into one file, longer runs still had to be aggregated over several files. The creation of the assembled type of files still involves the use of fairly unstable DAQ Mex-functions As the environment required for using the Mex-functions is already deprecated, its continued existence is uncertain.
46
47 The HDF hierarchy is almost identical in all formats. While in the the recent format each DAQ channel contains the data sets "value" and "index", the deprecated format had one data set for each DAQ channel. The deprecated formats supplies no time axis parameters for spectra data types.
48
49
50 **HDF5 example files (old format)**
51
52 Here we have a few HDF5 samples (User data combined with Photon diagnostics data) from a few beamtimes showing the different kind options.
53
54 [[image:attach:image2019-10-21_17-2-50.png||thumbnail="true" width="300"]] [[download HDF5 (Images @ FL2)>>url:https://desycloud.desy.de/index.php/s/nyEgeCWJFC4gao2||shape="rect"]]
55
56
57 [[~[~[image:attach:image2019-10-22_10-52-27.png~|~|thumbnail="true" width="300"~]~]download HDF5 (GHz ADC and OPIS @ FL2)>>url:https://desycloud.desy.de/index.php/s/AeA2kPNNnZgX95A||shape="rect"]]
58
59
60
61 {{/expand}}
62
63 === HDF examples: ===
64 {{/layout-cell}}
65 {{/layout-section}}
66
67 {{layout-section ac:type="three_equal"}}
68 {{layout-cell}}
69 * ADC data as example for **fast** **data** (10 Hz):            
70
71 [[image:attach:image2020-11-16_15-26-28.png||height="250"]]
72 {{/layout-cell}}
73
74 {{layout-cell}}
75 * The //average// FEL pulse energy as example for the **slow** **data**. Here the data is not saved with 10 Hz  - thus not for every FEL pulse train.  The data is typically saved with 1 Hz if the values are changing (like the FEL energy) and every about 20 sec if there is no change for longer time ( e.g. motor set values). Thus to use the data together with the "fast" one, one has to interpolate the data as explained in the examples in the repos below show (e.g. {{code language="none"}}df['GMD_T_average'] = df['GMD_T_average'].interpolate(method='linear'){{/code}})
76
77 ( as example only every 10th train ID is listed in the HDF group "index")
78
79 [[image:attach:image2020-11-16_15-31-45.png||height="250"]]
80 {{/layout-cell}}
81
82 {{layout-cell}}
83 * (((
84 //zraw// group contains the **original DAQ (DOOCS) names**
85 )))
86
87 of the properties saved in the DESY internal raw format. (For experts)
88
89
90 [[image:attach:image2020-11-16_16-26-3.png||height="400"]]
91 {{/layout-cell}}
92 {{/layout-section}}
93
94 {{layout-section ac:type="single"}}
95 {{layout-cell}}
96 {{info}}
97 === There are different options that help you to work with the FLASH HDF5 data in Python ===
98
99 * The currently developed option for large data sets: [[the FAB package>>url:https://hasfcpkg.desy.de/fab/fab.html||shape="rect"]] ... see below
100 * and for smaller projects:  (% class="Object" %)[[https:~~/~~/gitlab.desy.de/christopher.passow/flash-daq-hdf>>url:https://gitlab.desy.de/christopher.passow/flash-daq-hdf||shape="rect"]]
101
102 (% class="Object" %)See also the collection of Demo data and sample scripts : [[doc:FS-FLASH USER tmp.Data Acquisition and controls 1.DAQ and controls overview.Offline data analysis (DAQ).Collection of HDF5 sample data from different beamlines.WebHome]] and [[doc:FS-FLASH USER tmp.Data Acquisition and controls 1.DAQ and controls overview.Offline data analysis (DAQ).DEMO - Working with FLASH data.WebHome]]
103 {{/info}}
104 {{/layout-cell}}
105 {{/layout-section}}
106
107 {{layout-section ac:type="single"}}
108 {{layout-cell}}
109
110
111 == Complete list of recordable parameters ==
112
113 The complete list for the relation between DOOCS names and HDF5 names for the recordable parameters can be found in [[DESY's Repository>>url:https://stash.desy.de/projects/CS/repos/pah/browse/src/camp/data/channel2HdfName.dat||shape="rect"]].
114
115 == Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
116
117 {{id name="DOOCSparameters"/}}
118
119
120 === FLASH1 ===
121
122
123 In the Shutdown 2024 / 2025  the complete photon diagnostic and experiment control was renewed and thus the Doocs names and also some HDF5 names had to be changed. The new naming will be documented here as soon as the systems are online again.
124
125 The previously used naming scheme (2024 and before) can be found here:
126
127 {{expand expanded="false" title="FLASH1 Naming scheme used until 2024"}}
128 ==== (% id="cke_bm_8853497S" style="display:none" %) (%%)Beamline info (FLASH1) ====
129
130 {{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}
131 //always saved (PBD)//
132 DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
133 DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
134 desc: set pressure in the gas attenuator
135 units: mbar
136
137 {{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
138 //always saved (PBD)//
139 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
140 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
141 desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
142 units: none
143
144 {{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
145 //always saved (PBD)//
146 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
147 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
148 desc: PG Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
149 units: none
150
151 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
152 //always saved (PBD)//
153 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
154 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
155 desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
156 units: degree
157
158 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
159 //always saved (PBD)//
160 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
161 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
162 desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
163 units: degree
164
165 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
166 //always saved (PBD)//
167 DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
168 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
169 desc: Position of the PG filter wheel 1
170 units: degree
171
172 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
173 //always saved (PBD)//
174 DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
175 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
176 desc: Position of the PG filter wheel 2
177 units: degree
178
179 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
180 //always saved (PBD)//
181 DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
182 DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
183 desc: Position of the PG filter wheel 3
184 units: degree
185
186
187
188 NOTE: Aperture positions in the beamline as well as the positions of the beam steering mirrors are also saved. For more Info contact your local contact
189
190 [[Contents>>doc:||anchor="Contents"]]
191
192
193 ==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]]) ====
194
195 {{expand title="Discontinued GMD format (used until 2021)"}}
196 (% style="color:#000000" %)**Discontinued GMD data recording / evaluation  (VME + PhotonFlux ML server)**
197
198 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
199 //always saved (PBD)//
200
201 (% style="color:#000000" %)DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}} (%%)
202 (% style="color:#000000" %)DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}(%%)
203 desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator (ion current)
204 units : microJ
205
206 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
207 //always saved (PBD)//
208
209 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
210 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
211 desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
212 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
213
214 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
215 //always saved (PBD)//
216 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
217 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
218 desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
219 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
220
221 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
222 //always saved (PBD)//
223
224 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
225 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
226 desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
227 units : microJ
228
229 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
230 //always saved (PBD)//
231
232 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
233 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
234 desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
235 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
236
237 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
238 //always saved (PBD)//
239 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
240 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
241 desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
242 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
243 {{/expand}}
244
245
246 (% style="color:#000000; letter-spacing:0px" %)**NEW (since 2021) GMD data recording / evaluation  (same format as FLASH2 and XFEL)**
247
248 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
249 //always saved (PBD)//
250 (% style="color:#000000" %)DOOCS prop : (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %){{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}(% style="color:#000000" %) (%%)
251 (% style="color:#000000" %)DAQ channel: (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %){{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}
252
253 desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator
254 units : microJ
255
256
257 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
258 //always saved (PBD)//
259
260 (% style="color:#000000" %)DOOCS prop : 
261 (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %){{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}(% style="color:#000000" %)DAQ channel: (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %){{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL1.TUNNEL/INTENSITY.TD{{/code}}
262
263 desc : Energy per pulse measured in the Tunnel.  In addition measurement errors and beam position are included for EACH pulse in the pulse train  !! (see below)
264 units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FS-FLASH USER tmp.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
265
266 {{info title="GMD pulse resolved data structure"}}
267 For every pulse in the pulse train the information is saved:
268
269 1. **Intensity per pulse** (a.u. (more or less µJ ))
270 1. Intensity per pulse (auxillary GMD) - not used
271 1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
272 1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
273 1. **Intensity per pulse sigma** (a.u. (more or less µJ ), (% style="color:#000000" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise,  detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%))
274 1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
275 1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
276 1. Combined warning and error flags
277
278 The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this 
279 file
280
281 [[image:image2021-2-9_10-51-6.png]]
282
283
284 {{/info}}
285
286 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 !
287
288
289 Besides  pulse energy the GMD also provides information about the beam position
290
291 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
292 //always saved (PBD)//
293 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
294 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
295 desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
296 units : mm
297
298 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
299 //always saved (PBD)//
300 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
301 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
302 desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
303 units : mm
304
305 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
306 //always saved (PBD)//
307 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
308 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
309 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
310 units : mm
311
312 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
313 //always saved (PBD)//
314 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
315 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
316 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
317 units : mm
318
319
320 ==== Spectrometer (FLASH1) ====
321
322 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
323 _always saved (when Spectrum is measured !!) (PBD) _
324 DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}
325 DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}
326 desc : XUV Spectrum measured with the "tunnel spectrometer"
327 units :
328
329 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}
330 _always saved (when Spectrum is measured !!) (PBD) _
331 DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
332 DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
333 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
334 units : nm
335
336 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}
337 _always saved (when Spectrum is measured !!) (PBD) _
338 DOOCS prop : ==
339 DAQ channel: ==
340 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
341 units : nm
342
343 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}
344 //saved on DEMAND (PBD spectrometer stream)//
345 DOOCS prop : ==
346 DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}
347 desc : XUV Spectrum in eV measured with the "PG2 spectrometer"
348 units :
349
350 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}
351 //saved on DEMAND (PBD spectrometer stream)//
352 DOOCS prop : ==
353 DAQ channel: ==
354 desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
355 units : eV
356
357 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}
358 //saved on DEMAND (PBD spectrometer stream)//
359 DOOCS prop : ==
360 DAQ channel: ==
361 desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
362 units : eV
363
364 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}
365 //saved on DEMAND (PBD spectrometer stream)//
366 DOOCS prop : ==
367 DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}
368 desc : XUV Spectrum in nm measured with the "PG2 spectrometer"
369 units :
370
371 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}
372 //saved on DEMAND (PBD spectrometer stream)//
373 DOOCS prop : ==
374 DAQ channel: ==
375 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
376 units : nm
377
378 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}
379 //saved on DEMAND (PBD spectrometer stream)//
380 DOOCS prop : ==
381 DAQ channel: ==
382 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
383 units : nm
384
385 [[Contents>>doc:||anchor="Contents"]]
386
387 ==== Electron Beam properties (FLASH1) ====
388
389 ===== bunch charge =====
390
391 {{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
392 //always saved (PBD)//
393 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
394 DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
395 desc: electron bunch charge (FLASH1)
396 units: nC
397
398 =====
399 arrival time (BAM) =====
400
401 {{info title="BAM information: updates 2022 (status 2025)"}}
402 * 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"]]
403 * The data format of the BAM has been completely altered in the 2022 shutdown
404 * 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 ...
405 * 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)
406 * There has been also a renaming  (and relocation) of the BAMs.
407 ** acc:  4DBC3 → FL0.DBC2
408 ** FL1: 1SFELC →  FL1.SFELC
409 ** FL2: FL2XTDS → (% style="color:#172b4d" %)FL2.SEED5
410 * for more Info: [[LINK to detailed infos from MSK>>doc:SDiag.How-to articles.BAM Data Structure.WebHome||shape="rect"]]
411 * [[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]]
412 * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
413 {{/info}}
414
415 {{expand title="Discontinued BAM format (used until end 2021)"}}
416 (% style="color:#000000" %)**Discontinued BAM data recording **
417
418 {{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
419 //always saved (PBD)//
420 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
421 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
422 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).
423 units: ps (bigger numbers indicate later arrivaltime of the electrons)
424
425
426 {{code language="none"}}/FL1/Electron Diagnostic/BAM/1SFELC/electron bunch arrival time (low charge){{/code}}
427 //always saved (PBD)//
428 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/1SFELC/LOW_CHARGE_ARRIVAL_TIME{{/code}}
429 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/1SFELC.LOW_CHARGE_ARRIVAL_TIME{{/code}}
430 desc: Electron bunch arrival time measured with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.
431 units: ps (bigger numbers indicate later arrival time of the electrons)
432 {{/expand}}
433
434 ====== **BAM FL0.DBC2**{{code language="none"}}{{/code}} ======
435
436 (% style="color:#ff6600" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)(%%)
437 //always saved (PBD)//
438 {{code language="none"}}/FL1/Electron Diagnostic/BAM/ {{/code}}DOOCS prop : FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
439 DAQ (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP (%%)
440 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).
441
442 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
443
444
445 (% style="color:#ff6600" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw)(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
446 //always saved (PBD)//
447 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE
448 DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE (%%)
449 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). 
450 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
451
452
453 (% style="color:#ff6600" %)DBC2/error (HDF5 name not yet implemented - see zraw)(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
454 //always saved (PBD)//
455 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E.bamError.1(%%)
456 DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR.1(%%)
457 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
458
459
460 (% style="color:#ff6600" %)DBC2/status  (HDF5 name not yet implemented - see zraw)(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
461 //always saved (PBD)//
462 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E..bamStatus.//1//(%%)
463 DAQ channel(% style="color:#000000" %): FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.1(%%)
464 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
465
466
467 ====== **BAM FL1.SFELC**{{code language="none"}}{{/code}} ======
468
469 (% 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)
470
471 //always saved (PBD)//
472 (% style="color:#172b4d" %)**FL1.SFELC**(%%)
473 (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
474 (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %){{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).
475 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
476
477
478
479 (% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/electron bunch arrival time (raw) (HDF5 name not yet implemented - see zraw)(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
480 //always saved (PBD)//
481 DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIME.ABSOLUTE
482 DAQ channel:** **(% style="color:#000000" %)FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.ABSOLUTE (%%)
483 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). 
484 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
485
486
487 (% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/error (HDF5 name not yet implemented - see zraw)(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
488 //always saved (PBD)//
489 DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color:#000000" %)E.bamError(%%)
490 DAQ channel(% style="color:#000000" %): FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMERROR(%%)
491 desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
492
493
494 (% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/status  (HDF5 name not yet implemented - see zraw)(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
495 //always saved (PBD)//
496 DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color:#000000" %)E..bamStatus.//1//(%%)
497 DAQ chann(% style="color:#000000" %)el: FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMSTATUS.1(%%)
498 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
499
500
501
502 ===== electron beam profile =====
503
504 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
505 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
506 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
507 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
508 desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
509 units: pixel
510
511 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
512 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
513 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
514 DAQ channel: = PBD.BEAM.PROF.ML/CCT=
515 desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
516 units: fs per pixel
517
518 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
519 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
520 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
521 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
522 desc: rms pulse width of the measures TDS electron bunch profile
523 units: fs
524
525 ===== electron bunch energy =====
526
527 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
528 //always saved (PBD)//
529 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
530 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
531 desc: electron bunch energy (average over the bunch train)
532 units: (% class="twikiNewLink" %)MeV
533
534 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
535 //always saved (PBD)//
536 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
537 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
538 desc: electron bunch energy bunch resolved
539 units: (% class="twikiNewLink" %)MeV
540
541
542 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
543 //always saved (PBD)//
544 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
545 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
546 desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
547 units: nm
548
549 [[Contents>>doc:||anchor="Contents"]]
550 {{/expand}}
551
552 ==== Beamline info (FLASH1) ====
553
554 {{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}
555 //always saved (PBD)//
556 DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
557 DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
558 desc: set pressure in the gas attenuator
559 units: mbar
560
561 {{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
562 //always saved (PBD)//
563 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}
564 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}
565 desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
566 units: none
567
568 {{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}
569 //always saved (PBD)//
570 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}
571 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}
572 desc: PG Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
573 units: none
574
575 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}
576 //always saved (PBD)//
577 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
578 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
579 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]]
580 units: degree
581
582 {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
583 //always saved (PBD)//
584 DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
585 DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
586 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]]
587 units: degree
588
589 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
590 //always saved (PBD)//
591 DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=
592 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
593 desc: Position of the PG filter wheel 1
594 units: degree
595
596 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
597 //always saved (PBD)//
598 DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
599 DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
600 desc: Position of the PG filter wheel 2
601 units: degree
602
603 {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
604 //always saved (PBD)//
605 DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
606 DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}
607 desc: Position of the PG filter wheel 3
608 units: degree
609
610
611
612 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
613
614 [[Contents>>doc:||anchor="Contents"]]
615
616
617 ==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]]) ====
618
619 {{expand title="Discontinued GMD format (used until 2021)"}}
620 (% style="color:#000000" %)**Discontinued GMD data recording / evaluation  (VME + PhotonFlux ML server)**
621
622 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
623 //always saved (PBD)//
624
625 (% style="color:#000000" %)DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}} (%%)
626 (% style="color:#000000" %)DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}(%%)
627 desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator (ion current)
628 units : microJ
629
630 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
631 //always saved (PBD)//
632
633 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
634 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
635 desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
636 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]]**
637
638 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
639 //always saved (PBD)//
640 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
641 DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
642 desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
643 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]]**
644
645 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
646 //always saved (PBD)//
647
648 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
649 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
650 desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
651 units : microJ
652
653 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
654 //always saved (PBD)//
655
656 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
657 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
658 desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
659 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]]**
660
661 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
662 //always saved (PBD)//
663 DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
664 DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
665 desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
666 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]]**
667 {{/expand}}
668
669
670 (% style="color:#000000; letter-spacing:0px" %)**NEW (since 2021) GMD data recording / evaluation  (same format as FLASH2 and XFEL)**
671
672 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
673 //always saved (PBD)//
674 (% style="color:#000000" %)DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}} (%%)
675 (% style="color:#000000" %)DAQ channel: {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL1.TUNNEL/PHOTONFLUX.UJ{{/code}}
676
677 desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator
678 units : microJ
679
680
681 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
682 //always saved (PBD)//
683
684 (% style="color:#000000" %)DOOCS prop : 
685 {{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}}
686
687 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)
688 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]]**
689
690 {{info title="GMD pulse resolved data structure"}}
691 For every pulse in the pulse train the information is saved:
692
693 1. **Intensity per pulse** (a.u. (more or less µJ ))
694 1. Intensity per pulse (auxillary GMD) - not used
695 1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
696 1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
697 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)(%%))
698 1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
699 1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
700 1. Combined warning and error flags
701
702 The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this 
703 file
704
705
706 [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
707
708
709 {{/info}}
710
711 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 !
712
713
714 Besides  pulse energy the GMD also provides information about the beam position
715
716 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
717 //always saved (PBD)//
718 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
719 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
720 desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
721 units : mm
722
723 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
724 //always saved (PBD)//
725 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
726 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
727 desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
728 units : mm
729
730 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
731 //always saved (PBD)//
732 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
733 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
734 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
735 units : mm
736
737 {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
738 //always saved (PBD)//
739 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
740 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
741 desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
742 units : mm
743
744
745 ==== Spectrometer (FLASH1) ====
746
747 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
748 _always saved (when Spectrum is measured !!) (PBD) _
749 DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}
750 DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}
751 desc : XUV Spectrum measured with the "tunnel spectrometer"
752 units :
753
754 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}
755 _always saved (when Spectrum is measured !!) (PBD) _
756 DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
757 DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}
758 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
759 units : nm
760
761 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}
762 _always saved (when Spectrum is measured !!) (PBD) _
763 DOOCS prop : ==
764 DAQ channel: ==
765 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"
766 units : nm
767
768 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}
769 //saved on DEMAND (PBD spectrometer stream)//
770 DOOCS prop : ==
771 DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}
772 desc : XUV Spectrum in eV measured with the "PG2 spectrometer"
773 units :
774
775 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}
776 //saved on DEMAND (PBD spectrometer stream)//
777 DOOCS prop : ==
778 DAQ channel: ==
779 desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
780 units : eV
781
782 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}
783 //saved on DEMAND (PBD spectrometer stream)//
784 DOOCS prop : ==
785 DAQ channel: ==
786 desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
787 units : eV
788
789 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}
790 //saved on DEMAND (PBD spectrometer stream)//
791 DOOCS prop : ==
792 DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}
793 desc : XUV Spectrum in nm measured with the "PG2 spectrometer"
794 units :
795
796 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}
797 //saved on DEMAND (PBD spectrometer stream)//
798 DOOCS prop : ==
799 DAQ channel: ==
800 desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"
801 units : nm
802
803 {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}
804 //saved on DEMAND (PBD spectrometer stream)//
805 DOOCS prop : ==
806 DAQ channel: ==
807 desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
808 units : nm
809
810 [[Contents>>doc:||anchor="Contents"]]
811
812 ==== Electron Beam properties (FLASH1) ====
813
814 ===== bunch charge =====
815
816 {{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}
817 //always saved (PBD)//
818 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}
819 DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}
820 desc: electron bunch charge (FLASH1)
821 units: nC
822
823 =====
824 arrival time (BAM) =====
825
826 {{info title="BAM information: updates 2022 (status 2025)"}}
827 * 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"]]
828 * The data format of the BAM has been completely altered in the 2022 shutdown
829 * 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 ...
830 * 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)
831 * There has been also a renaming  (and relocation) of the BAMs.
832 ** acc:  4DBC3 → FL0.DBC2
833 ** FL1: 1SFELC →  FL1.SFELC
834 ** FL2: FL2XTDS → (% style="color:#172b4d" %)FL2.SEED5
835 * for more Info: [[LINK to detailed infos from MSK>>doc:SDiag.How-to articles.BAM Data Structure.WebHome||shape="rect"]]
836 * [[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]]
837 * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
838 {{/info}}
839
840 {{expand title="Discontinued BAM format (used until end 2021)"}}
841 (% style="color:#000000" %)**Discontinued BAM data recording **
842
843 {{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
844 //always saved (PBD)//
845 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
846 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
847 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).
848 units: ps (bigger numbers indicate later arrivaltime of the electrons)
849
850
851 {{code language="none"}}/FL1/Electron Diagnostic/BAM/1SFELC/electron bunch arrival time (low charge){{/code}}
852 //always saved (PBD)//
853 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/1SFELC/LOW_CHARGE_ARRIVAL_TIME{{/code}}
854 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/1SFELC.LOW_CHARGE_ARRIVAL_TIME{{/code}}
855 desc: Electron bunch arrival time measured with the BAM  before the undulator (pulse resolved data). This one was newly installed in 2020.
856 units: ps (bigger numbers indicate later arrival time of the electrons)
857 {{/expand}}
858
859 ====== **BAM FL0.DBC2**{{code language="none"}}{{/code}} ======
860
861 (% style="color:#ff6600" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)(%%)
862 //always saved (PBD)//
863 {{code language="none"}}/FL1/Electron Diagnostic/BAM/ {{/code}}DOOCS prop : FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
864 DAQ (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA1.COMP (%%)
865 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).
866
867 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
868
869
870 (% style="color:#ff6600" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
871 //always saved (PBD)//
872 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE
873 DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE (%%)
874 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). 
875 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
876
877
878 (% style="color:#ff6600" %)DBC2/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
879 //always saved (PBD)//
880 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E.bamError.1(%%)
881 DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR.1(%%)
882 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
883
884
885 (% style="color:#ff6600" %)DBC2/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
886 //always saved (PBD)//
887 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E..bamStatus.//1//(%%)
888 DAQ channel(% style="color:#000000" %): FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.1(%%)
889 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
890
891
892 ====== **BAM FL1.SFELC**{{code language="none"}}{{/code}} ======
893
894 (% 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)
895
896 //always saved (PBD)//
897 (% style="color:#172b4d" %)**FL1.SFELC**(%%)
898 (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
899 {{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).
900 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
901
902
903
904 (% 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}}(%%)
905 //always saved (PBD)//
906 DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIME.ABSOLUTE
907 DAQ channel:** **(% style="color:#000000" %)FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.ABSOLUTE (%%)
908 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). 
909 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
910
911
912 (% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/error (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
913 //always saved (PBD)//
914 DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color:#000000" %)E.bamError(%%)
915 DAQ channel(% style="color:#000000" %): FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMERROR(%%)
916 desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
917
918
919 (% style="color:#172b4d" %)SFELC(% style="color:#ff6600" %)/status  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL1/Electron Diagnostic/BAM/{{/code}}(%%)
920 //always saved (PBD)//
921 DOOCS prop : FLASH.SDIAG/BAM/(% style="color:#172b4d" %)FL1.SFELC(%%)/ARRIVAL_TIM(% style="color:#000000" %)E..bamStatus.//1//(%%)
922 DAQ chann(% style="color:#000000" %)el: FLASH.SDIAG/BAM/FL1.SFELC/ARRIVAL_TIME.BAMSTATUS.1(%%)
923 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
924
925
926
927 ===== electron beam profile =====
928
929 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}
930 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
931 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}
932 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
933 desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
934 units: pixel
935
936 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
937 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
938 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}
939 DAQ channel: = PBD.BEAM.PROF.ML/CCT=
940 desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
941 units: fs per pixel
942
943 {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
944 //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
945 DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}
946 DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}
947 desc: rms pulse width of the measures TDS electron bunch profile
948 units: fs
949
950 ===== electron bunch energy =====
951
952 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}
953 //always saved (PBD)//
954 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
955 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
956 desc: electron bunch energy (average over the bunch train)
957 units: (% class="twikiNewLink" %)MeV
958
959 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
960 //always saved (PBD)//
961 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}
962 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}
963 desc: electron bunch energy bunch resolved
964 units: (% class="twikiNewLink" %)MeV
965
966
967 {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}
968 //always saved (PBD)//
969 DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}
970 DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
971 desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
972 units: nm
973
974 [[Contents>>doc:||anchor="Contents"]]
975
976
977 ==== Timing information, rep rate etc.  (FLASH1) ====
978
979 ===== bunch repetition rate =====
980
981 {{code language="none"}}/FL1/Timing/repetition rate{{/code}}
982 //always saved (PBD)//
983 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}
984 DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
985 desc: repetition rate of the bunches / pulses within the burst (FLASH1)
986 units: kHz
987
988 ===== set number of pulses =====
989
990 (% style="color:#ff6600" %)(HDF5 name not yet implemented - see zraw)(% style="color:#ff0000" %){{code language="none"}}/FL1/Timing/set number of bunches {{/code}}(%%)
991 //always saved (PBD)//
992 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1 [4th number]{{/code}}
993 DAQ channel: {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1 [4th number]{{/code}}
994 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 
995 units:
996
997 ===== actual number of pulses =====
998
999 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
1000 //always saved (PBD)//
1001 DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}
1002 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
1003 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)
1004 units:
1005
1006 ===== actual pulse pattern recorded after the undulator =====
1007
1008 {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
1009 //always saved (PBD)//
1010 DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}
1011 DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
1012 desc: The bunch pattern as function of time in a burst recorded by toroid diagnostic BEHIND the undulator. (FLASH1)
1013 units:
1014
1015 ===== Train ID =====
1016
1017 {{code language="none"}}/Timing/train ID{{/code}}
1018 //always saved (PBD)//
1019 DOOCS prop : {{code language="none"}}none{{/code}}
1020 DAQ channel: {{code language="none"}}none{{/code}}
1021 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 !)
1022 units:
1023
1024 ===== (% style="color:#e67e22" %)Train time(%%) =====
1025
1026 (% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
1027 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
1028 units: d h min s cs
1029
1030 (% style="color:#e67e22" %){{code language="none"}}/Timing/time stamp{{/code}}
1031 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
1032 second column: microseconds
1033 third column: Train ID of FLASH
1034
1035 currently it is saved as Unix time in : /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time
1036
1037 {{expand expanded="false" title="Timestamp help for python"}}
1038 import time
1039
1040 # epoch time is found in /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time #!!! a leading 1 has to be added !!!
1041 # 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
1042 epoch_time = 1709051499.17 # Replace with your epoch time
1043
1044 formatted_time = time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime(epoch_time))
1045 print(formatted_time)
1046 {{/expand}}
1047
1048
1049 [[Contents>>doc:||anchor="Contents"]]
1050
1051 ==== Pump Probe Laser (FLASH1) ====
1052
1053 **PIGLET (PG laser)**
1054
1055 **{{code language="none"}}/FL1/Experiment/Pump probe laser{{/code}}**
1056
1057 {{info width="30%"}}
1058 list of saved parameters status May 2024 (up to now the parameters can be found in /zraw/ ... )
1059
1060 Download the PDF:
1061
1062 {{view-file att--filename="FSLADAQ-DAQParameterlistPiGLET.pdf"}}{{/view-file}}
1063
1064
1065
1066 {{/info}}
1067
1068 {{expand title="Parameters used until 2021"}}
1069 {{code language="none"}}
1070 /FL1/Experiment/Pump probe laser/laser attenuation
1071 {{/code}}
1072
1073 //always saved (PBD)//
1074 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
1075 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}
1076 desc: attenuation of the PPLaser (rotation of a waveplate)
1077 units : 0 no transmission , 1: full transmission
1078
1079
1080 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}
1081 //always saved (PBD)//
1082 DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
1083 DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}
1084 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
1085 units : ps ( pos delay means IR comes later)
1086
1087
1088 {{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}
1089 //always saved (PBD)//
1090 DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}
1091 DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}
1092 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
1093 units : ps ( pos delay means IR comes later)
1094
1095
1096 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}
1097 //always saved (PBD)//
1098 DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
1099 DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}
1100 desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
1101
1102
1103 {{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}
1104 //always saved (PBD)//
1105 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
1106 DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}
1107 desc: delay time between the optical laser and the FEL units: ps
1108 {{/expand}}
1109
1110
1111 [[Contents>>doc:||anchor="Contents"]]
1112
1113
1114 ==== User Data (FLASH1) ====
1115
1116 The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring of slow properties (motor positions etc) for user experiments. For details please ask your local contact.
1117
1118 NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
1119
1120 The most common and permanently installed device used by experiment are our ADCs:
1121
1122 ===== GHz ADCs =====
1123
1124 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]]**
1125 //saved on DEMAND in the user DAQ//
1126 \\The HDF5 names for the ADC traces are depending on the beamline :
1127 \\PG Beamline:
1128 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}
1129 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}
1130 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}
1131 {{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}
1132
1133 BL Beamlines:
1134 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}
1135 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}
1136 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}
1137 {{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}
1138 \\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}
1139 {{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}
1140 \\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}
1141 {{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}
1142
1143 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
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}} 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.
1145 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
1146
1147 In addition there are also additional parameters saved like:
1148
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 * {{code language="none"}}number of samples{{/code}}: total number of samples recorded for each 10 Hz trigger
1151 * {{code language="none"}}error (ADC):{{/code}}0 indicates that there was no error
1152
1153 ===== MHz ADCs =====
1154
1155 similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
1156 {{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}
1157 DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
1158 DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
1159
1160 In addition there are also additional parameters saved like:
1161
1162 * {{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.
1163 * {{code language="none"}}number of samples{{/code}}: total number of samples recorded for each 10 Hz trigger
1164
1165 [[Contents>>doc:||anchor="Contents"]]
1166
1167
1168
1169
1170 === FLASH2 ===
1171
1172 There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs
1173
1174 ==== Beamline info (FLASH2) ====
1175
1176 {{code language="none"}}/FL2/Beamlines/Attenuator/pressure  {{/code}}
1177 (% style="color:#000000" %)//always saved (PBD2)// (%%)
1178 (% style="color:#000000" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
1179 (% style="color:#000000" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
1180 (% style="color:#000000" %)desc: set pressure in the gas attenuator (%%)
1181 (% style="color:#000000" %)units: mbar
1182
1183 {{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
1184 //always saved (PBD2)//
1185 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER/CH00.TD{{/code}}
1186 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER{{/code}}
1187 desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)
1188 units: none
1189
1190
1191 {{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 1{{/code}}
1192 //always saved (PBD2)//
1193 DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}
1194 DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
1195 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]]**
1196 units: degree
1197
1198 /FL2/Beamlines/Filter wheel/position wheel 2
1199 always saved (PBD2)
1200 DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
1201 DAQ channel: {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS{{/code}}
1202 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]]
1203 units: degree
1204
1205
1206 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
1207
1208 [[Contents>>doc:||anchor="Contents"]]
1209
1210
1211
1212 ==== Photon Diagnostics SASE ([[XGMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]] - FLASH2) ====
1213
1214 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
1215 //always saved (PBD2)//
1216 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
1217 DAQ channel:{{code language="none"}} FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}
1218 desc : calibrated average ( ~~ 20 sec averaging time ) SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)
1219 units : microJ
1220
1221
1222 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
1223 //always saved (PBD2)//
1224 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
1225 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
1226 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)
1227 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]]**
1228
1229 {{info title="GMD pulse resolved data structure"}}
1230 For every pulse in the pulse train the information is saved:
1231
1232 1. **Intensity per pulse** (a.u. (more or less µJ ))
1233 1. Intensity per pulse (auxillary GMD) - not used
1234 1. Position horizontal (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
1235 1. Position vertical (mm, for a single pulse the position information may be very noisy  - talk to your local contact)
1236 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)(%%))
1237 1. Position horizontal sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
1238 1. Position vertical sigma  (mm, indicates the error (RMS, sigma) of the measurement according to known uncertainties and signal to noise)
1239 1. Combined warning and error flags
1240
1241 The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this 
1242 file
1243
1244
1245 [[image:attach:image2021-2-9_10-51-6.png||height="250"]]
1246
1247
1248 {{/info}}
1249
1250
1251 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 !
1252
1253
1254 Besides  pulse energy the GMD also provides information about the beam position
1255
1256
1257 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel horizontal{{/code}}
1258 //always saved (PBD2)//
1259 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
1260 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
1261 desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
1262 units : mm
1263
1264
1265 {{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel vertical{{/code}}
1266 //always saved (PBD2)//
1267 DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
1268 DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
1269 desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
1270 units : mm
1271
1272
1273 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel x
1274 always saved (PBD2)
1275 DOOCS prop : FLASH.FEL/XGM.BPM/FL2.HALL/X.TD
1276 DAQ channel: FLASH.FEL/XGM.BPM/FL2.HALL:2
1277 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 ...)
1278 units : mm   
1279
1280 (x=horizontal, y = vertial)
1281
1282 again the same parameter set is available for the **HALL GMD**
1283
1284
1285
1286 ==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
1287
1288 for more info see:** [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]**
1289
1290 (The OPIS hall is not installed yet ...)
1291
1292
1293 {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean photon energy{{/code}}
1294 // saved opon request (PBD2)//
1295 DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
1296 DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}
1297 desc : mean photon energy ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
1298 units : eV
1299
1300
1301 {{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelength{{/code}}
1302 // saved opon request (PBD2)//
1303 DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
1304 DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
1305 desc : mean wavelength ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
1306 units : nm
1307
1308
1309 {{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}}
1310 // saved opon request (PBD2)//
1311 DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
1312 DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
1313 desc : The bunch number of the bunch used for the wavelength calculation
1314 units :
1315
1316
1317 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"]])
1318
1319
1320 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 ...
1321
1322
1323
1324 ==== Electron Beam properties (FLASH2) ====
1325
1326 ===== bunch charge =====
1327
1328 {{code language="none"}}/FL2/Electron Diagnostic/Bunch charge/after undulator{{/code}}
1329 //always saved (PBD2)//
1330 DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
1331 DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
1332 desc: electron bunch charge FLASH2 (average value for each bunchtrain).
1333 units: nC
1334
1335
1336 ===== electron bunch energy =====
1337
1338 {{code language="none"}}/FL2/Electron Diagnostic/Electron energy/energy of first bunch/behind undulators{{/code}}
1339 //always saved (PBD2)//
1340 DOOCS prop : {{code language="none"}}FLASH.DIAG/BEAM_ENERGY_MEASUREMENT/FL2XTDS/ENERGY.FLASH2{{/code}}
1341 DAQ channel: (% style="color:#5e6c84" %)TTF2.DAQ/PBD2.BEAM.ENERGY.MEAS.ML.COPY/FL2XTDS.ENERGY.FLASH2{{code language="none"}}{{/code}}(%%)
1342 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
1343
1344 (% style="letter-spacing:0.0px" %)units: (% class="twikiNewLink" %)MeV
1345
1346
1347 (% style="color: rgb(94, 108, 132); font-weight: 600; letter-spacing: 0px;" %)
1348 ===== undulator settings =====
1349
1350 {{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/set wavelength{{/code}}
1351 //always saved (PBD2)//
1352 DOOCS prop : {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
1353 DAQ channel:  {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
1354 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 % ...
1355 units: nm
1356
1357 {{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/SASE14 gap{{/code}}
1358 //always saved (PBD2)//
1359 DOOCS prop : {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
1360 DAQ channel:  {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
1361 desc: gap value of the undulators. This can be used to follow up how many undulators were closed and if there was a taper
1362 units: mm
1363
1364 The gap values are saved for all 12 undulators (Nr 3 to 14). Undulator 14 is the one closest to the experimental hall.
1365
1366 =====
1367 arrival time (BAM) =====
1368
1369 {{info title="BAM information: updates 2022 (status 2025)"}}
1370 * 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"]]
1371 * The data format of the BAM has been completely altered in the 2022 shutdown
1372 * 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 ...
1373 * 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)
1374 * There has been also a renaming  (and relocation) of the BAMs.
1375 ** acc:  4DBC3 → FL0.DBC2
1376 ** FL1: 1SFELC →  FL1.SFELC
1377 ** FL2: FL2XTDS → (% style="color:#172b4d" %)FL2.SEED5
1378 * for more Info: [[LINK to detailed infos from MSK>>doc:SDiag.How-to articles.BAM Data Structure.WebHome||shape="rect"]]
1379 * [[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]]
1380 * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
1381 {{/info}}
1382
1383 {{expand title="Discontinued BAM format (used until end 2021)"}}
1384 (% style="color:#000000" %)**Discontinued BAM data recording **
1385
1386 {{code language="none"}}/FL2/Electron Diagnostic/BAM/8FL2XTDS/electron bunch arrival time (low charge){{/code}}
1387 //always saved (PBD2)//
1388 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/8FL2XTDS/LOW_CHARGE_ARRIVAL_TIME{{/code}}
1389 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/8FL2XTDS.LOW_CHARGE_ARRIVAL_TIME{{/code}}
1390 desc: Electron bunch arrival time measured with the BAM after the FLASH2 undulator (pulse resolved data)
1391 units: ps (bigger numbers indicate later arrivaltime of the electrons)
1392
1393 **FL1**{{code language="none"}}//Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}
1394 //always saved (PBD2)//
1395 DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}
1396 DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}
1397 desc: Electron bunch arrival time measured with the BAM  in the accelerator  (pulse resolved data)
1398 units: ps (bigger numbers indicate later arrivaltime of the electrons)
1399
1400 {{info title="BAM hints"}}
1401 * The BAM 4DBC3 measures the arrivaltime of** FLASH 1 and FLASH2** in the same data set (thus also sorted in at /FL1/ !).
1402 * 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 
1403 ** 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
1404 * [[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]]
1405 * [[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"]]
1406 * a recent  [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
1407 {{/info}}
1408 {{/expand}}
1409
1410
1411 ====== **BAM FL0.DBC2**{{code language="none"}}{{/code}} ======
1412
1413 (% style="color:#ff6600" %)**DBC2**/electron bunch arrival time  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}
1414
1415 {{code language="none"}}
1416 /zraw/FLASH.SDIAG/BAM.DAQ/FL0.DBC2.ARRIVAL_TIME.ABSOLUTE.SA2.COMP/dGroup/
1417 {{/code}}
1418
1419 //always saved (PBD)//
1420 **FL0.DBC2**
1421 (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/**FL0.DBC2**/ARRIVAL_TIME.ABSOLUTE.SA2.COMP
1422 {{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).
1423 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1424
1425
1426 (% style="color:#ff6600" %)DBC2/electron bunch arrival time (raw)  (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}
1427
1428 {{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.DBC2.ARRIVAL_TIME.ABSOLUTE.SA2/dGroup/{{/code}}
1429 //always saved (PBD)//
1430 {{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE{{/code}}
1431 (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel: {{/code}}(%%)
1432 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). 
1433 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1434
1435
1436 DBC2/error (% style="color:#f39c12" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1437 //always saved (PBD)//
1438 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.bamError.2
1439 DAQ channel: FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR.2
1440 desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
1441
1442 DBC2/status  (% style="color:#e67e22" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1443 //always saved (PBD)//
1444 DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.bamStatus.//2//
1445 DAQ channel: FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.2
1446 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
1447
1448
1449
1450 ====== **BAM FL2.SEED5**{{code language="none"}}{{/code}} ======
1451
1452 /FL2/Electron Diagnostic/BAM/**SEED5**(% style="color:#ff6600" %)/electron bunch arrival time  (HDF5 name not yet implemented - see zraw)
1453
1454 (% style="color:#000000" %){{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.SEED5.ARRIVAL_TIME.ABSOLUTE.SA2.COMP/dGroup/{{/code}}
1455
1456 //always saved (PBD)//
1457 (% style="color:#172b4d" %)**FL2.SEED5**(%%)
1458 (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/(% style="color:#172b4d" %)**FL2.SEED5**(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
1459 {{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).
1460 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1461
1462
1463
1464 (% 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}}
1465
1466 (% style="color:#000000" %){{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.SEED5.ARRIVAL_TIME.ABSOLUTE.SA2/dGroup/{{/code}}(%%)
1467 //always saved (PBD)//
1468 (% style="color:#172b4d" %)**FL2.SEED5**{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM//ARRIVAL_TIME.ABSOLUTE{{/code}}(%%)
1469 **~ **(% style="color:#000000" %)FLASH.SDIAG/BAM/(% style="color:#172b4d" %)**FL2.SEED5**(% style="color:#000000" %)/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel:{{/code}}(%%)
1470 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). 
1471 units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
1472
1473
1474 FL2.SEED5/error (% style="color:#f39c12" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1475 //always saved (PBD)//
1476 DOOCS prop : FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.bamError.2
1477 DAQ channel: FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.BAMERROR.2
1478 desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
1479
1480 FL2.SEED5/status  (% style="color:#e67e22" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
1481 //always saved (PBD)//
1482 DOOCS prop : FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.bamStatus.//2//
1483 DAQ channel: FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.BAMSTATUS.2
1484 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
1485
1486
1487 [[Contents>>doc:||anchor="Contents"]]
1488
1489
1490 ==== Timing information, rep rate etc.  (FLASH2) ====
1491
1492 ===== start time of FLASH2 =====
1493
1494 {{code language="none"}}/FL2/Timing/start time flash2{{/code}}
1495 //always saved (PBD2)//
1496 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
1497 DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
1498 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 ...)
1499 units: µs
1500
1501 ===== bunch repetition rate =====
1502
1503 {{code language="none"}}/FL2/Timing/repetition rate{{/code}}
1504 //always saved (PBD2)//
1505 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
1506 DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.2{{/code}}
1507 desc: repetition rate of the bunches / pulses within the burst (FLASH2)
1508 units: kHz
1509
1510
1511 ===== set number of pulses =====
1512
1513 (% style="color:#ff6600" %)(HDF5 name not yet implemented - see zraw)(% style="color:#ff0000" %){{code language="none"}}/FL2/Timing/set number of bunches {{/code}}(%%)
1514 //always saved (PBD2)//
1515 DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.2 [4th number]{{/code}}
1516 DAQ channel: {{code language="none"}}FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.2 [4th number]{{/code}}
1517 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 
1518 units:
1519
1520 ===== actual number of pulses =====
1521
1522 {{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}
1523 //always saved (PBD2)//
1524 DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1525 DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1526 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)
1527 units:
1528
1529 ===== actual pulse pattern recorded after the undulator =====
1530
1531 {{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}
1532 //always saved (PBD2)//
1533 DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1534 DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1535 desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH2)
1536 units:
1537
1538 ===== Train ID =====
1539
1540 {{code language="none"}}/Timing/train ID{{/code}}
1541 //always saved (PBD2)//
1542 DOOCS prop : {{code language="none"}}none{{/code}}
1543 DAQ channel: {{code language="none"}}none{{/code}}
1544 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 !)
1545 units:
1546
1547 ===== (% style="color:#e67e22" %)Train time(%%) =====
1548
1549 (% style="color:#e67e22" %)//always saved (PBD2)//(%%)
1550 (% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
1551 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
1552 units: d h min s cs
1553
1554 {{code language="none"}}
1555 /Timing/time stamp
1556 {{/code}}
1557
1558 (% style="color:#e67e22" %)//always saved (PBD2)//(%%)
1559 (% 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
1560 second column: microseconds
1561 third column: Train ID of FLASH
1562
1563
1564 (% 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
1565
1566 {{expand expanded="false" title="Timestamp help for python"}}
1567 import time
1568
1569 # epoch time is found in /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time #!!! a leading 1 has to be added !!!
1570 # 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
1571 epoch_time = 1709051499.17 # Replace with your epoch time
1572
1573 formatted_time = time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime(epoch_time))
1574 print(formatted_time)
1575 {{/expand}}
1576
1577
1578
1579
1580 [[Contents>>doc:||anchor="Contents"]]
1581
1582
1583 ==== User Data (FLASH2) ====
1584
1585 The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.
1586
1587 NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
1588
1589 The most common and permanently installed device used by experiment are our ADCs:
1590
1591 ===== GHz ADCs =====
1592
1593 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]]**
1594 //saved on DEMAND in the user DAQ//
1595 \\Up to now there are 4 channels available at FL24
1596 \\\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD{{/code}}
1597 {{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH01/TD{{/code}}
1598 \\{{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}}
1599
1600
1601 DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
1602 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.
1603 DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
1604
1605 In addition there are also additional parameters saved like:
1606
1607 * {{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.
1608 * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
1609 * {{code language="none"}}error (ADC):{{/code}}0 indicates that there was no error
1610 * {{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.
1611
1612 ===== MHz ADCs =====
1613
1614 similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
1615 {{code language="none"}}/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH2/TD{{/code}}
1616 DOOCS prop : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02/CH00.TD
1617 DAQ channel: : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02
1618
1619 In addition there are also additional parameters saved like:
1620
1621 * {{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.
1622 * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
1623
1624 [[Contents>>doc:||anchor="Contents"]]
1625
1626
1627
1628 ==== Pump Probe Laser (FLASH2) ====
1629
1630 {{info width="30%"}}
1631 list of saved parameters status May 2024 (up to now the parameters can be found in /zraw/ ... )
1632
1633 [[attach:FSLADAQ-DAQParameterlistULGAN-2.pdf||target="_blank"]]
1634
1635 [[attach:FSLADAQ-DAQParameterlistFL23-2.pdf||target="_blank"]]
1636
1637 [[attach:FSLADAQ-DAQParameterlistFL24-2.pdf||target="_blank"]]
1638
1639
1640 {{view-file att--filename="FSLADAQ-DAQParameterlistFL23-2.pdf"}}{{/view-file}}
1641
1642
1643 {{view-file att--filename="FSLADAQ-DAQParameterlistFL23-2.pdf"}}{{/view-file}}
1644
1645
1646 {{view-file att--filename="FSLADAQ-DAQParameterlistFL24-2.pdf"}}{{/view-file}}
1647
1648
1649 {{/info}}
1650
1651 {{expand title="Laser parameters used until 2023"}}
1652 These are the parameters that can be saved in the FL2 User DAQ for the FL2 PP laser//** FOR BEAMLINE FL24**//
1653
1654 **User delay**
1655
1656 Delay (set value):
1657
1658 {{code language="none"}}
1659 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR
1660 {{/code}}
1661
1662 Delay (readback):
1663
1664 {{code language="none"}}
1665 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
1666 {{/code}}
1667
1668 (% style="letter-spacing:0.0px" %)Delay (encoder readback):
1669
1670 {{code language="none"}}
1671 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.ENCODER_POSITION.RD
1672 {{/code}}
1673
1674 OXC. jitter:
1675
1676 {{code language="none"}}
1677 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
1678 {{/code}}
1679
1680
1681
1682 **FL24 Pulse resolved energy:**
1683
1684 OPCPA output (photodiode signal raw ADC trace 16000 samples):
1685
1686 {{code language="none"}}
1687 /zraw/FLASH.LASER/FLASH2CPUULGAN1.ADCSCOPE/CH23.TD/dGroup
1688 {{/code}}
1689
1690 (% style="letter-spacing:0.0px" %)Upper breadboard Photodiode (THG) burst (photodiode signal raw ADC trace 16000 samples)::
1691
1692 {{code language="none"}}
1693 /zraw/FLASH.LASER/FLASH2CPUULGAN1.ADCSCOPE/CH26.TD/dGroup
1694 {{/code}}
1695
1696 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.)
1697
1698 {{code language="none"}}
1699 /zraw/FLASH.LASER/MOD24.PES/FL24_userPD/dGroup
1700 {{/code}}
1701
1702
1703 **FL24 LAM (Laser Arrivaltime Monitor)  pulse resolved data:**
1704
1705 Signal of Photodiode1  - for experts only... (analyzed signal. integration over pulses in the ADC trace. )
1706
1707 {{code language="none"}}
1708 /zraw/FLASH.LASER/MOD24.PES/LAM.PD1/dGroup
1709 {{/code}}
1710
1711 Signal of Photodiode2  - for experts only...  (analyzed signal. integration over pulses in the ADC trace.)
1712
1713 {{code language="none"}}
1714 /zraw/FLASH.LASER/MOD24.PES/LAM.PD2/dGroup
1715 {{/code}}
1716
1717 "Actual" LAM Signal - to be calibrated ......  (analyzed signal. integration over pulses in the ADC trace.)
1718
1719 {{code language="none"}}
1720 /zraw/FLASH.LASER/MOD24.PES/LAM.PDBAL/dGroup
1721 {{/code}}
1722
1723 The delay feedback(% style="letter-spacing:0.0px" %)
1724
1725 {{code language="none"}}
1726 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26 
1727 {{/code}}
1728
1729 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):
1730
1731 {{code language="none"}}
1732 FLASH.LASER/MOD24.PES/LAM.PDBAL/PULSEENERGY.MEAN
1733 {{/code}}
1734
1735 LAM Delay line act:
1736
1737 {{code language="none"}}FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.POSITION.RD{{/code}}
1738 LAM Delay line set:
1739
1740 {{code language="none"}}
1741 FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.POSITION_SET.WR
1742 {{/code}}
1743
1744 LAM Delay line encoder:
1745
1746 {{code language="none"}}
1747 FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.ENCODER_POSITION.RD
1748 {{/code}}
1749
1750 Temperature feedback:
1751
1752 {{code language="none"}}
1753 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE24
1754 {{/code}}
1755
1756 **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):
1757
1758 {{code language="none"}}
1759 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.INTS/INTEGER30
1760 {{/code}}
1761
1762
1763 **FL24 Attenuator angle:**
1764
1765 {{code language="none"}}
1766 FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
1767 {{/code}}
1768
1769 **FL24 Polarization control:**
1770
1771 {{code language="none"}}
1772 FLASH.FEL/FLAPP2BEAMLINES/MOTOR14.FL24/FPOS
1773 {{/code}}
1774
1775 **SysDC delay error:**
1776
1777 {{code language="none"}}
1778 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26
1779 {{/code}}
1780
1781
1782 **Timing error: (these two need to be observed and both=0 means no error)**
1783
1784 {{code language="none"}}
1785 FLASH/CPUULGAN1.TIMING/ULGAN1/dT_alarm
1786 {{/code}}
1787
1788 {{code language="none"}}
1789 FLASH/CPUULGAN1.TIMING/ULGAN1/dMPN
1790 {{/code}}
1791
1792 **Laser error status:**
1793
1794
1795 **FL24 Virtual camera X and Y history, beam size: (use slow data)**
1796
1797 {{code language="none"}}
1798 FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.X
1799 {{/code}}
1800
1801 {{code language="none"}}
1802 FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.Y
1803 {{/code}}
1804
1805 {{code language="none"}}
1806 FLASH.LASER/MOD24.CAM/UV.14.VF/ROI_SPECTRUM.X.SIG
1807 {{/code}}
1808
1809 {{expand title="Parameters used until 2021"}}
1810 //{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}always saved (PBD2)//
1811 DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1812 DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
1813 desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1814 units : deg.
1815
1816
1817
1818 //{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/polarization position{{/code}}always saved (PBD2)//
1819 DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1820 DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
1821 desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
1822 units : deg.
1823
1824
1825 {{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay readback{{/code}}
1826 //always saved (PBD2)//
1827 DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1828 DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
1829 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)
1830 units : ps )
1831
1832
1833 {{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
1834 //always saved (PBD)//
1835 DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1836 DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
1837 desc: rms jitter of the fs-Oscillator
1838 units: fs
1839 {{/expand}}
1840
1841
1842 ==== FL 26 Pump Probe Laser (FLASH2) ====
1843
1844 These are the parameters that can be saved in the FL2 User DAQ for the FL2 PP laser//** FOR BEAMLINE FL26**//
1845
1846
1847 **User delay**
1848
1849 Delay (set value):
1850
1851 {{code language="none"}}
1852 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR
1853 {{/code}}
1854
1855 Delay (readback):
1856
1857 {{code language="none"}}
1858 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
1859 {{/code}}
1860
1861 Delay (encoder readback):
1862
1863 {{code language="none"}}
1864 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.ENCODER_POSITION.RD
1865 {{/code}}
1866
1867 OXC. jitter:
1868
1869 {{code language="none"}}
1870 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
1871 {{/code}}
1872
1873
1874 **Parameters for FL26**
1875
1876 (% class="wrapped" %)
1877 |(((
1878 FL2PPL FL26 REMI Attenuation: HWP motor current position
1879 )))|(((
1880 FLASH.FEL/FLAPP2BEAMLINES/MOTOR11.FL26B/FPOS
1881 )))
1882 |(((
1883 FL2PPL FL26 REMI Polarization: linear polarization angle
1884 )))|(((
1885 FLASH.FEL/FLAPP2BEAMLINES/MOTOR12.FL26B/FPOS
1886 )))
1887 |(((
1888 FL2PPL FL26 REMI Diagnostics: NIR spectrum
1889 )))|(((
1890 FLASH.LASER/MOD26.SPECT/REMI/DAQ_CHANNEL
1891 )))
1892 |(((
1893 FL2PPL FL26 REMI Diagnostics: photo diode input MOD2.6 - pulse energy mean
1894 )))|(((
1895 FLASH.LASER/MOD26.PES/RE_OUT/PULSEENERGY.MEAN
1896 )))
1897 |(((
1898 FL2PPL FL26 REMI Diagnostics: photo diode input MOD2.6 - intra burst pulse energy
1899 )))|(((
1900 FLASH.LASER/MOD26.PES/RE_OUT/DAQ_CHANNEL
1901 )))
1902 |(((
1903 FL2PPL FL26 REMI Diagnostics: photo diode input MOD2.6 - raw adc
1904 )))|(((
1905 FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH04.TD
1906 )))
1907 |(((
1908 FL2PPL FL26 REMI Diagnostics: photo diode input REMI - pulse energy mean
1909 )))|(((
1910 FLASH.LASER/MOD26.PES/INC_BOX/PULSEENERGY.MEAN
1911 )))
1912 |(((
1913 FL2PPL FL26 REMI Diagnostics: photo diode input REMI - intra burst pulse energy
1914 )))|(((
1915 FLASH.LASER/MOD26.PES/INC_BOX/DAQ_CHANNEL
1916 )))
1917 |(((
1918 FL2PPL FL26 REMI Diagnostics: photo diode input REMI - raw adc
1919 )))|(((
1920 FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH05.TD
1921 )))
1922 |(((
1923 FL2PPL FL26 REMI In coupling: filter wheel 1 position
1924 )))|(((
1925 FLASH/MOD26.FW1/FLASH2MOD26/pos
1926 )))
1927 |(((
1928 FL2PPL FL26 REMI In coupling: filter wheel 2 position
1929 )))|(((
1930 FLASH/MOD26.FW2/FLASH2MOD26/pos
1931 )))
1932 |(((
1933 FL2PPL FL26 REMI: Energy meter REMI incoupling breadboard
1934 )))|(((
1935 FLASH.LASER/MOD26.OPHIRE/REINC.54/DAQ_CHANNEL
1936 )))
1937 |(((
1938 FL2PPL FL26 REMI Incoupling: focusing lens position
1939 )))|(((
1940 FLASH.FEL/FLAPP2BEAMLINES/MOTOR3.FL26B/FPOS
1941 )))
1942 |(((
1943 FL2PPL FL26 REMI Incoupling: nearfield
1944 )))|(((
1945 FLASH.LASER/MOD26.CAM/REINC.21.NF/DAQ_CHANNEL
1946 )))
1947 |(((
1948 FL2PPL FL26 REMI Incoupling: focus
1949 )))|(((
1950 FLASH.LASER/MOD26.CAM/REINC.22.FF/DAQ_CHANNEL
1951 )))
1952 |(((
1953 FL2PPL FL26 REMI Drift: relative arrival time intra burst LAM balanced - calb. in the PES
1954 )))|(((
1955 FLASH.LASER/MOD26.PES/LAM_DIFF/DAQ_CHANNEL
1956 )))
1957 |(((
1958 FL2PPL FL26 REMI Drift: forward signal (PD1)  raw
1959 )))|(((
1960 FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH00.TD
1961 )))
1962 |(((
1963 FL2PPL FL26 REMI Drift: backward signal (PD2) raw
1964 )))|(((
1965 FLASH.LASER/TAMC532DMA/ULGAN1_S5/CH01.TD
1966 )))
1967 |(((
1968 FL2PPL FL26 REMI Drift: mean relative burst arrival time - avarage of the calib value
1969 )))|(((
1970 FLASH.LASER/MOD26.PES/LAM_DIFF/PULSEENERGY.MEAN
1971 )))
1972 |(((
1973 FL2PPL FL26 REMI Drift: delay line position (ODL of the LAM REMI)
1974 )))|(((
1975 FLASH.FEL/FLAPP2BEAMLINES/MOTOR14.FL26B/FPOS
1976 )))
1977 |(((
1978 FL2PPL FL26 Laser Hutch: delay line position (ODL of the osc. Sync / user delay)
1979 )))|(((
1980 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
1981 )))
1982 |(((
1983 FL2PPL FL26 REMI Drift: delay line encoder position (ODL REMI raw value)
1984 )))|(((
1985 FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.0.ENCODER_POSITION.RD
1986 )))
1987 |(((
1988 Jiiter between oscillator and MLO (inloop jitter osc. Sync)
1989 )))|(((
1990 FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
1991 )))
1992 |(((
1993 Temperature controlled fiber (PWM signal to the temperature controlled fiber delay sysdc)
1994 )))|(((
1995 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE23
1996 )))
1997 |(((
1998 Temperature controlled fiber (Temp of the fiber delay sysdc)
1999 )))|(((
2000 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE24
2001 )))
2002 |(((
2003 Sydc feedback data if LAM is not activated (sysdc delay)
2004 )))|(((
2005 FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26
2006 )))
2007 {{/expand}}
2008
2009
2010
2011 === "/uncategorized/" ===
2012
2013 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
2014
2015
2016 === HDF5 structure revisions ===
2017
2018 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:
2019
2020
2021 * All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.
2022 * 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".
2023 * A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.
2024
2025 (% class="wrapped" %)
2026 |=(((
2027 earlier HDF path (vers. 0.2)
2028 )))|=(((
2029 is now (vers. 0.3)
2030 )))
2031 |(((
2032 /Photon Diagnostic/GMD/Beam position/position BDA x
2033 )))|(((
2034 /FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal
2035 )))
2036 |(((
2037 /Photon Diagnostic/GMD/Beam position/position BDA y
2038 )))|(((
2039 /FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical
2040 )))
2041 |(((
2042 /Photon Diagnostic/GMD/Beam position/position tunnel x
2043 )))|(((
2044 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal
2045 )))
2046 |(((
2047 /Photon Diagnostic/GMD/Beam position/position tunnel y
2048 )))|(((
2049 /FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical
2050 )))
2051 |(((
2052 /Experiment/Pump probe laser/BPM/position x
2053 )))|(((
2054 /FL1/Experiment/Pump probe laser/BPM/position horizontal
2055 )))
2056 |(((
2057 /Experiment/Pump probe laser/BPM/position y
2058 )))|(((
2059 /FL1/Experiment/Pump probe laser/BPM/position vertical
2060 )))
2061 |(((
2062 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal
2063 )))|(((
2064 /FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
2065 )))
2066 |(((
2067 /FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical
2068 )))|(((
2069 /FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
2070 )))
2071 |(((
2072 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal
2073 )))|(((
2074 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
2075 )))
2076 |(((
2077 /FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical
2078 )))|(((
2079 /FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
2080 )))
2081 |(((
2082 /FL2/Photon Diagnostic/GMD/Average energy/hall
2083 )))|(((
2084 /FL2/Photon Diagnostic/GMD/Average energy/energy hall
2085 )))
2086 |(((
2087 /FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
2088 )))|(((
2089 /FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)
2090 )))
2091 |(((
2092 /FL2/Photon Diagnostic/GMD/Average energy/tunnel
2093 )))|(((
2094 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel
2095 )))
2096 |(((
2097 /FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
2098 )))|(((
2099 /FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)
2100 )))
2101 |(((
2102 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x
2103 )))|(((
2104 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
2105 )))
2106 |(((
2107 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y
2108 )))|(((
2109 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
2110 )))
2111 |(((
2112 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x
2113 )))|(((
2114 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
2115 )))
2116 |(((
2117 /FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y
2118 )))|(((
2119 /FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
2120 )))
2121
2122 [[Contents>>doc:||anchor="Contents"]]
2123
2124
2125 {{/layout-cell}}
2126 {{/layout-section}}
2127 {{/layout}}