Skip to main content

MyRocketSimulator is a Python package designed to simulate spacecrafts launching from Earth and orbiting around it or flying to the Moon.

Project description

Welcome to MyRocketSimulator!

MyRocketSimulator is a Python library for spacecraft orbit propagation around the Earth and missions towards and around the Moon. It provides the simulation environment for the author’s plan to replicate the complete trajectory of Apollo 11, from launch to splashdown. Necessary parts for such an undertaking a continuously added to MRS.

The simulator relies on a high-fidelity propagator that includes all relevant perturbating forces, such as drag, SRP, gravity with spherical harmonics and third body gravity. A published in-depth comparison with GMAT proved its accuracy for Earth orbiting spacecrafts. Download the paper Spacecraft Orbit Propagation with the MyRocketSimulator Python Package.

An early, non-published release of MRS was used to perform a preliminary flight simulation and analysis of the Moon-bound Artemis I mission. Download the paper Preliminary Launch Trajectory Simulation for Artemis I with the Space Launch System.

MRS 1.2 was used to recreate the actual launch trajectory of Artemis I by optimizing control parameters, aiming to reach a known statevector of the spacecraft some time after trans-lunar injection. Read the paper Artemis I Launch Trajectory Reconstruction with the MyRocketSimulator Python Package.

Relevant features of MRS 1.2:

  • Multi-segment simulations providing distinct force configurations and delta-v maneuvers.
  • Earth and Moon gravity with spherical harmonics using pyshtools.
  • Solid tides for Earth and Moon.
  • Third bodies (Sun, Venus, Mars, Jupiter, Moon).
  • Precise ephemeris and coordinate transformations through Skyfield.
  • Atmospheric modelling with PyNRLMSISE-00.
  • DOP853 integration from SciPy.
  • Data frame export, including more than 60 run-time variables.
  • Import of external state vectors for 1:1 trajectory comparison.
  • Spacecraft modelling based on different parts with individual stages and engines.
  • Attitude control in different frames, such as local ENU, launchsite ENU, VNB, relative to inertial and Earth-fixed velocity.
  • Delta-v maneuvers in different frames.
  • Pre-configured visualizations.

The typical workflow of MRS has three steps:

  • Define the mission settings, e.g. by writing your own mission file or editing a provided file.
  • Run the propagation.
  • Add required data and export the data frame for further use.

Exemplary visualization of flight with two delta-v maneuvers in order to raise the spacecraft's altitude: GCRF view of satellite with Hohmann transfer to higher altitude

Installation

PyPI

MRS can be automatically installed trough its release on PyPI (Link). Simply execute the following command:

pip install myrocketsimulator

Github

The MRS library can be manually downloaded from Gibthub (Link). After downloading the repository, simply execute the following command in its top folder:

pip install .

Getting started

After installation, you are ready to start with your first simulation. The following code performs a 24-hour propagation of the ISS, using the included MRS default mission. Please note that Skyfield and spaceweather will require an internet connection to download relevant data, such as ephemeris files.

# import MRS libraries
from myrocketsimulator import MRSlib, MRSvislib

# make MRSMission object with the default MRS mission
MRSdemo0mission = MRSlib.MRSmission('defaultMRSmission')

# run mission
MRSdemo0mission.run_mission()

# add latitude and longitude data to the data frame 
MRSdemo0mission.expand_DFname(['EarthLLA'])

# make MRSvislib object with the performed mission
MRSdemo0viewer = MRSvislib.MRSviewer(MRSdemo0mission)

# show ground track
MRSdemo0viewer.plot_GroundtrackEarth()

The console output will be:

MRS:		Using default mission.
MRS:		Loading mission object 'defaultMRSmission'.
MRS:		Mission 'Default MRS Mission (ISS)' loaded.
MRS:		Checking mission data validity.
MRS:		Loading Default MRS spacecraft (ISS) as static spacecraft.
MRS:		Mission data valid.
MRS:		Running mission Default MRS Mission (ISS).
MRS:		Processing mission segment 0.
MRS:		Mission ended. Processing time: 1.301 seconds.
MRS:		Adding Earth LLA to dataframe.
MRSviewer:	Loading dataframe of mission Default MRS Mission Update.

The ground track will be shown as a figure: GCRF view of satellite with Hohmann transfer to higher altitude

Demo missions

The github repository contains demo missions that demonstrate different features of MyRocketSimulator. They can be used as template for your own missions.

  • MRSexample0: simple propagation of the ISS (see Getting started)
  • MRSexample1: satellite propagation and GMAT comparison
  • MRSexample2: high accurate propagation with GMAT orbital element comparison
  • MRSexample3: two delta-v maneuvers to perform a Hohmann transfer

Demo missions including features from MRS 1.2 such as spacecraft modelling and guidance to simulate actual launch trajectories will be added in future.

Documentation

MRS does currently not provide its own help function or further documentation, but can be easily learned by using the following resources:

print(MRSlib.MRSmission.load_mission.__doc__)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

myrocketsimulator-1.2.0.tar.gz (7.7 MB view details)

Uploaded Source

Built Distribution

myrocketsimulator-1.2.0-py3-none-any.whl (7.7 MB view details)

Uploaded Python 3

File details

Details for the file myrocketsimulator-1.2.0.tar.gz.

File metadata

  • Download URL: myrocketsimulator-1.2.0.tar.gz
  • Upload date:
  • Size: 7.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.6

File hashes

Hashes for myrocketsimulator-1.2.0.tar.gz
Algorithm Hash digest
SHA256 5fb98b91185f65badb1a594f60bb5e3a2eb9d991c5bf54f3fbfce89cddef272a
MD5 620c4bdbb46134dec736890b260d00f8
BLAKE2b-256 6740c8a5b256ddaf13b9976d8492c2f1ffc5d0848d948ac1d7b82540d5277ae2

See more details on using hashes here.

File details

Details for the file myrocketsimulator-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for myrocketsimulator-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5fdb2892b93aaeaddb3d4b0efd987b4e6734ef1da68d4097afed0dd937b5763e
MD5 e2663d1f29e50f8479e990d4390b5cd1
BLAKE2b-256 05793e45cbbe86156138418b1e4abd261eb3ac5fafa5aeb2989cb0ebbeba2b37

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page