Other analysis/nuwabasics

Table Of Contents

Previous topic

Daya Bay Data Files

Next topic

NuWa Recipes

This Page

Daya Bay Links

Content Skeleton

NuWa Basics

If you wish to do more analysis than histogramming data from files, you must use NuWa. NuWa is the name given to the analysis software written for the Daya Day experiment. It is installed and available on the computer clusters. To load the software on one of the clusters, see Sec. Loading the NuWa software. To install NuWa on another computer, see Sec. Installing the NuWa software.

NuWa analysis allows you to:

  • Access all event data
  • Relate data at different paths (ie. /Event/Rec to /Event/Readout)
  • Access non-event data (ie. PMT positions, cable mapping, etc)
  • Do more complex calculations
  • Write NuWa data files

This section provides a short description of the nuwa.py program, Job Modules, and analysis algorithms. This is followed by a series of recipes for common analysis tasks.

The nuwa.py Command

The nuwa.py command is the main command to use the Daya Bay analysis software. A command has a structure similar to,

shell> nuwa.py -n <numberOfEntries> -m"<Module>" <inputFile>

A complete list of options is given in Sec sec:nuwaoptions. An example is,

shell> nuwa.py -n 100 -m"Quickstart.PrintRawData" daq.NoTag.0005773.Physics.SAB-AD2.SFO-1._0001.root

In this simple example, the first 100 triggered readouts are read from the input file, and their data is printed to the screen. The -n option specifies the number of entries to process. The -n -1 option will process all events in the input file(s). The -m option specifies how the job should be configured. Sec. NuWa Job Modules discusses job configuration using Job Modules.

An arbitrary number of input files can be given, and will be processed in sequence.

shell> nuwa.py -n <numberOfEntries> -m"<Module>" <inputFile1> <inputFile2>

The -o option can be used to write the event data to a NuWa output file,

shell> nuwa.py -n <numberOfEntries> -m"<Module>" -o <outputFile> <inputFile>

Some other useful options are,

  • --no-history: Do not print out job configuration information to the screen
  • -l n: Set the minimum level of logging output printed to the screen (1: VERBOSE, 2: DEBUG, 3: INFO, 4: WARNING, 5: ERROR)
  • -A n*s: Keep events for the past n seconds available for correlation studies with the current event.
  • --help: Print nuwa.py usage, including descriptions of all options.

NuWa Job Modules

Job modules are used to configure simulation and analysis tasks. Specifically, Job modules are scripts which do the following:

  • Add analysis Algorithms and Tools to the job
  • Configure Algorithms, Tools, and Services used by the job

Job Modules are used with the nuwa.py command as follows,

shell> nuwa.py -n 100 -m"<Module1>" -m"<Module2>" <inputFile>

You can put as many modules as you like on the command line. Some modules can take arguments; these should be placed inside the quotes immediately after the module name,

shell> nuwa.py -n 100 -m"<Module1> -a argA -b argB" <inputFile>