def create_experiment(name, version, space, **kwargs):
"""Instantiate the experiment and its attribute objects
All unspecified arguments will be replaced by system's defaults (orion.core.config.*).
Parameters
----------
name: str
Name of the experiment.
version: int
Version of the experiment.
space: dict or Space object
Optimization space of the algorithm. If dict, should have the form
`dict(name='<prior>(args)')`.
algorithms: str or dict, optional
Algorithm used for optimization.
strategy: str or dict, optional
Parallel strategy to use to parallelize the algorithm.
max_trials: int, optional
Maximum number or trials before the experiment is considered done.
storage: dict, optional
Configuration of the storage backend.
"""
experiment = Experiment(name=name, version=version)
experiment._id = kwargs.get('_id', None) # pylint:disable=protected-access
experiment.pool_size = kwargs.get('pool_size')
if experiment.pool_size is None:
experiment.pool_size = orion.core.config.experiment.get(
'pool_size', deprecated='ignore')
experiment.max_trials = kwargs.get('max_trials',
orion.core.config.experiment.max_trials)
experiment.space = _instantiate_space(space)
experiment.algorithms = _instantiate_algo(experiment.space,
kwargs.get('algorithms'))
experiment.producer = kwargs.get('producer', {})
experiment.producer['strategy'] = _instantiate_strategy(
experiment.producer.get('strategy'))
experiment.working_dir = kwargs.get(
'working_dir', orion.core.config.experiment.working_dir)
experiment.metadata = kwargs.get(
'metadata', {'user': kwargs.get('user', getpass.getuser())})
experiment.refers = kwargs.get('refers', {
'parent_id': None,
'root_id': None,
'adapter': []
})
experiment.refers['adapter'] = _instantiate_adapters(
experiment.refers.get('adapter', []))
return experiment
def test_register_trials(tmp_path, random_dt):
"""Register a list of newly proposed trials/parameters."""
with OrionState():
exp = Experiment("supernaekei", mode="x")
exp._id = 0
exp.working_dir = tmp_path
trials = [
Trial(params=[{"name": "a", "type": "integer", "value": 5}]),
Trial(params=[{"name": "b", "type": "integer", "value": 6}]),
]
for trial in trials:
exp.register_trial(trial)
yo = list(map(lambda trial: trial.to_dict(), get_storage().fetch_trials(exp)))
assert len(yo) == len(trials)
assert yo[0]["params"] == list(map(lambda x: x.to_dict(), trials[0]._params))
assert yo[1]["params"] == list(map(lambda x: x.to_dict(), trials[1]._params))
assert yo[0]["status"] == "new"
assert yo[1]["status"] == "new"
assert yo[0]["submit_time"] == random_dt
assert yo[1]["submit_time"] == random_dt
assert yo[0]["exp_working_dir"] == tmp_path
assert yo[1]["exp_working_dir"] == tmp_path
def create_experiment(name, version, mode, space, **kwargs):
"""Instantiate the experiment and its attribute objects
All unspecified arguments will be replaced by system's defaults (orion.core.config.*).
Parameters
----------
name: str
Name of the experiment.
version: int
Version of the experiment.
mode: str
The access rights of the experiment on the database.
'r': read access only
'w': can read and write to database
'x': can read and write to database, algo is instantiated and can execute optimization
space: dict or Space object
Optimization space of the algorithm. If dict, should have the form
`dict(name='<prior>(args)')`.
algorithms: str or dict, optional
Algorithm used for optimization.
strategy: str or dict, optional
Parallel strategy to use to parallelize the algorithm.
max_trials: int, optional
Maximum number or trials before the experiment is considered done.
max_broken: int, optional
Number of broken trials for the experiment to be considered broken.
storage: dict, optional
Configuration of the storage backend.
"""
experiment = Experiment(name=name, version=version, mode=mode)
experiment._id = kwargs.get("_id", None) # pylint:disable=protected-access
experiment.max_trials = kwargs.get("max_trials",
orion.core.config.experiment.max_trials)
experiment.max_broken = kwargs.get("max_broken",
orion.core.config.experiment.max_broken)
experiment.space = _instantiate_space(space)
experiment.algorithms = _instantiate_algo(
experiment.space,
experiment.max_trials,
kwargs.get("algorithms"),
ignore_unavailable=mode != "x",
)
# TODO: Remove for v0.4
_instantiate_strategy(kwargs.get("producer", {}).get("strategy"))
experiment.working_dir = kwargs.get(
"working_dir", orion.core.config.experiment.working_dir)
experiment.metadata = kwargs.get(
"metadata", {"user": kwargs.get("user", getpass.getuser())})
experiment.refers = kwargs.get("refers", {
"parent_id": None,
"root_id": None,
"adapter": []
})
experiment.refers["adapter"] = _instantiate_adapters(
experiment.refers.get("adapter", []))
log.debug("Created experiment with config:\n%s",
pprint.pformat(experiment.configuration))
return experiment
