astronereus
Python frontend for Nereus — trans-dimensional Bayesian inference for exoplanet orbits.
You do not need Julia. Nereus itself is Julia, but this package fetches a prebuilt runtime on first use and runs it out-of-process in a warm daemon. Nothing is compiled at install time.
pip install astronereus
That is the whole install. The first time you actually ask for a fit, the runtime (~480 MB) is fetched and warmed once, and you are told it is happening:
astronereus: no Julia runtime yet -- fetching it once now.
astronereus: fetching runtime (macos-arm64, julia 1.11.9) ...
astronereus: unpacking ...
astronereus: warming the runtime (one-time, a few minutes) ...
astronereus: ready (207s)
pip cannot do that step itself -- wheels have no post-install hook -- so it
happens on first use instead. To get it over with ahead of a workshop or a
flight, run it deliberately:
python -c "import astronereus; astronereus.install()"
NEREUS_NO_AUTO_INSTALL=1 turns the automatic fetch off and makes the first
call fail with instructions instead, for CI and air-gapped machines.
The distribution and the import are both astronereus. The name nereus on
PyPI belongs to an unrelated geophysics package, and a distribution whose import
name differs from its install name is a thing every user has to be told, so they
are deliberately the same string here.
Use
import astronereus
summary = astronereus.run_job(cfg) # one-shot
with astronereus.session() as s: # or reuse one warm daemon
a = s.run_job(cfg_a)
pg = s.detect.rv_periodogram(t=t, rv=rv, rv_err=err)
Typed entry points per observable — fit_rv, fit_transit, fit_astrometry,
fit_rm, fit_tomography, fit_ttv, fit_binary, fit_joint — take channel
objects (RV, Transit, Astrometry, RM, Night, TTV, SB2) and return
a JobResult.
The first install() unpacks the runtime and warms it once (a few minutes);
every process after that starts in about twenty seconds. NEREUS_BUNDLE_URL
points the installer at a local file or file:// URL — that is the intended
path for a workshop room, where thirty people pulling half a gigabyte over
conference wifi is not a plan.
Runtime bundles
Prebuilt runtimes are attached to the
Nereus.jl releases, with
SHA256SUMS alongside:
| platform | size |
|---|---|
macos-arm64 |
466 MiB |
linux-x86_64 |
690 MiB |
linux-aarch64 |
650 MiB |
install() picks the one for your platform and verifies it against the
published checksum.
Upgrading the package does not refresh a runtime you already have — the
bundle is a separate download cached outside site-packages. When a release
ships against a newer Nereus, session() says so on start-up; get it with:
python -c "import astronereus; astronereus.install(force=True)"
``` For a classroom, fetch it once and point everyone at the
local copy instead:
```sh
export NEREUS_BUNDLE_URL=/Volumes/NEREUS/nereus-runtime-1.11.9-macos-arm64.tar.zst
NEREUS_HOME relocates the runtime cache out of the default platform cache
directory.
Licence
MIT — see LICENSE.
1 maintainer
Release files for astronereus 0.4.27
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| astronereus-0.4.27.tar.gz | 81.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| astronereus-0.4.27-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 161.7 kB
Release files / astronereus-0.4.27.tar.gz
| Download URL | astronereus-0.4.27.tar.gz |
|---|---|
| Size | 81.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6dae81b2ad7e9c8af84f086880d9b42561e11cf5a93c9d1af9fd4ea981d89242
|
|
BLAKE2b-256 checksum How to use checksums |
65f64ed4134b60e0e2704a64b128850c2e3aec5b70261d584d603a881b218ec2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / astronereus-0.4.27-py3-none-any.whl
| Download URL | astronereus-0.4.27-py3-none-any.whl |
|---|---|
| Size | 80.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6bcc33595ebaa4fc4e1d9f288aa69ca2448c52dbd05b00701cac12c4c3fa5740
|
|
BLAKE2b-256 checksum How to use checksums |
3862bd9a67e577460f6b95c726efe24d3a5fa87a9be6a40b1b834ba60a99932d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
