: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.

.. _surrogate_discipline_examples:

Surrogate discipline
====================

This section illustrates
how to create and use a :class:`.SurrogateDiscipline`.

This :class:`.Discipline` implements the notion of surrogate model,
mainly used to approximate an expensive discipline from samples.

A :class:`.SurrogateDiscipline` wraps a regression model
built from the :mod:`gemseo.mlearning` package.
For those who are interested in machine learning techniques,
such as data transformation and model assessment,
please refer to :ref:`the corresponding examples <machine_learning_examples>`.


.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="We want to build an .Discipline based on a regression model approximating the following discipline with two inputs and two outputs:">

.. only:: html

  .. image:: /examples/surrogate/images/thumb/sphx_glr_plot_surrogate_discipline_thumb.png
    :alt:

  :doc:`/examples/surrogate/plot_surrogate_discipline`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a surrogate discipline</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this section we describe the usage of surrogate model in |g|, which is implemented in the .SurrogateDiscipline class.">

.. only:: html

  .. image:: /examples/surrogate/images/thumb/sphx_glr_plot_surrogate_scenario_thumb.png
    :alt:

  :doc:`/examples/surrogate/plot_surrogate_scenario`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plug a surrogate discipline in a Scenario</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/surrogate/plot_surrogate_discipline
   /examples/surrogate/plot_surrogate_scenario


.. 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: surrogate_python.zip </examples/surrogate/surrogate_python.zip>`

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

      :download:`Download all examples in Jupyter notebooks: surrogate_jupyter.zip </examples/surrogate/surrogate_jupyter.zip>`


.. only:: html

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

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