Series Data Information
Contents
Data Series, also known as an Array, can create series variables using the Block Permanent Variable (BPV) dialog, or the Instrument Permanent Variable(IPV) dialog.
Both (BPV)&(IPV) Data Series types are available to support two different data types:
•Numeric series will work with Floating Point & Integer values in all of its elements.
•String Series are design to contain any String or Text value in all of its elements.
Both (BPV)&(IPV) Data Series can be Auto-Index or Manually-Index:
•Data Series intended to provide an indicator instruments, must be Auto-Index so the alignment of the instrument record testing is aligned to an element in the instruments data series.
•Data Series intended to track how a system many positions are active at one time must be Auto-Index so the number of positions that are active can be recorded and aligned to each test record.
Both (BPV)&(IPV) Data Series can use a Manual-Index:
Manual-Index needs the user of a Manual-Index decides how many element are included in the Manual-Index series.
The process that manages the Manual-Index control must be created by the user so the information. There are two examples of how to a manual-index can be managed in this next Trading Blox Builder Forum Link:
BPV Data Information: |
|---|
All (BPV)variable data is not dependent on any instrument.
When you need to create a variable that needs to not be dependent on any instrument, a (BPV)must be where you create your variables.
Knowing the characteristic of the data type you select, makes a significant difference in how it is used and what is available from that data type. For example, if the data stored needs to be accessible with the same information in all of the test-operating script sections, a(BPV)is the data-type to use. |
IPV Data Information: |
|---|
All (IPV)variables are dependent on a specific instrument symbol that is in the system's list of instruments.
When you need to create a variable that needs to be dependent on a specific symbol instrument, an (IPV)must be where you create that variable. |
All data elements in a Numeric series are a Floating Point variables. All data elements in a String Series are String or Text values.
Both series are also know as an array of elements that are accessed by their element position index value. Trading Blox Builder supports these two type of series: Auto-Index & Manual-Index.
Auto-Index: is a process that sizes the number of elements in the series to be the same as number of records in the instrument file. To access an element in the series, the record number of the data's record is all that is needed to access that element in the series.
an indexed list of numeric value locations that can hold the same value, or a different a value in each of the series elements. Auto-Index Series match the instrument's date information and use the same index offset that the instrument's data use. i.e., an instrument.close[0], represents the current close price. An instrument.close[1] represents the previous date's close price. That same offset number process is how the information can be accessed in an Auto-Index numeric series.
A numeric series can be Manually-Index. Manually-Indexed series require the user to determine the size of the series, this means how many variable places will be needed, and how to access the series requires the user to create the indexing and searching scripts to access information.
Numeric Series/Arrays, can only contain a list of numbers. These can be tied to the test day using the "Auto-Index" feature described below. They can also be a fixed manually sized series that can be expanded or reduce using scripting. Fixed series are access by an index that is managed by scripted statements.
All data elements in a Numeric series are a Floating Point variables. A series, also know as an array, are an indexed list of numeric value locations that can hold the same value, or a different a value in each of the series elements. Auto-Index Series match the instrument's date information and use the same index offset that the instrument's data use. i.e., an instrument.close[0], represents the current close price. An instrument.close[1] represents the previous date's close price. That same offset number process is how the information can be accessed in an Auto-Index numeric series.
A numeric series can be Manually-Index. Manually-Indexed series require the user to determine the size of the series, this means how many variable places will be needed, and how to access the series requires the user to create the indexing and searching scripts to access information.
Numeric Series/Arrays, can only contain a list of numbers. These can be tied to the test day using the "Auto-Index" feature described below. They can also be a fixed manually sized series that can be expanded or reduce using scripting. Fixed series are access by an index that is managed by scripted statements. |
|---|
 BPV Series Indexing Options A BPV Series with Auto Index checked, will track the test.currentDay index. When Auto-Index is NOT Enabled, the series will be a static series that is managed and a accessed with scripting. |
|
|---|---|
This option will not appear unless the BPV numeric-series type is selected and is using System-Scope setting.
The numeric variable type that has a System scope setting will display this Ploting Control area where the user can create a chart graphic to display the numeric series information:  Appears when a BPV is System-Scope, or Test-Scope.
•The color of a graphed plot is assigned using the Plotted Color Selector. •The graph name where the plotted information is to appear is determined by the name entered into the Graph Area field. •The type of plotted display is based upon the selection appearing in the Graph Style selector. •When more than one series is being plotted in a custom graph, and one of those series has enabled "Log Scale" option, then all series plotting in the same Graph Area will plot as log scale. •When you plot more than one BPV variable in a custom graph, be sure the ranges of the all the series is within a reasonable range for all the series being plotted in that same graph area so the display is readable and consistent. •When a blox is used to create a custom graph, and that blox is inserted in multiple systems, there will be multiple plotted graphs displaying information from each of the systems. This is also true when you use multiple plotting statements in in your test, then multiple Summary Custom Charts will be created for each one. |
SetSeriesSize
Data Series Indexing
Block Permanent Variables
Instrument Permanent Variables
SortSeries
SetSeriesValues
Numeric Series:
Series data types can be Auto-Indexed, or they can be manually indexed. If there needs to be a series element for a named series to match the count of an instrument's data records, then use the default setting of Auto-Index.
A series that doesn't need to align to the instrument's data records, but might contain less or more information, use the manual index option and control the indexing and the sizing of the series with your program's source code.
String Series:
All series, or arrays store numbers and text values in a series of individual variable elements. Each element stores the value it was assigned until it is cleared, or given a different value. Each element in a series is accessible by using its referenced location. Usually this referencing is to assign the location to an integer value that acts as a location reference, or an index to that elements location.
In simple terms a series is a list of elements that contain the values of Floating numbers in numeric arrays, or a series of String Alpha-Numeric characters in the elements in a String array.
Auto-Indexed series are accessed are reference by the specifying the offset value from the current bar to where that element will be located. For example, to access yesterday's series element, use a value of 1 as the offset amount.
Manually sized series are access an element by its count position within the series.
Smallest value of a series is 1, and 1 is always the position location of first element in the series. Use above information to determine if it is accessed by offset reference, or direct location reference.
Series data types can be Auto-Indexed, or they can be manually indexed. If there needs to be a series element for a named series to match the count of an instrument's data records, then use the default setting of Auto-Index.
A series that doesn't need to align to the instrument's data records, but might contain less or more information, use the manual index option and control the indexing and the sizing of the series with your program's source code.
Two Column Number Series:
Two-column series are single-column numeric series that are later modified with a simple scripting process to establish the second column. All two-column series must be manually indexed series. Manually indexed series require scripting to keep track of the series size and decide which index value is needed to access information.
Bar Indexing Description and Reference: