The UserData object contains user-defined XY data. The UserData object has no constructor; it is created automatically when an Odb object is created.
odb.userData()
This method creates an XYData object from a sequence of X–Y data pairs.
odb.userData().XYData
odb_UserData&
XYData(const odb_String& name,
const odb_SequenceSequenceDouble& data,
const odb_String& sourceDescription,
const odb_String& contentDescription,
const odb_String& positionDescription,
const odb_String& legendLabel,
const odb_String& xValuesLabel,
const odb_String& yValuesLabel,
const odb_QuantityType& axis1QuantityType,
const odb_QuantityType& axis2QuantityType);Required arguments
An odb_String specifying the repository key.
An odb_SequenceSequenceDouble specifying the X–Y data pairs.
Optional arguments
An odb_String specifying the source of the X–Y data (e.g., “Entered from keyboard”, “Taken from ASCII file”, “Read from an ODB”, etc.). The default value is an empty string.
An odb_String specifying the content of the X–Y data (e.g., “field 1 vs. field 2”). The default value is an empty string.
An odb_String specifying additional information about the X–Y data (e.g., “for whole model”). The default value is an empty string.
An odb_String specifying the label to be used in the legend. The default value is the name of the XYData object.
An odb_String specifying the label for the X-values. This value may be overridden if the X–Y data are combined with other X–Y data. The default value is an empty string.
An odb_String specifying the label for the Y-values. This value may be overridden if the X–Y data are combined with other X–Y data. The default value is an empty string.
A QuantityType object specifying the QuantityType object associated to the X -axis1- values.
A QuantityType object specifying the QuantityType object associated to the Y -axis2- values.
Return value
An XYData object.
Exceptions
InvalidNameError.
The UserData object can have the following members:
odb_UserXYDataRepository& xyDataObjects();
odb_UserXYData& xyDataObjects(const odb_String& xyName);
An odb_String specifying the repository key.
An odb_String specifying the source of the X–Y data (e.g., “Entered from keyboard”, “Taken from ASCII file”, “Read from an ODB”, etc.). The default value is an empty string.
An odb_String specifying the content of the X–Y data (e.g., “field 1 vs. field 2”). The default value is an empty string.
An odb_String specifying additional information about the X–Y data (e.g., “for whole model”). The default value is an empty string.
An odb_String specifying the label for the X-values. This value may be overridden if the X–Y data are combined with other X–Y data. The default value is an empty string.
An odb_String specifying the label for the Y-values. This value may be overridden if the X–Y data are combined with other X–Y data. The default value is an empty string.
A QuantityType object specifying the QuantityType object associated to the X -axis1- values.
A QuantityType object specifying the QuantityType object associated to the Y -axis2- values.
An odb_String specifying the label to be used in the legend. The default value is the name of the XYData object.
A repository of UserXYData objects.
An odb_SequenceSequenceDouble specifying the X–Y data pairs.