<< lowdisc_cget Sequences lowdisc_destroy >>

Low Discrepancy Toolbox >> Low Discrepancy Toolbox > Sequences > lowdisc_configure

lowdisc_configure

Configure a field of the object and returns the modified object.

Calling Sequence

this = lowdisc_configure (this,key,value)

Parameters

this:

the current object

key:

a string. The name of the option to get. All options which can be set with lowdisc_configure can be get with lowdisc_cget.

value:

the value associated with the key. Its type depends on the value of the key.

Description

This command allows to configure the state of the current object. It requires to take the current object both as an input and output argument. The following keys are available.

Some sequences can be configured in order to increase their maximum dimension. These sequences accept the following "-primeslist" option.

The sequences which are sensitive to this option are : "halton", "haltonf", "faure", "fauref", "reversehalton", "reversehaltonf".

For the Fast Niederreiter sequence in arbitrary base, we can configure the base.

Some expertise is required to configure the skip and leap options. The skip option can improve the Faure, Sobol and Niederreiter sequences. The leap option can improve the Halton sequence, although Kocis and Whiten also tried to leap the Faure and Sobol sequences. This can lead to some trouble for non-experts. For that purpose, we designed the following functions.

These functions have been designed to include suggestions by various authors to improve the sequences. In the situation where we have no knowledge of the settings to use, these functions may be used. Still, these have not been included as defaults, which authorizes a more aware choice of the parameters.

Some sequences are limited in the maximum number of dimensions, because they use internally fixed tables of parameters (e.g. the Sobol sequence). Some other sequences can be extended with the "-primeslist" option. The "-primeslist" option can be configure with a table of primes computed with the lowdisc_primes100(), lowdisc_primes1000() or lowdisc_primes10000() functions. The maximum dimension which can be attained with these tables depends on the sequence. See the specific settings of each sequence below for detail.

Examples

lds = lowdisc_new("faure");
lds = lowdisc_configure(lds,"-dimension",3);
method = lowdisc_cget(lds,"-method")
nbdim = lowdisc_cget(lds,"-dimension")
i = lowdisc_cget(lds,"-sequenceindex")
verbose = lowdisc_cget(lds,"-verbose")
lds
lds = lowdisc_destroy(lds);

Authors

<< lowdisc_cget Sequences lowdisc_destroy >>