IC86_2014

Documentation and examples for running L1 and L2 filtering on IC86_2014 data and simulation.

Environment Setup

First obtain a copy of the IceRec meta-project:

$ svn co http://code.icecube.wisc.edu/svn/meta-projects/icerec/releases/IC2014-L2_V14-02-00 src
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release -DUSE_CINT=True ../src
$ make

Note

The IceRec version listed here is the special L2 variant for 2014.

Caution

The -DUSE_CINT=True is important to make sure dst-extractor is built, which L2 filtering requires to load properly.

Hint

make -j12 on servers will run 12 threads of compiling in parallel, building your meta-project faster.

Possible Errors

  • glshovel

    A glshovel cmake error like this:

    CMake Error: The following variables are used in this project, but they are set to NOTFOUND.
    Please set them or make sure they are set and tested correctly in the CMake files:
    GLUT_Xmu_LIBRARY (ADVANCED)
        linked by target "glshovel" in directory /scratch/dschultz/IC86_2014/src/glshovel
    
    -- Configuring incomplete, errors occurred!
    

    The solution is to delete the glshovel project, since it is old and unsupported.

    $ rm -rf ../src/glshovel
    

Experimental Data

An example of how to run L2 on a PFFilt file (not that you should ever do this yourself, as production has already done it.)

I am assuming you have a GCD and i3 file:

$ cp /data/exp/IceCube/2014/filtered/PFFilt/0609/PFFilt_PhysicsFiltering_Run00124852_Subrun00000000_00000000.tar.bz2 .
$ cp /data/exp/IceCube/2014/filtered/level2/0609/Run00124852/Level2_IC86.2014_data_Run00124852_0609_0_94_GCD.i3.gz .

Next, load the environment:

$ ./env-shell.sh
************************************************************************
*                                                                      *
*                   W E L C O M E  to  I C E T R A Y                   *
*                                                                      *
*       Version icerec.releases.IC2014-L2_V14-02-00     r141213        *
*                                                                      *
*                You are welcome to visit our Web site                 *
*                        http://icecube.umd.edu                        *
*                                                                      *
************************************************************************

Icetray environment has:
   I3_SRC       = /scratch/dschultz/IC86_2014/src
   I3_BUILD     = /scratch/dschultz/IC86_2014/build
   I3_PORTS     = /cvmfs/icecube.wisc.edu/py2-v1/RHEL_6_x86_64/i3ports
   Python       = Python 2.7.3

The process.py script has various options:

$ filterscripts/resources/scripts/offlineL2/process.py -h
Module iceprod.modules not found. Will not define IceProd Class
Usage: process.py [options]

Options:
  -h, --help            show this help message and exit
  -s, --simulation      Mark as simulation (MC)
  -i INFILE, --input=INFILE
                        Input i3 file(s)  (use comma separated list for
                        multiple files)
  -g GCDFILE, --gcd=GCDFILE
                        GCD file for input i3 file
  -o OUTFILE, --output=OUTFILE
                        Output i3 file
  -n NUM, --num=NUM     Number of frames to process
  --dstfile=DSTFILE     DST root file (should be .root)
  --gapsfile=GAPSFILE   gaps text file (should be .txt)
  --icetopoutput=ICETOPOUTPUT
                        Output IceTop file
  --eheoutput=EHEOUTPUT
                        Output EHE i3 file
  --slopoutput=SLOPOUTPUT
                        Output SLOP file
  --rootoutput=ROOTOUTPUT
                        Output root file
  --photonicsdir=PHOTONICSDIR
                        Directory with photonics tables

For experimental data, most of the default configuration is fine. Use as such:

$ filterscripts/resources/scripts/offlineL2/process.py -i PFFilt_PhysicsFiltering_Run00124852_Subrun00000000_00000000.tar.bz2 -g Level2_IC86.2014_data_Run00124852_0609_0_94_GCD.i3.gz -o Level2_IC86.2014_data_Run00124852_Part00000000.i3.bz2
Warning in <TUnixSystem::SetDisplay>: DISPLAY not set, setting it to
Module iceprod.modules not found. Will not define IceProd Class
infiles:  ['Level2_IC86.2014_data_Run00124852_0609_0_94_GCD.i3.gz', 'PFFilt_PhysicsFiltering_Run00124852_Subrun00000000_00000000.tar.bz2']
... (many lines of output) ...

This may take a while for a full PFFilt file (2-3 hours is normal).

At the end, you should get a file named:

Level2_IC86.2014_data_Run00124852_Part00000000.i3.bz2

If you want the other files, specify filenames for those options.