Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

top

FLASH HDF5 structure

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:

...

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

top


HDF5 example files

Here we have a few HDF5 samples (User data combined with Photon diagnostics data) from a few beamtimes showing the different kind options.

Example 1:  Images saved at FLASH2


Image Added



top



Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ

...


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

top


Photon Diagnostics SASE (GMD) / Spectrometer (FLASH1)

...

/FL1/Photon Diagnostic/Wavelength/PG2 spectrometer/photon wavelength start value
saved on DEMAND (PBD spectrometer stream)
DOOCS prop : ==
DAQ channel: ==
desc : increment value (in nm) for each pixel for the wavelength axis of the XUV Spectrum measured with the "PG spectrometer"
units : nm

top

Electron Beam properties (FLASH1)

...

/FL1/Electron Diagnostic/Electron energy/wavelength bunch train average
_always saved (PBD)
DOOCS prop : TTF2.DAQ/ENERGY.DOGLEG/LAMBDA_MEAN/VAL
DAQ channel: PBD.ENERGY.DOGLEG/LAMBDA_MEAN
desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
units: nm

top


Timing information, rep rate etc.  (FLASH1)

...

/Timing/time stamp
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
second column: microseconds
third column: Train ID of FLASH

top


Pump Probe Laser (FLASH1)

...

/FL1/Experiment/Pump probe laser/streak camera delay time
always saved (PBD)
DOOCS prop : TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME
DOOCS prop : TTF2.FEL/TDOLFEL/TDOLFEL/STREAK.CAM.TIME
desc: delaytime between the optical laser and the FEL units: ps


top


User Data (FLASH1)

The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.

...

  • sample frequency: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
  • number of samples: total number of samoles recorded for each 10 Hz trigger

top




FLASH2

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

...

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

top



Photon Diagnostics SASE (XGMD - FLASH2)

...

Docu for BAM:  LINK to detailled infos from MSK (may only work inside DESY network and to a recent talk about the working principle of the BAM


top


Timing information, rep rate etc.  (FLASH2)

...

always saved (PBD2)
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
second column: microseconds
third column: Train ID of FLASH

top


User Data (FLASH2)

The data saved specifically for detectors at an experiment will show up in /Experiment/ there is a large number of options for cameras or monitoring pslow properties (motor positons etc) for user experiments. For details please ask your local contact.

...

  • sample frequency: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
  • number of samples: total number of samoles recorded for each 10 Hz trigger

top



Pump Probe Laser (FLASH2)

...

/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS
always saved (PBD)
DOOCS prop : FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
DAQ channel: FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
desc: rms jitter of the fs-Oscillator
units: fs

top


"/uncategorized/"

 If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with their DOOCS names

...

earlier HDF path (vers. 0.2)is now (vers. 0.3)
/Photon Diagnostic/GMD/Beam position/position BDA x/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal
/Photon Diagnostic/GMD/Beam position/position BDA y/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical
/Photon Diagnostic/GMD/Beam position/position tunnel x/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal
/Photon Diagnostic/GMD/Beam position/position tunnel y/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical
/Experiment/Pump probe laser/BPM/position x/FL1/Experiment/Pump probe laser/BPM/position horizontal
/Experiment/Pump probe laser/BPM/position y/FL1/Experiment/Pump probe laser/BPM/position vertical
/FL2/Photon Diagnostic/GMD/Beam position/Average/position hall horizontal/FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
/FL2/Photon Diagnostic/GMD/Beam position/Average/position hall vertical/FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
/FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel horizontal/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
/FL2/Photon Diagnostic/GMD/Beam position/Average/position tunnel vertical/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
/FL2/Photon Diagnostic/GMD/Average energy/hall/FL2/Photon Diagnostic/GMD/Average energy/energy hall
/FL2/Photon Diagnostic/GMD/Average energy/hall (raw)/FL2/Photon Diagnostic/GMD/Average energy/energy hall (raw)
/FL2/Photon Diagnostic/GMD/Average energy/tunnel/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel
/FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)/FL2/Photon Diagnostic/GMD/Average energy/energy tunnel (raw)
/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall x/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/hall y/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel x/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
/FL2/Photon Diagnostic/GMD/Beam position/Pulse resolved/tunnel y/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical


top


Example code showing how to access HDF5 files

...

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

top

How to read HDF5 with Python via FLASHH5

...

Here is an outdated list with the available properties that are always saved (PBD) for FLASH1 as HDF5 names and the corresponding DOOCS names

top