candle - Candlestick chart

Syntax

candle(HighPrices, LowPrices, ClosePrices, OpenPrices)
candle(HighPrices, LowPrices, ClosePrices, OpenPrices, 
Color, Dates, Dateform)

Arguments

`HighPrices`	High prices for a security. A column vector.
`LowPrices`	Low prices for a security. A column vector.
`ClosePrices`	Closing prices for a security. A column vector.
`OpenPrices`	Opening prices for a security. A column vector.
`Color`	(Optional) Candlestick color. A string. MATLAB software supplies a default color if none is specified. The default color differs depending on the background color of the figure window. See `ColorSpec` in the MATLAB documentation for color names.
`Dates`	(Optional) Column vector of dates for user specified X-axis tick labels.
`Dateform`	(Optional) Date string format used as the x-axis tick labels. (See `datetick` in the MATLAB documentation.) You can specify a `dateform` only when `tsobj` does not contain time-of-day data. If `tsobj` contains time-of-day data, `dateform` is restricted to `'dd-mmm-yyyy HH:MM'`.

Description

candle(HighPrices, LowPrices, ClosePrices, OpenPrices) plots a candlestick chart given column vectors with the high, low, closing, and opening prices of a security.

If the closing price is greater than the opening price, the body (the region between the opening and closing price) is unfilled.

If the opening price is greater than the closing price, the body is filled.

candle(HighPrices, LowPrices, ClosePrices, OpenPrices, Color, Dates, Dateform) plots a candlestick chart given column vectors with the high, low, closing, and opening prices of a security. In addition, the optional arguments Color, Dates, and Dateform specify the color of the candle box and the date string format used as the x-axis tick labels.

Examples

Given HighPrices, LowPrices, ClosePrices, and OpenPrices as equal-size vectors of stock price data

candle(HighPrices, LowPrices, ClosePrices, OpenPrices, 'blue')

plots a candlestick chart with blue candles.

The following example shows a candlestick chart for the most recent 21 days in disney.mat:

load disney;
candle(dis_HIGH(end-20:end), dis_LOW(end-20:end), dis_CLOSE(end-20:end),...
dis_OPEN(end-20:end), 'b');

Search MATLAB Documentation
R2012a Documentation → Financial Toolbox
View documentation for other releases	Learn more about Financial Toolbox

candle - Candlestick chart

Syntax

Arguments

Description

Examples

See Also