NuRadioReco.utilities.diodeSimulator module

class NuRadioReco.utilities.diodeSimulator.diodeSimulator(output_passband=(None, None))

Bases: object

Calculate a signal as processed by the tunnel diode. The given signal is convolved with the tunnel diodde response as in AraSim.

Parameters:

output_passband: (float, float) tuple

Frequencies for a 6th-order Butterworth filter to be applied after the diode filtering. If a lowpass filter is needed, please pass a (None, float) tuple as parameter.

Methods

calculate_noise_parameters([sampling_rate, ...])	Calculates the mean and the standard deviation for the diode-filtered noise.
tunnel_diode(channel)	Calculate a signal as processed by the tunnel diode.

end

tunnel_diode(channel)

Calculate a signal as processed by the tunnel diode. The given signal is convolved with the tunnel diode response as in AraSim.

The diode model used in this module returns a dimensionless power trace, where the antenna resistance is only a normalisation for the final voltage. That’s why the antenna resistance has been fixed to a value of 8.5 ohms.

Parameters:

channel: Channel

Signal to be processed by the tunnel diode.

Returns:

trace_after_tunnel_diode: array

Signal output of the tunnel diode for the input channel. Careful! This trace is dimensionless and comes from a convolution of the power with the diode response.

calculate_noise_parameters(sampling_rate=1.0, min_freq=0.05, max_freq=1.0, amplitude=9.999999999999999e-06, type='rayleigh', n_tries=10000, n_samples=10000)

Calculates the mean and the standard deviation for the diode-filtered noise.

Parameters:

sampling_rate: float

Sampling rate

min_freq: float

Minimum frequency of the bandwidth

max_freq: float

Maximum frequency of the bandwidth

amplitude: float

Voltage amplitude (RMS) for the noise

type: string

Noise type

n_tries: int

Number of times the calculation is carried out, to get proper averages for the mean and the standard deviation.

n_samples: int

Number of samples for each individual noise trace

Returns:

power_mean: float

Mean of the diode-filtered noise

power_std: float

Standard deviation of the diode-filtered noise

end()

NuRadioReco.utilities.diodeSimulator.get_window_around_maximum(station, diode=None, triggered_channels=None, ratio=0.01, edge=20)

This function filters the signal using a diode model and calculates the times around the filtered maximum where the signal is the ratio parameter times the maximum. Then, it creates a time window by substracting and adding the edge parameter to these times. This function is useful for reducing the probability of noise-triggered events while using the envelope phased array, although it can also be applied to the standard phased array.

Parameters:

station: NuRadioReco station

Station containing the information on the detector

diode: diodeSimulator or None

Diode model to be applied. If None, a diode with an output 200 MHz low-pass filter is chosen

triggered_channels: array of integers

Channels used for the trigger, and also for creating the window

ratio: float

Cut parameter

edge: float

Times to be sustracted from the points defined by the ratio cut to create the window

Returns:

(left_time, right_time): (float, float) tuple

Tuple containing the edges of the time window