normalisation

piran.normalisation.compute_cunningham_norm_factor(

cpdr: Cpdr,

omega: Annotated[Quantity, Unit('rad / s')],

X_range: Annotated[Quantity, Unit(dimensionless)],

) → Annotated[Quantity, Unit('s / m3')]

Calculate the normalisation factor from Cunningham 2023 (denominator of equation 4b).

Parameters:

cpdrpiran.cpdr.Cpdr

Cold plasma dispersion relation object.

omegaastropy.units.quantity.Quantity convertible to rad/second

Wave frequency.

X_rangeastropy.units.quantity.Quantity (dimensionless_unscaled)

Wave normal angles.

Returns:

norm_factorastropy.units.quantity.Quantity[UNIT_NF]

piran.normalisation.compute_glauert_norm_factor(

cpdr: Cpdr,

omega: Annotated[Quantity, Unit('rad / s')],

X_range: Annotated[Quantity, Unit(dimensionless)],

wave_norm_angle_dist: Gaussian,

method='simpson',

) → Annotated[Quantity, Unit('s / m3')]

Calculate the normalisation factor from Glauert & Horne 2005 (equation 15).

Parameters:

cpdrpiran.cpdr.Cpdr

Cold plasma dispersion relation object.

omegaastropy.units.quantity.Quantity convertible to rad/second

Wave frequency.

X_rangeastropy.units.quantity.Quantity (dimensionless_unscaled)

Wave normal angles.

wave_norm_angle_distpiran.gauss.Gaussian

Distribution of wave normal angles.

methodstr, default=”simpson”

A string representing the integration method. The valid options are “trapezoid” and “simpson”.

Returns:

norm_factorastropy.units.quantity.Quantity[UNIT_NF]