Post-processing algorithms

Warning

Some capabilities may require the installation of GEMSEO with all its features and some others may depend on plugins.

Note

All the features of the wrapped libraries may not be exposed through GEMSEO.

Animation

Module: gemseo.post.animation

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • first_iteration : int, optional

    The iteration to begin the animation.

    By default it is set to -1.

  • frame_rate : int, optional

    The number of iterations per time step.

    By default it is set to 1.

  • gif_file_path : str | Path, optional

    The path to the GIF file.

    By default it is set to animated_gif.

  • n_repetitions : int | None, optional

    The number of times the animation is played. If None,

    By default it is set to None.

  • opt_post_processor : str, optional

    The class name of the OptPostProcessor.

    By default it is set to BasicHistory.

  • remove_frames : bool, optional

    Wether to remove the frame images after the GIF generation.

    By default it is set to True.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

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

  • time_step : int, optional

    The time step between two frames in milliseconds.

    By default it is set to 100.

  • **options : Any

    The options of the OptPostProcessor.

BasicHistory

Module: gemseo.post.basic_history

Required parameters
  • variable_names : Sequence[str]

    The names of the variables.

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • normalize : bool, optional

    Whether to normalize the data.

    By default it is set to False.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

Compromise

Note

The plugin gemseo_pymoo is required.

Module: gemseo_pymoo.post.compromise

Optional parameters
  • **scalar_options : Any

    The keyword arguments for the scalarization function.

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

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

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

  • plot_legend : bool, optional

    Whether to show the legend.

    By default it is set to True.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

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

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

ConstraintsHistory

Module: gemseo.post.constraints_history

Required parameters
  • constraint_names : Sequence[str]

    The names of the constraints.

Optional parameters
  • add_points : bool, optional

    Whether to add one point per iteration on the line.

    By default it is set to True.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • line_style : str, optional

    The style of the line, e.g. "-" or "--". If "", do not plot the line.

    By default it is set to –.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

Correlations

Module: gemseo.post.correlations

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.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

  • n_plots_x : int, optional

    The number of horizontal plots.

    By default it is set to 5.

  • n_plots_y : int, optional

    The number of vertical plots.

    By default it is set to 5.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

DataVersusModel

Note

The plugin gemseo_calibration is required.

Module: gemseo_calibration.post.data_versus_model.post

Required parameters
  • output : str

    The description is missing.

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

GradientSensitivity

Module: gemseo.post.gradient_sensitivity

Optional parameters
  • compute_missing_gradients : bool, optional

    Whether to compute the gradients at the selected iteration if they were not computed by the algorithm.

    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 OptimizationProblem instance was imported from an HDF5 file. This option requires an OptimizationProblem with a gradient-based algorithm.

    By default it is set to False.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • scale_gradients : bool, optional

    If True, normalize each gradient w.r.t. the design variables.

    By default it is set to False.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

HighTradeOff

Note

The plugin gemseo_pymoo is required.

Module: gemseo_pymoo.post.high_tradeoff

Optional parameters
  • **options : OptPostProcessorOptionType

    The options of the post-processor.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

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

  • plot_legend : bool, optional

    Whether to show the legend.

    By default it is set to True.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **high_tradeoff_options : Any

    The keyword arguments for the class pymoo.mcdm.high_tradeoff.HighTradeoffPoints.

MultiObjectiveDiagram

Note

The plugin gemseo_pymoo is required.

Module: gemseo_pymoo.post.core.multi_objective_diagram

Required parameters
  • decomposition : Decomposition

    The instance of the scalarization function to use.

  • visualization : type[Plot]

    The Pymoo visualization class to be used to create the plot.

  • weights : ndarray

    The weights for the scalarization function.

Optional parameters
  • **scalar_options : Any

    The keyword arguments for the scalarization function.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • normalize_each_objective : bool, optional

    Whether the objectives should be normalized.

    By default it is set to True.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

ObjConstrHist

Module: gemseo.post.obj_constr_hist

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.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

OptHistoryView

Module: gemseo.post.opt_history_view

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

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

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

ParallelCoordinates

Module: gemseo.post.para_coord

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The post-processor options.

ParetoFront

Module: gemseo.post.pareto_front

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • show_non_feasible : bool, optional

    If True, show the non-feasible points in the plot.

    By default it is set to True.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

Petal

Note

The plugin gemseo_pymoo is required.

Module: gemseo_pymoo.post.petal

Required parameters
  • decomposition : Decomposition

    The instance of the scalarization function to use.

  • weights : ndarray

    The weights for the scalarization function.

Optional parameters
  • **scalar_options : Any

    The keyword arguments for the scalarization function.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

QuadApprox

Module: gemseo.post.quad_approx

Required parameters
  • function : str

    The function name to build the quadratic approximation.

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

Radar

Note

The plugin gemseo_pymoo is required.

Module: gemseo_pymoo.post.radar

Required parameters
  • decomposition : Decomposition

    The instance of the scalarization function to use.

  • weights : ndarray

    The weights for the scalarization function.

Optional parameters
  • **scalar_options : Any

    The keyword arguments for the scalarization function.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • normalize_each_objective : bool, optional

    Whether the objectives should be normalized.

    By default it is set to True.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

RadarChart

Module: gemseo.post.radar_chart

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.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • iteration : int | RadarChart.OPTIMUM, optional

    Either an iteration in \(-N,\ldots,-1,1,`ldots,N\) or the tag OPTIMUM for the iteration at which the optimum is located, where \(N\) is the length of the database.

    By default it is set to opt.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

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

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

Robustness

Module: gemseo.post.robustness

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

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

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

SOM

Module: gemseo.post.som

Optional parameters
  • annotate : bool, optional

    If True, add label of neuron value to SOM plot.

    By default it is set to False.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • n_x : int, optional

    The number of grids in x.

    By default it is set to 4.

  • n_y : int, optional

    The number of grids in y.

    By default it is set to 4.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

ScatterPareto

Note

The plugin gemseo_pymoo is required.

Module: gemseo_pymoo.post.scatter_pareto

Optional parameters
  • **scatter_options : Any

    The keyword arguments for the class pymoo.visualization.scatter.Scatter.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

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

  • plot_legend : bool, optional

    Whether to show the legend.

    By default it is set to True.

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

ScatterPlotMatrix

Module: gemseo.post.scatter_mat

Required parameters
  • variable_names : Sequence[str]

    The functions names or design variables to plot. If the list is empty, plot all design variables.

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

  • filter_non_feasible : bool, optional

    If True, remove the non-feasible points from the data.

    By default it is set to False.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

TopologyView

Module: gemseo.post.topology_view

Required parameters
  • n_x : int

    The number of elements in the horizontal direction.

  • n_y : int

    The number of elements in the vertical direction.

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.

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

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

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.

VariableInfluence

Module: gemseo.post.variable_influence

Optional parameters
  • absolute_value : bool, optional

    Whether to plot the absolute value of the influence.

    By default it is set to False.

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

  • fig_size : FigSizeType | None, optional

    The width and height of the figure in inches, e.g. (w, h). If None, use the OptPostProcessor.DEFAULT_FIG_SIZE of the post-processor.

    By default it is set to None.

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

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

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

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

  • log_scale : bool, optional

    Whether to set the y-axis as log scale.

    By default it is set to False.

  • save : bool, optional

    If True, save the figure.

    By default it is set to True.

  • save_var_files : bool, optional

    Whether to save the influential variables indices to a NumPy file.

    By default it is set to False.

  • show : bool, optional

    If True, display the figure.

    By default it is set to False.

  • **options : OptPostProcessorOptionType

    The options of the post-processor.