LinuxCommandLibrary

kosmorro

Execute actions automatically based on scheduled times

TLDR

Get ephemerides for Paris, France

$ kosmorro --latitude=[48.7996] --longitude=[2.3511]
copy

Get ephemerides for Paris, France, in the UTC+2 timezone
$ kosmorro --latitude=[48.7996] --longitude=[2.3511] --timezone=[2]
copy

Get ephemerides for Paris, France, on June 9th, 2020
$ kosmorro --latitude=[48.7996] --longitude=[2.3511] --date=[2020-06-09]
copy

Generate a PDF (Note: TeXLive must be installed)
$ kosmorro --format=[pdf] --output=[path/to/file.pdf]
copy

SYNOPSIS

kosmorro {} []

kosmorro cli
kosmorro gui
kosmorro api [--host

] [--port ] [--debug]
kosmorro console

PARAMETERS

cli
    Launches the interactive command-line interface for Kosmorro, providing a dedicated shell environment for planning and simulation.

gui
    Starts the graphical user interface of Kosmorro, offering a visual way to interact with the software's features.

api
    Launches the RESTful API server for programmatic access to Kosmorro's features, allowing integration with other applications.

console
    Opens an interactive Python console with the Kosmorro library pre-loaded, useful for direct scripting and development.

--host


    For the api subcommand, specifies the host address on which the API server will listen (default: 0.0.0.0, meaning all available interfaces).

--port
    For the api subcommand, specifies the port number on which the API server will listen (default: 8000).

--debug
    For the api subcommand, enables debug mode for the API server, providing more verbose output and potentially developer tools.

DESCRIPTION

Kosmorro is an open-source, Python-based application designed for personal space travel planning. It offers robust tools for orbital mechanics simulation, enabling users to determine celestial body positions, calculate orbits, and find optimal trajectories. The software also incorporates a spacecraft builder to define vehicle characteristics like mass and delta-v, and includes a comprehensive database of celestial bodies, spacecraft, and spaceports. Kosmorro supports multiple modes of interaction: as a Python library, through its graphical user interface (GUI), or via its command-line interface (CLI). The CLI primarily consists of interactive subcommands, allowing users to explore and plan within a dedicated shell environment or launch its various services.

CAVEATS

Kosmorro is not a standard Linux system utility; it must be installed as a Python package, typically via pip. Its command-line interface is primarily designed for interactive subcommands rather than single-shot scriptable operations (with the exception of launching services like the API). Data for celestial bodies and spacecraft may require initial download or updates.

INSTALLATION

Kosmorro is typically installed using Python's package manager. You can install it with: pip install kosmorro. Ensure you have a compatible Python environment (e.g., Python 3.8+).

INTERACTIVE CLI

When you run kosmorro cli, you enter an interactive shell where you can type commands like 'plan_trip', 'show_body', etc., rather than passing all arguments directly on the initial command line. Type 'help' within the shell for a list of available commands.

HISTORY

Kosmorro is an actively developed, open-source project hosted on GitHub, created to provide a comprehensive personal space travel planning tool. Its development leverages modern Python libraries for its various components, including argparse for CLI parsing, cmd2 for interactive shell features, FastAPI for the API, and PyQt for the GUI. This contemporary stack suggests a focus on maintainability and user experience from its inception.

SEE ALSO

python(1), pip(1)

Copied to clipboard