Skip to content

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 (setup the environment, generate the sample system configuration, and use nanorc to run the sample system), and they draw on more detailed instructions from other repositories, for example, daq-buildtools and nanorc.

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.8.0

  4. dbt-create.sh dunedaq-v2.8.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/7qNnuxD8igDOVJT/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.8.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

More detailed explanations on how to create different configurations can be found in Instructions for different configurations for first-time users

If and when you are ready to start looking at existing code and possibly modifying it, you can use steps like the following:

  1. cd <work_dir>

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

  3. setup_dbt dunedaq-v2.8.0

  4. dbt-workarea-env

  5. cd sourcecode

  6. git clone https://github.com/DUNE-DAQ/<package_name>.git -b develop

    • e.g. git clone https://github.com/DUNE-DAQ/dfmodules.git -b develop
    • the full list of available repository is here

  7. cd ..

  8. dbt-build.sh

  9. dbt-workarea-env --refresh

  10. continue as described above...

Last git commit to the markdown source of this page:

Author: bieryAtFnal

Date: Fri Aug 27 10:13:53 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

Back to top