.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "examples/post_process/algorithms/plot_robustness.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_examples_post_process_algorithms_plot_robustness.py>`
        to download the full example code

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_examples_post_process_algorithms_plot_robustness.py:


Robustness
==========

In this example, we illustrate the use of the :class:`.Robustness` plot
on the Sobieski's SSBJ problem.

.. GENERATED FROM PYTHON SOURCE LINES 28-35

.. code-block:: default

    from __future__ import annotations

    from gemseo import configure_logger
    from gemseo import create_discipline
    from gemseo import create_scenario
    from gemseo.problems.sobieski.core.problem import SobieskiProblem








.. GENERATED FROM PYTHON SOURCE LINES 36-40

Import
------
The first step is to import some high-level functions
and a method to get the design space.

.. GENERATED FROM PYTHON SOURCE LINES 40-43

.. code-block:: default


    configure_logger()





.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    <RootLogger root (INFO)>



.. GENERATED FROM PYTHON SOURCE LINES 44-59

Description
-----------

In the :class:`.Robustness` post-processing,
the robustness of the optimum is represented by a box plot. Using the
quadratic approximations of all the output functions, we
propagate analytically a normal distribution with 1% standard deviation
on all the design variables, assuming no cross-correlations of inputs,
to obtain the mean and standard deviation of the resulting normal
distribution. A series of samples are randomly generated from the resulting
distribution, whose quartiles are plotted, relatively to the values of
the function at the optimum. For each function (in abscissa), the plot
shows the extreme values encountered in the samples (top and bottom
bars). Then, 95% of the values are within the blue boxes. The average is
given by the red bar.

.. GENERATED FROM PYTHON SOURCE LINES 61-65

Create disciplines
------------------
At this point, we instantiate the disciplines of Sobieski's SSBJ problem:
Propulsion, Aerodynamics, Structure and Mission

.. GENERATED FROM PYTHON SOURCE LINES 65-74

.. code-block:: default

    disciplines = create_discipline(
        [
            "SobieskiPropulsion",
            "SobieskiAerodynamics",
            "SobieskiStructure",
            "SobieskiMission",
        ]
    )








.. GENERATED FROM PYTHON SOURCE LINES 75-78

Create design space
-------------------
We also read the design space from the :class:`.SobieskiProblem`.

.. GENERATED FROM PYTHON SOURCE LINES 78-80

.. code-block:: default

    design_space = SobieskiProblem().design_space








.. GENERATED FROM PYTHON SOURCE LINES 81-88

Create and execute scenario
---------------------------
The next step is to build an MDO scenario in order to maximize the range,
encoded 'y_4', with respect to the design parameters, while satisfying the
inequality constraints 'g_1', 'g_2' and 'g_3'. We can use the MDF formulation,
the SLSQP optimization algorithm
and a maximum number of iterations equal to 100.

.. GENERATED FROM PYTHON SOURCE LINES 88-100

.. code-block:: default

    scenario = create_scenario(
        disciplines,
        formulation="MDF",
        objective_name="y_4",
        maximize_objective=True,
        design_space=design_space,
    )
    scenario.set_differentiation_method()
    for constraint in ["g_1", "g_2", "g_3"]:
        scenario.add_constraint(constraint, "ineq")
    scenario.execute({"algo": "SLSQP", "max_iter": 10})





.. rst-class:: sphx-glr-script-out

 .. code-block:: none

        INFO - 16:25:10:  
        INFO - 16:25:10: *** Start MDOScenario execution ***
        INFO - 16:25:10: MDOScenario
        INFO - 16:25:10:    Disciplines: SobieskiAerodynamics SobieskiMission SobieskiPropulsion SobieskiStructure
        INFO - 16:25:10:    MDO formulation: MDF
        INFO - 16:25:10: Optimization problem:
        INFO - 16:25:10:    minimize -y_4(x_shared, x_1, x_2, x_3)
        INFO - 16:25:10:    with respect to x_1, x_2, x_3, x_shared
        INFO - 16:25:10:    subject to constraints:
        INFO - 16:25:10:       g_1(x_shared, x_1, x_2, x_3) <= 0.0
        INFO - 16:25:10:       g_2(x_shared, x_1, x_2, x_3) <= 0.0
        INFO - 16:25:10:       g_3(x_shared, x_1, x_2, x_3) <= 0.0
        INFO - 16:25:10:    over the design space:
        INFO - 16:25:10:    +-------------+-------------+-------+-------------+-------+
        INFO - 16:25:10:    | name        | lower_bound | value | upper_bound | type  |
        INFO - 16:25:10:    +-------------+-------------+-------+-------------+-------+
        INFO - 16:25:10:    | x_shared[0] |     0.01    |  0.05 |     0.09    | float |
        INFO - 16:25:10:    | x_shared[1] |    30000    | 45000 |    60000    | float |
        INFO - 16:25:10:    | x_shared[2] |     1.4     |  1.6  |     1.8     | float |
        INFO - 16:25:10:    | x_shared[3] |     2.5     |  5.5  |     8.5     | float |
        INFO - 16:25:10:    | x_shared[4] |      40     |   55  |      70     | float |
        INFO - 16:25:10:    | x_shared[5] |     500     |  1000 |     1500    | float |
        INFO - 16:25:10:    | x_1[0]      |     0.1     |  0.25 |     0.4     | float |
        INFO - 16:25:10:    | x_1[1]      |     0.75    |   1   |     1.25    | float |
        INFO - 16:25:10:    | x_2         |     0.75    |   1   |     1.25    | float |
        INFO - 16:25:10:    | x_3         |     0.1     |  0.5  |      1      | float |
        INFO - 16:25:10:    +-------------+-------------+-------+-------------+-------+
        INFO - 16:25:10: Solving optimization problem with algorithm SLSQP:
        INFO - 16:25:10: ...   0%|          | 0/10 [00:00<?, ?it]
        INFO - 16:25:11: ...  10%|█         | 1/10 [00:00<00:00, 10.15 it/sec, obj=-536]
        INFO - 16:25:11: ...  20%|██        | 2/10 [00:00<00:01,  7.38 it/sec, obj=-2.12e+3]
     WARNING - 16:25:11: MDAJacobi has reached its maximum number of iterations but the normed residual 1.4486313079508508e-06 is still above the tolerance 1e-06.
        INFO - 16:25:11: ...  30%|███       | 3/10 [00:00<00:01,  6.32 it/sec, obj=-3.75e+3]
        INFO - 16:25:11: ...  40%|████      | 4/10 [00:00<00:00,  6.13 it/sec, obj=-4.01e+3]
     WARNING - 16:25:11: MDAJacobi has reached its maximum number of iterations but the normed residual 2.928004141058104e-06 is still above the tolerance 1e-06.
        INFO - 16:25:11: ...  50%|█████     | 5/10 [00:00<00:00,  5.86 it/sec, obj=-4.49e+3]
        INFO - 16:25:11: ...  60%|██████    | 6/10 [00:01<00:00,  5.93 it/sec, obj=-3.4e+3]
        INFO - 16:25:11: ...  70%|███████   | 7/10 [00:01<00:00,  6.52 it/sec, obj=-4.93e+3]
        INFO - 16:25:12: ...  80%|████████  | 8/10 [00:01<00:00,  6.88 it/sec, obj=-4.76e+3]
        INFO - 16:25:12: ...  90%|█████████ | 9/10 [00:01<00:00,  7.24 it/sec, obj=-4.62e+3]
        INFO - 16:25:12: ... 100%|██████████| 10/10 [00:01<00:00,  7.61 it/sec, obj=-4.56e+3]
        INFO - 16:25:12: Optimization result:
        INFO - 16:25:12:    Optimizer info:
        INFO - 16:25:12:       Status: None
        INFO - 16:25:12:       Message: Maximum number of iterations reached. GEMSEO Stopped the driver
        INFO - 16:25:12:       Number of calls to the objective function by the optimizer: 12
        INFO - 16:25:12:    Solution:
        INFO - 16:25:12:       The solution is feasible.
        INFO - 16:25:12:       Objective: -3749.8868975554387
        INFO - 16:25:12:       Standardized constraints:
        INFO - 16:25:12:          g_1 = [-0.01671296 -0.03238836 -0.04350867 -0.05123129 -0.05681738 -0.13780658
        INFO - 16:25:12:  -0.10219342]
        INFO - 16:25:12:          g_2 = -0.0004062839430756249
        INFO - 16:25:12:          g_3 = [-0.66482546 -0.33517454 -0.11023156 -0.183255  ]
        INFO - 16:25:12:       Design space: 
        INFO - 16:25:12:       +-------------+-------------+---------------------+-------------+-------+
        INFO - 16:25:12:       | name        | lower_bound |        value        | upper_bound | type  |
        INFO - 16:25:12:       +-------------+-------------+---------------------+-------------+-------+
        INFO - 16:25:12:       | x_shared[0] |     0.01    | 0.05989842901423112 |     0.09    | float |
        INFO - 16:25:12:       | x_shared[1] |    30000    |  59853.73840058666  |    60000    | float |
        INFO - 16:25:12:       | x_shared[2] |     1.4     |         1.4         |     1.8     | float |
        INFO - 16:25:12:       | x_shared[3] |     2.5     |  2.527371250092273  |     8.5     | float |
        INFO - 16:25:12:       | x_shared[4] |      40     |  69.86825198198687  |      70     | float |
        INFO - 16:25:12:       | x_shared[5] |     500     |  1495.734648986894  |     1500    | float |
        INFO - 16:25:12:       | x_1[0]      |     0.1     |         0.4         |     0.4     | float |
        INFO - 16:25:12:       | x_1[1]      |     0.75    |  0.7521124139939552 |     1.25    | float |
        INFO - 16:25:12:       | x_2         |     0.75    |  0.7520888531444992 |     1.25    | float |
        INFO - 16:25:12:       | x_3         |     0.1     |  0.1398000762238233 |      1      | float |
        INFO - 16:25:12:       +-------------+-------------+---------------------+-------------+-------+
        INFO - 16:25:12: *** End MDOScenario execution (time: 0:00:01.334324) ***

    {'max_iter': 10, 'algo': 'SLSQP'}



.. GENERATED FROM PYTHON SOURCE LINES 101-106

Post-process scenario
---------------------
Lastly, we post-process the scenario by means of the :class:`.Robustness`
which plots any of the constraint or
objective functions w.r.t. the optimization iterations or sampling snapshots.

.. GENERATED FROM PYTHON SOURCE LINES 108-116

.. tip::

   Each post-processing method requires different inputs and offers a variety
   of customization options. Use the high-level function
   :func:`.get_post_processing_options_schema` to print a table with
   the options for any post-processing algorithm.
   Or refer to our dedicated page:
   :ref:`gen_post_algos`.

.. GENERATED FROM PYTHON SOURCE LINES 116-118

.. code-block:: default


    scenario.post_process("Robustness", save=False, show=True)



.. image-sg:: /examples/post_process/algorithms/images/sphx_glr_plot_robustness_001.png
   :alt: Boxplot of the optimization functions with normalized stddev 0.01
   :srcset: /examples/post_process/algorithms/images/sphx_glr_plot_robustness_001.png
   :class: sphx-glr-single-img


.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    /home/docs/checkouts/readthedocs.org/user_builds/gemseo/envs/5.0.0/lib/python3.9/site-packages/genson/schema/strategies/base.py:42: UserWarning: Schema incompatible. Keyword 'description' has conflicting values ('The width and height of the figure in inches, e.g. ``(w, h)``.\nIf ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE`\nof the post-processor.' vs. 'The width and height of the figure in inches, e.g. `(w, h)`.\nIf ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE`\nof the post-processor.'). Using 'The width and height of the figure in inches, e.g. ``(w, h)``.\nIf ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE`\nof the post-processor.'
      warn(('Schema incompatible. Keyword {0!r} has conflicting '

    <gemseo.post.robustness.Robustness object at 0x7fea4e9cd0d0>




.. rst-class:: sphx-glr-timing

   **Total running time of the script:** ( 0 minutes  1.573 seconds)


.. _sphx_glr_download_examples_post_process_algorithms_plot_robustness.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example




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

      :download:`Download Python source code: plot_robustness.py <plot_robustness.py>`

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

      :download:`Download Jupyter notebook: plot_robustness.ipynb <plot_robustness.ipynb>`


.. only:: html

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

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