NuRadioReco.framework.parameters module

Provides an interface to store simulated and reconstructed quantities

The parameters module provides access to store and read simulated or reconstructed quantities in the different custom classes used in NuRadioMC.

class NuRadioReco.framework.parameters.stationParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

nu_zenith = 1

the zenith angle of the incoming neutrino direction

nu_azimuth = 2

the azimuth angle of the incoming neutrino direction

nu_energy = 3

the energy of the neutrino

nu_flavor = 4

the flavor of the neutrino

ccnc = 5

neutral current of charged current interaction

nu_vertex = 6

the neutrino vertex position

inelasticity = 7

inelasticity ot neutrino interaction

triggered = 8

flag if station was triggered or not

cr_energy = 9

the cosmic-ray energy

cr_zenith = 10

zenith angle of the cosmic-ray incoming direction

cr_azimuth = 11

azimuth angle of the cosmic-ray incoming direction

channels_max_amplitude = 12

the maximum amplitude of all channels (considered in the trigger module)

zenith = 13

the zenith angle of the incoming signal direction (WARNING: this parameter is not well defined as the incoming signal direction might be different for different channels)

azimuth = 14

the azimuth angle of the incoming signal direction (WARNING: this parameter is not well defined as the incoming signal direction might be different for different channels)

zenith_cr_templatefit = 15
zenith_nu_templatefit = 16
cr_xcorrelations = 19

dict of result of crosscorrelations with cr templates

nu_xcorrelations = 20

dict of result of crosscorrelations with nu templates

station_time = 21
cr_energy_em = 24

the electromagnetic shower energy (the cosmic ray energy that ends up in electrons, positrons and gammas)

nu_inttype = 25

interaction type, e.g., cc, nc, tau_em, tau_had

chi2_efield_time_direction_fit = 26

the chi2 of the direction fitter that used the maximum pulse times of the efields

ndf_efield_time_direction_fit = 27

the number of degrees of freedom of the direction fitter that used the maximum pulse times of the efields

cr_xmax = 28

Depth of shower maximum of the air shower

vertex_2D_fit = 29

horizontal distance and z coordinate of the reconstructed vertex of the neutrino

distance_correlations = 30
shower_energy = 31

the energy of the shower

viewing_angles = 32

reconstructed viewing angles. A nested map structure. First key is channel id, second key is ray tracing solution id. Value is a float

flagged_channels = 60

a defaultdict of flagged NRR channel ids with as value a list of the reason(s) for flagging (used in readLOFARData, stationRFIFilter)

cr_dominant_polarisation = 61

the channel orientation containing the dominant cosmic ray signal (calculated by stationPulseFinder)

dirty_fft_channels = 62

a list of FFT channels flagged as RFI (calculated by stationRFIFilter)

class NuRadioReco.framework.parameters.channelParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

zenith = 1

zenith angle of the incoming signal direction

azimuth = 2

azimuth angle of the incoming signal direction

maximum_amplitude = 4

the maximum ampliude of the magnitude of the trace

SNR = 5

an dictionary of various signal-to-noise ratio definitions

maximum_amplitude_envelope = 6

the maximum ampliude of the hilbert envelope of the trace

P2P_amplitude = 7

the peak to peak amplitude

cr_xcorrelations = 8

dict of result of crosscorrelations with cr templates

nu_xcorrelations = 9

dict of result of crosscorrelations with nu templates

signal_time = 10

the time of the maximum amplitude of the envelope

noise_rms = 11

the root mean square of the noise

signal_regions = 12

list of start and end times of regions that likely contain a signal

noise_regions = 13

list of start and end times of regions that likel do not contain any signals

signal_time_offset = 14

the relative timing differences of the signal arrival times between channels

signal_receiving_zenith = 15

the zenith angle of direction at which the radio signal arrived at the antenna

signal_ray_type = 16

type of the ray propagation path of the signal received by this channel. Options are direct, reflected and refracted

signal_receiving_azimuth = 17

the azimuth angle of direction at which the radio signal arrived at the antenna

block_offsets = 18

‘block’ or pedestal offsets. See NuRadioReco.modules.RNO_G.channelBlockOffsetFitter

Vrms_NuRadioMC_simulation = 19

the noise rms used in the MC simulation

bandwidth_NuRadioMC_simulation = 20

the integrated channel response (=bandwidth for signal chains without amplification) used in the MC simulation

class NuRadioReco.framework.parameters.electricFieldParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

ray_path_type = 1

the type of the ray tracing solution (‘direct’, ‘refracted’ or ‘reflected’)

polarization_angle = 2

electric field polarization in onsky-coordinates. 0 corresponds to polarization in e_theta, 90deg is polarization in e_phi

polarization_angle_expectation = 3

expected polarization based on shower geometry. Defined analogous to polarization_angle

signal_energy_fluence = 4

Energy/area in the radio signal

cr_spectrum_slope = 5

Slope of the radio signal’s spectrum as reconstructed by the voltageToAnalyticEfieldConverter

zenith = 7

zenith angle of the signal. Note that refraction at the air/ice boundary is not taken into account

azimuth = 8

azimuth angle of the signal. Note that refraction at the air/ice boundary is not taken into account

signal_time = 9
nu_vertex_distance = 10

the distance along the ray path from the vertex to the channel

nu_viewing_angle = 11

the angle between shower axis and launch vector

max_amp_antenna = 12

the maximum amplitude of the signal after convolution with the antenna response pattern, dict with channelid as key

max_amp_antenna_envelope = 13

the maximum amplitude of the signal envelope after convolution with the antenna response pattern, dict with channelid as key

reflection_coefficient_theta = 14

for reflected rays: the complex Fresnel reflection coefficient of the eTheta component

reflection_coefficient_phi = 15

for reflected rays: the complex Fresnel reflection coefficient of the ePhi component

cr_spectrum_quadratic_term = 16

result of the second order correction to the spectrum fitted by the voltageToAnalyticEfieldConverter

energy_fluence_ratios = 17

Ratios of the energy fluences in different passbands

nu_vertex_propagation_time = 18

the time it takes for the signal to propagate from the vertex to the channel

raytracing_solution = 19

the ray tracing solution (the dictionary returned by get_raytracing_output(i_solution))

launch_vector = 20

the launch vector of the ray from which this efield originates (only available for in-ice simulations)

class NuRadioReco.framework.parameters.ARIANNAParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

seq_start_time = 1

the start time of a sequence

seq_stop_time = 2

the stop time of a sequence

seq_num = 3

the sequence number of the current event

comm_period = 4

length of data taking window

comm_duration = 5

maximum diration of communication window

trigger_thresholds = 6

trigger thresholds converted to voltage

l1_supression_value = 7

This provieds the L1 supression value for given event

internal_clock_time = 8

time since last trigger with ms precision

class NuRadioReco.framework.parameters.showerParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

zenith = 1

zenith angle of the shower axis pointing towards xmax

azimuth = 2

azimuth angle of the shower axis pointing towards xmax

core = 3

position of the intersection between shower axis and an observer plane

energy = 4

total energy of the primary particle, or shower energy for in-ice particle showers

electromagnetic_energy = 5

energy of the electromagnetic shower component

radiation_energy = 6

totally emitted radiation energy

electromagnetic_radiation_energy = 7

radiation energy originated from the electromagnetic emission

primary_particle = 8

particle id of the primary particle

shower_maximum = 9

position of shower maximum in slant depth, e.g., Xmax

distance_shower_maximum_geometric = 10

distance to xmax in meter

distance_shower_maximum_grammage = 11

distance to xmax in g / cm^2

parent_id = 12

id of parent in sim particles

refractive_index_at_ground = 100

refractivity at sea level

atmospheric_model = 101

atmospheric model used in simulation

magnetic_field_rotation = 102

offset between magnetic field and north in reconstruction corrdinatesystem

magnetic_field_vector = 103

magnetic field used in simulation in local coordinate system

observation_level = 104

altitude a.s.l where the particles are stored

charge_excess_profile_id = 105

the id of the charge-excess profile used in the ARZ Askaryan calculation

type = 106

for neutrino induces showers in ice: can be “HAD” or “EM”

vertex = 107

the interaction vertex (for air showers this corresponds to the point of X0)

vertex_time = 108

the propagation time relative to the first interactions

interaction_type = 109

the interaction type, e.g. cc or nc

k_L = 110

the k_L parameter of the Alvarez2009 parameter that controls the longitudional width of the charge excess profile

flavor = 111

the flavor of the particle initiating the shower

n_interaction = 112

Hierarchical counter for the number of showers per event group (also accounts for showers which did not trigger and might not be saved)

interferometric_shower_maximum = 120

depth of the maximum of the longitudinal profile of the beam-formed signal

interferometric_shower_axis = 121

shower axis (direction) derived from beam-formed signal

interferometric_core = 122

core (intersection of shower axis with obs plane) derived from beam-formed signal

class NuRadioReco.framework.parameters.emitterParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

position = 1

the interaction vertex (for air showers this corresponds to the point of X0)

model = 2

the emitter model used to simulate the emission (as defined in NuRadioMC/SignalGen/emitter.py)

amplitude = 3

the amplitude of the signal

polarization = 4

the polarization of the signal

half_width = 5

the width of square and tone_burst signal

frequency = 6

the frequency of a signal (for cw and tone_burst model)

orientation_phi = 7

the orientation of the emiting antenna, defined via two vectors that are defined with two angles each

orientation_theta = 8

the orientation of the emiting antenna, defined via two vectors that are defined with two angles each

rotation_phi = 9

the orientation of the emiting antenna, defined via two vectors that are defined with two angles each

rotation_theta = 10

the orientation of the emiting antenna, defined via two vectors that are defined with two angles each

realization_id = 11

the id of the measurement of the emitted electric field

antenna_type = 12

the type of the antenna used to simulate the emission

time = 13

the time when the signal was emitted

class NuRadioReco.framework.parameters.particleParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

parent_id = 1

the entry number of the parent particle, None if primary.

zenith = 2

the zenith angle of the incoming neutrino direction

azimuth = 3

the azimuth angle of the incoming neutrino direction

energy = 4

the energy of the neutrino

flavor = 5

the flavor of the neutrino, more generally the PDG code

vertex = 6

the neutrino vertex position (x,y,z)

vertex_time = 9
weight = 10
inelasticity = 11

inelasticity ot neutrino interaction

interaction_type = 12

interaction type, e.g., cc, nc

n_interaction = 13

number of interaction

shower_id = 14

the shower id associated with this particle. This is needed to generate HDF5 files that contain the primary particle

cr_energy = 101

the cosmic-ray energy

cr_zenith = 102

zenith angle of the cosmic-ray incoming direction

cr_azimuth = 103

azimuth angle of the cosmic-ray incoming direction

cr_energy_em = 104

the electromagnetic shower energy (the cosmic ray energy that ends up in electrons, positrons and gammas)

class NuRadioReco.framework.parameters.generatorAttributes(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

Emax = 1

maximum simulated energy

Emin = 2

minimum simulated energy

deposited = 3

deposited energies or neutrino energies?

fiducial_rmin = 4

fiducial volume parameter (if cylindrical footprint used)

fiducial_rmax = 5

fiducial volume parameter (if cylindrical footprint used)

fiducial_xmin = 6

fiducial volume parameter (if rectangular footprint used)

fiducial_xmax = 7

fiducial volume parameter (if rectangular footprint used)

fiducial_ymin = 8

fiducial volume parameter (if rectangular footprint used)

fiducial_ymax = 9

fiducial volume parameter (if rectangular footprint used)

fiducial_zmin = 10
fiducial_zmax = 11
rmin = 12

volume parameter (if cylindrical)

rmax = 13

volume parameter (if cylindrical)

xmin = 14

volume parameter (if rectangular)

xmax = 15

volume parameter (if rectangular)

ymin = 16

volume parameter (if rectangular)

ymax = 17

volume parameter (if rectangular)

zmin = 18
zmax = 19
volume = 20
area = 21
phimax = 22

simulated space angle range

phimin = 23

simulated space angle range

thetamax = 24

simulated space angle range

thetamin = 25

simulated space angle range

flavors = 26

list of simulated event flavours

dt = 27

inverse of sampling rate used in the simulation

Tnoise = 28

noise temperature used in the simulation

Vrms = 29

noise rms used in the simulation,

bandwidth = 30

integrated channel response used in the simulation

n_events = 100
n_samples = 101
start_event_id = 102
total_number_of_events = 103
NuRadioMC_EvtGen_version = 200
NuRadioMC_EvtGen_version_hash = 201
NuRadioMC_version = 202
NuRadioMC_version_hash = 203
class NuRadioReco.framework.parameters.eventParameters(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

An enumeration.

sim_config = 1

contents of the config file that the NuRadioMC simulation was run with

hash_NuRadioReco = 2

deprecated, since NuRadioReco is no longer its own repository

hash_NuRadioMC = 3

git hash of the NuRadioMC commit that the file was created with