Skip to Content

Changes for page The FLASH HDF5 structure

Last modified by sndueste on 2025/09/10 11:43
From version 89.11
edited by sndueste
on 2025/04/23 14:55
Change comment: Update document after refactoring.
To version 89.12
edited by sndueste
on 2025/04/24 13:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -111,7 +111,6 @@
111 111  == Complete list of recordable parameters ==
112 112  
113 113  The complete list for the relation between DOOCS names and HDF5 names for the recordable parameters can be found in [[DESY's Repository>>url:https://stash.desy.de/projects/CS/repos/pah/browse/src/camp/data/channel2HdfName.dat||shape="rect"]].
114 -
115 115  
116 116  == Most popular FLASH parameters and their names in HDF5, DOOCS and (raw) DAQ ==
117 117  
... ... @@ -130,7 +130,6 @@
130 130  DAQ channel: {{code language="none"}}FLASH.FEL/GAS_DOSING/FL1.ATTENUATOR/PRESSURE{{/code}}
131 131  desc: set pressure in the gas attenuator
132 132  units: mbar
133 -
134 134  
135 135  {{code language="none"}}/FL1/Beamlines/BL/Fast shutter/open{{/code}}
136 136  //always saved (PBD)//
... ... @@ -152,7 +152,6 @@
152 152  DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS1/FILTER1/FW.MOTOR.POS{{/code}}
153 153  desc: Position of the BL filter wheel 1 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
154 154  units: degree
155 -
156 156  
157 157  {{code language="none"}}/FL1/Beamlines/BL/Filters/BL filter wheel/position filter 2{{/code}}
158 158  //always saved (PBD)//
... ... @@ -160,7 +160,6 @@
160 160  DAQ channel: {{code language="none"}}TTF2.FEL/BLFILTERS2/FILTER2/FW.MOTOR.POS{{/code}}
161 161  desc: Position of the BL filter wheel 2 - to correlate with the filter material please look [[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]
162 162  units: degree
163 -
164 164  
165 165  {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 1{{/code}}
166 166  //always saved (PBD)//
... ... @@ -168,7 +168,6 @@
168 168  DAQ channel: {{code language="none"}}TTF2.FEL/BDAF1/BDA.F1/FW.MOTOR.POS{{/code}}
169 169  desc: Position of the PG filter wheel 1
170 170  units: degree
171 -
172 172  
173 173  {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 2{{/code}}
174 174  //always saved (PBD)//
... ... @@ -176,7 +176,6 @@
176 176  DAQ channel: {{code language="none"}}TTF2.FEL/BDAF2/BDA.F2/FW.MOTOR.POS{{/code}}
177 177  desc: Position of the PG filter wheel 2
178 178  units: degree
179 -
180 180  
181 181  {{code language="none"}}/FL1/Beamlines/PG/Filters/position filter 3{{/code}}
182 182  //always saved (PBD)//
... ... @@ -267,7 +267,6 @@
267 267  
268 268  {{info title="GMD pulse resolved data structure"}}
269 269  For every pulse in the pulse train the information is saved:
270 -
271 271  
272 272  1. **Intensity per pulse** (a.u. (more or less µJ ))
273 273  1. Intensity per pulse (auxillary GMD) - not used
... ... @@ -511,7 +511,6 @@
511 511  DAQ channel: {{code language="none"}}PBD.BEAM.PROF.ML/DAQ.OUT.PROF.CCCED{{/code}}
512 512  desc: temporal profile of electron bunch, y axis in Ampers (FLASH1)
513 513  units: pixel
514 -
515 515  
516 516  {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/Expert stuff/TDS calibration constant{{/code}}
517 517  //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
... ... @@ -519,7 +519,6 @@
519 519  DAQ channel: = PBD.BEAM.PROF.ML/CCT=
520 520  desc: TDS calibration constant for the x-axis of the profiles: fs per pixel
521 521  units: fs per pixel
522 -
523 523  
524 524  {{code language="none"}}/FL1/Electron Diagnostic/Electron bunch profile/TDS profile width rms{{/code}}
525 525  //always saved (PBD) - IF LOLA is ON and ACTIVATED in the PBD DAQ (talk to expert)//
... ... @@ -535,8 +535,7 @@
535 535  DOOCS prop : {{code language="none"}}TTF2.DAQ/ENERGY.DOGLEG/E_INTRA_MEAN/VAL{{/code}}
536 536  DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/E_MEAN{{/code}}
537 537  desc: electron bunch energy (average over the bunch train)
538 -units: (% class="twikiNewLink" %)MeV(%%)
539 -
529 +units: (% class="twikiNewLink" %)MeV
540 540  
541 541  {{code language="none"}}/FL1/Electron Diagnostic/Electron energy/pulse resolved energy{{/code}}
542 542  //always saved (PBD)//
... ... @@ -552,7 +552,6 @@
552 552  DAQ channel: {{code language="none"}}PBD.ENERGY.DOGLEG/LAMBDA_MEAN{{/code}}
553 553  desc: Wavelength calculated by the electron bunch energy (average over the bunch train) (FLASH1)
554 554  units: nm
555 -
556 556  
557 557  [[Contents>>doc:||anchor="Contents"]]
558 558  
... ... @@ -567,7 +567,6 @@
567 567  DAQ channel: {{code language="none"}}TTF2.UTIL/LASER.CONTROL/GUN/PULSE_FREQ{{/code}}
568 568  desc: repetition rate of the bunches / pulses within the burst (FLASH1)
569 569  units: kHz
570 -
571 571  
572 572  ===== set number of pulses =====
573 573  
... ... @@ -586,7 +586,6 @@
586 586  DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
587 587  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)
588 588  units:
589 -
590 590  
591 591  ===== actual pulse pattern recorded after the undulator =====
592 592  
... ... @@ -596,7 +596,6 @@
596 596  DAQ channel: {{code language="none"}}TTF2.DIAG/PBD.TOROID.ML/12EXP{{/code}}
597 597  desc: The bunch pattern as function of time in a burst recorded by toroid diagnostic BEHIND the undulator. (FLASH1)
598 598  units:
599 -
600 600  
601 601  ===== Train ID =====
602 602  
... ... @@ -606,21 +606,22 @@
606 606  DAQ channel: {{code language="none"}}none{{/code}}
607 607  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 !)
608 608  units:
609 -
610 610  
611 -===== Train time =====
596 +===== (% style="color:#e67e22" %)Train time(%%) =====
612 612  
613 -{{code language="none"}}/Timing/train time{{/code}}
598 +(% style="color:#e67e22" %){{code language="none"}}/Timing/train time{{/code}}
614 614  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
615 615  units: d h min s cs
616 -
617 617  
618 -{{code language="none"}}/Timing/time stamp{{/code}}
602 +(% style="color:#e67e22" %){{code language="none"}}/Timing/time stamp{{/code}}
619 619  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
620 620  second column: microseconds
621 621  third column: Train ID of FLASH
622 -
623 623  
607 +currently it is saved as Unix time in
608 +
609 +|/zraw/FLASH.DIAG/TIMINGINFO/TIME1.BUNCH_FIRST_INDEX.1/dGroup/time
610 +
624 624  [[Contents>>doc:||anchor="Contents"]]
625 625  
626 626  
... ... @@ -754,8 +754,7 @@
754 754  (% style="color:#000000" %)DOOCS prop : {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
755 755  (% style="color:#000000" %)DAQ channel:  {{code language="none"}}FLASH.FEL/ATT.GAS_DOSING/FL2.HALL/PRESSURE{{/code}} (%%)
756 756  (% style="color:#000000" %)desc: set pressure in the gas attenuator (%%)
757 -(% style="color:#000000" %)units: mbar(%%)
758 -
744 +(% style="color:#000000" %)units: mbar
759 759  
760 760  {{code language="none"}}/FL2/Beamlines/FL20/Shutter/open{{/code}}
761 761  //always saved (PBD2)//
... ... @@ -771,7 +771,6 @@
771 771  DAQ channel: FLASH.FEL/FL20H.PH.MOTOR/MOTOR1.MOT3/FPOS
772 772  desc: Position of the BL filter wheel 1 - to correlate with the filter material please look **[[here>>doc:FS-FLASH USER tmp.jddd-linked help pages.Filter-Units.Filter wheels in FLASH1 and FLASH2.WebHome]]**
773 773  units: degree
774 -
775 775  
776 776  /FL2/Beamlines/Filter wheel/position wheel 2
777 777  always saved (PBD2)
... ... @@ -806,7 +806,6 @@
806 806  
807 807  {{info title="GMD pulse resolved data structure"}}
808 808  For every pulse in the pulse train the information is saved:
809 -
810 810  
811 811  1. **Intensity per pulse** (a.u. (more or less µJ ))
812 812  1. Intensity per pulse (auxillary GMD) - not used
... ... @@ -1104,7 +1104,6 @@
1104 1104  DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/3GUN/NUMBEROFBUNCHES.FLASH2{{/code}}
1105 1105  desc: Number of bunches measured BEHIND the undulator. If pulses are used for diagnostic of the protection system of the accelerator limits the number of bunches to be accelerated this is the actual number that created XUV radiation.The number is calculated by the DAQ middle layer server, (FLASH2)
1106 1106  units:
1107 -
1108 1108  
1109 1109  ===== actual pulse pattern recorded after the undulator =====
1110 1110  
... ... @@ -1114,7 +1114,6 @@
1114 1114  DAQ channel: {{code language="none"}}FLASH.DIAG/PBD2.TOROID.ML/9FL2BURN.PULSEPATTERN{{/code}}
1115 1115  desc: The bunch pattern as function of time in a burst recorded by toroide diagnostic BEHIND the undulator. (FLASH2)
1116 1116  units:
1117 -
1118 1118  
1119 1119  ===== Train ID =====
1120 1120  
... ... @@ -1124,7 +1124,6 @@
1124 1124  DAQ channel: {{code language="none"}}none{{/code}}
1125 1125  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 !)
1126 1126  units:
1127 -
1128 1128  
1129 1129  ===== Train time =====
1130 1130  
... ... @@ -1132,7 +1132,6 @@
1132 1132  {{code language="none"}}/Timing/train time{{/code}}
1133 1133  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
1134 1134  units: d h min s cs
1135 -
1136 1136  
1137 1137  {{code language="none"}}
1138 1138  /Timing/time stamp
... ... @@ -1142,7 +1142,6 @@
1142 1142  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
1143 1143  second column: microseconds
1144 1144  third column: Train ID of FLASH
1145 -
1146 1146  
1147 1147  [[Contents>>doc:||anchor="Contents"]]
1148 1148