pyanno4rt.optimization.methods._weighted_sum_optimization

Weighted-sum optimization problem.

Overview

Classes
`WeightedSumOptimization`	Weighted-sum optimization problem class.

Classes

class pyanno4rt.optimization.methods._weighted_sum_optimization.WeightedSumOptimization(backprojection, objectives, constraints)[source]

Weighted-sum optimization problem class.

This class provides methods to perform weighted-sum optimization. It features a component tracker and implements the respective objective, gradient, constraint and constraint jacobian functions.

Parameters:: backprojection (object of class)

:param DoseProjection ConstantRBEProjection: The object representing the type of backprojection. :param objectives: Dictionary with the internally configured objectives. :type objectives: dict :param constraints: Dictionary with the internally configured constraints. :type constraints: dict

backprojection

Type:: object of class

:class:`~pyanno4rt.optimization.projections._dose_projection.DoseProjection` :class:`~pyanno4rt.optimization.projections._constant_rbe_projection.ConstantRBEProjection`: See ‘Parameters’.

objectives

See ‘Parameters’.

Type:: dict

constraints

See ‘Parameters’.

Type:: dict

tracker

Dictionary with the iteration-wise component values.

Type:: dict

Overview

Methods
`objective`(fluence, track)	Compute the objective function value.
`gradient`(fluence)	Compute the gradient function value.
`constraint`(fluence, track)	Compute the constraint function value(s).
`jacobian`(fluence)	Compute the constraint jacobian function value.

Members

objective(fluence, track=True)[source]

Compute the objective function value.

Parameters:

fluence (ndarray) – Fluence vector.
track (bool, default=True) – Indicator for tracking the single objective function values.

Returns:

Objective function value.

Return type:

float

gradient(fluence)[source]

Compute the gradient function value.

Parameters:: fluence (ndarray) – Fluence vector.
Returns:: Gradient function value.
Return type:: ndarray

constraint(fluence, track=True)[source]

Compute the constraint function value(s).

Parameters:

fluence (ndarray) – Fluence vector.
track (bool, default=True) – Indicator for tracking the constraint function value(s).

Returns:

Constraint function value(s).

Return type:

float

jacobian(fluence)[source]

Compute the constraint jacobian function value.

Parameters:: fluence (ndarray) – Fluence vector.
Returns:: Constraint jacobian function value.
Return type:: ndarray