https://github.com/galactics/beyond

Flight Dynamic Library
https://github.com/galactics/beyond

flight-dynamics python3 space

Last synced: 5 months ago
JSON representation

Flight Dynamic Library

• Host: GitHub
• URL: https://github.com/galactics/beyond
• Owner: galactics
• License: mit
• Created: 2016-05-22T22:50:19.000Z (about 10 years ago)
• Default Branch: main
• Last Pushed: 2025-11-16T15:09:53.000Z (7 months ago)
• Last Synced: 2026-01-03T08:47:45.318Z (6 months ago)
• Topics: flight-dynamics, python3, space
• Language: Python
• Homepage:
• Size: 7.95 MB
• Stars: 57
• Watchers: 5
• Forks: 9
• Open Issues: 11
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
Beyond

======

.. image:: http://readthedocs.org/projects/beyond/badge/?version=latest

    :alt: Documentation Status

    :target: http://beyond.readthedocs.io/en/latest/?badge=latest

.. image:: https://app.travis-ci.com/galactics/beyond.svg?branch=master

    :alt: Tests

    :target: https://app.travis-ci.com/galactics/beyond

.. image:: https://coveralls.io/repos/github/galactics/beyond/badge.svg?branch=master

    :alt: Coverage Status

    :target: https://coveralls.io/github/galactics/beyond?branch=master

.. image:: https://img.shields.io/pypi/v/beyond.svg

    :alt: PyPi version

    :target: https://pypi.python.org/pypi/beyond

.. image:: https://img.shields.io/pypi/pyversions/beyond.svg

    :alt: Python versions

    :target: https://pypi.python.org/pypi/beyond

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg

    :target: https://github.com/psf/black

This library was started to better understand how Flight Dynamics works. It

has no intent of efficiency nor performance at the moment, and the goal is

mainly to develop a simple API for space observations.

The sources of this library can be found at `github `__ and

are under the MIT license.

Installation

------------

Beyond requires Python 3.7+, numpy and `sgp4 `__.

To install the library and its dependencies use pip

.. code-block:: shell

    pip install beyond

Documentation

-------------

  * `Last release `__ (stable)

  * `Dev `__ (latest)

Usage

-----

.. code-block:: python

    import numpy as np

    from beyond.io.tle import Tle

    from beyond.frames import create_station

    from beyond.dates import Date, timedelta

    # Parse TLE

    tle = Tle("""ISS (ZARYA)

    1 25544U 98067A   19072.15347313  .00000167  00000-0  10147-4 0  9997

    2 25544  51.6420 118.6717 0004098  99.2855 123.2259 15.52799885160336""")

    # Create a station from which to compute the pass

    station = create_station('KSC', (28.524058, -80.65085, 0.0))

    for orb in station.visibility(tle.orbit(), start=Date.now(), stop=timedelta(days=1), step=timedelta(minutes=2), events=True):

        # As all angles are given in radians,

        # there is some conversion to do

        azim = -np.degrees(orb.theta) % 360

        elev = np.degrees(orb.phi)

        r = orb.r / 1000.

        print("{event:10} {tle.name}  {date:%Y-%m-%dT%H:%M:%S.%f} {azim:7.2f} {elev:7.2f} {r:10.2f}".format(

            date=orb.date, r=r, azim=azim, elev=elev,

            tle=tle, event=orb.event if orb.event is not None else ""

        ))

        # Stop at the end of the first pass

        if orb.event and orb.event.info == "LOS":

            break

This library is used as basis for the `Space-Command `__ utility.

Commons usages for this library are:

  * `Predicting of satellite visibility `__

  * `Computing satellite ground track `__

  * `Computing planets visibility `__

References

----------

A lot of the formulas and flight dynamic algorithm are based on Vallado's

*Fundamentals of Astrodynamic and Applications* 4th ed.