InstructionsForCasualUsers

The intention of this page is to provide a few simple instructions that new or casual users can use to quickly demonstrate the operation of a small MiniDAQ system that uses emulators instead of real electronics.

The steps fall into a few general categories, and they draw on more detailed instructions from other repositories, for example, daq-buildtools and nanorc.

  1. setup the environment

  2. generate the sample system configuration

  3. use nanorc to run the sample system

Here are the steps that should be used when you first create your local software working area (i.e. <work_dir>):

  1. log into a system that has access to /cvmfs/dunedaq.opensciencegrid.org/

  2. source /cvmfs/dunedaq.opensciencegrid.org/setup_dunedaq.sh

  3. setup_dbt dunedaq-v2.6.0

  4. dbt-create.sh dunedaq-v2.6.0 <work_dir>

  5. cd <work_dir>

  6. dbt-workarea-env

  7. download a raw data file, either by running "curl -o frames.bin -O https://cernbox.cern.ch/index.php/s/VAqNtn7bwuQtff3/download" or clicking on the CERNBox link) and put it into <work_dir>

  8. python -m minidaqapp.nanorc.mdapp_multiru_gen -d ./frames.bin -o . -s 10 mdapp_fake

  9. nanorc mdapp_fake boot init conf start 101 wait 2 resume wait 60 pause wait 2 stop scrap terminate

  10. examine the contents of the HDf5 file with commands like the following:

    • h5dump-shared -H -A swtest_run000101_0000_*.hdf5
    • and
    • python3 $DFMODULES_FQ_DIR/dfmodules/bin/hdf5dump/hdf5_dump.py -p both -f swtest_run000101_0000_*.hdf5

When you return to this work area (for example, after logging out and back in), you can skip the 'setup' steps in the instructions above. For example:

  1. cd <work_dir>

  2. source /cvmfs/dunedaq.opensciencegrid.org/setup_dunedaq.sh

  3. setup_dbt dunedaq-v2.6.0

  4. dbt-workarea-env

  5. nanorc mdapp_fake boot init conf start 102 wait 2 resume wait 60 pause wait 2 stop scrap terminate

Last git commit to the markdown source of this page:

Author: jcfreeman2

Date: Thu Jun 3 13:45:10 2021 -0500

If you see a problem with the documentation on this page, please file an Issue at https://github.com/DUNE-DAQ/minidaqapp/issues