Track

class showermodel.track.Track(theta=0.0, alt=None, az=0.0, x0=0.0, y0=0.0, xi=0.0, yi=0.0, zi=None, atmosphere=None, **kwargs)

Bases: DataFrame

DataFrame containing a linear-shower track discretization.

Use sm.Track() to construct a default Track object.

Parameters

theta (float) – Zenith angle in degrees of the apparent position of the source.
alt (float) – Altitude in degrees of the apperent position of the source. If None, theta is used. If given, theta is overwritten.
az (float) – Azimuth angle (from north, clockwise) in degrees of the apparent position of the source.
x0 (float) – East and north coordinates in km of shower impact point at ground.
y0 (float) – East and north coordinates in km of shower impact point at ground.
xi (float, default None) – East, north and height coordinates in km of the first interaction point of the shower. If given, x0 and y0 are ignored.
yi (float, default None) – East, north and height coordinates in km of the first interaction point of the shower. If given, x0 and y0 are ignored.
zi (float, default None) – East, north and height coordinates in km of the first interaction point of the shower. If given, x0 and y0 are ignored.
atmosphere (Atmosphere) – If None, a new Atmosphere object is generated.
**kwargs ({h0, h_top, N_steps, model}) – Options to construct the new Atmosphere object when atm==None. If None, the default Atmosphere object is used.

x

Column 0, east coordinate in km.

Type: float

y

Column 1, north coordinate in km.

Type: float

z

Column 2, height in km from ground level.

Type: float

t

Column 3, travel time in microseconds. t=0 at the first interaction point. The shower is assumed to propagates with the speed of light.

Type: float

atmosphere

Type: Atmosphere

theta

Zenith angle in degrees of the apparent position of the source.

Type: float

alt

Altitude in degrees of the apparent position of the source.

Type: float

az

Azimuth angle (from north, clockwise) in degrees of the apparent position of the source.

Type: float

ux, uy, uz

Coordinates of a unit vector pointing to the source position (antiparallel to the shower propagation vector).

Type: float

vx, vy, vz

Coordinates of a unit vector perpendicular to the shower axis and parallel to horizontal plane.

Type: float

wx, wy, wz

Coordinates of a unit vector perpendicular to both u and v.

Type: float

x0, y0, z0

Coordinates in km of shower impact point at ground (z0=0). Set to None for ascending showers beginning at zi>0.

Type: float or None

xi, yi, zi

Coordinates in km of the first interaction point of the shower.

Type: float

t_total

Total travel time in microseconds.

Type: float

x_top, y_top, z_top

Coordinates in km of shower at the top of the atmosphere. Set to None for descending showers beginning at zi<z_top.

Type: float or None

dl

Size in km of discretization step along the shower axis.

Type: float

h_to_xyz(): Get the spatial coordinates from height above sea level.

z_to_t(): Get travel time mass density from height.

Xv_to_xyz(): Get the spatial coordinates from vertical depth.

X_to_xyz(): Get the spatial coordinates from travel depth.

Projection(): Make a Projection object containing the coordinates of a shower track relative to a telescope position.

show_projection(): Make a Projection object and show it.