Augment - Add design points

Syntax

Description

Augment is a method of mbcdoe.design. Use it to add points to a design using a specified design generator. After augmenting a design, the design Style is set to Custom unless an optimal design is used for augmentation, as in the Design Editor.

D = Augment(D,Numpoints) augments the design with the number of points specified by Numpoints using the current generator settings.

D = Augment(D,'Prop1',value1,...) augments the design with the generator specified by the generator property value pairs.

You can use the Augment method to add points to an existing type using a different design type.

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

To set all designs points to fixed and then augment an existing design optimally, use the FixPoints method to fix all the points as follows:

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

When augmenting with an optimal design generator existing points which are not fixed may be changed. To add points optimally and keep only fixed points, use RemovePoints before augmenting, e.g.,

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:

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.

Examples

To create a candidate set and then optimally augment a design 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 );

See Also

CreateCandidateSet | Generate

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS