Function
Adds an indexed member to a Series Object.
Syntax
#include <dx/dx.h>
Series DXSetSeriesMember(Series s, int n, double position, Object o)
Functional Details
Adds the Object o as the nth member (as specified by the zero-based index n) to the Series s. It also sets the Series position to the floating-point value position. A Series is intended to represent a single Field sampled across some parameter, such as time or temperature (position contains the value of this sampled parameter).
Generally, members of a Series s must be added sequentially, with indices starting at 0. If, however, an already existing index is given in n, then that member in s will be replaced by the Object o. The type of a Series is set the first time a typed member is added; subsequent members are required to match this type.
The index n provides a convenient mechanism for indexing the members of a Series. The position value is actually a piece of metadata to be associated with each member of the Series, which when used with the values associated with the other members, provides a means of generating intermember data (e.g., when using the Streakline module).
DXSetSeriesMember does not enforce any restrictions on the Series position value; duplicate or non-monotonic values can be set. However, many Realization modules require the position values to form a monotonic sequence, and if the value does represent time, some modules also require the values to be positive.
For an example of one use of Series, see Streakline in IBM Visualization Data Explorer User's Reference.
Return Value
Returns NULL and sets an error code.
See Also
DXGetMemberCount,
DXGetSeriesMember,
DXNewSeries,
DXSetEnumeratedMember,
DXSetMember
Streakline in IBM Visualization Data
Explorer User's Reference