Series Object Properties
Setting the data for the series:
(a) 2 by N numeric matrix:
In this case the first row is assumed to contain the X values, and the second row the Y values.
(b) N by 2 numeric matrix:
In this case the first column is assumed to contain the X values, and the second row the Y values. (Note: for a 2 by 2 matrix, case (a) applies).
(c) Numeric scalar, vector, 1 by N matrix, or N by 1 matrix:,
In this case the data provided is assumed to represent the Y values of the series, and the X values are implicitly set to 0, 1, 2....N-1
If you read back this property, the data is always returned in format (a), i.e. as a 2 by N matrix of X values, Y Values
properties can be written as numeric scalars, vectors or one-row
matrices. They provide an alternative way of specifying the X and Y
values respectively for points on the series. The
If you read back one of these properties, the data is always returned as a numeric vector.
set the data used for High-Low-Open-Close and Candlestick charts.
They are numeric vectors, each representing one of the four Y data
points associated with each X value in the
Using the Alternate scale for the series:
This is a Boolean scalar. It defaults to 0, meaning that the series should be drawn using the main Y scale (i.e. the left axis). If you set it to 1, the series will instead be drawn using the alternate Y scale (i.e. the right axis).
you want only one Y axis, but you want it to appear on the right
instead of the left, set this property to 1 for all the series in the
chart, so they all use the alternate axis. Alternatively, if you
want only one axis, but you want it to be drawn on both the left and the
right, leave this property as 0 for all the series in the chart (so
they all use the main axis), and use the
Enabling/Disabling and Showing/Hiding the series:
This is a Boolean scalar. It defaults to 1, meaning that the series is enabled and should be included in the chart.
If you set this property to 0, the series is not included in the chart at all. This means that it is not displayed, and also that it takes no part in determining the scale used by the chart.
is also a Boolean scalar which defaults to 1, meaning that the series
is visible (provided the
you set this property to 0, the series is not displayed when the
chart is drawn. However, unless the
This is useful for two purposes. Firstly, you can temporarily hide a series without the scale of the chart altering. Secondly, you can force the chart to extend the scale by including a dummy series which is enabled but not visible.
can also use the
Labelling the series:
property is a text vector, which associates a label with the series.
By default it is an empty vector, which means the series has no
label. If you give it a label using this property, then it will
appear in the legend for the chart, with a sample line, marker or
filled rectangle to show which series is which on the chart. (The
legend will not be shown if the Chart object's
a Pie chart, the
Setting the appearance of the series:
a series is drawn as a Scatter chart, each point is denoted by a
marker symbol. By default, the symbol to use is selected when the
series is created. By changing the
marker is specified by assigning a character scalar, which is one of
the following APL symbols:
(The actual marker is drawn is not a character, but a shape similar to that of the corresponding APL symbol. The APL font is not used to render the marker shape.)
a marker is drawn, by default it is drawn in outline only. If you
By default, the Chart object will choose a unique color for each Series object when it is created, but this property allows you to select a particular color. It is specified as a single color value (vector of three separate RGB values, or a single integer encoding the three values). It is used for drawing lines, and filling bars or areas, associated with the data of the series.
any marker associated with a series is drawn in the color set for the
series as a whole (i.e. the
bars and pie slices associated with a series are filled with a solid
block of color. If you wish, you can specify a different fill
pattern for the series, by assigning one of the following values to
1=Solid, 2=Horizontal grid pattern, 3=Vertical grid pattern, 4=Forward diagonal, 5=Backward diagonal, 6=Cross pattern, 7=Diagonal cross pattern
lines associated with a series are drawn as a continuous (solid)
line. If you wish, you can specify a different line type for the
series, by assigning one of the following values to the
1=Solid, 3=Dash, 4=Dot, 5=DashDot, 6=DashDotDot
property is an integer scalar, which determines the width (in pixels)
of lines drawn for the series. By default, it is
Setting the series type for Mixed charts:
Normally, each series on the chart is shown in the same way, as determined by the type property of the parent Chart object. For example, all the series are displayed as bars if the chart type is set to 'bar'.
however, you may wish to display different series in different ways
on the same chart. To do this, you need to set the
Be careful when mixing series displayed as bar charts with the other
types. Bars are by default drawn centered at X coordinates 1, 2, 3..., if no
Copyright © 1996-2010 MicroAPL Ltd