Series Object

ICE Data Services -

Series Object EFS Objects


The Series Object is an EFS-specific object that contains a collection of data, or series, where each value in the series corresponds to a bar in an Advanced Chart relative to the specified symbol and interval.  Any of the Built-in Study Functions or Series Functions can be used to create a Series Object.


Syntax
xSeriesObj = SeriesFunction( [ parameters ] )

Where:  xSeriesObj is a user-defined variable and SeriesFunction is one of the Built-in Study or Series functions.  The parameters specified would correspond to the parameters for the specific series function if applicable.


Parameters

See the corresponding function reference article for the chosen Built-in Study or Series function.


Return Value(s)

Series Object.  

 

Methods

getInterval()

- Returns the base interval of the Series Object if initialized with a specified sym() or inv() , otherwise the method will return null.
var myInv = xSeriesObj.getInterval();

 

getSymbol()

- Returns the base symbol of the Series Object if initialized with a specified sym() or inv(), otherwise the method will return null.
var mySym = xSeriesObj.getSymbol();

 

getValue( nBarIndex ) - Returns the specified bar index value of the Series Object relative to it's base symbol/interval.  If no sym() or inv() parameter is used in the initialization of the Series Object, the base symbol/interval will be the same as that of the Advanced Chart in which the formula is processing.

var myNum = xSeriesObj.getValue(0);

 

Notes

Only available in versions 7.9 or later.

If the chosen series function has a bar index parameter specified, a single value will be returned instead of a Series Object.

To determine if a user-defined variable was successfully assigned to a Series Object, pass the variable name to the debugPrintln() function.  If the variable is in the form of a Series Object, [object Series] will be printed to the formula output window.

 

Code Examples

See the code examples in the Built-in Study and Series Functions' reference articles.

See the getSeries() function for a code example of how to access a specific Series Object from an array of Series Objects returned by efsInternal() or efsExternal().

 

See Also

EFS Objects
Built-in Study Functions
Series Functions
eSignal Bulletin Board Search Engine
Help Guides and Tutorials