@observerly/astrometry/dist/refraction.d.ts

observerly's lightweight, zero-dependency, type safe astrometry library written in Typescript for calculating the position of celestial objects in the sky.

/*****************************************************************************************************************/
/*****************************************************************************************************************/
import type { HorizontalCoordinate } from './common';
/*****************************************************************************************************************/
/**
 *
 * getRefraction()
 *
 * The refraction correction to the observed object is an adjustment to the observed object
 * based on pressure and temperature effects.
 *
 * N.B. There is no correction for the azimuthal angle.
 *
 * @param target - The horizontal coordinate of the observed object.
 * @param temperature - The temperature in Kelvin.
 * @param pressure - The pressure in Pascals.
 * @returns The refraction correction to the observed object (in degrees).
 *
 */
export declare const getRefraction: (target: HorizontalCoordinate, temperature?: number, pressure?: number) => number;
/*****************************************************************************************************************/
/**
 *
 * getCorrectionToHorizontalForRefraction()
 *
 * The correction to the HorizontalCoordinate for refraction is an adjustment to the observed
 * HorizontalCoordinate based on pressure and temperature effects.
 *
 * @param target - The horizontal coordinate of the observed object.
 * @param temperature - The temperature in Kelvin.
 * @param pressure - The pressure in Pascals.
 * @returns The horizontal coordinate of the observed object corrected for atmospheric refraction.
 *
 */
export declare const getCorrectionToHorizontalForRefraction: (target: HorizontalCoordinate, temperature?: number, pressure?: number) => HorizontalCoordinate;
/*****************************************************************************************************************/
/**
 *
 * getAirmass()
 *
 * The airmass is the path length of light through the Earth's atmosphere. The airmass is a measure
 * of the amount of atmosphere that light must pass through to reach the observer. The airmass
 * is inversely proportional to the altitude of the observed object.
 *
 * @see Ciddor, P. E. (1996). “A New Equation of State for Air: The Dependence of Density on Pressure and Temperature.” Metrologia, 33(2), 209–221.
 *
 * @param target - The horizontal coordinate of the observed object.
 * @returns the airmass of the observed object.
 *
 */
export declare const getAirmass: (target: HorizontalCoordinate) => number;
/*****************************************************************************************************************/