feat: 扩展天文计算能力
- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息 - 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算 - 新增木星伽利略卫星位置、现象与接触事件计算 - 新增恒星星表、星座判定、自行修正与观测辅助能力 - 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包 - 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算 - 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试 - 重构基础算法文件组织，补充大量公开 API 注释和语义回归测试 - 更新中文和英文 README，补充示例、精度说明、SVG 配图
This commit is contained in:
@@ -0,0 +1,923 @@
|
||||
package svg
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"html"
|
||||
"math"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"b612.me/astro/basic"
|
||||
eclipsecore "b612.me/astro/eclipse"
|
||||
)
|
||||
|
||||
const (
|
||||
lunarEclipseSVGDefaultWidth = 960
|
||||
lunarEclipseSVGDefaultHeight = 620
|
||||
lunarEclipseSVGDefaultZone = 8 * 60 * 60
|
||||
|
||||
lunarEclipseSVGLanguageChinese = "zh"
|
||||
lunarEclipseSVGLanguageEnglish = "en"
|
||||
)
|
||||
|
||||
// LunarEclipseSVGOptions 控制月食穿影 SVG 输出。
|
||||
// LunarEclipseSVGOptions controls lunar eclipse shadow-path SVG output.
|
||||
type LunarEclipseSVGOptions struct {
|
||||
// Width / Height 是 SVG 画布尺寸；<=0 时使用默认尺寸。
|
||||
// Width/Height are SVG canvas size; values <= 0 use defaults.
|
||||
Width int
|
||||
Height int
|
||||
// Step 是月心路径采样步长；<=0 时使用 5 分钟。
|
||||
// Step is the Moon-center path sampling step; values <= 0 use five minutes.
|
||||
Step time.Duration
|
||||
// Title 是图题；为空时自动生成。
|
||||
// Title is the chart title; empty values use an automatic title.
|
||||
Title string
|
||||
// SummaryText 是标题下第一行摘要；为空时自动生成。
|
||||
// SummaryText is the first summary line below the title; empty values use an automatic summary.
|
||||
SummaryText string
|
||||
// MaximumText 是标题下第二行食甚说明；为空时自动生成。
|
||||
// MaximumText is the second line below the title for maximum-eclipse details; empty values use automatic text.
|
||||
MaximumText string
|
||||
// CoordinatesText 是标题下第三行坐标说明；为空时自动生成。
|
||||
// CoordinatesText is the third line below the title for coordinates; empty values use automatic text.
|
||||
CoordinatesText string
|
||||
// DurationText 是标题下第四行历时说明；为空时自动生成。
|
||||
// DurationText is the fourth line below the title for durations; empty values use automatic text.
|
||||
DurationText string
|
||||
// MetaText 是标题下第五行补充说明；为空时自动生成沙罗信息。
|
||||
// MetaText is the fifth line below the title; empty values use automatic Saros text.
|
||||
MetaText string
|
||||
// ContactsTitle 是接触时刻区标题；为空时自动生成。
|
||||
// ContactsTitle is the contacts-panel title; empty values use an automatic title.
|
||||
ContactsTitle string
|
||||
// DirectionText 是底部方向说明；为空时自动生成。
|
||||
// DirectionText is the footer direction note; empty values use an automatic note.
|
||||
DirectionText string
|
||||
// FooterNote 是底部补充说明；为空时自动生成。
|
||||
// FooterNote is the footer explanatory note; empty values use an automatic note.
|
||||
FooterNote string
|
||||
// Language 是标签语言；"en" 使用英文，其他值或空值使用中文。
|
||||
// Language controls label language; "en" uses English, other values or empty values use Chinese.
|
||||
Language string
|
||||
// Location 是图中显示时刻的时区；nil 时使用 UTC+8。
|
||||
// Location is the display timezone for chart times; nil uses UTC+8.
|
||||
Location *time.Location
|
||||
}
|
||||
|
||||
type lunarEclipseSVGCalculator func(float64, basic.LunarEclipseDiagramOptions) basic.LunarEclipseDiagramResult
|
||||
type lunarEclipseSVGFinder func(time.Time) LunarEclipseInfo
|
||||
|
||||
type lunarEclipseSVGLayout struct {
|
||||
width float64
|
||||
height float64
|
||||
cx float64
|
||||
cy float64
|
||||
scale float64
|
||||
diagramLeft float64
|
||||
diagramRight float64
|
||||
panelX float64
|
||||
panelY float64
|
||||
}
|
||||
|
||||
type lunarEclipseSVGPoint struct {
|
||||
basic.LunarEclipseDiagramPoint
|
||||
X float64
|
||||
Y float64
|
||||
}
|
||||
|
||||
type lunarEclipseSVGMaximumCoordinates struct {
|
||||
RA float64
|
||||
Dec float64
|
||||
EclipticLongitude float64
|
||||
EclipticLatitude float64
|
||||
ConstellationCode string
|
||||
ConstellationName string
|
||||
}
|
||||
|
||||
// LunarEclipseSVG 生成月食穿影图 SVG，默认使用 Danjon 影半径模型。
|
||||
// LunarEclipseSVG generates an SVG lunar eclipse shadow-path chart, using the Danjon shadow model by default.
|
||||
func LunarEclipseSVG(date time.Time, options LunarEclipseSVGOptions) (string, bool) {
|
||||
return LunarEclipseSVGDanjon(date, options)
|
||||
}
|
||||
|
||||
// LunarEclipseSVGDanjon 生成月食穿影图 SVG，使用 Danjon 影半径模型。
|
||||
// LunarEclipseSVGDanjon generates an SVG lunar eclipse shadow-path chart with the Danjon shadow model.
|
||||
func LunarEclipseSVGDanjon(date time.Time, options LunarEclipseSVGOptions) (string, bool) {
|
||||
return lunarEclipseSVG(date, options, basic.LunarEclipseDiagramDanjon, eclipsecore.ClosestLunarEclipseDanjon)
|
||||
}
|
||||
|
||||
// LunarEclipseSVGChauvenet 生成月食穿影图 SVG，使用 Chauvenet 影半径模型。
|
||||
// LunarEclipseSVGChauvenet generates an SVG lunar eclipse shadow-path chart with the Chauvenet shadow model.
|
||||
func LunarEclipseSVGChauvenet(date time.Time, options LunarEclipseSVGOptions) (string, bool) {
|
||||
return lunarEclipseSVG(date, options, basic.LunarEclipseDiagramChauvenet, eclipsecore.ClosestLunarEclipseChauvenet)
|
||||
}
|
||||
|
||||
func lunarEclipseSVG(
|
||||
date time.Time,
|
||||
options LunarEclipseSVGOptions,
|
||||
calculator lunarEclipseSVGCalculator,
|
||||
finder lunarEclipseSVGFinder,
|
||||
) (string, bool) {
|
||||
options = normalizeLunarEclipseSVGOptions(options)
|
||||
diagram := calculator(timeToTTJDE(date), basic.LunarEclipseDiagramOptions{
|
||||
StepDays: durationToDays(options.Step),
|
||||
})
|
||||
if diagram.Eclipse.Type == basic.LunarEclipseNone || len(diagram.Points) == 0 {
|
||||
return "", false
|
||||
}
|
||||
info := lunarEclipseInfoFromBasic(diagram.Eclipse, options.Location)
|
||||
if finder != nil {
|
||||
coreInfo := finder(info.Maximum)
|
||||
info.HasSaros = coreInfo.HasSaros
|
||||
info.Saros = coreInfo.Saros
|
||||
}
|
||||
return renderLunarEclipseSVG(info, diagram, options), true
|
||||
}
|
||||
|
||||
func normalizeLunarEclipseSVGOptions(options LunarEclipseSVGOptions) LunarEclipseSVGOptions {
|
||||
if options.Width <= 0 {
|
||||
options.Width = lunarEclipseSVGDefaultWidth
|
||||
}
|
||||
if options.Height <= 0 {
|
||||
options.Height = lunarEclipseSVGDefaultHeight
|
||||
}
|
||||
if options.Location == nil {
|
||||
options.Location = time.FixedZone("UTC+8", lunarEclipseSVGDefaultZone)
|
||||
}
|
||||
if strings.EqualFold(options.Language, lunarEclipseSVGLanguageEnglish) {
|
||||
options.Language = lunarEclipseSVGLanguageEnglish
|
||||
} else {
|
||||
options.Language = lunarEclipseSVGLanguageChinese
|
||||
}
|
||||
return options
|
||||
}
|
||||
|
||||
func renderLunarEclipseSVG(
|
||||
info LunarEclipseInfo,
|
||||
diagram basic.LunarEclipseDiagramResult,
|
||||
options LunarEclipseSVGOptions,
|
||||
) string {
|
||||
headerTexts := lunarEclipseSVGHeaderTexts(info, options)
|
||||
layout := lunarEclipseSVGLayoutFor(diagram, options, lunarEclipseSVGHeaderBottom(headerTexts))
|
||||
points := lunarEclipseSVGPoints(diagram.Points)
|
||||
mapX := func(x float64) float64 { return layout.cx - x*layout.scale }
|
||||
mapY := func(y float64) float64 { return layout.cy - y*layout.scale }
|
||||
title := lunarEclipseSVGTitleText(info, options)
|
||||
|
||||
var b strings.Builder
|
||||
fmt.Fprintf(&b, `<svg xmlns="http://www.w3.org/2000/svg" width="%d" height="%d" viewBox="0 0 %d %d">`, options.Width, options.Height, options.Width, options.Height)
|
||||
b.WriteString(`<defs>`)
|
||||
b.WriteString(lunarEclipseSVGMoonSymbol)
|
||||
b.WriteString(`</defs>`)
|
||||
b.WriteString(`<rect width="100%" height="100%" fill="#efefed"/>`)
|
||||
fmt.Fprintf(&b, `<rect x="22" y="18" width="%.3f" height="%.3f" fill="#ffffff" stroke="#c9c9c6" stroke-width="1.2"/>`,
|
||||
layout.width-44, layout.height-36)
|
||||
fmt.Fprintf(&b, `<text x="%.3f" y="44" fill="#111111" font-family="Georgia, 'Times New Roman', serif" font-size="26" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
layout.width/2, html.EscapeString(title))
|
||||
fmt.Fprintf(&b, `<line x1="%.3f" y1="57" x2="%.3f" y2="57" stroke="#555" stroke-width="1"/>`, layout.width/2-78, layout.width/2+78)
|
||||
writeLunarEclipseSummary(&b, headerTexts, options)
|
||||
fmt.Fprintf(&b, `<circle cx="%.3f" cy="%.3f" r="%.3f" fill="#e9e9e9" stroke="#d6d6d6" stroke-width="1.2"/>`,
|
||||
layout.cx, layout.cy, diagram.PenumbraRadius*layout.scale)
|
||||
fmt.Fprintf(&b, `<circle cx="%.3f" cy="%.3f" r="%.3f" fill="#b21f16" stroke="#83170f" stroke-width="1.3"/>`,
|
||||
layout.cx, layout.cy, diagram.UmbraRadius*layout.scale)
|
||||
writeLunarEclipseShadowLabels(&b, layout, diagram, options.Language)
|
||||
writeLunarEclipseAxes(&b, layout.cx, layout.cy, diagram.PenumbraRadius*layout.scale, options.Language)
|
||||
writeLunarEclipseEclipticLine(&b, layout, diagram, mapX, mapY, options.Language)
|
||||
|
||||
if len(points) > 0 {
|
||||
b.WriteString(`<path d="`)
|
||||
for i, point := range points {
|
||||
if i == 0 {
|
||||
fmt.Fprintf(&b, `M %.3f %.3f`, mapX(point.X), mapY(point.Y))
|
||||
continue
|
||||
}
|
||||
fmt.Fprintf(&b, ` L %.3f %.3f`, mapX(point.X), mapY(point.Y))
|
||||
}
|
||||
b.WriteString(`" fill="none" stroke="#333333" stroke-width="1.1" stroke-dasharray="5 4" stroke-linecap="round" stroke-linejoin="round"/>`)
|
||||
}
|
||||
|
||||
eventPoints := lunarEclipseSVGEventPoints(points)
|
||||
for _, point := range eventPoints {
|
||||
if point.Label == "Greatest" {
|
||||
continue
|
||||
}
|
||||
writeLunarEclipseMoon(&b, point, diagram, mapX(point.X), mapY(point.Y), layout.scale, false)
|
||||
}
|
||||
for _, point := range eventPoints {
|
||||
if point.Label == "Greatest" {
|
||||
writeLunarEclipseMoon(&b, point, diagram, mapX(point.X), mapY(point.Y), layout.scale, true)
|
||||
break
|
||||
}
|
||||
}
|
||||
for _, point := range eventPoints {
|
||||
if point.Label == "" {
|
||||
continue
|
||||
}
|
||||
x := mapX(point.X)
|
||||
y := mapY(point.Y)
|
||||
writeLunarEclipseEventLabel(&b, point.Label, x, y, layout.cx, diagram.MoonRadius*layout.scale, options.Language)
|
||||
}
|
||||
|
||||
writeLunarEclipseContacts(&b, info, options, layout.panelX, layout.panelY)
|
||||
writeLunarEclipseFooter(&b, info, options, layout)
|
||||
|
||||
b.WriteString(`</svg>`)
|
||||
return b.String()
|
||||
}
|
||||
|
||||
func lunarEclipseSVGLayoutFor(
|
||||
diagram basic.LunarEclipseDiagramResult,
|
||||
options LunarEclipseSVGOptions,
|
||||
headerBottom float64,
|
||||
) lunarEclipseSVGLayout {
|
||||
width := float64(options.Width)
|
||||
height := float64(options.Height)
|
||||
margin := math.Max(32, math.Min(48, width*0.05))
|
||||
panelWidth := math.Max(210, math.Min(260, width*0.24))
|
||||
diagramLeft := margin
|
||||
diagramRight := width - panelWidth - 34
|
||||
if diagramRight-diagramLeft < width*0.48 {
|
||||
diagramRight = width - margin
|
||||
}
|
||||
topReserved := math.Max(166, headerBottom+24)
|
||||
bottomReserved := 82.0
|
||||
extent := diagram.PenumbraRadius + diagram.MoonRadius + 0.72
|
||||
scale := math.Min((diagramRight-diagramLeft)/(2*extent), (height-topReserved-bottomReserved)/(2*extent))
|
||||
if scale <= 0 || math.IsNaN(scale) || math.IsInf(scale, 0) {
|
||||
scale = 1
|
||||
}
|
||||
cx := (diagramLeft + diagramRight) / 2
|
||||
cy := topReserved + (height-topReserved-bottomReserved)/2 + 12
|
||||
panelX := diagramRight + 22
|
||||
if panelX+panelWidth > width-margin/2 {
|
||||
panelX = width - panelWidth - margin/2
|
||||
}
|
||||
if panelX < diagramRight {
|
||||
panelX = diagramRight
|
||||
}
|
||||
return lunarEclipseSVGLayout{
|
||||
width: width,
|
||||
height: height,
|
||||
cx: cx,
|
||||
cy: cy,
|
||||
scale: scale,
|
||||
diagramLeft: diagramLeft,
|
||||
diagramRight: diagramRight,
|
||||
panelX: panelX,
|
||||
panelY: math.Max(148, cy-88),
|
||||
}
|
||||
}
|
||||
|
||||
func lunarEclipseSVGTitle(info LunarEclipseInfo, language string) string {
|
||||
return fmt.Sprintf("%s %s", info.Maximum.Format("2006-01-02"), lunarEclipseSVGTypeName(info.Type, language))
|
||||
}
|
||||
|
||||
func lunarEclipseSVGTitleText(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
if options.Title != "" {
|
||||
return options.Title
|
||||
}
|
||||
return lunarEclipseSVGTitle(info, options.Language)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGHeaderTexts(info LunarEclipseInfo, options LunarEclipseSVGOptions) []string {
|
||||
lines := []string{
|
||||
lunarEclipseSVGSummaryText(info, options),
|
||||
lunarEclipseSVGMaximumTextValue(info, options),
|
||||
lunarEclipseSVGCoordinatesTextValue(info, options),
|
||||
lunarEclipseSVGDurationTextValue(info, options),
|
||||
lunarEclipseSVGMetaTextValue(info, options),
|
||||
}
|
||||
filtered := make([]string, 0, len(lines))
|
||||
for _, line := range lines {
|
||||
if line != "" {
|
||||
filtered = append(filtered, line)
|
||||
}
|
||||
}
|
||||
return filtered
|
||||
}
|
||||
|
||||
func lunarEclipseSVGSummaryText(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
if options.SummaryText != "" {
|
||||
return options.SummaryText
|
||||
}
|
||||
return lunarEclipseSVGSummary(info, options.Language)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGMaximumTextValue(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
if options.MaximumText != "" {
|
||||
return options.MaximumText
|
||||
}
|
||||
return lunarEclipseSVGMaximumText(info, options)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGCoordinatesTextValue(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
if options.CoordinatesText != "" {
|
||||
return options.CoordinatesText
|
||||
}
|
||||
coordinates := lunarEclipseSVGMaximumCoordinatesFor(info, options.Language)
|
||||
return lunarEclipseSVGMaximumCoordinatesText(coordinates, options.Language)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGDurationTextValue(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
if options.DurationText != "" {
|
||||
return options.DurationText
|
||||
}
|
||||
return lunarEclipseSVGDurationSummary(info, options.Language)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGMetaTextValue(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
if options.MetaText != "" {
|
||||
return options.MetaText
|
||||
}
|
||||
return lunarEclipseSVGMetaText(info, options.Language)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGContactsTitleText(options LunarEclipseSVGOptions) string {
|
||||
if options.ContactsTitle != "" {
|
||||
return options.ContactsTitle
|
||||
}
|
||||
if options.Language == lunarEclipseSVGLanguageEnglish {
|
||||
return "Contacts"
|
||||
}
|
||||
return "接触时刻"
|
||||
}
|
||||
|
||||
func lunarEclipseSVGDirectionTextValue(options LunarEclipseSVGOptions) string {
|
||||
if options.DirectionText != "" {
|
||||
return options.DirectionText
|
||||
}
|
||||
return lunarEclipseSVGDirectionText(options.Language)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGFooterNoteText(options LunarEclipseSVGOptions) string {
|
||||
if options.FooterNote != "" {
|
||||
return options.FooterNote
|
||||
}
|
||||
note := "图中月面大小和影半径均按实际相对角半径缩放。"
|
||||
if options.Language == lunarEclipseSVGLanguageEnglish {
|
||||
note = "Moon disks and shadow radii are drawn to the same relative angular-radius scale."
|
||||
}
|
||||
return note
|
||||
}
|
||||
|
||||
func lunarEclipseSVGHeaderLineY(index int) float64 {
|
||||
return 84 + float64(index)*22
|
||||
}
|
||||
|
||||
func lunarEclipseSVGHeaderBottom(lines []string) float64 {
|
||||
if len(lines) == 0 {
|
||||
return 72
|
||||
}
|
||||
return lunarEclipseSVGHeaderLineY(len(lines)-1) + 14
|
||||
}
|
||||
|
||||
func lunarEclipseSVGSummary(info LunarEclipseInfo, language string) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
return fmt.Sprintf("type=%s penumbral=%.4f umbral=%.4f",
|
||||
lunarEclipseSVGTypeName(info.Type, language), info.PenumbralMagnitude, info.UmbralMagnitude)
|
||||
}
|
||||
return fmt.Sprintf("食型=%s 半影食分=%.4f 本影食分=%.4f",
|
||||
lunarEclipseSVGTypeName(info.Type, language), info.PenumbralMagnitude, info.UmbralMagnitude)
|
||||
}
|
||||
|
||||
func writeLunarEclipseSummary(b *strings.Builder, lines []string, options LunarEclipseSVGOptions) {
|
||||
for index, line := range lines {
|
||||
fontSize := 13
|
||||
fill := "#333"
|
||||
if index == 0 {
|
||||
fontSize = 14
|
||||
fill = "#222"
|
||||
}
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="%s" font-family="Georgia, 'Times New Roman', serif" font-size="%d" text-anchor="middle">%s</text>`,
|
||||
float64(options.Width)/2, lunarEclipseSVGHeaderLineY(index), fill, fontSize, html.EscapeString(line))
|
||||
}
|
||||
}
|
||||
|
||||
func lunarEclipseSVGDirectionText(language string) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
return "North is up and east is left; the ecliptic is projected near greatest eclipse."
|
||||
}
|
||||
return "上北下南，左东右西；黄道按食甚附近天球投影绘制。"
|
||||
}
|
||||
|
||||
func lunarEclipseSVGMaximumText(info LunarEclipseInfo, options LunarEclipseSVGOptions) string {
|
||||
maximum := info.Maximum.In(options.Location).Format("2006-01-02 15:04:05 MST")
|
||||
if options.Language == lunarEclipseSVGLanguageEnglish {
|
||||
return "Maximum: " + maximum
|
||||
}
|
||||
return "食甚：" + maximum
|
||||
}
|
||||
|
||||
func lunarEclipseSVGMaximumCoordinatesFor(
|
||||
info LunarEclipseInfo,
|
||||
language string,
|
||||
) lunarEclipseSVGMaximumCoordinates {
|
||||
jde := timeToTTJDE(info.Maximum)
|
||||
ra, dec := basic.HMoonTrueRaDec(jde)
|
||||
lon := basic.HMoonApparentLo(jde)
|
||||
lat := basic.HMoonTrueBo(jde)
|
||||
code := basic.ConstellationCode(ra, dec, jde)
|
||||
name := basic.ConstellationNameByCodeZH(code)
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
name = basic.ConstellationNameByCodeEN(code)
|
||||
}
|
||||
return lunarEclipseSVGMaximumCoordinates{
|
||||
RA: ra,
|
||||
Dec: dec,
|
||||
EclipticLongitude: lon,
|
||||
EclipticLatitude: lat,
|
||||
ConstellationCode: code,
|
||||
ConstellationName: name,
|
||||
}
|
||||
}
|
||||
|
||||
func lunarEclipseSVGMaximumCoordinatesText(
|
||||
coordinates lunarEclipseSVGMaximumCoordinates,
|
||||
language string,
|
||||
) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
return fmt.Sprintf("Moon: RA %s Dec %s ecl.lon %.4f deg ecl.lat %.4f deg %s",
|
||||
lunarEclipseSVGFormatRA(coordinates.RA),
|
||||
lunarEclipseSVGFormatSignedAngle(coordinates.Dec),
|
||||
coordinates.EclipticLongitude,
|
||||
coordinates.EclipticLatitude,
|
||||
coordinates.ConstellationName,
|
||||
)
|
||||
}
|
||||
return fmt.Sprintf("月球：赤经 %s 赤纬 %s 黄经 %.4f° 黄纬 %.4f° %s",
|
||||
lunarEclipseSVGFormatRA(coordinates.RA),
|
||||
lunarEclipseSVGFormatSignedAngle(coordinates.Dec),
|
||||
coordinates.EclipticLongitude,
|
||||
coordinates.EclipticLatitude,
|
||||
coordinates.ConstellationName,
|
||||
)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGFormatRA(degree float64) string {
|
||||
totalSeconds := int(math.Round(normalizeDegree360(degree) / 15 * 3600))
|
||||
totalSeconds %= 24 * 3600
|
||||
hours := totalSeconds / 3600
|
||||
minutes := totalSeconds % 3600 / 60
|
||||
seconds := totalSeconds % 60
|
||||
return fmt.Sprintf("%02dh%02dm%02ds", hours, minutes, seconds)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGFormatSignedAngle(degree float64) string {
|
||||
sign := "+"
|
||||
if degree < 0 {
|
||||
sign = "-"
|
||||
degree = -degree
|
||||
}
|
||||
totalSeconds := int(math.Round(degree * 3600))
|
||||
degrees := totalSeconds / 3600
|
||||
minutes := totalSeconds % 3600 / 60
|
||||
seconds := totalSeconds % 60
|
||||
return fmt.Sprintf("%s%02d°%02d′%02d″", sign, degrees, minutes, seconds)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGDurationSummary(info LunarEclipseInfo, language string) string {
|
||||
penumbral := lunarEclipseSVGFormatDuration(info.PenumbralEnd.Sub(info.PenumbralStart))
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
parts := []string{"Penumbral duration " + penumbral}
|
||||
if info.HasPartial {
|
||||
parts = append(parts, "Umbral duration "+lunarEclipseSVGFormatDuration(info.PartialEnd.Sub(info.PartialStart)))
|
||||
}
|
||||
if info.HasTotal {
|
||||
parts = append(parts, "Total duration "+lunarEclipseSVGFormatDuration(info.TotalEnd.Sub(info.TotalStart)))
|
||||
}
|
||||
return strings.Join(parts, " ")
|
||||
}
|
||||
parts := []string{"半影历时 " + penumbral}
|
||||
if info.HasPartial {
|
||||
parts = append(parts, "本影历时 "+lunarEclipseSVGFormatDuration(info.PartialEnd.Sub(info.PartialStart)))
|
||||
}
|
||||
if info.HasTotal {
|
||||
parts = append(parts, "全食历时 "+lunarEclipseSVGFormatDuration(info.TotalEnd.Sub(info.TotalStart)))
|
||||
}
|
||||
return strings.Join(parts, " ")
|
||||
}
|
||||
|
||||
func lunarEclipseSVGMetaText(info LunarEclipseInfo, language string) string {
|
||||
if !info.HasSaros {
|
||||
return ""
|
||||
}
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
return fmt.Sprintf("Lunar Saros %d %d/%d", info.Saros.Series, info.Saros.Member, info.Saros.Count)
|
||||
}
|
||||
return fmt.Sprintf("沙罗 %d 第 %d/%d 个成员", info.Saros.Series, info.Saros.Member, info.Saros.Count)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGFormatDuration(duration time.Duration) string {
|
||||
if duration < 0 {
|
||||
duration = -duration
|
||||
}
|
||||
totalSeconds := int(duration.Round(time.Second).Seconds())
|
||||
hours := totalSeconds / 3600
|
||||
minutes := totalSeconds % 3600 / 60
|
||||
seconds := totalSeconds % 60
|
||||
return fmt.Sprintf("%02d:%02d:%02d", hours, minutes, seconds)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGTypeName(eclipseType LunarEclipseType, language string) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
switch eclipseType {
|
||||
case LunarEclipsePenumbral:
|
||||
return "Penumbral Lunar Eclipse"
|
||||
case LunarEclipsePartial:
|
||||
return "Partial Lunar Eclipse"
|
||||
case LunarEclipseTotal:
|
||||
return "Total Lunar Eclipse"
|
||||
default:
|
||||
return "No Lunar Eclipse"
|
||||
}
|
||||
}
|
||||
switch eclipseType {
|
||||
case LunarEclipsePenumbral:
|
||||
return "半影月食"
|
||||
case LunarEclipsePartial:
|
||||
return "月偏食"
|
||||
case LunarEclipseTotal:
|
||||
return "月全食"
|
||||
default:
|
||||
return "无月食"
|
||||
}
|
||||
}
|
||||
|
||||
func writeLunarEclipseAxes(b *strings.Builder, cx, cy, radius float64, language string) {
|
||||
north, east, west, south := "北", "东", "西", "南"
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
north, east, west, south = "N", "E", "W", "S"
|
||||
}
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#111" font-family="Georgia, 'Times New Roman', serif" font-size="14" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
cx, cy-radius-18, html.EscapeString(north))
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#111" font-family="Georgia, 'Times New Roman', serif" font-size="14" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
cx-radius-22, cy+4, html.EscapeString(east))
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#111" font-family="Georgia, 'Times New Roman', serif" font-size="14" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
cx+radius+22, cy+4, html.EscapeString(west))
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#111" font-family="Georgia, 'Times New Roman', serif" font-size="14" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
cx, cy+radius+28, html.EscapeString(south))
|
||||
}
|
||||
|
||||
func lunarEclipseSVGPoints(points []basic.LunarEclipseDiagramPoint) []lunarEclipseSVGPoint {
|
||||
result := make([]lunarEclipseSVGPoint, 0, len(points))
|
||||
for _, point := range points {
|
||||
distance := math.Hypot(point.X, point.Y)
|
||||
positionAngleRad := lunarEclipseMoonCenterPositionAngle(point.JDE) * math.Pi / 180
|
||||
result = append(result, lunarEclipseSVGPoint{
|
||||
LunarEclipseDiagramPoint: point,
|
||||
X: distance * math.Sin(positionAngleRad),
|
||||
Y: distance * math.Cos(positionAngleRad),
|
||||
})
|
||||
}
|
||||
return result
|
||||
}
|
||||
|
||||
func writeLunarEclipseEclipticLine(
|
||||
b *strings.Builder,
|
||||
layout lunarEclipseSVGLayout,
|
||||
diagram basic.LunarEclipseDiagramResult,
|
||||
mapX, mapY func(float64) float64,
|
||||
language string,
|
||||
) {
|
||||
unitX, unitY, ok := lunarEclipseSVGEclipticDirection(diagram.Eclipse.Maximum)
|
||||
if !ok {
|
||||
return
|
||||
}
|
||||
|
||||
extent := (diagram.PenumbraRadius + diagram.MoonRadius) * 1.42
|
||||
screenStartX := mapX(-unitX * extent)
|
||||
screenStartY := mapY(-unitY * extent)
|
||||
screenEndX := mapX(unitX * extent)
|
||||
screenEndY := mapY(unitY * extent)
|
||||
if math.IsNaN(screenStartX) || math.IsNaN(screenStartY) || math.IsNaN(screenEndX) || math.IsNaN(screenEndY) {
|
||||
return
|
||||
}
|
||||
|
||||
fmt.Fprintf(b, `<line x1="%.3f" y1="%.3f" x2="%.3f" y2="%.3f" stroke="#555" stroke-width="1" stroke-dasharray="4 3" opacity="0.82"/>`,
|
||||
screenStartX, screenStartY, screenEndX, screenEndY)
|
||||
|
||||
labelX := screenStartX
|
||||
labelY := screenStartY
|
||||
anchor := "end"
|
||||
if screenEndX < screenStartX {
|
||||
labelX = screenEndX
|
||||
labelY = screenEndY
|
||||
}
|
||||
labelX -= 8
|
||||
if labelX < layout.diagramLeft+18 {
|
||||
labelX += 16
|
||||
anchor = "start"
|
||||
}
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#444" font-family="Georgia, 'Times New Roman', serif" font-size="12" text-anchor="%s">%s</text>`,
|
||||
labelX, labelY+4, anchor, html.EscapeString(lunarEclipseSVGLabelEcliptic(language)))
|
||||
}
|
||||
|
||||
func lunarEclipseSVGEclipticDirection(ttJDE float64) (float64, float64, bool) {
|
||||
originRA, originDec := lunarEclipseShadowCenterRaDec(ttJDE)
|
||||
centerLongitude := normalizeDegree360(basic.HSunApparentLo(ttJDE) + 180)
|
||||
ra1, dec1 := basic.LoBoToRaDec(ttJDE, centerLongitude-1, 0)
|
||||
ra2, dec2 := basic.LoBoToRaDec(ttJDE, centerLongitude+1, 0)
|
||||
x1, y1 := lunarEclipseSVGTangentOffset(originRA, originDec, ra1, dec1)
|
||||
x2, y2 := lunarEclipseSVGTangentOffset(originRA, originDec, ra2, dec2)
|
||||
dx := x2 - x1
|
||||
dy := y2 - y1
|
||||
length := math.Hypot(dx, dy)
|
||||
if length == 0 || math.IsNaN(length) || math.IsInf(length, 0) {
|
||||
return 0, 0, false
|
||||
}
|
||||
return dx / length, dy / length, true
|
||||
}
|
||||
|
||||
func lunarEclipseSVGTangentOffset(originRA, originDec, targetRA, targetDec float64) (float64, float64) {
|
||||
separation := lunarEclipseSVGAngularSeparation(originRA, originDec, targetRA, targetDec)
|
||||
positionAngleRad := lunarEclipsePositionAngle(originRA, originDec, targetRA, targetDec) * math.Pi / 180
|
||||
return separation * math.Sin(positionAngleRad), separation * math.Cos(positionAngleRad)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGAngularSeparation(ra1, dec1, ra2, dec2 float64) float64 {
|
||||
ra1Rad := ra1 * math.Pi / 180
|
||||
dec1Rad := dec1 * math.Pi / 180
|
||||
ra2Rad := ra2 * math.Pi / 180
|
||||
dec2Rad := dec2 * math.Pi / 180
|
||||
cosDistance := math.Sin(dec1Rad)*math.Sin(dec2Rad) +
|
||||
math.Cos(dec1Rad)*math.Cos(dec2Rad)*math.Cos(ra2Rad-ra1Rad)
|
||||
if cosDistance > 1 {
|
||||
cosDistance = 1
|
||||
}
|
||||
if cosDistance < -1 {
|
||||
cosDistance = -1
|
||||
}
|
||||
return math.Acos(cosDistance) * 180 / math.Pi
|
||||
}
|
||||
|
||||
func lunarEclipseSVGLabelEcliptic(language string) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
return "Ecliptic"
|
||||
}
|
||||
return "黄道"
|
||||
}
|
||||
|
||||
func writeLunarEclipseShadowLabels(
|
||||
b *strings.Builder,
|
||||
layout lunarEclipseSVGLayout,
|
||||
diagram basic.LunarEclipseDiagramResult,
|
||||
language string,
|
||||
) {
|
||||
penumbraLabel, umbraLabel := "地球半影", "地球本影"
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
penumbraLabel, umbraLabel = "Earth's Penumbra", "Earth's Umbra"
|
||||
}
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#333" font-family="Georgia, 'Times New Roman', serif" font-size="13" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
layout.cx, layout.cy-diagram.PenumbraRadius*layout.scale+28, html.EscapeString(penumbraLabel))
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#111" font-family="Georgia, 'Times New Roman', serif" font-size="13" font-weight="700" text-anchor="middle">%s</text>`,
|
||||
layout.cx, layout.cy-diagram.UmbraRadius*layout.scale+22, html.EscapeString(umbraLabel))
|
||||
}
|
||||
|
||||
func lunarEclipseSVGEventPoints(points []lunarEclipseSVGPoint) []lunarEclipseSVGPoint {
|
||||
events := make([]lunarEclipseSVGPoint, 0, 7)
|
||||
for _, point := range points {
|
||||
for _, label := range lunarEclipseSVGPointLabels(point) {
|
||||
event := point
|
||||
event.Label = label
|
||||
event.Labels = []string{label}
|
||||
events = append(events, event)
|
||||
}
|
||||
}
|
||||
return events
|
||||
}
|
||||
|
||||
func lunarEclipseSVGPointLabels(point lunarEclipseSVGPoint) []string {
|
||||
if len(point.Labels) > 0 {
|
||||
return point.Labels
|
||||
}
|
||||
if point.Label == "" {
|
||||
return nil
|
||||
}
|
||||
return []string{point.Label}
|
||||
}
|
||||
|
||||
func writeLunarEclipseMoon(
|
||||
b *strings.Builder,
|
||||
point lunarEclipseSVGPoint,
|
||||
diagram basic.LunarEclipseDiagramResult,
|
||||
x, y, scale float64,
|
||||
greatest bool,
|
||||
) {
|
||||
radius := diagram.MoonRadius * scale
|
||||
opacity := 0.64
|
||||
if greatest {
|
||||
opacity = 0.9
|
||||
}
|
||||
fmt.Fprintf(b, `<g class="event-moon">`)
|
||||
fmt.Fprintf(b, `<use href="#le-moon" x="%.3f" y="%.3f" width="%.3f" height="%.3f" opacity="%.2f"/>`,
|
||||
x-radius, y-radius, radius*2, radius*2, opacity)
|
||||
if lunarEclipseSVGDeepUmbra(point.LunarEclipseDiagramPoint, diagram) {
|
||||
tintOpacity := 0.46
|
||||
if greatest {
|
||||
tintOpacity = 0.58
|
||||
}
|
||||
fmt.Fprintf(b, `<circle cx="%.3f" cy="%.3f" r="%.3f" fill="#d66f1f" opacity="%.2f"/>`,
|
||||
x, y, radius, tintOpacity)
|
||||
}
|
||||
fmt.Fprintf(b, `<circle cx="%.3f" cy="%.3f" r="%.3f" fill="none" stroke="#b9b9b9" stroke-width="0.8" opacity="0.9"/>`, x, y, radius)
|
||||
b.WriteString(`</g>`)
|
||||
}
|
||||
|
||||
func lunarEclipseSVGDeepUmbra(point basic.LunarEclipseDiagramPoint, diagram basic.LunarEclipseDiagramResult) bool {
|
||||
return math.Hypot(point.X, point.Y) < diagram.UmbraRadius+diagram.MoonRadius*0.75
|
||||
}
|
||||
|
||||
func writeLunarEclipseEventLabel(
|
||||
b *strings.Builder,
|
||||
label string,
|
||||
x, y, cx, moonRadius float64,
|
||||
language string,
|
||||
) {
|
||||
text := lunarEclipseSVGEventName(label, language)
|
||||
dx := moonRadius*0.72 + 6
|
||||
anchor := "start"
|
||||
if x < cx {
|
||||
dx = -dx
|
||||
anchor = "end"
|
||||
}
|
||||
dy := -moonRadius*0.35 - 4
|
||||
if label == "Greatest" {
|
||||
dy = moonRadius + 15
|
||||
anchor = "middle"
|
||||
dx = 0
|
||||
}
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#2554c7" font-family="Georgia, 'Times New Roman', serif" font-size="12" text-anchor="%s">%s</text>`,
|
||||
x+dx, y+dy, anchor, html.EscapeString(text))
|
||||
}
|
||||
|
||||
func lunarEclipseSVGEventName(label, language string) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
switch label {
|
||||
case "Greatest":
|
||||
return "Greatest"
|
||||
default:
|
||||
return label
|
||||
}
|
||||
}
|
||||
switch label {
|
||||
case "P1":
|
||||
return "P1 半影始"
|
||||
case "U1":
|
||||
return "U1 初亏"
|
||||
case "U2":
|
||||
return "U2 食既"
|
||||
case "Greatest":
|
||||
return "食甚"
|
||||
case "U3":
|
||||
return "U3 生光"
|
||||
case "U4":
|
||||
return "U4 复圆"
|
||||
case "P4":
|
||||
return "P4 半影终"
|
||||
default:
|
||||
return label
|
||||
}
|
||||
}
|
||||
|
||||
type lunarEclipseSVGContact struct {
|
||||
label string
|
||||
name string
|
||||
time time.Time
|
||||
angle float64
|
||||
hasAngle bool
|
||||
}
|
||||
|
||||
func writeLunarEclipseContacts(
|
||||
b *strings.Builder,
|
||||
info LunarEclipseInfo,
|
||||
options LunarEclipseSVGOptions,
|
||||
x, y float64,
|
||||
) {
|
||||
contacts := lunarEclipseSVGContacts(info, options.Language)
|
||||
if len(contacts) == 0 {
|
||||
return
|
||||
}
|
||||
title := lunarEclipseSVGContactsTitleText(options)
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#111" font-family="Georgia, 'Times New Roman', serif" font-size="13" font-weight="700">%s (%s)</text>`,
|
||||
x, y, html.EscapeString(title), html.EscapeString(options.Location.String()))
|
||||
for index, contact := range contacts {
|
||||
line := fmt.Sprintf("%s %s %s", contact.label, contact.name, contact.time.In(options.Location).Format("15:04:05"))
|
||||
if contact.hasAngle {
|
||||
if options.Language == lunarEclipseSVGLanguageEnglish {
|
||||
line = fmt.Sprintf("%s PA %.1f°", line, contact.angle)
|
||||
} else {
|
||||
line = fmt.Sprintf("%s 方位 %.1f°", line, contact.angle)
|
||||
}
|
||||
}
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#222" font-family="Georgia, 'Times New Roman', serif" font-size="12">%s</text>`,
|
||||
x, y+float64(index+1)*18, html.EscapeString(line))
|
||||
}
|
||||
}
|
||||
|
||||
func writeLunarEclipseFooter(
|
||||
b *strings.Builder,
|
||||
info LunarEclipseInfo,
|
||||
options LunarEclipseSVGOptions,
|
||||
layout lunarEclipseSVGLayout,
|
||||
) {
|
||||
_ = info
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#333" font-family="Georgia, 'Times New Roman', serif" font-size="12">%s</text>`,
|
||||
40.0, layout.height-54, html.EscapeString(lunarEclipseSVGDirectionTextValue(options)))
|
||||
note := lunarEclipseSVGFooterNoteText(options)
|
||||
fmt.Fprintf(b, `<text x="%.3f" y="%.3f" fill="#555" font-family="Georgia, 'Times New Roman', serif" font-size="12">%s</text>`,
|
||||
40.0, layout.height-34, html.EscapeString(note))
|
||||
}
|
||||
|
||||
func lunarEclipseSVGContacts(info LunarEclipseInfo, language string) []lunarEclipseSVGContact {
|
||||
angles := lunarEclipseContactAngleMap(info.ContactPoints)
|
||||
contacts := []lunarEclipseSVGContact{
|
||||
lunarEclipseSVGContactFor("P1", lunarEclipseSVGContactName("P1", language), info.PenumbralStart, angles),
|
||||
}
|
||||
if info.HasPartial {
|
||||
contacts = append(contacts, lunarEclipseSVGContactFor("U1", lunarEclipseSVGContactName("U1", language), info.PartialStart, angles))
|
||||
}
|
||||
if info.HasTotal {
|
||||
contacts = append(contacts, lunarEclipseSVGContactFor("U2", lunarEclipseSVGContactName("U2", language), info.TotalStart, angles))
|
||||
}
|
||||
contacts = append(contacts, lunarEclipseSVGContact{label: "GE", name: lunarEclipseSVGContactName("Greatest", language), time: info.Maximum})
|
||||
if info.HasTotal {
|
||||
contacts = append(contacts, lunarEclipseSVGContactFor("U3", lunarEclipseSVGContactName("U3", language), info.TotalEnd, angles))
|
||||
}
|
||||
if info.HasPartial {
|
||||
contacts = append(contacts, lunarEclipseSVGContactFor("U4", lunarEclipseSVGContactName("U4", language), info.PartialEnd, angles))
|
||||
}
|
||||
contacts = append(contacts, lunarEclipseSVGContactFor("P4", lunarEclipseSVGContactName("P4", language), info.PenumbralEnd, angles))
|
||||
return contacts
|
||||
}
|
||||
|
||||
func lunarEclipseSVGContactFor(
|
||||
label, name string,
|
||||
time time.Time,
|
||||
angles map[string]float64,
|
||||
) lunarEclipseSVGContact {
|
||||
angle, ok := angles[label]
|
||||
return lunarEclipseSVGContact{
|
||||
label: label,
|
||||
name: name,
|
||||
time: time,
|
||||
angle: angle,
|
||||
hasAngle: ok,
|
||||
}
|
||||
}
|
||||
|
||||
func lunarEclipseContactAngleMap(points []LunarEclipseContactPoint) map[string]float64 {
|
||||
angles := make(map[string]float64, len(points))
|
||||
for _, point := range points {
|
||||
angles[point.Label] = point.ContactPositionAngle
|
||||
}
|
||||
return angles
|
||||
}
|
||||
|
||||
func lunarEclipseSVGContactName(label, language string) string {
|
||||
if language == lunarEclipseSVGLanguageEnglish {
|
||||
switch label {
|
||||
case "P1":
|
||||
return "Penumbral begins"
|
||||
case "U1":
|
||||
return "Partial begins"
|
||||
case "U2":
|
||||
return "Total begins"
|
||||
case "Greatest":
|
||||
return "Greatest"
|
||||
case "U3":
|
||||
return "Total ends"
|
||||
case "U4":
|
||||
return "Partial ends"
|
||||
case "P4":
|
||||
return "Penumbral ends"
|
||||
default:
|
||||
return label
|
||||
}
|
||||
}
|
||||
switch label {
|
||||
case "P1":
|
||||
return "半影始"
|
||||
case "U1":
|
||||
return "初亏"
|
||||
case "U2":
|
||||
return "食既"
|
||||
case "Greatest":
|
||||
return "食甚"
|
||||
case "U3":
|
||||
return "生光"
|
||||
case "U4":
|
||||
return "复圆"
|
||||
case "P4":
|
||||
return "半影终"
|
||||
default:
|
||||
return label
|
||||
}
|
||||
}
|
||||
|
||||
func durationToDays(duration time.Duration) float64 {
|
||||
if duration <= 0 {
|
||||
return 0
|
||||
}
|
||||
return duration.Hours() / 24
|
||||
}
|
||||
Reference in New Issue
Block a user