跳到内容

析因设计

smac.initial_design.factorial_design #

FactorialInitialDesign #

FactorialInitialDesign(
    scenario: Scenario,
    n_configs: int | None = None,
    n_configs_per_hyperparameter: int | None = 10,
    max_ratio: float = 0.25,
    additional_configs: list[Configuration] = None,
    seed: int | None = None,
)

基类: AbstractInitialDesign

用于选择角点和中间配置的析因初始设计。

源代码位于 smac/initial_design/abstract_initial_design.py 
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
def __init__(
    self,
    scenario: Scenario,
    n_configs: int | None = None,
    n_configs_per_hyperparameter: int | None = 10,
    max_ratio: float = 0.25,
    additional_configs: list[Configuration] = None,
    seed: int | None = None,
):
    self._configspace = scenario.configspace

    if seed is None:
        seed = scenario.seed

    self.use_default_config = scenario.use_default_config

    self._seed = seed
    self._rng = np.random.RandomState(seed)
    self._n_configs_per_hyperparameter = n_configs_per_hyperparameter

    # make sure that additional configs is not a mutable default value
    # this avoids issues
    if additional_configs is None:
        additional_configs = []

    if self.use_default_config:
        default_config = self._configspace.get_default_configuration()
        default_config.origin = "Initial Design: Default configuration"
        additional_configs.append(default_config)

    self._additional_configs = additional_configs

    n_params = len(list(self._configspace.values()))
    if n_configs is not None:
        logger.info("Using `n_configs` and ignoring `n_configs_per_hyperparameter`.")
        self._n_configs = n_configs
    elif n_configs_per_hyperparameter is not None:
        self._n_configs = n_configs_per_hyperparameter * n_params
    else:
        raise ValueError(
            "Need to provide either argument `n_configs` or "
            "`n_configs_per_hyperparameter` but provided none of them."
        )

    # If the number of configurations is too large, we reduce it
    _n_configs = int(max(1, min(self._n_configs, (max_ratio * scenario.n_trials))))
    if self._n_configs != _n_configs:
        logger.info(
            f"Reducing the number of initial configurations from {self._n_configs} to "
            f"{_n_configs} (max_ratio == {max_ratio})."
        )
        self._n_configs = _n_configs

    # We allow no configs if we have additional configs
    if n_configs is not None and n_configs == 0 and len(additional_configs) > 0:
        self._n_configs = 0

    if self._n_configs + len(additional_configs) > scenario.n_trials:
        raise ValueError(
            f"Initial budget {self._n_configs} cannot be higher than the number of trials {scenario.n_trials}."
        )

meta 属性 #

meta: dict[str, Any]

返回创建对象的元数据。

select_configurations #

select_configurations() -> list[Configuration]

选择初始配置。内部调用 _select_configurations 方法，该方法必须由子类实现。

返回值#

configs : list[Configuration] 来自子类的配置。

源代码位于 smac/initial_design/abstract_initial_design.py 
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
def select_configurations(self) -> list[Configuration]:
    """Selects the initial configurations. Internally, `_select_configurations` is called,
    which has to be implemented by the child class.

    Returns
    -------
    configs : list[Configuration]
        Configurations from the child class.
    """
    configs: list[Configuration] = []

    if self._n_configs == 0:
        logger.info("No initial configurations are used.")
    else:
        configs += self._select_configurations()

    # Adding additional configs
    configs += self._additional_configs

    for config in configs:
        if config.origin is None:
            config.origin = "Initial design"

    # Removing duplicates
    # (Reference: https://stackoverflow.com/questions/7961363/removing-duplicates-in-lists)
    configs = list(OrderedDict.fromkeys(configs))
    logger.info(
        f"Using {len(configs) - len(self._additional_configs)} initial design configurations "
        f"and {len(self._additional_configs)} additional configurations."
    )

    return configs