Skip to main content

GitHub Actions Test Badge Coveralls Badge PyPI version PyPI Monthly Downloads

OpenMDAO

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 us!

Documentation

Documentation for the latest development version can be found here.

Documentation for all released versions can be found here.

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), and (2) from the GitHub repository.

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

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
cd OpenMDAO
pip install .

If you would like to make changes to OpenMDAO it is recommended you install it in editable 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]

Using Pixi for reproducable environments

Fully utilizing OpenMDAO means relying on a number of third-party dependencies, notably pyoptsparse, mpi4py, petsc4py, numpy, and scipy. Keeping so many dependencies in sync can be a challenge. To help users, OpenMDAO uses pixi to maintain reproduceable environments. The goal of this is to ensure that users of a given OpenMDAO release can reproduce the environment against which that release was tested.

Starting with version 3.42.0, OpenMDAO provides Pixi environments for dependency management. Pixi is especially useful because some OpenMDAO dependencies (like MPI, PETSc) are not available on PyPI but are needed for parallel computing features.

You can read more about the using OpenMDAO's curated Pixi environments in the "getting started" section of our documentation.

OpenMDAO Versions

OpenMDAO 3.x.y represents the current, supported version. It requires Python 3.10 or later and is maintained here. 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. 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.

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, and install the development dependencies as described here.

  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. 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, but if you would like to build a local copy you can find instructions to do so here.

Download files

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

Source Distribution

openmdao-3.45.1.tar.gz (13.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openmdao-3.45.1-py3-none-any.whl (13.9 MB view details)

Uploaded Python 3

File details

Details for the file openmdao-3.45.1.tar.gz.

File metadata

  • Download URL: openmdao-3.45.1.tar.gz
  • Upload date:
  • Size: 13.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openmdao-3.45.1.tar.gz
Algorithm Hash digest
SHA256 314c5d796c5dbcc4334b70cd9d306cb8f8db78c84918b8406b88ede56d5cc909
MD5 bf11eb1900bf28f9117a455d8410ff5b
BLAKE2b-256 0ecbeb66d984ee6bd3f20f134cebe2096d555231d71fdba9685e59b8a66ca8aa

See more details on using hashes here.

Provenance

The following attestation bundles were made for openmdao-3.45.1.tar.gz:

Publisher: release_workflow.yml on OpenMDAO/OpenMDAO

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file openmdao-3.45.1-py3-none-any.whl.

File metadata

  • Download URL: openmdao-3.45.1-py3-none-any.whl
  • Upload date:
  • Size: 13.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openmdao-3.45.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2ac96fcd3ebd4f3096d527f6f792f4b5ddb8823093c2fff1f89f147159fab6da
MD5 11e65e65469ef9eb8c88df3c8c5fe124
BLAKE2b-256 3d12373995de37a7509106536db43d5779b50f49d3ec4b2b6865835f6ff793a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for openmdao-3.45.1-py3-none-any.whl:

Publisher: release_workflow.yml on OpenMDAO/OpenMDAO

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

3.45.1 This release

2 files

3.45.0

2 files

3.44.0

2 files

3.43.0

2 files

3.42.0

2 files

3.41.0

2 files

3.40.0

2 files

3.39.0

2 files

3.38.0

1 file

3.37.0

2 files

3.36.0

1 file

3.35.0

1 file

3.34.2

1 file

3.34.1

2 files

3.34.0

2 files

3.33.0

1 file

3.32.0

1 file

3.31.1

1 file

3.31.0

1 file

3.30.0

1 file

3.29.0

1 file

3.28.0

1 file

3.27.0

1 file

3.26.0

1 file

3.25.0

1 file

3.24.0

1 file

3.23.0

1 file

3.22.0

1 file

3.21.0

1 file

3.20.0

1 file

3.19.0

1 file

3.18.0

1 file

3.17.0

1 file

3.16.0

1 file

3.15.0

1 file

3.14.0

1 file

3.13.1

1 file

3.13.0

1 file

3.12.0

1 file

3.11.0

1 file

3.10.0

1 file

3.9.2

1 file

3.9.1

1 file

3.9.0

1 file

3.8.0

1 file

3.7.0

1 file

3.6.0

1 file

3.5.0

1 file

3.4.1

1 file

3.4.0

1 file

3.3.0

1 file

3.2.1

1 file

3.2.0

1 file

3.1.1

1 file

3.1.0

1 file

3.0.0

1 file

2.10.1

1 file

2.10.0

1 file

2.9.1

1 file

2.9.0

1 file

2.8.0

1 file

2.7.1

1 file

2.7.0

1 file

2.6.0

1 file

2.5.0

1 file

2.4.0

1 file

2.3.1

1 file

2.3.0

1 file

2.2.1

1 file

2.2.0

1 file

2.1.0

1 file

2.0.2

1 file

1.7.4

1 file

1.7.3

1 file

1.7.2

1 file

1.7.1

1 file

1.7.0

1 file

1.6.4

1 file

1.6.3

1 file

1.6.2

1 file

1.6.1

1 file

1.6.0

1 file

1.5.0

1 file

1.4.1

1 file

1.4.0

1 file

1.3.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page