Augment

Add design points

collapse all in page

Syntax

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

Description

DoeObjMod = Augment(DoeObj,NumPoints) augments the design with the number of points specified by NumPoints using the current generator settings.

example

DoeObjMod = Augment(DoeObj,'Name1','Value1',…) augments the design with the generator specified by the name-value pairs.

example

Examples

collapse all

OptDesign = Augment(OptDesign,...
    'Type','V-optimal',...
    'MaxIterations',200,...
    'NoImprovement', 50,...
    'NumberOfPoints',20);

Use FixPoints to set all the designs points to fixed and then optimally augment an existing design.

OptDesign = FixPoints(OptDesign);
OptDesign = Augment(OptDesign,...
    'Type','V-optimal',...
    'MaxIterations',200,...
    'NoImprovement', 50,...
    'NumberOfPoints',20);

Use RemovePoints to optimally add points and keep only fixed points.

OptDesign = RemovePoints(OptDesign,'free');
OptDesign = Augment(OptDesign,...
    'Type','V-optimal',...
    'MaxIterations',200,...
    'NoImprovement', 50,...
    'NumberOfPoints',20);

To get a candidate set object for use with an optimal design, use this code.

C = CreateCandidateSet(OptDesign,'Type', 'Grid',...
       'NumberOfLevels',[21 21 21]);

You see an error if you try to call Augment when the design Style is User-defined or Experimental data.

Create a candidate set and optimally augment it with 10 points.

CandidateSet = augmentedDesign.CreateCandidateSet...
( 'Type', 'Grid' );
CandidateSet.NumberOfLevels = [21 21 21 21];
augmentedDesign = Augment( augmentedDesign,...
    'Type', 'V-optimal',...
    'NumberOfPoints', 10,...
    'CandidateSet', CandidateSet,...
    'MaxIterations', 200,...
    'NoImprovement', 50 );

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.

Generator type, specified as the comma-separated pair consisting of 'Type' and a character vector.

Example: 'Type','V-optimal'

Number of points, specified as the comma-separated pair consisting of 'NumberOfPoints' and an integer.

Example: 'NumberOfPoints',20

Output Arguments

collapse all

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

Version History

Introduced in R2008a

See Also

| |