astro/sundial/doc.go

23 lines
1.0 KiB
Go
Raw Normal View History

// Package sundial provides apparent-solar-time helpers and planar-sundial
// geometry utilities.
//
// 当前提供两层能力:
// - 真太阳时换算
// - 平太阳时换算
// - 太阳时角
// - 平太阳时 / 区时对应的时角与时间线采样
// - 平面日晷通用几何(影尖坐标、日晷中心、极轴晷针)
// - 平面日晷受光时角区间
// - 赤纬曲线的分段采样
// - 赤道 / 水平 / 垂直日晷特例
// - 水平日晷时线角
//
// 对地方平太阳时时间线采样时,传入的 date 应处于目标地点的地方平太阳时区;
// 对区时时间线采样时date 负责提供民用日期与时区,原有钟面时间会被目标钟面读数替换。
//
// The package covers apparent solar time, mean solar time, hour-angle
// conversions for mean or zone time, general planar sundial geometry,
// illuminated hour-angle intervals, declination-curve sampling, and a few
// common special cases such as equatorial, horizontal, and vertical dials.
package sundial