CDArrayMBS.mulArray(value as CDArrayMBS)

The array will be multiplied by multiplying each array element with the corresponding element of the CDArrayMBS object.

Parameter	Default	Description
Values	(Mandatory)	A CDArrayMBS with numbers to be multiplied to the CDArrayMBS object.

See also:

• mulArray(value() as Double)

CDArrayMBS.mulArray(value() as Double)

dim src(-1) as Double = Array( 63.1, 10.15, 6.15, 2.88 )
dim data As New CDArrayMBS(array(2.0, 2.0, 2.0, 2.0))

data.mulArray( src )

dim lines(-1) as string

lines.Append str(data.count)+" values:"
lines.Append ""
lines.Append str(Data.getvalue(0))
lines.Append str(Data.getvalue(1))
lines.Append str(Data.getvalue(2))
lines.Append str(Data.getvalue(3))

MsgBox Join(lines,EndOfLine)

The array will be multiplied by multiplying each array element with the corresponding element of the CDArrayMBS object.

Parameter	Default	Description
b	(Mandatory)	An array of numbers to be multiplied to the CDArrayMBS object.

See also:

• mulArray(value as CDArrayMBS)

CDArrayMBS.mulValue(value as Double)

dim data As New CDArrayMBS(array(1.0, 2.0, 3.0, 4.0))

data.mulValue(5)

dim lines(-1) as string

lines.Append str(data.count)+" values:"
lines.Append ""
lines.Append str(Data.getvalue(0))
lines.Append str(Data.getvalue(1))
lines.Append str(Data.getvalue(2))
lines.Append str(Data.getvalue(3))

MsgBox Join(lines,EndOfLine)

Parameter	Default	Description
b	(Mandatory)	A number to be multiplied to every element of the CDArrayMBS object.

Some examples using this method:

• /ChartDirector/pareto

CDArrayMBS.percentile(p as Double) as double

Parameter	Default	Description
p	(Mandatory)	The percentile to get. It should be between 0 - 100.

CDArrayMBS.rate(offset as Integer = 1)

Parameter	Default	Description
offset	1	The difference in position between an element and the earlier element to divide it.

CDArrayMBS.replace(a as Double, b as Double)

Parameter	Default	Description
a	(Mandatory)	The value to be replaced.
b	(Mandatory)	The replacing value.

CDArrayMBS.result as memoryblock

CDArrayMBS.selectEQZ

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectEQZ(decisionArray() as Double, fillValue as Double = 0)

CDArrayMBS.selectEQZ(decisionArray() as Double, fillValue as Double = 0)

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectEQZ

CDArrayMBS.selectGEZ

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectGEZ(decisionArray() as Double, fillValue as Double = 0)

CDArrayMBS.selectGEZ(decisionArray() as Double, fillValue as Double = 0)

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectGEZ

CDArrayMBS.selectGTZ

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectGTZ(decisionArray() as Double, fillValue as Double = 0)

CDArrayMBS.selectGTZ(decisionArray() as Double, fillValue as Double = 0)

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectGTZ

CDArrayMBS.selectLEZ

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectLEZ(decisionArray() as Double, fillValue as Double = 0)

CDArrayMBS.selectLEZ(decisionArray() as Double, fillValue as Double = 0)

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectLEZ

CDArrayMBS.selectLTZ

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectLTZ(decisionArray() as Double, fillValue as Double = 0)

CDArrayMBS.selectLTZ(decisionArray() as Double, fillValue as Double = 0)

The selected elements will be left unchanged. The remaining elements will be replaced by the given fillValue.

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectLTZ

CDArrayMBS.selectNEZ

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectNEZ(decisionArray() as Double, fillValue as Double = 0)

CDArrayMBS.selectNEZ(decisionArray() as Double, fillValue as Double = 0)

If the decisionArray is empty, the CDArrayMBS object itself will function as the decision array.

Parameter	Default	Description
decisionArray	[Empty_Array]	An array of numbers used to decide whether the corresponding elements in the CDArrayMBS object is selected or not.
fillValue	0	The value used to replace the elements that are not selected.

See also:

• selectNEZ

CDArrayMBS.selectRegularSpacing(majorTickStep as Integer, minorTickStep as Integer = 0, initialMargin as Integer = 0)

The primary purpose of this method is to select the regularly spaced elements as ticks on an enumerated axis.

For example, if the majorTickStep is 10, and minorTickStep is 5, this method will select one out of 10 elements as major tick elements, and one of out of 5 elements as minor tick elements.

Major tick elements will remain intact. The remaining minor ticks elements will have their values replaced with MinorTickOnly. Non-selected elements will have their values replaced with kNoValue, so they will not appear on the axis. The resulting array can be used directly in Axis.setLabels.

Parameter	Default	Description
majorTickStep	(Mandatory)	The spacing between major ticks.
minorTickStep	0	The spacing between minor ticks. The default value of 0 means no minor tick will be used.
initialMargin	0	The position of the first tick.

CDArrayMBS.selectStartOfDay(majorTickStep as Integer = 1, initialMargin as Double = 10800.0)

This method assumes the elements of the CDArrayMBS object are dates/times.

The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see
Axis.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per day (or one tick per multiple days). This is by selecting the dates/times in the data array only if it is not the same day as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by kNoValue. The resulting array can be used directly in Axis.setLabels.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the day it represents. By default, near means within 3 hours (10800 seconds). This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.

However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using Layer.setXData and Axis.setDateScale.

Parameter	Default	Description
majorTickStep	1	The tick step. The default value of 1 means one tick per day. A value of n means one tick per n days.
initialMargin	10800	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the day it represents. The default is 3 hours (10800 seconds).

CDArrayMBS.selectStartOfHour(majorTickStep as Integer = 1, initialMargin as Double = 300.0)

This method assumes the elements of the CDArrayMBS object are dates/times.

The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see
Axis.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per hour (or one tick per multiple hours). This is by selecting the dates/times in the data array only if it is not the same hour as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by kNoValue. The resulting array can be used directly in Axis.setLabels2.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the hour it represents. By default, near means within 300 seconds. This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.

However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using Layer.setXData and Axis.setDateScale.

Parameter	Default	Description
majorTickStep	1	The tick step. The default value of 1 means one tick per hour. A value of n means one tick per n hours.
initialMargin	300	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the hour it represents. The default is 300 seconds.

CDArrayMBS.selectStartOfMinute(majorTickStep as Integer = 1, initialMargin as Double = 5.0)

This method assumes the elements of the ArrayMath object are dates/times.

The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see CDAxisMBS.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per minute (or one tick per multiple minutes). This is by selecting the dates/times in the data array only if it is not the same minute as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by kNoValue. The resulting array can be used directly in CDAxisMBS.setLabels2.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the minute it represents. By default, near means within 5 seconds. This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.

However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using CDLayerMBS.setXData and CDAxisMBS.setDateScale3 (or CDAxisMBS.setDateScale or CDAxisMBS.setDateScale2).

Argument	Default	Description
majorTickStep	1	The tick step. A value of n means one tick per n minutes.
initialMargin	5	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the minute it represents. The default is 5 seconds.

CDArrayMBS.selectStartOfMonth(majorTickStep as Integer = 1, initialMargin as Double = 432000.0)

This method assumes the elements of the CDArrayMBS object are dates/times.

The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see
Axis.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per month (or one tick per multiple months). This is by selecting the dates/times in the data array only if it is not the same month as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by kNoValue. The resulting array can be used directly in
Axis.setLabels.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the month it represents. By default, near means within 5 days (432000 seconds). This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.

However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using Layer.setXData and Axis.setDateScale.

Parameter	Default	Description
majorTickStep	1	The tick step. The default value of 1 means one tick per month. A value of n means one tick per n months.
initialMargin	432000	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the month it represents. The default is 5 days (432000 seconds).

CDArrayMBS.selectStartOfSecond(majorTickStep as Integer = 1, initialMargin as Double = 0.1)

This method assumes the elements of the ArrayMath object are dates/times.

The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see CDAxisMBS.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per second (or one tick per multiple seconds). This is by selecting the dates/times in the data array only if it is not the same second as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by NoValue. The resulting array can be used directly in CDAxisMBS.setLabels2.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the second it represents. By default, near means within 0.1 second. This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.

However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using CDLayerMBS.setXData and CDAxisMBS.setDateScale3 (or CDAxisMBS.setDateScale or CDAxisMBS.setDateScale2).

Argument	Default	Description
majorTickStep	1	The tick step. A value of n means one tick per n seconds.
initialMargin	0.1	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the second it represents. The default is 0.1 second.

CDArrayMBS.selectStartOfWeek(majorTickStep as Integer = 1, initialMargin as Double = 172800.0)

This method assumes the elements of the CDArrayMBS object are dates/times.

The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see
Axis.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per week (or one tick per multiple weeks). This is by selecting the dates/times in the data array only if it is not the same week as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by kNoValue. The resulting array can be used directly in Axis.setLabels.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the week it represents. By default, near means within 2 days (172800 seconds). This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.


However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using Layer.setXData and Axis.setDateScale.

Parameter	Default	Description
majorTickStep	1	The tick step. The default value of 1 means one tick per week. A value of n means one tick per n weeks.
initialMargin	172800	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the week it represents. The default is 2 days (172800 seconds).

CDArrayMBS.selectStartOfYear(majorTickStep as Integer = 1, initialMargin as Double = 5184000.0)

This method assumes the elements of the CDArrayMBS object are
dates/times. The primary purpose of this method is to select the appropriate elements as ticks on an enumerated axis.

Suppose you want to plot a variable against time. The x-values of the data points will be an array of dates/times. If an enumerated x-axis is used (see
Axis.setLabels), there will be a tick at every data point, which may be too dense if there are too many data points.

This method can be used to reduce the ticks to one tick per year (or one tick per multiple years). This is by selecting the dates/times in the data array only if it is not the same year as the previous element in the array. The selected elements will be left unchanged, while the elements not select will be replaced by kNoValue. The resulting array can be used directly in Axis.setLabels.

For the first data point, there is no previous data point to compare, so it is handled differently. The first data point will be selected if it is near the beginning of the year it represents. By default, near means within 60 days (5184000 seconds). This is configurable using the initialMargin argument.

Note that if the data points does not have data in a certain time range, no element can be selected in that time range, and so there will be no tick for that time range. This is appropriate for many chart types, such as finance charts, in which missing time ranges (non-trading hours, holidays, etc) are traditionally skipped.

However, if the data points may contain missing time ranges, but the ticks cannot be skipped, it may be more appropriate to use a non-enumerated x-axis by using Layer.setXData and Axis.setDateScale.

Parameter	Default	Description
majorTickStep	1	The tick step. The default value of 1 means one tick per year. A value of n means one tick per n years.
initialMargin	5184000	The margin for the first data point. The first data point will be selected if it is within initialMargin number of seconds from beginning of the year it represents. The default is 60 days (5184000 seconds).

CDArrayMBS.shift(offset as Integer = 1)

If the array does not have any kNoValue data points, this method will shift the point at position "n" to "n + offset". On the "right" side of the array (the side with the largest index), points that are shifted outside the array will be discarded. On the "left" side of the array, fillValue data points will be shifted in.

If the array contains kNoValue data points, these points are not shifted. Conceptually, one can imagine the non-NoValue points being shifted to the next non-NoValue positions, and the process repeats
offset number of times.

Parameter	Default	Description
offset	1	The number of positions to shift the array "rightwards."
fillValue	kNoValue	The new value to be shifted into the array.

See also:

• shift(offset as Integer, fillValue as Double)

CDArrayMBS.shift(offset as Integer, fillValue as Double)

If the array does not have any kNoValue data points, this method will shift the point at position "n" to "n + offset". On the "right" side of the array (the side with the largest index), points that are shifted outside the array will be discarded. On the "left" side of the array, fillValue data points will be shifted in.

If the array contains kNoValue data points, these points are not shifted. Conceptually, one can imagine the non-NoValue points being shifted to the next non-NoValue positions, and the process repeats
offset number of times.

Parameter	Default	Description
offset	1	The number of positions to shift the array "rightwards."
fillValue	kNoValue	The new value to be shifted into the array.

See also:

• shift(offset as Integer = 1)

CDArrayMBS.stdDev as Double

dim data As New CDArrayMBS(array(1.0, 2.0, 3.0, 4.0))
MsgBox str(data.stdDev) // shows 1.118034

CDArrayMBS.subArray(value as CDArrayMBS)

The array will be subtracted by subtracting each array element from the corresponding element of the CDArrayMBS object.

Parameter	Default	Description
Values	(Mandatory)	A CDArrayMBS with numbers to be subtracted from the CDArrayMBS object.

See also:

• subArray(value() as Double)