This class provides the ability to set result values ready for displaying at the appropriate solution step.
The object stores 3 types of result values:
Elemental results are for when only a single value is to be displayed for each element.
ElementNodal results are for when an element has different results at each node, but the result belongs to the element, hence there can be multiple results at a given node.
Nodal results have a value at each node.
A DAResultSet is equivalent to a DAResult substep. The SubstepValue parameter enables multiple results to be calculated and displayed for a DAResult.
Only results that are appropriate for the display type set in the XML definition file should be added to the object; otherwise an exception will be generated.
Depending upon the display style set in the XML definition file the result can have a 1, 3 or 6 components, i.e. scalar, vector or tensor. The component input required is 1 based, i.e. use 1 in the case of scalar.
Setting any value to the capacity of a double (1.79769e+308) will result in the element being displayed in a translucent manner. This is the default if a value is not defined for a particular element.
Table 107: Members
| Name | Type | Description |
|---|---|---|
| SetElementalValue(int ElementId, int Component, double Value) | void | Sets an element result for a given component to the specified Value |
| GetElementalValue(int ElementID, int Component) | double | Returns the result value |
| SetElementalValues(int ElementId, double[] Values) | void | Sets an element result for all components to the specified Value array |
| GetElementalValues(int ElementId) | double [] | Returns the result values for all components as an array |
| SetElementNodalValue(int ElementId, int NodeId, int Component, double Value) | void |
Sets a node result at the NodeId of an element defined by the provided ElementId, for the specified Component. If the NodeId doesn’t exist on the given ElementId an exception will be generated. |
| GetElementNodalValue(int ElementId, int NodeId, int Component) | double |
Returns the result for a given NodeId, ElementId, and Component. If the NodeId doesn’t exist on the given ElementId an exception will be generated. |
| SetElementNodalValues(int ElementId, int NodeId, double[] Values) | void |
Sets a node result at the NodeId of an element defined by the provided ElementId for all components. If the NodeId doesn’t exist on the given ElementId an exception will be generated. |
| GetElementNodalValues(int ElementId, int NodeId) | double[] |
Returns the result for a given NodeId and ElementId for all components as an array. If the NodeId doesn’t exist on the given ElementId an exception will be generated. |
| SetNodalValue(int NodeId, int Component, double Value) | void | Sets a node result value for the given NodeId and Component |
| GetNodalValue(int NodeId, int Component) | double | Returns the value for the given NodeId and Component |
| SetNodalValues(int NodeId, double[] Values) | void | Sets a node result values for the given NodeId for all Components |
| GetNodalValues(int NodeId) | double[] | Returns the value for the given NodeId as an array for all Components |
| SubstepValue | double | Sets the Substep value of this DAResultSet (i.e. Time, Frequency, Substep Number) |