.. 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. .. _gen_post_algos: Post-processing algorithms ========================== .. warning:: Some capabilities may require the :ref:`installation ` of |g| with :ref:`all its features ` and some others may depend on :ref:`plugins `. .. note:: All the features of the wrapped libraries may not be exposed through |g|. .. raw:: html .. _Animation_options: Animation --------- Module: :class:`gemseo.post.animation` .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **first_iteration** : *int, optional* The iteration to begin the animation. By default it is set to -1. .. raw:: html
  • **frame_rate** : *int, optional* The number of iterations per time step. By default it is set to 1. .. raw:: html
  • **gif_file_path** : *str | Path, optional* The path to the GIF file. By default it is set to animated_gif. .. raw:: html
  • **n_repetitions** : *int | None, optional* The number of times the animation is played. If ``None``, By default it is set to None. .. raw:: html
  • **opt_post_processor** : *str, optional* The class name of the :class:`.OptPostProcessor`. By default it is set to BasicHistory. .. raw:: html
  • **remove_frames** : *bool, optional* Wether to remove the frame images after the GIF generation. By default it is set to True. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • **temporary_database_file** : *str | Path | None, optional* The path to a temporary database file to avoid deepcopy memory errors. If ``None``, deepcopy is used instead. By default it is set to None. .. raw:: html
  • **time_step** : *int, optional* The time step between two frames in milliseconds. By default it is set to 100. .. raw:: html
  • ****options** : *Any* The options of the :class:`.OptPostProcessor`. .. raw:: html
.. _BasicHistory_options: BasicHistory ------------ Module: :class:`gemseo.post.basic_history` .. raw:: html
Required parameters
  • **variable_names** : *Sequence[str]* The names of the variables. .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **normalize** : *bool, optional* Whether to normalize the data. By default it is set to False. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _Compromise_options: Compromise ---------- .. note:: The plugin `gemseo_pymoo `_ is required. Module: :class:`gemseo_pymoo.post.compromise` .. raw:: html
Optional parameters
  • ****scalar_options** : *Any* The keyword arguments for the scalarization function. .. raw:: html
  • **decomposition** : *Decomposition | None, optional* The instance of the scalarization function to use. If ``None``, use a weighted sum. By default it is set to None. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **plot_arrow** : *bool, optional* Whether to plot arrows connecting the utopia point to the compromise points. The arrows are annotated with the ``2-norm`` ( `Euclidian distance `_ ) of the vector represented by the arrow. By default it is set to False. .. raw:: html
  • **plot_extra** : *bool, optional* Whether to plot the extra pareto related points, i.e. ``utopia``, ``nadir`` and ``anchor`` points. By default it is set to True. .. raw:: html
  • **plot_legend** : *bool, optional* Whether to show the legend. By default it is set to True. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • **weights** : *ndarray | None, optional* The weights for the scalarization function. If None, a normalized array is used, e.g. [1./n, 1./n, ..., 1./n] for an optimization problem with n-objectives. By default it is set to None. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _ConstraintsHistory_options: ConstraintsHistory ------------------ Module: :class:`gemseo.post.constraints_history` .. raw:: html
Required parameters
  • **constraint_names** : *Sequence[str]* The names of the constraints. .. raw:: html
Optional parameters
  • **add_points** : *bool, optional* Whether to add one point per iteration on the line. By default it is set to True. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **line_style** : *str, optional* The style of the line, e.g. ``"-"`` or ``"--"``. If ``""``, do not plot the line. By default it is set to --. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _Correlations_options: Correlations ------------ Module: :class:`gemseo.post.correlations` .. raw:: html
Optional parameters
  • **coeff_limit** : *float, optional* The minimum correlation coefficient below which the variable is not plotted. By default it is set to 0.95. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **func_names** : *Sequence[str] | None, optional* The names of the functions to be considered. If ``None``, all functions are considered. By default it is set to None. .. raw:: html
  • **n_plots_x** : *int, optional* The number of horizontal plots. By default it is set to 5. .. raw:: html
  • **n_plots_y** : *int, optional* The number of vertical plots. By default it is set to 5. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _DataVersusModel_options: DataVersusModel --------------- .. note:: The plugin `gemseo_calibration `_ is required. Module: :class:`gemseo_calibration.post.data_versus_model.post` .. raw:: html
Required parameters
  • **output** : *str* The description is missing. .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _GradientSensitivity_options: GradientSensitivity ------------------- Module: :class:`gemseo.post.gradient_sensitivity` .. raw:: html
Optional parameters
  • **compute_missing_gradients** : *bool, optional* Whether to compute the gradients at the selected iteration if they were not computed by the algorithm. .. warning:: Activating this option may add considerable computation time depending on the cost of the gradient evaluation. This option will not compute the gradients if the :class:`.OptimizationProblem` instance was imported from an HDF5 file. This option requires an :class:`.OptimizationProblem` with a gradient-based algorithm. By default it is set to False. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **iteration** : *int | None, optional* The iteration to plot the sensitivities. Can use either positive or negative indexing, e.g. ``5`` for the 5-th iteration or ``-2`` for the penultimate one. If ``None``, use the iteration of the optimum. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **scale_gradients** : *bool, optional* If ``True``, normalize each gradient w.r.t. the design variables. By default it is set to False. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _HighTradeOff_options: HighTradeOff ------------ .. note:: The plugin `gemseo_pymoo `_ is required. Module: :class:`gemseo_pymoo.post.high_tradeoff` .. raw:: html
Optional parameters
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **plot_arrow** : *bool, optional* Whether to plot arrows connecting the utopia point to the compromise points. The arrows are annotated with the ``2-norm`` ( `Euclidian distance `_ ) of the vector represented by the arrow. By default it is set to False. .. raw:: html
  • **plot_extra** : *bool, optional* Whether to plot the extra pareto related points, i.e. ``utopia``, ``nadir`` and ``anchor`` points. By default it is set to True. .. raw:: html
  • **plot_legend** : *bool, optional* Whether to show the legend. By default it is set to True. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****high_tradeoff_options** : *Any* The keyword arguments for the class :class:`pymoo.mcdm.high_tradeoff.HighTradeoffPoints`. .. raw:: html
.. _MultiObjectiveDiagram_options: MultiObjectiveDiagram --------------------- .. note:: The plugin `gemseo_pymoo `_ is required. Module: :class:`gemseo_pymoo.post.core.multi_objective_diagram` .. raw:: html
Required parameters
  • **decomposition** : *Decomposition* The instance of the scalarization function to use. .. raw:: html
  • **visualization** : *type[Plot]* The Pymoo visualization class to be used to create the plot. .. raw:: html
  • **weights** : *ndarray* The weights for the scalarization function. .. raw:: html
Optional parameters
  • ****scalar_options** : *Any* The keyword arguments for the scalarization function. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **normalize_each_objective** : *bool, optional* Whether the objectives should be normalized. By default it is set to True. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _ObjConstrHist_options: ObjConstrHist ------------- Module: :class:`gemseo.post.obj_constr_hist` .. raw:: html
Optional parameters
  • **constraint_names** : *Sequence[str] | None, optional* The names of the constraints to plot. If ``None``, use all the constraints. By default it is set to None. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _OptHistoryView_options: OptHistoryView -------------- Module: :class:`gemseo.post.opt_history_view` .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **obj_max** : *float | None, optional* The upper limit of the *y*-axis on which the objective is plotted. This limit must be greater than or equal to the maximum value of the objective history. If ``None``, use the maximum value of the objective history. By default it is set to None. .. raw:: html
  • **obj_min** : *float | None, optional* The lower limit of the *y*-axis on which the objective is plotted. This limit must be less than or equal to the minimum value of the objective history. If ``None``, use the minimum value of the objective history. By default it is set to None. .. raw:: html
  • **obj_relative** : *bool, optional* Whether the difference between the objective and its initial value is plotted instead of the objective. By default it is set to False. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • **variable_names** : *Sequence[str] | None, optional* The names of the variables to display. If ``None``, use all design variables. By default it is set to None. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _ParallelCoordinates_options: ParallelCoordinates ------------------- Module: :class:`gemseo.post.para_coord` .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The post-processor options. .. raw:: html
.. _ParetoFront_options: ParetoFront ----------- Module: :class:`gemseo.post.pareto_front` .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **objectives** : *Sequence[str] | None, optional* The functions names or design variables to plot. If ``None``, use the objective function (maybe a vector). By default it is set to None. .. raw:: html
  • **objectives_labels** : *Sequence[str] | None, optional* The labels of the objective components. If ``None``, use the objective name suffixed by an index. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • **show_non_feasible** : *bool, optional* If ``True``, show the non-feasible points in the plot. By default it is set to True. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _Petal_options: Petal ----- .. note:: The plugin `gemseo_pymoo `_ is required. Module: :class:`gemseo_pymoo.post.petal` .. raw:: html
Required parameters
  • **decomposition** : *Decomposition* The instance of the scalarization function to use. .. raw:: html
  • **weights** : *ndarray* The weights for the scalarization function. .. raw:: html
Optional parameters
  • ****scalar_options** : *Any* The keyword arguments for the scalarization function. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _QuadApprox_options: QuadApprox ---------- Module: :class:`gemseo.post.quad_approx` .. raw:: html
Required parameters
  • **function** : *str* The function name to build the quadratic approximation. .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **func_index** : *int | None, optional* The index of the output of interest to be defined if the function has a multidimensional output. If ``None`` and if the output is multidimensional, an error is raised. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _Radar_options: Radar ----- .. note:: The plugin `gemseo_pymoo `_ is required. Module: :class:`gemseo_pymoo.post.radar` .. raw:: html
Required parameters
  • **decomposition** : *Decomposition* The instance of the scalarization function to use. .. raw:: html
  • **weights** : *ndarray* The weights for the scalarization function. .. raw:: html
Optional parameters
  • ****scalar_options** : *Any* The keyword arguments for the scalarization function. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **normalize_each_objective** : *bool, optional* Whether the objectives should be normalized. By default it is set to True. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _RadarChart_options: RadarChart ---------- Module: :class:`gemseo.post.radar_chart` .. raw:: html
Optional parameters
  • **constraint_names** : *Iterable[str] | None, optional* The names of the constraints. If ``None``, use all the constraints. By default it is set to None. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **iteration** : *int | RadarChart.OPTIMUM, optional* Either an iteration in :math:`-N,\ldots,-1,1,`ldots,N` or the tag :attr:`.OPTIMUM` for the iteration at which the optimum is located, where :math:`N` is the length of the database. By default it is set to opt. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • **show_names_radially** : *bool, optional* Whether to write the names of the constraints in the radial direction. Otherwise, write them horizontally. The radial direction can be useful for a high number of constraints. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _Robustness_options: Robustness ---------- Module: :class:`gemseo.post.robustness` .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • **stddev** : *float, optional* The standard deviation of the normal uncertain variable to be added to the optimal design value; expressed as a fraction of the bounds of the design variables. By default it is set to 0.01. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _SOM_options: SOM --- Module: :class:`gemseo.post.som` .. raw:: html
Optional parameters
  • **annotate** : *bool, optional* If ``True``, add label of neuron value to SOM plot. By default it is set to False. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **n_x** : *int, optional* The number of grids in x. By default it is set to 4. .. raw:: html
  • **n_y** : *int, optional* The number of grids in y. By default it is set to 4. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _ScatterPareto_options: ScatterPareto ------------- .. note:: The plugin `gemseo_pymoo `_ is required. Module: :class:`gemseo_pymoo.post.scatter_pareto` .. raw:: html
Optional parameters
  • ****scatter_options** : *Any* The keyword arguments for the class :class:`pymoo.visualization.scatter.Scatter`. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **plot_arrow** : *bool, optional* Whether to plot arrows connecting the utopia point to the compromise points. The arrows are annotated with the ``2-norm`` ( `Euclidian distance `_ ) of the vector represented by the arrow. By default it is set to False. .. raw:: html
  • **plot_extra** : *bool, optional* Whether to plot the extra pareto related points, i.e. ``utopia``, ``nadir`` and ``anchor`` points. By default it is set to True. .. raw:: html
  • **plot_legend** : *bool, optional* Whether to show the legend. By default it is set to True. .. raw:: html
  • **point_labels** : *Sequence[str], optional* The label of the points of interest. If a list is provided, it must contain as many labels as the points of interest. Moreover, in the last case, each point will have a different color. By default it is set to points. .. raw:: html
  • **points** : *ndarray | None, optional* The points of interest to be plotted. If None, only the pareto front is plot along with extra point (depending on ``plot_extra`` value). By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _ScatterPlotMatrix_options: ScatterPlotMatrix ----------------- Module: :class:`gemseo.post.scatter_mat` .. raw:: html
Required parameters
  • **variable_names** : *Sequence[str]* The functions names or design variables to plot. If the list is empty, plot all design variables. .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **filter_non_feasible** : *bool, optional* If ``True``, remove the non-feasible points from the data. By default it is set to False. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _TopologyView_options: TopologyView ------------ Module: :class:`gemseo.post.topology_view` .. raw:: html
Required parameters
  • **n_x** : *int* The number of elements in the horizontal direction. .. raw:: html
  • **n_y** : *int* The number of elements in the vertical direction. .. raw:: html
Optional parameters
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **iterations** : *int | Iterable[int] | None, optional* The iterations of the optimization history. If ``None``, the last iteration is taken. By default it is set to None. .. raw:: html
  • **observable** : *str | None, optional* The name of the observable to be plotted. It should be of size ``n_x*n_y``. By default it is set to None. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html
.. _VariableInfluence_options: VariableInfluence ----------------- Module: :class:`gemseo.post.variable_influence` .. raw:: html
Optional parameters
  • **absolute_value** : *bool, optional* Whether to plot the absolute value of the influence. By default it is set to False. .. raw:: html
  • **directory_path** : *Path | None, optional* The path of the directory to save the figures. If ``None``, use the current working directory. By default it is set to None. .. raw:: html
  • **fig_size** : *FigSizeType | None, optional* The width and height of the figure in inches, e.g. ``(w, h)``. If ``None``, use the :attr:`.OptPostProcessor.DEFAULT_FIG_SIZE` of the post-processor. By default it is set to None. .. raw:: html
  • **file_extension** : *str | None, optional* A file extension, e.g. 'png', 'pdf', 'svg', ... If ``None``, use a default file extension. By default it is set to None. .. raw:: html
  • **file_name** : *str | None, optional* The name of the file to save the figures. If ``None``, use a default one generated by the post-processing. By default it is set to None. .. raw:: html
  • **file_path** : *Path | None, optional* The path of the file to save the figures. If the extension is missing, use ``file_extension``. If ``None``, create a file path from ``directory_path``, ``file_name`` and ``file_extension``. By default it is set to None. .. raw:: html
  • **level** : *float, optional* The proportion of the total sensitivity to use as a threshold to filter the variables. By default it is set to 0.99. .. raw:: html
  • **log_scale** : *bool, optional* Whether to set the y-axis as log scale. By default it is set to False. .. raw:: html
  • **save** : *bool, optional* If ``True``, save the figure. By default it is set to True. .. raw:: html
  • **save_var_files** : *bool, optional* Whether to save the influential variables indices to a NumPy file. By default it is set to False. .. raw:: html
  • **show** : *bool, optional* If ``True``, display the figure. By default it is set to False. .. raw:: html
  • ****options** : *OptPostProcessorOptionType* The options of the post-processor. .. raw:: html