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 / 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) ====

570

571

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

572

//always saved (PBD2)//

573

DOOCS prop : FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ

574

DAQ channel: FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ

575

desc : calibrated average 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

581

582

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

583

//always saved (PBD2)//

584

DOOCS prop : FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ.SIGMA

585

DAQ channel: FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ.SIGMA

desc : (ion current)

units : microJ

\\

\\

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

594

//always saved (PBD)//

595

DOOCS prop : FLASH.FEL/XGM.INTENSITY/FL2.HALL/INTENSITY.TD

596

DAQ channel: FLASH.FEL/XGM.INTENSITY/FL2.HALL/INTENSITY.TD

597

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

598

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"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}

605

//always saved (PBD)//

606

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

607

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

608

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

609

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]]

610

611

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

612

//always saved (PBD)//

613

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

614

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

615

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

616

units : microJ

617

618

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

619

//always saved (PBD)//

620

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

621

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

622

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

623

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]]

624

625

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

626

//always saved (PBD)//

627

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

628

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

629

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

630

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]]

631

632

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

633

//always saved (PBD)//

634

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

635

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

636

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

637

units : mm

638

639

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

640

//always saved (PBD)//

641

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

642

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

643

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

644

units : mm

645

646

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

647

//always saved (PBD)//

648

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

649

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

650

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

651

units : mm

652

653

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

654

//always saved (PBD)//

655

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

656

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

657

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

units : mm

\\

\\

\\

(% class="wrapped" %)

|=(((

DAQ name

)))|=(((

HDF5 name

)))

|(((

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

674

)))|(((

675

/FL2/Electron Diagnostic/Undulator setting/SASE03 gap

676

)))

677

|(((

678

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

679

)))|(((

680

/FL2/Electron Diagnostic/Undulator setting/SASE14 gap

681

)))

682

|(((

683

TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH

684

)))|(((

685

/FL2/Electron Diagnostic/Undulator setting/set wavelength

686

)))

687

|(((

688

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

689

)))|(((

690

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

691

)))

692

|(((

693

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

694

)))|(((

695

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

696

)))

697

|(((

698

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

699

)))|(((

700

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

701

)))

702

|(((

703

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

704

)))|(((

705

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

706

)))

707

|(((

708

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

709

)))|(((

710

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

711

)))

712

|(((

713

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

714

)))|(((

715

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

716

)))

717

|(((

718

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

719

)))|(((

720

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

721

)))

722

|(((

723

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

724

)))|(((

725

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

726

)))

727

|(((

728

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

729

)))|(((

730

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

731

)))

732

|(((

733

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

734

)))|(((

735

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

736

)))

737

|(((

738

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

739

)))|(((

740

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

741

)))

742

|(((

743

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

744

)))|(((

745

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

746

)))

747

|(((

748

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

749

)))|(((

750

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

751

)))

752

|(((

753

FLASH.FEL/XGM.INTENSITY/FL2.HALL

754

)))|(((

755

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

756

)))

757

|(((

758

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

759

)))|(((

760

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

761

)))

762

|(((

763

FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL

764

)))|(((

765

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

766

)))

767

|(((

768

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

769

)))|(((

770

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

771

)))

772

|(((

773

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

774

)))|(((

775

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

776

)))

777

|(((

778

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

779

)))|(((

780

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

781

)))

782

|(((

783

FLASH.FEL/ADC.ADQ/OPIS1.CH02

784

)))|(((

785

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

786

)))

787

|(((

788

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

789

)))|(((

790

/FL2/Electron Diagnostic/Bunch charge/after undulator

791

)))

792

|(((

793

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

794

)))|(((

795

/FL2/Electron Diagnostic/Bunch charge/at gun

796

)))

797

|(((

798

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

799

)))|(((

800

/FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal

801

)))

802

|(((

803

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

804

)))|(((

805

/FL2/Beamlines/Tunnel Apertures/position aperture1 vertical

806

)))

807

|(((

808

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

809

)))|(((

810

/FL2/Beamlines/FL20/Shutter/channel 0

811

)))

812

|(((

813

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

814

)))|(((

815

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

816

)))

817

|(((

818

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

819

)))|(((

820

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

821

)))

822

|(((

823

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

824

)))|(((

825

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

826

)))

827

|(((

828

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

829

)))|(((

830

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

831

)))

832

|(((

833

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

834

)))|(((

835

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

836

)))

837

|(((

838

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

839

)))|(((

840

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

841

)))

842

|(((

843

FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS

844

)))|(((

845

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

846

)))

847

|(((

848

FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS

849

)))|(((

850

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

)))

\\

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

856

857

=== HDF5 structure revisions ===

858

859

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.

864

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

865

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

\\

(% class="wrapped" %)

870

|=(((

871

earlier HDF path (vers. 0.2)

)))|=(((

is now (vers. 0.3)

)))

|(((

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

877

)))|(((

878

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

879

)))

880

|(((

881

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

882

)))|(((

883

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

884

)))

885

|(((

886

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

887

)))|(((

888

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

889

)))

890

|(((

891

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

892

)))|(((

893

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

894

)))

895

|(((

896

/Experiment/Pump probe laser/BPM/position x

897

)))|(((

898

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

899

)))

900

|(((

901

/Experiment/Pump probe laser/BPM/position y

902

)))|(((

903

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

904

)))

905

|(((

906

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

907

)))|(((

908

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

909

)))

910

|(((

911

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

912

)))|(((

913

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

914

)))

915

|(((

916

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

917

)))|(((

918

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

919

)))

920

|(((

921

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

922

)))|(((

923

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

924

)))

925

|(((

926

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

927

)))|(((

928

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

929

)))

930

|(((

931

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

932

)))|(((

933

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

934

)))

935

|(((

936

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

937

)))|(((

938

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

939

)))

940

|(((

941

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

942

)))|(((

943

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

944

)))

945

|(((

946

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

947

)))|(((

948

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

949

)))

950

|(((

951

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

952

)))|(((

953

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

954

)))

955

|(((

956

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

957

)))|(((

958

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

959

)))

960

|(((

961

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

962

)))|(((

963

/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 ===

977

978

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

979

980

(% 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

981

982

(% 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

983

984

(% 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' );

989

)))

990

991

(% 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');

992

993

(% 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

1000

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

1001

)))

1002

1003

(% 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]);

1008

)))

1009

1010

(% 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 ]

1019

1020

(% 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] );

1025

)))

1026

1027

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

1028

1029

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

1030

1031

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

1038

1039

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

Wiki source code of The FLASH HDF5 structure