Extension points#

Registries#

class DMDO.Registry(kind, entry_point_group=None)#

Bases: Generic[T]

A case-insensitive name -> component registry with aliases and plugin discovery.

Parameters:
  • kind (str)

  • entry_point_group (Optional[str])

register(name, component=None, *, aliases=(), override=False)#

Register component under name; usable as a decorator when component is omitted.

Parameters:
  • name (str)

  • component (T | None)

  • aliases (Iterable[str])

  • override (bool)

canonical_name(name)#

The registered name name resolves to (following aliases), or None.

Parameters:

name (str)

Return type:

str | None

DMDO.solvers#

Subproblem solver strategies (entry-point group dmdo.solvers): mads (alias OMADS), poll, search, scipy.

DMDO.executors#

Executor factories (entry-point group dmdo.executors): inprocess (alias serial), process (alias parallel).

DMDO.blackboxes#

Analyses and objectives referenced by name from problem definitions (entry-point group dmdo.blackboxes).

DMDO.policies#

Coordination policies (entry-point group dmdo.policies): none.

DMDO.register_blackbox(name, component=None, *, override=True)#

Register a callable or discipline so problem definitions can refer to it by name.

Parameters:
  • name (str)

  • component (Callable | None)

  • override (bool)

Subproblem solvers#

class DMDO.BaseSolver#

Bases: object

Default behaviour shared by solver strategies (see DMDO.ports.SubproblemSolver).

Strategies are stateless: per-subproblem state travels in SolverRequest.warm_start / SolverOutcome.warm_start, so a strategy instance can be shared, re-created on every solve, or run in another process.

prepare_settings(settings, sp_index, warn)#

Validate / complete the solver-specific settings given in the subproblem definition.

Parameters:
  • settings (Dict[str, Any] | None)

  • sp_index (int)

  • warn (Callable[[str], None])

Return type:

Dict[str, Any] | None

select_config(conf, settings)#

Pick SolverRequest.config from the subproblem’s CONFIG block and its prepared solver settings.

Parameters:
  • conf (Dict[str, Any] | None)

  • settings (Dict[str, Any] | None)

Return type:

Dict[str, Any] | None

Coordination policies#

class DMDO.CoordinationPolicy#

Base class of the coordination policies: decides how each multiplier update of the coordinator is scaled. Policies hold no state of their own; they read and write the coordinator they are given.

compute_scales(coord, iteration)#

Return (beta_scale, gamma_scale, budget_scale, event) for this outer iteration: the factor applied to the exponent of the penalty growth \(\beta\), the factor applied to the stall threshold \(\gamma\), the factor applied to the inner evaluation budget of the next outer iteration, and a flag that custom policies return as False. All factors are 1 in the base class.

multiplier_scales(coord, iteration)#

Called by the coordinator before each update: evaluates compute_scales() and records the applied factors. Returns (beta_scale, gamma_scale, event).

class DMDO.NeutralPolicy#

The none policy: the update of Background, unchanged.

DMDO.policy_for(coord)#

The policy of a coordinator: the one named by its adaptation_policy option, none by default.

Built-in observers#

class DMDO.CheckpointWriter#

Bases: RunObserver

Pickles the run to <post_dir>/coord_chk.pkl at the start of every outer iteration after the first.

class DMDO.ConsoleReporter#

Bases: RunObserver

Prints and logs one progress line per outer iteration (when the run’s display option is on).

class DMDO.CoordinationHistoryRecorder#

Writes Coordination_history.out: a header at the first outer iteration, then one row per outer iteration (Outputs).