Project offline_filterscripts

Invoke with: import icecube.offline_filterscripts

Python I3Modules

CalculateGaps

CalculateGaps (Python I3Module)

Module to generate data gaps file for later use

Param EventHeaderName:

Default = 'I3EventHeader', Name of the Event Header

Param MinGapTime:

Default = 30, Minimum time (in seconds) between events to consider as a data gap

Param OutputFileName:

Default = '', Name of Output Gaps File

Positional

Positional (Python I3Module)

Check first hit position and time between first tWo HLC hits.

Param elowenbool:

Default = 'ELOWEN_Filter_positions', whether to keep or not

Param IcePickServiceKey:

Default = '', Key for an IcePick in the context that this module should check before processing physics frames.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

HoboTimeSplitter

HoboTimeSplitter (Python I3Module)

Split an event into halves on the charge-weighted mean time.

Param IcePickServiceKey:

Default = '', Key for an IcePick in the context that this module should check before processing physics frames.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

Param Output:

Default = '', Name of the mask in the output P frames

Param Pulses:

Default = '', Pulses to split

MarkQForHive

MarkQForHive (Python I3Module)

Mark q-frames to apply HiveSplitter.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

HivePframeCut

HivePframeCut (Python I3Module)

Check if IceHive produced more than 1 p-frame and check if this overlaps with the FPT trigger window.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

RemoveHiveP

RemoveHiveP (Python I3Module)

Remove IceHive p-frames that did not pass the filter.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

CheckForTrigger

CheckForTrigger (Python I3Module)

Check for the presence of a particular Trigger, according to its configID.

Param ConfigID:

Default = 30002, ConfigID to look for

Param IcePickServiceKey:

Default = '', Key for an IcePick in the context that this module should check before processing physics frames.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

Param InputTriggerHierarchy:

Default = 'DSTTriggers', Name of input trigger hierarchy

Param Output:

Default = 'IceAct_TriggerPresent_Bool', Name of filter decision bool

ReevaluateTriggerOnIceTopSplit

ReevaluateTriggerOnIceTopSplit (Python I3Module)

IceTop 2-station Trigger module.

Param IcePickServiceKey:

Default = '', Key for an IcePick in the context that this module should check before processing physics frames.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

Param Input:

Default = 'CleanedHLCTankPulses', Name of input pulse series

Param InputTriggerHierarchy:

Default = 'DSTTriggers', Name of input trigger hierarchy

Param Output:

Default = 'IceTop_TwoStationFilter_Bool', Name of filter decision bool

TimeWindowCollector

TimeWindowCollector (Python I3Module)

A module to collect time windows from frames and write them to an I3TimeWindowSeries in the frame.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

Param TimeWindowName:

Default = <Unprintable>, Name of the time windows to collect

Param TimeWindowSeriesName:

Default = <Unprintable>, Name of the timewindow series to write

I3ShadowFilter

I3ShadowFilter (Python I3Module)

Filter to select events coming from a direction close to Moon or Sun.

Param azimuth_range:

Default = [-1.5707963267948966, 1.5707963267948966], Azimuth range for the ‘shadow window’, specified by two doubles that specify the minimum and maximum azimuth difference w.r.t. the Moon/Sun coordinates.

Param filter_name:

Default = 'I3ShadowFilter_24', Name of the filter

Param IcePickServiceKey:

Default = '', Key for an IcePick in the context that this module should check before processing physics frames.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

Param mc_MJD_name:

Default = 'CorsikaMoon', If fake event times are generated for corsika events, then the MJD and angular coordinates are stored in the frame. If several Moon filters are defined (e.g. one for conventional data and one for extended DST), then subsequent filters can reuse the generated times and and angles (instead of generating different ones) if the same name is configured for this option.

Param mc_MJD_range:

Default = <Unprintable>, For testing with simulation: give the MJD range (e.g. 01 January 10:00 - 08 January 21:00 (2024): [60310.417,60317.875]instead of getting the event time from the event header, for each event a random time in the given MJD range will be generated. Default: empty range, i.e. assume experimental input data.

Param mc_random_service_name:

Default = <Unprintable>, Name of the random number generator service used to generate the event time in the year for simulated events.

Param paranoia:

Default = False, Parameter to set the amount of sanity checks(False for less checks, True for more).

Param reco_particle_key:

Default = <Unprintable>, Name of the reconstructed particle in the frame.

Param shadow_name:

Default = 'Moon', Shadow from which object (Moon or Sun)?

Param shadow_zenith_maximum:

Default = 1.5707963267948966, Maximum zenith for the Moon/Sun (default: horizon).

Param solid_angle_corrected:

Default = False, If set, then the behavior of AzimuthRange is slightly changed: the azimuth difference is multiplied with sin(zenith) (zenith of the reconstructed track).

Param zenith_range:

Default = [-0.2617993877991494, 0.2617993877991494], Zenith range for the angular window, specified by two doubles that specify the minimum and maximum zenith difference w.r.t. the Moon/Sun coordinates.

GapMin

GapMin (Python I3Module)

Gap min class.

Param IcePickServiceKey:

Default = '', Key for an IcePick in the context that this module should check before processing physics frames.

Param If:

Default = None, A python function… if this returns something that evaluates to True, Module runs, else it doesn’t

Param use_pulses:

Default = <Unprintable>, Use pulses or launches

I3Tray segments

MPE

MPE (I3Tray segment)

Define MPE segment.

Param Pulses:

Default = '',

Param Seed:

Default = '',

Param If:

Default = <function <lambda> at 0x122f5bec0>,

Param suffix:

Default = '',

Param MPEFit:

Default = 'MPEFit',

Param MPEFitCramerRao:

Default = 'MPEFitCramerRao',

SPE

SPE (I3Tray segment)

Define SPE segment.

Param Pulses:

Default = '',

Param If:

Default = <function <lambda> at 0x122f5bd80>,

Param suffix:

Default = '',

Param LineFit:

Default = 'LineFit',

Param SPEFitSingle:

Default = 'SPEFitSingle',

Param SPEFit:

Default = 'SPEFit2',

Param SPEFitCramerRao:

Default = 'SPEFit2CramerRao',

Param N_iter:

Default = 2,

OfflineFilterGapsWriter

OfflineFilterGapsWriter (I3Tray segment)

Tray segment to calculate the gaps and livetime of data files

Param Filename:

Default = None,

Param MinGapTime:

Default = 30,

generate_ref_file

generate_ref_file (I3Tray segment)

Generate information for a filter test reference file

elowenfilter

elowenfilter (I3Tray segment)

Run all the ELOWEN filtersteps.

RunCRWGFilters

RunCRWGFilters (I3Tray segment)

Run four CosmicRay filters.

CascadeOfflineFilter

CascadeOfflineFilter (I3Tray segment)

Offline Cascade Filter Segment.

CascadeLlhVertexFit

CascadeLlhVertexFit (I3Tray segment)

Run CscdLlhVertexFit, seeded with CLast.

Param Pulses:

Default = None,

Param If:

Default = <function <lambda> at 0x122f22b60>,

HighLevelFits

HighLevelFits (I3Tray segment)

SPE Reconstructions.

Param pulses:

Default = None,

Param InIceCscd:

Default = <function <lambda> at 0x122f23100>,

OfflineCascadeReco

OfflineCascadeReco (I3Tray segment)

Offline Basic Cascade Recos.

Param If:

Default = <function <lambda> at 0x122f225c0>, Python function or module for conditional execution of all fits

Param BadDOMListName:

Default = 'BadDomsList', Name of the Bad DOMs list to use in the FillRatio module Should be the list that matches the input pulses (HLC pulses with HLC bad dom list, etc.)

Offline_Monopod

Offline_Monopod (I3Tray segment)

Run Monopod Reconstruction on cleaned and masked pulses.

Param Pulses:

Default = 'OfflinePulses',

Param amplitude_table:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_single_spice_ftp-v1_flat_z20_a5.abs.fits',

Param effectivedistance_table:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_effectivedistance_spice_ftp-v1_z20.eff.fits',

Param effectivedistance_tableprob:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_effectivedistance_spice_ftp-v1_z20.prob.fits',

Param effectivedistance_tablemod:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_effectivedistance_spice_ftp-v1_z20.tmod.fits',

Param tilt_table_dir:

Default = '$I3_BUILD/ice-models/resources/models/ICEMODEL/spice_ftp-v1/',

Param timing_table:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_single_spice_ftp-v1_flat_z20_a5.prob.v2.fits',

Param minimizer:

Default = 'iMIGRAD',

Param If:

Default = <function <lambda> at 0x122f22f20>,

SPEFit

SPEFit (I3Tray segment)

Run SPE Fit.

Param Pulses:

Default = 'OfflinePulses',

Param Jitter:

Default = 15.0,

Param NoiseRate:

Default = 1e-08,

Param Iterations:

Default = 1,

Param If:

Default = <function <lambda> at 0x122f22de0>,

SplitFits

SplitFits (I3Tray segment)

Run SPEFit and CascadeLlh on split pulse series named {BasePulses}_0 and {BasePulses}_1.

Param BasePulses:

Default = None,

Param If:

Default = <function <lambda> at 0x10c75bf60>,

TimeSplitFits

TimeSplitFits (I3Tray segment)

Split the event in two time halves and run SPEFit+CscdLlh on each half separately.

Param Pulses:

Default = 'OfflinePulses',

Param If:

Default = <function <lambda> at 0x122f22ca0>,

TopoSplitFits_Doubles

TopoSplitFits_Doubles (I3Tray segment)

Toological Split Fit on Double events.

Param If:

Default = <function <lambda> at 0x122f22a20>,

TopoSplitFits_Singles

TopoSplitFits_Singles (I3Tray segment)

Topological Split Fit.

Param SRTPulses:

Default = 'SplitRTCleanedInIcePulses',

Param If:

Default = <function <lambda> at 0x122f228e0>,

CascadeHitCleaning

CascadeHitCleaning (I3Tray segment)

Cascade Pulse and Time Window Cleaning.

Param Pulses:

Default = 'SplitInIcePulses',

Param TWOfflinePulsesHLC:

Default = 'TWOfflinePulsesHLC',

Param If:

Default = <function <lambda> at 0x122f232e0>,

TopologicalCounter

TopologicalCounter (I3Tray segment)

Count the number of topological clusters in a given pulse series map, using only the first HLC pulse in each DOM.

Param pulses:

Default = 'OfflinePulsesHLC',

Param If:

Default = <function <lambda> at 0x122f23420>,

runVeto_Coinc

runVeto_Coinc (I3Tray segment)

Run the veto on coincident events.

Param pulses:

Default = None,

Param If:

Default = <function <lambda> at 0x122f236a0>,

runVeto_Singles

runVeto_Singles (I3Tray segment)

Run the veto on single events.

Param pulses:

Default = None,

Param If:

Default = <function <lambda> at 0x122f23560>,

deepcore_filter

deepcore_filter (I3Tray segment)

Apply the offline DeepCoreFilter cuts.

Param pulses:

Default = 'SplitInIcePulses',

Param If:

Default = <function <lambda> at 0x10c6cfe20>,

FaintParticleFilter

FaintParticleFilter (I3Tray segment)

Define the FaintParticleFilter segment.

Param If:

Default = <function <lambda> at 0x122f98400>,

FaintParticleFilter_hive

FaintParticleFilter_hive (I3Tray segment)

Define the FaintParticleFilter hive segment.

Param pulses:

Default = None,

Param If:

Default = <function <lambda> at 0x122f98900>,

IceHiveFPF

IceHiveFPF (I3Tray segment)

Configure and run IceHive.

Param input_pulses:

Default = None,

Param SplitName:

Default = None,

Param output_pulses:

Default = None,

highq_filter

highq_filter (I3Tray segment)

Run hqtot, place the result in the P frame, and set a flag based on it.

Param filter_name:

Default = 'HighQFilter',

run_hqtot

run_hqtot (I3Tray segment)

Run HomogenizedQTot segment from VHESelfVeto module.

Param output_key_name:

Default = 'Homogenized_QTot',

IceTopTwoStationFilter

IceTopTwoStationFilter (I3Tray segment)

Make the frame I3Bool, and then run I3FilterModule on it. UNUSED for now, since we’re just doing I3Bools.

Param If:

Default = <function <lambda> at 0x122f99440>,

IceTopFilterNTank

IceTopFilterNTank (I3Tray segment)

Define the IceTopNTankX_22 filters.

IceTopFilterSelectedStations

IceTopFilterSelectedStations (I3Tray segment)

Define the IceTopSelectedStations_22 filters.

MeseFilter

MeseFilter (I3Tray segment)

Define the first version of the 2024 mese filter segment.

DoubleSplit

DoubleSplit (I3Tray segment)

Calculate reconstruction in two time windows.

Param InputPulseMap:

Default = None,

Param splitname1:

Default = None,

Param splitname2:

Default = None,

Param If:

Default = <function <lambda> at 0x122f99da0>,

MonopoleFilter

MonopoleFilter (I3Tray segment)

Define the MonopoleFilter segment.

Param If:

Default = <function <lambda> at 0x122f9a340>,

monopoleCV

monopoleCV (I3Tray segment)

Calculate Common Variables.

Param RecoPulses:

Default = None,

Param ParticleName:

Default = None,

Param remove:

Default = None,

Param If:

Default = <function <lambda> at 0x122f99c60>,

CalculateCutValues

CalculateCutValues (I3Tray segment)

Run CommonVariables values to use in the offline muon filter cuts

Param If:

Default = <function <lambda> at 0x122f59d00>,

CharacterizeHits

CharacterizeHits (I3Tray segment)

Write out various hit on the non-DeepCore pulses

Param If:

Default = <function <lambda> at 0x122f5a3e0>,

MuonOfflineFilter

MuonOfflineFilter (I3Tray segment)

Run the OfflineMuonFilter.

OfflineMuonReconstructions

OfflineMuonReconstructions (I3Tray segment)

Run the reconstructions for the offline muon filter.

CalculateShieldVars

CalculateShieldVars (I3Tray segment)

Calculate shield variables to look for hits in IceTop.

DoBayesianFit

DoBayesianFit (I3Tray segment)

Perform a Bayesian fit using the given parameters.

Param Pulses:

Default = '',

Param Seed:

Default = '',

Param If:

Default = <function <lambda> at 0x122f5afc0>,

DoReconstructions

DoReconstructions (I3Tray segment)

Perform various reconstructions on the input data.

Param photonicsdir:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/SPICEMie/',

Param photonicsdriverdir:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/SPICEMie/driverfiles/',

Param photonicsdriverfile:

Default = 'mu_photorec.list',

Param infmuonampsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/InfBareMu_mie_abs_z20a10_V2.fits',

Param infmuonprobsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/InfBareMu_mie_prob_z20a10_V2.fits',

Param cascadeampsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_single_spice_ftp-v1_flat_z20_a5.abs.fits',

Param cascadeprobsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_single_spice_ftp-v1_flat_z20_a5.prob.v2.fits',

Param cascadeeffdsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_effectivedistance_spice_ftp-v1_z20.eff.fits',

Param cascadeeffdprobsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_effectivedistance_spice_ftp-v1_z20.prob.fits',

Param cascadeeffdtmodsplinepath:

Default = '/cvmfs/icecube.opensciencegrid.org/data/photon-tables/splines/cascade_effectivedistance_spice_ftp-v1_z20.tmod.fits',

Param tiltdir:

Default = '$I3_BUILD/ice-models/resources/models/ICEMODEL/spice_ftp-v1/',

Param If:

Default = <function <lambda> at 0x122f5b4c0>,

DoSplineReco

DoSplineReco (I3Tray segment)

Perform spline reconstruction for muon tracks.

Param spline:

Default = '',

Param If:

Default = <function <lambda> at 0x122f5b380>,

DoSplitFits

DoSplitFits (I3Tray segment)

Perform split fits on the input pulses.

Param Pulses:

Default = '',

Param If:

Default = <function <lambda> at 0x122f5b240>,

Paraboloid

Paraboloid (I3Tray segment)

Perform paraboloid reconstruction on muon events.

Param If:

Default = <function <lambda> at 0x122f5a840>,

SplitRecos

SplitRecos (I3Tray segment)

Perform split reconstruction on the given tray.

Param Pulses:

Default = '',

Param Suffix:

Default = '',

Param If:

Default = <function <lambda> at 0x122f5b100>,

SplitAndRecoIceHive

SplitAndRecoIceHive (I3Tray segment)

Use IceHive to split the frame, then apply reconstructions.

Param If:

Default = <function <lambda> at 0x103081940>,

moon_and_sun_filters

moon_and_sun_filters (I3Tray segment)

Create two I3ShadowFilters (one for Moon, one for Sun).

SLOPFilter

SLOPFilter (I3Tray segment)

Define the SLOPFilter segment.

Param use_pulses:

Default = None,

Param If:

Default = <function <lambda> at 0x122fb65c0>,

audit

audit (I3Tray segment)

GCD audit tray segment.

Param run_id:

Default = None,

generate

generate (I3Tray segment)

Run main tray segment for generating GCDs.

Param run_id:

Default = None,

Legacy_CosmicRayFilter

Legacy_CosmicRayFilter (I3Tray segment)

Add a frame object containing tags for IceTop’s “legacy filters”.

Param Pulses:

Default = 'CleanedHLCTankPulses',

Param If:

Default = <function <lambda> at 0x122fb68e0>,

make_offline_filter_mask

make_offline_filter_mask (I3Tray segment)

Create an offline filter mask.

Param decision_name:

Default = 'PassedAnyOfflineFilter',

offline_filters

offline_filters (I3Tray segment)

Run offline filters.

offline_process

offline_process (I3Tray segment)

Run the offline processing.

Param gcdfile:

Default = None,

Param infiles:

Default = None,

read_superdst_files

read_superdst_files (I3Tray segment)

Resplit compressed DST file (from Pole) and prepare for higher level processing.

ref_offline_filter_mask

ref_offline_filter_mask (I3Tray segment)

Create reference objects and optionally compress P frames to Q frames.