1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
(api-reference)=
# API reference
This page holds boinor's API documentation, which might be helpful for final
users or developers to create their own boinor-based utilities. Among the
different sub-packages and modules, we might differentiate two big categories:
core utilities and high-level ones.
## High level API
The high level API of boinor allows you to do most common tasks
(propagate an osculating orbit, sampling an ephemerides, compute maneuvers)
in a straightforward way. All the methods expect Astropy units.
The most important high level objects and methods are
{py:class}`boinor.twobody.Orbit`, {py:class}`boinor.ephem.Ephem`, and
{py:class}`boinor.maneuver.Maneuver`.
Here is a summarized reference of commonly used methods:
```{eval-rst}
.. autoapiclass:: boinor.twobody.Orbit
:members: from_classical, from_vectors, from_sbdb, propagate, to_ephem
:noindex:
.. autoapiclass:: boinor.ephem.Ephem
:members: from_body, from_orbit, from_horizons, sample, rv
:noindex:
.. autoapiclass:: boinor.maneuver.Maneuver
:members: impulse, hohmann, bielliptic, lambert
:noindex:
```
You can read the complete reference of the high level API here:
% Terrible way of excluding the core package from the toctree:
% the `[!...]` syntax only matches a single character
% (see https://askubuntu.com/a/1231400)
% so we exclude anything starting with `c`,
% but then we re-include the `constants` and `czml`.
% A more powerful syntax would be desirable but it is not yet supported,
% see https://github.com/sphinx-doc/sphinx/issues/6650
```{toctree}
---
maxdepth: 1
glob:
---
/autoapi/boinor/[!c_]*/index
/autoapi/boinor/czml/index
/autoapi/boinor/constants/index
```
## Core API
The core API is a low level layer that contains simple functions.
They are accelerated using Numba, a Just-in-Time compiler for Python,
to achieve good performance. However, they take raw NumPy arrays and Python scalars,
so they will not protect you from dimensional errors.
```{toctree}
---
maxdepth: 3
---
/autoapi/boinor/core/index
```
|
