ConstrainedGenerate

Generate constrained space-filling design of specified size

collapse all in page

Syntax

DoeObjMod = ConstrainedGenerate(DoeObj,NumPoints)
DoeObjMod = ConstrainedGenerate(DoeObj,NumPoints,'Name1','Value1',…)

Description

DoeObjMod = ConstrainedGenerate(DoeObj,NumPoints) generates a space-filling design with the number of constrained points specified by NumPoints.

Use ConstrainedGenerate for only space-filling designs. It may not be possible to achieve a specified number of points, depending on the generator settings and constraints.

ConstrainedGenerate calls Generate and uses this formula to update UnconstrainedSize.

UnconstrainedSize = ceil(UnconstrainedSize * NumPoints/D.NumberOfPoints);

DoeObjMod = ConstrainedGenerate(DoeObj,NumPoints,'Name1','Value1',…) augments the generated space-filling design with the options specified by the name-value pairs.

example

Examples

collapse all

Use an existing space-filling design to create a 200-point design, then you inspect the constrained design and the total number of points.

sfDesign = ConstrainedGenerate( sfDesign, 200, 'UnconstrainedSize', 800, 'MaxIter',10  );

% How did we do?
finalNumberOfPoints = sfDesign.NumberOfPoints
% How many points did we need in total?
totalNumberOfPoints = sfDesign.Generator.NumberOfPoints

finalNumberOfPoints =
   200
totalNumberOfPoints =
   839

Input Arguments

collapse all

Instance of mbcdoe.design class, specified as a mbcdoe.design doe design object.

Number of design points, specified as a mbcdoe.designconstraint object.

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'Type','V-optimal'

The design generator properties determines the applicable name-value pairs.

Maximum number of iterations, specified as the comma-separated pair consisting of 'MaxIterations' and an integer.

Example: 'MaxIterations',15

Total number of points in the unconstrained design, specified as the comma-separated pair consisting of 'UnconstrainedSize' and an integer.

Example: 'UnconstrainedSize',10

Output Arguments

collapse all

Modified instance of mbcdoe.design class, returned as a mbcdoe.design object.

Version History

Introduced in R2008a

See Also

| |