The FLASH HDF5 structure

1

== Contents ==

2

3

\\

4

5

* [[General information about HDF5>>doc:||anchor="General information about HDF5"]]

6

* [[FLASH HDF5 structure>>doc:||anchor="FLASH HDF5 structure"]]

7

* [[Most popular FLASH parameters and their names in HDF5>>doc:||anchor="Most popular FLASH parameters and their names in HDF5"]]

8

** [[FLASH1>>doc:||anchor="FLASH1"]]

9

*** [[Beamline info (FLASH1)>>doc:||anchor="Beamline info (FLASH1)"]]

10

*** [[Photon Diagnostics SASE / Spectrometer (FLASH1)>>doc:||anchor="Photon Diagnostics SASE / Spectrometer (FLASH1)"]]

11

*** [[Electron Beam properties (FLASH1)>>doc:||anchor="Electron Beam properties (FLASH1)"]]

12

*** [[Timing information, rep rate etc.(FLASH1)>>doc:||anchor="Timing information, rep rate etc.(FLASH1)"]]

13

*** [[Pump Probe Laser (FLASH1)>>doc:||anchor="Pump Probe Laser (FLASH1)"]]

14

*** [[User Data (FLASH1)>>doc:||anchor="User Data (FLASH1)"]]

15

** [[FLASH2>>doc:||anchor="FLASH2"]]

16

** [[HDF5 structure revisions>>doc:||anchor="HDF5 structure revisions"]]

17

* [[Example code showing how to access HDF5 files>>doc:||anchor="Example code showing how to access HDF5 files"]]

18

** [[Samples how to read HDF5 with Matlab>>doc:||anchor="Samples how to read HDF5 with Matlab"]]

19

** [[How to read HDF5 with Python via FLASHH5>>doc:||anchor="How to read HDF5 with Python via FLASHH5"]]

20

* [[HDF5 and DOOCS>>doc:||anchor="HDF5 and DOOCS"]]

\\

\\

== General information about HDF5 ==

27

28

HDF5 is a data format maintained by the HDF group. For detailed general information see [[here~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://www.hdfgroup.org/HDF5/||shape="rect"]]

29

30

To download the HDF5 Viewer click [[here~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://support.hdfgroup.org/products/java/hdfview/index.html||shape="rect"]]

31

32

For use on the DESY Maxwell or PAL (max-fsc or pal) **hdfview** is available in the xray module :

33

{{code language="none"}}> module load xray{{/code}}

34

{{code language="none"}}> hdfview{{/code}}

35

36

[[Contents>>doc:||anchor="Contents"]]

37

38

== FLASH HDF5 structure ==

39

40

The photon diagnostic, electron diagnostic and beamline information as well as the information about the pump-probe laser and the infrastructure offered for users (GHz/MHz ADCs) can be included in one HDF5 file which is organised according to train IDs. The general structure is:

41

42

* Electron Diagnostic

* Photon Diagnostics

* Beamlines

* Experiment

* Timing

[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/HDF5main/HDF5_structure.jpg~|~|alt="HDF5_structure.jpg" width="700" height="500"~]~]>>attach:HDF5_structure.jpg]]

48

49

A detailled description of (most) channels can be found in the lower part of the hdf5 viewer:

50

[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/HDF5main/HDF5_structure_desc.jpg~|~|alt="HDF5_structure_desc.jpg" width="341" height="413"~]~]>>attach:HDF5_structure_desc.jpg]]

51

52

[[Contents>>doc:||anchor="Contents"]]

\\

== Most popular FLASH parameters and their names in HDF5 ==

57

58

The complete list for the relation between DOOCS names and HDF5 names for the recordable parameters can be found in [[DESY's Repository~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://stash.desy.de/projects/CS/repos/pah/browse/src/camp/data/channel2HdfName.dat||shape="rect"]].

59

The most common and often used ones are summarized below:

60

61

Note, the HDF group and data set names apply to our HDF tree version since vers. 0.3.0.

\\

=== FLASH1 ===

\\

==== Beamline info (FLASH1) ====

70

71

{{code language="none"}}/FL1/Beamlines/Attenuator/pressure{{/code}}

72

//always saved (PBD)//

73

DOOCS prop : {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}

74

DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}

75

desc: set pressure in the gas attenuator

units: mbar

\\

{{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}

80

//always saved (PBD)//

81

DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER/CH00.TD{{/code}}

82

DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/BL.SHUTTER{{/code}}

83

desc: BL Beamline Fast shutter state

units: none

\\

{{code language="none"}}/FL1/Beamlines/PG/Fast shutter/open{{/code}}

88

//always saved (PBD)//

89

DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER/CH00.TD{{/code}}

90

DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL1FS/PG.SHUTTER{{/code}}

91

desc: PG Beamline Fast shutter state

units: none

\\

{{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 1{{/code}}

96

//always saved (PBD)//

97

DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}

98

DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}

99

desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]

units: degree

\\

{{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}

104

//always saved (PBD)//

105

DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}

106

DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}

107

desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]

units: degree

\\

{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}

112

//always saved (PBD)//

113

DOOCS prop : = TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS=

114

DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}

115

desc: Position of the PG filter wheel 1

units: degree

\\

{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}

120

//always saved (PBD)//

121

DOOCS prop : {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}

122

DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}

123

desc: Position of the PG filter wheel 2

units: degree

\\

{{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}

128

//always saved (PBD)//

129

DOOCS prop : {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}

130

DAQ channel: {{code language="none"}}TTF2.FEL/PGFILTERS/PGFILTERS/FW.MOTOR.POS{{/code}}

131

desc: Position of the PG filter wheel 3

units: degree

\\

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

138

139

[[Contents>>doc:||anchor="Contents"]]

\\

==== Photon Diagnostics SASE ([[GMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]]) / Spectrometer (FLASH1) ====

144

145

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}

146

//always saved (PBD)//

147

DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT04/VAL{{/code}}

148

DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENPULSEIC{{/code}}

149

desc : calibrated average SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)

150

units : microJ

151

152

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}

153

//always saved (PBD)//

154

DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}

155

DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}

156

desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL

157

units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]

158

159

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}

160

//always saved (PBD)//

161

DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}

162

DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}

163

desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise

164

units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]

165

166

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}

167

//always saved (PBD)//

168

DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT05/VAL{{/code}}

169

DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENPULSEIC{{/code}}

170

desc : calibrated average SASE Energy/pulse measured in the BDA (in the experimental hall) after the attenuator (ion current)

171

units : microJ

172

173

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA{{/code}}

174

//always saved (PBD)//

175

DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}

176

DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}

177

desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL

178

units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]

179

180

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}

181

//always saved (PBD)//

182

DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}

183

DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}

184

desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise

185

units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]

186

187

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}

188

//always saved (PBD)//

189

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}

190

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}

191

desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, x=horizontal)

192

units : mm

193

194

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}

195

//always saved (PBD)//

196

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}

197

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}

198

desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, y=vertical)

199

units : mm

200

201

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}

202

//always saved (PBD)//

203

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}

204

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}

205

desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, x=horizontal)

206

units : mm

207

208

{{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}

209

//always saved (PBD)//

210

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}

211

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}

212

desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, y=vertical)

213

units : mm

214

215

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}

216

_always saved (when Spectrum is measured !!) (PBD) _

217

DOOCS prop : {{code language="none"}}TTF2.EXP/PHOTONWL.ML/WAVE_LENGTH/VAL.TD{{/code}}

218

DAQ channel: {{code language="none"}}PBD.PHOTONWL.ML/WAVE_LENGTH{{/code}}

219

desc : XUV Spectrum measured with the "tunnel spectrometer"

220

units :

221

222

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength start value{{/code}}

223

_always saved (when Spectrum is measured !!) (PBD) _

224

DOOCS prop : {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}

225

DAQ channel: {{code language="none"}}TTF2.EXP/PBD.PHOTONWL.ML/BSTART/VAL{{/code}}

226

desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"

227

units : nm

228

229

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength increment{{/code}}

230

_always saved (when Spectrum is measured !!) (PBD) _

231

DOOCS prop : ==

232

DAQ channel: ==

233

desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "tunnel spectrometer"

234

units : nm

235

236

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy{{/code}}

237

//saved on DEMAND (PBD spectrometer stream)//

238

DOOCS prop : ==

239

DAQ channel: {{code language="none"}}PBD.PHOTONEN.ML/PHOTON_ENERGY{{/code}}

240

desc : XUV Spectrum in eV measured with the "PG2 spectrometer"

241

units :

242

243

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy start value{{/code}}

244

//saved on DEMAND (PBD spectrometer stream)//

245

DOOCS prop : ==

246

DAQ channel: ==

247

desc : start value (in eV) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"

248

units : eV

249

250

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon energy increment{{/code}}

251

//saved on DEMAND (PBD spectrometer stream)//

252

DOOCS prop : ==

253

DAQ channel: ==

254

desc : increment value (in eV) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"

255

units : eV

256

257

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength{{/code}}

258

//saved on DEMAND (PBD spectrometer stream)//

259

DOOCS prop : ==

260

DAQ channel: {{code language="none"}}PHOTONEN.ML/PHOTON_WAVE_LEN{{/code}}

261

desc : XUV Spectrum in nm measured with the "PG2 spectrometer"

262

units :

263

264

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength increment{{/code}}

265

//saved on DEMAND (PBD spectrometer stream)//

266

DOOCS prop : ==

267

DAQ channel: ==

268

desc : start value (in nm) for the wavelength axis of the XUV Spectrum measured with the "PG2 spectrometer"

269

units : nm

270

271

{{code language="none"}}/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value{{/code}}

272

//saved on DEMAND (PBD spectrometer stream)//

273

DOOCS prop : ==

274

DAQ channel: ==

275

desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"

276

units : nm

277

278

[[Contents>>doc:||anchor="Contents"]]

279

280

==== Electron Beam properties (FLASH1) ====

281

282

===== bunch charge =====

283

284

{{code language="none"}}/FL1/Electron Diagnostic/Bunch charge/after undulator{{/code}}

285

//always saved (PBD)//

286

DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/CHARGE.FLASH1{{/code}}

287

DAQ channel: {{code language="none"}}FLASH.DIAG/TOROID/12EXP{{/code}}

288

desc: electron bunch charge (FLASH1)

units: nC

=====

arrival time =====

{{code language="none"}}/FL1/Electron Diagnostic/BAM/4DBC3/electron bunch arrival time (low charge){{/code}}

295

//always saved (PBD)//

296

DOOCS prop : {{code language="none"}}FLASH.SDIAG/BAM/4DBC3/LOW_CHARGE_ARRIVAL_TIME{{/code}}

297

DAQ channel: {{code language="none"}}FLASH.SDIAG/BAM.DAQ/4DBC3.LOW_CHARGE_ARRIVAL_TIME{{/code}}

298

desc: Electron bunch arrival time measured with the BAM (more or less) before the undulator (pulse resolved data)

299

units: ps (bigger numbers indicate later arrivaltime of the electrons)

300

note: besides the arivaltime from FLASH1 there is also the FLASH2/3 electron arrival time saved. [[LINK to detailled infos from MSK (may only work inside DESY network~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://www.desy.de/~~mbock/pages/BAM_daq_channel_descriptions.html||shape="rect"]] and to a recent [[talk about the working principle of the BAM>>url:https://confluence.desy.de/download/attachments/134216957/BAM-basics_and_outlook-2018_DESY-template_16-9Format.pdf?version=1&modificationDate=1565162143328&api=v2||shape="rect"]]

301

302

===== electron beam profile =====

303

304

{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile{{/code}}

305

//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//

306

DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/OUT.PROF.CCCED{{/code}}

307

DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}

308

desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)

units: pixel

\\

{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}

313

//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//

314

DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/CALIB.CONST.T{{/code}}

315

DAQ channel: = PBD.BEAM.PROF.ML/CCT=

316

desc: TDS calibration constant for the x-axis of the profiles: fs per pixel

units: fs per pixel

\\

{{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}

321

//always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//

322

DOOCS prop : {{code language="none"}}TTF2.DAQ/BEAM.PROF.ML/BEAM.PROF/SOWS.W.CCTED{{/code}}

323

DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/PROFWIDTHCCTED{{/code}}

324

desc: rms pulse width of the measures TDS electron bunch profile

325

units: fs

326

327

===== electron bunch energy =====

328

329

{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/average electron energy{{/code}}

330

_always saved (PBD)

331

DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}

332

DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}

333

desc: electron bunch energy (average over the bunch train)

334

units: (% class="twikiNewLink" %)MeV(%%)

335

\\

336

337

{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}

338

_always saved (PBD)

339

DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_SPECT/VAL.TD{{/code}}

340

DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_SPECT{{/code}}

341

desc: electron bunch energy bunch resolved

342

units: (% class="twikiNewLink" %)MeV

\\

{{code language="none"}}/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average{{/code}}

347

_always saved (PBD)

348

DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL{{/code}}

349

DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}

350

desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)

units: nm

\\

[[Contents>>doc:||anchor="Contents"]]

\\

==== Timing information, rep rate etc. (FLASH1) ====

359

360

===== bunch repetition rate =====

361

362

{{code language="none"}}/FL1/Timing/repetition rate{{/code}}

363

//always saved (PBD)//

364

DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/REP_RATE_KHZ.1{{/code}}

365

DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}

366

desc: repetition rate of the bunches / pulses within the burst (FLASH1)

units: kHz

\\

===== set number of pulses =====

371

372

{{code language="none"}}/FL1/Timing/set number of bunches{{/code}}

373

//always saved (PBD)//

374

DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH1{{/code}}

375

DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_NUM{{/code}}

376

desc: Number of pulses set at the gun (FLASH1)

377

units:

378

379

===== actual number of pulses =====

380

381

{{code language="none"}}/FL1/Timing/actual number of bunches{{/code}}

382

//always saved (PBD)//

383

DOOCS prop : {{code language="none"}}FLASH.DIAG/TOROID.ML/12EXP/NUMBEROFBUNCHES.FLASH1{{/code}}

384

DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}

385

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)

units:

\\

===== actual pulse pattern recorded after the undulator =====

390

391

{{code language="none"}}/FL1/Timing/Bunch pattern/pattern after undulator{{/code}}

392

//always saved (PBD)//

393

DOOCS prop : {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP/CHARGE.TD{{/code}}

394

DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}

395

desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH1)

units:

\\

===== Train ID =====

{{code language="none"}}/Timing/train ID{{/code}}

402

//always saved (PBD)//

403

DOOCS prop : {{code language="none"}}none{{/code}}

404

DAQ channel: {{code language="none"}}none{{/code}}

405

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 !)

units:

\\

===== Train time =====

410

411

{{code language="none"}}/Timing/train time{{/code}}

412

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

units: d h min s cs

\\

{{code language="none"}}/Timing/time stamp{{/code}}

417

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

418

second column: microseconds

419

third column: Train ID of FLASH

420

\\

421

422

[[Contents>>doc:||anchor="Contents"]]

\\

==== Pump Probe Laser (FLASH1) ====

427

428

{{code language="none"}}/FL1/Experiment/Pump probe laser/laser attenuation{{/code}}

429

430

//always saved (PBD)//

431

DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}

432

DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/ROT2.CURRENT{{/code}}

433

desc: attenuation of the PPLaser (rotation of a waveplate)

434

units : 0 no transmission , 1: full transmission

\\

{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay{{/code}}

439

//always saved (PBD)//

440

DOOCS prop : {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}

441

DAQ channel: {{code language="none"}}TTF2.FEL/PPDELAYCAL/PPDELAYCAL/DLY1.CURRENT{{/code}}

442

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

443

units : ps ( pos delay means IR comes later)

\\

{{code language="none"}}/FL1/Experiment/Pump probe laser/delay line IK220.0/ENC.DELAY{{/code}}

448

//always saved (PBD)//

449

DOOCS prop : {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0/ENC.DELAY{{/code}}

450

DAQ channel: {{code language="none"}}TTF2.FEL/DELLINE.ENC/IK220.0:ENC.DELAY{{/code}}

451

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

452

units : ps ( pos delay means IR comes later)

\\

{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO{{/code}}

457

//always saved (PBD)//

458

DOOCS prop : {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}

459

DAQ channel: {{code language="none"}}FLASH.SYNC/F1PPL.LASER_LOCK/28C.F1PPL1.CONTROLLER/ADV_CTRL_MANAGER.0.PID_INPUT_JITTER.2.RD{{/code}}

460

desc: rms jitter of the GECCO (% class="twikiNewLink" %)TiSa(%%) Oscillator units: fs

\\

{{code language="none"}}/FL1/Experiment/Pump probe laser/streak camera delay time{{/code}}

465

//always saved (PBD)//

466

DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}

467

DOOCS prop : {{code language="none"}}TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME{{/code}}

468

desc: delaytime between the optical laser and the FEL units: ps

\\

[[Contents>>doc:||anchor="Contents"]]

\\

==== User Data (FLASH1) ====

===== GHz ADCs =====

ADC traces of the (SPDevices 412) GHZ ADCs available for the users . More information about the ADCs can be found [[here>>doc:FLASHUSER.Data Acquisition and controls.Controls (DOOCS, jDDD,\.\.\.).MTCA ADCs.WebHome]]

481

//saved on DEMAND in the user DAQ//

482

\\The HDF5 names for the ADC traces are depending on the beamline :

483

\\PG Beamline:

484

{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH00/TD{{/code}}

485

{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH01/TD{{/code}}

486

{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH02/TD{{/code}}

487

{{code language="none"}}/FL1/Experiment/PG/ADQ412 GHz ADC/CH03/TD{{/code}}

488

489

BL Beamlines:

490

{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH00/TD{{/code}}

491

{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH01/TD{{/code}}

492

{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH02/TD{{/code}}

493

{{code language="none"}}/FL1/Experiment/BL1/ADQ412 GHz ADC/CH03/TD{{/code}}

494

\\{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH00/TD{{/code}}

495

{{code language="none"}}/FL1/Experiment/BL2/ADQ412 GHz ADC/CH01/TD{{/code}}

496

\\{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH02/TD{{/code}}

497

{{code language="none"}}/FL1/Experiment/BL3/ADQ412 GHz ADC/CH03/TD{{/code}}

498

499

DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00/CH00.TD or CH00.DAQ.TD{{/code}}

500

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.

501

DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}

502

503

in addition there are also additional parameters saved like:

504

505

* sample frequency (in MHz)

* error (state)

* offset

~|

===== MHz ADCs =====

similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:

514

{{code language="none"}}/FL1/Experiment/BL1/SIS8300 100MHz ADC/CH2/TD{{/code}}

515

DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD

516

DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02

\\

[[Contents>>doc:||anchor="Contents"]]

=== FLASH2 ===

There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs

525

526

==== Beamline info (FLASH2) ====

527

528

(% style="color: rgb(255,153,0);" %)(not yet available){{code language="none"}}/FL2/Beamlines/Attenuator/pressure {{/code}}(%%)

529

//always saved (PBD2)//

530

DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}}

531

DAQ channel: {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}}

532

desc: set pressure in the gas attenuator

units: mbar

\\

{{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}

537

//always saved (PBD2)//

538

DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER/CH00.TD{{/code}}

539

DAQ channel: {{code language="none"}}FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER{{/code}}

540

desc: BL Beamline Fast shutter state: 1 is open, 0 is closed ( for technical reasons there are 100 vales of this state saved ...)

units: none

{{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 1{{/code}}

545

//always saved (PBD2)//

546

DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}

547

DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS

548

desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]

units: degree

\\

//always saved (PBD2)//

554

\\\\[[here>>doc:FLASH.Filter history (BL filterwheel 12)]]

555

{{code language="none"}}/FL2/Beamlines/Filter wheel/position wheel 2 DOOCS prop : FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR2.MOT3/FPOS desc: Position of the BL filter wheel 2 - to correlate with the filter material please look units: degree{{/code}}

\\

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

560

561

[[Contents>>doc:||anchor="Contents"]]

\\

\\

==== Photon Diagnostics SASE ([[XGMD>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/gmd_intensity_and_position/index_eng.html||shape="rect"]] - FLASH2) ====

568

569

{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel{{/code}}

570

//always saved (PBD2)//

571

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}

572

DAQ channel:{{code language="none"}} FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ{{/code}}

573

desc : calibrated average ( ~~ 20 sec averaging time ) SASE Energy/pulse measured in the TUNNEL before the attenuator (ion current)

units : microJ

\\

(% style="color: rgb(255,204,0);" %)average Sigma to be included in

579

580

(% style="color: rgb(193,199,208);" %){{code language="none"}}/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel uncertainty{{/code}} (%%)

581

(% style="color: rgb(193,199,208);" %)//always saved (PBD2)// (%%)

582

(% style="color: rgb(193,199,208);" %)DOOCS prop : FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ.SIGMA (%%)

583

(% style="color: rgb(193,199,208);" %)DAQ channel: FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ.SIGMA (%%)

584

(% style="color: rgb(193,199,208);" %)desc : This parameter gives an indication of the error of the measurement of the average 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)(%%)

585

(% style="color: rgb(193,199,208);" %)units : microJ

\\

\\

{{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel{{/code}}

592

//always saved (PBD2)//

593

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}

594

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}

595

desc : Energy per pulse measured in the Tunnel (in fromt of the gas attenuator and the apertures in the Hall)

596

units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) [[see here for help>>doc:FLASH.Calibrating the pulse resolved (electron) data from GMD]]

\\

\\

{{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel uncertainty (sigma){{/code}}

603

//always saved (PBD2)//

604

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.SIGMA.TD{{/code}}

605

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:4{{/code}}

606

desc :(% style="color: rgb(0,0,0);" %)This parameter gives an indication of the error of the measurement of the pulse energy. This takes signal to noise, detector resolution, uncertainties in crossection etc into account. (it is NOT the measurement of the statistical fluctuation of the SASE pulses)(%%)

607

units : a.u. (more or less µJ - related to the value of the pulse energy )

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 !

\\

Besides pulse energy the GMD also provides information about the beam position

\\

{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel horizontal{{/code}}

621

//always saved (PBD2)//

622

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}

623

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}

624

desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (tunnel, x=horizontal)

units : mm

\\

{{code language="none"}}/FL2/Photon Diagnostic/GMD/Average Beam position/position tunnel vertical{{/code}}

630

//always saved (PBD2)//

631

DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}

632

DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}

633

desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (tunnel, x=horizontal)

units : mm

\\

\\

//always saved (PBD2)//

642

\\\\{{code language="none"}}/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel x DOOCS prop : FLASH.FEL/XGM.BPM/FL2.HALL/X.TDDAQ channel: FLASH.FEL/XGM.BPM/FL2.HALL:2 desc: {{/code}}Besides the well calibrated averaged beam position information there is also the option

643

{{code language="none"}}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 ...)units : mm {{/code}}

644

645

{{code language="none"}}(x=horizontal, y = vertial){{/code}}

646

647

again the same parameter set is available for the **HALL GMD**

\\

\\

==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====

654

655

for more info see: [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]

656

657

(The OPIS hall is not installed yet ...)

\\

{{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean photon energy{{/code}}

662

// saved opon request (PBD2)//

663

DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}

664

DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042{{/code}}

665

desc : mean photon energy ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)

units : eV

\\

{{code language="none"}}/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelength{{/code}}

671

// saved opon request (PBD2)//

672

DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}

673

DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040{{/code}}

674

desc : meanwavelength ( ~~ 1 sec averaging time ) measured in the TUNNEL for a specific bunch out of the bunch train (via photoelectron spectroscopy)

units : nm

\\

{{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}}

680

// saved opon request (PBD2)//

681

DOOCS prop : {{code language="none"}}FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}

682

DAQ channel:{{code language="none"}} FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL060{{/code}}

683

desc : The bunch number of the bunch used for the wavelength calculationiunits :

\\

\\

\\

\\

\\

\\

\\

\\

(% class="wrapped" %)

|=(((

DAQ name

)))|=(((

HDF5 name

)))

|(((

FLASH.UTIL/FL2.UND.MOTOR/FL2SASE3/GAP

709

)))|(((

710

/FL2/Electron Diagnostic/Undulator setting/SASE03 gap

711

)))

712

|(((

713

FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP

714

)))|(((

715

/FL2/Electron Diagnostic/Undulator setting/SASE14 gap

716

)))

717

|(((

718

TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH

719

)))|(((

720

/FL2/Electron Diagnostic/Undulator setting/set wavelength

721

)))

722

|(((

723

FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX.UJ

724

)))|(((

725

/FL2/Photon Diagnostic/GMD/Average energy/hall

726

)))

727

|(((

728

FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX

729

)))|(((

730

/FL2/Photon Diagnostic/GMD/Average energy/hall (raw)

731

)))

732

|(((

733

FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ

734

)))|(((

735

/FL2/Photon Diagnostic/GMD/Average energy/tunnel

736

)))

737

|(((

738

FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX

739

)))|(((

740

/FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)

741

)))

742

|(((

743

FLASH.FEL/XGM.POSMON/FL2.HALL/IX.POS

744

)))|(((

745

/FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal

746

)))

747

|(((

748

FLASH.FEL/XGM.POSMON/FL2.HALL/IY.POS

749

)))|(((

750

/FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical

751

)))

752

|(((

753

FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS

754

)))|(((

755

/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal

756

)))

757

|(((

758

FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS

759

)))|(((

760

/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical

761

)))

762

|(((

763

FLASH.FEL/XGM.BPM/FL2.HALL:0

764

)))|(((

765

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal

766

)))

767

|(((

768

FLASH.FEL/XGM.BPM/FL2.HALL:1

769

)))|(((

770

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical

771

)))

772

|(((

773

FLASH.FEL/XGM.BPM/FL2.TUNNEL:0

774

)))|(((

775

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal

776

)))

777

|(((

778

FLASH.FEL/XGM.BPM/FL2.TUNNEL:1

779

)))|(((

780

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical

781

)))

782

|(((

783

FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:1

784

)))|(((

785

/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy aux tunnel

786

)))

787

|(((

788

FLASH.FEL/XGM.INTENSITY/FL2.HALL

789

)))|(((

790

/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall

791

)))

792

|(((

793

FLASH.FEL/XGM.INTENSITY/FL2.HALL:0

794

)))|(((

795

/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall

796

)))

797

|(((

798

FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL

799

)))|(((

800

/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel

801

)))

802

|(((

803

FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:0

804

)))|(((

805

/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel

806

)))

807

|(((

808

FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042

809

)))|(((

810

/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean phtoton energy

811

)))

812

|(((

813

FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040

814

)))|(((

815

/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelengt

816

)))

817

|(((

818

FLASH.FEL/ADC.ADQ/OPIS1.CH02

819

)))|(((

820

/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Raw data/CH02

821

)))

822

|(((

823

FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2

824

)))|(((

825

/FL2/Electron Diagnostic/Bunch charge/after undulator

826

)))

827

|(((

828

FLASH.DIAG/PBD2.TOROID.ML/3GUN/CHARGE.FLASH2

829

)))|(((

830

/FL2/Electron Diagnostic/Bunch charge/at gun

831

)))

832

|(((

833

FLASH.FEL/FL20T.PH.MOTOR/MOTOR1.MOT1/FPOS

834

)))|(((

835

/FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal

836

)))

837

|(((

838

FLASH.FEL/FL20T.PH.MOTOR/MOTOR2.MOT1/FPOS

839

)))|(((

840

/FL2/Beamlines/Tunnel Apertures/position aperture1 vertical

841

)))

842

|(((

843

FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER

844

)))|(((

845

/FL2/Beamlines/FL20/Shutter/channel 0

846

)))

847

|(((

848

FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00

849

)))|(((

850

/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD

851

)))

852

|(((

853

FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH00

854

)))|(((

855

/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH0/TD

856

)))

857

|(((

858

FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD

859

)))|(((

860

/FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS

861

)))

862

|(((

863

FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/LOCK_STATUS.VALUE.RD

864

)))|(((

865

/FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO

866

)))

867

|(((

868

FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD

869

)))|(((

870

/FL2/Experiment/Pump probe laser/laser delay readback

871

)))

872

|(((

873

FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION_SET.WR

874

)))|(((

875

/FL2/Experiment/Pump probe laser/laser delay set value

876

)))

877

|(((

878

FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS

879

)))|(((

880

/FL2/Experiment/Pump probe laser/FL24/attenuator position

881

)))

882

|(((

883

FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS

884

)))|(((

885

/FL2/Experiment/Pump probe laser/FL24/polarization position

)))

\\

[[Contents>>doc:||anchor="Contents"]]

891

892

=== HDF5 structure revisions ===

893

894

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:

\\

* All FLASH1 related HDF groups moved to group "/FL1", i.e. a new prefix "/FL1" is added to their HDF path.

899

* 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".

900

* A number of inconsistent names have been streamlined. The relevant changes are listed in the following table.

\\

(% class="wrapped" %)

905

|=(((

906

earlier HDF path (vers. 0.2)

)))|=(((

is now (vers. 0.3)

)))

|(((

/Photon Diagnostic/GMD/Beam position/position BDA x

912

)))|(((

913

/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal

914

)))

915

|(((

916

/Photon Diagnostic/GMD/Beam position/position BDA y

917

)))|(((

918

/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical

919

)))

920

|(((

921

/Photon Diagnostic/GMD/Beam position/position tunnel x

922

)))|(((

923

/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal

924

)))

925

|(((

926

/Photon Diagnostic/GMD/Beam position/position tunnel y

927

)))|(((

928

/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical

929

)))

930

|(((

931

/Experiment/Pump probe laser/BPM/position x

932

)))|(((

933

/FL1/Experiment/Pump probe laser/BPM/position horizontal

934

)))

935

|(((

936

/Experiment/Pump probe laser/BPM/position y

937

)))|(((

938

/FL1/Experiment/Pump probe laser/BPM/position vertical

939

)))

940

|(((

941

/FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal

942

)))|(((

943

/FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal

944

)))

945

|(((

946

/FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical

947

)))|(((

948

/FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical

949

)))

950

|(((

951

/FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal

952

)))|(((

953

/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal

954

)))

955

|(((

956

/FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical

957

)))|(((

958

/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical

959

)))

960

|(((

961

/FL2/Photon Diagnostic/GMD/Average energy/hall

962

)))|(((

963

/FL2/Photon Diagnostic/GMD/Average energy/energy hall

964

)))

965

|(((

966

/FL2/Photon Diagnostic/GMD/Average energy/hall (raw)

967

)))|(((

968

/FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)

969

)))

970

|(((

971

/FL2/Photon Diagnostic/GMD/Average energy/tunnel

972

)))|(((

973

/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel

974

)))

975

|(((

976

/FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)

977

)))|(((

978

/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)

979

)))

980

|(((

981

/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x

982

)))|(((

983

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal

984

)))

985

|(((

986

/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y

987

)))|(((

988

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical

989

)))

990

|(((

991

/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x

992

)))|(((

993

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal

994

)))

995

|(((

996

/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y

997

)))|(((

998

/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical

)))

\\

[[Contents>>doc:||anchor="Contents"]]

\\

== Example code showing how to access HDF5 files ==

\\

=== Samples how to read HDF5 with Matlab ===

1012

1013

The examples apply to HDF files with HDF tree version before vers. 0.3.0.

1014

1015

(% style="color: rgb(0,128,0);" %)%% read in the needed data p=path; path(p,'D:\mess-daten\DAQ-data\hdf5\Gotthard') % add the actual folder to the path hdf5file='FLASH1_EXP-2016-03-16T1420.h5'; % data with Gotthard and VLS

1016

1017

(% style="color: rgb(0,128,0);" %)% h5disp(hdf5file,'/','min') % to get an idea what is in the file % h5info(hdf5file,'/Experiment/Gotthard1/BL.0') % get info about the individual channel

1018

1019

(% style="color: rgb(0,128,0);" %)% read a Number per 10 Hz pulse train:

(% class="code" %)

(((

FEL_Wavelength_energy_server=h5read(hdf5file,'/Photon Diagnostic/Wavelength/Calculated by energy/wavelength' );

1024

)))

1025

1026

(% style="color: rgb(0,128,0);" %)% read in a 1D array (spectrum) %GMD data GMD_Spectrum=h5read(hdf5file,'/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA');

1027

1028

(% style="color: rgb(0,128,0);" %)% This reads in all the data . One can also limit the amount of data read to a subset of the data stored in the file. e.g. for image Data (Gotthard)

\\

(% class="code" %)

(((

Start_event= 500 ; % define the first 10 Hz event

1035

Number_of_events = 20; % how many 10 Hz events to load

1036

)))

1037

1038

(% style="color: rgb(0,128,0);" %)% read only part of the data:

(% class="code" %)

(((

Gotthard_data=h5read(hdf5file,'/Experiment/Gotthard1/BL.0',[2 650 Start_event],[50 85 Number_of_events]);

1043

)))

1044

1045

(% style="color: rgb(0,128,0);" %)% start stop increment "manual" for 2 D data : [start bunch number in Gotthard data start pixelin spectrum start sample in 10 Hz trains], % [number of bunches in the Gotthard data number of points in the spectrum number of spectra ]

(% class="code" %)

(((

VLS_Spectrum=h5read(hdf5file,'/Photon Diagnostic/Wavelength/VLS online spectrometer/PCO.ROI.X',[400 Start_event],[200 Number_of_events] );

)))

(% style="color: rgb(0,128,0);" %)% start stop increment "manual" for 1D data : [start sample in the spectrum start sample in 10 Hz trains],[number of points in the spectrum number of spectra ]

1054

1055

(% style="color: rgb(0,128,0);" %)%GMD data

(% class="code" %)

(((

GMD_Spectrum=h5read(hdf5file,'/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA',[1 Start_event],[40 Number_of_events] );

1060

)))

1061

1062

[[Contents>>doc:||anchor="Contents"]]

1063

1064

=== How to read HDF5 with Python via FLASHH5 ===

1065

1066

With [[FlashH5>>doc:FLASHUSER.FLASHH5 for easier access of FLASH's HDF5 files]] we provide h5py based examples to access and evaluate FLASH's HDF5 files.

\\

== HDF5 and DOOCS ==

Here is an outdated [[list with the available properties that are always saved (PBD) for FLASH1 as>>attach:FLASH1__DaqChannel2HdfNamePbd.xlsx]] HDF5 names and the corresponding DOOCS names

1073

1074

[[Contents>>doc:||anchor="Contents"]]

Wiki source code of The FLASH HDF5 structure