Objectives

Objectives define the optimization targets—what the optimizer seeks to minimize, maximize, or explore.

Each entry in VOCS.objectives is a key–value pair where:

• key — objective name (string)

• value — a shorthand or longhand definition.

Examples

Shorthand forms:

from gest_api.vocs import VOCS

# Minimize an objective named "f"
vocs = VOCS(objectives={"f": "MINIMIZE"})

# Maximize an objective
vocs = VOCS(objectives={"f": "MAXIMIZE"})

# Mark an objective for exploration
vocs = VOCS(objectives={"f": "EXPLORE"})

Longhand form:

from gest_api.vocs import MinimizeObjective, VOCS

f_obj = MinimizeObjective(dtype=float)
vocs = VOCS(objectives={"f": f_obj})

Associated classes:

class gest_api.vocs.BaseObjective(*, dtype=None)

Parameters:

dtype (str | Type | Tuple | None)

class gest_api.vocs.MinimizeObjective(*, dtype=None)

Parameters:

dtype (str | Type | Tuple | None)

class gest_api.vocs.MaximizeObjective(*, dtype=None)

Parameters:

dtype (str | Type | Tuple | None)

class gest_api.vocs.ExploreObjective(*, dtype=None)

Parameters:

dtype (str | Type | Tuple | None)

Note

The dtype (data type) field for any parameter can be set according to https://numpy.org/doc/stable/reference/arrays.dtypes.html. The type specified must be supported by the generator.

By default, the dtype value is None, which means the variable is a scalar with a type determined by the generator.