hveto.utils module

General utilities for hveto

hveto.utils.channel_groups(channellist, ngroups)

Separate a list of channels into a number of equally-sized groups

Parameters

channellistlist

large list to separate into chunks

ngroupsint

number of output groups

Returns

iteratoriterator list of list

a generator sequence yielding a sub-list on each iteration

hveto.utils.primary_vetoed(starttime=None, hveto_path=None, snr=6.0, significance=5.0)

Catalogue all vetoed primary triggers from a given analysis

This utility queries the output of an hveto analysis for the triggers vetoed from its primary channel over all rounds (up to thresholds on signal-to-noise ratio and round significance).

Parameters

starttimestr or float

start GPS time for this analysis

hveto_path‘str’

path of the hveto files directory, not required if starttime is given

snrfloat, optional

signal-to-noise ratio threshold on triggers, default: 6.0

significancefloat, optional

hveto significance threshold on auxiliary channels, default: 5.0

Returns

catalogueEventTable

a tabular catalogue of primary triggers vetoed in the hveto run

hveto.utils.write_lal_cache(target, paths)