Wiki source code of The FLASH HDF5 structure

Version 95.1 by sndueste on 2025/05/19 16:53

version	line-number	content
44.1	1	{{layout}}
	2	{{layout-section ac:type="single"}}
	3	{{layout-cell}}
1.1	4	== Contents ==
	5
	6
	7
13.1	8	{{toc/}}
1.1	9
	10
	11	== General information about HDF5 ==
	12
84.1	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"]]
1.1	14
84.1	15	To download the HDF5 Viewer click [[here>>url:https://portal.hdfgroup.org/display/support/Download+HDFView\|\|shape="rect"]]
1.1	16
79.1	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}}
1.1	19	{{code language="none"}}> hdfview{{/code}}
	20
49.1	21	or you can use
	22
79.1	23	{{code language="none"}}
	24	> silx view
	25	{{/code}}
49.1	26
	27
4.1	28	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	29
45.1	30	== The FLASH HDF5 format ==
1.1	31
45.1	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.
40.1	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"}}
47.1	39	=== Comparison to FLASH's deprecated HDF formats ===
40.1	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.
45.1	48
	49
46.1	50	HDF5 example files (old format)
45.1	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
79.1	60
40.1	61	{{/expand}}
	62
45.1	63	=== HDF examples: ===
44.1	64	{{/layout-cell}}
	65	{{/layout-section}}
40.1	66
44.1	67	{{layout-section ac:type="three_equal"}}
	68	{{layout-cell}}
79.1	69	* ADC data as example for fast data (10 Hz):
40.1	70
44.1	71	[[image:attach:image2020-11-16_15-26-28.png\|\|height="250"]]
	72	{{/layout-cell}}
	73
	74	{{layout-cell}}
71.1	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}})
44.1	76
70.1	77	( as example only every 10th train ID is listed in the HDF group "index")
40.1	78
44.1	79	[[image:attach:image2020-11-16_15-31-45.png\|\|height="250"]]
	80	{{/layout-cell}}
	81
	82	{{layout-cell}}
41.1	83	* (((
44.1	84	//zraw// group contains the original DAQ (DOOCS) names
41.1	85	)))
40.1	86
41.1	87	of the properties saved in the DESY internal raw format. (For experts)
40.1	88
	89
44.1	90	[[image:attach:image2020-11-16_16-26-3.png\|\|height="400"]]
	91	{{/layout-cell}}
	92	{{/layout-section}}
41.1	93
44.1	94	{{layout-section ac:type="single"}}
	95	{{layout-cell}}
53.1	96	{{info}}
79.1	97	=== There are different options that help you to work with the FLASH HDF5 data in Python ===
40.1	98
78.1	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"]]
40.1	101
89.9	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]]
40.1	103	{{/info}}
44.1	104	{{/layout-cell}}
	105	{{/layout-section}}
40.1	106
44.1	107	{{layout-section ac:type="single"}}
	108	{{layout-cell}}
63.1	109
	110
45.1	111	== Complete list of recordable parameters ==
40.1	112
84.1	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"]].
1.1	114
79.1	115	== Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
1.1	116
30.1	117	{{id name="DOOCSparameters"/}}
	118
1.1	119
	120	=== FLASH1 ===
	121
93.2	122
93.5	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.
93.2	124
93.6	125	The previously used naming scheme (2024 and before) can be found here:
93.5	126
93.7	127	{{expand expanded="false" title="FLASH1 Naming scheme used until 2024"}}
95.1	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]]
93.7	243	{{/expand}}
93.6	244
95.1	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
1.1	552	==== Beamline info (FLASH1) ====
	553
79.1	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
1.1	559	units: mbar
	560
79.1	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 ...)
1.1	566	units: none
	567
79.1	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 ...)
1.1	573	units: none
	574
79.1	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}}
89.5	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]]
1.1	580	units: degree
	581
79.1	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}}
89.5	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]]
1.1	587	units: degree
	588
79.1	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
1.1	594	units: degree
	595
79.1	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
1.1	601	units: degree
	602
79.1	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
1.1	608	units: degree
8.1	609
1.1	610
8.1	611
34.1	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
8.1	613
4.1	614	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	615
8.1	616
39.1	617	==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html\|\|shape="rect"]]) ====
1.1	618
55.1	619	{{expand title="Discontinued GMD format (used until 2021)"}}
79.1	620	(% style="color:#000000" %)Discontinued GMD data recording / evaluation (VME + PhotonFlux ML server)
39.1	621
79.1	622	{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}
40.1	623	//always saved (PBD)//
34.1	624
79.1	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)
1.1	628	units : microJ
	629
79.1	630	{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
34.1	631	//always saved (PBD)//
	632
79.1	633	DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
	634	DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
1.1	635	desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
89.4	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]]
1.1	637
79.1	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
89.4	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]]
1.1	644
79.1	645	{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
34.1	646	//always saved (PBD)//
	647
79.1	648	DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}
	649	DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}
1.1	650	desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)
	651	units : microJ
	652
79.1	653	{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}
34.1	654	//always saved (PBD)//
	655
79.1	656	DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
	657	DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
1.1	658	desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
89.4	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]]
1.1	660
79.1	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
89.4	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]]
54.1	667	{{/expand}}
1.1	668
34.1	669
79.1	670	(% style="color:#000000; letter-spacing:0px" %)NEW (since 2021) GMD data recording / evaluation (same format as FLASH2 and XFEL)
54.1	671
79.1	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}}
39.1	676
79.1	677	desc : calibrated average SASE Energy/pulse measured in the TUNNEL upstream the gas attenuator
39.1	678	units : microJ
	679
	680
79.1	681	{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}
39.1	682	//always saved (PBD)//
	683
79.1	684	(% style="color:#000000" %)DOOCS prop :
39.1	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)
89.4	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]]
39.1	689
	690	{{info title="GMD pulse resolved data structure"}}
79.1	691	For every pulse in the pulse train the information is saved:
39.1	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)
79.1	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)(%%))
39.1	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
79.1	708
39.1	709	{{/info}}
	710
79.1	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 !
39.1	712
	713
	714	Besides pulse energy the GMD also provides information about the beam position
	715
79.1	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)
1.1	721	units : mm
	722
79.1	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)
1.1	728	units : mm
	729
79.1	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)
1.1	735	units : mm
	736
79.1	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)
1.1	742	units : mm
	743
39.1	744
	745	==== Spectrometer (FLASH1) ====
	746
79.1	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"
1.1	752	units :
	753
79.1	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"
1.1	759	units : nm
	760
79.1	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"
1.1	766	units : nm
	767
79.1	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}}
1.1	772	desc : XUV Spectrum in eV measured with the "PG2 spectrometer"
	773	units :
	774
79.1	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"
1.1	780	units : eV
	781
79.1	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"
1.1	787	units : eV
	788
79.1	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}}
1.1	793	desc : XUV Spectrum in nm measured with the "PG2 spectrometer"
	794	units :
	795
79.1	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"
1.1	801	units : nm
	802
79.1	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"
1.1	808	units : nm
	809
4.1	810	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	811
	812	==== Electron Beam properties (FLASH1) ====
	813
	814	===== bunch charge =====
	815
79.1	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)
1.1	821	units: nC
	822
5.1	823	=====
57.1	824	arrival time (BAM) =====
1.1	825
88.5	826	{{info title="BAM information: updates 2022 (status 2025)"}}
89.6	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"]]
57.1	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 ...
61.1	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)
57.1	831	* There has been also a renaming (and relocation) of the BAMs.
	832	** acc: 4DBC3 → FL0.DBC2
	833	** FL1: 1SFELC → FL1.SFELC
79.1	834	** FL2: FL2XTDS → (% style="color:#172b4d" %)FL2.SEED5
88.4	835	* for more Info: [[LINK to detailed infos from MSK>>doc:SDiag.How-to articles.BAM Data Structure.WebHome\|\|shape="rect"]]
89.10	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]]
57.1	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)"}}
79.1	841	(% style="color:#000000" %)Discontinued BAM data recording
57.1	842
79.1	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).
33.1	848	units: ps (bigger numbers indicate later arrivaltime of the electrons)
1.1	849
58.1	850
79.1	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.
58.1	856	units: ps (bigger numbers indicate later arrival time of the electrons)
57.1	857	{{/expand}}
33.1	858
68.1	859	====== BAM FL0.DBC2{{code language="none"}}{{/code}} ======
	860
79.1	861	(% style="color:#ff6600" %)DBC2/electron bunch arrival time (HDF5 name not yet implemented - see zraw)(%%)
68.1	862	//always saved (PBD)//
74.1	863	{{code language="none"}}/FL1/Electron Diagnostic/BAM/ {{/code}}DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE.SA1.COMP
79.1	864	DAQ (% style="color:#000000" %)channel: FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE.SA1.COMP (%%)
74.1	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).
68.1	866
74.1	867	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
68.1	868
	869
79.1	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)//
67.1	872	DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE
79.1	873	DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE (%%)
68.1	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).
58.1	875	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
	876
57.1	877
79.1	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)//
85.3	880	DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIM(% style="color:#000000" %)E.bamError.1(%%)
85.4	881	DAQ channel: (% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMERROR.1(%%)
85.2	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
57.1	883
58.1	884
79.1	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
57.1	890
	891
68.1	892	====== BAM FL1.SFELC{{code language="none"}}{{/code}} ======
	893
79.1	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)
68.1	895
	896	//always saved (PBD)//
79.1	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).
68.1	900	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
	901
	902
	903
79.1	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 (%%)
68.1	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).
58.1	909	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
	910
	911
79.1	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(%%)
58.1	916	desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
	917
	918
79.1	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(%%)
59.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
58.1	924
	925
33.1	926
1.1	927	===== electron beam profile =====
	928
79.1	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)
1.1	934	units: pixel
	935
79.1	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
1.1	941	units: fs per pixel
	942
79.1	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
1.1	948	units: fs
	949
	950	===== electron bunch energy =====
	951
79.1	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)
89.12	957	units: (% class="twikiNewLink" %)MeV
1.1	958
79.1	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
5.1	964	units: (% class="twikiNewLink" %)MeV
1.1	965
	966
79.1	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)
1.1	972	units: nm
	973
4.1	974	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	975
	976
5.1	977	==== Timing information, rep rate etc. (FLASH1) ====
1.1	978
	979	===== bunch repetition rate =====
	980
79.1	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}}
1.1	985	desc: repetition rate of the bunches / pulses within the burst (FLASH1)
	986	units: kHz
	987
	988	===== set number of pulses =====
	989
79.1	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)//
74.1	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
1.1	995	units:
	996
	997	===== actual number of pulses =====
	998
79.1	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)
1.1	1004	units:
	1005
	1006	===== actual pulse pattern recorded after the undulator =====
	1007
79.1	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)
1.1	1013	units:
	1014
	1015	===== Train ID =====
	1016
79.1	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 !)
1.1	1022	units:
	1023
89.12	1024	===== (% style="color:#e67e22" %)Train time(%%) =====
1.1	1025
89.12	1026	(% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
79.1	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
1.1	1028	units: d h min s cs
	1029
89.12	1030	(% style="color:#e67e22" %){{code language="none"}}/Timing/time stamp{{/code}}
79.1	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
1.1	1033	third column: Train ID of FLASH
	1034
91.1	1035	currently it is saved as Unix time in : /zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time
89.12	1036
92.1	1037	{{expand expanded="false" title="Timestamp help for python"}}
90.1	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
89.13	1048
4.1	1049	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	1050
	1051	==== Pump Probe Laser (FLASH1) ====
	1052
63.1	1053	PIGLET (PG laser)
62.1	1054
63.1	1055	{{code language="none"}}/FL1/Experiment/Pump probe laser{{/code}}
	1056
83.1	1057	{{info width="30%"}}
80.1	1058	list of saved parameters status May 2024 (up to now the parameters can be found in /zraw/ ... )
63.1	1059
82.1	1060	Download the PDF:
	1061
83.1	1062	{{view-file att--filename="FSLADAQ-DAQParameterlistPiGLET.pdf"}}{{/view-file}}
	1063
	1064
81.1	1065
80.1	1066	{{/info}}
69.1	1067
62.1	1068	{{expand title="Parameters used until 2021"}}
79.1	1069	{{code language="none"}}
	1070	/FL1/Experiment/Pump probe laser/laser attenuation
	1071	{{/code}}
5.1	1072
79.1	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)
1.1	1077	units : 0 no transmission , 1: full transmission
	1078
5.1	1079
79.1	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
1.1	1085	units : ps ( pos delay means IR comes later)
	1086
5.1	1087
79.1	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
1.1	1093	units : ps ( pos delay means IR comes later)
	1094
5.1	1095
79.1	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}}
2.1	1100	desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs
1.1	1101
	1102
79.1	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}}
52.1	1107	desc: delay time between the optical laser and the FEL units: ps
62.1	1108	{{/expand}}
1.1	1109
	1110
4.1	1111	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	1112
	1113
	1114	==== User Data (FLASH1) ====
	1115
52.1	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.
18.1	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
1.1	1122	===== GHz ADCs =====
	1123
89.7	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]]
79.1	1125	//saved on DEMAND in the user DAQ//
1.1	1126	\\The HDF5 names for the ADC traces are depending on the beamline :
79.1	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}}
1.1	1131	{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}
	1132
79.1	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}}
1.1	1141	{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}
	1142
79.1	1143	DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD or CH00.DAQ.TD{{/code}}
52.1	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.
1.1	1145	DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
	1146
18.1	1147	In addition there are also additional parameters saved like:
1.1	1148
16.1	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.
52.1	1150	* {{code language="none"}}number of samples{{/code}}: total number of samples recorded for each 10 Hz trigger
79.1	1151	* {{code language="none"}}error (ADC):{{/code}}0 indicates that there was no error
1.1	1152
	1153	===== MHz ADCs =====
	1154
79.1	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
1.1	1158	DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
	1159
18.1	1160	In addition there are also additional parameters saved like:
1.1	1161
18.1	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.
52.1	1163	* {{code language="none"}}number of samples{{/code}}: total number of samples recorded for each 10 Hz trigger
18.1	1164
4.1	1165	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	1166
18.1	1167
	1168
	1169
1.1	1170	=== FLASH2 ===
	1171
7.1	1172	There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs
1.1	1173
7.1	1174	==== Beamline info (FLASH2) ====
6.1	1175
79.1	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 (%%)
89.12	1181	(% style="color:#000000" %)units: mbar
5.1	1182
79.1	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 ...)
6.1	1188	units: none
5.1	1189
	1190
79.1	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
89.5	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]]
6.1	1196	units: degree
	1197
79.1	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}}
89.5	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]]
40.1	1203	units: degree
6.1	1204
8.1	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
6.1	1208	[[Contents>>doc:\|\|anchor="Contents"]]
	1209
	1210
	1211
10.1	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) ====
8.1	1213
79.1	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)
8.1	1219	units : microJ
	1220
	1221
79.1	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}}
38.1	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)
89.4	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]]
8.1	1228
39.1	1229	{{info title="GMD pulse resolved data structure"}}
79.1	1230	For every pulse in the pulse train the information is saved:
8.1	1231
38.1	1232	1. Intensity per pulse (a.u. (more or less µJ ))
	1233	1. Intensity per pulse (auxillary GMD) - not used
39.1	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)
79.1	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)(%%))
38.1	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
8.1	1240
38.1	1241	The pulse energy and the error are plotted for the first bunch of the pulse trains saved in this
	1242	file
8.1	1243
38.1	1244
	1245	[[image:attach:image2021-2-9_10-51-6.png\|\|height="250"]]
8.1	1246
79.1	1247
39.1	1248	{{/info}}
38.1	1249
8.1	1250
79.1	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 !
8.1	1252
	1253
9.1	1254	Besides pulse energy the GMD also provides information about the beam position
8.1	1255
9.1	1256
79.1	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)
8.1	1262	units : mm
	1263
9.1	1264
79.1	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)
8.1	1270	units : mm
	1271
	1272
79.1	1273	/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel x
40.1	1274	always saved (PBD2)
	1275	DOOCS prop : FLASH.FEL/XGM.BPM/FL2.HALL/X.TD
79.1	1276	DAQ channel: FLASH.FEL/XGM.BPM/FL2.HALL:2
40.1	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
8.1	1279
40.1	1280	(x=horizontal, y = vertial)
9.1	1281
	1282	again the same parameter set is available for the HALL GMD
	1283
8.1	1284
9.1	1285
15.1	1286	==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html\|\|shape="rect"]](FLASH2) ====
10.1	1287
19.1	1288	for more info see: [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html\|\|shape="rect"]]
10.1	1289
	1290	(The OPIS hall is not installed yet ...)
	1291
9.1	1292
10.1	1293	{{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean photon energy{{/code}}
79.1	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}}
10.1	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
9.1	1300
10.1	1301	{{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelength{{/code}}
79.1	1302	// saved opon request (PBD2)//
	1303	DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
10.1	1304	DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}
52.1	1305	desc : mean wavelength ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)
10.1	1306	units : nm
	1307
9.1	1308
10.1	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}}
79.1	1310	// saved opon request (PBD2)//
	1311	DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
10.1	1312	DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}
11.1	1313	desc : The bunch number of the bunch used for the wavelength calculation
	1314	units :
10.1	1315
9.1	1316
52.1	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"]])
11.1	1318
9.1	1319
52.1	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 ...
12.1	1321
9.1	1322
	1323
12.1	1324	==== Electron Beam properties (FLASH2) ====
	1325
	1326	===== bunch charge =====
	1327
79.1	1328	{{code language="none"}}/FL2/Electron Diagnostic/Bunch charge/after undulator{{/code}}
	1329	//always saved (PBD2)//
12.1	1330	DOOCS prop : {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2{{/code}}
79.1	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).
12.1	1333	units: nC
	1334
9.1	1335
52.1	1336	===== electron bunch energy =====
9.1	1337
52.1	1338	{{code language="none"}}/FL2/Electron Diagnostic/Electron energy/energy of first bunch/behind undulators{{/code}}
79.1	1339	//always saved (PBD2)//
52.1	1340	DOOCS prop : {{code language="none"}}FLASH.DIAG/BEAM_ENERGY_MEASUREMENT/FL2XTDS/ENERGY.FLASH2{{/code}}
79.1	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
52.1	1343
79.1	1344	(% style="letter-spacing:0.0px" %)units: (% class="twikiNewLink" %)MeV
52.1	1345
	1346
83.1	1347	(% style="color: rgb(94, 108, 132); font-weight: 600; letter-spacing: 0px;" %)
	1348	===== undulator settings =====
52.1	1349
79.1	1350	{{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/set wavelength{{/code}}
	1351	//always saved (PBD2)//
14.1	1352	DOOCS prop : {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
79.1	1353	DAQ channel: {{code language="none"}}TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH{{/code}}
14.1	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
12.1	1356
79.1	1357	{{code language="none"}}/FL2/Electron Diagnostic/Undulator setting/SASE14 gap{{/code}}
	1358	//always saved (PBD2)//
14.1	1359	DOOCS prop : {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
79.1	1360	DAQ channel: {{code language="none"}}FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP{{/code}}
15.1	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
14.1	1362	units: mm
	1363
15.1	1364	The gap values are saved for all 12 undulators (Nr 3 to 14). Undulator 14 is the one closest to the experimental hall.
14.1	1365
12.1	1366	=====
59.1	1367	arrival time (BAM) =====
12.1	1368
89.1	1369	{{info title="BAM information: updates 2022 (status 2025)"}}
89.6	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"]]
59.1	1371	* The data format of the BAM has been completely altered in the 2022 shutdown
88.5	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 ...
61.1	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)
59.1	1374	* There has been also a renaming (and relocation) of the BAMs.
	1375	** acc: 4DBC3 → FL0.DBC2
	1376	** FL1: 1SFELC → FL1.SFELC
88.5	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"]]
89.10	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]]
59.1	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)"}}
79.1	1384	(% style="color:#000000" %)Discontinued BAM data recording
59.1	1385
79.1	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)
33.1	1391	units: ps (bigger numbers indicate later arrivaltime of the electrons)
	1392
79.1	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)
14.1	1398	units: ps (bigger numbers indicate later arrivaltime of the electrons)
12.1	1399
80.1	1400	{{info title="BAM hints"}}
79.1	1401	* The BAM 4DBC3 measures the arrivaltime of FLASH 1 and FLASH2 in the same data set (thus also sorted in at /FL1/ !).
33.1	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
89.10	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]]
79.1	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"]]
33.1	1406	* a recent [[talk about the working principle of the BAM>>attach:BAM-basics and outlook-2018_DESY-template_16-9Format.pdf]]
	1407	{{/info}}
59.1	1408	{{/expand}}
10.1	1409
68.1	1410
	1411	====== BAM FL0.DBC2{{code language="none"}}{{/code}} ======
	1412
79.1	1413	(% style="color:#ff6600" %)DBC2/electron bunch arrival time (HDF5 name not yet implemented - see zraw){{code language="none"}}/FL2/Electron Diagnostic/BAM/{{/code}}
73.1	1414
79.1	1415	{{code language="none"}}
	1416	/zraw/FLASH.SDIAG/BAM.DAQ/FL0.DBC2.ARRIVAL_TIME.ABSOLUTE.SA2.COMP/dGroup/
	1417	{{/code}}
73.1	1418
68.1	1419	//always saved (PBD)//
	1420	FL0.DBC2
79.1	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).
68.1	1423	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
	1424
	1425
79.1	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}}
73.1	1427
	1428	{{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.DBC2.ARRIVAL_TIME.ABSOLUTE.SA2/dGroup/{{/code}}
79.1	1429	//always saved (PBD)//
68.1	1430	{{code language="none"}}DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE{{/code}}
79.1	1431	(% style="color:#000000" %)FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.ABSOLUTE {{code language="none"}}DAQ channel: {{/code}}(%%)
68.1	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).
59.1	1433	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
14.1	1434
59.1	1435
85.7	1436	DBC2/error (% style="color:#f39c12" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
85.5	1437	//always saved (PBD)//
85.6	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 !!
85.5	1441
85.7	1442	DBC2/status (% style="color:#e67e22" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
85.5	1443	//always saved (PBD)//
85.7	1444	DOOCS prop : FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.bamStatus.//2//
	1445	DAQ channel: FLASH.SDIAG/BAM/FL0.DBC2/ARRIVAL_TIME.BAMSTATUS.2
85.5	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
68.1	1450	====== BAM FL2.SEED5{{code language="none"}}{{/code}} ======
	1451
79.1	1452	/FL2/Electron Diagnostic/BAM/SEED5(% style="color:#ff6600" %)/electron bunch arrival time (HDF5 name not yet implemented - see zraw)
68.1	1453
79.1	1454	(% style="color:#000000" %){{code language="none"}}/zraw/FLASH.SDIAG/BAM.DAQ/FL0.SEED5.ARRIVAL_TIME.ABSOLUTE.SA2.COMP/dGroup/{{/code}}
73.1	1455
68.1	1456	//always saved (PBD)//
79.1	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
74.1	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).
68.1	1460	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
	1461
	1462
	1463
79.1	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}}
73.1	1465
79.1	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}}(%%)
68.1	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).
59.1	1471	units: fs (bigger numbers (typically) indicate later arrival times of the electrons).
	1472
	1473
85.8	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
86.1	1477	DAQ channel: FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.BAMERROR.2
85.8	1478	desc: If the value is 0 , the BAM is working well. If it is non-zero there is a problem !!
59.1	1479
86.1	1480	FL2.SEED5/status (% style="color:#e67e22" %)(HDF5 name not yet implemented - see zraw)(%%)/FL2/Electron Diagnostic/BAM/
85.8	1481	//always saved (PBD)//
86.1	1482	DOOCS prop : FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.bamStatus.//2//
	1483	DAQ channel: FLASH.SDIAG/BAM/FL2.SEED5/ARRIVAL_TIME.BAMSTATUS.2
85.8	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
15.1	1487	[[Contents>>doc:\|\|anchor="Contents"]]
12.1	1488
	1489
16.1	1490	==== Timing information, rep rate etc. (FLASH2) ====
12.1	1491
15.1	1492	===== start time of FLASH2 =====
12.1	1493
79.1	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}}
17.1	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 ...)
15.1	1499	units: µs
12.1	1500
	1501	===== bunch repetition rate =====
	1502
79.1	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}}
15.1	1507	desc: repetition rate of the bunches / pulses within the burst (FLASH2)
12.1	1508	units: kHz
	1509
74.1	1510
	1511	===== set number of pulses =====
	1512
79.1	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)//
74.1	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
12.1	1520	===== actual number of pulses =====
	1521
79.1	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)
12.1	1527	units:
	1528
	1529	===== actual pulse pattern recorded after the undulator =====
	1530
79.1	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)
12.1	1536	units:
	1537
	1538	===== Train ID =====
	1539
79.1	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 !)
12.1	1545	units:
	1546
93.1	1547	===== (% style="color:#e67e22" %)Train time(%%) =====
12.1	1548
93.2	1549	(% style="color:#e67e22" %)//always saved (PBD2)//(%%)
	1550	(% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
79.1	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
12.1	1552	units: d h min s cs
	1553
79.1	1554	{{code language="none"}}
	1555	/Timing/time stamp
	1556	{{/code}}
16.1	1557
93.2	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
79.1	1560	second column: microseconds
12.1	1561	third column: Train ID of FLASH
	1562
93.1	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
12.1	1580	[[Contents>>doc:\|\|anchor="Contents"]]
	1581
	1582
19.1	1583	==== User Data (FLASH2) ====
18.1	1584
19.1	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
18.1	1591	===== GHz ADCs =====
	1592
89.7	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]]
79.1	1594	//saved on DEMAND in the user DAQ//
19.1	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}}
18.1	1599
	1600
79.1	1601	DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD or CH00.DAQ.TD{{/code}}
18.1	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.
19.1	1603	DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
18.1	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
79.1	1609	* {{code language="none"}}error (ADC):{{/code}}0 indicates that there was no error
18.1	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
79.1	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
19.1	1617	DAQ channel: : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02
18.1	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
12.1	1626
	1627
85.1	1628	==== Pump Probe Laser (FLASH2) ====
21.1	1629
84.1	1630	{{info width="30%"}}
80.1	1631	list of saved parameters status May 2024 (up to now the parameters can be found in /zraw/ ... )
	1632
84.1	1633	[[attach:FSLADAQ-DAQParameterlistULGAN-2.pdf\|\|target="_blank"]]
80.1	1634
84.1	1635	[[attach:FSLADAQ-DAQParameterlistFL23-2.pdf\|\|target="_blank"]]
80.1	1636
84.1	1637	[[attach:FSLADAQ-DAQParameterlistFL24-2.pdf\|\|target="_blank"]]
	1638
	1639
	1640	{{view-file att--filename="FSLADAQ-DAQParameterlistFL23-2.pdf"}}{{/view-file}}
	1641
85.1	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
84.1	1648
80.1	1649	{{/info}}
	1650
85.1	1651	{{expand title="Laser parameters used until 2023"}}
79.1	1652	These are the parameters that can be saved in the FL2 User DAQ for the FL2 PP laser// FOR BEAMLINE FL24//
21.1	1653
64.1	1654	User delay
	1655
	1656	Delay (set value):
	1657
79.1	1658	{{code language="none"}}
	1659	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR
	1660	{{/code}}
64.1	1661
77.1	1662	Delay (readback):
64.1	1663
79.1	1664	{{code language="none"}}
	1665	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
	1666	{{/code}}
64.1	1667
79.1	1668	(% style="letter-spacing:0.0px" %)Delay (encoder readback):
77.1	1669
79.1	1670	{{code language="none"}}
	1671	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.ENCODER_POSITION.RD
	1672	{{/code}}
77.1	1673
64.1	1674	OXC. jitter:
	1675
79.1	1676	{{code language="none"}}
	1677	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
	1678	{{/code}}
64.1	1679
	1680
	1681
77.1	1682	FL24 Pulse resolved energy:
	1683
72.1	1684	OPCPA output (photodiode signal raw ADC trace 16000 samples):
64.1	1685
79.1	1686	{{code language="none"}}
	1687	/zraw/FLASH.LASER/FLASH2CPUULGAN1.ADCSCOPE/CH23.TD/dGroup
	1688	{{/code}}
64.1	1689
79.1	1690	(% style="letter-spacing:0.0px" %)Upper breadboard Photodiode (THG) burst (photodiode signal raw ADC trace 16000 samples)::
64.1	1691
79.1	1692	{{code language="none"}}
	1693	/zraw/FLASH.LASER/FLASH2CPUULGAN1.ADCSCOPE/CH26.TD/dGroup
	1694	{{/code}}
64.1	1695
72.1	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.)
64.1	1697
79.1	1698	{{code language="none"}}
	1699	/zraw/FLASH.LASER/MOD24.PES/FL24_userPD/dGroup
	1700	{{/code}}
64.1	1701
	1702
77.1	1703	FL24 LAM (Laser Arrivaltime Monitor) pulse resolved data:
64.1	1704
72.1	1705	Signal of Photodiode1 - for experts only... (analyzed signal. integration over pulses in the ADC trace. )
	1706
79.1	1707	{{code language="none"}}
	1708	/zraw/FLASH.LASER/MOD24.PES/LAM.PD1/dGroup
	1709	{{/code}}
72.1	1710
	1711	Signal of Photodiode2 - for experts only... (analyzed signal. integration over pulses in the ADC trace.)
	1712
79.1	1713	{{code language="none"}}
	1714	/zraw/FLASH.LASER/MOD24.PES/LAM.PD2/dGroup
	1715	{{/code}}
72.1	1716
	1717	"Actual" LAM Signal - to be calibrated ...... (analyzed signal. integration over pulses in the ADC trace.)
	1718
79.1	1719	{{code language="none"}}
	1720	/zraw/FLASH.LASER/MOD24.PES/LAM.PDBAL/dGroup
	1721	{{/code}}
72.1	1722
79.1	1723	The delay feedback(% style="letter-spacing:0.0px" %)
75.1	1724
79.1	1725	{{code language="none"}}
	1726	FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26
	1727	{{/code}}
64.1	1728
79.1	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):
75.1	1730
79.1	1731	{{code language="none"}}
	1732	FLASH.LASER/MOD24.PES/LAM.PDBAL/PULSEENERGY.MEAN
	1733	{{/code}}
75.1	1734
76.1	1735	LAM Delay line act:
75.1	1736
76.1	1737	{{code language="none"}}FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.POSITION.RD{{/code}}
	1738	LAM Delay line set:
75.1	1739
79.1	1740	{{code language="none"}}
	1741	FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.POSITION_SET.WR
	1742	{{/code}}
75.1	1743
76.1	1744	LAM Delay line encoder:
75.1	1745
79.1	1746	{{code language="none"}}
	1747	FLASH.SYNC/LAM.EXP.ODL/F2.MOD.AMC12/FMC0.MD22.1.ENCODER_POSITION.RD
	1748	{{/code}}
75.1	1749
76.1	1750	Temperature feedback:
75.1	1751
79.1	1752	{{code language="none"}}
	1753	FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE24
	1754	{{/code}}
75.1	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
79.1	1758	{{code language="none"}}
	1759	FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.INTS/INTEGER30
	1760	{{/code}}
75.1	1761
	1762
77.1	1763	FL24 Attenuator angle:
75.1	1764
79.1	1765	{{code language="none"}}
	1766	FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
	1767	{{/code}}
64.1	1768
77.1	1769	FL24 Polarization control:
64.1	1770
79.1	1771	{{code language="none"}}
	1772	FLASH.FEL/FLAPP2BEAMLINES/MOTOR14.FL24/FPOS
	1773	{{/code}}
64.1	1774
	1775	SysDC delay error:
	1776
79.1	1777	{{code language="none"}}
	1778	FLASH.LASER/ULGAN1.DYNPROP/TCFIBER.DOUBLES/DOUBLE26
	1779	{{/code}}
64.1	1780
	1781
	1782	Timing error: (these two need to be observed and both=0 means no error)
	1783
79.1	1784	{{code language="none"}}
	1785	FLASH/CPUULGAN1.TIMING/ULGAN1/dT_alarm
	1786	{{/code}}
64.1	1787
79.1	1788	{{code language="none"}}
	1789	FLASH/CPUULGAN1.TIMING/ULGAN1/dMPN
	1790	{{/code}}
64.1	1791
	1792	Laser error status:
	1793
	1794
77.1	1795	FL24 Virtual camera X and Y history, beam size: (use slow data)
64.1	1796
79.1	1797	{{code language="none"}}
	1798	FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.X
	1799	{{/code}}
64.1	1800
79.1	1801	{{code language="none"}}
	1802	FLASH.LASER/MOD24.BEAMPOS/UV.VF_BP/CENTER.Y
	1803	{{/code}}
64.1	1804
79.1	1805	{{code language="none"}}
	1806	FLASH.LASER/MOD24.CAM/UV.14.VF/ROI_SPECTRUM.X.SIG
	1807	{{/code}}
64.1	1808
	1809	{{expand title="Parameters used until 2021"}}
79.1	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)
21.1	1814	units : deg.
	1815
12.1	1816
21.1	1817
79.1	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)
21.1	1822	units : deg.
	1823
12.1	1824
79.1	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}}
21.1	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
12.1	1832
79.1	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}}
22.1	1837	desc: rms jitter of the fs-Oscillator
	1838	units: fs
65.1	1839	{{/expand}}
21.1	1840
77.1	1841
	1842	==== FL 26 Pump Probe Laser (FLASH2) ====
	1843
79.1	1844	These are the parameters that can be saved in the FL2 User DAQ for the FL2 PP laser// FOR BEAMLINE FL26//
77.1	1845
	1846
	1847	User delay
	1848
	1849	Delay (set value):
	1850
79.1	1851	{{code language="none"}}
	1852	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION_SET.WR
	1853	{{/code}}
77.1	1854
	1855	Delay (readback):
	1856
79.1	1857	{{code language="none"}}
	1858	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.POSITION.RD
	1859	{{/code}}
77.1	1860
78.1	1861	Delay (encoder readback):
77.1	1862
79.1	1863	{{code language="none"}}
	1864	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/FMC0.MD22.0.ENCODER_POSITION.RD
	1865	{{/code}}
77.1	1866
	1867	OXC. jitter:
	1868
79.1	1869	{{code language="none"}}
	1870	FLASH.SYNC/LASER.LOCK.EXP/F2.PPL.OSC/CURRENT_INPUT_JITTER.RD
	1871	{{/code}}
77.1	1872
	1873
	1874	Parameters for FL26
	1875
78.1	1876	(% class="wrapped" %)
77.1	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	)))
85.1	2007	{{/expand}}
21.1	2008
	2009
85.1	2010
23.1	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
1.1	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
45.1	2025	(% class="wrapped" %)
1.1	2026	\|=(((
4.1	2027	earlier HDF path (vers. 0.2)
1.1	2028	)))\|=(((
4.1	2029	is now (vers. 0.3)
1.1	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
4.1	2122	[[Contents>>doc:\|\|anchor="Contents"]]
1.1	2123
79.1	2124
44.1	2125	{{/layout-cell}}
	2126	{{/layout-section}}
	2127	{{/layout}}

Wiki source code of The FLASH HDF5 structure

Applications

Navigation