msts-micropython
Geocentric lunar ephemerides from a Unix timestamp: the Moon's ecliptic position, distance, and phase.
This is a Python port of msts, the OCaml library, rewritten for MicroPython on resource-constrained microcontrollers. It implements the same algorithm with the same accuracy bounds. Use this version on-device, and the OCaml original wherever a full OCaml toolchain is available.
The implementation follows Paul Schlyter's algorithm: Keplerian orbital elements propagated from a fixed epoch with empirical perturbation corrections.
The library depends only on the standard math module. It performs no
I/O, reads no files, keeps no global state, and is fully deterministic.
compute is total for finite inputs; invalid arguments raise
ValueError naming the offending parameter.
Results are validated against JPL Horizons (DE441) over the interval 1900-01-01 through 2100-12-31.
Guaranteed error bounds:
- 2° in ecliptic longitude
- 0.5° in ecliptic latitude
- 1% in distance
- 0.02 in illuminated fraction
Typical errors are substantially smaller.
Requirements
- MicroPython, or
- CPython 3
Only the standard math module is required.
Installation
Copy msts.py onto the target device, for example:
mpremote cp msts.py :
Or simply place it alongside your own modules.
Example
import msts
# J2000.0 = 2000-01-01T12:00:00Z
e = msts.compute(946728000.0)
print("%s %.1f%% %.0f km" % (
msts.phase_name_to_string(e.phase.name),
e.phase.illuminated_fraction * 100.0,
e.position.distance_km,
))
Example uses
compute takes a Unix timestamp and returns a small result structure. It
performs no I/O and allocates only three small objects, making it
inexpensive enough to call on every wake cycle of a battery-powered
device.
Some applications:
- Clock or watch firmware — moon-phase complications for MicroPython-based clocks and smartwatches.
- E-ink or OLED displays — ESP32 or RP2040 boards that wake on a timer, compute the current phase, and update a display without network access.
- Garden automation — irrigation or planting reminders keyed to the lunar phase alongside existing sensor data.
- Outdoor lighting — dim or disable solar- or LoRa-powered lighting near the full moon when ambient light is already higher.
- Education — classroom demonstrations of basic orbital mechanics by varying the timestamp and observing the resulting position and phase.
- Astrophotography helpers — approximate moon phase and brightness for scheduling. Not suitable where precise rise/set times or arcsecond-level accuracy are required.
Differences from the OCaml original
phase_nameis represented by small integer constants (msts.NEW_MOON,msts.WAXING_CRESCENT, ...) instead of an OCaml variant type or Pythonenum, since MicroPython has no standardenummodule.Invalid_argumentbecomesValueError.- Field names, function names, formulas, constants, and documented accuracy bounds otherwise match the OCaml implementation one-for-one.
License
ISC. See LICENSE.
Metadata
Release files for micropython-msts 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| micropython_msts-0.1.0.tar.gz | 7.1 kB | Without provenance | Details for micropython_msts-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| micropython_msts-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for micropython_msts-0.1.0-py3-none-any.whl |
Total release size: 13.3 kB
Release files / micropython_msts-0.1.0.tar.gz
| Download URL | micropython_msts-0.1.0.tar.gz |
|---|---|
| Size | 7.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
603c249c3e7b1020350c4beef3db7841a02ce2222ba0770ad894b0af319c6ded
|
|
BLAKE2b-256 checksum How to use checksums |
6452b4b3a170081cacbf0af3de67e6775ccb53153b6aa0a75ea2aa436eb1ed46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / micropython_msts-0.1.0-py3-none-any.whl
| Download URL | micropython_msts-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
397c18ce2a3610fcf2828623295d1c4d9c56c11467e542866f3d36d0445df7ee
|
|
BLAKE2b-256 checksum How to use checksums |
506f4630dd2e9a1c1203642283c699492864c41f8469b2f8604e6b210bcc544c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for micropython-msts 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.