evomo.algorithms.bce_moead#

Attributes#

algo

Classes#

BCEMOEAD

Initialize the BCEMOEAD population and optimization state.

Module Contents#

class evomo.algorithms.bce_moead.BCEMOEAD(pop_size: int, n_objs: int, lb: torch.Tensor, ub: torch.Tensor, T: int | None = None, nr: int | None = None, **kwargs)#

Bases: evox.core.Algorithm

Initialize the BCEMOEAD population and optimization state.

Parameters:

  • pop_size (int) – Required. Requested number of candidate solutions. Use a positive integer; algorithm-specific minimums and reference-vector sampling are described below.

  • n_objs (int) – Required. Number of objectives, matching the second dimension of the problem’s objective tensor. Objectives are minimized; this library targets two or more objectives.

  • lb (torch.Tensor) – Required. Lower decision bounds of shape (D,), where D is the number of decision variables. Use floating-point bounds with the same shape, dtype and device as ub, and lb <= ub elementwise.

  • ub (torch.Tensor) – Required. Upper decision bounds of shape (D,). The decision dimension is inferred from the bounds, rather than passed separately. Match lb in shape, dtype and device.

  • T (int or None) – Default: None. Neighborhood size. None uses ceil(N / 10) for the sampled population size N. The effective value is min(max(2, T), N) after resolving the default.

  • nr (int or None) – Default: None. Maximum replacements per offspring. None uses ceil(N / 100); the effective value is clamped to [1, N] for sampled population size N.

  • kwargs (dict) – Default: {}. Extra keyword arguments are accepted for constructor compatibility but are not read by this implementation. In particular, passing device=... here does not move tensors; place both bounds on the intended device before construction.

Note

Use this algorithm through a workflow that connects the problem’s evaluation method. Call workflow.init_step() before workflow.step() or compiling the step. The current evaluation path expects an objective tensor of shape (B, n_objs). It does not consume a (fitness, constraint_violation) tuple.

Reference-vector sampling can change the requested population size. Read self.pop.shape[0] for the actual size.

Tensor allocation uses lb.device. There is no explicit device parameter; prepare both bounds on the intended device.

init_step() → None#

Evaluate the initial population and initialize algorithm state.

Invoke through workflow.init_step() before the first optimization step.

Returns:

None; results are stored in algorithm state.

step() → None#

Advance optimization and update population and fitness state in place.

Invoke through workflow.step() after initialization. The caller controls termination.

Returns:

None; results are stored in algorithm state.

evomo.algorithms.bce_moead.algo#