ProblemDescDB Class Reference

The database containing information parsed from the DAKOTA input file. More...

Inheritance diagram for ProblemDescDB:

List of all members.

Public Member Functions
	ProblemDescDB ()
	default constructor
	ProblemDescDB (ParallelLibrary &parallel_lib, CommandLineHandler &cmd_line_handler)
	standard constructor
	ProblemDescDB (ParallelLibrary &parallel_lib)
	library mode constructor
	ProblemDescDB (const ProblemDescDB &db)
	copy constructor
	~ProblemDescDB ()
	destructor
ProblemDescDB	operator= (const ProblemDescDB &db)
	assignment operator
void	manage_inputs (CommandLineHandler &cmd_line_handler)
	normal API employed in main.C.
void	manage_inputs (const char *dakota_input_file, void(*)(void *)=NULL, void *=NULL)
	library_mode.C.
void	parse_inputs (const char *dakota_input_file, void(*)(void *)=NULL, void *=NULL)
	have been provided.
void	check_input ()
	keywords in the dakota input file. Used by parse_inputs().
void	broadcast ()
	data across the processor allocation. Used by manage_inputs().
void	post_process ()
	variables/responses specification arrays. Used by manage_inputs().
void	lock ()
	may not be set properly. Unlocked by a set nodes operation.
void	unlock ()
	Explicitly unlocks the database. Use with care.
void	set_db_list_nodes (const String &method_tag)
	this method specification to set all other list iterators.
void	set_db_list_nodes (const size_t &method_index)
	specification to set all other list iterators.
void	resolve_top_method ()
	to the top method and then sets the list nodes accordingly.
void	set_db_method_node (const String &method_tag)
	particular method specification (only).
void	set_db_method_node (const size_t &method_index)
	particular method specification (only).
size_t	get_db_method_node ()
	return the index of the active node in dataMethodList
void	set_db_model_nodes (const String &model_tag)
	identifier string
void	set_db_model_nodes (const size_t &model_index)
	within dataModelList
size_t	get_db_model_node ()
	return the index of the active node in dataModelList
void	set_db_variables_node (const String &variables_tag)
	set dataVariablesIter based on the variables identifier string
void	set_db_interface_node (const String &interface_tag)
	set dataInterfaceIter based on the interface identifier string
void	set_db_responses_node (const String &responses_tag)
	set dataResponsesIter based on the responses identifier string
ParallelLibrary &	parallel_library () const
	return the parallelLib reference
IteratorList &	iterator_list ()
	return a list of all Iterator objects that have been instantiated
ModelList &	model_list ()
	return a list of all Model objects that have been instantiated
VariablesList &	variables_list ()
	return a list of all Variables objects that have been instantiated
InterfaceList &	interface_list ()
	return a list of all Interface objects that have been instantiated
ResponseList &	response_list ()
	return a list of all Response objects that have been instantiated
const RealDenseVector &	get_rdv (const String &entry_name) const
	get a RealDenseVector out of the database based on an identifier string
const RealVector &	get_drv (const String &entry_name) const
	get a RealVector out of the database based on an identifier string
const IntVector &	get_div (const String &entry_name) const
	get an IntVector out of the database based on an identifier string
const IntArray &	get_dia (const String &entry_name) const
	get an IntArray out of the database based on an identifier string
const UShortArray &	get_dusa (const String &entry_name) const
	get an UShortArray out of the database based on an identifier string
const RealSymDenseMatrix &	get_rsdm (const String &entry_name) const
	get a RealSymDenseMatrix out of the database based on an identifier string
const RealDenseVectorArray &	get_rdva (const String &entry_name) const
	identifier string
const RealVectorArray &	get_drva (const String &entry_name) const
	get a RealVectorArray out of the database based on an identifier string
const IntList &	get_dil (const String &entry_name) const
	get an IntList out of the database based on an identifier string
const IntSet &	get_dis (const String &entry_name) const
	get an IntSet out of the database based on an identifier string
const StringArray &	get_dsa (const String &entry_name) const
	get a StringArray out of the database based on an identifier string
const String2DArray &	get_ds2a (const String &entry_name) const
	get a String2DArray out of the database based on an identifier string
const String &	get_string (const String &entry_name) const
	get a String out of the database based on an identifier string
const Real &	get_real (const String &entry_name) const
	get a Real out of the database based on an identifier string
const int &	get_int (const String &entry_name) const
	get an int out of the database based on an identifier string
const short &	get_short (const String &entry_name) const
	get a short out of the database based on an identifier string
const size_t &	get_sizet (const String &entry_name) const
	get a size_t out of the database based on an identifier string
const bool &	get_bool (const String &entry_name) const
	get a bool out of the database based on an identifier string
void	insert_node (const DataStrategy &data_strategy)
	set the DataStrategy object
void	insert_node (const DataMethod &data_method)
	add a DataMethod object to the dataMethodList
void	insert_node (const DataModel &data_model)
	add a DataModel object to the dataModelList
void	insert_node (DataVariables &data_variables)
	add a DataVariables object to the dataVariablesList
void	insert_node (const DataInterface &data_interface)
	add a DataInterface object to the dataInterfaceList
void	insert_node (const DataResponses &data_responses)
	add a DataResponses object to the dataResponsesList
void	set (const String &entry_name, const RealDenseVector &rdv)
	set a RealDenseVector within the database based on an identifier string
void	set (const String &entry_name, const RealVector &drv)
	set a RealVector within the database based on an identifier string
void	set (const String &entry_name, const IntVector &div)
	set an IntVector within the database based on an identifier string
void	set (const String &entry_name, const RealSymDenseMatrix &rsdm)
	set a RealMatrix within the database based on an identifier string
void	set (const String &entry_name, const RealDenseVectorArray &rdva)
	identifier string
void	set (const String &entry_name, const RealVectorArray &drva)
	set a RealVectorArray within the database based on an identifier string
void	set (const String &entry_name, const StringArray &dsa)
	set a StringArray within the database based on an identifier string
bool	is_null () const
	function to check dbRep (does this envelope contain a letter)
Protected Member Functions
	ProblemDescDB (BaseConstructor, ParallelLibrary &parallel_lib)
	derived class constructors - Coplien, p. 139)
virtual void	derived_manage_inputs (const char *dakota_input_file)
	This version reads from the dakota input filename passed in.
Protected Attributes
DataStrategy	strategySpec
	to strategy_kwhandler() or insert_node()
List< DataMethod >	dataMethodList
	or insert_node()
List< DataModel >	dataModelList
	or insert_node()
List< DataVariables >	dataVariablesList
	variables_kwhandler() or insert_node()
List< DataInterface >	dataInterfaceList
	interface_kwhandler() or insert_node()
List< DataResponses >	dataResponsesList
	responses_kwhandler() or insert_node()
size_t	strategyCntr
	counter for strategy specifications used in check_input
Private Member Functions
const Iterator &	get_iterator (Model &model)
	retrieve an existing Iterator, if it exists, or instantiate a new one
const Model &	get_model ()
	retrieve an existing Model, if it exists, or instantiate a new one
const Variables &	get_variables ()
	retrieve an existing Variables, if it exists, or instantiate a new one
const Interface &	get_interface ()
	retrieve an existing Interface, if it exists, or instantiate a new one
const Response &	get_response (const Variables &vars)
	retrieve an existing Response, if it exists, or instantiate a new one
ProblemDescDB *	get_db (ParallelLibrary &parallel_lib, CommandLineHandler &cmd_line_handler)
	correct letter class
ProblemDescDB *	get_db (ParallelLibrary &parallel_lib)
	correct letter class
void	send_db_buffer ()
	and dataResponsesList. Used by manage_inputs().
void	receive_db_buffer ()
	and dataResponsesList. Used by manage_inputs().
Private Attributes
ParallelLibrary &	parallelLib
	reference to the parallel_lib object passed from main
List< DataMethod >::iterator	dataMethodIter
	iterator identifying the active list node in dataMethodList
List< DataModel >::iterator	dataModelIter
	iterator identifying the active list node in dataModelList
List< DataVariables >::iterator	dataVariablesIter
	iterator identifying the active list node in dataVariablesList
List< DataInterface >::iterator	dataInterfaceIter
	iterator identifying the active list node in dataInterfaceList
List< DataResponses >::iterator	dataResponsesIter
	iterator identifying the active list node in dataResponsesList
IteratorList	iteratorList
	list of iterator objects, one for each method specification
ModelList	modelList
	list of model objects, one for each model specification
VariablesList	variablesList
	list of variables objects, one for each variables specification
InterfaceList	interfaceList
	list of interface objects, one for each interface specification
ResponseList	responseList
	list of response objects, one for each responses specification
bool	methodDBLocked
	prior to setting the list node for the active method specification
bool	modelDBLocked
	prior to setting the list node for the active model specification
bool	variablesDBLocked
	prior to setting the list node for the active variables specification
bool	interfaceDBLocked
	prior to setting the list node for the active interface specification
bool	responsesDBLocked
	prior to setting the list node for the active responses specification
ProblemDescDB *	dbRep
	pointer to the letter (initialized only for the envelope)
int	referenceCount
	number of objects sharing dbRep
Friends
class	Model
	Model requires access to get_variables() and get_response().
class	SingleModel
	SingleModel requires access to get_interface().
class	HierarchSurrModel
	HierarchSurrModel requires access to get_model().
class	DataFitSurrModel
	DataFitSurrModel requires access to get_iterator() and get_model().
class	NestedModel
	get_iterator(), and get_model()
class	Strategy
	Strategy requires access to get_iterator().
class	SingleMethodStrategy
	SingleMethodStrategy requires access to get_model().
class	HybridStrategy
	HybridStrategy requires access to get_model().
class	ConcurrentStrategy
	ConcurrentStrategy requires access to get_model().
class	SurrBasedLocalMinimizer
	SurrBasedLocalMinimizer requires access to get_iterator().
class	SurrBasedGlobalMinimizer
	SurrBasedGlobalMinimizer requires access to get_iterator().

---

Detailed Description

The database containing information parsed from the DAKOTA input file.

The ProblemDescDB class is a database for DAKOTA input file data that is populated by a parser defined in a derived class. When the parser reads a complete keyword, it populates a data class object (DataStrategy, DataMethod, DataVariables, DataInterface, or DataResponses) and, for all cases except strategy, appends the object to a linked list (dataMethodList, dataVariablesList, dataInterfaceList, or dataResponsesList). No strategy linked list is used since only one strategy specification is allowed.

---

Constructor & Destructor Documentation

ProblemDescDB

(

)

default constructor

The default constructor: dbRep is NULL in this case. This makes it necessary to check for NULL in the copy constructor, assignment operator, and destructor.

ProblemDescDB	(	ParallelLibrary &	parallel_lib,
		CommandLineHandler &	cmd_line_handler
	)

standard constructor

This is the primary envelope constructor which uses problem_db to build a fully populated db object. It only needs to extract enough data to properly execute get_db(problem_db), since the constructor overloaded with BaseConstructor builds the actual base class data inherited by the derived classes.

ProblemDescDB

(

ParallelLibrary &

parallel_lib

)

library mode constructor

This is the library mode envelope constructor which does not have access to command line options.

ProblemDescDB

(

const ProblemDescDB &

db

)

copy constructor

Copy constructor manages sharing of dbRep and incrementing of referenceCount.

~ProblemDescDB

(

)

destructor

Destructor decrements referenceCount and only deletes dbRep when referenceCount reaches zero.

ProblemDescDB	(	BaseConstructor	,
		ParallelLibrary &	parallel_lib
	)			[protected]

derived class constructors - Coplien, p. 139)

This constructor is the one which must build the base class data for all derived classes. get_db() instantiates a derived class letter and the derived constructor selects this base class constructor in its initialization list (to avoid the recursion of the base class constructor calling get_db() again). Since the letter IS the representation, its representation pointer is set to NULL (an uninitialized pointer causes problems in ~ProblemDescDB).

---

Member Function Documentation

ProblemDescDB operator=

(

const ProblemDescDB &

db

)

assignment operator

Assignment operator decrements referenceCount for old dbRep, assigns new dbRep, and increments referenceCount for new dbRep.

void manage_inputs

(

CommandLineHandler &

cmd_line_handler

)

normal API employed in main.C.

Manage command line inputs using the CommandLineHandler class and parse the input file.

void manage_inputs	(	const char *	dakota_input_file,
		void(*)(void *)	callback = NULL,
		void *	callback_data = NULL
	)

library_mode.C.

Parse the input file, broadcast it to all processors, and post-process the data on all processors.

void parse_inputs	(	const char *	dakota_input_file,
		void(*)(void *)	callback = NULL,
		void *	callback_data = NULL
	)

have been provided.

Parse the input file, execute the callback function (if present), and perform basic checks on keyword counts.

ProblemDescDB * get_db	(	ParallelLibrary &	parallel_lib,
		CommandLineHandler &	cmd_line_handler
	)			[private]

correct letter class

Initializes dbRep to the appropriate derived type. The standard derived class constructors are invoked.

ProblemDescDB * get_db

(

ParallelLibrary &

parallel_lib

)

[private]

correct letter class

Initializes dbRep to an NIDR instance for library mode. The standard derived class constructors are invoked.

---

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

• ProblemDescDB.H
• ProblemDescDB.C

---