An open-high-low-close candle stock graph with volume is the same as an open-high-low-close candle stock graph, except that it also displays the volume of shares traded in a separate area of the graph. Each stock marker displays four separate values; bars in the lower part of the graph show trading volume.
The constant for this graph type is STOCK_OHLC_CANDLE_VOLUME
.
You use stock graphs to show more than one stock price for a stock.
The following figure shows the data structure of a STOCK_OHLC_CANDLE_VOLUME
stock graph.
The data structure for open-high-low-close candle stock graphs with volume is as follows:
A group is a five-column set or, if data columns are shown as series, then as a five-row set of data. Each group is represented by a stock marker and a bar. If you show data for more than one group, then the values for open, high, low, close, and volume should vary faster than the Time values. That is, the order of the columns (or rows) should be Monday Open, Monday High, Monday Low, Monday Close, Monday Volume, Tuesday High, Tuesday Open, Tuesday Low, Tuesday Close, Tuesday Volume, and so on. A group is labeled by an O1 tick label, such as Thurs.
Candle stock graphs display only one series of data. If you have more than one series of data, then only the first series is displayed. For this reason, no legend appears in a candle stock graph. You should show the series label in the title of the graph.
Each group in this kind of stock graph has two measure values:
The first value is the opening price. The opening price defines the top or the bottom of the candle (rectangle).
The second value is the high price, which defines the top of the line that is attached to the top of the candle (the wick). This value is not visible if the high value is equal to the open or close value.
The third value is the low price, which defines the bottom of the line that is attached to the bottom of the candle (the wick). This value is not visible if the low value is equal to the open or close value.
The fourth value is the closing price. The closing price also defines the top or the bottom of the candle.
The fifth value is the volume, which defines the bar in the lower half of the graph.
The lesser of the open and close values defines the bottom of the candle. The greater value defines the top. If the closing value is greater than the opening value, then the candle is green. If the opening value is higher than the closing value, then the candle is red.
The data for this kind of stock graph has the following guidelines:
All graphs show numeric data only.
The open-high-low-close stock candle graph that shows volume must have at least five columns of data (or rows, if series are columns), in this order:
Open
High
Low
Close
Volume
If the data has fewer than five columns (or rows) of data, then the Graph bean displays a message about insufficient data, instead of displaying a graph.
If the opening or closing price lies outside the high and low range, then
the graph sends an AlertEvent
to any registered AlertListeners
.
The ID for the AlertEvent
is DATA_STOCK_OPEN_OR_CLOSE_OUT_OF_RANGE
.
To display stock data for more than one day, the data must be in multiples
of five, such as five groups for Monday, then five for Tuesday, and so on.
If the last group does not have five columns (or rows), then the graph does
not display that group. The graph notifies any registered AlertListeners
of this problem by sending an AlertEvent
, with DATA_PARTIAL_GROUP
as its ID.
Open-high-low-close candle stock graphs with volume can have only one series of data. If you have more than one series of data, then only the first series appears in the graph. This graph type does not display a legend, so you should display the name of the stock in a title.
Time axis data must be regular, complete, and in ascending order. If it is not, then the graph displays a regular ordinal axis rather than a time axis. The graph recognizes time data that skips days when stocks are not traded.
The following graph shows the stock data for one stock for two different days.
The following table shows the grid of data that the stock graph displays. This
example assumes that Graph.isDataRowShownAsASeries
returns true
.
Mon Open | Mon High | Mon Low | Mon Close | Mon Volume | Tues Open | Tues High | Tues Low | Tues Close | Tues Volume |
---|---|---|---|---|---|---|---|---|---|
22.25 | 27.64 | 21.88 | 26.13 | 22336 | 26.75 | 35.13 | 21.75 | 23.13 | 25374 |
Stock Graphs
Handling Problems
in Graph Data
Specifying Data for a Graph
Example: Setting Data from
a File on a High-Low-Close Stock Graph