Block Permanent Variable (BPV) and Instrument Permanent Variable (IPV) variables support numeric and string based series arrays.

 

Series can declared to Auto-Index or Manually index, and the location to access and assign information is determined by the user selected option.

 

Index Method

Series Type

Description:

Auto-Index

(Default)

BPV

Auto-Index option controls the size of the series, and increments each element to align with the test position.  Series element position index value, and the number of elements in the series is the value of the test.currentDay property.

 

BPV Series values can be plotted and displayed in a Custom Chart when the BPV series is set to a Scope of System, Test, or simulation.  When the scope is not set to Block, the Plotting section of the dialog will appear where the graphing options can be accessed.

IPV

Auto-Index option controls the size of the series, and increments each element to align with the instrument's test position.  Series element position index value, and the number of elements in the series is the value returned by instrument.bar property of each instrument.

 

Auto-Index series Plot and Display options allow the data from the series to be displayed on the price chart where the instrument's price information is displayed.

Manual-Index

BPV &

IPV

Manual indexing series size can be determined when the series is created, and they can be changed in the script with the SetSeriesSize series function.  

 

Minimum series size and index value is 1.  Maximum series size and index value is 100,000.  Index value is the value for the position of any element in the series including the first and largest size number of elements.  Setting the index value to an element location will all that element's value to be accessed..

 

Current size of a series can be retrieved using the GetSeriesSize series function.

 

Script index values must always be in the range starting at 1 and can be up to size of 100,000 elements.

 

Manual series can assign the same value to all the elements in the series at the same time using SetSeriesValues series function.

 

Manual series can be sorted in an ascending or descending direction using the SortSeries series function.   When sorting String values in a series require the understanding of how character values are ordered when sorted.

BPV

Numeric BPV series can also be declared in the script window:

  Variables: < series-name > TYPE: Series

 

When using script to declaring a series it must be sized using the SetSeriesSize series function before it can be index for value assignment.

IPV

Manual indexed IPV series must be created using the IPV variable creation dialog.

Available Series Functions

GetSeriesSize
SetSeriesSize
SetSeriesValues
SortSeries
SortSeriesDual

 

 


 

Created with Help & Manual 7 and styled with Premium Pack Version 2.80 © by EC Software