foxes_opt.core.farm_opt_problem¶
Classes¶
Abstract base class of wind farm optimization problems. |
Module Contents¶
-
class foxes_opt.core.farm_opt_problem.FarmOptProblem(name: str, algo: foxes.core.Algorithm, sel_turbines: list[int] | None =
None, calc_farm_args: dict[str, Any] | None =None, points: numpy.ndarray | None =None, **kwargs: Any)[source]¶ Bases:
iwopy.ProblemAbstract base class of wind farm optimization problems.
- Parameters:¶
- name
The problem’s name
- algo
The algorithm
- sel_turbines
The turbines selected for optimization, or None for all
- calc_farm_args
Additional parameters for algo.calc_farm()
- points
The probe points, shape: (n_states, n_points, 3)
- kwargs
Additional parameters for iwopy.Problem
-
add_constraint(constraint, varmap_int=
None, varmap_float=None, verbosity=0)¶ Add a constraint to the problem.
- Parameters:¶
- constraint: iwopy.Constraint
The constraint
- varmap_int: dict, optional
Mapping from objective variables to problem variables. Key: str or int, value: str or int
- varmap_float: dict, optional
Mapping from objective variables to problem variables. Key: str or int, value: str or int
- verbosity: int
The verbosity level, 0 = silent
-
add_objective(objective, varmap_int=
None, varmap_float=None, verbosity=0)¶ Add an objective to the problem.
- Parameters:¶
- objective: iwopy.Objective
The objective
- varmap_int: dict, optional
Mapping from objective variables to problem variables. Key: str or int, value: str or int
- varmap_float: dict, optional
Mapping from objective variables to problem variables. Key: str or int, value: str or int
- verbosity: int
The verbosity level, 0 = silent
- add_to_layout_figure(ax: matplotlib.axes.Axes, **kwargs: Any) matplotlib.axes.Axes[source]¶
Add to a layout figure
- Parameters:¶
- ax
The figure axis
- apply_individual(vars_int: numpy.ndarray, vars_float: numpy.ndarray) Any[source]¶
Apply new variables to the problem.
- apply_population(vars_int: numpy.ndarray, vars_float: numpy.ndarray) Any[source]¶
Apply new variables to the problem, for a whole population.
-
calc_gradients(vars_int, vars_float, func, components, ivars, fvars, vrs, pop=
False, verbosity=0)¶ The actual gradient calculation, not to be called directly (call get_gradients instead).
Can be overloaded in derived classes, the base class only considers analytic derivatives.
- Parameters:¶
- vars_int: np.array
The integer variable values, shape: (n_vars_int,)
- vars_float: np.array
The float variable values, shape: (n_vars_float,)
- func: iwopy.core.OptFunctionList, optional
The functions to be differentiated, or None for a list of all objectives and all constraints (in that order)
- components: list of int, optional
The function’s component selection, or None for all
- ivars: list of int
The indices of the function int variables in the problem
- fvars: list of int
The indices of the function float variables in the problem
- vrs: list of int
The function float variable indices wrt which the derivatives are to be calculated
- pop: bool
Flag for vectorizing calculations via population
- verbosity: int
The verbosity level, 0 = silent
- Returns:¶
- gradients: numpy.ndarray
The gradients of the functions, shape: (n_components, n_vrs)
-
check_constraints_individual(constraint_values, verbosity=
0)¶ Check if the constraints are fullfilled for the given individual.
-
check_constraints_population(constraint_values, verbosity=
0)¶ Check if the constraints are fullfilled for the given population.
-
evaluate_individual(vars_int, vars_float, ret_prob_res=
False)¶ Evaluate a single individual of the problem.
- Parameters:¶
- vars_int: np.array
The integer variable values, shape: (n_vars_int,)
- vars_float: np.array
The float variable values, shape: (n_vars_float,)
- ret_prob_res: bool
Flag for additionally returning of problem results
- Returns:¶
- objs: np.array
The objective function values, shape: (n_objectives,)
- con: np.array
The constraints values, shape: (n_constraints,)
- prob_res: object, optional
The problem results
-
evaluate_population(vars_int, vars_float, ret_prob_res=
False)¶ Evaluate all individuals of a population.
- Parameters:¶
- vars_int: np.array
The integer variable values, shape: (n_pop, n_vars_int)
- vars_float: np.array
The float variable values, shape: (n_pop, n_vars_float)
- ret_prob_res: bool
Flag for additionally returning of problem results
- Returns:¶
- objs: np.array
The objective function values, shape: (n_pop, n_objectives)
- cons: np.array
The constraints values, shape: (n_pop, n_constraints)
- prob_res: object, optional
The problem results
-
finalize(verbosity=
0)¶ Finalize the object.
- Parameters:¶
- verbosity: int
The verbosity level, 0 = silent
-
finalize_individual(vars_int, vars_float, verbosity=
1)¶ Finalization, given the champion data.
- Parameters:¶
- vars_int: np.array
The optimal integer variable values, shape: (n_vars_int,)
- vars_float: np.array
The optimal float variable values, shape: (n_vars_float,)
- verbosity: int
The verbosity level, 0 = silent
- Returns:¶
- problem_results: Any
The results of the variable application to the problem
- objs: np.array
The objective function values, shape: (n_objectives,)
- cons: np.array
The constraints values, shape: (n_constraints,)
-
finalize_population(vars_int, vars_float, verbosity=
0)¶ Finalization, given the final population data.
- Parameters:¶
- vars_int: np.array
The integer variable values of the final generation, shape: (n_pop, n_vars_int)
- vars_float: np.array
The float variable values of the final generation, shape: (n_pop, n_vars_float)
- verbosity: int
The verbosity level, 0 = silent
- Returns:¶
- problem_results: Any
The results of the variable application to the problem
- objs: np.array
The final objective function values, shape: (n_pop, n_components)
- cons: np.array
The final constraint values, shape: (n_pop, n_constraints)
-
get_gradients(vars_int, vars_float, func=
None, components=None, vars=None, pop=False, verbosity=0)¶ Obtain gradients of a function that is linked to the problem.
The func object typically is a iwopy.core.OptFunctionList object that contains a selection of objectives and/or constraints that were previously added to this problem. By default all objectives and constraints (and all their components) are being considered, cf. class ProblemDefaultFunc.
- Parameters:¶
- vars_int: np.array
The integer variable values, shape: (n_vars_int,)
- vars_float: np.array
The float variable values, shape: (n_vars_float,)
- func: iwopy.core.OptFunctionList, optional
The functions to be differentiated, or None for a list of all objectives and all constraints (in that order)
- components: list of int, optional
The function’s component selection, or None for all
- vars: list of int or str, optional
The float variables wrt which the derivatives are to be calculated, or None for all
- verbosity: int
The verbosity level, 0 = silent
- pop: bool
Flag for vectorizing calculations via population
- Returns:¶
- gradients: numpy.ndarray
The gradients of the functions, shape: (n_components, n_vars)
- initial_values_float()¶
The initial values of the float variables.
- Returns:¶
- values: numpy.ndarray
Initial float values, shape: (n_vars_float,)
- initial_values_int()¶
The initial values of the integer variables.
- Returns:¶
- values: numpy.ndarray
Initial int values, shape: (n_vars_int,)
-
initialize(verbosity: int =
1) None[source]¶ Initialize the object.
- Parameters:¶
- verbosity
The verbosity level, 0 = silent
- max_values_float()¶
The maximal values of the float variables.
Use numpy.inf for unbounded.
- Returns:¶
- values: numpy.ndarray
Maximal float values, shape: (n_vars_float,)
- max_values_int()¶
The maximal values of the integer variables.
Use self.INT_INF for unbounded.
- Returns:¶
- values: numpy.ndarray
Maximal int values, shape: (n_vars_int,)
- min_values_float()¶
The minimal values of the float variables.
Use -numpy.inf for unbounded.
- Returns:¶
- values: numpy.ndarray
Minimal float values, shape: (n_vars_float,)
- min_values_int()¶
The minimal values of the integer variables.
Use -self.INT_INF for unbounded.
- Returns:¶
- values: numpy.ndarray
Minimal int values, shape: (n_vars_int,)
- classmethod new(problem_type: str, *args: Any, **kwargs: Any) Any[source]¶
Run-time farm opt problem factory.
- Parameters:¶
- problem_type
The selected derived class name
- args
Additional parameters for the constructor
- kwargs
Additional parameters for the constructor
- classmethod parse_tvar(tvr: str) tuple[str, int][source]¶
Parse foxes variable name and turbine index from turbine variable
- prob_res_einsum_individual(prob_res_list, coeffs)¶
Calculate the einsum of problem results
- prob_res_einsum_population(prob_res_list, coeffs)¶
Calculate the einsum of problem results
- update_problem_individual(vars_int: numpy.ndarray, vars_float: numpy.ndarray) None[source]¶
Update the algo and other data using the latest optimization variables.
This function is called before running the farm calculation.
- Parameters:¶
- vars_int
The integer variable values, shape: (n_vars_int,)
- vars_float
The float variable values, shape: (n_vars_float,)
- update_problem_population(vars_int: numpy.ndarray, vars_float: numpy.ndarray) None[source]¶
Update the algo and other data using the latest optimization variables.
This function is called before running the farm calculation.
- Parameters:¶
- vars_int
The integer variable values, shape: (n_pop, n_vars_int,)
- vars_float
The float variable values, shape: (n_pop, n_vars_float,)
- var_names_float()¶
The names of float variables.
- Returns:¶
- names: list of str
The names of the float variables
- var_names_int()¶
The names of integer variables.
- Returns:¶
- names: list of str
The names of the integer variables
-
INT_INF =
-999999¶
- algo¶
- property all_turbines : bool¶
Flag for all turbines optimization
- Returns:¶
- value
True if all turbines are subject to optimization
- calc_farm_args¶
- cons¶
- property constraints_tol¶
Gets the tolerance values of constraints
- Returns:¶
- ctol: numpy.ndarray
The constraint tolerance values, shape: (n_constraints,)
- property counter : int | None¶
The current value of the application counter
- Returns:¶
- value
The current value of the application counter
- property initialized¶
Flag for finished initialization
- Returns:¶
- bool
True if initialization has been done
- property max_values_constraints¶
Gets the maximal values of constraints
- Returns:¶
- cma: numpy.ndarray
The maximal constraint values, shape: (n_constraints,)
- property maximize_objs¶
Flags for objective maximization
- Returns:¶
- maximize: numpy.ndarray
Boolean flag for maximization of objective, shape: (n_objectives,)
-
memory =
None¶
- property min_values_constraints¶
Gets the minimal values of constraints
- Returns:¶
- cmi: numpy.ndarray
The minimal constraint values, shape: (n_constraints,)
- property n_constraints¶
The total number of constraints, i.e., the sum of all components
- Returns:¶
- n_con: int
The total number of constraint functions
- property n_objectives¶
The total number of objectives, i.e., the sum of all components
- Returns:¶
- n_obj: int
The total number of objective functions
- property n_sel_turbines : int¶
The numer of selected turbines
- Returns:¶
- value
The numer of selected turbines
- name¶
- objs¶
-
points =
None¶