pyrex.ice_model.AntarcticIce

class pyrex.ice_model.AntarcticIce(n0=1.78, k=0.43, a=0.0132, valid_range=(- 2850, 0), index_above=1, index_below=None)

Class describing the ice at the south pole.

In all methods, the depth z should be given as a negative value if it is below the surface of the ice.

Parameters

n0float, optional

Asymptotic index of refraction of the deep ice.

kfloat, optional

Multiplicative factor for the index of refraction parameterization.

afloat, optional

Exponential factor for the index of refraction parameterization with units of 1/m.

valid_rangearray_like of float, optional

Range of depths over which the uniform index of refraction applies. Assumed to have two elements where the first value is lower (deeper, more negative) than the second.

index_abovefloat or None, optional

Index of refraction above the ice region. If None, uses the same index of refraction as the top of the ice.

index_belowfloat or None, optional

Index of refraction below the ice region. If None, uses the same index of refraction as the bottom of the ice.

Notes

Parameterizations mostly based on South Pole ice characteristics outlined by Matt Newcomb [1].

References

1

13. Newcomb (2013) http://icecube.wisc.edu/~araproject/radio/

Attributes

n0, k, afloat

Parameters of the index of refraction of the ice.

valid_rangetuple

Range of depths over which the ice model is valid. Consists of two elements where the first value is lower (deeper, more negative) than the second.

index_above

The index of refraction above the ice’s valid range.

index_below

The index of refraction below the ice’s valid range.

Methods

attenuation_length(z, f)	Calculates attenuation lengths for given depths and frequencies.
contains(point)	Determines if the given point is within the ice’s valid range.
depth_with_index(n)	Calculates the corresponding depth for a given index of refraction.
gradient(z)	Calculates the gradient of the index of refraction at a given depth.
index(z)	Calculates the index of refraction of the ice at a given depth.
temperature(z)	Calculates the temperature of the ice at a given depth.