openaerostruct

OpenAeroStruct is a lightweight tool that performs aerostructural optimization using OpenMDAO.

https://github.com/mdolab/openaerostruct

Science Score: 85.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 6 DOI reference(s) in README
  • Academic publication links
    Links to: researchgate.net
  • Committers with academic emails
    14 of 28 committers (50.0%) from academic institutions
  • Institutional organization owner
    Organization mdolab has institutional domain (mdolab.engin.umich.edu)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.9%) to scientific vocabulary

Keywords

aerodynamics open-source openmdao optimization

Keywords from Contributors

mach co-design optimal-control pseudospectral trajectory-optimization

Scientific Fields

Physics Physical Sciences - 40% confidence
Materials Science Physical Sciences - 40% confidence
Last synced: 4 months ago · JSON representation ·

Repository

OpenAeroStruct is a lightweight tool that performs aerostructural optimization using OpenMDAO.

Basic Info
  • Host: GitHub
  • Owner: mdolab
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 14.8 MB
Statistics
  • Stars: 227
  • Watchers: 22
  • Forks: 121
  • Open Issues: 36
  • Releases: 27
Topics
aerodynamics open-source openmdao optimization
Created almost 10 years ago · Last pushed 4 months ago
Metadata Files
Readme License Citation Codeowners

README.md

OpenAeroStruct

Build 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, fuel-weight inertial loads, or structural-weight inertial loads, 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}}

If using point-mass loads or thrust loads, please cite the following conference paper.

John P. Jasa, Shamsheer S. Chauhan, Justin S. Gray, and Joaquim R. R. A. Martins, “How Certain Physical Considerations Impact Aerostructural Wing Optimization,” AIAA/ISSMO Multidisciplinary Analysis and Optimization Conference, Dallas, TX, 2019. doi:10.2514/6.2019-3242

@inproceedings{Jasa2019c, Author = {John P. Jasa and Shamsheer S. Chauhan and Justin S. Gray and Joaquim R. R. A. Martins}, Address = {Dallas, TX}, Booktitle = {AIAA/ISSMO Multidisciplinary Analysis and Optimization Conference}, Doi = {10.2514/6.2019-3242}, Title = {How Certain Physical Considerations Impact Aerostructural Wing Optimization}, Month = {June}, Year = {2019}}

License

Copyright 2018 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.

Owner

  • Name: MDO Lab
  • Login: mdolab
  • Kind: organization

Multidisciplinary Design Optimization Laboratory at the University of Michigan

Citation (CITATION.cff)

cff-version: "1.2.0"
authors:
- family-names: Jasa
  given-names: John P.
  orcid: "https://orcid.org/0000-0001-5442-2792"
- family-names: Hwang
  given-names: John T.
  orcid: "https://orcid.org/0009-0002-5789-6357"
- family-names: Martins
  given-names: Joaquim R. R. A.
  orcid: "https://orcid.org/0000-0003-2143-1478"
doi: 10.1007/s00158-018-1912-8
message: If you use this software, please cite the following paper.
preferred-citation:
  authors:
  - family-names: Jasa
    given-names: John P.
    orcid: "https://orcid.org/0000-0001-5442-2792"
  - family-names: Hwang
    given-names: John T.
    orcid: "https://orcid.org/0009-0002-5789-6357"
  - family-names: Martins
    given-names: Joaquim R. R. A.
    orcid: "https://orcid.org/0000-0003-2143-1478"
  title: "Open-source coupled aerostructural optimization using Python"
  journal: "Structural and Multidisciplinary Optimization"
  volume: "57"
  number: "4"
  pages: "1815--1827"
  date: "2018-04"
  doi: "10.1007/s00158-018-1912-8"

GitHub Events

Total
  • Create event: 12
  • Issues event: 9
  • Release event: 4
  • Watch event: 28
  • Delete event: 6
  • Member event: 5
  • Issue comment event: 28
  • Push event: 43
  • Pull request event: 26
  • Pull request review event: 68
  • Pull request review comment event: 53
  • Fork event: 4
Last Year
  • Create event: 12
  • Issues event: 9
  • Release event: 4
  • Watch event: 28
  • Delete event: 6
  • Member event: 5
  • Issue comment event: 28
  • Push event: 43
  • Pull request event: 26
  • Pull request review event: 68
  • Pull request review comment event: 53
  • Fork event: 4

Committers

Last synced: almost 2 years ago

All Time
  • Total Commits: 1,415
  • Total Committers: 28
  • Avg Commits per committer: 50.536
  • Development Distribution Score (DDS): 0.442
Past Year
  • Commits: 14
  • Committers: 5
  • Avg Commits per committer: 2.8
  • Development Distribution Score (DDS): 0.714
Top Committers
Name Email Commits
johnjasa j****1@g****m 789
Justin Gray j****y@g****m 103
Kenneth-T-Moore k****1@n****v 98
John T. Hwang h****t@u****u 94
shamsheersc19 s****u@u****u 53
Neil Wu n****u@u****u 49
hwangjt h****t@J****l 39
Sam Friedman s****x@o****m 36
kmarsteller k****r@n****v 35
Shugo Kaneko 4****h 24
nbons n****s@u****u 17
John Hwang h****t@J****l 15
Eytan Adler 6****r 12
EliotAH e****n@g****m 10
Mostafa Meliani m****a@g****m 6
Kelvin Leung l****m@u****u 6
yqliaohk y****o@u****u 5
Tim Brooks 4****b 5
Charles Mader c****r@C****l 4
Joaquim R. R. A. Martins j****m@u****u 4
cmader c****r@u****u 2
lucaeros 9****s 2
Andrew Lamkin l****a@u****u 2
Ben Brelje b****e@u****u 1
Bret Naylor n****b@g****m 1
Bernardo Bahia Monteiro b****a@u****u 1
John Jasa j****a@p****v 1
acmarta a****a@h****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 63
  • Total pull requests: 102
  • Average time to close issues: 9 months
  • Average time to close pull requests: 13 days
  • Total issue authors: 28
  • Total pull request authors: 15
  • Average comments per issue: 2.0
  • Average comments per pull request: 2.62
  • Merged pull requests: 83
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 6
  • Pull requests: 25
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 21 days
  • Issue authors: 6
  • Pull request authors: 3
  • Average comments per issue: 1.83
  • Average comments per pull request: 0.88
  • Merged pull requests: 18
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • kanekosh (12)
  • johnjasa (8)
  • nwu63 (5)
  • shamsheersc19 (4)
  • Aviatims (4)
  • xiaoh4i (3)
  • jexalto (2)
  • jdebecdelievre (2)
  • eytanadler (2)
  • x3oo (2)
  • sabakhshi (2)
  • marcomangano (1)
  • fmamitrotta (1)
  • ewu63 (1)
  • lucaeros (1)
Pull Request Authors
  • kanekosh (37)
  • sabakhshi (18)
  • eytanadler (16)
  • shamsheersc19 (12)
  • timryanb (12)
  • A-CGray (10)
  • RemyCharayron (2)
  • lamkina (2)
  • acmarta (2)
  • eirikurj (2)
  • lucaeros (2)
  • nwu63 (1)
  • Kenneth-T-Moore (1)
  • vishhh17 (1)
  • vishhwamehta (1)
Top Labels
Issue Labels
bug (8) maintenance (2) help wanted (1) good first issue (1) question (1)
Pull Request Labels
documentation (1) maintenance (1)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 2,980 last-month
  • Total dependent packages: 2
    (may contain duplicates)
  • Total dependent repositories: 0
    (may contain duplicates)
  • Total versions: 60
  • Total maintainers: 1
proxy.golang.org: github.com/mdolab/openaerostruct
  • Versions: 23
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 6.5%
Average: 6.7%
Dependent repos count: 7.0%
Last synced: 4 months ago
proxy.golang.org: github.com/mdolab/OpenAeroStruct
  • Versions: 23
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 6.5%
Average: 6.7%
Dependent repos count: 7.0%
Last synced: 4 months ago
pypi.org: openaerostruct

OpenAeroStruct

  • Versions: 14
  • Dependent Packages: 2
  • Dependent Repositories: 0
  • Downloads: 2,980 Last month
Rankings
Dependent packages count: 2.9%
Forks count: 4.5%
Stargazers count: 5.8%
Downloads: 9.5%
Average: 10.7%
Dependent repos count: 30.6%
Maintainers (1)
Last synced: 4 months ago

Dependencies

.github/workflows/oas.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v3 composite
setup.py pypi
  • Remember *
  • matplotlib *
  • numpy >=1.20
  • openmdao >=3.15
  • scipy >=1.6.0