A high-low-close stock graph is a graph that is specifically designed for showing the high, low, and closing prices of a stock. Each stock marker displays three separate values.
The constant for this graph type is STOCK_HILO_CLOSE
.
You use stock graphs to show more than one stock price for a stock.
The following figure shows the data structure of a STOCK_HILO_CLOSE
stock graph.
The data structure for high-low-close stock graphs is as follows:
A group is a three-column set or, if data columns are shown as series, then as a three-row set of data. Each group is represented by a single stock marker. If you show data for more than one group, then the high, low, and closing values should vary faster than the Time values. That is, the order of the columns (or rows) should be Monday High, Monday Low, Monday Close, Tuesday High, Tuesday Low, Tuesday Close, and so on. A group is labeled by an O1 tick label, such as Mon.
A series is represented by stock markers of the same color. Most stock graphs show only one series of data. A series is labeled by legend text, such as Stock A. The legend should appear, even if you have only one series of data.
Each group in this kind of stock graph has three measure values:
The first value is the high price. It determines the top of the stock marker.
The second value is the low price, which defines the bottom of the stock marker.
The third value is the closing price, which defines the right arm of the stock marker.
Data for this kind of stock graph has the following guidelines:
All graphs show numeric data only.
The high-low-close stock graph must have at least three columns of data (or rows, if series are columns), in this order:
High
Low
Close
If the data has fewer than three columns (or rows) of data, then the Graph bean displays a message about insufficient data, instead of displaying a graph.
If the 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 three, such as three columns for Monday, then three for Tuesday, and
so on. If the last group does not have three 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.
Most high-low-close stock graphs have only one series of data. The series should be the name of the stock whose prices you show in the graph. You can have more than one series. However, if you do show more than one series and the prices of the different stocks overlap, then some stock markers obscure other stock markers.
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 High | Mon Low | Mon Close | Tues High | Tues Low | Tues Close |
---|---|---|---|---|---|
77.63 | 73.88 | 76.13 | 85.13 | 71.75 | 75.13 |
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