The following types of columns are created:
If you want to convert these, look at
Dependent parameters whose constraints are unsatisfied generate
NA entries in their
For discrete vectors the levels and their order will be preserved, even if not all levels are present.
Currently only lhs designs are supported.
The algorithm currently iterates the following steps:
We create a space filling design for all parameters, disregarding
trafo or the forbidden region.
Forbidden points are removed.
Parameters are trafoed (potentially, depending on the setting of argument
dependent parameters whose constraints are unsatisfied are set to
Duplicated design points are removed. Duplicated points are not generated in a reasonable space-filling design, but the way discrete parameters and also parameter dependencies are handled make this possible.
If we removed some points, we now try to augment the design in a space-filling way and iterate.
Note that augmenting currently is somewhat experimental as we simply generate
missing points via new calls to
lhs::randomLHS(), but do not add points so
they are maximally far away from the already present ones. The reason is that
the latter is quite hard to achieve with complicated dependencies and
forbidden regions, if one wants to ensure that points actually get added...
But we are working on it.
Note that if you have trafos attached to your params, the complete creation
of the design (except for the detection of invalid parameters w.r.t to their
requires setting) takes place on the UNTRANSFORMED scale. So this function
creates, e.g., a maximin LHS design on the UNTRANSFORMED scale, but not
necessarily the transformed scale.
generateDesign will NOT work if there are dependencies over multiple levels
of parameters and the dependency is only given with respect to the
“previous” parameter. A current workaround is to state all
dependencies on all parameters involved. (We are working on it.)
generateDesign( n = 10L, par.set, fun, fun.args = list(), trafo = FALSE, augment = 20L )
data.frame. Columns are named by the ids of the parameters. If the
par.set argument contains a vector parameter, its corresponding column
names in the design are the parameter id concatenated with 1 to dimension
of the vector. The result will have an
“trafo”, which is set to the value of argument
ps = makeParamSet( makeNumericParam("x1", lower = -2, upper = 1), makeIntegerParam("x2", lower = 10, upper = 20) ) # random latin hypercube design with 5 samples: generateDesign(5, ps)#> x1 x2 #> 1 0.92476040 14 #> 2 -1.97945520 10 #> 3 0.04139694 12 #> 4 -0.55787713 16 #> 5 -1.16677921 20# with trafo ps = makeParamSet( makeNumericParam("x", lower = -2, upper = 1), makeNumericVectorParam("y", len = 2, lower = 0, upper = 1, trafo = function(x) x / sum(x)) ) generateDesign(10, ps, trafo = TRUE)#> x y1 y2 #> 1 -0.06164406 0.07021103 0.92978897 #> 2 -0.94052794 0.46482035 0.53517965 #> 3 -1.93874650 0.90117318 0.09882682 #> 4 0.20626204 0.44527728 0.55472272 #> 5 -1.52898651 0.39375021 0.60624979 #> 6 0.75745541 0.91641603 0.08358397 #> 7 0.56338102 0.43994502 0.56005498 #> 8 -1.28854664 0.31894308 0.68105692 #> 9 -0.38299058 0.41814615 0.58185385 #> 10 -0.63202615 0.51549263 0.48450737