NuRadioReco.modules.RNO_G.dataProviderRNOG module

class NuRadioReco.modules.RNO_G.dataProviderRNOG.dataProviderRNOG

Bases: object

This module provides an easy access to “processed” RNO-G data.

It does so by running a set of “processing” modules on the data. This module is a wrapper around the following modules (in this order):

1. NuRadioReco.modules.io.RNO_G.readRNOGDataMattak

2. NuRadioReco.modules.RNO_G.channelGlitchDetector

3. NuRadioReco.modules.RNO_G.channelBlockOffsetFitter

4. NuRadioReco.modules.channelAddCableDelay

The module reads RNO-G data, applies a glitch detection algorithm (does not remove/fix them!), fits block offsets (and removes them!) and subtracts cable delays. The voltage calibration is applied in the readRNOGDataMattak module. The module also updates the detector object with the station time.

The readRNOGDataMattak module has two different modes to apply the voltage calibration:

• If read_calibrated_data==True (default: False), the “bias scan-based” voltage calibration is applied by mattak.

• If convert_to_voltage==True (default: True), a “pseudo” fully-linear voltage calibration is applied.

Hence, by default only the “pseudo” fully-linear voltage calibration is applied. If you want to apply the “bias scan-based” voltage calibration, set read_calibrated_data=True in the begin function. You have to make sure that mattak finds the necessary calibration files. If you want to retrieve the raw data, set both to False.

Please refer to he documentation of the individual modules for more information. In particular the readRNOGDataMattak which performs the actual reading of the data and applies the voltage calibration. The reader module is based on the mattak package (https://github.com/RNO-G/mattak).

Methods

begin(files, det[, reader_kwargs])	Call the begin method of the modules.
end()	Call the end method of the modules
run()	Run the modules

See also

NuRadioReco.modules.io.RNO_G.readRNOGDataMattak

NuRadioReco.modules.RNO_G.channelGlitchDetector

NuRadioReco.modules.RNO_G.channelBlockOffsetFitter

NuRadioReco.modules.channelAddCableDelay

begin(files, det, reader_kwargs={})

Call the begin method of the modules.

Parameters:

files: list of str

List of files to read (are passed to the readRNOGDataMattak module).

det: Detector

Detector object.

reader_kwargs: dict (default: {})

Keyword arguments passed to the reader module readRNOGDataMattak.

end()

Call the end method of the modules

run()

Run the modules

Yields:

event: Event

The processed event