David Adams
May 2022
Package to facilitate the running of DUNE lar jobs with dunesw (formerly dunetpc).
This package follows the dunerun build convention.
To install this package, first install dunerun specifying the dunesw release. Here we denote the base installation directory <install-dir> and assume package-specific installation. Then set up dunerun and the clone and install duneproc as follows:
cd <pkgdir> source <install-dir>/dunerun/setup.sh git clone https://github.com/dladams/duneproc.git dune-run -e dunebuild duneproc/build
Here <pkgdir> is a source installation dir which can be removed after installation and the set up defines the env needed for the build command.
To set up to use this package, set up dunerun and then use it to start a shell:
source <install-dir>/dunerun/setup.sh dune-run -e dunesw,duneproc shell duneproc>
If you want to stream hdf5 files (used for raw data starting in late 2021), then add the xrdhdf5 environment, i.e. replace the above dune-run command with
dune-run -e dunesw,xrdhdf5,duneproc shell
After set up, use the help command to check for success and see what commans are available:
duneproc> duneprocHelp Usage: /home/dladams/proc/install/v09_46_00_00/duneproc/bin/duneprocHelp OPT OPT = general for general commands OPT = pdsp for protoDUNE commands OPT = ib for Iceberg commands OPT = ibex fpr Iceberg examples OPT = ibex fpr Iceberg examples
The command duneproc runs a lar job with the first argument
specifying the fcl configuration and the second the data to be processed.
For detailed help, use duneproc -H. Example:
duneproc wfRaw/wfrran500/wftick4000/dpcr\_apa3u/event132560 5777evts132000-133000
This package provides many fcl configuration files including the top-level run_dataprep.fcl which runs the event and trigger filters and dataprep configured to read protoDUNE (I) data by APA. Alone, it does not run any tools but these may be added in the usual fashion, e.g. by adding
services.RawDigitPrepService.AdcChannelToolNames: @local::protodune_dataprep_tools_calib_noiserem
to local.fcl in the job submission directory.
This runs the standard processing up to the point where the ROIs and energy calibration
are dropped in preparation for wirecell processing.
A tutorial to get started is available doc/tutorial01.md and a tutorial on the duneproc command is at doc/tutorial02.md. The latter has some useful protoDUNE examples.
There is also a tutorial for Iceberg.