.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "examples/post_process/algorithms/plot_variable_influence.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_variable_influence.py>`
        to download the full example code.

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

.. _sphx_glr_examples_post_process_algorithms_plot_variable_influence.py:


Variables influence
===================

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

.. GENERATED FROM PYTHON SOURCE LINES 28-36

.. code-block:: Python


    from __future__ import annotations

    from gemseo import configure_logger
    from gemseo import create_discipline
    from gemseo import create_scenario
    from gemseo.problems.mdo.sobieski.core.design_space import SobieskiDesignSpace








.. GENERATED FROM PYTHON SOURCE LINES 37-41

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

.. GENERATED FROM PYTHON SOURCE LINES 41-44

.. code-block:: Python


    configure_logger()





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

 .. code-block:: none


    <RootLogger root (INFO)>



.. GENERATED FROM PYTHON SOURCE LINES 45-55

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

The **VariableInfluence** post-processing performs first-order variable
influence analysis.

The method computes :math:`\frac{d f}{d x_i} \cdot \left(x_{i_*} -
x_{initial_design}\right)`,
where :math:`x_{initial_design}` is the initial value of the variable
and :math:`x_{i_*}` is the optimal value of the variable.

.. GENERATED FROM PYTHON SOURCE LINES 57-61

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

.. GENERATED FROM PYTHON SOURCE LINES 61-68

.. code-block:: Python

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








.. GENERATED FROM PYTHON SOURCE LINES 69-72

Create design space
-------------------
We also create the :class:`.SobieskiDesignSpace`.

.. GENERATED FROM PYTHON SOURCE LINES 72-74

.. code-block:: Python

    design_space = SobieskiDesignSpace()








.. GENERATED FROM PYTHON SOURCE LINES 75-82

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 82-94

.. code-block:: Python

    scenario = create_scenario(
        disciplines,
        "y_4",
        design_space,
        formulation_name="MDF",
        maximize_objective=True,
    )
    scenario.set_differentiation_method()
    for constraint in ["g_1", "g_2", "g_3"]:
        scenario.add_constraint(constraint, constraint_type="ineq")
    scenario.execute(algo_name="SLSQP", max_iter=10)





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

 .. code-block:: none

     WARNING - 08:39:01: Unsupported feature 'minItems' in JSONGrammar 'SobieskiMission_discipline_output' for property 'y_4' in conversion to SimpleGrammar.
     WARNING - 08:39:01: Unsupported feature 'maxItems' in JSONGrammar 'SobieskiMission_discipline_output' for property 'y_4' in conversion to SimpleGrammar.
        INFO - 08:39:01:  
        INFO - 08:39:01: *** Start MDOScenario execution ***
        INFO - 08:39:01: MDOScenario
        INFO - 08:39:01:    Disciplines: SobieskiAerodynamics SobieskiMission SobieskiPropulsion SobieskiStructure
        INFO - 08:39:01:    MDO formulation: MDF
        INFO - 08:39:01: Optimization problem:
        INFO - 08:39:01:    minimize -y_4(x_shared, x_1, x_2, x_3)
        INFO - 08:39:01:    with respect to x_1, x_2, x_3, x_shared
        INFO - 08:39:01:    subject to constraints:
        INFO - 08:39:01:       g_1(x_shared, x_1, x_2, x_3) <= 0
        INFO - 08:39:01:       g_2(x_shared, x_1, x_2, x_3) <= 0
        INFO - 08:39:01:       g_3(x_shared, x_1, x_2, x_3) <= 0
        INFO - 08:39:01:    over the design space:
        INFO - 08:39:01:       +-------------+-------------+-------+-------------+-------+
        INFO - 08:39:01:       | Name        | Lower bound | Value | Upper bound | Type  |
        INFO - 08:39:01:       +-------------+-------------+-------+-------------+-------+
        INFO - 08:39:01:       | x_shared[0] |     0.01    |  0.05 |     0.09    | float |
        INFO - 08:39:01:       | x_shared[1] |    30000    | 45000 |    60000    | float |
        INFO - 08:39:01:       | x_shared[2] |     1.4     |  1.6  |     1.8     | float |
        INFO - 08:39:01:       | x_shared[3] |     2.5     |  5.5  |     8.5     | float |
        INFO - 08:39:01:       | x_shared[4] |      40     |   55  |      70     | float |
        INFO - 08:39:01:       | x_shared[5] |     500     |  1000 |     1500    | float |
        INFO - 08:39:01:       | x_1[0]      |     0.1     |  0.25 |     0.4     | float |
        INFO - 08:39:01:       | x_1[1]      |     0.75    |   1   |     1.25    | float |
        INFO - 08:39:01:       | x_2         |     0.75    |   1   |     1.25    | float |
        INFO - 08:39:01:       | x_3         |     0.1     |  0.5  |      1      | float |
        INFO - 08:39:01:       +-------------+-------------+-------+-------------+-------+
        INFO - 08:39:01: Solving optimization problem with algorithm SLSQP:
        INFO - 08:39:01:     10%|█         | 1/10 [00:00<00:00, 18.75 it/sec, obj=-536]
        INFO - 08:39:01:     20%|██        | 2/10 [00:00<00:00, 13.80 it/sec, obj=-2.12e+3]
     WARNING - 08:39:02: MDAJacobi has reached its maximum number of iterations but the normed residual 5.741449586530469e-06 is still above the tolerance 1e-06.
        INFO - 08:39:02:     30%|███       | 3/10 [00:00<00:00, 11.26 it/sec, obj=-3.46e+3]
        INFO - 08:39:02:     40%|████      | 4/10 [00:00<00:00, 10.79 it/sec, obj=-3.96e+3]
        INFO - 08:39:02:     50%|█████     | 5/10 [00:00<00:00, 11.02 it/sec, obj=-4.61e+3]
        INFO - 08:39:02:     60%|██████    | 6/10 [00:00<00:00, 11.72 it/sec, obj=-4.5e+3]
        INFO - 08:39:02:     70%|███████   | 7/10 [00:00<00:00, 12.11 it/sec, obj=-4.26e+3]
        INFO - 08:39:02:     80%|████████  | 8/10 [00:00<00:00, 12.44 it/sec, obj=-4.11e+3]
        INFO - 08:39:02:     90%|█████████ | 9/10 [00:00<00:00, 12.68 it/sec, obj=-4.02e+3]
        INFO - 08:39:02:    100%|██████████| 10/10 [00:00<00:00, 12.90 it/sec, obj=-3.99e+3]
        INFO - 08:39:02: Optimization result:
        INFO - 08:39:02:    Optimizer info:
        INFO - 08:39:02:       Status: None
        INFO - 08:39:02:       Message: Maximum number of iterations reached. GEMSEO stopped the driver.
        INFO - 08:39:02:       Number of calls to the objective function by the optimizer: 12
        INFO - 08:39:02:    Solution:
        INFO - 08:39:02:       The solution is feasible.
        INFO - 08:39:02:       Objective: -3463.120411437138
        INFO - 08:39:02:       Standardized constraints:
        INFO - 08:39:02:          g_1 = [-0.01112145 -0.02847064 -0.04049911 -0.04878943 -0.05476349 -0.14014207
        INFO - 08:39:02:  -0.09985793]
        INFO - 08:39:02:          g_2 = -0.0020925663903177405
        INFO - 08:39:02:          g_3 = [-0.71359843 -0.28640157 -0.05926796 -0.183255  ]
        INFO - 08:39:02:       Design space:
        INFO - 08:39:02:          +-------------+-------------+---------------------+-------------+-------+
        INFO - 08:39:02:          | Name        | Lower bound |        Value        | Upper bound | Type  |
        INFO - 08:39:02:          +-------------+-------------+---------------------+-------------+-------+
        INFO - 08:39:02:          | x_shared[0] |     0.01    | 0.05947685840242058 |     0.09    | float |
        INFO - 08:39:02:          | x_shared[1] |    30000    |   59246.692998739   |    60000    | float |
        INFO - 08:39:02:          | x_shared[2] |     1.4     |         1.4         |     1.8     | float |
        INFO - 08:39:02:          | x_shared[3] |     2.5     |   2.64097355362077  |     8.5     | float |
        INFO - 08:39:02:          | x_shared[4] |      40     |  69.32144380869019  |      70     | float |
        INFO - 08:39:02:          | x_shared[5] |     500     |  1478.031626737187  |     1500    | float |
        INFO - 08:39:02:          | x_1[0]      |     0.1     |         0.4         |     0.4     | float |
        INFO - 08:39:02:          | x_1[1]      |     0.75    |  0.7608797907508461 |     1.25    | float |
        INFO - 08:39:02:          | x_2         |     0.75    |  0.7607584987262048 |     1.25    | float |
        INFO - 08:39:02:          | x_3         |     0.1     |  0.1514057659459843 |      1      | float |
        INFO - 08:39:02:          +-------------+-------------+---------------------+-------------+-------+
        INFO - 08:39:02: *** End MDOScenario execution (time: 0:00:00.784531) ***




.. GENERATED FROM PYTHON SOURCE LINES 95-99

Post-process scenario
---------------------
Lastly, we post-process the scenario by means of the :class:`.VariableInfluence`
plot.

.. GENERATED FROM PYTHON SOURCE LINES 101-109

.. 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 109-111

.. code-block:: Python


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



.. image-sg:: /examples/post_process/algorithms/images/sphx_glr_plot_variable_influence_001.png
   :alt: 9 variables explain 99% of -y_4, 5 variables explain 99% of g_1[0], 5 variables explain 99% of g_1[1], 5 variables explain 99% of g_1[2], 5 variables explain 99% of g_1[3], 5 variables explain 99% of g_1[4], 4 variables explain 99% of g_1[5], 4 variables explain 99% of g_1[6], 1 variables explain 99% of g_2, 7 variables explain 99% of g_3[0], 7 variables explain 99% of g_3[1], 3 variables explain 99% of g_3[2], 3 variables explain 99% of g_3[3]
   :srcset: /examples/post_process/algorithms/images/sphx_glr_plot_variable_influence_001.png
   :class: sphx-glr-single-img


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

 .. code-block:: none

        INFO - 08:39:02: Output name; most influential variables to explain 0.99% of the output variation 
        INFO - 08:39:02:    -y_4; x_1[1], x_2, x_3, x_shared[0], x_shared[1], x_shared[2], x_shared[3], x_shared[4], x_shared[5]
        INFO - 08:39:02:    g_1[0]; x_1[0], x_1[1], x_shared[0], x_shared[3], x_shared[5]
        INFO - 08:39:02:    g_1[1]; x_1[0], x_1[1], x_shared[0], x_shared[3], x_shared[5]
        INFO - 08:39:02:    g_1[2]; x_1[0], x_1[1], x_shared[0], x_shared[3], x_shared[5]
        INFO - 08:39:03:    g_1[3]; x_1[0], x_1[1], x_shared[0], x_shared[3], x_shared[5]
        INFO - 08:39:03:    g_1[4]; x_1[0], x_1[1], x_shared[0], x_shared[3], x_shared[5]
        INFO - 08:39:03:    g_1[5]; x_1[0], x_1[1], x_shared[3], x_shared[5]
        INFO - 08:39:03:    g_1[6]; x_1[0], x_1[1], x_shared[3], x_shared[5]
        INFO - 08:39:03:    g_2; x_shared[0]
        INFO - 08:39:03:    g_3[0]; x_2, x_3, x_shared[0], x_shared[1], x_shared[2], x_shared[4], x_shared[5]
        INFO - 08:39:03:    g_3[1]; x_2, x_3, x_shared[0], x_shared[1], x_shared[2], x_shared[4], x_shared[5]
        INFO - 08:39:03:    g_3[2]; x_3, x_shared[1], x_shared[2]
        INFO - 08:39:03:    g_3[3]; x_3, x_shared[1], x_shared[2]

    <gemseo.post.variable_influence.VariableInfluence object at 0x7f6dc822b7c0>




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

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


.. _sphx_glr_download_examples_post_process_algorithms_plot_variable_influence.py:

.. only:: html

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

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

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

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

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

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: plot_variable_influence.zip <plot_variable_influence.zip>`


.. only:: html

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

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