cee::ug::DataResultGroup

class DataResultGroup : public RefCountedObject 

Result group binding a geometry and results (scalar, vector, displacement and/or transformation)

A state owns a set of geometries and a DataResultGroup is the binding between a geometry and it’s results. Each geometry in the state have one (and only one) corresponding result group.

../_images/uml_dataresultgroup.png

DataResultGroup has no public constructor and will always exist for each geometry in a state. Get the requested result group by calling DataState::results(const DataGeometry* geometry).

Get the data result group for a given geometry:

// Get geometry with global index 0
cee::ug::DataGeometry* geometry = state->DataGeometry(0);

// Get corresponding result group
cee::ug::DataResultGroup* resultGroup = state->results(geometry);

The DataResultGroup object contains all available results for a given geometry. Result types are:

Scalar results: DataResultScalar
Vector results: DataResultVector
Displacement results: DataResultDisplacement
Visibility results:DataResultVisibility
Transformation result: DataResultTransformation
Symmetric Tensor result: DataResultSymmetricTensor

Add a scalar result using addScalar(). Remove all using removeAllScalars(). Use scalarCount() to return number of scalar results for this result group. Access individual scalar results using scalar() with the requested index. To convert from a scalar id to a scalar index, use scalarIndex(). Vector results, Displacement results and Symmetric Tensor results use the same structure and naming convention as shown above for scalar. Transformation and visibility results differ slightly from the other since a result group only can have one of each of these results. Set the transformation result using setTransformation() and get the existing one using transformation(). Same syntax applies to visibility results.

Note! The class is reference counted and can be shared between multiple states. Remember that since this object to is reference counted it should never be created on the stack.

Example

Example of how to add a node based scalar result to a geometry consisting of only one triangle.

Create a scalar result object with a unique id and node based result mapping.

int scalarResultId = 1;
cee::PtrRef<cee::ug::DataResultScalar> scalarResult = new cee::ug::DataResultScalar(scalarResultId, cee::ug::PER_NODE);

The result array must have one value for each node coordinate in the triangle. Remember that the array must be resized before inserting the results.

cee::PtrRef<cee::ug::DataPartScalar> scalarPart = new cee::ug::DataPartScalar();
scalarPart->resize(3);
scalarPart->setValue(0, 1.0);
scalarPart->setValue(1, 2.0);
scalarPart->setValue(2, 3.0);

Number of parts in the DataResultScalar must match number of parts in the geometry. Scalar values must also fit the corresponding part in the geometry. Here the part is a single triangle with three nodes and a node mapped result, hence a results array with three values will fit.

scalarResult->addPart(scalarPart.get());

For each geometry in a state there is a result group binding the geometry and results.

Add the result scalar to the state’s result group for the corresponding geometry (DataGeometry) geo

state->results(geo.get())->addScalar(scalarResult.get());

Tutorials UnstructGrid: A simple model with results