# `Angelus`
[🔗](https://github.com/MonsignorEduardo/angelus/blob/v0.0.2/lib/angelus.ex#L1)

High-level geocentric ephemeris API backed by SPICE/JPL.

## Quick start

    # 1. Download kernels (once)
    mix angelus.kernels

    # 2. Load kernels at runtime
    :ok = Angelus.load_kernels()

    # 3. Query positions
    {:ok, positions} = Angelus.positions(
      [:sun, :moon, :mercury, :venus, :mars,
       :jupiter, :saturn, :uranus, :neptune, :pluto],
      ~U[1990-05-24 06:30:00Z]
    )

See `Angelus.Ephemeris` and `Angelus.Spice` for the full API.

# `load_kernels`

Loads the default v0.1 SPICE kernel set from `priv/kernels/`.

Delegates to `Angelus.Spice.load_kernels/0`.

# `load_kernels`

Loads SPICE kernels with options or explicit paths.

Delegates to `Angelus.Spice.load_kernels/1`.

# `position`

Returns the geocentric position of a single body at the given UTC datetime.

Delegates to `Angelus.Ephemeris.position/3`.

# `positions`

Returns the geocentric positions of a list of bodies at the given UTC datetime.

Delegates to `Angelus.Ephemeris.positions/3`.

# `version`

```elixir
@spec version() :: String.t()
```

Returns the Angelus library version.

---

*Consult [api-reference.md](api-reference.md) for complete listing*