/openconcept

OpenConcept: A toolkit for conceptual MDAO of aircraft with unconventional propulsion architectures

Primary LanguagePythonMIT LicenseMIT

OpenConcept - A conceptual design toolkit with efficient gradients implemented in the OpenMDAO framework

Authors: Benjamin J. Brelje and Eytan J. Adler

Build Coverage Documentation PyPI PyPI - Downloads

OpenConcept is a new toolkit for the conceptual design of aircraft. OpenConcept was developed in order to model and optimize aircraft with electric propulsion at low computational cost. The tools are built on top of NASA Glenn's OpenMDAO framework, which in turn is written in Python.

OpenConcept is capable of modeling a wide range of propulsion systems, including detailed thermal management systems. The following figure (from this paper) shows one such system that is modeled in the N3_HybridSingleAisle_Refrig.py example.

The following charts show more than 250 individually optimized hybrid-electric light twin aircraft (similar to a King Air C90GT). Optimizing hundreds of configurations can be done in a couple of hours on a standard laptop computer.

Example charts

The reason for OpenConcept's efficiency is the analytic derivatives built into each analysis routine and component. Accurate, efficient derivatives enable the use of Newton nonlinear equation solutions and gradient-based optimization at low computational cost.

Documentation

Automatically-generated documentation is available at (https://mdolab-openconcept.readthedocs-hosted.com/en/latest/).

To build the docs locally, install the sphinx_mdolab_theme via pip. Then enter the doc folder in the root directory and run make html. The built documentation can be viewed by opening _build/html/index.html. OpenAeroStruct is required (also installable via pip) to build the OpenAeroStruct portion of the source docs.

Getting Started

OpenConcept can be pip installed directly from PyPI

pip install openconcept

To run the examples or edit the source code:

  1. Clone the repo to disk (git clone https://github.com/mdolab/openconcept)
  2. Navigate to the root openconcept folder
  3. Run pip install -e . to install the package (the -e can be omitted if not editing the source)

Get started by following the tutorials in the documentation to learn the most important parts of OpenConcept. The features section of the documentation describes most of the components and system models available in OpenConcept.

Requirements

This toolkit requires the use of OpenMDAO 3.10.0 or later. OpenMDAO requires a late NumPy and SciPy.

The latest versions all tests have passed on are

Package Version
Python 3.10.4
OpenMDAO 3.16.0
NumPy 1.22.4
SciPy 1.7.3
OpenAeroStruct 2.5.1

Citation

Please cite this software by reference to the conference paper:

Benjamin J. Brelje and Joaquim R.R.A. Martins, "Development of a Conceptual Design Model for Aircraft Electric Propulsion with Efficient Gradients", 2018 AIAA/IEEE Electric Aircraft Technologies Symposium, AIAA Propulsion and Energy Forum, (AIAA 2018-4979) DOI: 10.2514/6.2018-4979

@inproceedings{Brelje2018a,
	address = {{C}incinnati,~{OH}},
	author = {Benjamin J. Brelje and Joaquim R. R. A. Martins},
	booktitle = {Proceedings of the AIAA/IEEE Electric Aircraft Technologies Symposium},
	doi = {10.2514/6.2018-4979},
	month = {July},
	title = {Development of a Conceptual Design Model for Aircraft Electric Propulsion with Efficient Gradients},
	year = {2018}
	}

If using the integrated OpenAeroStruct VLM or aerostructural aerodynamic models, please cite the following conference paper:

Eytan J. Adler and Joaquim R.R.A. Martins, "Aerostructural wing design optimization considering full mission analysis", 2022 AIAA SciTech Forum, San Diego, CA, January 2022. DOI: 10.2514/6.2022-0382

@inproceedings{Adler2022a,
	author      = {Eytan J. Adler and Joaquim R. R. A. Martins},
	title       = {Aerostructural wing design optimization considering full mission analysis},
	booktitle   = {AIAA SciTech Forum},
	doi         = {10.2514/6.2022-0382},
	month       = {January},
	year        = {2022}
	}