[![GitHub Actions Test Badge][17]][18]
[![Coveralls Badge][13]][14]
[![PyPI version][10]][11]
[![PyPI Monthly Downloads][12]][11]
# [OpenMDAO][0]
OpenMDAO is an open-source high-performance computing platform for
systems analysis and multidisciplinary optimization, written in Python.
It enables you to decompose your models, making them easier to build and
maintain, while still solving them in a tightly coupled manner with
efficient parallel numerical methods.
The OpenMDAO project is primarily focused on supporting gradient-based
optimization with analytic derivatives to allow you to explore large
design spaces with hundreds or thousands of design variables, but the
framework also has a number of parallel computing features that can
work with gradient-free optimization, mixed-integer nonlinear
programming, and traditional design space exploration.
If you are using OpenMDAO, please [cite][20] us!
## Documentation
Documentation for the latest version can be found [here][2].
Documentation archives for prior versions can be found [here][3].
## Important Notice
While the API is relatively stable, **OpenMDAO** remains in active development.
There will be periodic changes to the API.
User's are encouraged to pin their version of OpenMDAO to a recent release and
update periodically.
## Install OpenMDAO
You have two options for installing **OpenMDAO**, (1) from the
[Python Package Index (PyPI)][1], and (2) from the [GitHub repository][4].
**OpenMDAO** includes several optional sets of dependencies including:
`test` for installing the developer tools (e.g., testing, coverage),
`docs` for building the documentation and
`visualization` for some extra visualization tools.
Specifying `all` will include all of the optional dependencies.
### Install from [PyPI][1]
This is the easiest way to install **OpenMDAO**. To install only the runtime
dependencies:
pip install openmdao
To install all the optional dependencies:
pip install openmdao[all]
### Install from a Cloned Repository
This allows you to install **OpenMDAO** from a local copy of the source code.
git clone http://github.com/OpenMDAO/OpenMDAO
pip install OpenMDAO
If you would like to make changes to **OpenMDAO** it is recommended you
install it in *[editable][16]* mode (i.e., development mode) by adding the `-e`
flag when calling `pip`, this way any changes you make to the source code will
be included when you import **OpenMDAO** in *Python*. You will also want to
install the packages necessary for running **OpenMDAO**'s tests and documentation
generator. You can install everything needed for development by running:
pip install -e OpenMDAO[all]
## OpenMDAO Versions
**OpenMDAO 3.x.y** represents the current, supported version. It requires Python 3.8
or later and is maintained [here][4]. To upgrade to the latest release, run:
pip install --upgrade openmdao
**OpenMDAO 2.10.x** was the last version to support Python 2.x and is no longer supported.
To install this older release, run:
pip install "openmdao<3"
**OpenMDAO 1.7.4** was an earlier version of OpenMDAO and is also no longer supported.
The code repository is now named **OpenMDAO1**, and has moved [here][5]. To install it, run:
pip install "openmdao<2"
The legacy **OpenMDAO v0.x** (versions 0.13.0 and older) of the
**OpenMDAO-Framework** are [here][6].
## Test OpenMDAO
Users are encouraged to run the unit tests to ensure **OpenMDAO** is performing
correctly. In order to do so, you must install the testing dependencies.
1. Install **OpenMDAO** and its testing dependencies:
`pip install openmdao[test]`
> Alternatively, you can clone the repository, as explained
[here](#install-from-a-cloned-repository), and install the development
dependencies as described [here](#install-the-developer-dependencies).
2. Run tests:
`testflo openmdao -n 1`
3. If everything works correctly, you should see a message stating that there
were zero failures. If the tests produce failures, you are encouraged to report
them as an [issue][7]. If so, please make sure you include your system spec,
and include the error message.
> If tests fail, please include your system information, you can obtain
that by running the following commands in *python* and copying the results
produced by the last line.
import platform, sys
info = platform.uname()
(info.system, info.version), (info.machine, info.processor), sys.version
> Which should produce a result similar to:
(('Windows', '10.0.17134'),
('AMD64', 'Intel64 Family 6 Model 94 Stepping 3, GenuineIntel'),
'3.6.6 | packaged by conda-forge | (default, Jul 26 2018, 11:48:23) ...')
## Build the Documentation for OpenMDAO
Documentation for the latest version can always be found [here][2], but if you would like to build a local copy you can find instructions to do so [here][19].
[0]: http://openmdao.org/ "OpenMDAO"
[1]: https://pypi.org/project/openmdao/ "OpenMDAO @PyPI"
[2]: http://openmdao.org/newdocs/versions/latest "Latest Docs"
[3]: http://openmdao.org/docs "Archived Docs"
[4]: https://github.com/OpenMDAO/OpenMDAO "OpenMDAO Git Repo"
[5]: https://github.com/OpenMDAO/OpenMDAO1 "OpenMDAO 1.x Git Repo"
[6]: https://github.com/OpenMDAO/OpenMDAO-Framework "OpenMDAO Framework Git Repo"
[7]: https://github.com/OpenMDAO/OpenMDAO/issues/new "Make New OpenMDAO Issue"
[8]: https://help.github.com/articles/changing-a-remote-s-url/ "Update Git Remote URL"
[10]: https://badge.fury.io/py/openmdao.svg "PyPI Version"
[11]: https://badge.fury.io/py/openmdao "OpenMDAO @PyPI"
[12]: https://img.shields.io/pypi/dm/openmdao "PyPI Monthly Downloads"
[13]: https://coveralls.io/repos/github/OpenMDAO/OpenMDAO/badge.svg?branch=master "Coverage Badge"
[14]: https://coveralls.io/github/OpenMDAO/OpenMDAO?branch=master "OpenMDAO @Coveralls"
[15]: https://en.wikipedia.org/wiki/Software_release_life_cycle#Beta "Wikipedia Beta"
[16]: https://setuptools.readthedocs.io/en/latest/setuptools.html#development-mode "Pip Editable Mode"
[17]: https://github.com/OpenMDAO/OpenMDAO/actions/workflows/openmdao_test_workflow.yml/badge.svg "Github Actions Badge"
[18]: https://github.com/OpenMDAO/OpenMDAO/actions "Github Actions"
[19]: http://openmdao.org/newdocs/versions/latest/other_useful_docs/developer_docs/doc_build.html
[20]: https://openmdao.org/newdocs/versions/latest/other/citing.html
Raw data
{
"_id": null,
"home_page": "http://openmdao.org",
"name": "openmdao",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "optimization multidisciplinary multi-disciplinary analysis",
"author": "OpenMDAO Team",
"author_email": "openmdao@openmdao.org",
"download_url": "https://files.pythonhosted.org/packages/05/d9/25ef5d06cd8bf8a1f108534b00cfd5a77f23da2eaab8ae5b696201e3d490/openmdao-3.31.1.tar.gz",
"platform": null,
"description": "[![GitHub Actions Test Badge][17]][18]\n[![Coveralls Badge][13]][14]\n[![PyPI version][10]][11]\n[![PyPI Monthly Downloads][12]][11]\n\n# [OpenMDAO][0]\n\nOpenMDAO is an open-source high-performance computing platform for\nsystems analysis and multidisciplinary optimization, written in Python.\nIt enables you to decompose your models, making them easier to build and\nmaintain, while still solving them in a tightly coupled manner with\nefficient parallel numerical methods.\n\nThe OpenMDAO project is primarily focused on supporting gradient-based\noptimization with analytic derivatives to allow you to explore large\ndesign spaces with hundreds or thousands of design variables, but the\nframework also has a number of parallel computing features that can\nwork with gradient-free optimization, mixed-integer nonlinear\nprogramming, and traditional design space exploration.\n\nIf you are using OpenMDAO, please [cite][20] us!\n\n## Documentation\n\nDocumentation for the latest version can be found [here][2].\n\nDocumentation archives for prior versions can be found [here][3].\n\n## Important Notice\n\nWhile the API is relatively stable, **OpenMDAO** remains in active development.\nThere will be periodic changes to the API.\nUser's are encouraged to pin their version of OpenMDAO to a recent release and\nupdate periodically.\n\n## Install OpenMDAO\n\nYou have two options for installing **OpenMDAO**, (1) from the\n[Python Package Index (PyPI)][1], and (2) from the [GitHub repository][4].\n\n**OpenMDAO** includes several optional sets of dependencies including:\n`test` for installing the developer tools (e.g., testing, coverage),\n`docs` for building the documentation and\n`visualization` for some extra visualization tools.\nSpecifying `all` will include all of the optional dependencies.\n\n### Install from [PyPI][1]\n\nThis is the easiest way to install **OpenMDAO**. To install only the runtime\ndependencies:\n\n pip install openmdao\n\nTo install all the optional dependencies:\n\n pip install openmdao[all]\n\n### Install from a Cloned Repository\n\nThis allows you to install **OpenMDAO** from a local copy of the source code.\n\n git clone http://github.com/OpenMDAO/OpenMDAO\n pip install OpenMDAO\n\nIf you would like to make changes to **OpenMDAO** it is recommended you\ninstall it in *[editable][16]* mode (i.e., development mode) by adding the `-e`\nflag when calling `pip`, this way any changes you make to the source code will\nbe included when you import **OpenMDAO** in *Python*. You will also want to\ninstall the packages necessary for running **OpenMDAO**'s tests and documentation\ngenerator. You can install everything needed for development by running:\n\n pip install -e OpenMDAO[all]\n\n## OpenMDAO Versions\n\n**OpenMDAO 3.x.y** represents the current, supported version. It requires Python 3.8\nor later and is maintained [here][4]. To upgrade to the latest release, run:\n\n pip install --upgrade openmdao\n\n**OpenMDAO 2.10.x** was the last version to support Python 2.x and is no longer supported.\nTo install this older release, run:\n\n pip install \"openmdao<3\"\n\n**OpenMDAO 1.7.4** was an earlier version of OpenMDAO and is also no longer supported.\nThe code repository is now named **OpenMDAO1**, and has moved [here][5]. To install it, run:\n\n pip install \"openmdao<2\"\n\nThe legacy **OpenMDAO v0.x** (versions 0.13.0 and older) of the\n**OpenMDAO-Framework** are [here][6].\n\n## Test OpenMDAO\n\nUsers are encouraged to run the unit tests to ensure **OpenMDAO** is performing\ncorrectly. In order to do so, you must install the testing dependencies.\n\n1. Install **OpenMDAO** and its testing dependencies:\n\n `pip install openmdao[test]`\n\n > Alternatively, you can clone the repository, as explained\n [here](#install-from-a-cloned-repository), and install the development\n dependencies as described [here](#install-the-developer-dependencies).\n\n2. Run tests:\n\n `testflo openmdao -n 1`\n\n3. If everything works correctly, you should see a message stating that there\nwere zero failures. If the tests produce failures, you are encouraged to report\nthem as an [issue][7]. If so, please make sure you include your system spec,\nand include the error message.\n\n > If tests fail, please include your system information, you can obtain\n that by running the following commands in *python* and copying the results\n produced by the last line.\n\n import platform, sys\n\n info = platform.uname()\n (info.system, info.version), (info.machine, info.processor), sys.version\n\n > Which should produce a result similar to:\n\n (('Windows', '10.0.17134'),\n ('AMD64', 'Intel64 Family 6 Model 94 Stepping 3, GenuineIntel'),\n '3.6.6 | packaged by conda-forge | (default, Jul 26 2018, 11:48:23) ...')\n\n## Build the Documentation for OpenMDAO\n\nDocumentation for the latest version can always be found [here][2], but if you would like to build a local copy you can find instructions to do so [here][19].\n\n[0]: http://openmdao.org/ \"OpenMDAO\"\n[1]: https://pypi.org/project/openmdao/ \"OpenMDAO @PyPI\"\n\n[2]: http://openmdao.org/newdocs/versions/latest \"Latest Docs\"\n[3]: http://openmdao.org/docs \"Archived Docs\"\n\n[4]: https://github.com/OpenMDAO/OpenMDAO \"OpenMDAO Git Repo\"\n[5]: https://github.com/OpenMDAO/OpenMDAO1 \"OpenMDAO 1.x Git Repo\"\n[6]: https://github.com/OpenMDAO/OpenMDAO-Framework \"OpenMDAO Framework Git Repo\"\n\n[7]: https://github.com/OpenMDAO/OpenMDAO/issues/new \"Make New OpenMDAO Issue\"\n\n[8]: https://help.github.com/articles/changing-a-remote-s-url/ \"Update Git Remote URL\"\n\n[10]: https://badge.fury.io/py/openmdao.svg \"PyPI Version\"\n[11]: https://badge.fury.io/py/openmdao \"OpenMDAO @PyPI\"\n\n[12]: https://img.shields.io/pypi/dm/openmdao \"PyPI Monthly Downloads\"\n\n[13]: https://coveralls.io/repos/github/OpenMDAO/OpenMDAO/badge.svg?branch=master \"Coverage Badge\"\n[14]: https://coveralls.io/github/OpenMDAO/OpenMDAO?branch=master \"OpenMDAO @Coveralls\"\n\n[15]: https://en.wikipedia.org/wiki/Software_release_life_cycle#Beta \"Wikipedia Beta\"\n\n[16]: https://setuptools.readthedocs.io/en/latest/setuptools.html#development-mode \"Pip Editable Mode\"\n\n[17]: https://github.com/OpenMDAO/OpenMDAO/actions/workflows/openmdao_test_workflow.yml/badge.svg \"Github Actions Badge\"\n[18]: https://github.com/OpenMDAO/OpenMDAO/actions \"Github Actions\"\n\n[19]: http://openmdao.org/newdocs/versions/latest/other_useful_docs/developer_docs/doc_build.html\n\n[20]: https://openmdao.org/newdocs/versions/latest/other/citing.html\n",
"bugtrack_url": null,
"license": "Apache License, Version 2.0",
"summary": "OpenMDAO framework infrastructure",
"version": "3.31.1",
"project_urls": {
"Homepage": "http://openmdao.org"
},
"split_keywords": [
"optimization",
"multidisciplinary",
"multi-disciplinary",
"analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05d925ef5d06cd8bf8a1f108534b00cfd5a77f23da2eaab8ae5b696201e3d490",
"md5": "5647f377bd9e938ae55b19f7c80a2f45",
"sha256": "83b8f6642ed2f54d02a61fce5ce4271038e845f6d0c43d7fee474ccb504e2ec9"
},
"downloads": -1,
"filename": "openmdao-3.31.1.tar.gz",
"has_sig": false,
"md5_digest": "5647f377bd9e938ae55b19f7c80a2f45",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5753599,
"upload_time": "2024-03-15T23:05:47",
"upload_time_iso_8601": "2024-03-15T23:05:47.880696Z",
"url": "https://files.pythonhosted.org/packages/05/d9/25ef5d06cd8bf8a1f108534b00cfd5a77f23da2eaab8ae5b696201e3d490/openmdao-3.31.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-15 23:05:47",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "openmdao"
}
JSON