Skip to content

Release v1.15

Choose a tag to compare

@chaunceygardiner chaunceygardiner released this 30 Jul 20:08

weewx-skyfield 1.15

A theme and a translation release: the Sky page gains a theme option —
dark (the default), light, or auto, which follows the sun at generation
time; a complete Dutch translation ships (Beta, awaiting native-speaker
review — corrections and reviewers very welcome); the French
translation, its review now complete, drops its Beta label; and every
radians-valued almanac angle now also answers in decimal degrees
($almanac.moon.parallactic_angle.degrees). Drop-in upgrade from any
1.x — install over it, no config changes; at the default theme the page
looks as before (one caption is reworded, see below).

What's new

  • The Sky page has a theme. theme = dark | light | auto in the
    [[SkyfieldReport]] section of weewx.conf: dark is the night
    plate the page has always had and stays the default; light renders
    the whole page — panels included — on the paper-atlas plate the
    embeddable panels have offered since 1.5; auto picks light while
    the sun is up at the moment the page is generated and dark otherwise.
    The page regenerates every report cycle, so the auto flip follows
    sunrise and sunset within one archive interval — the colors are baked
    in at generation time, still with no JavaScript. Asked for by a
    Belchertown user whose skin switches themes the same way (issue #3).

    [StdReport]
        [[SkyfieldReport]]
            theme = auto
    

    With the light plate in play, the Rise & Set caption no longer names
    its tick's color — "the tick across each bar is the transit" — since
    the tick is ivory only on the dark plate. Reworded in all languages.

  • Dutch ships (Beta). lang/nl.conf is a complete translation:
    the page prose, every panel string, the body names and all 88
    constellation names, which follow the Dutch Wikipedia's
    Lijst van sterrenbeelden
    (the IAU standardizes only the Latin names). The moon phases and
    compass points are as in WeeWX's own Dutch lang file, so a Dutch
    station reads consistently across skins. One line turns it on:

    [StdReport]
        [[SkyfieldReport]]
            lang = nl
    

    Beta until a native speaker has reviewed it — corrections are very
    welcome as issues or pull requests. Tests keep the Dutch complete
    the same way they keep the German and French: new strings cannot
    ship untranslated.

    The Sky page in Dutch

  • French is out of Beta. The native-speaker review is complete and
    confirmed the translation as shipped.

  • Degrees on every radians angle. The PyEphem-shaped angles —
    parallactic_angle, the moon's libration_lat/libration_long/
    colong, Jupiter's cmlI/cmlII, Saturn's earth_tilt/sun_tilt,
    and $almanac.separation(...) — now carry the same answer in decimal
    degrees: append .degrees ($almanac.moon.parallactic_angle.degrees);
    .radians names the value itself. The values are unchanged plain
    floats in radians, matching PyEphem's numeric scale, so existing
    templates — including the math.degrees($...) idiom and the
    PyEphem-style explicit call $almanac.venus.parallactic_angle()
    keep working. The parens-free parallactic_angle now also resolves
    outside Cheetah, so loopdata almanac fields can read
    almanac.moon.parallactic_angle.degrees. Asked for by a user.

  • Docs: where Earth's coordinates live. The body lists now say
    explicitly that there is no $almanac.earth — Earth is the observer,
    not a served body (PyEphem has no Earth body either) — and point to
    $almanac.sun.hlongitude/hlatitude, which report Earth's
    heliocentric coordinates per the XEphem convention.

Requirements

  • Python 3.9 or later
  • WeeWX 5.2 or later
  • Skyfield (1.47 or later) and NumPy in WeeWX's Python environment (see the
    README); PyEphem is NOT required

Installing/upgrading

Download weewx-skyfield.zip from this release, then:

weectl extension install weewx-skyfield.zip

Restart WeeWX. No weewx.conf changes are needed when upgrading from
1.x. Note that upgrading replaces the bundled skin (skins/Skyfield/,
including its lang/ files) — if you have edited an installed lang file
(trying out corrections, say), save a copy or send the corrections
upstream first; local additions such as extra star names survive
upgrades best as [[[Almanac]]] entries in weewx.conf (see the
manual).