Passed
Push — master ( 7ebd63...8bd9a3 )
by Simon
06:11
created

RandomAnnealingOptimizer.__init__()   A

Complexity

Conditions 1

Size

Total Lines 30
Code Lines 29

Duplication

Lines 30
Ratio 100 %

Importance

Changes 0
Metric Value
eloc 29
dl 30
loc 30
rs 9.184
c 0
b 0
f 0
cc 1
nop 12

How to fix   Many Parameters   

Many Parameters

Methods with many parameters are not only hard to understand, but their parameters also often become inconsistent when you need more, or different data.

There are several approaches to avoid long parameter lists:

1
# Author: Simon Blanke
2
# Email: [email protected]
3
# License: MIT License
4
5
from typing import List, Dict, Literal, Literal
6
7
from ..search import Search
8
from ..optimizers import RandomAnnealingOptimizer as _RandomAnnealingOptimizer
9
10
11 View Code Duplication
class RandomAnnealingOptimizer(_RandomAnnealingOptimizer, Search):
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated in your project.
Loading history...
12
    """
13
    A class implementing **random annealing** for the public API.
14
    Inheriting from the `Search`-class to get the `search`-method and from
15
    the `RandomAnnealingOptimizer`-backend to get the underlying algorithm.
16
17
    Parameters
18
    ----------
19
    search_space : dict[str, list]
20
        The search space to explore. A dictionary with parameter
21
        names as keys and a numpy array as values.
22
    initialize : dict[str, int]
23
        The method to generate initial positions. A dictionary with
24
        the following key literals and the corresponding value type:
25
        {"grid": int, "vertices": int, "random": int, "warm_start": list[dict]}
26
    constraints : list[callable]
27
        A list of constraints, where each constraint is a callable.
28
        The callable returns `True` or `False` dependend on the input parameters.
29
    random_state : None, int
30
        If None, create a new random state. If int, create a new random state
31
        seeded with the value.
32
    rand_rest_p : float
33
        The probability of a random iteration during the the search process.
34
    epsilon : float
35
        The step-size for the climbing.
36
    distribution : str
37
        The type of distribution to sample from.
38
    n_neighbours : int
39
        The number of neighbours to sample and evaluate before moving to the best
40
        of those neighbours.
41
    annealing_rate : float
42
        The annealing rate for the temperature.
43
    start_temp : float
44
        The initial temperature.
45
    """
46
47
    def __init__(
48
        self,
49
        search_space: Dict[str, list],
50
        initialize: Dict[
51
            Literal["grid", "vertices", "random", "warm_start"], int | List
52
        ] = {"grid": 4, "random": 2, "vertices": 4},
53
        constraints: List[callable] = [],
54
        random_state: int = None,
55
        rand_rest_p: float = 0,
56
        nth_process: int = None,
57
        epsilon: float = 0.03,
58
        distribution: Literal[
59
            "normal", "laplace", "gumbel", "logistic"
60
        ] = "normal",
61
        n_neighbours: int = 3,
62
        annealing_rate=0.98,
63
        start_temp=10,
64
    ):
65
        super().__init__(
66
            search_space=search_space,
67
            initialize=initialize,
68
            constraints=constraints,
69
            random_state=random_state,
70
            rand_rest_p=rand_rest_p,
71
            nth_process=nth_process,
72
            epsilon=epsilon,
73
            distribution=distribution,
74
            n_neighbours=n_neighbours,
75
            annealing_rate=annealing_rate,
76
            start_temp=start_temp,
77
        )
78