candle( plots a candlestick chart
from a series of opening, high, low, and closing prices of a security. If the
closing price is greater than the opening price, the body (the region between the
open and close price) is unfilled; otherwise the body is filled.
Generate a Candlestick Chart for a Data Series for a Stock
Load the file
SimulatedStock.mat, which provides a timetable (
TMW) for financial data for TMW stock. This is a candlestick chart with blue candles, for the most recent 21 days in SimulatedStock
load SimulatedStock.mat; candle(TMW(end-20:end,:),'b'); title('Candlestick chart for TMW')
Data — Data for opening, high, low, and closing prices
matrix | table | timetable
Data for opening, high, low, and closing prices, specified as a matrix,
table, or timetable. For matrix input,
Data is an
4 matrix of opening, high,
low, and closing prices stored in the corresponding columns. Timetables and
M rows must contain variables named
Color — (Optional) Three element color vector
background color of figure window (default) | color vector
[R G B] | string
Three element color vector, specified as a
[R G B]
color vector or a string specifying the color name. The default color
differs depending on the background color of the figure window.
RGB triplets and hexadecimal color codes are useful for specifying custom colors.
An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range
[0,1]; for example,
[0.4 0.6 0.7].
A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (
#) followed by three or six hexadecimal digits, which can range from
F. The values are not case sensitive. Thus, the color codes
Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.
|Color Name||Short Name||RGB Triplet||Hexadecimal Color Code||Appearance|
Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB® uses in many types of plots.
|RGB Triplet||Hexadecimal Color Code||Appearance|
ax — Valid axis object
current axes (
ax = gca) (default) | axes object
(Optional) Valid axis object, specified as an axes object. The candle plot
is created in the axes specified by
ax instead of in the
current axes (
ax = gca). The option
can precede any of the input argument combinations.
h — Graphic handle of the figure
Graphic handle of the figure, returned as a handle object.
Version HistoryIntroduced before R2006a
R2022b: Support for negative price data
Data input accepts negative prices.