$extrastylesheet
Dakota  Version 6.2
Public Member Functions | Private Member Functions | Static Private Member Functions | Private Attributes
DDACEDesignCompExp Class Reference

Wrapper class for the DDACE design of experiments library. More...

Inheritance diagram for DDACEDesignCompExp:
PStudyDACE Analyzer Iterator

List of all members.

Public Member Functions

 DDACEDesignCompExp (ProblemDescDB &problem_db, Model &model)
 primary constructor for building a standard DACE iterator
 DDACEDesignCompExp (Model &model, int samples, int symbols, int seed, unsigned short sampling_method)
 alternate constructor used for building approximations
 ~DDACEDesignCompExp ()
 destructor
void pre_run ()
 pre-run portion of run (optional); re-implemented by Iterators which can generate all Variables (parameter sets) a priori
void extract_trends ()
 Mapping of the core_run() virtual function for the PStudy/DACE branch.
void post_input ()
 read tabular data for post-run mode
void post_run (std::ostream &s)
 post-run portion of run (optional); verbose to print results; re-implemented by Iterators that can read all Variables/Responses and perform final analysis phase in a standalone way
int num_samples () const
void sampling_reset (int min_samples, bool all_data_flag, bool stats_flag)
 reset sampling iterator to use at least min_samples
unsigned short sampling_scheme () const
 return sampling name
void vary_pattern (bool pattern_flag)
 sets varyPattern in derived classes that support it
void get_parameter_sets (Model &model)
 Returns one block of samples (ndim * num_samples)

Private Member Functions

void compute_main_effects ()
 builds a DDaceMainEffects::OneWayANOVA if mainEffectsFlag is set
boost::shared_ptr
< DDaceSamplerBase > 
create_sampler (Model &model)
 create a DDACE sampler
void resolve_samples_symbols ()
 convenience function for resolving number of samples and number of symbols from input.

Static Private Member Functions

static void copy_data (const std::vector< DDaceSamplePoint > &dspa, Real *ptr, const int ptr_len)
 copy DDACE point to RealVector

Private Attributes

unsigned short daceMethod
 oas, lhs, oa_lhs, random, box_behnken, central_composite, or grid
int samplesSpec
 initial specification of number of samples
int symbolsSpec
 initial specification of number of symbols
int numSamples
 current number of samples to be evaluated
int numSymbols
 current number of symbols to be used in generating the sample set (inversely related to number of replications)
const int seedSpec
 the user seed specification for the random number generator (allows repeatable results)
int randomSeed
 current seed for the random number generator
bool allDataFlag
 flag which triggers the update of allVars/allResponses for use by Iterator::all_variables() and Iterator::all_responses()
size_t numDACERuns
 counter for number of executions for this object
bool varyPattern
 flag for continuing the random number sequence from a previous execution (e.g., for surrogate-based optimization) so that multiple executions are repeatable but not correlated.
bool mainEffectsFlag
 flag which specifies main effects
std::vector< std::vector< int > > symbolMapping
 mapping of symbols for main effects calculations

Detailed Description

Wrapper class for the DDACE design of experiments library.

The DDACEDesignCompExp class provides a wrapper for DDACE, a C++ design of experiments library from the Computational Sciences and Mathematics Research (CSMR) department at Sandia's Livermore CA site. This class uses design and analysis of computer experiments (DACE) methods to sample the design space spanned by the bounds of a Model. It returns all generated samples and their corresponding responses as well as the best sample found.


Constructor & Destructor Documentation

DDACEDesignCompExp ( ProblemDescDB problem_db,
Model model 
)

primary constructor for building a standard DACE iterator

This constructor is called for a standard iterator built with data from probDescDB.

References Dakota::abort_handler(), DDACEDesignCompExp::daceMethod, DDACEDesignCompExp::mainEffectsFlag, Iterator::maxEvalConcurrency, Analyzer::numContinuousVars, and DDACEDesignCompExp::numSamples.

DDACEDesignCompExp ( Model model,
int  samples,
int  symbols,
int  seed,
unsigned short  sampling_method 
)

alternate constructor used for building approximations

This alternate constructor is used for instantiations on-the-fly, using only the incoming data. No problem description database queries are used.

References Iterator::maxEvalConcurrency, DDACEDesignCompExp::numSamples, and DDACEDesignCompExp::resolve_samples_symbols().


Member Function Documentation

void pre_run ( ) [virtual]

pre-run portion of run (optional); re-implemented by Iterators which can generate all Variables (parameter sets) a priori

pre-run phase, which a derived iterator may optionally reimplement; when not present, pre-run is likely integrated into the derived run function. This is a virtual function; when re-implementing, a derived class must call its nearest parent's pre_run(), if implemented, typically _before_ performing its own implementation steps.

Reimplemented from Iterator.

References DDACEDesignCompExp::get_parameter_sets(), Iterator::iteratedModel, and PStudyDACE::varBasedDecompFlag.

void post_run ( std::ostream &  s) [virtual]

post-run portion of run (optional); verbose to print results; re-implemented by Iterators that can read all Variables/Responses and perform final analysis phase in a standalone way

Post-run phase, which a derived iterator may optionally reimplement; when not present, post-run is likely integrated into run. This is a virtual function; when re-implementing, a derived class must call its nearest parent's post_run(), typically _after_ performing its own implementation steps.

Reimplemented from Analyzer.

References Analyzer::allResponses, Analyzer::allSamples, SensAnalysisGlobal::compute_correlations(), DDACEDesignCompExp::compute_main_effects(), DDACEDesignCompExp::create_sampler(), Iterator::iteratedModel, DDACEDesignCompExp::mainEffectsFlag, PStudyDACE::pStudyDACESensGlobal, Iterator::subIteratorFlag, DDACEDesignCompExp::symbolMapping, and PStudyDACE::varBasedDecompFlag.

int num_samples ( ) const [inline, virtual]

Return current number of evaluation points. Since the calculation of samples, collocation points, etc. might be costly, provide a default implementation here that backs out from the maxEvalConcurrency.

Reimplemented from Analyzer.

References DDACEDesignCompExp::numSamples.

void resolve_samples_symbols ( ) [private]

convenience function for resolving number of samples and number of symbols from input.

This function must define a combination of samples and symbols that is acceptable for a particular sampling algorithm. Users provide requests for these quantities, but this function must enforce any restrictions imposed by the sampling algorithms.

References Dakota::abort_handler(), DDACEDesignCompExp::daceMethod, Analyzer::numContinuousVars, DDACEDesignCompExp::numSamples, DDACEDesignCompExp::numSymbols, and Iterator::submethod_enum_to_string().

Referenced by DDACEDesignCompExp::DDACEDesignCompExp(), DDACEDesignCompExp::get_parameter_sets(), and DDACEDesignCompExp::post_input().

void copy_data ( const std::vector< DDaceSamplePoint > &  dspa,
Real *  ptr,
const int  ptr_len 
) [static, private]

copy DDACE point to RealVector

copy DDACE point array to RealVectorArray copy DDACE point array to Real*

References Dakota::abort_handler().

Referenced by DDACEDesignCompExp::get_parameter_sets().


The documentation for this class was generated from the following files: