Refraction and timing#
Air bends light and slows it down. This page describes how obdeect computes the bending of a ray and
the air delay from an atmospheric profile. The atmosphere stage uses it for light sources and for
photons emitted in the air. Photons of a run with refraction_applied = 1 are not refracted again.
The bending and air delay described on this page are plane-parallel (layers of constant height, no
Earth curvature). This is the expansion used in mode none. In mode spherical the same
quantities come from integrals over spherical shells (Refraction in the spherical mode).
In mode corsika CORSIKA has already applied the curved refraction.
Input table#
Lines starting with # and blank lines are skipped. The first four columns are used:
# Alt [km] rho [g/cm^3] thick [g/cm^2] n-1
0.000 1.21171e-03 1.04473e+03 2.80503e-04
1.000 1.10668e-03 9.28757e+02 2.55945e-04
Rules (violations raise ValueError):
5 to 120 levels, altitudes strictly ascending and within ±1000 km.
density and n-1 positive; density and thickness strictly decreasing with height.
top thickness may be zero; the top density must be positive.
the thickness column must agree with the integral of the density over the table to 5 %.
Interpolation#
Heights in m a.s.l. (cm internally).
Density and n-1 are interpolated by a natural cubic spline of their logarithm through the levels.
The spline is tabulated on a fine grid: every level is a grid point, cells at most 3 m long.
Inside a cell density and n-1 are exponential (linear in the logarithm), so integrals of n-1 over height are exact for the tabulated profile.
Thickness between two levels is the upper level’s table value plus the interval’s table thickness times the fraction of the interval’s mass (from the interpolated density) above the height. Level values are reproduced exactly.
Below the table the bottom values are used; above it density, thickness and n-1 are 0.
profile = obdeect.propagation.AtmosphereProfile("atmprof_ecmwf_north_winter_fixed.dat")
profile.density([0.0, 2180.0]) # [1.21171e-03, 9.75149e-04] g/cm^3
profile.group_index(2180.0) # 1.000225191893913
Ray bending#
Plane-parallel layers, n(h) = 1 + nu(h). A photon emitted at height h_e with zenith angle
theta_e (direction cosines (cx, cy), downward) follows Snell’s law
n(h) sin(theta(h)) = n(h_e) sin(theta_e)
to the observation level, where sin(theta_obs) = sin(theta_e) n(h_e) / n(obs). Over the path
horizontal offset dx = integral of tan(theta(h)) dh - (h_e - obs) tan(theta_e)
travel time T = (1/c) integral of n(h) / cos(theta(h)) dh
dx is the displacement against the straight line along the emission direction (negative: the ray
ends nearer the vertical of the emission point). T includes the vacuum path along the emission
direction, (h_e - obs) / (c cos(theta_e)); T minus that vacuum path is the air excess. The
refractive index n is used for the travel time (no dispersion term).
The integrals are evaluated as a series. With delta = n_e/n - 1 (about 1e-4) the integrands are
power series in s_e delta, with coefficients from the Taylor series of s/sqrt(1-s^2) and
1/sqrt(1-s^2). delta^k is a polynomial in nu_e and nu, so each term is a product of powers
of nu_e and the moments M_b(h) = integral of nu^b dh, tabulated once per profile and observation
level. Six terms are summed; the truncation error is below 1e-6 m for zenith angles up to 82 degrees
(tested). No loop over layers, no allocation, and two table lookups at most.
The new direction is (cx, cy) sin(theta_obs)/sin(theta_e); the position moves by
dx (cx, cy)/sin(theta_e).
bend returns False and leaves the photon unchanged if an input (height, direction, position,
time) is not finite, the direction is not inside the unit circle (upward or horizontal), the emission
is below the observation level, or the ray is too close to the horizon for the series
(sin(theta_e) (nu_obs - nu_e) > 0.1 cos^2(theta_e), about 87 degrees). Public height lookups, the
timing helpers and the observation level throw for non-finite values.
Example (ECMWF table, observation level 2180 m, photon direction purely in x):
emission height |
zenith |
displacement |
travel time minus vacuum straight path |
|---|---|---|---|
10 km |
20 deg |
-0.18 m |
+4.07 ns |
10 km |
60 deg |
-3.04 m |
-0.73 ns |
20 km |
60 deg |
-9.32 m |
-15.40 ns |
40 km |
60 deg |
-12.59 m |
-24.02 ns |
Vertical photons have no displacement. Their travel-time excess over vacuum equals
straight_path_air_delay_ns (4.02 ns from 10 km, 5.77 ns from 20 km).
At large zenith angles the excess can be negative: the ray bends towards the vertical, so its path is shorter than the straight line, which outweighs the slower speed in air. The series agrees with a numerical integration of the exact integrands to 1e-6 m and 1e-6 ns on the ECMWF table.
Spherical mode#
Mode spherical of the curvature option does not use the expansion above. It bends
the ray in spherical shells, with Bouguer’s law \(n r \sin\theta = K\), and adds the air delay along
the bent ray. The equations, the lookup tables and their accuracy are on the
curvature page. The plane-parallel bending above
is the limit of that mode for an infinite Earth radius.
Timing#
ambient_group_index(profile, obs): refractive indexn = 1 + (n-1)at the observation level. ln(n-1) is interpolated with a natural cubic spline in height (m), tabulated on 40 000 equidistant heights between the lowest and highest level, linear between them. Below the table the first value is used; at or above the top leveln = 1. The height must be below the second-highest level (elseValueError).propagation_time_ns(path, n) = path * n / c,c = 0.299792458 m/ns.straight_path_air_delay_ns(profile, h1, h2, zenith):(1/c) integral of (n-1) dh / cos(zenith)between two heights, exact for the interpolated profile.
Units#
quantity |
unit |
|---|---|
height, position |
m (public API); cm internally ( |
density |
g/cm³ |
thickness |
g/cm² |
n-1 |
dimensionless |
direction |
cosines (cx, cy); cz = sqrt(1 - cx² - cy²) > 0 |
time |
ns, added to the emission time |
Refraction tables depend on the observation level: build one RefractionTables per level.
RefractionTables.etadsn is the Gladstone-Dale ratio (n-1)/density (about 0.23 cm³/g) at the
first level more than 1.5 km above the observation level.