Subruns: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
No edit summary
(The midas documentation has moved to https://midas.triumf.ca/docs/)
 
Line 1: Line 1:
{{Pagelinks}}
The midas documentation has moved. See [https://midas.triumf.ca/docs/develop/features/storing_data/data_logging/midas_files/#subrun-duration Subrun duration] in Data logging: midas files for the new documentation about subruns.
 
A '''subrun''' scheme is available in the MIDAS event logger utility ([[mlogger]])
to split a big data file into several individual data files. This feature might be helpful if a data file from a single run gets too large (>4 GB for example) and if shorter runs are not wanted for efficiency reasons. The scheme works as follows:
In the  ODB [[Keys in the ODB /Logger/Channels tree #/Logger/Channels/<logging-channel-number>/Settings subtree | /Logger/Channels/x/Settings/ subtree]] except where noted
 
* If a new subrun is to be started
** after a certain '''time''' :
*** Set  [[Keys in the ODB /Logger tree #/Logger/Subrun duration | /Logger/Subrun duration]] key to the required time in seconds.
** or after a certain '''number of bytes''' :
*** Set  [[Keys in the ODB /Logger/Channels tree #/Logger/Channels/0/Settings/Subrun Byte limit | Subrun Byte limit key]] to the required number of bytes for the subrun
 
*    Set [[Keys in the ODB /Logger/Channels tree #/Logger/Channels/0/Settings/Filename | Filename key]] to something like run%05d_%02d.mid. The first %05d will be replaced by the run number, while the second one will be replaced by the subrun number. This will result in files such as
 
    run00001_00.mid    run #1
    run00001_01.mid      "
    run00001_02.mid      "
    run00001_03.mid      "
    run00002_00.mid    run #2
    run00002_01.mid      "
    run00002_02.mid      "
    run00002_03.mid      "
 
 
Each subrun will contain an ODB dump if this is turned on via [[Keys in the ODB /Logger/Channels tree #/Logger/Channels/0/Settings/ODB Dump | ODB Dump key]].
The stopping of the "main" run (after four subruns in the above example) can be done in the usual way (event limit in the front-end, manually through [[odbedit]], etc.).
 
'''Note:''' the user may manually request a new subrun to start, set the [[Keys in the ODB /Logger tree #/Logger/Next subrun | Next subrun key]] to "y".
 
 
[[Category:Data Logging]]

Latest revision as of 22:01, 30 October 2026

The midas documentation has moved. See Subrun duration in Data logging: midas files for the new documentation about subruns.