template_synthesis.numpy.utilities.cs_transformations module

template_synthesis.numpy.utilities.cs_transformations.e_ce(traces, x, y)

Calculate the charge-excess (or Askaryan) component of electric field in the shower plane, i.e. the electric field should be in the (vxB, vxvxB, v) CS

Parameters:
traces : np.ndarray

The traces in the shower plane, shaped as (samples, polarisations)

x : float

The antenna position along the vxB axis

y : float

The antenna position along the vxvxB axis

Returns:

e_ce – The charge-excess component of the electric field

Return type:

np.ndarray

template_synthesis.numpy.utilities.cs_transformations.e_geo(traces, x, y)

Calculate the geomagnetic component from the electric field in the shower plane, i.e. the electric field should be in the (vxB, vxvxB, v) CS

Parameters:
traces : np.ndarray

The traces in the shower plane, shaped as (samples, polarisations)

x : float

The antenna position along the vxB axis

y : float

The antenna position along the vxvxB axis

Returns:

e_geo – The geomagnetic component of the electric field

Return type:

np.ndarray

template_synthesis.numpy.utilities.cs_transformations.e_to_geo_ce(traces, x, y)

Decouples the electric field in the shower plane, i.e. the electric field should be in the (vxB, vxvxB, v) CS, into the geomagnetic and charge-excess components.

Parameters:
traces : np.ndarray

The traces in the shower plane, shaped as (samples, polarisations)

x : float

The antenna position along the vxB axis

y : float

The antenna position along the vxvxB axis

Returns:

  • e_geo (np.ndarray) – The geomagnetic component of the electric field

  • e_ce (np.ndarray) – The charge-excess component of the electric field

template_synthesis.numpy.utilities.cs_transformations.geo_ce_to_e(traces, x, y)

Reconstruct a three-dimensional electric field in the shower plane, i.e. the (vxB, vxvxB, v) CS, from the geomagnetic component of the charge-excess components. The v-component is set to zero.

Parameters:
traces : np.ndarray

The electric field traces, shaped as (samples, components)

x : float

The antenna position along the vxB axis

y : float

The antenna position along the vxvxB axis

Returns:

e_field – The three-dimensional electric field, in the shower plane CS, shaped as (samples, polarisations)

Return type:

np.ndarray