Client

Note

A client object can be created by calling jcmwave.optimizer.client().

class jcmwave.client.Client(host, verbose=True, check=True)

This class provides methods for creating new optimization studies. Example:

 domain = [
   {'name': 'x1', 'type': 'continuous', 'domain': (-1.5,1.5)}, 
   {'name': 'x2', 'type': 'continuous', 'domain': (-1.5,1.5)},
]
study = client.create_study(domain=domain, name='example')

check_server()

Checks if the optimization server is running. Example:

>>> client.check_server()
Optimization server is running

create_benchmark(benchmark_id=None, num_average=None)

Creates a new Benchmark object for benchmarking different optimization studies against each other. Example:

benchmark = client.create_benchmark(num_average=6);

Parameters:

• benchmark_id (str) – A unique identifier of the benchmark.
• num_average (int) – Number of study runs to determine average study performance

create_study(domain=None, name=None, study_id=None, constraints=None, driver='BayesOptimization', save_dir=None, output_precision=1e-10, dashboard=True, open_browser=True)

Creates a new Study instance. Example:

study = client.create_study(domain=domain, name='example')

Parameters:

• domain (list) –

  List of domain definitions for each parameter. A domain definition consists of a dictionary with the entries

  name:Name of the parameter. E.g. ‘x1’. The name should contain no spaces and must not be equal to function names like ‘sin’, ‘cos’, ‘exp’ etc. type:Type of the parameter. Either ‘continuous’, ‘discrete’, ‘categorial’, or ‘fixed’. Fixed parameters are not optimized, but can be used in the constraint functions. domain:The domain of the parameter. For continuous parameters this is a tuple (min, max). For discrete parameters this is a list of values, e.g. [1.0,2.5,3.0]. For categorial inputs it is a list of strings, e.g. [‘cat1’,’cat2’,’cat3’]. Note, that categorial values are internally mapped to integer representations, which are allowed to have a correlation. The categorial values should therefore be ordered according to their similarity. For fixed parameters the domain is a single parameter value.

  Example:

  domain = [{'name': 'x1', 'type': 'continuous', 'domain': (-2.0,2.0)}, 
            {'name': 'x2', 'type': 'continuous', 'domain': (-2.0,2.0)},
            {'name': 'x3', 'type': 'discrete', 'domain': [-1.0,0.0,1.0]},
            {'name': 'x4', 'type': 'categorial', 'domain': ['a','b']}
            {'name': 'x5', 'type': 'fixed', 'domain': 2.0}]
  

• constraints (list) –

  List of constraints on the domain. Each list element is a dictionary with the entries

  name:Name of the constraint. constraint:A string defining a function that is smaller zero if and only if the constraint is met. The following operations and functions may be used: +,-,*,/,^,sqrt,sin,cos,tan,abs,round, sgn, tunc. E.g. 'x1^2 + x2^2 + sin(x1+x2)'

  Example:

  constraints = [
      {'name': 'circle', 'constraint': 'x1^2+x2^2-4'},
      {'name': 'triangle', 'constraint': 'x1-x2'},
  ]
  

• study_id (str) – A unique identifier of the study. All relevant information on the study are saved in a file named study_id+’.jcmo’ If the study already exists, the domain and constraints do not need to be provided. If not set, the study_id is set to a random unique string.
• name (str) – The name of the study that will be shown in the dashboard.
• save_dir (str) – The path to a directory, where the study file (jcmo-file) is saved. If False, no study file is saved.
• driver (str) – Driver used for the study (default: ‘BayesOptimization’). For a list of drivers, see the Analysis and Optimization Toolkit/Driver Reference.
• output_precision (float) –

  Precision level for ouput of parameters. (Default: 1e-10)

  Note

  Rounding the output can potentially lead to a slight breaking of constraints.

• dashboard (bool) – If true, a dashboard server will be started for the study. (Default: True)
• open_browser (bool) – If true, a browser window with the dashboard is started. (Default: True)

shutdown_server(force=False)

Shuts down the optimization server. Example:

client.shutdown_server()

Parameters:force (bool) – If True the optimization server is closed even if a study is not yet finished.