# FDS Python SDK
This package contains the Python Software Development Kit (SDK) of space**tower**™.
space**tower**™ is Exotrail's Flight Dynamics System (FDS). It covers all the needs of the flight dynamics engineer, including but not limited to :
- Orbit Determination using PV (Position-Velocity) or GPS NMEA measurements;
- Measurement Generation;
- Event prediction e.g. station passes;
- Generation and simulation of maneuvers e.g. for orbit raising;
- Uncertainties evaluation for all of these cases.
The Python SDK brings these features to you through a set of Python modules directly callable in your scripts. These modules interacts with the public Application Programming Interface (API) of space**tower**™ available online.
## Contents
- [Installation instructions](#installation-instructions)
- [Prerequisites](#prerequisites)
- [Step-by-step installation](#step-by-step-installation)
- [Features overview](#features-overview)
- [Orbit Extrapolation](#orbit-extrapolation)
- [Orbit Determination](#orbit-determination)
- [Maneuver Generation](#maneuver-generation)
- [Documentation](#documentation)
- [Dependencies](#dependencies)
- [Contact](#contact)
- [License](#license)
- [Version history](#version-history)
## Installation instructions
### Prerequisites
In order to use the Python SDK of space**tower**™, you need to have Python 3.11 or higher installed, with a package manager like pip or poetry.
The procedure described hereafter also requires the use of a Command Line Interface (CLI).
API credentials are required to call the space**tower**™ API. If you do not have credentials yet, please register at https://portal.exotrail.space.
### Step-by-step installation
It is recommended to use a virtual environment to install the SDK.
This will prevent conflicts with other Python packages that may be installed on the system.
To create a virtual environment:
```bash
$ python -m venv venv
```
Based on your operating system, you will have to activate the virtual environment differently. For Windows, you can use the following command :
```bash
$ .\.venv\Scripts\activate
```
or if you want to use the Powershell script:
```bash
$ .\.venv\Scripts\Activate.ps1
```
For Unix-based systems, you can use :
```bash
$ source .venv/bin/activate
```
To install the SDK :
```bash
$ pip install spacetower-fds-sdk
```
This will install the SDK and its dependencies into the virtual environment.
To set up the API credentials, you can use the following command:
```python
from fds.config import set_client_id, set_client_secret
set_client_id("your_client_id")
set_client_secret("your_client_secret")
```
## Features Overview
### Orbit extrapolation
In its simplest use, given an initial state and a target time, the SDK can call the API points of space**tower**™ exposed online to request the propagation of the state to the target time.
Additional parameters can be passed to the `OrbitExtrapolation` class to perform more complex operations, such as:
- Find orbital events (e.g. eclipse entry/exit, ascending and descending nodes, etc.)
- Find station visibility windows (e.g. when a ground station, defined by the user, can see the satellite)
- Find events related to sensors (e.g. find windows where the Sun is in the field of view of a camera)
- Generate simulated measurements (e.g. GPS NMEA, position and velocity, radar, etc.)
- Generate output ephemerides of various types (e.g. Cartesian, Keplerian, attitude, etc.). Cartesian ephemerides can be also produced in the Orbit Ephemerides Message (OEM) format.
- Propagate the state covariance matrix
- Simulate attitude and/or trajectory changes through maneuver roadmaps.
### Orbit determination
The SDK of space**tower**™ can perform orbit determination by calling the API points to request the estimation of the state of the satellite, given an initial state, a set of measurements and configuration parameters. An Unscented Kalman Filter (UKF) is used to perform the estimation.
The class `OrbitDetermination` provides a simple interface to the API.
Additionally, users can add model parameters to the estimation, i.e. the drag coefficient, the reflectivity coefficient and the thrust scale factors. Providing a maneuver roadmap will also allow the SDK to characterise the maneuvers that have been performed (in terms of mean variations of the state and thrust magnitude and direction).
### Maneuver generation
The maneuver generation functionality allows users to generate a maneuver roadmap that can be used in the orbit extrapolation and orbit determination functionalities. Several parameters can be passed to the `ManeuverGeneration` class to generate the roadmap, definining the desired strategy and constraints (through the `ManeuverStrategy` object) and targets (e.g. change of semi-major axis, inclination, etc.).
### Additional features
The SDK also provides additional functionalities in support of the main operations, such as:
- Two-line element (TLE) handling
- NMEA sentences parsing
- Vector operations
- Frame transformations
- Quaternion operations
- Orbital mechanics calculations
## Documentation
An online documentation of the Python SDK of space**tower**™ can be accessed at : https://docs.spacetower.exotrail.space/python-sdk/index.html
It includes docstrings description of the various modules of the SDK, to which you can refer to when using space**tower**™ in your projects.
Furthermore, a set of demonstration notebooks using *Jupyter* are available here: https://github.com/exotrail/spacetower-notebooks
These notebooks aim at being resources for new users to understand how the SDK is built, as well as showcasing the performances of space**tower**™. They cover the most frequent use cases of an FDS.
An online version of the notebooks can be found on our customer portal: https://portal.exotrail.space
## Dependencies
As mentioned in the Getting started section, this demonstration package is written using Python 3.11, and relies on pip for installing dependencies. Said dependencies can be found in the *pyproject.toml* file of this package.
## Contact
To get in touch with us, please send a mail to the Flight Dynamics Support service at
fds-support@exotrailspace.onmicrosoft.com
## License
This package is distributed under the MIT License. You are free to use, modify, and distribute the software as you see fit, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software. The software is provided "as is," without warranty of any kind, express or implied. For more details, please refer to the LICENSE file included in this repository.
## Version history
**[1.1.0]** 2024-06-21
- Added firing constraints to the `ManeuverGeneration` class
**[1.0.0]** 2024-05-31
- Initial release
- Coverage of the main use cases og space**tower**™ API: Orbit Extrapolation, Orbit Determination, Maneuver Generation
Raw data
{
"_id": null,
"home_page": null,
"name": "spacetower-fds-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "FDS, API, Exotrail, Flight Dynamics",
"author": "Exotrail",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/14/2d/d224bc8d76865a9975ab6158b79dfba0a2f0c7f0233f169cc78abdbd58c9/spacetower_fds_sdk-1.2.1.tar.gz",
"platform": null,
"description": "# FDS Python SDK\n\nThis package contains the Python Software Development Kit (SDK) of space**tower**\u2122.\n\nspace**tower**\u2122 is Exotrail's Flight Dynamics System (FDS). It covers all the needs of the flight dynamics engineer, including but not limited to :\n- Orbit Determination using PV (Position-Velocity) or GPS NMEA measurements;\n- Measurement Generation;\n- Event prediction e.g. station passes;\n- Generation and simulation of maneuvers e.g. for orbit raising;\n- Uncertainties evaluation for all of these cases.\n\nThe Python SDK brings these features to you through a set of Python modules directly callable in your scripts. These modules interacts with the public Application Programming Interface (API) of space**tower**\u2122 available online.\n\n\n## Contents\n\n- [Installation instructions](#installation-instructions)\n - [Prerequisites](#prerequisites)\n - [Step-by-step installation](#step-by-step-installation)\n- [Features overview](#features-overview)\n - [Orbit Extrapolation](#orbit-extrapolation)\n - [Orbit Determination](#orbit-determination)\n - [Maneuver Generation](#maneuver-generation)\n- [Documentation](#documentation)\n- [Dependencies](#dependencies)\n- [Contact](#contact)\n- [License](#license)\n- [Version history](#version-history)\n\n\n## Installation instructions\n\n### Prerequisites\n\nIn order to use the Python SDK of space**tower**\u2122, you need to have Python 3.11 or higher installed, with a package manager like pip or poetry. \n\nThe procedure described hereafter also requires the use of a Command Line Interface (CLI).\n\nAPI credentials are required to call the space**tower**\u2122 API. If you do not have credentials yet, please register at https://portal.exotrail.space.\n\n### Step-by-step installation\n\nIt is recommended to use a virtual environment to install the SDK.\nThis will prevent conflicts with other Python packages that may be installed on the system.\n\nTo create a virtual environment:\n```bash\n$ python -m venv venv\n```\nBased on your operating system, you will have to activate the virtual environment differently. For Windows, you can use the following command :\n```bash \n$ .\\.venv\\Scripts\\activate\n``` \nor if you want to use the Powershell script:\n```bash \n$ .\\.venv\\Scripts\\Activate.ps1\n``` \nFor Unix-based systems, you can use : \n```bash \n$ source .venv/bin/activate\n```\n\nTo install the SDK :\n```bash\n$ pip install spacetower-fds-sdk\n```\n\nThis will install the SDK and its dependencies into the virtual environment.\n\nTo set up the API credentials, you can use the following command:\n```python\nfrom fds.config import set_client_id, set_client_secret\nset_client_id(\"your_client_id\")\nset_client_secret(\"your_client_secret\")\n```\n\n## Features Overview\n\n### Orbit extrapolation\n\nIn its simplest use, given an initial state and a target time, the SDK can call the API points of space**tower**\u2122 exposed online to request the propagation of the state to the target time.\n\nAdditional parameters can be passed to the `OrbitExtrapolation` class to perform more complex operations, such as:\n\n- Find orbital events (e.g. eclipse entry/exit, ascending and descending nodes, etc.)\n- Find station visibility windows (e.g. when a ground station, defined by the user, can see the satellite)\n- Find events related to sensors (e.g. find windows where the Sun is in the field of view of a camera)\n- Generate simulated measurements (e.g. GPS NMEA, position and velocity, radar, etc.)\n- Generate output ephemerides of various types (e.g. Cartesian, Keplerian, attitude, etc.). Cartesian ephemerides can be also produced in the Orbit Ephemerides Message (OEM) format.\n- Propagate the state covariance matrix\n- Simulate attitude and/or trajectory changes through maneuver roadmaps.\n\n### Orbit determination\n\nThe SDK of space**tower**\u2122 can perform orbit determination by calling the API points to request the estimation of the state of the satellite, given an initial state, a set of measurements and configuration parameters. An Unscented Kalman Filter (UKF) is used to perform the estimation.\nThe class `OrbitDetermination` provides a simple interface to the API.\n\nAdditionally, users can add model parameters to the estimation, i.e. the drag coefficient, the reflectivity coefficient and the thrust scale factors. Providing a maneuver roadmap will also allow the SDK to characterise the maneuvers that have been performed (in terms of mean variations of the state and thrust magnitude and direction).\n\n### Maneuver generation\n\nThe maneuver generation functionality allows users to generate a maneuver roadmap that can be used in the orbit extrapolation and orbit determination functionalities. Several parameters can be passed to the `ManeuverGeneration` class to generate the roadmap, definining the desired strategy and constraints (through the `ManeuverStrategy` object) and targets (e.g. change of semi-major axis, inclination, etc.).\n\n### Additional features\n\nThe SDK also provides additional functionalities in support of the main operations, such as:\n\n- Two-line element (TLE) handling\n- NMEA sentences parsing\n- Vector operations\n- Frame transformations\n- Quaternion operations\n- Orbital mechanics calculations\n\n## Documentation\n\nAn online documentation of the Python SDK of space**tower**\u2122 can be accessed at : https://docs.spacetower.exotrail.space/python-sdk/index.html\n\nIt includes docstrings description of the various modules of the SDK, to which you can refer to when using space**tower**\u2122 in your projects.\n\nFurthermore, a set of demonstration notebooks using *Jupyter* are available here: https://github.com/exotrail/spacetower-notebooks \n\nThese notebooks aim at being resources for new users to understand how the SDK is built, as well as showcasing the performances of space**tower**\u2122. They cover the most frequent use cases of an FDS.\n\nAn online version of the notebooks can be found on our customer portal: https://portal.exotrail.space\n\n## Dependencies\n\nAs mentioned in the Getting started section, this demonstration package is written using Python 3.11, and relies on pip for installing dependencies. Said dependencies can be found in the *pyproject.toml* file of this package.\n\n## Contact\n\nTo get in touch with us, please send a mail to the Flight Dynamics Support service at \nfds-support@exotrailspace.onmicrosoft.com\n\n ## License\n\nThis package is distributed under the MIT License. You are free to use, modify, and distribute the software as you see fit, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software. The software is provided \"as is,\" without warranty of any kind, express or implied. For more details, please refer to the LICENSE file included in this repository.\n\n## Version history\n\n**[1.1.0]** 2024-06-21\n- Added firing constraints to the `ManeuverGeneration` class\n\n**[1.0.0]** 2024-05-31\n- Initial release\n - Coverage of the main use cases og space**tower**\u2122 API: Orbit Extrapolation, Orbit Determination, Maneuver Generation\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "SDK for spacetower Flight Dynamics System API",
"version": "1.2.1",
"project_urls": null,
"split_keywords": [
"fds",
" api",
" exotrail",
" flight dynamics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "76e590a5242e5e7eccefe1a254b6c4568bd995dec9f1c4587aa4af34374104ca",
"md5": "9e5e8af68579340290c39a5a26cd4e7c",
"sha256": "0ae83a1a3ed6dc4c97f6b25146ac9cceaaebf5382fe40d2e64d3c052ad9b42e4"
},
"downloads": -1,
"filename": "spacetower_fds_sdk-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e5e8af68579340290c39a5a26cd4e7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 100800,
"upload_time": "2024-08-06T15:39:37",
"upload_time_iso_8601": "2024-08-06T15:39:37.534951Z",
"url": "https://files.pythonhosted.org/packages/76/e5/90a5242e5e7eccefe1a254b6c4568bd995dec9f1c4587aa4af34374104ca/spacetower_fds_sdk-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "142dd224bc8d76865a9975ab6158b79dfba0a2f0c7f0233f169cc78abdbd58c9",
"md5": "10d49f49d95f674a7c4e85ad141fac27",
"sha256": "38b29795c5b3cd466285a575570a52348482c46d321aad0b2871c96e7c0711bc"
},
"downloads": -1,
"filename": "spacetower_fds_sdk-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "10d49f49d95f674a7c4e85ad141fac27",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 84212,
"upload_time": "2024-08-06T15:39:39",
"upload_time_iso_8601": "2024-08-06T15:39:39.401377Z",
"url": "https://files.pythonhosted.org/packages/14/2d/d224bc8d76865a9975ab6158b79dfba0a2f0c7f0233f169cc78abdbd58c9/spacetower_fds_sdk-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-06 15:39:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "spacetower-fds-sdk"
}
JSON