Retrieve a value from the database based on the selection criteria. This function enables the user to vary the data being displayed by varying any of the inputs including the parameter type.
PLGetValue( DatabaseName, TimeIndex, ParameterType, ItemIndex, DOFNo )
DatabaseName (Character String) |
The full path and filename to the relevant database. The file extension is optional. |
TimeIndex (Integer) |
The relevant time index, from 1 to the number of solutions in the database. |
ParameterType (Integer) |
The type of parameter to retrieve data for. See Parameter Types for a complete list. |
ItemIndex (Integer) |
The index of the item to retrieve the data for. This is dependent on the parameter type. |
DOFNo (Integer) |
The DOFNo varies for parameter types and may refer to a local node depending on the data being requested. |
A numerical value containing the requested force value for the specified parameters or one of the following error codes:
-999999998 |
Invalid Database. |
-999999996 |
Invalid Parameter Type. |
-999999995 |
Invalid Time Index. |
-999999990 |
No Data Available. |
-999999988 |
Item Index is out of range. |
-999999985 |
Specified Degree of Freedom/Local Node is out of range. |
-999999980 |
General Read Error. |