package svg
import (
"errors"
"fmt"
"html"
"math"
"strings"
"time"
"b612.me/astro/internal/svgmap"
"b612.me/astro/moon"
)
// ErrInvalidPlanetOccultationPath 表示有限盘面路径数据格式错误。
// ErrInvalidPlanetOccultationPath reports malformed finite-disk path data.
var ErrInvalidPlanetOccultationPath = errors.New("invalid planetary occultation path")
// ErrInvalidPlanetOccultationSVGOptions 表示行星 SVG 画布选项无效。
// ErrInvalidPlanetOccultationSVGOptions reports invalid planetary SVG canvas options.
var ErrInvalidPlanetOccultationSVGOptions = errors.New("invalid planetary occultation SVG options")
const (
planetOccultationSVGMinimumWidth = 640
planetOccultationSVGMinimumHeight = 480
)
// PlanetOccultationSVGOptions 控制全球行星月掩路径 SVG。
// PlanetOccultationSVGOptions controls a global planetary-occultation path SVG.
type PlanetOccultationSVGOptions = StarOccultationSVGOptions
// FindPlanetOccultationSVGs 搜索时间窗口并渲染每条全球有限盘面行星月掩路径。
// FindPlanetOccultationSVGs searches a time window and renders every global finite-disk planetary occultation path.
func FindPlanetOccultationSVGs(
start, end time.Time,
planet moon.OccultationPlanet,
pathOptions moon.OccultationPathOptions,
options PlanetOccultationSVGOptions,
) ([]string, error) {
paths, err := moon.FindPlanetOccultationPaths(start, end, planet, pathOptions)
if err != nil {
return nil, err
}
diagrams := make([]string, 0, len(paths))
for _, path := range paths {
diagram, renderErr := PlanetOccultationPathSVG(path, options)
if renderErr != nil {
return nil, renderErr
}
diagrams = append(diagrams, diagram)
}
return diagrams, nil
}
// PlanetOccultationPathSVG 渲染已计算的有限盘面行星路径。
// PlanetOccultationPathSVG renders a computed finite-disk planetary path.
func PlanetOccultationPathSVG(
path moon.PlanetOccultationPath,
options PlanetOccultationSVGOptions,
) (string, error) {
if err := validatePlanetOccultationPath(path); err != nil {
return "", err
}
targetID := path.TargetID
if targetID == "" {
targetID = path.Planet.String()
}
if err := validateStarOccultationSVGOptions(options); err != nil {
return "", fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationSVGOptions, err)
}
if options.Width > 0 && options.Width < planetOccultationSVGMinimumWidth {
return "", fmt.Errorf("%w: width must be zero or at least %d", ErrInvalidPlanetOccultationSVGOptions, planetOccultationSVGMinimumWidth)
}
if options.Height > 0 && options.Height < planetOccultationSVGMinimumHeight {
return "", fmt.Errorf("%w: height must be zero or at least %d", ErrInvalidPlanetOccultationSVGOptions, planetOccultationSVGMinimumHeight)
}
options = normalizeStarOccultationSVGOptions(options)
starShape := planetOccultationStarShape(path, targetID)
if targetID == path.Planet.String() && options.Language == starOccultationSVGLanguageChinese {
targetID = planetOccultationChineseName(path.Planet)
starShape.TargetID = targetID
}
options.Projection = MapProjection(resolvePlanetOccultationMapProjection(path, options.Projection))
options = planetOccultationSVGDefaults(path, options)
return renderOccultationPathSVG(starShape, &path, options), nil
}
func resolvePlanetOccultationMapProjection(
path moon.PlanetOccultationPath,
requested MapProjection,
) svgmap.Projection {
minimumLatitude := path.Greatest.Latitude
maximumLatitude := path.Greatest.Latitude
for _, series := range [][]moon.OccultationPathPoint{
path.CenterLine, path.NorthernLimit, path.SouthernLimit,
path.NorthernTotalLimit, path.SouthernTotalLimit,
} {
for _, point := range series {
minimumLatitude = math.Min(minimumLatitude, point.Latitude)
maximumLatitude = math.Max(maximumLatitude, point.Latitude)
}
}
for _, footprints := range [][]moon.PlanetOccultationFootprint{path.PartialFootprints, path.TotalFootprints} {
for _, footprint := range footprints {
for _, polygon := range footprint.Polygons {
for _, point := range polygon {
minimumLatitude = math.Min(minimumLatitude, point.Latitude)
maximumLatitude = math.Max(maximumLatitude, point.Latitude)
}
}
}
}
return svgmap.ResolveProjection(internalMapProjection(requested), path.Greatest.Latitude, minimumLatitude, maximumLatitude)
}
func planetOccultationStarShape(path moon.PlanetOccultationPath, targetID string) moon.StarOccultationPath {
return moon.StarOccultationPath{
TargetID: targetID,
Start: path.Start,
Greatest: path.Greatest,
End: path.End,
Complete: path.Complete,
CenterLine: path.CenterLine,
NorthernLimit: path.NorthernLimit,
SouthernLimit: path.SouthernLimit,
Step: path.Step,
TargetSpacingKM: path.TargetSpacingKM,
}
}
func validatePlanetOccultationPath(path moon.PlanetOccultationPath) error {
if err := path.Planet.Validate(); err != nil {
return fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationPath, err)
}
if err := validateStarOccultationPath(planetOccultationStarShape(path, path.TargetID)); err != nil {
return fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationPath, err)
}
if !path.HasTotalBand {
if path.TotalComplete || !path.TotalStart.Time.IsZero() || !path.TotalEnd.Time.IsZero() ||
len(path.NorthernTotalLimit) != 0 || len(path.SouthernTotalLimit) != 0 ||
len(path.TotalFootprints) != 0 || path.GreatestTotalWidthKM != 0 {
return fmt.Errorf("%w: total-band fields require HasTotalBand", ErrInvalidPlanetOccultationPath)
}
return validatePlanetOccultationFootprints("partial", path.PartialFootprints, path.Start.Time, path.End.Time)
}
if !path.TotalComplete {
return fmt.Errorf("%w: global total-occultation band is incomplete", ErrInvalidPlanetOccultationPath)
}
if err := validateStarOccultationPathPoint("total start", path.TotalStart); err != nil {
return fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationPath, err)
}
if err := validateStarOccultationPathPoint("total end", path.TotalEnd); err != nil {
return fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationPath, err)
}
if !path.TotalStart.Time.After(path.Start.Time) || !path.TotalStart.Time.Before(path.Greatest.Time) ||
!path.TotalEnd.Time.After(path.Greatest.Time) || !path.TotalEnd.Time.Before(path.End.Time) {
return fmt.Errorf("%w: total-band times must be inside outer start, greatest, and end", ErrInvalidPlanetOccultationPath)
}
if !starOccultationFinite(path.GreatestTotalWidthKM) || path.GreatestTotalWidthKM <= 0 ||
path.GreatestTotalWidthKM >= path.Greatest.WidthKM {
return fmt.Errorf("%w: total-band width must be positive and narrower than the outer band", ErrInvalidPlanetOccultationPath)
}
if err := validatePlanetOccultationTotalLimits(path); err != nil {
return err
}
if err := validatePlanetOccultationFootprints("partial", path.PartialFootprints, path.Start.Time, path.End.Time); err != nil {
return err
}
if err := validatePlanetOccultationFootprints("total", path.TotalFootprints, path.TotalStart.Time, path.TotalEnd.Time); err != nil {
return err
}
return nil
}
func validatePlanetOccultationFootprints(
name string,
footprints []moon.PlanetOccultationFootprint,
start, end time.Time,
) error {
for footprintIndex, footprint := range footprints {
if footprint.Time.Before(start) || footprint.Time.After(end) {
return fmt.Errorf("%w: %s footprint[%d] time must be inside its contact interval",
ErrInvalidPlanetOccultationPath, name, footprintIndex)
}
if footprintIndex > 0 && !footprint.Time.After(footprints[footprintIndex-1].Time) {
return fmt.Errorf("%w: %s footprint times must be strictly increasing",
ErrInvalidPlanetOccultationPath, name)
}
if len(footprint.Polygons) == 0 {
return fmt.Errorf("%w: %s footprint[%d] must contain a polygon",
ErrInvalidPlanetOccultationPath, name, footprintIndex)
}
for polygonIndex, polygon := range footprint.Polygons {
if len(polygon) < 3 {
return fmt.Errorf("%w: %s footprint[%d].polygon[%d] must contain at least three points",
ErrInvalidPlanetOccultationPath, name, footprintIndex, polygonIndex)
}
for pointIndex, point := range polygon {
pointName := fmt.Sprintf("%s footprint[%d].polygon[%d][%d]", name, footprintIndex, polygonIndex, pointIndex)
if err := validateStarOccultationPathPoint(pointName, point); err != nil {
return fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationPath, err)
}
if !point.Time.Equal(footprint.Time) {
return fmt.Errorf("%w: %s time must match its footprint", ErrInvalidPlanetOccultationPath, pointName)
}
}
}
}
return nil
}
func validatePlanetOccultationTotalLimits(path moon.PlanetOccultationPath) error {
if len(path.NorthernTotalLimit) != len(path.SouthernTotalLimit) || len(path.NorthernTotalLimit) < 2 {
return fmt.Errorf("%w: total northern and southern limits must contain matching samples", ErrInvalidPlanetOccultationPath)
}
for index := range path.NorthernTotalLimit {
for _, item := range []struct {
name string
point moon.OccultationPathPoint
}{
{fmt.Sprintf("northern total limit[%d]", index), path.NorthernTotalLimit[index]},
{fmt.Sprintf("southern total limit[%d]", index), path.SouthernTotalLimit[index]},
} {
if err := validateStarOccultationPathPoint(item.name, item.point); err != nil {
return fmt.Errorf("%w: %v", ErrInvalidPlanetOccultationPath, err)
}
}
if !path.NorthernTotalLimit[index].Time.Equal(path.SouthernTotalLimit[index].Time) {
return fmt.Errorf("%w: total limit sample %d times must match", ErrInvalidPlanetOccultationPath, index)
}
if index > 0 && !path.NorthernTotalLimit[index].Time.After(path.NorthernTotalLimit[index-1].Time) {
return fmt.Errorf("%w: total limit times must be strictly increasing", ErrInvalidPlanetOccultationPath)
}
}
last := len(path.NorthernTotalLimit) - 1
if !path.NorthernTotalLimit[0].Time.Equal(path.TotalStart.Time) || !path.SouthernTotalLimit[0].Time.Equal(path.TotalStart.Time) ||
!path.NorthernTotalLimit[last].Time.Equal(path.TotalEnd.Time) || !path.SouthernTotalLimit[last].Time.Equal(path.TotalEnd.Time) {
return fmt.Errorf("%w: total limits must span total start through total end", ErrInvalidPlanetOccultationPath)
}
return nil
}
func planetOccultationSVGDefaults(
path moon.PlanetOccultationPath,
options PlanetOccultationSVGOptions,
) PlanetOccultationSVGOptions {
if options.SummaryText == "" {
options.SummaryText = planetOccultationSVGSummaryText(path, options)
}
if options.GreatestText == "" {
options.GreatestText = planetOccultationSVGGreatestText(path, options.Language)
}
if options.MapTitle == "" {
if options.Language == starOccultationSVGLanguageEnglish {
options.MapTitle = "Global partial- and total-occultation bands"
} else {
options.MapTitle = "全球部分掩带与全掩带"
}
}
if options.ContactsTitle == "" {
if options.Language == starOccultationSVGLanguageEnglish {
options.ContactsTitle = "Global phases"
} else {
options.ContactsTitle = "全球阶段"
}
}
if options.FooterNote == "" {
options.FooterNote = planetOccultationSVGFooter(path, options)
}
return options
}
func planetOccultationSVGSummaryText(path moon.PlanetOccultationPath, options PlanetOccultationSVGOptions) string {
start := path.Start.Time.In(options.Location)
greatest := path.Greatest.Time.In(options.Location)
end := path.End.Time.In(options.Location)
zone := starOccultationLocationLabel(greatest, options.Location)
if !path.HasTotalBand {
if options.Language == starOccultationSVGLanguageEnglish {
return fmt.Sprintf("Partial begins %s | Greatest %s | Partial ends %s (%s)",
starOccultationFormatEventTime(start, true),
starOccultationFormatEventTime(greatest, !starOccultationSameDate(start, greatest)),
starOccultationFormatEventTime(end, !starOccultationSameDate(start, end)), zone)
}
return fmt.Sprintf("外掩始 %s | 掩甚 %s | 外掩终 %s (%s)",
starOccultationFormatEventTime(start, true),
starOccultationFormatEventTime(greatest, !starOccultationSameDate(start, greatest)),
starOccultationFormatEventTime(end, !starOccultationSameDate(start, end)), zone)
}
totalStart := path.TotalStart.Time.In(options.Location)
totalEnd := path.TotalEnd.Time.In(options.Location)
if options.Language == starOccultationSVGLanguageEnglish {
return fmt.Sprintf("Partial begins %s | Total begins %s | Greatest %s | Total ends %s | Partial ends %s (%s)",
starOccultationFormatEventTime(start, true),
starOccultationFormatEventTime(totalStart, !starOccultationSameDate(start, totalStart)),
starOccultationFormatEventTime(greatest, !starOccultationSameDate(start, greatest)),
starOccultationFormatEventTime(totalEnd, !starOccultationSameDate(start, totalEnd)),
starOccultationFormatEventTime(end, !starOccultationSameDate(start, end)), zone)
}
return fmt.Sprintf("外掩始 %s | 全掩始 %s | 掩甚 %s | 全掩终 %s | 外掩终 %s (%s)",
starOccultationFormatEventTime(start, true),
starOccultationFormatEventTime(totalStart, !starOccultationSameDate(start, totalStart)),
starOccultationFormatEventTime(greatest, !starOccultationSameDate(start, greatest)),
starOccultationFormatEventTime(totalEnd, !starOccultationSameDate(start, totalEnd)),
starOccultationFormatEventTime(end, !starOccultationSameDate(start, end)), zone)
}
func planetOccultationSVGGreatestText(path moon.PlanetOccultationPath, language string) string {
coordinates := starOccultationFormatCoordinates(path.Greatest.Longitude, path.Greatest.Latitude)
if path.HasTotalBand {
if language == starOccultationSVGLanguageEnglish {
return fmt.Sprintf("Greatest point %s | partial-band width %.1f km | total-band width %.1f km",
coordinates, path.Greatest.WidthKM, path.GreatestTotalWidthKM)
}
return fmt.Sprintf("掩甚点 %s | 部分掩带宽 %.1f km | 全掩带宽 %.1f km",
coordinates, path.Greatest.WidthKM, path.GreatestTotalWidthKM)
}
if language == starOccultationSVGLanguageEnglish {
return fmt.Sprintf("Greatest point %s | partial-band width %.1f km", coordinates, path.Greatest.WidthKM)
}
return fmt.Sprintf("掩甚点 %s | 部分掩带宽 %.1f km", coordinates, path.Greatest.WidthKM)
}
func planetOccultationSVGFooter(path moon.PlanetOccultationPath, options PlanetOccultationSVGOptions) string {
projection := starOccultationProjectionLabel(options.Projection, options.Language)
ringNote := ""
if path.Planet == moon.OccultationSaturn {
if options.Language == starOccultationSVGLanguageEnglish {
ringNote = " Saturn's rings are not included in contact geometry."
} else {
ringNote = "土星环不参与接触计算。"
}
}
if options.Language == starOccultationSVGLanguageEnglish {
return projection + "; Natural Earth 1:50m physical land, no administrative boundaries. " +
"The outer-contact cone bounds any disk overlap; the inner-contact cone bounds full planet-disk coverage." + ringNote
}
return projection + ";Natural Earth 1:50m 物理陆地底图,不含行政边界;" +
"外切锥面界定任意圆盘重叠,内切锥面界定行星圆盘完全被月球遮住。" + ringNote
}
func writePlanetOccultationMap(
b *strings.Builder,
path moon.PlanetOccultationPath,
starShape moon.StarOccultationPath,
layout starOccultationSVGLayout,
options StarOccultationSVGOptions,
) {
layout.mapFrame().WriteOcean(b)
writeStarOccultationGraticule(b, layout)
writeStarOccultationLand(b, layout)
if len(path.PartialFootprints) > 0 {
writePlanetOccultationFootprintSweep(b, path.PartialFootprints, layout,
"partial-occultation-band-layer", "occultation-band", "#e0ae43", 0.34)
} else {
writeOccultationBand(b, path.NorthernLimit, path.SouthernLimit, layout,
"partial-occultation-band-layer", "occultation-band", "#e0ae43", 0.34)
}
if path.HasTotalBand {
if len(path.TotalFootprints) > 0 {
writePlanetOccultationFootprintSweep(b, path.TotalFootprints, layout,
"total-occultation-band-layer", "total-occultation-band", "#607d98", 0.72)
} else {
writeOccultationBand(b, path.NorthernTotalLimit, path.SouthernTotalLimit, layout,
"total-occultation-band-layer", "total-occultation-band", "#607d98", 0.72)
}
}
if len(path.PartialFootprints) == 0 {
writeStarOccultationGeoLine(b, path.NorthernLimit, layout, "northern-limit", "#a66f18", 1.25, "")
writeStarOccultationGeoLine(b, path.SouthernLimit, layout, "southern-limit", "#a66f18", 1.25, "")
}
if path.HasTotalBand && len(path.TotalFootprints) == 0 {
writeStarOccultationGeoLine(b, path.NorthernTotalLimit, layout, "northern-total-limit", "#355878", 1.3, "")
writeStarOccultationGeoLine(b, path.SouthernTotalLimit, layout, "southern-total-limit", "#355878", 1.3, "")
}
writeStarOccultationGeoLine(b, starShape.CenterLine, layout, "center-line", "#59676b", 1.6, "5 4")
writeStarOccultationVisibleCenterLine(b, starShape.CenterLine, layout)
excluded := []time.Time{path.Start.Time, path.End.Time}
if path.HasTotalBand {
excluded = append(excluded, path.TotalStart.Time, path.TotalEnd.Time)
}
writeOccultationTimeMarkers(b, starShape.CenterLine, layout, options, excluded, path.Greatest.Time)
writePlanetOccultationEventMarkers(b, path, layout, options.Language)
layout.mapFrame().WriteFrame(b)
writePlanetOccultationLegend(b, layout, options.Language, path.HasTotalBand)
}
func writePlanetOccultationFootprintSweep(
b *strings.Builder,
footprints []moon.PlanetOccultationFootprint,
layout starOccultationSVGLayout,
layerClass, pathClass, color string,
opacity float64,
) {
var geometry strings.Builder
for _, footprint := range footprints {
for _, polygon := range footprint.Polygons {
geographic := make([]svgmap.GeoPoint, len(polygon))
for index, point := range polygon {
geographic[index] = svgmap.GeoPoint{Longitude: point.Longitude, Latitude: point.Latitude}
}
for _, fragment := range svgmap.PolygonFragments(geographic, layout.projection) {
if len(fragment) < 3 {
continue
}
if planetOccultationProjectedArea(layout, fragment) < 0 {
for left, right := 0, len(fragment)-1; left < right; left, right = left+1, right-1 {
fragment[left], fragment[right] = fragment[right], fragment[left]
}
}
for index, point := range fragment {
x, y := layout.project(point.Longitude, point.Latitude)
command := "L"
if index == 0 {
command = "M"
}
fmt.Fprintf(&geometry, "%s %.3f %.3f ", command, x, y)
}
geometry.WriteString("Z ")
}
}
}
if geometry.Len() == 0 {
return
}
fmt.Fprintf(b, ``,
layerClass, color, opacity, pathClass, geometry.String())
}
func planetOccultationProjectedArea(layout starOccultationSVGLayout, points []svgmap.GeoPoint) float64 {
area := 0.0
for index, point := range points {
next := points[(index+1)%len(points)]
x1, y1 := layout.project(point.Longitude, point.Latitude)
x2, y2 := layout.project(next.Longitude, next.Latitude)
area += x1*y2 - x2*y1
}
return area / 2
}
type planetOccultationProjectedEventMarker struct {
point moon.OccultationPathPoint
label string
kind string
x, y float64
visible bool
placement starOccultationEventMarkerPlacement
}
func writePlanetOccultationEventMarkers(
b *strings.Builder,
path moon.PlanetOccultationPath,
layout starOccultationSVGLayout,
language string,
) {
markers := []planetOccultationProjectedEventMarker{
{point: path.Start, label: planetOccultationEventLabel("start", language), kind: "start"},
}
if path.HasTotalBand {
markers = append(markers, planetOccultationProjectedEventMarker{
point: path.TotalStart, label: planetOccultationEventLabel("total-start", language), kind: "total-start",
})
}
markers = append(markers, planetOccultationProjectedEventMarker{
point: path.Greatest, label: planetOccultationEventLabel("greatest", language), kind: "greatest",
})
if path.HasTotalBand {
markers = append(markers, planetOccultationProjectedEventMarker{
point: path.TotalEnd, label: planetOccultationEventLabel("total-end", language), kind: "total-end",
})
}
markers = append(markers, planetOccultationProjectedEventMarker{
point: path.End, label: planetOccultationEventLabel("end", language), kind: "end",
})
for index := range markers {
markers[index].x, markers[index].y, markers[index].visible = layout.mapFrame().Project(
markers[index].point.Longitude, markers[index].point.Latitude,
)
markers[index].placement = starOccultationDefaultEventMarkerPlacement(
markers[index].x, markers[index].y, markers[index].kind, layout,
)
}
if path.HasTotalBand {
separatePlanetOccultationMarkerPair(markers, 0, 1, layout)
separatePlanetOccultationMarkerPair(markers, 4, 3, layout)
}
drawOrder := make([]int, len(markers))
for index := range drawOrder {
drawOrder[index] = index
}
if path.HasTotalBand {
// 先绘制接近重合的外接触,再绘制较小的内接触点,使两个真实地理位置都保持可读。
// Draw the near-coincident outer contacts first, then the smaller inner contacts, so both true geographic positions remain legible.
drawOrder = []int{0, 4, 1, 3, 2}
}
for _, index := range drawOrder {
marker := markers[index]
if marker.visible {
writeStarOccultationProjectedEventMarker(
b, marker.x, marker.y, marker.label, marker.kind, marker.placement,
)
}
}
}
func separatePlanetOccultationMarkerPair(
markers []planetOccultationProjectedEventMarker,
outerIndex, totalIndex int,
layout starOccultationSVGLayout,
) {
outer := &markers[outerIndex]
total := &markers[totalIndex]
if !outer.visible || !total.visible || math.Hypot(outer.x-total.x, outer.y-total.y) >= 30 {
return
}
upper := math.Min(outer.y, total.y) - 10
lower := math.Max(outer.y, total.y) + 18
top := layout.mapY + 12
bottom := layout.mapY + layout.mapHeight - 5
if lower > bottom {
lower = math.Min(outer.y, total.y) - 10
upper = lower - 16
}
if upper < top {
upper = math.Max(outer.y, total.y) + 16
lower = upper + 16
}
outer.placement.labelY = math.Max(top, math.Min(bottom, upper))
total.placement.labelY = math.Max(top, math.Min(bottom, lower))
outer.placement.leader = true
total.placement.leader = true
}
func writePlanetOccultationLegend(
b *strings.Builder,
layout starOccultationSVGLayout,
language string,
hasTotal bool,
) {
labels := []string{"部分掩带", "可见中心线", "几何中心线"}
if hasTotal {
labels = []string{"部分掩带", "全掩带", "可见中心线", "几何中心线"}
}
if language == starOccultationSVGLanguageEnglish {
labels = []string{"Partial band", "Visible center", "Geometric center"}
if hasTotal {
labels = []string{"Partial band", "Total band", "Visible center", "Geometric center"}
}
}
y := layout.mapY + layout.mapHeight + 30
itemWidth := layout.mapWidth / float64(len(labels))
for index, label := range labels {
x := layout.mapX + float64(index)*itemWidth
switch {
case index == 0:
fmt.Fprintf(b, ``, x, y-10)
case hasTotal && index == 1:
fmt.Fprintf(b, ``, x, y-10)
default:
color, dash := "#087f8c", ""
if index == len(labels)-1 {
color, dash = "#59676b", "5 4"
}
fmt.Fprintf(b, ``)
}
fmt.Fprintf(b, `%s`,
x+23, y, html.EscapeString(label))
}
}
func writePlanetOccultationEventsPanel(
b *strings.Builder,
path moon.PlanetOccultationPath,
layout starOccultationSVGLayout,
options PlanetOccultationSVGOptions,
) {
writeOccultationEventsPanel(b, planetOccultationSVGEventRows(path, options.Language), layout, options)
}
func planetOccultationSVGEventRows(path moon.PlanetOccultationPath, language string) []starOccultationEventRow {
rows := []starOccultationEventRow{
{name: planetOccultationEventLabel("start", language), point: path.Start},
}
if path.HasTotalBand {
rows = append(rows, starOccultationEventRow{name: planetOccultationEventLabel("total-start", language), point: path.TotalStart})
}
rows = append(rows, starOccultationEventRow{name: planetOccultationEventLabel("greatest", language), point: path.Greatest})
if path.HasTotalBand {
rows = append(rows, starOccultationEventRow{name: planetOccultationEventLabel("total-end", language), point: path.TotalEnd})
}
return append(rows, starOccultationEventRow{name: planetOccultationEventLabel("end", language), point: path.End})
}
func planetOccultationEventLabel(kind, language string) string {
if language == starOccultationSVGLanguageEnglish {
switch kind {
case "start":
return "Partial begins"
case "total-start":
return "Total begins"
case "greatest":
return "Greatest"
case "total-end":
return "Total ends"
default:
return "Partial ends"
}
}
switch kind {
case "start":
return "外掩始"
case "total-start":
return "全掩始"
case "greatest":
return "掩甚"
case "total-end":
return "全掩终"
default:
return "外掩终"
}
}
func planetOccultationChineseName(planet moon.OccultationPlanet) string {
switch planet {
case moon.OccultationMercury:
return "水星"
case moon.OccultationVenus:
return "金星"
case moon.OccultationMars:
return "火星"
case moon.OccultationJupiter:
return "木星"
case moon.OccultationSaturn:
return "土星"
case moon.OccultationUranus:
return "天王星"
case moon.OccultationNeptune:
return "海王星"
default:
return "行星"
}
}