Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cuspaceflight/campyros

CamPyRoS (Cambridge Python Rocketry Simulator) is a Python package which provides fully featured rocket trajectory simulation
https://github.com/cuspaceflight/campyros

aerodynamics heating rockets stochastic-analysis trajectory trajectory-prediction wind

Last synced: about 2 months ago
JSON representation

CamPyRoS (Cambridge Python Rocketry Simulator) is a Python package which provides fully featured rocket trajectory simulation

Host: GitHub
URL: https://github.com/cuspaceflight/campyros
Owner: cuspaceflight
License: gpl-3.0
Created: 2020-10-31T09:30:53.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2021-07-27T17:48:01.000Z (over 3 years ago)
Last Synced: 2024-06-11T17:30:32.307Z (6 months ago)
Topics: aerodynamics, heating, rockets, stochastic-analysis, trajectory, trajectory-prediction, wind
Language: Jupyter Notebook
Homepage: https://campyros.readthedocs.io/
Size: 37.5 MB
Stars: 19
Watchers: 4
Forks: 5
Open Issues: 2
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # CamPyRoS - A 6DOF Rocket Trajectory Simulator

[![DOI](https://zenodo.org/badge/308847422.svg)](https://zenodo.org/badge/latestdoi/308847422) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)[![Testing](https://github.com/cuspaceflight/CamPyRoS/actions/workflows/testcase.yml/badge.svg)](https://github.com/cuspaceflight/CamPyRoS/actions/workflows/testcase.yml)

CamPyRoS (Cambridge Python Rocketry Simulator) is a Python package which provides fully featured rocket trajectory simulation including features like:

- 6 degrees of freedom (3 translational, 3 rotational)

- Monte Carlo stochastic analysis

- Aerodynamic heating model

- Use of live wind data

- Variable mass and moments of inertia models

## Getting started

Currently not all dependancies are supported by the same install methods so the easiest install doesn't contain the full functionality. To install the core library:

`pip install git+https://github.com/cuspaceflight/CamPyRoS.git`  

Statistics has a dependancy not fully supported by windows, to install it:

`pip install ray` on most platforms, for Windows problems see [here](https://docs.ray.io/en/master/installation.html).

If you don't install this the statistics module will run but only single threaded which will be *extremely* slow.

## Usage

The repository contains some examples you can run:

- `example.ipynb` or `example.py` : Launch of a simple rocket (the Martlet 4).

- `Stats Model Example.ipynb` : Example of how to use the statistics model and stochastic analysis.

- `Aerodynamic Heating Example.ipynb` : Example of how to run an aerodynamic heating simulation.

## Helping out

If you would like to contribute please have a look at the [guidelines](CONTRIBUTING.md)

## In progress

- **GUI:** An incomplete (and outdated) GUI has been made using Tkinter, and is in gui.py.

- **Slosh modelling:** Some slosh modelling functions have been put together in slosh.py, based on the following source - [The Dynamic Behavior of Liquids in Moving Containers, with Applications to Space Vehicle Technology](https://ntrs.nasa.gov/citations/19670006555).

- **Wind variability:** Statistical analysis of historic wind forecasts and obervations are analysed to create a Guassian difference profile to vary the wind in the statistical models (see wind-stats branch for a very poorly documented insight to current progress)

## Potential for expansion

- **Multistage rockets**

- **Fin cant, roll damping, and roll acceleration:** [OpenRocket Technical Documentation](http://openrocket.info/documentation.html)

- **CFD coupling:** [PyFoam](https://openfoamwiki.net/index.php/Contrib/PyFoam), [Simulations of 6-DOF Motion

with a Cartesian Method](https://pdfs.semanticscholar.org/ace3/5a61803390b0e0b70f6ca34492ad20a03e03.pdf)

- **Multiphysics coupling:** [PRECICE](https://www.precice.org/)

## Cite as

Daniel Gibbons, & Jago Strong-Wright. (2021, February 11). cuspaceflight/CamPyRoS: First release! (Version V1.0). Zenodo. http://doi.org/10.5281/zenodo.4535672

## Main References

[1] - [Stochastic Six-Degree-of-Freedom Flight Simulator for Passively Controlled High-Power Rockets](https://ascelibrary.org/doi/10.1061/%28ASCE%29AS.1943-5525.0000051)

[2] - [Tangent ogive nose aerodynamic heating program: NQLD019](https://ntrs.nasa.gov/citations/19730063810)

## Additional References

[3] - [NASA Basic Considerations for Rocket Trajectory Simulation](https://apps.dtic.mil/sti/pdfs/AD0642855.pdf)

[4] - [SIX DEGREE OF FREEDOM DIGITAL SIMULATION MODEL FOR UNGUIDED FIN-STABILIZED ROCKETS](https://apps.dtic.mil/dtic/tr/fulltext/u2/452106.pdf)

[5] - [Trajectory Prediction for a Typical Fin Stabilized Artillery Rocket](https://journals.ekb.eg/article_23742_f19c1da1a61e78c1f5bb7ce58a7b30dd.pdf)

[6] - [Central Limit Theorem and Sample Size](https://www.umass.edu/remp/Papers/Smith&Wells_NERA06.pdf)

[7] - [Monte Carlo Simulations: Number of Iterations and Accuracy](https://apps.dtic.mil/dtic/tr/fulltext/u2/a621501.pdf)

[8] - [Method for Calculating Aerodynamic Heating on Sounding Rocket Tangent Ogive Noses](https://arc.aiaa.org/doi/abs/10.2514/3.62081)

[9] - [Six degree-of-freedom (6-DOF) Flight Simulation Check-cases](https://nescacademy.nasa.gov/flightsim/)