JAPAN Doc Portal

Documentation for new Prex/Crex analysis is curated here

Important Resources

• Analyzer Meeting list
• Contributing on Github

Resources

• Source code: JAPAN Github
• Guide to using Github

Using JAPAN on adaq cluster

In the apar account, execute "gojapan" to setup the environment variables and change to the "official" copy of JAPAN (~apar/PREX/japan).

Some typical calls to the analyzer:

• ./build/qwparity --config prexCH.conf --detectors prexCH_detectors_no_hel.map -r 1107
  This does the analysis for parity_CH mode data files (run 1107 in this particular case), where the helicity patterns are treated as always being quartets with polarities "+ - - +".
• ./build/qwparity --config prex.conf -r 1036
  This analyzes the parity_ALL mode data files, using the injector helicity data to build quartets. The current default analysis mode is in quartets, if the DAQ is changed to octets or other patterns, we will need to update the injector helicity configuration used by the analyzer.
• ./build/qwparity --config prexinj.conf -r ####
  This analyzes the parity_INJ mode data files. The current default analysis mode is in quartets, if the DAQ is changed to octets or other patterns, we will need to update the injector helicity configuration used by the analyzer.

Using Japan on ifarm to analyze TEDf test stand data

To analyze any CODA DAQ .dat file with JAPAN, do the followin

source /site/12gev_phys/softenv.csh 2.3
cd /directory/to/store/japan/
git clone https://github.com/JeffersonLab/japan
cd japan
git checkout tedf-test-stand
source setup_japan.tcsh
mkdir build; cd build; cmake ..; make; cd ..
./build/qwparity --config tedf_testing.conf -r [number]

• • The config file (contained within the Parity/prminput folder) should contain all of the necessary information for JAPAN to decode the data
  • Care must be taken to ensure that the maps correspond to what configuration the DAQ channels were in during the data collection for that run
  • Run numbers can be used automatically to do this, but the user must define the map files appropriately so it works
  • It is important to turn off the beam current normalization for channel readouts
• The ROOT output should go into your (setup_japan.tcsh initialized environment variable location) ${QW_ROOTFILES}, for analysis done on the corresponding .dat file in ${QW_DATA}
• After analyzing your run, be sure to look at the JAPAN outputs and read the Error Summary list
  • Any number above 0 indicates that an event has failed some check and the data was not saved to the ROOTfile (or it was, but has an error code assigned to it)

Compilation

The code as is compiles fine on ifarm machines (1401 or 1402). For local installation you need to have:

• mysql++
• root with minuit2 library
• boost libraries

Verified compilation with:

-- The C compiler identification is GNU 4.8.5
-- The CXX compiler identification is GNU 4.8.5
-- Check for working C compiler: /bin/cc
-- Check for working C compiler: /bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /bin/c++
-- Check for working CXX compiler: /bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- System name Linux
-- Found ROOT 6.12/04 in /home/ciprian/root/root6/root/build
-- Boost version: 1.53.0
-- Found the following Boost libraries:
--   program_options
--   filesystem
--   system
--   regex
No QwAnalysis dictionaries needed for ROOT 6.12/04.
-- Configuring done
-- Generating done
-- Build files have been written to: /home/ciprian/prex/japan/build