Skip to main content

OpenAeroStruct

Project description

OpenAeroStruct

GitHub Actions Status codecov Documentation Status PyPI PyPI - Downloads

OpenAeroStruct is a lightweight tool that performs aerostructural optimization using OpenMDAO. It couples a vortex-lattice method (VLM) and a 6 degrees of freedom 3-dimensional spatial beam model to simulate aerodynamic and structural analyses using lifting surfaces. These simulations are wrapped with an optimizer using NASA's OpenMDAO framework. The analysis and optimization results can be visualized using included tools, producing figures such as these:

With a tubular structure Example

With a wingbox structure Example2

Please note that this repository is provided as is without any guaranteed support. If you would like to highlight issues, ask questions, or make changes, please do so using GitHub Issues and Pull Requests. The developers will address them at their discretion.

The easiest way to get started is by installing OpenAeroStruct via the Python Package Index with

pip install openaerostruct

If you'd like easier access to the examples and source code, install OpenAeroStruct by cloning this repository and entering the folder it generates. Then do:

pip install -e .

Documentation

Please see the documentation for more installation details, walkthroughs, and examples.

Citation

For more background, theory, and figures, see the OpenAeroStruct journal article. Please cite this article when using OpenAeroStruct in your research or curricula.

John P. Jasa, John T. Hwang, and Joaquim R. R. A. Martins. "Open-source coupled aerostructural optimization using Python." Structural and Multidisciplinary Optimization 57.4 (2018): 1815-1827. DOI: 10.1007/s00158-018-1912-8

@article{Jasa2018a,
	Author = {John P. Jasa and John T. Hwang and Joaquim R. R. A. Martins},
	Doi = {10.1007/s00158-018-1912-8},
	Journal = {Structural and Multidisciplinary Optimization},
	Month = {April},
	Number = {4},
	Pages = {1815--1827},
	Publisher = {Springer},
	Title = {Open-source coupled aerostructural optimization using {Python}},
	Volume = {57},
	Year = {2018}}

If using the wingbox model, please cite the following conference paper.

Shamsheer S. Chauhan and Joaquim R. R. A. Martins, “Low-Fidelity Aerostructural Optimization of Aircraft Wings with a Simplified Wingbox Model Using OpenAeroStruct,” Proceedings of the 6th International Conference on Engineering Optimization, EngOpt 2018, Springer, Lisbon, Portugal, September 2018, pp. 418–431. doi:10.1007/978-3-319-97773-7 38

@inproceedings{Chauhan2018b,
	Author = {Shamsheer S. Chauhan and Joaquim R. R. A. Martins},
	Address = {Lisbon, Portugal},
	Booktitle = {Proceedings of the 6th International Conference on Engineering Optimization, EngOpt 2018},
	Doi = {10.1007/978-3-319-97773-7_38},
	Pages = {418-431},
	Publisher = {Springer},
	Title = {Low-Fidelity Aerostructural Optimization of Aircraft Wings with a Simplified Wingbox Model Using {OpenAeroStruct}},
	Year = {2018}}

Version Information

The oldest and latest versions of the dependencies that we test regularly are the following (other versions may work, but no guarantees):

Dependency oldest latest
Python 3.8 3.11
NumPy 1.20 latest
SciPy 1.6.0 latest
OpenMDAO 3.15 latest
MPhys 1.0.0 latest
Matplotlib latest latest
pyGeo (optional) 1.6.0 latest
OpenVSP (optional) 3.27.1 3.27.1

If you are looking to use the previous version of OpenAeroStruct which uses OpenMDAO 1.7.4, use OpenAeroStruct 1.0 from here.

License

Copyright 2018-2023 MDO Lab

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

openaerostruct-2.7.0-py3-none-any.whl (391.7 kB view hashes)

Uploaded Python 3

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