README.md 3.47 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
![Orekit logo](https://www.orekit.org/img/orekit-logo.png)

# Orekit

> An accurate and efficient core layer for space flight dynamics applications

[Orekit](https://www.orekit.org) is a low level space dynamics library written
in Java. Orekit is designed to be easily used in very different contexts, from
quick studies up to critical operations. As a library, Orekit provides basic
elements (orbits, dates, attitude, frames, ...) and various algorithms to
11
handle them (conversions, propagations, pointing, events detection, orbit determination ...).
12

13
[![](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
Bryan Cazabonne's avatar
Bryan Cazabonne committed
14
15
[![](https://sonar.orekit.org/api/project_badges/measure?project=orekit%3Aorekit&metric=alert_status)](https://sonar.orekit.org/dashboard?id=orekit%3Aorekit)
[![](https://sonar.orekit.org/api/project_badges/measure?project=orekit%3Aorekit&metric=coverage)](https://sonar.orekit.org/dashboard?id=orekit%3Aorekit)
16
17
18
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7249096.svg)](https://doi.org/10.5281/zenodo.7249096)


Guilhem Bonnefille's avatar
Guilhem Bonnefille committed
19

20
21
22
23
## Download

### Official releases

24
[Official Orekit releases](https://gitlab.orekit.org/orekit/orekit/-/releases)
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
are available on our [Gitlab instance](https://gitlab.orekit.org/). They are
also available in the
[Maven repository](https://mvnrepository.com/artifact/org.orekit/orekit).

### Development version

To get the latest development version, please clone our official repository
and checkout the `develop` branch:

```bash
git clone -b develop https://gitlab.orekit.org/orekit/orekit.git
```
__Note:__ Our official repository is
[mirrored on Github](https://github.com/CS-SI/Orekit).

40
41
42
## Documentation

Project overview, architecture and development, detailed features list,
43
Javadoc and a lot of other information is available on the
44
45
46
47
48
49
[Maven site](https://www.orekit.org/site-orekit-development/).

## Getting help

The main communication channel is our [forum](https://forum.orekit.org/). You
can report bugs and suggest new features in our
50
51
[issues tracking system](https://gitlab.orekit.org/orekit/orekit/issues). When
reporting security issues check the "This issue is confidential" box.
52
53
54

## Contributing

55
56
Orekit exists thanks to the contribution of
[many people](https://gitlab.orekit.org/orekit/orekit/graphs/develop).
57
58
59
Please take a look at our
[contributing guidelines](src/site/markdown/contributing.md) if you're
interested in helping!
60
61
62
63
64
65
66
67

## Building

Detailed information on how to build Orekit from source either using Maven or
Eclipse is provided in [building.md](src/site/markdown/building.md) file.

## Dependencies

68
69
70
Orekit relies on the following
[FOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) libraries,
all released under business friendly FOSS licenses.
71

Sebastien Dinot's avatar
Sebastien Dinot committed
72
### Compile-time/run-time dependencies
73

74
* [Hipparchus](https://hipparchus.org/), a mathematics library released under
75
  the Apache License, version 2.1.
76

Sebastien Dinot's avatar
Sebastien Dinot committed
77
### Test-time dependencies
78

79
* [JUnit 5](http://www.junit.org/), a widely used unit test framework released
Sébastien Dinot's avatar
Sébastien Dinot committed
80
  under the Eclipse Public License, version 1.0.
81

82
* [Mockito](https://site.mockito.org/), a mocking framework for unit tests,
83
84
85
  released under MIT license.

More detailed information is available in the
86
[Maven site](https://www.orekit.org/site-orekit-development/dependencies.html).
87
88
89

## License

90
Orekit is licensed by [CS GROUP](https://www.c-s.fr/) under
91
the [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html).
92
A copy of this license is provided in the [LICENSE.txt](LICENSE.txt) file.