//! Reference frame definitions and the rotation between the inertial and
//! Earth-fixed frames.
//!
//! A reference frame fixes the orientation and origin that a vector is
//! expressed relative to. This crate names the two frames used for
//! near-Earth work and computes the rotation between them. Concrete
//! position types that carry a frame are defined in `apsis-coord`; this
//! crate works with the rotation matrix and the angle that defines it.
//!
//! The inertial frame is the Earth-centered inertial (ECI) frame aligned
//! with the mean equator and equinox of J2000.0. Its axes are fixed in
//! inertial space, so an orbit propagated in it is not affected by the
//! rotation of the Earth.
//!
//! The rotating frame is the Earth-centered Earth-fixed (ECEF) frame. Its
//! third axis is the Earth's rotation axis and its first axis follows the
//! prime meridian, so a point fixed to the ground has constant coordinates
//! in it.
//!
//! The two are related by a rotation of [`EarthRotationAngle`] about the
//! common third axis. This crate models the Earth's rotation with the Earth
//! Rotation Angle, which is a function of UT1 only. It does not apply
//! precession or nutation, because an angle accurate to a few hundredths of
//! a degree is sufficient for pointing and coverage work and the full model
//! needs the orientation of the celestial pole, which is a separate
//! computation.
//!
//! Source: the Earth Rotation Angle expression is from the International
//! Astronomical Union, as given in the *IERS Conventions (2010)*, equation
//! 8.32.
//!
//! ```
//! use apsis_frames::{EarthRotationAngle, rotation_eci_to_ecef};
//!
//! // The angle advances by roughly 360.9856 degrees per day.
//! let first = EarthRotationAngle::from_ut1_days(0.0);
//! let second = EarthRotationAngle::from_ut1_days(1.0);
//! let advance = (second.radians() - first.radians()).to_degrees();
//! assert!((advance - 360.985_612_288_088).abs() < 1e-6);
//!
//! // The rotation is ready to apply to a vector.
//! let _ = rotation_eci_to_ecef(first);
//! ```
//!
//! 参考系定义，以及惯性系与地固系之间的转动。
//!
//! 参考系固定了矢量所相对表达的取向与原点。本 crate 为近地工作所用的两个
//! 坐标系命名，并计算它们之间的转动。携带坐标系的具位置类型定义在
//! `apsis-coord` 中；本 crate 处理转动矩阵以及定义它的角。
//!
//! 惯性系是与 J2000.0 平赤道与平春分点对齐的地心惯性（ECI）系。其各轴在
//! 惯性空间中固定，故在其中传播的轨道不受地球转动影响。
//!
//! 转动坐标系是地心地固（ECEF）系。其第三轴是地球自转轴，第一轴随本初
//! 子午线，故固定于地面的点在其中具有恒定坐标。
//!
//! 二者由绕公共第三轴转动 [`EarthRotationAngle`] 相联系。本 crate 用地球
//! 自转角为地球自转建模，它仅是 UT1 的函数。它不施加岁差或章动，因为精确
//! 到百分之几度的角对指向与覆盖工作已足够，而完整模型需要天极的取向，那是
//! 另一项单独的计算。
//!
//! 出处：地球自转角表达式来自国际天文学联合会，如 *IERS Conventions
//! （2010）* 式 8.32 所给出。

#![forbid(unsafe_code)]
#![deny(missing_docs)]

mod earth_rotation;
pub mod iau2000;

pub use earth_rotation::{
    ERA_J2000_TURNS, ERA_RATE_TURNS_PER_DAY, EarthRotationAngle, rotation_ecef_to_eci,
    rotation_eci_to_ecef, ut1_days_from_j2000,
};