Last modified by sndueste on 2025-09-08 15:36

From version 10.1
edited by sndueste
on 2019-09-18 16:47
Change comment: There is no comment for this version
To version 28.1
edited by sndueste
on 2022-09-08 11:18
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -7,7 +7,7 @@
7 7  == General Concept ==
8 8  
9 9  A large number of parameters which are essential for ALL Experiments is continuously saved (pulse energy, arrival time, Beamline settings ...) in the [[ PHOTONDIAGNOSTIC FLASH DAQ>>doc:FLASHUSER.FLASH1 PhotDiag stream]] system.
10 -Other [[experiment related information>>doc:FLASHUSER.Configuring the user DAQs]] is ONLY saved by the users ON DEMAND in the FLASH DAQ system. To record this type of data we have 3 User DAQs at FLASH1 (FLASH1_USER1,FLASH1_USER2 and FLASH1_USER3) and one at FLASH 2 (FLASH2_USER1)
10 +Other [[experiment related information>>doc:FLASHUSER.Configuring the user DAQs]] is ONLY saved by the users **ON DEMAND **in the FLASH DAQ system. To record this type of data we have 3 User DAQs at FLASH1 (FLASH1_USER1,FLASH1_USER2 and FLASH1_USER3) and two at FLASH 2 (FLASH2_USER1, FLASH2_USER2)
11 11  How to save this experiment related "User-Data" will be explained briefly in this page:
12 12  
13 13  \\
... ... @@ -20,18 +20,20 @@
20 20  
21 21  === DAQ control panel ===
22 22  
23 -To get to the User DAQ control one has to go to {{code language="none"}}Experiment control{{/code}} -> {{code language="none"}}User DAQ tab{{/code}} -> {{code language="none"}}FLxUSERy DAQ CTRL{{/code}}
24 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/jddd_DAQ-control-manual-how_to_get.png~|~|alt="jddd_DAQ-control-manual-how_to_get.png" width="500" height="360"~]~]>>attach:jddd_DAQ-control-manual-how_to_get.png]]
23 +To get to the User DAQ control one has to go to {{code language="none"}}Experiment control{{/code}} -> {{code language="none"}}User DAQ tab{{/code}} -> {{code language="none"}}FLxUSERy DAQ CTRL {{/code}}
24 +
25 +[[image:attach:jddd_DAQ-control-manual-how_to_get.png||width="500"]][[image:attach:image2022-9-8_10-50-53.png||width="450"]]
25 25  \\The following window opens. Here the User DAQ can be started and stopped as well as the incoming data can be visualized, information about data rates and saved properties is presented as well as the panel is automatically printed in to the logbook:
26 26  
27 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/jddd_DAQ-control-manual2.png~|~|alt="jddd_DAQ-control-manual2.png" width="960" height="720"~]~]>>attach:jddd_DAQ-control-manual2.png]]
28 +[[image:attach:jddd_DAQ-control-manual2.png||width="800"]]
28 28  \\\\
29 29  
30 30  \\
31 31  
32 -* By pressing the start and stop button, besides sending the commands to the DAQ the button prints the panel to the respective beamline / experiments logbook. Here you can later on keep track of the runs. Links to the Beamline logbooks can be found [[here>>doc:FLASH.Electronic Logbooks]] (DESY internal link)
33 -* After starting, the stop button appears only after saving abut 200 shots to prevent too early stopping which may disturb the DAQ.
34 -* Each run has a unique run number. This number is needed to retrieve the data later on. So it is important to keep track which number is associated to what experimental parameters. Note that the run numbers are used by all FLASH DAQs (currently about 10). It might thus well be, that two consecutive runs from you do have run numbers which are spaced by more than one if another DAQ has been started in-between ...
33 +* By pressing the start and stop button, besides sending the commands to the DAQ the button prints the panel to the respective beamline / experiments logbook. Here you can later on keep track of the runs. Links to the Beamline logbooks can be found [[here>>doc:FLASHUSER.Data Acquisition and controls.DAQ and controls overview.E-Logbooks.WebHome]].
34 +* here a sample entry in the **logbook**. The run number, "run comment" and several other parameters are printed as (searchable) text in addition with the screenshot of the DAQ control to get all relevant data for this run in the logbook: [[image:attach:image2022-9-8_10-57-56.png||thumbnail="true" height="250"]]
35 +* NOTE: After starting, the stop button appears only after saving abut 200 shots to prevent too early stopping which may disturb the DAQ.
36 +* NOTE: Each run has a unique run number. This number is needed to retrieve the data later on. So it is important to keep track which number is associated to what experimental parameters. Note that the run numbers are used by all FLASH DAQs (currently about 10). It might thus well be, that two consecutive runs from you do have run numbers which are spaced by more than one if another DAQ has been started in-between ...
35 35  
36 36  \\
37 37  
... ... @@ -66,7 +66,7 @@
66 66  
67 67  ==== Offline DAQ monitor ====
68 68  
69 -This tool looks if a predefined selection of parameters is saved in the raw file. When a raw.-file reached its maximum size ( ~~ 1 GB) it is closed and a new file is opened. Once closed, the Offline DAQ monitor reads the file and checks if there are entris for the selected parameters. It shows the fraction of events containing data. For “fast” data (data written with 10 Hz and bunch ID synchronous like images, ADC traces) this should be close to 100%. For “slow” data (saved about every second e.g. pressures , temperatures...) this is about 10-20%. **However it is to note** that this program just check if there is **anything** saved. It does not check if it is the proper data.
71 +This tool looks if a predefined selection of parameters is saved in the raw file. When a raw.-file reached its maximum size ( ~~ 1 GB) it is closed and a new file is opened. Once closed, the Offline DAQ monitor reads the file and checks if there are entries for the selected parameters. It shows the fraction of events containing data. For “fast” data (data written with 10 Hz and bunch ID synchronous like images, ADC traces) this should be close to 100%. For “slow” data (saved about every second e.g. pressures , temperatures...) this is about 10-20%. **However it is to note** that this program just check if there is **anything** saved. It does not check if it is the proper data.
70 70  
71 71  \\
72 72  
... ... @@ -74,12 +74,13 @@
74 74  
75 75  To ultimately check if the correct data is saved one can use the DAQ data GUI to look at the saved raw. files.
76 76  
77 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/DAQgui1.jpg~|~|alt="DAQgui1.jpg" width="500" height="350"~]~]>>attach:DAQgui1.jpg]][[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/DAQgui2.jpg~|~|alt="DAQgui2.jpg" width="500" height="350"~]~]>>attach:DAQgui2.jpg]][[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/daqgui3.png~|~|alt="daqgui3.png" width="500" height="350"~]~]>>attach:daqgui3.png]]
79 +[[image:attach:daqgui3.png||height="250"]][[image:attach:DAQgui2.jpg||height="250"]][[image:attach:DAQgui1.jpg||height="250"]]
80 +
78 78  \\
79 79  
80 -The DAQ Data GUI is a general tool to select and visualise data that was saved in the DAQ . It has in addition simple analysis options like histogram, mean, min or max values as function of time etc. Also correlations between different parameters can be analyzed in the tool. More details can be found [[How to Use the FLASH DAQ Data GUI?~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://ttfinfo.desy.de/FLASHWiki/Wiki.jsp?page=FLASHDAQdataGUI||shape="rect"]] and [[ here (DAQdataGUI link collection) >>doc:FLASH.How to get the data out of the DAQ]]
83 +The DAQ Data GUI is a general tool to select and visualize data that was saved in the DAQ . It has in addition simple analysis options like histogram, mean, min or max values as function of time etc. Also correlations between different parameters can be analyzed in the tool. More details can be found [[How to Use the FLASH DAQ Data GUI?~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://ttfinfo.desy.de/FLASHWiki/Wiki.jsp?page=FLASHDAQdataGUI||shape="rect"]] and [[ here (DAQdataGUI link collection) >>doc:FLASH.How to get the data out of the DAQ]]
81 81  
82 -The tool (separate Java program) can be started [[DAQdataGUI~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://ttfinfo2.desy.de/common/applications/DAQdataGUI-experimental.jnlp||shape="rect"]] or in the DAQ control panel ( lower right) on your local (Desy) PC. In some cases the access via Windows does not work. An option which should always work is to log onto {{code language="none"}}flashlxuser1{{/code}} or {{code language="none"}}flashlxuser2{{/code}} and start {{code language="none"}}DAQdataGUI{{/code}} from the command line.
85 +The tool (separate Java program) can be started [[DAQdataGUI~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:http://ttfinfo2.desy.de/common/applications/DAQdataGUI-experimental.jnlp||shape="rect"]] or in the DAQ control panel ( lower right) on your local user console (Linux or Windows) or lo onto the COntrol machines: {{code language="none"}}flashlxuser1,flashlxuser2{{/code}} or {{code language="none"}}flashlxuser3{{/code}} (there you also may start via  {{code language="none"}}DAQdataGUI{{/code}} from the command line).
83 83  
84 84  
85 85  \\To access the desired data one has to:
... ... @@ -97,17 +97,15 @@
97 97  The (% class="twikiNewLink" %)DAQdataGui(%%) is a powerful tool to visualize the saved data and to do very preliminary analysis. however for more detailed analysis the data has to be read into analysis programs ( matlab, python, Origin ...) here are different options one can use (what option is the best and how to set it up has to be discussed before hand with the FLASH DAQ experts ...)
98 98  
99 99  * The FLASH DAQ system records the data in binary " {{code language="none"}}.raw{{/code}} " files.
100 -** [[reading the data via Matlab >>doc:FLASHUSER.Data Acquisition and controls.Data Access at FLASH (DAQ, gpfs,\.\.\.).Offline data analysis (DAQ).For experts\: many ways to get Data from the DAQ.How to Access the DAQ Using Matlab.WebHome]] works not for all data types equally well and needs precise knowledge of the desired Parameters (useful to have a quick look / preliminary analysis on few parameters).
101 -** Examples how to read from {{code language="none"}}.raw{{/code}} files can also be found in [[the user code collection>>doc:FLASH.Collection of user codes]]
103 +** (% class="confluence-link" %)reading the .raw files [[directly via Python>>url:https://ttfinfo.desy.de/DOOCSWiki/Wiki.jsp?page=PythonDAQClientInterface||shape="rect"]], or [[via Matlab >>doc:FLASHUSER.Data Acquisition and controls.Data Access at FLASH (DAQ, gpfs,\.\.\.).Offline data analysis (DAQ).For experts\: many ways to get Data from the DAQ.How to Access the DAQ Using Matlab.WebHome]](%%)(no longer recommended) works, yet not for all data types equally well, and needs precise knowledge of the desired Parameters (useful to have a quick look / preliminary analysis on few parameters).
102 102  ** Note that the raw data is only accessible from certain computers within the DESY network and thus not very handy for offline analysis later on ...
103 103  
104 104  \\
105 105  
106 106  * To ease the data analysis we IN ADDITION provide //ON REQUEST// the data from the FLASH DAQ as HDF5 format
107 -** ONLINE HDF5s: To make efficient use of the HDF5 files for analysis during the beamtime and afterwards we provide a [[very useful tool (Beamtime Daq Access)>>doc:FLASHUSER.Near-Online data analysis]]. Using this tool (working for Python and Matlab) one can get the data of parameters per run or for specific bunch ID intervals etc. without having to care from which subset of HDF5 files the data is read ...
108 -** Summary HDF5 files include complete runs. They will be put after the beamtime on the gpfs storage and are available from computers within DESY (for registered Beamtime participants) and also access
109 -** Intro to the [[HDF5 structure used at FLASH>>doc:FLASHUSER.Data Acquisition and controls.Data Access at FLASH (DAQ, gpfs,\.\.\.).Offline data analysis (DAQ).The FLASH HDF5 structure.WebHome]]. This contains also a list of the most used Parameters saved at FLASH for analysis - including the HDF5 names, DOOCS and DAQ names ...
110 -** [[Short examples>>doc:FLASHUSER.Data Acquisition and controls.Data Access at FLASH (DAQ, gpfs,\.\.\.).Offline data analysis (DAQ).The FLASH HDF5 structure.WebHome]] and [[user provided examples>>doc:FLASH.Collection of user codes]] on how to read HDF5 in Matlab
109 +** ONLINE HDF5s: Intro to the [[HDF5 structure used at FLASH>>doc:FLASHUSER.Data Acquisition and controls.Data Access at FLASH (DAQ, gpfs,\.\.\.).Offline data analysis (DAQ).The FLASH HDF5 structure.WebHome]]. This contains also a list of the most used Parameters saved at FLASH for analysis - including the HDF5 names, DOOCS and DAQ names ...
110 +** [[Examples>>url:https://gitlab.desy.de/christopher.passow/flash-daq-hdf||shape="rect"]] and an [[API>>url:https://gitlab.desy.de/christopher.passow/fdh-builder||shape="rect"]] to make use of the online HDF5s
111 +** [[Short examples>>doc:FLASHUSER.Data Acquisition and controls.Data Access at FLASH (DAQ, gpfs,\.\.\.).Offline data analysis (DAQ).The FLASH HDF5 structure.WebHome]] and [[user provided examples>>doc:FLASH.OUTDATED - Collection of user codes]] on how to read HDF5 in Matlab (no longer recommended).
111 111  
112 112  The HDF5 files (online and summary) are saved in the [["gpfs" system ~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://confluence.desy.de/display/ASAP3/Architecture||shape="rect"]]. it can be accessed from [[Windows and Linux computers at DESY~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://confluence.desy.de/display/ASAP3/Mounting+the+storage+system+at+the+beamline||shape="rect"]] by the persons ( logins) which are registered for the beamtime in DOOR ( functional accounts
113 113  
... ... @@ -116,7 +116,7 @@
116 116  * /asap3/flash/gpfs/ //beamline used// / //year// /data/ //Beamtime application number// /raw/hdf/ (the //Beamtime application number// can be fund in the pdf schedule sent around by Rolf ...)
117 117  * as example: {{code language="none"}}/asap3/flash/gpfs/bl2/2017/data/11003163/raw/hdf/{{/code}}
118 118  
119 -More details and links can be found in the [[doc:FLASHUSER.User overview]].
120 +More details and links can be found in the [[doc:FLASHUSER.Data Acquisition and controls.DAQ and controls overview.WebHome]].
120 120  
121 121  \\
122 122  
... ... @@ -132,15 +132,19 @@
132 132  
133 133  === Configuring the DAQ ===
134 134  
136 +[[image:attach:RCGUI_2.jpg||height="400"]]
137 +\\
135 135  
136 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/RCGUI_2.jpg~|~|alt="RCGUI_2.jpg" width="400" height="500"~]~]>>attach:RCGUI_2.jpg]]
139 +\\
137 137  
138 -Using the jddd DAQ control panel one can start and stop runs but in order to configure the DAQ which data to save one has to use a a separate *DAQ run control * java application. Since it needs write access to DOOCS internal file systems, which can not be made available elsewhere one has to start the system on our DOOCS control computers [[flashlxuser1.desy.de>>url:http://flashlxuser1.desy.de||shape="rect"]]{{code language="none"}}{{/code}} or [[flashlxuser2.desy.de>>url:http://flashlxuser2.desy.de||shape="rect"]]{{code language="none"}}{{/code}}.
139 -Log in with the beamline account (bl1user, bl2user, ..., fl24user...) either via X-Win32 from windows or via ssh from Linux machines.
140 -Once logged in to {{code language="none"}}flashlxuser1{{/code}} or {{code language="none"}}flashlxuser2{{/code}} the DAQ run control can be started. Depending on the DAQ you want to use the commands are:
141 +Using the jddd DAQ control panel one can start and stop runs but in order to configure the DAQ which data to save one has to use a a separate *DAQ run control * java application. Since it needs write access to DOOCS internal file systems, which can not be made available elsewhere one has to start the system on our linux user consoles at the beamline or on the  DOOCS control computers {{code language="none"}}flashlxuser1.desy.deflashlxuser2.desy.de {{/code}} or {{code language="none"}}flashlxuser3.desy.de{{/code}}.
142 +Log in with the beamline account (bl1user, bl2user, ..., fl24user...) either via fastX3 or {{code language="none"}}Remote desktop{{/code}} from windows or via ssh from Linux machines.
143 +Once logged in to {{code language="none"}}flashlxuser1,2,3{{/code}} the DAQ run control can be started in the "advanced"  Tab of the DAQ control :
141 141  
142 -\\
145 +[[image:attach:image2022-9-8_11-14-7.png||border="true" width="343" height="250"]]
143 143  
147 +Or in the command line:
148 +
144 144  (% class="wrapped" %)
145 145  |(((
146 146  Unix command
... ... @@ -175,29 +175,33 @@
175 175  )))|(((
176 176  FLASH2_USER1 DAQ
177 177  )))
183 +|(% colspan="1" %)(((
184 +{{code language="none"}}
185 +RCGUIFL2USER2
186 +{{/code}}
187 +)))|(% colspan="1" %)(((
188 +FLASH2_USER2 DAQ
189 +)))
178 178  
179 -Which DAQ to use is decided by the FLASH DAQ team according to the beamtime schedule.
180 -
181 181  \\
182 182  
183 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/RCGUI_properties.jpg~|~|alt="RCGUI_properties.jpg" width="503" height="311"~]~]>>attach:RCGUI_properties.jpg]]
193 +Which DAQ to use is decided by the FLASH DAQ team according to the beamtime schedule.
184 184  
195 +[[image:attach:RCGUI_properties.jpg||height="400"]]
196 +
185 185  \\
186 186  
187 -Using the {{code language="none"}}Add{{/code}} and {{code language="none"}}Rem(ove){{/code}} buttons one can move the desired "subsystems" in the included side - meaning that they are saved. The "subsystems" contain typically several DOOCS parameters. E.g. {{code language="none"}}EXPERIMENT_MHZ_ADC_BL1{{/code}} contains all relevant DOOCS properties of the 4 MHZ ADC channels available at BL1. To get a detailled information about the saved parameters one can have a look to the "Show Properties in Subsystems" button . In addition, a list of all possible subsystems and their description can be found [[here>>doc:FLASHUSER.Configuring the user DAQs]].
199 +Using the {{code language="none"}}Add{{/code}} and {{code language="none"}}Rem(ove){{/code}} buttons one can move the desired "subsystems" in the included side - meaning that they are saved. The "subsystems" contain typically several DOOCS parameters. E.g. {{code language="none"}}EXPERIMENT_MHZ_ADC_BL1{{/code}} contains all relevant DOOCS properties of the four  MHZ ADC channels available at BL1. To get a detailed information about the saved parameters one can have a look to the "Show Properties in Subsystems" button . In addition, a list of all possible subsystems and their description can be found [[here>>doc:FLASHUSER.Configuring the user DAQs]].
188 188  
189 189  \\
190 190  
191 191  === Configuring the DAQ monitor ===
192 192  
193 -The DAQ monitor ( and the Offline monitor) can be confgured using DAQdataGUI.
194 -Load a test run containing all relavant propoerties. Select all properties you want to monitor. Use {{code language="none"}}Tools -> Channels to DAQMonitor{{/code}} and choose your DAQ. This sends a list with the selected properties to the DAQ monitor of your system.
195 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/daq_monitor_config.png~|~|alt="daq_monitor_config.png" width="700" height="390"~]~]>>attach:daq_monitor_config.png]]
205 +The DAQ monitor ( and the Offline monitor) can be configured using DAQdataGUI.
206 +Load a test run containing all relevant properties. Select all properties you want to monitor. Use {{code language="none"}}Tools -> Channels to DAQMonitor{{/code}} and choose your DAQ. This sends a list with the selected properties to the DAQ monitor of your system.
196 196  
197 -\\
208 +[[image:attach:daq_monitor_config.png||height="400"]]
198 198  
199 -\\
200 -
201 201  === Start and Stop a run ===
202 202  
203 203  In order to "activate" and test your configuration you have to start a run with the new configuration. **NOTE: Whenever the configuration was changed with the RCGUI the new run HAS to be started with the RCGUI **(starting with the jddd DAQ panel would only start the last configuration that has been running before !!!
... ... @@ -214,15 +214,10 @@
214 214  
215 215  \\
216 216  
217 -\\
218 -
219 -\\
220 -
221 221  === Load/Save the configuration ===
222 222  
228 +[[image:attach:whitelist.jpg||height="400"]]
223 223  
224 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/whitelist.jpg~|~|alt="whitelist.jpg" width="532" height="370"~]~]>>attach:whitelist.jpg]]
225 -
226 226  Once a list of subsystems is defined and tested this parameter combination should then be saved in a so-called //white list//. By loading this white list one can then easily configure the DAQ after changes / restarts ... to the initially defined settings to save the correct data.
227 227  The whitelist can be saved/loaded with the Run Control GUI by: {{code language="none"}}File -> Group White List -> Save/Load{{/code}}. Note, while the top left rectangle's background of time and date is yellow, don't try any further controls of the GUI, you might confuse the program. It is busy reading the configuration from the run control database. The background changes back to grey when it has finished.
228 228  \\The filename convention for the White Lists are arranged in the way:
... ... @@ -232,14 +232,24 @@
232 232  
233 233  \\
234 234  
235 -\\
239 +=== Choosing the file size ===
236 236  
237 -\\
241 +The DAQ writes into a file (in .raw format) up to a configurable value. If the limit is reached the file will be closed and a new file will be started. Thus a run can contain tens to hundreds of files.
238 238  
239 -=== Assigning the DAQ to the beamline in jddd ===
243 +The size can be configured to be 100 MB, 350 MB or 1000 MB (default)
240 240  
241 -To assign which DAQ is used at what beamline one has to use the dropdown menu in the {{code language="none"}}parameter monitor{{/code}}. In each Beamline overview tab (BL1,2,3) there is a button (upper right) that starts the {{code language="none"}}parameter monitor{{/code}} panel. In the upper middle is a DAQ field in which the appropriate DAQ can be assigned to the Beamline.
245 +Few things to consider (in case of doubt talk to the expert (Erland ...)):
242 242  
247 +* 1000 MB: This is the standard setting which is best for archiving (few large files are preferred). However mainly for images that are saved with less than 10 Hz the HDF5 converter has problems with the large files. And for low data rates it may take upto half an hour to fill one 1GB file. Then smaller ones are also preferable.
248 +* 350 MB: Often a good compromise ...
249 +* 100 MB: It is not preferred to have many "small" files for storing the data. For very small data rates this is an option to not wait too long till the next file is created.
250 +
251 +To choose the desired file size one has to choose a run mode configuration in the RunControlGUI
252 +
253 +[[~[~[image:attach:image2020-1-17_13-39-38.png~|~|height="400"~]~]>>attach:image2020-1-17_13-39-38.png]]
254 +
255 +This will however the clear the definition of selected subsystems and one has to reload the whitelist of the experiment again.
256 +
243 243  \\
244 244  
245 245  \\
... ... @@ -248,21 +248,24 @@
248 248  
249 249  \\
250 250  
265 +=== Assigning the DAQ to the beamline in jddd ===
266 +
267 +To assign which DAQ is used at what beamline one has to use the dropdown menu in the {{code language="none"}}parameter monitor{{/code}}. In each Beamline overview tab (BL1,2,3) there is a button (upper right) that starts the {{code language="none"}}parameter monitor{{/code}} panel. In the upper middle is a DAQ field in which the appropriate DAQ can be assigned to the Beamline.
268 +
269 +\\
270 +
251 251  === Setting the logbook to print in / putting the Whitelist name in jddd ===
252 252  
253 253  The jddd DAQ Control should be set up that it prints by default the relevant run information in the logbook associated to your beamline [[Logbooks>>doc:FLASH.Electronic Logbooks]]
254 254  
255 255  Define logbook / and whitelist for display in the jddd DAQ control (jddd otherwise does not "know" which White list was used ... this has to be put in by hand ...up to now)
256 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/setting_parameters.jpg~|~|alt="setting_parameters.jpg" width="500" height="300"~]~]>>attach:setting_parameters.jpg]]
257 257  
258 -\\
277 +[[image:attach:setting_parameters.jpg||height="400"]]
259 259  
260 260  \\
261 261  
262 262  \\
263 263  
264 -\\
265 -
266 266  == In case something goes wrong: Troubleshooting ==
267 267  
268 268  \\
... ... @@ -269,7 +269,7 @@
269 269  
270 270  === No //START// or //STOP// buttons are visible in the DAQ control panel ===
271 271  
272 -~* The jddd GUI only shows the Start and stop bunnon if the DAQ is in the "Idle" state. sometimes the DAQ "just" gets stuck in the stopping phase. Then stopping again or starting form the not "Idle" state can help. For this goto the "Advanced" tab of the jddd DAQ control . there the START and STOP buttons are always available ... independent of the state of the DAQ. If this does not help you may have to restart the DAQ ...
289 +~* The jddd GUI only shows the Start and stop button if the DAQ is in the "Idle" state. sometimes the DAQ "just" gets stuck in the stopping phase. Then stopping again or starting form the not "Idle" state can help. For this goto the "Advanced" tab of the jddd DAQ control . there the START and STOP buttons are always available ... independent of the state of the DAQ. If this does not help you may have to restart the DAQ ...
273 273  
274 274  \\
275 275  
... ... @@ -285,9 +285,11 @@
285 285  
286 286  === Data seems not properly saved ===
287 287  
305 +[[image:attach:RC_logfile.jpg||height="250"]]
288 288  
289 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/RC_logfile.jpg~|~|alt="RC_logfile.jpg" width="518" height="300"~]~]>>attach:RC_logfile.jpg]]When checking the saved run with the (% class="twikiNewLink" %)DAQdataGUI(%%) it may happen that the property shows up in the data tree but no events are saved. Then (most likely) something is wrong with the sending of the data.
290 290  
308 + When checking the saved run with the (% class="twikiNewLink" %)DAQdataGUI(%%) it may happen that the property shows up in the data tree but no events are saved. Then (most likely) something is wrong with the sending of the data.
309 +
291 291  * A very helpful tool is the {{code language="none"}}RC logfile{{/code}}. in the RCGUI on the lower right side there is a button to start an editor with the log file. besides lots of standard entries there is usually also a hint on where to find the problem ...
292 292  * check if the device is working properly. Is it connected? Can you see data in jddd / DOOCS ? . If not you have to fix the DOOCS part ... DAQ can only save what is properly implemented in DOOCS.
293 293  * If camera images are not properly saved ( e.g. only "0"s in the image matrix or the DAQ sender can not be switched to "on") a **restart of the camera server** usually helps.
... ... @@ -309,36 +309,35 @@
309 309  \\
310 310  
311 311  * Generally there 3 ways to "restart" the DAQ
312 -** 1. The least interferring way is the "all to INITIALIZE" that tries to reset the DAQ processes ... helps for simple "hickups"
331 +** 1. The least interfering way is the "all to INITIALIZE" that tries to reset the DAQ processes ... helps for simple "hickups"
313 313  ** 2. The "re-start DAQ" really reboots the whole DAQ process. The settings still should be as before ... this is the "Usual" restart
314 314  ** 3. In very hard and severe cases there is the ultimate restart button: "re-start DAQ (no RCSHM)"
315 315  
316 316  
317 -\\*Here in more detail:*
336 +\\//**Here in more detail:**//
318 318  
319 319  \\
320 320  
321 321  * if the DAQ gets stuck in the starting or stopping procedure one can try to initialize the DAQ or in the worst case restart it.
322 -** to be able to restart the DAQ one has to run jddd on the {{code language="none"}}flashlxuser1{{/code}} or {{code language="none"}}flashlxuser2{{/code}} (up to now (Aug 2018) the restat on our consoles (cons0...12) is NOT possible yet [[image:url:http://hasfweb.desy.de/pub/TWiki/SmiliesPlugin/frown.gif||alt="frown"]]) : log in at one of these machines with your beamline account (e.g. bl1user or fl24user). Start jddd with the {{code language="none"}}jFLASH{{/code}} command. Click on "Photons" -> Experimental Hall "Photons main panel"
341 +** **to be able to restart the DAQ one has to run jddd on the {{code language="none"}}flashlxuser1,flashlxuser2{{/code}} or {{code language="none"}}flashlxuser3{{/code}} (up to now ( 2021) the restat on our consoles (cons0...12) is NOT reliably possible ) : log in at one of these machines with your beamline account (e.g. bl1user or fl24user). Start jddd with the {{code language="none"}}flash{{/code}} command. Click on "Photons" -> Experimental Hall "Photons main panel"**
323 323  ** The DAQ "expert" panel can be reached from the User DAQ control panel.
324 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/DAQ_expert.jpg~|~|alt="DAQ_expert.jpg" width="400" height="350"~]~]>>attach:DAQ_expert.jpg]]
325 325  
344 + [[image:attach:DAQ_expert.jpg||height="400"]]
326 326  \\
327 327  
328 -\\
329 -
330 330  *
331 331  ** Then you see the following "DAQ expert panel":
332 332  ** first one may try the "all to INITIALIZE" button. it starts a script window and asks for the passwd (the beamline accounts (blxuser) should have the according rights. vuvfuser has it for sure. The script sets all subcomponents to initialize. It is helpful if one subcomponent got stuck.
333 333  
351 + [[image:attach:UserDAQ_status.jpg||height="400"]]
352 +\\
334 334  
335 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/UserDAQ_status.jpg~|~|alt="UserDAQ_status.jpg" width="500" height="400"~]~]>>attach:UserDAQ_status.jpg]]
336 -
337 337  \\
338 338  
339 339  * If this does not help you have to "re-start DAQ". This completely restarts all processes and takes a while. A script window appears and shows what steps are actually done. At the end is sais: "Cleanup finished".
340 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/DAQ_restart_msg.jpg~|~|alt="DAQ_restart_msg.jpg" width="400" height="350"~]~]>>attach:DAQ_restart_msg.jpg]]
341 341  
358 + [[image:attach:DAQ_restart_msg.jpg||height="400"]]
359 +
342 342  \\
343 343  
344 344  * For the "re-start DAQ" the DAQ should come up in the same state as before. Meaning that the subsystems (ADCs, cameras ..) are still loaded and displayed. If this is not the case you can try to load your white list and start a new run. If the data is saved correctly you are done.
... ... @@ -348,14 +348,15 @@
348 348  * **IF the DAQ still does not work properly** the final option is the: "re-start DAQ (no RCSHM)". This button does the same as the "re-start DAQ" but the Run Controller shared memory is **not** re-stored. It means that after the DAQ is back no run configuration is selected.
349 349  ** in the jddd control the list of subsystems sais "empty"
350 350  ** in the RCGUI in the lower part it sais "RUN mode is not set"
351 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/restart_RCM_no_runmode.jpg~|~|alt="restart_RCM_no_runmode.jpg" width="400" height="400"~]~]>>attach:restart_RCM_no_runmode.jpg]]
352 352  
370 + [[image:attach:restart_RCM_no_runmode.jpg||height="400"]]
353 353  \\
354 354  
373 +\\
374 +
355 355  *
356 -** one has to go to the "Run Modes" tab and select the run mode {{code language="none"}}FLASH1_EXP{{/code}} by clicking on it !
357 -[[~[~[image:url:http://hasfweb.desy.de/pub/Setup/DAQjddd/runmode_set.jpg~|~|alt="runmode_set.jpg" width="400" height="400"~]~]>>attach:runmode_set.jpg]]
358 -** then one has to go back to the {{code language="none"}}Subsystems{{/code}} . now all subsystems are included.
376 +** one has to go to the "Run Modes" tab and select the run mode {{code language="none"}}FLASH1_EXP{{/code}} by clicking on it and choose the desired file size (stored settings)
377 +** then one has to go back to the {{code language="none"}}Subsystems{{/code}} . initially all subsystems are included.
359 359  ** finally you have to select your White list and start a run ...
360 360  
361 361  \\
... ... @@ -370,13 +370,19 @@
370 370  
371 371  ----
372 372  
373 -[[Some more details for experts ...>>doc:FLASH.Collection of Detailsof the DAQ from various times \.\.\. not for public use]]
392 +== [[Some more details for experts ...>>doc:FLASH.Collection of Detailsof the DAQ from various times \.\.\. not for public use]] ==
374 374  
394 +=== Re-read the data base ===
395 +
396 +If there are new Properties included by Vladimir et al one has to reread the data base.
397 +
398 +This can be done easiest by going to the run modes and choose a different "stored setting" (changing e.g. from filesize 100 MB to 350 MB) and going back to subsystems. At this point the new database entries are read in. then one can do the same backwards to switch back to the initial file size. Doing this the configured list of subsystems is lost and one has to reload the whitelist and start a run to get the loaded whitelist in the configuration.
399 +
375 375  \\
376 376  
377 -=== Re-read the data base ===
402 +OR one can do the hard way:
378 378  
379 -On flashlxuser1 or 2 start RCGUIFL1USER1 or appropriate to the DAQ you want to reconfigure. Select the tab "Run Modes". To then reload or re-init the run control database you need the expert menu entry:
404 +On flashlxuser1,2 or 3 start RCGUIFL1USER1 or appropriate to the DAQ you want to reconfigure. Select the tab "Run Modes". To then reload or re-init the run control database you need the expert menu entry:
380 380  
381 381  {{code language="none"}}Options -> "Show Expert Menu"{{/code}}
382 382  
... ... @@ -387,3 +387,27 @@
387 387  {{code language="none"}}"expert" -> "Run Control Commands" -> "Re-init SHM"{{/code}}
388 388  
389 389  Now close the RCGUI and start it again. Switch to the tab "subsystems", wait for the subsystems to be reloaded and load the whitelist you want to use.
415 +
416 +\\
417 +
418 +Tracking DAQ restarts
419 +
420 +A system was implemented (March 2020) where each restart of a user DAQ is recorded in a log file
421 +
422 +One can see all log files in :
423 +
424 +/home/doocsadm/bm/rcdb/restartslog/
425 +
426 +=== data base errors ===
427 +
428 +The red flags next to the  different stream indicators tell something about data base errors
429 +
430 +\\
431 +
432 +[[image:attach:2021-02-10 15_23_20-How to save data in the User DAQ - FS-FLASH USER - DESY Confluence.png||width="600"]]
433 +
434 +upper flag:  There was a problem to read run catalogue
435 +
436 +lower flag: There was a problem to read dccp catalogue.
437 +
438 +In both cases there are counters of failures to read a catalogue. If this counter is not incrementing with every attempt to read a catalogue, then it's no problem. It can be monitored and reset in the panel that one gets by pressing on "green" area.