Files
astro/eclipse/svg/doc.go
T
b612 2bf8478639 feat: 完善日月食与月掩几何链路并扩展历法接口
- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算,支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径,补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出,支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推,补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存,降低重复计算开销并提升边界稳定
2026-09-17 12:27:40 +08:00

59 lines
2.9 KiB
Go

// Package svg 生成日食与月食的 SVG 图件。
//
// 可降级的图层用 data-source 标注实际几何来源,取值词表如下;没有降级分支的图层不带该属性。
//
// partial-band-union 偏食可见域填充:权威边界线材与瞬时足迹求并集
// sampled-footprint-sweep 偏食可见域填充:逐瞬时足迹扫掠(并集不可用时的降级)
// partial-band-contours 偏食可见域边界线
// rise-set-phase-lines 初亏、食甚、复圆的日升日落线
// magnitude-contours 地方最大食分等值线
// greatest-time-isochrones 食甚时刻等时线
// besselian-critical-envelope 中心食带:Bessel 临界包络
// paired-limit-chords 中心食带:南北限界弦带(包络不可用时的降级)
// sampled-open-sweep 中心食带:采样扫掠(前两者都不可用时的降级)
// central-path-limits 中心线与南北限界线
// penumbral-outlines 瞬时半影轮廓
// central-shadow-outlines 瞬时本影、反本影轮廓
// p1-p4-visibility-regions 月食可见性分区
// p1-p4-horizon-boundaries 月食 P1、P4 地平边界
//
// Package svg renders solar- and lunar-eclipse SVG charts. Degradable layers tag the geometry
// source they actually used in data-source, using exactly the values above.
package svg
// data-source 词表,见包注释。
const (
eclipseMapSourcePartialBandUnion = "partial-band-union"
eclipseMapSourceSampledFootprintSweep = "sampled-footprint-sweep"
eclipseMapSourcePartialBandContours = "partial-band-contours"
eclipseMapSourceRiseSetPhaseLines = "rise-set-phase-lines"
eclipseMapSourceMagnitudeContours = "magnitude-contours"
eclipseMapSourceGreatestTimeIsochrones = "greatest-time-isochrones"
eclipseMapSourceBesselianEnvelope = "besselian-critical-envelope"
eclipseMapSourcePairedLimitChords = "paired-limit-chords"
eclipseMapSourceSampledOpenSweep = "sampled-open-sweep"
eclipseMapSourceCentralPathLimits = "central-path-limits"
eclipseMapSourcePenumbralOutlines = "penumbral-outlines"
eclipseMapSourceCentralShadowOutlines = "central-shadow-outlines"
eclipseMapSourceLunarVisibilityRegions = "p1-p4-visibility-regions"
eclipseMapSourceLunarHorizonBoundaries = "p1-p4-horizon-boundaries"
)
// eclipseMapDataSources 是全部合法取值,测试用它封闭词表。
var eclipseMapDataSources = []string{
eclipseMapSourcePartialBandUnion,
eclipseMapSourceSampledFootprintSweep,
eclipseMapSourcePartialBandContours,
eclipseMapSourceRiseSetPhaseLines,
eclipseMapSourceMagnitudeContours,
eclipseMapSourceGreatestTimeIsochrones,
eclipseMapSourceBesselianEnvelope,
eclipseMapSourcePairedLimitChords,
eclipseMapSourceSampledOpenSweep,
eclipseMapSourceCentralPathLimits,
eclipseMapSourcePenumbralOutlines,
eclipseMapSourceCentralShadowOutlines,
eclipseMapSourceLunarVisibilityRegions,
eclipseMapSourceLunarHorizonBoundaries,
}