b612/astro
1
1
Fork 0
Code Issues Pull Requests Projects Releases 18 Wiki Activity

fix: 修正行星事件边界与留点计算

Browse Source 
- 统一 UT 事件时刻与 TT 查询时刻的边界判断
- 将外行星留点搜索锚定到对应冲日周期
- 修正水星、金星合日、留、大距事件选择
- 统一七大行星视位置计算辅助逻辑
- 增加公开 Last/Next 边界和 JPL/NAOJ 基线回归测试
This commit is contained in:
兔子
2026-05-22 12:24:41 +08:00
parent d40c4dfcd9
commit 34ff6a36ae
51 changed files with 33522 additions and 10994 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+74 -78
View File
@@ -309,7 +309,6 @@ func main() {
```text
// 同一公历时刻在三国并立时期会映射到多个政权各自的农历结果
[魏明帝 景初三年腊月二十 蜀后主 延熙二年冬月十九 吴大帝 赤乌二年冬月二十]
// 结构化农历信息输出；每个对象对应一个政权口径下的结果
[
{
@@ -370,14 +369,12 @@ func main() {
"chineseZodiac": "羊"
}
]
// “元丰六年十月十二日”对应的公历日期
1083-11-24 00:00:00 +0800 CST
// 同一天在并行政权下还会命中辽道宗大康九年十月十二
[宋神宗 元丰六年十月十二 辽道宗 大康九年十月十二]
// 现代农历日期转换结果；2026 年正月初一对应 2026-02-17
2026-02-17 00:00:00 +0800 CST //2026年春节
2026-02-17 00:00:00 +0800 CST
```
#### 节气
@@ -407,10 +404,10 @@ func main() {
输出结果
```
2020-02-04 17:03:17.820854187 +0800 CST
2020-12-21 18:02:17.568823993 +0800 CST
2020-03-20 11:49:34.502393603 +0800 CST
2020-03-20 11:49:34.502393603 +0800 CST
2020-02-04 17:03:20.471614301 +0800 CST
2020-12-21 18:02:20.648710727 +0800 CST
2020-03-20 11:49:37.149532735 +0800 CST
2020-03-20 11:49:37.149532735 +0800 CST
```
@@ -474,14 +471,14 @@ func main() {
输出结果
```
2020-01-01 07:22:27.964431345 +0800 CST <nil>
2020-01-01 07:50:14.534510672 +0800 CST <nil>
2020-01-01 07:22:27.960488498 +0800 CST <nil>
2020-01-01 07:50:14.530648291 +0800 CST <nil>
2020-01-01 12:47:35.933117866 +0800 CST
2020-01-01 17:44:47.076647579 +0800 CST <nil>
2020-01-01 18:12:33.629668056 +0800 CST <nil>
2020-01-01 11:52:44.643359184 +0800 CST <nil>
2020-01-01 17:38:03.879639208 +0800 CST
2020-01-01 23:26:52.202896177 +0800 CST <nil>
2020-01-01 17:44:47.070974707 +0800 CST <nil>
2020-01-01 18:12:33.624035418 +0800 CST <nil>
2020-01-01 11:52:45.157297253 +0800 CST <nil>
2020-01-01 17:38:02.510787248 +0800 CST
2020-01-01 23:26:51.580328643 +0800 CST <nil>
```
@@ -536,17 +533,16 @@ func main() {
输出结果：
```
280.0152925179703
23.436215552851408
赤经： 18h43m34.83s 赤纬： -23°3′30.25″
280.01526210031136
23.4362178391013
赤经： 18h43m34.82s 赤纬： -23°3′30.27″
人马座
方位角： 120.19483856399326 高度角： 2.4014324584398516 天顶距： 87.59856754156014
0.9832929365443133
赤经： 23h17m51.93s 赤纬： -10°19′17.02″
方位角： 120.19477090015224 高度角： 2.4014437419430097 天顶距： 87.59855625805699
0.983292937163176
赤经： 23h17m53.15s 赤纬： -10°19′18.57″
宝瓶座
方位角： 67.84449893794012 高度角： -45.13018696439911 天顶距： 135.13018696439912
404238.6354387698
方位角： 67.84050700509859 高度角： -45.13425530765482 天顶距： 135.13425530765483
404238.6096080479
```
太阳还提供 `sun.Physical` / `sun.PhysicalN`，返回：
@@ -683,12 +679,12 @@ func main() {
输出结果：
```
0.3000437415436273 // 月面约有 30% 被太阳照亮
0.300041309608744 // 月面约有 30% 被太阳照亮
上峨眉月 // 当前月相描述
2020-01-25 05:41:55.820311009 +0800 CST // 下一次朔月
2020-01-03 12:45:20.809730887 +0800 CST // 下一次上弦
2020-01-11 03:21:14.729664623 +0800 CST // 下一次望月，也就是满月
2020-01-17 20:58:20.955985486 +0800 CST // 下一次下弦
2020-01-25 05:41:58.271192908 +0800 CST // 下一次朔月
2020-01-03 12:45:23.229190707 +0800 CST // 下一次上弦
2020-01-11 03:21:17.159625291 +0800 CST // 下一次望月，也就是满月
2020-01-17 20:58:23.396406769 +0800 CST // 下一次下弦
```
月相四个相位同时提供拼音名和英文 alias，例如：
@@ -1074,18 +1070,18 @@ func main() {
```text
total
true {125 49 72}
2028-12-31 16:52:05.257715537 +0000 UTC
2.273989043 1.246114288
2028-12-31 14:03:54.163612125 +0000 UTC
2028-12-31 15:07:42.293254197 +0000 UTC
2028-12-31 16:16:27.717077732 +0000 UTC
2028-12-31 17:27:46.687390804 +0000 UTC
2028-12-31 18:36:32.272528112 +0000 UTC
2028-12-31 19:40:11.173523784 +0000 UTC
2.29960334 1.25117109
2028-12-31 16:52:05.566135346 +0000 UTC
2.273989043382249 1.2461142882946992
2028-12-31 14:03:54.219463169 +0000 UTC
2028-12-31 15:07:42.115980684 +0000 UTC
2028-12-31 16:16:27.24464178 +0000 UTC
2028-12-31 17:27:46.214954853 +0000 UTC
2028-12-31 18:36:32.251235246 +0000 UTC
2028-12-31 19:40:11.52023971 +0000 UTC
2.2996033397593934 1.2511710895700923
true
total
2029-01-01 00:52:05.257715537 +0800 CST
2029-01-01 00:52:05.566135346 +0800 CST
```
##### 与 NASA 数据对照
@@ -1232,20 +1228,20 @@ func main() {
输出结果：
```
2019-11-11 23:21:39.702344834 +0800 CST // 水星上次下合
2021-03-26 14:57:38.289429545 +0800 CST // 金星下次上合
2019-11-01 04:31:47.807287573 +0800 CST // 水星上次由顺行转逆行的留
2021-12-18 18:59:12.762369811 +0800 CST // 金星下次由逆行转顺行的留
2019-10-20 11:59:33.893027007 +0800 CST // 水星上次东大距
2020-08-13 07:56:02.326616048 +0800 CST // 金星下次西大距
2020-01-01 10:01:10.821288228 +0800 CST <nil> // 西安当天金星升起时刻；无错误
2020-01-01 20:27:00.741534233 +0800 CST <nil> // 西安当天金星落下时刻；无错误
2019-11-11 23:21:42.048057317 +0800 CST // 水星上次下合
2021-03-26 14:57:43.01215589 +0800 CST // 金星下次上合
2019-11-01 04:31:38.999851942 +0800 CST // 水星上次由顺行转逆行的留
2020-06-25 02:07:41.549940705 +0800 CST // 金星下次由逆行转顺行的留
2019-10-20 11:50:28.734245896 +0800 CST // 水星上次东大距
2020-08-13 07:59:17.123789191 +0800 CST // 金星下次西大距
2020-01-01 10:02:34.172194004 +0800 CST <nil> // 西安当天金星升起时刻；无错误
2020-01-01 20:25:37.363712489 +0800 CST <nil> // 西安当天金星落下时刻；无错误
-4 // 金星视星等
49.98145049145023 // 金星相位角，单位度
0.8215177914415865 // 金星被照亮比例
255.63802111818407 // 金星亮面中心位置角，单位度
1.2760033106813273 // 金地距离，单位 AU
0.7262288470390035 // 金日距离，单位 AU
255.63802093000768 // 金星亮面中心位置角，单位度
1.2778819631550336 // 金地距离，单位 AU
0.7262651056423838 // 金日距离，单位 AU
```
内外行星同样提供 `Diameter` / `Semidiameter`（以及 `N` 版），返回地心视直径/视半径，单位为角秒。
@@ -1313,22 +1309,22 @@ func main() {
```text
true // 找到一次有效的地心水星凌日
2019-11-11 12:35:31.637522578 +0000 UTC // 一触：水星外切进入太阳圆面
2019-11-11 12:37:12.887506484 +0000 UTC // 二触：水星完全进入太阳圆面
2019-11-11 15:19:48.430488109 +0000 UTC // 凌甚：水星中心最接近太阳中心
2019-11-11 18:02:29.246907234 +0000 UTC // 三触：水星开始离开太阳圆面
2019-11-11 18:04:10.707873702 +0000 UTC // 四触：水星外切离开太阳圆面
2019-11-11 12:35:31.617325544 +0000 UTC // 一触：水星外切进入太阳圆面
2019-11-11 12:37:13.078211545 +0000 UTC // 二触：水星完全进入太阳圆面
2019-11-11 15:19:48.410291075 +0000 UTC // 凌甚：水星中心最接近太阳中心
2019-11-11 18:02:29.2267102 +0000 UTC // 三触：水星开始离开太阳圆面
2019-11-11 18:04:10.687676668 +0000 UTC // 四触：水星外切离开太阳圆面
5h28m39.070351124s // 一触到四触的地心凌日持续时间
75.92460219695154 // 凌甚时水星中心与太阳中心的最小角距离，单位角秒
968.8881521396688 // 凌甚时太阳视半径，单位角秒
4.978442856283907 // 凌甚时水星视半径，单位角秒
75.92506897631685 // 凌甚时水星中心与太阳中心的最小角距离，单位角秒
968.8881520858397 // 凌甚时太阳视半径，单位角秒
4.978442860728242 // 凌甚时水星视半径，单位角秒
true // 找到一次有效的地心金星凌日
2012-06-05 22:09:47.581470608 +0000 UTC // 一触：金星外切进入太阳圆面
2012-06-05 22:27:35.979940295 +0000 UTC // 二触：金星完全进入太阳圆面
2012-06-06 01:29:35.686955451 +0000 UTC // 凌甚：金星中心最接近太阳中心
2012-06-06 04:31:35.18302828 +0000 UTC // 三触：金星开始离开太阳圆面
2012-06-06 04:49:23.581457734 +0000 UTC // 四触：金星外切离开太阳圆面
6h39m35.999987126s // 一触到四触的地心凌日持续时间
2012-06-05 22:09:47.514281272 +0000 UTC // 一触：金星外切进入太阳圆面
2012-06-05 22:27:35.701768398 +0000 UTC // 二触：金星完全进入太阳圆面
2012-06-06 01:29:35.408823788 +0000 UTC // 凌甚：金星中心最接近太阳中心
2012-06-06 04:31:34.90493685 +0000 UTC // 三触：金星开始离开太阳圆面
2012-06-06 04:49:23.303366303 +0000 UTC // 四触：金星外切离开太阳圆面
6h39m35.789085031s // 一触到四触的地心凌日持续时间
```
#### 外行星
@@ -1390,18 +1386,18 @@ func main() {
输出结果：
```
2020-10-14 07:25:47.740884125 +0800 CST // 火星下次冲日
2021-01-29 09:39:30.916356146 +0800 CST // 木星下次合日
2019-04-30 10:28:27.453395426 +0800 CST // 土星上次由顺行转逆行的留
saturn B=23.577026 Bp=23.266930 P=6.629811 dU=1.171017 major=34.133852 minor=13.652911 // 土星环 B、B'、P、dU、长轴、短轴
2021-01-14 21:35:01.269377768 +0800 CST // 天王星下次由逆行转顺行的留
2019-12-08 17:00:13.772284984 +0800 CST // 海王星上次东方照
2020-06-07 03:10:57.179121673 +0800 CST // 火星下次西方照
2020-01-01 04:40:05.409269034 +0800 CST <nil> // 西安当天火星升起时刻；无错误
2020-01-01 14:56:57.175483703 +0800 CST <nil> // 西安当天火星落下时刻；无错误
2020-10-14 07:25:50.262777507 +0800 CST // 火星下次冲日
2021-01-29 09:39:33.565426468 +0800 CST // 木星下次合日
2019-04-30 10:27:41.606289446 +0800 CST // 土星上次由顺行转逆行的留
saturn B=23.577026 Bp=23.266930 P=6.629811 dU=1.171016 major=34.133852 minor=13.652911 // 土星环 B、B'、P、dU、长轴、短轴
2020-01-11 15:23:07.378419935 +0800 CST // 天王星下次由逆行转顺行的留
2019-12-08 17:00:15.328663587 +0800 CST // 海王星上次东方照
2020-06-07 03:10:59.356176853 +0800 CST // 火星下次西方照
2020-01-01 04:41:29.622089266 +0800 CST <nil> // 西安当天火星升起时刻；无错误
2020-01-01 14:55:32.963870465 +0800 CST <nil> // 西安当天火星落下时刻；无错误
1.57 // 火星视星等
2.1820316323604088 // 地火距离，单位 AU
1.5894169865107062 // 日火距离，单位 AU
2.1844284956325937 // 地火距离，单位 AU
1.5897860004265403 // 日火距离，单位 AU
```
@@ -1452,7 +1448,7 @@ func main() {
```text
jupiter DS=54.342153 DE=1.436485 CMI=292.712909 CMII=276.309048 CMIII=147.241811 // 木星子日/子地赤纬，System I/II/III 中央经线，单位度
saturn B=-0.608048 Bp=-2.675677 P=4.480276 major=42.709920 minor=0.453248 // 土星环 B、B'、短轴位置角、外缘长短轴，角度单位度，长短轴单位角秒
saturn B=-0.608046 Bp=-2.675677 P=4.480276 major=42.709920 minor=0.453246 // 土星环 B、B'、短轴位置角、外缘长短轴，角度单位度，长短轴单位角秒
```
只需要中央经线时，可以单独调用 `CentralMeridians`：
@@ -1619,8 +1615,8 @@ func main() {
2019-12-31 19:22:56.176710426 +0800 CST // 天狼星升起时刻
2020-01-01 05:30:39.834894239 +0800 CST // 天狼星落下时刻
大犬座 // 天狼星所在星座
5h58m10.19s // 织女一在公元 13600 年的赤经
84°19′26.25″ // 织女一在公元 13600 年的赤纬
5h58m5.71s // 织女一在公元 13600 年的赤经
84°19′26.13″ // 织女一在公元 13600 年的赤纬
天狼 Sirius -1.46 // 最亮恒星表第一项：中文名、英文常用名、视星等
```