Create a description object for a parameter.

For each parameter type a special constructor function is available, see below.

For the following arguments you can also pass an expression instead of a concrete value: default, len, lower, upper, values. These expressions can depend on arbitrary symbols, which are later filled in / substituted from a dictionary, in order to produce a concrete valu, see evaluateParamExpressions(). So this enables data / context dependent settings, which is sometimes useful.

The S3 class is a list which stores these elements:

id (character(1))

See argument of same name.

type (character(1))

Data type of parameter. For all type string see (getTypeStringsAll())

len (integer(1) | expression)

See argument of same name.

lower (numeric | expression)

See argument of same name. Length of this vector is len.

upper (numeric | expression)

See argument of same name. Length of this vector is len.

values (list | expression)

Discrete values, always stored as a named list.

cnames (character

See argument of same name.

allow.inf (logical(1))

See argument of same name.

trafo (NULL | function(x))

See argument of same name.

requires (NULL | expression)

See argument of same name.

default (any concrete value | expression)

See argument of same name.

has.default (logical(1))

Extra flag to really be able to check whether the user passed a default, to avoid troubles with NULL and NA.

tunable (logical(1))

See argument of same name.

special.vals (list)

See argument of same name.

makeNumericParam(
  id,
  lower = -Inf,
  upper = Inf,
  allow.inf = FALSE,
  default,
  trafo = NULL,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeNumericVectorParam(
  id,
  len,
  lower = -Inf,
  upper = Inf,
  cnames = NULL,
  allow.inf = FALSE,
  default,
  trafo = NULL,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeIntegerParam(
  id,
  lower = -Inf,
  upper = Inf,
  default,
  trafo = NULL,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeIntegerVectorParam(
  id,
  len,
  lower = -Inf,
  upper = Inf,
  cnames = NULL,
  default,
  trafo = NULL,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeLogicalParam(
  id,
  default,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeLogicalVectorParam(
  id,
  len,
  cnames = NULL,
  default,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeDiscreteParam(
  id,
  values,
  trafo = NULL,
  default,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeDiscreteVectorParam(
  id,
  len,
  values,
  trafo = NULL,
  default,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeFunctionParam(
  id,
  default = default,
  requires = NULL,
  special.vals = list()
)

makeUntypedParam(
  id,
  default,
  requires = NULL,
  tunable = TRUE,
  special.vals = list()
)

makeCharacterParam(id, default, requires = NULL, special.vals = list())

makeCharacterVectorParam(
  id,
  len,
  cnames = NULL,
  default,
  requires = NULL,
  special.vals = list()
)

Arguments

id	(`character(1)`) Name of parameter.
lower	(`numeric` \| `expression`) Lower bounds. A singe value of length 1 is automatically replicated to `len` for vector parameters. If `len = NA` you can only pass length-1 scalars. Default is `-Inf`.
upper	(`numeric` \| `expression`) Upper bounds. A singe value of length 1 is automatically replicated to `len` for vector parameters. If `len = NA` you can only pass length-1 scalars. Default is `Inf`.
allow.inf	(`logical(1)`) Allow infinite values for numeric and numericvector params to be feasible settings. Default is `FALSE`.
default	(any concrete value \| `expression`) Default value used in learner. Note: When this is a discrete parameter make sure to use a VALUE here, not the NAME of the value. If this argument is missing, it means no default value is available.
trafo	(`NULL` \| `function(x)`) Function to transform parameter. It should be applied to the parameter value before it is, e.g., passed to a corresponding objective function. Function must accept a parameter value as the first argument and return a transformed one. Default is `NULL` which means no transformation.
requires	(`NULL` \| `call` \| `expression`) States requirements on other parameters' values, so that setting this parameter only makes sense if its requirements are satisfied (dependent parameter). Can be an object created either with `expression` or `quote`, the former type is auto-converted into the later. Only really useful if the parameter is included in a (ParamSet()). Default is `NULL` which means no requirements.
tunable	(`logical(1)`) Is this parameter tunable? Defining a parameter to be not-tunable allows to mark arguments like, e.g., “verbose” or other purely technical stuff. Note that this flag is most likely not respected by optimizing procedures unless stated otherwise. Default is `TRUE` (except for `untyped`, `function`, `character` and `characterVector`) which means it is tunable.
special.vals	(`list()`) A list of special values the parameter can except which are outside of the defined range. Default is an empty list.
len	(`integer(1)` \| `expression`) Length of vector parameter.
cnames	(`character`) Component names for vector params (except discrete). Every function in this package that creates vector values for such a param, will name that vector with `cnames`.
values	(`vector` \| `list` \| `expression`) Possible discrete values. Instead of using a vector of atomic values, you are also allowed to pass a list of quite “complex” R objects, which are used as discrete choices. If you do the latter, the elements must be uniquely named, so that the names can be used as internal representations for the choice.

Value

[Param()].

Examples

makeNumericParam("x", lower = -1, upper = 1)
#>      Type len Def  Constr Req Tunable Trafo
#> 1 numeric   -   - -1 to 1   -    TRUE     -
makeNumericVectorParam("x", len = 2)
#>            Type len Def      Constr Req Tunable Trafo
#> 1 numericvector   2   - -Inf to Inf   -    TRUE     -
makeDiscreteParam("y", values = c("a", "b"))
#>       Type len Def Constr Req Tunable Trafo
#> 1 discrete   -   -    a,b   -    TRUE     -
makeCharacterParam("z")
#>        Type len Def Constr Req Tunable Trafo
#> 1 character   -   -      -   -   FALSE     -