主要内容

candle

K 线图

说明

candle(Data) 绘制证券开盘价、最高价、最低价和收盘价的 K 线图。如果收盘价大于开盘价,则烛体(开盘价和收盘价之间的区域)为空心的;否则,烛体为实心的。

示例

candle(Data,Color) 添加了一个可选参量 Color

示例

h = candle(ax___) 添加了一个可选参量 ax

示例

示例

全部折叠

加载文件 SimulatedStock.mat,该文件提供了 TMW 股票的财务数据时间表 (TMW)。这是 SimulatedStock .mat 中最近 21 天的 K 线图,图中采用蓝色 K 线。

load SimulatedStock.mat;
candle(TMW(end-20:end,:),'b');
title('Candlestick chart for TMW')

Figure contains an axes object. The axes object with title Candlestick chart for TMW contains 22 objects of type line, patch.

输入参数

全部折叠

开盘价、最高价、最低价和收盘价数据,指定为矩阵、表或时间表。对于矩阵输入,Data 是由存储在相应列中的开盘价、最高价、最低价和收盘价组成的 M × 4 矩阵。行数为 M 的时间表和表必须包含以下名称的变量:'Open''High''Low''Close'(不区分大小写)。

数据类型: double | table | timetable

三元素颜色向量,指定为 [R G B] 颜色向量或指定颜色名称的字符串。默认颜色因图窗窗口的背景色而异。

RGB 三元组和十六进制颜色代码可用于指定自定义颜色。

  • RGB 三元组是三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在 [0,1] 范围内;例如, [0.4 0.6 0.7]

  • 十六进制颜色代码是以散列符号 (#) 开头的字符向量或字符串标量,后跟三或六位十六进制数字,范围从 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

或者,您也可以按名称指定一些常用颜色。下表列出了命名颜色选项、等效的 RGB 三元组和十六进制颜色代码。

颜色名称简称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

下表列出了浅色主题和深色主题中绘图的默认调色板。

调色板调色板颜色

"gem" - 浅色主题默认调色板

在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。

Sample of the "gem" color palette

"glow" - 深色主题默认调色板

Sample of the "glow" color palette

您可以使用 orderedcolorsrgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

数据类型: double | string

(可选)有效坐标区对象,指定为一个坐标区对象。K 线图是在 ax 指定的坐标区中创建的,而不是在当前坐标区 (ax = gca) 中创建的。选项 ax 可以位于任何输入参量组合之前。

数据类型: object

输出参量

全部折叠

图窗的图形句柄,以句柄对象形式返回。

详细信息

全部折叠

版本历史记录

在 R2006a 之前推出

全部展开