objective module

Define a class to hold optimisation objective with its ideal value.

class Objective(name, weight, descriptor=None, ideal_value=None)

Bases: ABC

Hold an objective and methods to evaluate it.

Parameters:

• name (str) – A short string to describe the objective and access to it.

• weight (float) – A scaling constant to set the weight of current objective.

• descriptor (str | None, optional) – A longer string to explain the objective. The default is None.

• ideal_value (float | tuple[float], optional) – The ideal value or range of values that we should tend to.

name: str

weight: float

descriptor: str | None = None

ideal_value: tuple[float, float] | float | None = None

__post_init__()

Avoid line jumps in the descriptor.

Return type:

None

abstract __str__()

Output info on what is this objective about.

Return type:

str

abstract base_str()

Tell nature and position of objective.

Return type:

str

static str_header()

Give a header to explain what __str__() returns.

Return type:

str

abstract evaluate(simulation_output)

Compute residue of this objective.

Parameters:

simulation_output (SimulationOutput | float) – Object containing simulation results of the broken linac.

Returns:

residue – Difference between current evaluation and ideal_value value for self.name, scaled by self.weight.

Return type:

float

__init__(name, weight, descriptor=None, ideal_value=None)

Parameters:

• name (str)

• weight (float)

• descriptor (str | None, default: None)

• ideal_value (tuple[float, float] | float | None, default: None)

_abc_impl = <_abc._abc_data object at 0x73dca6b606c0>