Changes for page The FLASH HDF5 structure

Last modified by sndueste on 2025/02/06 10:55

From version 16.1
edited by sndueste
on 2019/09/18 09:29
Change comment: There is no comment for this version
To version 23.1
edited by sndueste
on 2019/09/18 16:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -79,7 +79,7 @@
79 79  //always saved (PBD)//
80 80  DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
81 81  DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
82 -desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
82 +desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASHUSER.Filter history (BL filterwheel 12)]]
83 83  units: degree
84 84  \\
85 85  
... ... @@ -87,7 +87,7 @@
87 87  //always saved (PBD)//
88 88  DOOCS prop : {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
89 89  DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
90 -desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
90 +desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FLASHUSER.Filter history (BL filterwheel 12)]]
91 91  units: degree
92 92  \\
93 93  
... ... @@ -137,7 +137,7 @@
137 137  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT34/VAL{{/code}}
138 138  DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.USER{{/code}}
139 139  desc :Energy per pulse Tunnel (from e-) - the values are set to "0" if there was no SASE beam in the FEL
140 -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]]
140 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
141 141  
142 142  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel (raw){{/code}}
143 143  //always saved (PBD)//
... ... @@ -144,7 +144,7 @@
144 144  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT14/VAL{{/code}}
145 145  DAQ channel: {{code language="none"}}PBD.PHFLUX/TUNNEL.ENERGYPULSE.FF{{/code}}
146 146  desc :Energy per pulse Tunnel (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
147 -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]]
147 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
148 148  
149 149  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Average energy/energy BDA{{/code}}
150 150  //always saved (PBD)//
... ... @@ -158,7 +158,7 @@
158 158  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT35/VAL{{/code}}
159 159  DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.USER{{/code}}
160 160  desc :Energy per pulse BDA (from e-) - the values are set to "0" if there was no SASE beam in the FEL
161 -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]]
161 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision) **[[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
162 162  
163 163  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Pulse resolved energy/energy BDA (raw){{/code}}
164 164  //always saved (PBD)//
... ... @@ -165,13 +165,13 @@
165 165  DOOCS prop : {{code language="none"}}TTF2.DAQ/PHFLUX/OUT15/VAL{{/code}}
166 166  DAQ channel: {{code language="none"}}PBD.PHFLUX/BDA.ENERGYPULSE.FF{{/code}}
167 167  desc :Energy per pulse BDA (from e-) - uncorrected values. There are also values saved if there was no beam ... just background noise
168 -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]]
168 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
169 169  
170 170  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA horizontal{{/code}}
171 171  //always saved (PBD)//
172 172  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
173 173  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IX.POS{{/code}}
174 -desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, x=horizontal)
174 +desc :Beam position of the photon Beam determined by the GMD (BDA, x=horizontal)
175 175  units : mm
176 176  
177 177  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position BDA vertical{{/code}}
... ... @@ -178,7 +178,7 @@
178 178  //always saved (PBD)//
179 179  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
180 180  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.BDA/IY.POS{{/code}}
181 -desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (BDA, y=vertical)
181 +desc :Beam position of the photon Beam determined by the GMD (BDA, y=vertical)
182 182  units : mm
183 183  
184 184  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel horizontal{{/code}}
... ... @@ -185,7 +185,7 @@
185 185  //always saved (PBD)//
186 186  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
187 187  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IX.POS{{/code}}
188 -desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, x=horizontal)
188 +desc :Beam position of the photon Beam determined by the GMD (TUNNEL, x=horizontal)
189 189  units : mm
190 190  
191 191  {{code language="none"}}/FL1/Photon Diagnostic/GMD/Beam position/position tunnel vertical{{/code}}
... ... @@ -192,7 +192,7 @@
192 192  //always saved (PBD)//
193 193  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
194 194  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL1.TUNNEL/IY.POS{{/code}}
195 -desc :Beam position of the photon Beam determined by the [[GMD>>doc:FLASH.Gas Monitor Detector]] (TUNNEL, y=vertical)
195 +desc :Beam position of the photon Beam determined by the GMD (TUNNEL, y=vertical)
196 196  units : mm
197 197  
198 198  {{code language="none"}}/FL1/Photon Diagnostic/Wavelength/Tunnelspectrometer/wavelength{{/code}}
... ... @@ -385,7 +385,7 @@
385 385  //always saved (PBD)//
386 386  DOOCS prop : {{code language="none"}}none{{/code}}
387 387  DAQ channel: {{code language="none"}}none{{/code}}
388 -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 !)
388 +desc: Each 10 Hz burst has its unique train ID. For the HDF5 data set the ID is the same for all parameters with the same index (note camera images may be shifted by 1 ID - talk to the experts !)
389 389  units:
390 390  \\
391 391  
... ... @@ -392,7 +392,7 @@
392 392  ===== Train time =====
393 393  
394 394  {{code language="none"}}/Timing/train time{{/code}}
395 -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
395 +desc:Local time as array of day, hour, minute, second, and centisecond. This data set is meant for visualization purposes only. For correlations use the train ID or the Unix time of the time stamp
396 396  units: d h min s cs
397 397  \\
398 398  
... ... @@ -458,9 +458,15 @@
458 458  
459 459  ==== User Data (FLASH1) ====
460 460  
461 +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.
462 +
463 +NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
464 +
465 +The most common and permanently installed device used by experiment are our ADCs:
466 +
461 461  ===== GHz ADCs =====
462 462  
463 -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]]
469 +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]]**
464 464  //saved on DEMAND in the user DAQ//
465 465  \\The HDF5 names for the ADC traces are depending on the beamline :
466 466  \\PG Beamline:
... ... @@ -483,15 +483,12 @@
483 483  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.
484 484  DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.PG/EXP1.CH00{{/code}}
485 485  
486 -in addition there are also additional parameters saved like:
492 +In addition there are also additional parameters saved like:
487 487  
488 488  * {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
489 489  * {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
490 490  * {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
491 -* {{code language="none"}}offset{{/code}}: To use the full dynamic range of the ADC one can shift the base line . This offset is saved here.
492 492  
493 -~|
494 -
495 495  ===== MHz ADCs =====
496 496  
497 497  similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
... ... @@ -499,10 +499,19 @@
499 499  DOOCS prop : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02/CH00.TD
500 500  DAQ channel: : FLASH.FEL/ADC.SIS.BL1/EXP1.CH02
501 501  
502 -\\
505 +In addition there are also additional parameters saved like:
503 503  
507 +* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
508 +* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
509 +
504 504  [[Contents>>doc:||anchor="Contents"]]
505 505  
512 +\\
513 +
514 +\\
515 +
516 +\\
517 +
506 506  === FLASH2 ===
507 507  
508 508  There is analog to FLASH1 a permanently running "PhotonDagnostic DAQ FLASH2" (PBD2) and 2 User DAQs
... ... @@ -510,11 +510,11 @@
510 510  ==== Beamline info (FLASH2) ====
511 511  
512 512  (% style="color: rgb(255,153,0);" %)(not yet available){{code language="none"}}/FL2/Beamlines/Attenuator/pressure  {{/code}}(%%)
513 -//always saved (PBD2)//
514 -DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}}
515 -DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}}
516 -desc: set pressure in the gas attenuator
517 -units: mbar
525 +(% style="color: rgb(193,199,208);" %)//always saved (PBD2)// (%%)
526 +(% style="color: rgb(193,199,208);" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
527 +(% style="color: rgb(193,199,208);" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
528 +(% style="color: rgb(193,199,208);" %)desc: set pressure in the gas attenuator (%%)
529 +(% style="color: rgb(193,199,208);" %)units: mbar(%%)
518 518  \\
519 519  
520 520  {{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
... ... @@ -529,13 +529,13 @@
529 529  //always saved (PBD2)//
530 530  DOOCS prop : {{code language="none"}}FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS{{/code}}
531 531  DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
532 -desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
544 +desc: Position of the BL filter wheel 1 - to correlate with the filter material please look **[[here>>doc:FLASHUSER.Filter history (BL filterwheel 12)]]**
533 533  units: degree
534 534  \\
535 535  
536 536  
537 537  //always saved (PBD2)//
538 -\\\\[[here>>doc:FLASH.Filter history (BL filterwheel 12)]]
550 +\\\\**[[here>>doc:FLASHUSER.Filter history (BL filterwheel 12)]]**
539 539  {{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}}
540 540  
541 541  \\
... ... @@ -577,7 +577,7 @@
577 577  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
578 578  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL/INTENSITY.TD{{/code}}
579 579  desc : Energy per pulse measured in the Tunnel  (in fromt of the gas attenuator and the apertures in the Hall)
580 -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]]
592 +units : a.u. (more or less µJ but need to be calibrated with the "Average energy" for good precision)** [[see here for help>>doc:FLASHUSER.jddd-linked help pages.Calibrating the pulse resolved (electron) data from GMD.WebHome]]**
581 581  
582 582  \\
583 583  
... ... @@ -605,7 +605,7 @@
605 605  //always saved (PBD2)//
606 606  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
607 607  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS{{/code}}
608 -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)
620 +desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
609 609  units : mm
610 610  
611 611  \\
... ... @@ -614,7 +614,7 @@
614 614  //always saved (PBD2)//
615 615  DOOCS prop : {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
616 616  DAQ channel: {{code language="none"}}FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS{{/code}}
617 -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)
629 +desc : the Average ( ~~ 20 sec averaging time ) Beam position of the photon Beam determined by the GMD (tunnel, x=horizontal)
618 618  units : mm
619 619  
620 620  \\
... ... @@ -634,7 +634,7 @@
634 634  
635 635  ==== Photon Diagnostics OPIS[[ >>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]](FLASH2) ====
636 636  
637 -for more info see: [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]
649 +for more info see:** [[ OPIS>>url:http://photon-science.desy.de/facilities/flash/photon_diagnostics/opis_spectrometer/index_eng.html||shape="rect"]]**
638 638  
639 639  (The OPIS hall is not installed yet ...)
640 640  
... ... @@ -736,7 +736,7 @@
736 736  //always saved (PBD2)//
737 737  DOOCS prop : {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
738 738  DAQ channel: {{code language="none"}}FLASH.DIAG/TIMER/FLASHCPUTIME1.0/BUNCH_POSITION.2{{/code}}
739 -desc: The max 600 µs acceleration time of FLASH is devided between FLASH1 and FLASH2. FLASH1 is (up to now) first starting for historic reasons 700 µs. thus if e.g. the start time of FLASH2 ( property name see below) is 1200 it means that FLASH starts at column 500 (1200-700) ...
751 +desc: The max 600 µs acceleration time of FLASH is devided between FLASH1 and FLASH2. This 600 µs window starts with FLASH1 (up to now)  at a time"label" of 700 µs (for historic reasons). Thus the first bunch of FLASH 1 comes at "700" and the last possibel bunch comes at 1300 (700+600). After FLASH1 train is over ther is a about 70µs switching time with no bunches. Then comes the first FLASH2 bunch.  Thus if e.g. the start time of FLASH2 is 1200 it means that FLASH2 starts at column 500 (1200-700)  in the HDF5 files. (However for yet unknown reasons this may change by 2-3 colums ...)
740 740  units: µs
741 741  
742 742  ===== bunch repetition rate =====
... ... @@ -798,209 +798,102 @@
798 798  
799 799  \\
800 800  
801 -\\
813 +==== User Data (FLASH2) ====
802 802  
815 +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.
816 +
817 +NOTE: If parameters for an experiment are included on short notice the correct naming in the HDF5 may not be in time and the data will show up in /uncategorized/ with the DOOCS names
818 +
819 +The most common and permanently installed device used by experiment are our ADCs:
820 +
821 +===== GHz ADCs =====
822 +
823 +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]]**
824 +//saved on DEMAND in the user DAQ//
825 +\\Up to now there are 4 channels available at FL24
826 +\\\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD{{/code}}
827 +{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH01/TD{{/code}}
828 +\\{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH02/TD{{/code}}{{code language="none"}}/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH03/TD{{/code}}
829 +
803 803  \\
804 804  
832 +DOOCS prop : {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00/CH00.TD  or CH00.DAQ.TD{{/code}}
833 +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.
834 +DAQ channel: {{code language="none"}}FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00{{/code}}
835 +
836 +In addition there are also additional parameters saved like:
837 +
838 +* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
839 +* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
840 +* {{code language="none"}}error (ADC):{{/code}} 0 indicates that there was no error
841 +* {{code language="none"}}/CH0-CH3/offset{{/code}}: To use the full dynamic range of the ADC one can shift the base line . This offset is saved here.
842 +
843 +===== MHz ADCs =====
844 +
845 +similar to the GHz ADCs the MHz ADCs are saved with HDF5 names like:
846 +{{code language="none"}}/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH2/TD{{/code}}
847 +DOOCS prop : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02/CH00.TD
848 +DAQ channel: : FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH02
849 +
850 +In addition there are also additional parameters saved like:
851 +
852 +* {{code language="none"}}sample frequency{{/code}}: it shows the sample frequency in MHz (number of samples per µs). NOTE: the clock of the ADC is NOT synchronized to the FLASH timing system. Thus the number of samples between bunches in the bunch train may be not integer numbers which will be show up for long bunch trains.
853 +* {{code language="none"}}number of samples{{/code}}: total number of samoles recorded for each 10 Hz trigger
854 +
855 +[[Contents>>doc:||anchor="Contents"]]
856 +
805 805  \\
806 806  
807 807  \\
808 808  
861 +==== Pump Probe Laser (FLASH2) ====
862 +
863 +There may be more information available from the "Laser DAQ". laese contact your Laser Local Contact.
864 +
865 +
866 +{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/attenuator position{{/code}}//always saved (PBD2)//
867 +DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
868 +DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS{{/code}}
869 +desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
870 +units : deg.
871 +
809 809  \\
810 810  
874 +
875 +{{code language="none"}}/FL2/Experiment/Pump probe laser/FL24/polarization position{{/code}}//always saved (PBD2)//
876 +DOOCS prop : {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
877 +DAQ channel: {{code language="none"}}FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/FPOS{{/code}}
878 +desc: attenuation of the PPLaser in the FL24 hutch (rotation of a waveplate)
879 +units : deg.
880 +
811 811  \\
812 812  
813 -(% class="wrapped" %)
814 -|=(((
815 -DAQ name
816 -)))|=(((
817 -HDF5 name
818 -)))
819 -|(((
820 -FLASH.UTIL/FL2.UND.MOTOR/FL2SASE3/GAP
821 -)))|(((
822 -/FL2/Electron Diagnostic/Undulator setting/SASE03 gap
823 -)))
824 -|(((
825 -FLASH.UTIL/FL2.UND.MOTOR/FL2SASE14/GAP
826 -)))|(((
827 -/FL2/Electron Diagnostic/Undulator setting/SASE14 gap
828 -)))
829 -|(((
830 -TTF2.FEEDBACK/FL2.WAVELENGTHCONTROL/FLASH2/WAVELENGTH
831 -)))|(((
832 -/FL2/Electron Diagnostic/Undulator setting/set wavelength
833 -)))
834 -|(((
835 -FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX.UJ
836 -)))|(((
837 -/FL2/Photon Diagnostic/GMD/Average energy/hall
838 -)))
839 -|(((
840 -FLASH.FEL/XGM.PHOTONFLUX/FL2.HALL/PHOTONFLUX
841 -)))|(((
842 -/FL2/Photon Diagnostic/GMD/Average energy/hall (raw)
843 -)))
844 -|(((
845 -FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX.UJ
846 -)))|(((
847 -/FL2/Photon Diagnostic/GMD/Average energy/tunnel
848 -)))
849 -|(((
850 -FLASH.FEL/XGM.PHOTONFLUX/FL2.TUNNEL/PHOTONFLUX
851 -)))|(((
852 -/FL2/Photon Diagnostic/GMD/Average energy/tunnel (raw)
853 -)))
854 -|(((
855 -FLASH.FEL/XGM.POSMON/FL2.HALL/IX.POS
856 -)))|(((
857 -/FL2/Photon Diagnostic/GMD/Average beam position/position hall horizontal
858 -)))
859 -|(((
860 -FLASH.FEL/XGM.POSMON/FL2.HALL/IY.POS
861 -)))|(((
862 -/FL2/Photon Diagnostic/GMD/Average beam position/position hall vertical
863 -)))
864 -|(((
865 -FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IX.POS
866 -)))|(((
867 -/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel horizontal
868 -)))
869 -|(((
870 -FLASH.FEL/XGM.POSMON/FL2.TUNNEL/IY.POS
871 -)))|(((
872 -/FL2/Photon Diagnostic/GMD/Average beam position/position tunnel vertical
873 -)))
874 -|(((
875 -FLASH.FEL/XGM.BPM/FL2.HALL:0
876 -)))|(((
877 -/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall horizontal
878 -)))
879 -|(((
880 -FLASH.FEL/XGM.BPM/FL2.HALL:1
881 -)))|(((
882 -/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position hall vertical
883 -)))
884 -|(((
885 -FLASH.FEL/XGM.BPM/FL2.TUNNEL:0
886 -)))|(((
887 -/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel horizontal
888 -)))
889 -|(((
890 -FLASH.FEL/XGM.BPM/FL2.TUNNEL:1
891 -)))|(((
892 -/FL2/Photon Diagnostic/GMD/Pulse resolved beam position/position tunnel vertical
893 -)))
894 -|(((
895 -FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:1
896 -)))|(((
897 -/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy aux tunnel
898 -)))
899 -|(((
900 -FLASH.FEL/XGM.INTENSITY/FL2.HALL
901 -)))|(((
902 -/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
903 -)))
904 -|(((
905 -FLASH.FEL/XGM.INTENSITY/FL2.HALL:0
906 -)))|(((
907 -/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy hall
908 -)))
909 -|(((
910 -FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL
911 -)))|(((
912 -/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
913 -)))
914 -|(((
915 -FLASH.FEL/XGM.INTENSITY/FL2.TUNNEL:0
916 -)))|(((
917 -/FL2/Photon Diagnostic/GMD/Pulse resolved energy/energy tunnel
918 -)))
919 -|(((
920 -FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL042
921 -)))|(((
922 -/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean phtoton energy
923 -)))
924 -|(((
925 -FLASH.UTIL/STORE/FL2.TUNNEL.OPIS/VAL040
926 -)))|(((
927 -/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Processed/mean wavelengt
928 -)))
929 -|(((
930 -FLASH.FEL/ADC.ADQ/OPIS1.CH02
931 -)))|(((
932 -/FL2/Photon Diagnostic/Wavelength/OPIS tunnel/Raw data/CH02
933 -)))
934 -|(((
935 -FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN/CHARGE.FLASH2
936 -)))|(((
937 -/FL2/Electron Diagnostic/Bunch charge/after undulator
938 -)))
939 -|(((
940 -FLASH.DIAG/PBD2.TOROID.ML/3GUN/CHARGE.FLASH2
941 -)))|(((
942 -/FL2/Electron Diagnostic/Bunch charge/at gun
943 -)))
944 -|(((
945 -FLASH.FEL/FL20T.PH.MOTOR/MOTOR1.MOT1/FPOS
946 -)))|(((
947 -/FL2/Beamlines/Tunnel Apertures/position aperture1 horizontal
948 -)))
949 -|(((
950 -FLASH.FEL/FL20T.PH.MOTOR/MOTOR2.MOT1/FPOS
951 -)))|(((
952 -/FL2/Beamlines/Tunnel Apertures/position aperture1 vertical
953 -)))
954 -|(((
955 -FLASH.FEL/ADC.SIS.FL2FS/FL20.SHUTTER
956 -)))|(((
957 -/FL2/Beamlines/FL20/Shutter/channel 0
958 -)))
959 -|(((
960 -FLASH.FEL/ADC.ADQ.FL2EXP1/FL2EXP1.CH00
961 -)))|(((
962 -/FL2/Experiment/MTCA-EXP1/ADQ412 GHz ADC/CH00/TD
963 -)))
964 -|(((
965 -FLASH.FEL/ADC.SIS.FL2EXP1/FL2EXP1.CH00
966 -)))|(((
967 -/FL2/Experiment/MTCA-EXP1/SIS8300 100MHz ADC/CH0/TD
968 -)))
969 -|(((
970 -FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD
971 -)))|(((
972 -/FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS
973 -)))
974 -|(((
975 -FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/LOCK_STATUS.VALUE.RD
976 -)))|(((
977 -/FL2/Experiment/Pump probe laser/Synchronization/timing jitter RMS GECCO
978 -)))
979 -|(((
980 -FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD
981 -)))|(((
982 -/FL2/Experiment/Pump probe laser/laser delay readback
983 -)))
984 -|(((
985 -FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION_SET.WR
986 -)))|(((
987 -/FL2/Experiment/Pump probe laser/laser delay set value
988 -)))
989 -|(((
990 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR1.FL24/FPOS
991 -)))|(((
992 -/FL2/Experiment/Pump probe laser/FL24/attenuator position
993 -)))
994 -|(((
995 -FLASH.FEL/FLAPP2BEAMLINES/MOTOR2.FL24/POS
996 -)))|(((
997 -/FL2/Experiment/Pump probe laser/FL24/polarization position
998 -)))
883 +{{code language="none"}}/FL1/Experiment/Pump probe laser/laser delay readback{{/code}}
884 +//always saved (PBD2)//
885 +DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
886 +DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/FMC0.MD22.0.POSITION.RD{{/code}}
887 +desc: delay of the Pump probe laser - measured by the read back position of the motor. There is also the set value available ( upto now these values are only updating every 1-2 seconds. There is no fast encoder property as on FLASH1 available)
888 +units : ps )
999 999  
1000 1000  \\
1001 1001  
892 +{{code language="none"}}/FL1/Experiment/Pump probe laser/Synchronization/timing jitter RMS{{/code}}
893 +//always saved (PBD)//
894 +DOOCS prop : {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
895 +DAQ channel: {{code language="none"}}FLASH.SYNC/LASER.LOCK.EXP/FLASH2.PPL1.OSC1/CURRENT_INPUT_JITTER.RD{{/code}}
896 +desc: rms jitter of the fs-Oscillator
897 +units: fs
898 +
1002 1002  [[Contents>>doc:||anchor="Contents"]]
1003 1003  
901 +\\
902 +
903 +=== "/uncategorized/" ===
904 +
905 + 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
906 +
907 +\\
908 +
1004 1004  === HDF5 structure revisions ===
1005 1005  
1006 1006  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: