Kerykeion推运技法详解:次限推运、太阳弧与主限推运三选一指南

原创2026-10-30 13:39:591,819 阅读

Kerykeion推运技法详解:次限推运、太阳弧与主限推运三选一指南

Kerykeion 是一款面向占星计算与可视化输出的 Python 库,内置了三大经典推运技法:次限推运(Secondary Progressions)、太阳弧推运(Solar Arc)与主限推运(Primary Directions)。本文带你快速理解三者的原理差异、适用场景与选型建议,帮助你在做流年、年度主题或事件预测时一次选对工具。

三种推运技法:30秒看懂差异

先给结论,再展开细节:

技法 核心思路 行星推进速度 典型用途 对应工厂类
次限推运 "一天抵一年",用出生地 N 天后的真实星空代表第 N 年 太阳 ~1°/年,月亮 ~12°/年 逐年生活主题、年度趋势 SecondaryProgressionFactory
太阳弧推运 取推进太阳与本命太阳的差值(太阳弧),统一加到本命所有点上 所有点均 ~1°/年 年度主题、双轮图(biwheel) SolarArcFactory
主限推运 Placidus 半弧法,用赤经弧计算"何时合相某点" 由弧长换算年龄 精确事件预测(传统占星) PrimaryDirectionsFactory

Kerykeion 生成的占星轮盘与推运图表预览

次限推运:一天抵一年的流年工具

次限推运是西方占星中使用最广的推运技法。它的符号逻辑是:出生后真实流逝的 N 天,象征人生的第 N 年。因此在 Kerykeion 中,只要给出一个目标日期,工厂就会算出对应的"推运星盘":

  • 太阳每年推进约 1°,月亮每年推进约 12°,慢行星一生只移动几度——大部分预测价值来自快行星与本命盘的接触
  • 目标日期二选一:target_iso_utc_datetime(ISO UTC 时间戳)或 target_year(该年 1 月 1 日 00:00 UTC 的简写),两者互斥

最小用法示例(完整示例见 examples/secondary_progressions_example.py):

from kerykeion import AstrologicalSubjectFactory, SecondaryProgressionFactory

natal = AstrologicalSubjectFactory.from_birth_data(
    "Grace Hopper", 1906, 12, 9, 11, 30,
    lng=-73.9857, lat=40.7484, tz_str="America/New_York", online=False,
)
progressed = SecondaryProgressionFactory.compute(
    natal, target_iso_utc_datetime="2026-04-25T00:00:00Z"
)

如果你不仅想要推运星盘,还想拿到"推运点 vs 本命点"的相位清单,使用 compute_full(),它会返回 SecondaryProgressionsResultModel,其中包含:

  • progressed_subject:完整的推运星盘模型,可直接喂给相位、尊贵度、画盘等下游工具
  • progressed_to_natal_aspects:推运相位命中(默认 3° 容许度,默认五大托勒密相位)
  • progressed_points:逐点比较,带 sign_changed 换星座标志,方便你直接筛出换星座年份

⚠️ 注意角度约定:Kerykeion 采用 "Q2 / daily houses" 约定,推运 MC 是该瞬间真实天空的 MC(约 360°/年);而 astro.com 等网站默认用太阳弧推进 MC(~1°/年)。行星位置两者完全一致,只有上升、天顶与宫头不同。实现细节见 kerykeion/secondary_progressions/factory.py。

次限推运本命盘渲染示例(深色主题)

太阳弧推运:统一弧度的年度放大镜

太阳弧推运是次限推运的"姊妹技法":它计算推进太阳与本命太阳的差值(即"太阳弧"),并把这同一个弧均匀地加到本命盘的每一个点上。结果是所有定向点都按约 1°/年 的速度前进,本命盘内部的几何关系被完整保留。

两个核心方法:

  • compute() → 返回 SolarArcSubjectModel:太阳弧度数、每个定向点的位置(含 sign_changed 标志)、以及"定向点 vs 本命点"的相位命中
  • compute_directed_subject() → 返回一份整体前移的星盘副本(名称带 (directed) 后缀),所有点连同四轴(Asc/MC/Desc/IC)都按太阳弧前移,宫头保持本命——这正是画双轮图(内环本命、外环定向)想要的形态
directed = SolarArcFactory.compute_directed_subject(natal, target_year=2030)
result = SolarArcFactory.compute(natal, target_iso_utc_datetime="2026-04-25T00:00:00Z")

与次限推运相比,太阳弧的优势在于:每个点推进速度一致,读盘时"所有能量同时被点亮",非常适合做年度主题复盘和 biwheel 叠加图。实现细节见 kerykeion/secondary_progressions/solar_arc.py。

Kerykeion 现代风格星盘:太阳弧推运结果可叠加绘制

主限推运:传统占星的事件级预测

主限推运(Primary Directions)是古典/传统占星中预测人生事件最常用的方法。Kerykeion 实现了 Placidus 半弧法(under the pole 变体),核心流程是:

  1. 把每个点的黄道位置转为赤道坐标(赤经 RA、赤纬 Dec)
  2. 按出生纬度计算半弧(昼弧/夜弧)
  3. 计算天顶距(MD)与指标星的 Placidus 极
  4. 在指标星的极下计算承诺星的斜升度,两者之差即为推运弧
  5. 按速率键把弧换算为年龄

速率键(rate_key)二选一:

  • ptolemy(默认):1° 弧 = 1 年
  • naibod:0.98564° = 1 年(太阳平运动速率)
directions = PrimaryDirectionsFactory.compute(subject, max_years=80)
for d in directions[:10]:
    print(f"Year {d.direction_years:.1f}: {d.promissor} {d.aspect} {d.significator}")

返回结果按 direction_years 排序,同时包含正向(is_converse=False)与逆向条目——需要注意逆向弧是经典逆向法的近似值,做精确逆向推运时应过滤使用。默认参与推运的点为日月金水火土加上升与天顶。另外 compute_speculum() 可单独导出坐标表(speculum)供核对。完整文档见 site/docs/primary_directions_factory.md。

主限推运输入的本命盘示例(经典黑白风格)

三选一指南:哪种技法适合你的问题?

你的需求 推荐技法 理由
看"某一年整体发生了什么主题" 次限推运 月亮速度快,年份颗粒度最细,是年度推运主流选择
画 biwheel 双轮图、看统一能量点亮 太阳弧推运 全图同步前移,几何保持,视觉与象征都清晰
定位具体事件发生的年龄/年份 主限推运 直接输出"哪岁哪个月球合上升"这类事件级时间点
与 astro.com 等网站结果对拍 次限推运 + 注意角度约定 行星位置一致;上升/天顶按 Q2 约定解读
想要结构化 JSON 做自动化 三者皆可 均返回 Pydantic 模型,字段含义见官方文档

一个常见的组合拳:用次限推运做逐年主题扫描 → 对可疑年份用太阳弧做双轮验证 → 对关键事件用主限推运精确定位年龄。

命令行快速体验:三条命令上手

不想写 Python?Kerykeion 自带 CLI,三大技法都有对应命令:

# 次限推运:输出到目标年份的双轮 SVG
kerykeion progression -s example --target-year 2027 -f svg -o prog_2027.svg

# 太阳弧推运:到目标年份或指定时刻
kerykeion solar-arc -s example --target-year 2027 -f json

# 主限推运:Placidus 半弧法
kerykeion directions -s example -f json

次限推运图表命令实现在 cli/kerykeion_cli/commands/charts.py,太阳弧与主限推运命令在 cli/kerykeion_cli/commands/technique.py。

Kerykeion 推运与本命盘输出示例(现代深色主题)

深入阅读

选对技法,推运就不再是"三个长得像的工厂",而是各有分工的流年工具箱。💫

登录后查看全文
kerykeion