MiniCLEAN

The instructions on this page assume that you already have a local computing account; if not, see First Steps for New Users.

How to get started with MiniCLEAN

Papers and other Documents to get started with MiniCLEAN

• A very nice summary of the status of the detector and upcoming commissioning at SNOLAB in Sudbury, Canada:

 https://absuploads.aps.org/presentation.cfm?pid=12471

• The rat-pac tutorial (this is the SNO+ version). Take a look at the available RAT version on github and more info
  • https://github.com/rat-pac/rat-pac/blob/master/doc/Tutorial001.pdf

Some detailed links

• a nice article on recently developed analysis techniques

 Update on the MiniCLEAN Dark Matter Experiment.
 MINICLEAN Collaboration (K. Rielage (Los Alamos) et al.).  Mar 19, 2014.  9 pp. 
 Published in Phys.Procedia 61 (2015) 144-152.
 e-Print: arXiv:1403.4842 [physics.ins-det]  https://arxiv.org/pdf/1403.4842.pdf
 

• a Bayesian technique applied to the general problem of particle identification in single-phase liquid argon dark matter detectors here is a very nice article

  Improving Photoelectron Counting and Particle Identification in Scintillation Detectors with Bayesian Techniques.
  M. Akashi-Ronquest (Los Alamos) et al..  Aug 8, 2014.  15 pp.
  Published in Astropart.Phys. 65 (2015) 40-54.
  e-Print: arXiv:1408.1914 [physics.ins-det] https://arxiv.org/pdf/1408.1914.pdf

Getting a Vault Account

You must get a miniclean vault account, this can be obtained by emailing Kim Palladino. She will create the account and then send, to your email, the login information. You can check and must manage your account via https://deapclean.org/vault/profile/. When you update it, another account is created for you to access the RAT svn and documentation. The vault is the MiniCLEAN document/online database source. It is located here.

Set up RAT account

You will need a RAT account, this can only be obtained once you have a miniclean vault account. The RAT User Guide is here.

How to run MiniCLEAN RAT jobs with HTCondor

In order to use the computing resources at Wisconsin, one can submit HTCondor jobs to run simulation

ssh <username>@login02.hep.wisc.edu

# Make a valid voms-proxy
voms-proxy-init -valid 142:00

# Run runWiscJobs script to submit jobs
# To get help about options
# python  /cvmfs/lz.opensciencegrid.org/sw/bin/runWiscJobs.py -h

python /cvmfs/lz.opensciencegrid.org/sw/bin/runWiscJobs.py \
       --WorkFlow="ar39.mac_test1" \
       --Executable="farmoutRAT.sh" \
       --Experiment=miniclean \
       --nJobs=1 \
       --TransferInputFile="ar39.mac" \
       --HDFSProdDir=outputfile \
       --UserEnv="UserName=`whoami` " \
       --OutputDir="ar39.mac" \
       --Arguments="ar39.mac"

# If you want your output copied to HDFS, have your executable copy the output
# files to the directory you specify with --HDFSProdDir.

Executable example: FarmountRAT.sh

#!/bin/bash

wdir=$(pwd)

# Source the environment needed to run RAT
source /afs/hep.wisc.edu/ddm/ratcage/local/bin/geant4.sh
source /afs/hep.wisc.edu/ddm/ratcage/root-5.34.12/bin/thisroot.sh
source /afs/hep.wisc.edu/ddm/ratcage/env.sh

# Temporary directory that gets created on the execute node
tmpDir=$(mktemp -d --tmpdir="./")
cd $tmpDir

cp ../*.mac .
pwd

# Run the RAT
rat -o ar39_test1.root ar39.mac

mkdir -p ../outputfile

cd ../outputfile
ln -s ../$tmpDir/*.root .

Example ar39.mac

/glg4debug/glg4param omit_muon_processes 1.0
/glg4debug/glg4param omit_hadronic_processes 1.0

/rat/db/set DETECTOR experiment "MiniCLEAN"
/rat/db/set DETECTOR geo_file "MiniCLEAN/MiniCLEAN.geo"

/rat/db/set SHELLFIT position_only 1
/rat/db/set SHELLFIT single_pe 1

/rat/db/set DAQ st_prune 0

/run/initialize

/rat/proc daq
/rat/proc calibrate
/rat/proc pulseIntWindow
/rat/proc singlepe

/rat/proc mcfprompt
/rat/proc fprompt
/rat/proc shellfit
/rat/proc fitcentroid
/rat/proc lrecoil

/tracking/setMaxGlobalTime 1.e9

/rat/proc count
/rat/procset update 10

# Use IO.default_output_filename
/rat/proclast outroot

# Uses a beta decay spectrum which includes corrections from nuclear physics.
/generator/add combo spectrum:fillshell
/generator/vtx/set e- Ar39_beta

# Uses beta decay generator, but does not include corrections.
#/generator/add decaychain 39Ar:fill

# /tracking/storeTrajectory 1
# /tracking/discardParticleTrajectory opticalphoton
# Use fill shell method, /generator/pos/set X Y Z Ri Ro volname

/generator/pos/set 0 0 0 0 1016 cryoliquid
/generator/rate/set 1.0
/run/beamOn 10000

Example Miniclean analysis code

Location of the example annotated analysis script:

 /afs/hep.wisc.edu/ddm/MiniCLEAN/annotated_analysis_script.C

This analysis code needs to be compiled before you can run it. To compile the analysis code, make a copy in the direction that you want to work in, source RAT by running

 source /afs/hep.wisc.edu/ddm/ratcage/env.sh

Open ROOT, then run in ROOT

 .L annotated_analysis_script.C+

This loads the C script into ROOT and then compiles it, be sure to append the '+' after the C to compile. To run it, call the function defined in the script. In this case, you should run

 makehistogram("PATH_TO_YOUR_ROOT_FILE")

A copy of the analysis code is here Miniclean annotated analysis script