meepmeep.numba3d.cos_v_p_angle_o

meepmeep.numba3d.cos_v_p_angle_o#

meepmeep.numba3d.cos_v_p_angle_o(v, t, tpa, p, dt, ep_table, ep_times, coeffs)[source]#

Cosine of the angle between the planet position and a fixed reference vector.

Accepts a scalar time t or a 1-D array of times and dispatches to the scalar (_cos_v_p_angle_os()) or vector (cos_v_p_angle_ov()) kernel at compile time (inside @njit) or at call time (pure Python).

Useful for projecting the planet position onto an arbitrary line-of-sight axis (e.g. the spin axis of an oblate star).

Parameters:
vndarray, shape (3,)

Reference vector. Need not be unit-norm; the cosine is computed from the dot product divided by the product of the norms.

tfloat or ndarray

Time(s) at which to evaluate the angle.

tpa, p, dt, ep_table, ep_times, coeffs

See _pos_os().

Returns:
cos_thetafloat or ndarray

Cosine of the angle between the planet position vector and v, in \([-1, 1]\). Arrays of shape (N,) for an array t.