:orphan:

..
   Copyright 2021 IRT Saint Exupéry, https://www.irt-saintexupery.com

   This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
   International License. To view a copy of this license, visit
   http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative
   Commons, PO Box 1866, Mountain View, CA 94042, USA.

Disciplines
===========

.. toctree::
   :glob:
   :maxdepth: 1
   :hidden:

   **



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Use a data converter">

.. only:: html

  .. image:: /examples/disciplines/images/thumb/sphx_glr_plot_data_converter_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_plot_data_converter.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Use a data converter</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/disciplines/plot_data_converter

..
   Copyright 2021 IRT Saint Exupéry, https://www.irt-saintexupery.com

   This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
   International License. To view a copy of this license, visit
   http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative
   Commons, PO Box 1866, Mountain View, CA 94042, USA.

Fundamentals of disciplines
~~~~~~~~~~~~~~~~~~~~~~~~~~~

A discipline computes output data from input data.



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example, the Jacobian of an .MDODiscipline is checked by derivative approximation.">

.. only:: html

  .. image:: /examples/disciplines/basics/images/thumb/sphx_glr_plot_check_jacobian_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_basics_plot_check_jacobian.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Check the Jacobian of a discipline</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example, we will compute the Jacobians of some outputs of an .MDODiscipline with respec...">

.. only:: html

  .. image:: /examples/disciplines/basics/images/thumb/sphx_glr_plot_compute_jacobian_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_basics_plot_compute_jacobian.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Compute the Jacobian of a discipline analytically</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example, we will compute the Jacobians of some outputs of an .MDODiscipline with respec...">

.. only:: html

  .. image:: /examples/disciplines/basics/images/thumb/sphx_glr_plot_compute_jacobian_fd_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_basics_plot_compute_jacobian_fd.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Compute the Jacobian of a discipline with finite differences</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Create a discipline from an external executable">

.. only:: html

  .. image:: /examples/disciplines/basics/images/thumb/sphx_glr_plot_interface_exec_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_basics_plot_interface_exec.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a discipline from an external executable</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Create a discipline that uses pandas DataFrames">

.. only:: html

  .. image:: /examples/disciplines/basics/images/thumb/sphx_glr_plot_data_frame_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_basics_plot_data_frame.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a discipline that uses pandas DataFrames</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/disciplines/basics/plot_check_jacobian
   /examples/disciplines/basics/plot_compute_jacobian
   /examples/disciplines/basics/plot_compute_jacobian_fd
   /examples/disciplines/basics/plot_interface_exec
   /examples/disciplines/basics/plot_data_frame

..
   Copyright 2021 IRT Saint Exupéry, https://www.irt-saintexupery.com

   This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
   International License. To view a copy of this license, visit
   http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative
   Commons, PO Box 1866, Mountain View, CA 94042, USA.

Grammars for inputs and outputs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

A grammar defines a set of variables from names and possibly types and default values.



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Merge or update a JSONGrammar">

.. only:: html

  .. image:: /examples/disciplines/grammars/images/thumb/sphx_glr_plot_json_grammar_merge_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_grammars_plot_json_grammar_merge.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Merge or update a JSONGrammar</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Use a pydantic grammar">

.. only:: html

  .. image:: /examples/disciplines/grammars/images/thumb/sphx_glr_plot_pydantic_grammar_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_grammars_plot_pydantic_grammar.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Use a pydantic grammar</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/disciplines/grammars/plot_json_grammar_merge
   /examples/disciplines/grammars/plot_pydantic_grammar

..
   Copyright 2021 IRT Saint Exupéry, https://www.irt-saintexupery.com

   This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
   International License. To view a copy of this license, visit
   http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative
   Commons, PO Box 1866, Mountain View, CA 94042, USA.

Different types of disciplines
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

A few examples of templates to help you build your discipline faster.



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Create a discipline from a Python function">

.. only:: html

  .. image:: /examples/disciplines/types/images/thumb/sphx_glr_plot_auto_py_discipline_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_types_plot_auto_py_discipline.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a discipline from a Python function</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Create a discipline from analytical expressions">

.. only:: html

  .. image:: /examples/disciplines/types/images/thumb/sphx_glr_plot_analytic_discipline_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_types_plot_analytic_discipline.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a discipline from analytical expressions</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The .RemappingDiscipline can be used to rename the input and output variables of an original di...">

.. only:: html

  .. image:: /examples/disciplines/types/images/thumb/sphx_glr_plot_remapping_discipline_thumb.png
    :alt:

  :ref:`sphx_glr_examples_disciplines_types_plot_remapping_discipline.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Rename the input and output variables</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/disciplines/types/plot_auto_py_discipline
   /examples/disciplines/types/plot_analytic_discipline
   /examples/disciplines/types/plot_remapping_discipline


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: disciplines_python.zip </examples/disciplines/disciplines_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: disciplines_jupyter.zip </examples/disciplines/disciplines_jupyter.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_