小行星与半人马小行星

English

asteroid-ephemeris-lite 是 js-ephemeris-lite 的可选小天体星历包，提供九个小天体在固定 J2000 平黄道坐标轴中的日心和地心几何位置。接口返回三维 AU 向量，可用于一般几何计算，并非只保留黄经或专门面向占星用途。

安装

npm install js-ephemeris-lite asteroid-ephemeris-lite

使用

import {
  ASTEROID,
  asteroidGeocentricPosition,
  asteroidHeliocentricPosition,
} from 'asteroid-ephemeris-lite';

const jdTT = 2451545;
const ceresFromSun = asteroidHeliocentricPosition(ASTEROID.CERES, jdTT);
const chironFromEarth = asteroidGeocentricPosition(ASTEROID.CHIRON, jdTT, 'accurate');

支持谷神星、智神星、婚神星、灶神星、爱神星、1181 Lilith，以及 Chiron、Pholus、Nessus。LILITH_1181 明确指编号 1181 的小行星，不是月球远地点相关的“黑月莉莉丝”。

时间、坐标与修正

• 输入为有限的 JD(TT)，范围为天文纪年 -3000～3000 年。
• 输出为固定 J2000 平黄道与平春分点坐标轴中的 AU 向量。
• 日心接口以太阳为中心；地心接口减去所选 accuracy 档位的地球日心位置。
• 结果是几何位置，不含光行时、光行差、引力偏折、岁差章动或地形视差。
• 离线源样本使用 TDB；TT 与 TDB 的毫秒级周期差远小于本轻量模型的误差预算。

每个分段在边界附近使用五次平滑校正，使相邻位置连续。该处理消除了直接切换独立拟合分段产生的位置跳变；当前接口不提供小行星速度，因此不承诺解析速度精度。

模型与精度

六个中低偏心率对象使用分段轨道要素 Poisson 模型；三个半人马对象使用自适应分段的 Cartesian Chebyshev 模型。后者直接以三维位置误差选段，不再只按地心方向误差筛选。

下表是独立跨年代样本相对离线基准向量的观测结果，不是对任意时刻的严格上界。公开的 ASTEROID_MODEL_INFO.positionErrorBudgetKm 使用更保守的回归阈值。

| 对象 | 三维位置 RMS | 三维位置最大值 | 方向最大值 | | --- | ---: | ---: | ---: | | Ceres | 14,835 km | 50,379 km | 26.94″ | | Pallas | 24,994 km | 98,847 km | 72.48″ | | Juno | 46,907 km | 232,321 km | 158.24″ | | Vesta | 13,181 km | 34,484 km | 21.77″ | | Eros | 19,662 km | 95,804 km | 113.08″ | | 1181 Lilith | 7,649 km | 44,878 km | 26.75″ | | Chiron | 557 km | 2,185 km | 0.31″ | | Pholus | 590 km | 3,665 km | 0.48″ | | Nessus | 496 km | 915 km | 0.09″ |

这些模型适合体积受限应用中的近似位置、可视化和候选事件筛选。测量归算、掩星预报、航天器导航或需要公里级保证的工作，应直接使用覆盖相应年代的 JPL SPK 或其他经过验证的数值星历。

数据来源与长年代限制

• Ceres、Pallas、Juno、Vesta 在本模块的完整范围内使用 JPL sb441-n16 样本。
• Eros 约 1550～2650 年使用 JPL sb441-n373s；范围外来自项目离线生成的连续数值积分数据。
• 1181 Lilith、Chiron、Pholus、Nessus 约 1799～2101 年使用 JPL Horizons SPK；范围外来自同一离线数据工程的连续数值积分扩展。

后两类对象在官方 SPK 区间外不应被描述为 JPL 直接星历。长年代结果还受初始轨道、扰动模型及近距离遭遇的混沌放大影响，年代越远不确定性通常越大。

小行星系数不包含在 js-ephemeris-lite 主包中，只有安装本包的项目才会下载这些数据。