libMesh::QoISet Class Reference

Data structure for specifying which Quantities of Interest should be calculated in an adjoint or a parameter sensitivity calculation. More...

#include <qoi_set.h>

Classes
class	iterator

Public Member Functions
	QoISet ()
	Empty constructor: "calculate all QoIs in the System". More...
	QoISet (const System &sys)
	Default constructor: "calculate all QoIs in the System", "give every QoI weight 1.0". More...
	QoISet (const std::vector< bool > &indices)
	Constructor-from-vector-of-bool: "calculate the QoIs for which \p indices[q] is true". More...
	QoISet (const std::vector< unsigned int > &indices)
	Constructor-from-vector: "calculate the listed QoIs", "give every QoI weight 1.0". More...
void	clear ()
	Resets to "calculate all QoIs, give every QoI weight 1.0". More...
std::size_t	size (const System &sys) const
void	add_indices (const std::vector< unsigned int > &indices)
	Add this indices to the set to be calculated. More...
void	add_index (std::size_t)
	Add this index to the set to be calculated. More...
void	remove_indices (const std::vector< unsigned int > &indices)
	Remove these indices from the set to be calculated. More...
void	remove_index (std::size_t)
	Remove this index from the set to be calculated. More...
void	set_weight (std::size_t, Real)
	Set the weight for this index. More...
Real	weight (std::size_t) const
	Get the weight for this index (default 1.0) More...
bool	has_index (std::size_t) const
	Return whether or not this index is in the set to be calculated. More...
iterator	begin () const
	Return an iterator pointing to the first index in the set. More...

Private Attributes
std::vector< bool >	_indices
	Interpret _indices.empty() to mean "calculate all indices". More...
std::vector< Real >	_weights
	Interpret _weights.size() <= i to mean "weight i = 1.0". More...

Detailed Description

Data structure for specifying which Quantities of Interest should be calculated in an adjoint or a parameter sensitivity calculation.

Author

Roy Stogner

Date

2009 Used to specify quantities of interest in a simulation.

Definition at line 45 of file qoi_set.h.

Constructor & Destructor Documentation

QoISet() [1/4]

libMesh::QoISet::QoISet

(

)

Empty constructor: "calculate all QoIs in the System".

No further changes to this special QoISet should be made; it doesn't even know how many QoIs your system has, it just knows to instruct a function to use all of them.

Definition at line 97 of file qoi_set.h.

: _indices(), _weights() {}

QoISet() [2/4]

libMesh::QoISet::QoISet ( const System &  sys )

explicit

Default constructor: "calculate all QoIs in the System", "give every QoI weight 1.0".

QoISet() [3/4]

libMesh::QoISet::QoISet ( const std::vector< bool > &  indices )

explicit

Constructor-from-vector-of-bool: "calculate the QoIs for which \p indices[q] is true".

Definition at line 111 of file qoi_set.h.

                                          :
    _indices(indices), _weights() {}

QoISet() [4/4]

libMesh::QoISet::QoISet ( const std::vector< unsigned int > &  indices )

explicit

Constructor-from-vector: "calculate the listed QoIs", "give every QoI weight 1.0".

Definition at line 192 of file qoi_set.h.

References add_indices().

                                                      :
  _indices(), _weights()
{
  this->add_indices(indices);
}

Member Function Documentation

add_index()

void libMesh::QoISet::add_index

(

std::size_t

i

)

Add this index to the set to be calculated.

Definition at line 201 of file qoi_set.h.

References _indices.

{
  if (i >= _indices.size())
    _indices.resize(i+1, true);
  _indices[i] = true;
}

add_indices()

void libMesh::QoISet::add_indices

(

const std::vector< unsigned int > &

indices

)

Add this indices to the set to be calculated.

Referenced by QoISet().

begin()

iterator libMesh::QoISet::begin

(

)

const

Return an iterator pointing to the first index in the set.

Definition at line 170 of file qoi_set.h.

References _indices.

{ return iterator(0, _indices); }

clear()

void libMesh::QoISet::clear

(

)

Resets to "calculate all QoIs, give every QoI weight 1.0".

Definition at line 124 of file qoi_set.h.

References _indices, and _weights.

{ _indices.clear(); _weights.clear(); }

has_index()

bool libMesh::QoISet::has_index

(

std::size_t

i

)

const

Return whether or not this index is in the set to be calculated.

Definition at line 221 of file qoi_set.h.

References _indices.

Referenced by libMesh::SensitivityData::allocate_data(), and libMesh::SensitivityData::allocate_hessian_data().

{
  return (_indices.size() <= i || _indices[i]);
}

remove_index()

void libMesh::QoISet::remove_index

(

std::size_t

i

)

Remove this index from the set to be calculated.

Definition at line 211 of file qoi_set.h.

References _indices.

{
  if (i >= _indices.size())
    _indices.resize(i+1, true);
  _indices[i] = false;
}

remove_indices()

void libMesh::QoISet::remove_indices

(

const std::vector< unsigned int > &

indices

)

Remove these indices from the set to be calculated.

set_weight()

void libMesh::QoISet::set_weight	(	std::size_t	i,
		Real	w
	)

Set the weight for this index.

Definition at line 229 of file qoi_set.h.

References _weights.

{
  if (_weights.size() <= i)
    _weights.resize(i+1, 1.0);

  _weights[i] = w;
}

size()

std::size_t libMesh::QoISet::size

(

const System &

sys

)

const

Returns

The number of QoIs that would be computed for the System sys

weight()

Real libMesh::QoISet::weight

(

std::size_t

i

)

const

Get the weight for this index (default 1.0)

Definition at line 240 of file qoi_set.h.

References _weights.

{
  if (_weights.size() <= i)
    return 1.0;
  return _weights[i];
}

Member Data Documentation

_indices

std::vector<bool> libMesh::QoISet::_indices

private

Interpret _indices.empty() to mean "calculate all indices".

Definition at line 176 of file qoi_set.h.

Referenced by add_index(), begin(), clear(), has_index(), and remove_index().

_weights

std::vector<Real> libMesh::QoISet::_weights

private

Interpret _weights.size() <= i to mean "weight i = 1.0".

Definition at line 181 of file qoi_set.h.

Referenced by clear(), set_weight(), and weight().

---

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

• include/systems/qoi_set.h