sun_position — GEOCAM sun op

• 数据种类:signal → table

• 调用: import fullseye as fs; fs.ledger.sun_position(lat_deg, lon_deg, unix_times)(要直接调用实现,import geocam; geocam.sun_position(lat_deg, lon_deg, unix_times);从台账取用则 opsgeocam.get("sun_position"))

用法

纬度、经度、时刻(UNIX 秒,UTC)→ 太阳的方位角、仰角 [度] (NOAA 太阳位置算法,Meeus 1998 的低精度公式)。

公开的闭式(与 NOAA Global Monitoring Laboratory 的 Solar Calculator 相同的公式:

儒略世纪 → 平黄经、平近点角、中心差 → 视黄经 → 黄赤交角 → 赤纬 与均时差 → 时角 → 天顶角、方位角)。精度在 2000 年 ± 1 世纪内为 0.01° 左右(NOAA 的说明), 大气折射加到仰角上(NOAA 的分段公式,接近水平时最大 0.57°)。时刻为 UTC 的 UNIX 秒(1-D,float 即可)。忽略闰秒与 ΔT(对 0.01° 没有影响)。

Args:

lat_deg, lon_deg: 观测点。经度以东为正。

unix_times: (N,) UNIX 秒(UTC)。也可为标量。

Returns:

table: azimuth_deg (N,)(北 0°,顺时针)/ elevation_deg (N,)(含折射)/

elevation_true_deg (N,)(不含折射)/ declination_deg / equation_of_time_min /

hour_angle_deg / n。

已用真值确认的性质(tests/test_geocam.py):春分正午仰角 = 90 − |纬度|, 北半球正午的方位为 180°(南),方位按东 → 南 → 西单调变化,日出与日落的仰角对称,赤纬在 ±23.44° 以内。

详细使用指南

• geocam 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• poc_public_camera_heading — py -3.11 examples/poc_public_camera_heading.py

• poc_public_camera_heading_real — py -3.11 examples/poc_public_camera_heading_real.py

类型可衔接的下一个算子(可接受 table 作为输入)

render_skyline_view · camera_orientation_from_skyline

同类别(sun)

sun_pixel_position · camera_orientation_from_sun · sun_bloom_fit · camera_orientation_from_sun_candidates


*Provenance: geocam.py — GEOCAM 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.