Swiss Ephemeris Node.js Binding 技术文档

1. 安装指南

安装依赖

为了使用 Swiss Ephemeris 绑定，您的系统需要安装 Node.js 0.12 或更高版本。如果您使用的是较旧的 Node.js 版本，请安装 Swiss Ephemeris 0.4.x 或更早版本。

安装 Swiss Ephemeris

使用 npm 命令安装 Swiss Ephemeris：

$ npm install swisseph

2. 项目使用说明

Swiss Ephemeris 绑定允许您在 Node.js 应用程序中使用 Swiss Ephemeris 库的功能。以下是一些基本的使用示例：

获取儒略日

var swisseph = require('swisseph');

var date = { year: 2015, month: 1, day: 1, hour: 0 };

var julday = swisseph.swe_julday(date.year, date.month, date.day, date.hour, swisseph.SE_GREG_CAL);

获取太阳和月亮位置

var swisseph = require('swisseph');

// 测试日期
var date = { year: 2012, month: 1, day: 1, hour: 0 };
console.log('测试日期:', date);

var flag = swisseph.SEFLG_SPEED;

// 设置历书路径
swisseph.swe_set_ephe_path(__dirname + '/../ephe');

// 计算儒略日
swisseph.swe_julday(date.year, date.month, date.day, date.hour, swisseph.SE_GREG_CAL, function (julday_ut) {
    console.log('儒略日（世界时）:', julday_ut);

    // 计算太阳位置
    swisseph.swe_calc_ut(julday_ut, swisseph.SE_SUN, flag, function (body) {
        console.log('太阳位置:', body);
    });

    // 计算月亮位置
    swisseph.swe_calc_ut(julday_ut, swisseph.SE_MOON, flag, function (body) {
        console.log('月亮位置:', body);
    });
});

更多示例请参考 examples 和 test 文件夹。

使用赤道坐标或直角坐标

在计算行星、恒星、节点或近点位置时，如果使用 SEFLG_EQUATORIAL 或 SEFLG_XYZ 标志位，结果属性的名称将与赤道坐标的情况不同。请运行 examples/issue-23.js 文件查看详细信息。

历书设置

Swiss Ephemeris 支持以下三种历书类型：

• Steve Moshier 插值法，覆盖从公元前 3000 年到公元 3000 年，精度为 0.1 角秒，不需要数据文件。
• Swiss Ephemeris，是 DE431 的压缩版，覆盖从公元前 13000 年到公元 17000 年，精度为 0.001 角秒，需要约 90MB 的数据文件。可以从 ftp://www.astro.com/pub/swisseph/ephe 下载。
• JPL NASA 历书，是最先进的历书，DE431 覆盖从公元前 13000 年到公元 17000 年，最大可能的精度，需要 2.9GB 的数据文件。可以从 ftp://www.astro.com/pub/jplfiles 下载。

要使用数据文件，请先下载并放入文件夹中，然后通过以下命令设置历书路径：

swisseph.swe_set_ephe_path('/path/to/downloaded/ephemeris');

并选择历书类型：

// 使用 Moshier 插值法
var body = swisseph.swe_calc_ut(julday_ut, swisseph.SE_SUN, swisseph.SEFLG_SPEED | swisseph.SEFLG_MOSEPH);

// 使用 Swiss Ephemeris
var body = swisseph.swe_calc_ut(julday_ut, swisseph.SE_SUN, swisseph.SEFLG_SPEED | swisseph.SEFLG_SWIEPH);

// 使用 JPL NASA 历书
var body = swisseph.swe_calc_ut(julday_ut, swisseph.SE_SUN, swisseph.SEFLG_SPEED | swisseph.SEFLG_JPLEPH);

3. 项目 API 使用文档

Swiss Ephemeris 绑定提供了多个 API，以下是一些常用的 API：

• swe_julday(year, month, day, hour, calendar)：计算给定日期的儒略日。
• swe_calc_ut(julday, body, flag)：计算给定儒略日的天体位置。
• swe_set_ephe_path(path)：设置历书数据文件的路径。

更多 API 请参考 Swiss Ephemeris 的官方文档。

4. 项目安装方式

请遵循以下步骤安装 Swiss Ephemeris 绑定：

1. 确保您的系统已安装 Node.js 0.12 或更高版本。
2. 使用 npm 命令安装 Swiss Ephemeris：

$ npm install swisseph

3. 下载并设置历书数据文件（如果需要）。
4. 在您的 Node.js 应用程序中引入 Swiss Ephemeris 并开始使用。