Space Command
=============
.. image:: http://readthedocs.org/projects/space-command/badge/?version=latest
:alt: Documentation Status
:target: https://space-command.readthedocs.io/en/latest/?badge=latest
.. image:: https://img.shields.io/pypi/v/space-command.svg
:alt: PyPi version
:target: https://pypi.python.org/pypi/space-command
.. image:: https://img.shields.io/pypi/pyversions/space-command.svg
:alt: Python versions
:target: https://pypi.python.org/pypi/space-command
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
The space command allows to compute the position of satellites and their passes above our head.
In order to do this, it uses the `beyond <https://github.com/galactics/beyond>`__ library.
Installation
------------
For the stable release
.. code-block:: shell
$ pip install space-command
For the latest development version
.. code-block:: shell
$ pip install git+https://github.com/galactics/beyond
$ pip install git+https://github.com/galactics/space-command
Features
--------
* Retrieve orbits as TLE from `Celestrak <http://celestrak.com/>`__ or `Space-Track <https://www.space-track.org/>`__
* Compute visibility from a given point of observation
* Compute phases of the Moon and other solar system bodies
* Animated map of the orbit of satellites
* Compute events for a given satellite (day/night, node, AOS/LOS, etc.)
* Retrieve Solar System bodies ephemeris
See `documentation <https://space-command.readthedocs.io/en/latest/>`__ for a
list of all the features.
Changelog
---------
[0.7.3] - 2023-08-19
^^^^^^^^^^^^^^^^^^^^
**Added**
- Python 3.11 support
- ``space tle`` displays total insertions from celestrak
- ``space station`` creation can now handle negative coordinates
- ``space log`` show current versions of beyond and space-command
**Modified**
- Subcommands are now listed without discrimination between official and third-party entry points.
**Removed**
- Python 3.6 support
[0.7.2] - 2022-10-14
^^^^^^^^^^^^^^^^^^^^
**Added**
- Python 3.9 and 3.10 support
- Option to force CCSDS format (XML or KVN)
- ``space map`` add pause button
- ``space passes`` elevation graph
- ``space log`` colorized log
- ``space tle`` now parses GP data instead of old-style files
- ``space tle`` now inserts tles in chuncks to avoid sqlite locks (@hamarituc)
[0.7.1] - 2020-09-13
^^^^^^^^^^^^^^^^^^^^
**Modified**
- follow ``beyond`` refactoring of listeners
[0.7] - 2020-08-11
^^^^^^^^^^^^^^^^^^
**Added**
- ``space tle`` history range selection
- ``wspace backup`` command to create, list and restore workspaces backups
- ``orb2circle()`` function to quickly compute the circle of visibility of a spacecraft
- ``space opm`` and ``space oem`` commands for OPM and OEM handling.
- ``tox`` passes command-line arguments to ``pytest`` if provided after ``--``
**Modified**
- refactoring of ``space map``, as a subpackage
- ``parse_date()`` tries both default date format ("%Y-%m-%dT%H:%M:%S" and "%Y-%m-%d"),
allowing for more relaxed dates command arguments
- refactoring ``space sat`` with documentation on each function
**Removed**
- ``space ephem`` is replaced by ``space oem``
- ``space station`` does not allow interactive station creation anymore
[0.6] - 2020-01-01
^^^^^^^^^^^^^^^^^^
**Added**
- `black <https://black.readthedocs.io/en/stable/>`__ code style
- Retrieve available pages from Celestrak
- Parse time scale of a datetime argument (i.e. "2020-01-01T14:36:00 TAI")
- ``wspace`` can list and restore backups
- ``space planet`` display the download progress
- Support of Python 3.8
- ``space events`` can compute Argument Of Latitude, and specific stations events
- ``space map`` command arguments to start at a given date, disable ground track or disable visibility circle
**Modified**
- ``Sat.from_selector`` take a single selector and return a single Sat instance.
Use ``Sat.from_selectors()`` for a generator.
- Refactoring the *space.tle* module into a subpackage
**Fixed**
- Correction of sorting algorithm for ``space tle``
- ``space passes`` header
- Support of environment variable to set a proxy, even in async code
- ``map`` does not crash when an ephemeris is out of bound
**Removed**
- Support of python 3.5
- Unused imports
[0.5] - 2019-07-30
^^^^^^^^^^^^^^^^^^
**Added**
- ``space map`` shows groundtrack
- ``space events`` can selectively display one type of event
- ``space sat`` subcommand to handle the satellite database
- ``space ephem`` subcommand to handle ephemerides
- ``wspace`` for workspace management
- ``space passes`` now has a csv output format
- ``space planet`` is able to fetch any bsp file defined in the config file
**Modified**
- Time span inputs normalized for all commands (20s, 3d12h5m, etc.)
- Satellites can now be accessed by other identifiers than name (norad=25544 and cospar=1998-067A are equivalent to "ISS (ZARYA)"). See ``space sat``
- Logging is now with a timed rotating file
[0.4.2] - 2019-02-23
^^^^^^^^^^^^^^^^^^^^
**Added**
- Logging
- Tests
- ``space events`` subcommand computes all orbital events of a satellite (AOS/LOS, Apogee/Perigee, etc.)
- ``space phase`` to compute the phase of available planets and moons
- groundtracks optional on map
**Removed**
- ``space moon`` subcommand. This is now handled by the more generic ``space phase``
[0.4.1] - 2018-11-01
^^^^^^^^^^^^^^^^^^^^
**Added**
- TLE database dump and statistics
- Station map
- Stations' characteristics defined in config file are now set as attributes of the
station object
[0.4] - 2018-10-20
^^^^^^^^^^^^^^^^^^
**Added**
- Compute ephemeris of solar system bodies (Moon, Mars, Jupiter, Titan, etc.)
- Moon phase computation
- Centralized date handling, via command ``space clock``
- Allow TLE retrieval from Space-Track
**Changed**
- Database classes are now suffixed with *Db*
- Subcommand retrieving data from the web now use the argument **fetch** instead of get.
**Removed**
- Light propagation delay no longer taken into account.
The computation was tedious, and has been removed from the beyond library
[v0.3] - 2018-07-24
^^^^^^^^^^^^^^^^^^^
**Added**
- Possibility to create your own commands with the ``space.command`` `entry point <https://setuptools.readthedocs.io/en/latest/pkg_resources.html#entry-points>`__.
- Search TLE containing a string
- Retrieve all chronological TLE of an object
- ``space map`` displays real-time position of objects
- Compute moon phase
- Every command taking object names can also take TLE or CCSDS ephemeris via stdin
- add mask handling for stations
- Passes zenithal display optional
**Changed**
- MIT license replace GPLv3
**Removed**
- EOP database disabled by default.
Raw data
{
"_id": null,
"home_page": "",
"name": "space-command",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "flight dynamic,satellite,space",
"author": "Jules David",
"author_email": "jules@onada.fr",
"download_url": "https://files.pythonhosted.org/packages/33/4e/b6879bf791d1bb3bcf443dedcc25da3c3ecd36f3b2e7a531169dc0b34763/space-command-0.7.3.tar.gz",
"platform": null,
"description": "Space Command\n=============\n\n.. image:: http://readthedocs.org/projects/space-command/badge/?version=latest\n :alt: Documentation Status\n :target: https://space-command.readthedocs.io/en/latest/?badge=latest\n\n.. image:: https://img.shields.io/pypi/v/space-command.svg\n :alt: PyPi version\n :target: https://pypi.python.org/pypi/space-command\n\n.. image:: https://img.shields.io/pypi/pyversions/space-command.svg\n :alt: Python versions\n :target: https://pypi.python.org/pypi/space-command\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n\nThe space command allows to compute the position of satellites and their passes above our head.\n\nIn order to do this, it uses the `beyond <https://github.com/galactics/beyond>`__ library.\n\nInstallation\n------------\n\nFor the stable release\n\n.. code-block:: shell\n\n $ pip install space-command\n\nFor the latest development version\n\n.. code-block:: shell\n\n $ pip install git+https://github.com/galactics/beyond\n $ pip install git+https://github.com/galactics/space-command\n\nFeatures\n--------\n\n* Retrieve orbits as TLE from `Celestrak <http://celestrak.com/>`__ or `Space-Track <https://www.space-track.org/>`__\n* Compute visibility from a given point of observation\n* Compute phases of the Moon and other solar system bodies\n* Animated map of the orbit of satellites\n* Compute events for a given satellite (day/night, node, AOS/LOS, etc.)\n* Retrieve Solar System bodies ephemeris\n\nSee `documentation <https://space-command.readthedocs.io/en/latest/>`__ for a\nlist of all the features.\n\nChangelog\n---------\n\n[0.7.3] - 2023-08-19\n^^^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- Python 3.11 support\n- ``space tle`` displays total insertions from celestrak\n- ``space station`` creation can now handle negative coordinates\n- ``space log`` show current versions of beyond and space-command\n\n**Modified**\n\n- Subcommands are now listed without discrimination between official and third-party entry points.\n\n**Removed**\n\n- Python 3.6 support\n\n[0.7.2] - 2022-10-14\n^^^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- Python 3.9 and 3.10 support\n- Option to force CCSDS format (XML or KVN)\n- ``space map`` add pause button\n- ``space passes`` elevation graph\n- ``space log`` colorized log\n- ``space tle`` now parses GP data instead of old-style files\n- ``space tle`` now inserts tles in chuncks to avoid sqlite locks (@hamarituc)\n\n[0.7.1] - 2020-09-13\n^^^^^^^^^^^^^^^^^^^^\n\n**Modified**\n\n- follow ``beyond`` refactoring of listeners\n\n[0.7] - 2020-08-11\n^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- ``space tle`` history range selection\n- ``wspace backup`` command to create, list and restore workspaces backups\n- ``orb2circle()`` function to quickly compute the circle of visibility of a spacecraft\n- ``space opm`` and ``space oem`` commands for OPM and OEM handling.\n- ``tox`` passes command-line arguments to ``pytest`` if provided after ``--``\n\n**Modified**\n\n- refactoring of ``space map``, as a subpackage\n- ``parse_date()`` tries both default date format (\"%Y-%m-%dT%H:%M:%S\" and \"%Y-%m-%d\"),\n allowing for more relaxed dates command arguments\n- refactoring ``space sat`` with documentation on each function\n\n**Removed**\n\n- ``space ephem`` is replaced by ``space oem``\n- ``space station`` does not allow interactive station creation anymore\n\n[0.6] - 2020-01-01\n^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- `black <https://black.readthedocs.io/en/stable/>`__ code style\n- Retrieve available pages from Celestrak\n- Parse time scale of a datetime argument (i.e. \"2020-01-01T14:36:00 TAI\")\n- ``wspace`` can list and restore backups\n- ``space planet`` display the download progress\n- Support of Python 3.8\n- ``space events`` can compute Argument Of Latitude, and specific stations events\n- ``space map`` command arguments to start at a given date, disable ground track or disable visibility circle\n\n**Modified**\n\n- ``Sat.from_selector`` take a single selector and return a single Sat instance.\n Use ``Sat.from_selectors()`` for a generator.\n- Refactoring the *space.tle* module into a subpackage\n\n**Fixed**\n\n- Correction of sorting algorithm for ``space tle``\n- ``space passes`` header\n- Support of environment variable to set a proxy, even in async code\n- ``map`` does not crash when an ephemeris is out of bound\n\n**Removed**\n\n- Support of python 3.5\n- Unused imports\n\n[0.5] - 2019-07-30\n^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- ``space map`` shows groundtrack\n- ``space events`` can selectively display one type of event\n- ``space sat`` subcommand to handle the satellite database\n- ``space ephem`` subcommand to handle ephemerides\n- ``wspace`` for workspace management\n- ``space passes`` now has a csv output format\n- ``space planet`` is able to fetch any bsp file defined in the config file\n\n**Modified**\n\n- Time span inputs normalized for all commands (20s, 3d12h5m, etc.)\n- Satellites can now be accessed by other identifiers than name (norad=25544 and cospar=1998-067A are equivalent to \"ISS (ZARYA)\"). See ``space sat``\n- Logging is now with a timed rotating file\n\n[0.4.2] - 2019-02-23\n^^^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- Logging\n- Tests\n- ``space events`` subcommand computes all orbital events of a satellite (AOS/LOS, Apogee/Perigee, etc.)\n- ``space phase`` to compute the phase of available planets and moons\n- groundtracks optional on map\n\n**Removed**\n\n- ``space moon`` subcommand. This is now handled by the more generic ``space phase``\n\n[0.4.1] - 2018-11-01\n^^^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- TLE database dump and statistics\n- Station map\n- Stations' characteristics defined in config file are now set as attributes of the\n station object\n\n[0.4] - 2018-10-20\n^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- Compute ephemeris of solar system bodies (Moon, Mars, Jupiter, Titan, etc.)\n- Moon phase computation\n- Centralized date handling, via command ``space clock``\n- Allow TLE retrieval from Space-Track\n\n**Changed**\n\n- Database classes are now suffixed with *Db*\n- Subcommand retrieving data from the web now use the argument **fetch** instead of get.\n\n**Removed**\n\n- Light propagation delay no longer taken into account.\n The computation was tedious, and has been removed from the beyond library\n\n[v0.3] - 2018-07-24\n^^^^^^^^^^^^^^^^^^^\n\n**Added**\n\n- Possibility to create your own commands with the ``space.command`` `entry point <https://setuptools.readthedocs.io/en/latest/pkg_resources.html#entry-points>`__.\n- Search TLE containing a string\n- Retrieve all chronological TLE of an object\n- ``space map`` displays real-time position of objects\n- Compute moon phase\n- Every command taking object names can also take TLE or CCSDS ephemeris via stdin\n- add mask handling for stations\n- Passes zenithal display optional\n\n**Changed**\n\n- MIT license replace GPLv3\n\n**Removed**\n\n- EOP database disabled by default.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Space Command",
"version": "0.7.3",
"project_urls": null,
"split_keywords": [
"flight dynamic",
"satellite",
"space"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "334eb6879bf791d1bb3bcf443dedcc25da3c3ecd36f3b2e7a531169dc0b34763",
"md5": "f6e1c67ed07508ad68a1a20ca282fa32",
"sha256": "e2546cc47acb78d62d4c00fe6402df52a42f4def75e7f89c6b6b04ae0228dacc"
},
"downloads": -1,
"filename": "space-command-0.7.3.tar.gz",
"has_sig": false,
"md5_digest": "f6e1c67ed07508ad68a1a20ca282fa32",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3640832,
"upload_time": "2023-08-18T22:54:44",
"upload_time_iso_8601": "2023-08-18T22:54:44.879718Z",
"url": "https://files.pythonhosted.org/packages/33/4e/b6879bf791d1bb3bcf443dedcc25da3c3ecd36f3b2e7a531169dc0b34763/space-command-0.7.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-18 22:54:44",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "space-command"
}
JSON