gemseo / formulations

Show inherited members

disciplinary_opt module

A formulation for uncoupled or weakly coupled problems.

class gemseo.formulations.disciplinary_opt.DisciplinaryOpt(disciplines, objective_name, design_space, maximize_objective=False, grammar_type=GrammarType.JSON)[source]

Bases: MDOFormulation

The disciplinary optimization.

This formulation draws the architecture of a mono-disciplinary optimization process from an ordered list of disciplines, an objective function and a design space.

  • disciplines (list[MDODiscipline]) – The disciplines.

  • objective_name (str) – The name(s) of the discipline output(s) used as objective. If multiple names are passed, the objective will be a vector.

  • design_space (DesignSpace) – The design space.

  • maximize_objective (bool) –

    Whether to maximize the objective.

    By default it is set to False.

  • grammar_type (MDODiscipline.GrammarType) –

    The type of the input and output grammars.

    By default it is set to “JSONGrammar”.


Get the expected data exchange sequence.

This method is used for the XDSM representation and can be overloaded by subclasses.


The expected sequence of data exchange where the i-th item is described by the starting discipline, the ending discipline and the coupling variables.

Return type:

list[tuple[gemseo.core.discipline.MDODiscipline, gemseo.core.discipline.MDODiscipline, list[str]]]


Get the expected sequence of execution of the disciplines.

This method is used for the XDSM representation and can be overloaded by subclasses.

For instance:

  • [A, B] denotes the execution of A, then the execution of B

  • (A, B) denotes the concurrent execution of A and B

  • [A, (B, C), D] denotes the execution of A, then the concurrent execution of B and C, then the execution of D.


A sequence of elements which are either an ExecutionSequence or a tuple of ExecutionSequence for concurrent execution.

Return type:

list[gemseo.core.execution_sequence.ExecutionSequence, tuple[gemseo.core.execution_sequence.ExecutionSequence]]


Return the disciplines which inputs are required to run the scenario.

A formulation seeks to compute the objective and constraints from the input variables. It structures the optimization problem into multiple levels of disciplines. The disciplines directly depending on these inputs are called top level disciplines.

By default, this method returns all disciplines. This method can be overloaded by subclasses.


The top level disciplines.

Return type:


opt_problem: OptimizationProblem

The optimization problem generated by the formulation from the disciplines.