函数文档——画图、预警与条件表达式

画图函数

plot

将系列数据绘制在K线图表上（线图）

plot(series, title, color, linewidth, lineDash, display, offset, showLast, trackPrice, excludeRange)

类型

绘图函数

参数说明

名称	类型	默认值	说明
series	序列数据	(必要参数)	要绘制的数据系列
title	字符串	(必要参数)	绘图标题
color	字符串	rgba(255,255,255,1)	绘图的颜色，支持rgba，十六进制，以及常用颜色 rgb取值0-255，不透明度a取值0-1 (1为完全不透明)
linewidth	数值	1	绘制线的宽度
lineDash	数值数组	[0]	虚线; [1,2] 1是虚线长度，2紧跟着的间隔
display	布尔值	true	是否展示
offset	数值	1	展示时的偏移值
showLast	数值	-1	只展示最后的N根K线的指标值
trackPrice	布尔值	false	绘制最新的价格线
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plot(dif, title='DIF', color='rgba(47,210,178,1)', lineWidth=1, lineDash=[0], display=true);
plot(dif, title='DIF');

plotColumn

将系列数据绘制在K线图表上（柱状图）

plotColumn(series, title, color, fill, display, offset, showLast, excludeRange)

类型

绘图函数

参数说明

名称	类型	默认值	说明
series	序列数据	(必要参数)	要绘制的数据系列
title	字符串	(必要参数)	绘图标题
color	字符串	rgba(255,255,255,1)	绘图的颜色，支持rgba，十六进制，以及常用颜色 rgb取值0-255，不透明度a取值0-1(1为完全不透明)
fill	布尔值	true	颜色是否填充整个柱子
display	布尔值	true	是否展示
offset	数值	1	展示时的偏移值
showLast	数值	-1	只展示最后的N根K线的指标值
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plotColumn(ma3, title='柱状图', color='blue', fill=true, display=true);
plotColumn(dif, title='DIF');

plotText

将文字绘制在K线图表上

plotText(cond, title,text,refSeries,bgColor,color,fontSize,placement,display, offset, showLast, excludeRange)

语法版本需要 // @version=2
PC端需要 2.7.4 及以上

类型

绘图函数

参数说明

名称	类型	默认值	说明
cond	序列数据	(必要参数)	是否进行文字绘制的bool系列
title	字符串	(必要参数)	绘图标题
text	字符串	(必要参数)	绘图文字
refSeries	序列数据	(必要参数)	绘制引用的序列数据
bgColor	字符串	rgba(255,255,255,1)	文字背景的颜色，支持rgba，十六进制，以及常用颜色rgb取值0-255，不透明度a取值0-1(1为完全不透明)
color	字符串	rgba(255,255,255,1)	文字背景的颜色，支持rgba，十六进制，以及常用颜色rgb取值0-255，不透明度a取值0-1(1为完全不透明)
fontSize	数值	14	文字大小
placement	字符串	'top'	文字位置，支持类型：top(绘制在k线上方), bottom(绘制在k线下方)
display	布尔值	true	是否展示
offset	数值	1	展示时的偏移值
showLast	数值	-1	只展示最后的N根K线的指标值
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plotText(close < open, title = 'plotText',text = 'UP',refSeries = close,bgColor='blue',color='red',fontSize=14,placement='bottom',display=true);

plotShape

将图形绘制在K线图表上

plotShape(cond, title,refSeries,shape,color,fill,placement,display, offset, showLast, excludeRange)

语法版本需要 // @version=2
PC端版本需要 2.7.4 及以上

类型

绘图函数

参数说明

名称	类型	默认值	说明
cond	序列数据	(必要参数)	是否进行图形绘制的bool系列
title	字符串	(必要参数)	绘图标题
refSeries	序列数据	(必要参数)	绘制引用的序列数据
shape	字符串	(必要参数)	绘制的图形，可选 circle,triangleUp,triangleDown,arrowUp,arrowDown
color	字符串	rgba(255,255,255,1)	图形背景的颜色，支持rgba，十六进制，以及常用颜色rgb取值0-255，不透明度a取值0-1(1为完全不透明)
fill	布尔值	true	是否填充
placement	字符串	'top'	图形位置，支持类型：top(绘制在k线上方), bottom(绘制在k线下方)
display	布尔值	true	是否展示
offset	数值	1	展示时的偏移值
showLast	数值	-1	只展示最后的N根K线的指标值
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plotShape(close < open, title = 'plotShape',refSeries = close,shape = 'circle',color='blue',fill = true,placement='bottom',display=true);

fill

使用提供的颜色填充两个绘图之间的背景

fill(series1, series2, color, display)

类型

绘图函数

参数说明

名称	类型	默认值	说明
series1	序列数据	(必要参数)	第一个数据序列
series2	序列数据	(必要参数)	第二个数据序列
color	字符串	rgba(255,255,255,1)	绘图的颜色，支持rgba，十六进制，以及常用颜色
display	布尔值	true	是否展示

返回值

返回绘图

例子

fill(ma3, ma7, 'red');

plotHist

绘制直方图，与plotColumn只是绘制样式差异

plotHist(cond, title, color, display, showLast, histBase, excludeRange)

语法版本需要 // @version=2
PC端版本需要 2.7.4 及以上

类型

绘图函数

参数说明

名称	类型	默认值	说明
cond	序列数据	(必要参数)	是否进行图形绘制的数据系列
title	字符串	(必要参数)	绘图标题
color	字符串	rgba(255,255,255,1)	绘图的颜色，支持rgba，十六进制，以及常用颜色rgb取值0-255，不透明度a取值0-1(1为完全不透明)
display	布尔值	true	是否展示
showLast	数值	-1	只展示最后的N根K线的指标值
histBase	数值	0	直方图的初始值
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plotHist(ma3, title = '直方图',color='blue',fill = true, display=true);
plotHist(close, title = 'close', histBase = 3000)

plotCandle

绘制蜡烛图

plotCandle(open, high,low,close,title,display, color, wickColor, borderColor, showLast, trackPrice, excludeRange)

语法版本需要 // @version=2
PC端版本需要 2.7.4 及以上

类型

绘图函数

参数说明

名称	类型	默认值	说明
open	序列数据	(必要参数)	开盘价数据序列
high	序列数据	(必要参数)	最高价格数据序列（注意：K线图会以开高低收这四个值的最大值作为最高值）
low	序列数据	(必要参数)	最低价格数据序列（注意：K线图会以开高低收这四个值的最小值作为最高值）
close	序列数据	(必要参数)	收盘价数据序列
title	字符串	(必要参数)	绘图标题
display	布尔值	true	是否展示
color	字符串	默认根据开收盘价自动填充颜色	K线蜡烛的填充色，支持rgba，十六进制，以及常用颜色rgb取值0-255，不透明度a取值0-1(1为完全不透明)
wickColor	字符串	默认采用K线蜡烛描边色	影线的颜色
borderColor	字符串	默认采用K线蜡烛填充色	K线蜡烛的描边色
showLast	数值	-1	只展示最后的N根K线的指标值
trackPrice	布尔值	false	绘制最新的价格线
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plotCandle(open, high,low,close, title='candle', color='blue')

plotOhlc

绘制美国线

plotOhlc(open, high,low,close,title,display, color, showLast, trackPrice, excludeRange)

语法版本需要 // @version=2
PC端版本需要 2.7.4 及以上

类型

绘图函数

参数说明

名称	类型	默认值	说明
open	序列数据	(必要参数)	开盘价数据序列
high	序列数据	(必要参数)	最高价格数据序列（注意：K线图会以开高低收这四个值的最大值作为最高值）
low	序列数据	(必要参数)	最低价格数据序列（注意：K线图会以开高低收这四个值的最小值作为最高值）
close	序列数据	(必要参数)	收盘价数据序列
title	字符串	(必要参数)	绘图标题
display	布尔值	true	是否展示
color	字符串	默认根据开收盘价自动填充颜色	K线蜡烛的填充色，支持rgba，十六进制，以及常用颜色rgb取值0-255，不透明度a取值0-1(1为完全不透明)
showLast	数值	-1	只展示最后的N根K线的指标值
trackPrice	布尔值	false	绘制最新的价格线
excludeRange	布尔值	false	控制当前函数的值是否参与Y轴范围计算

返回值

返回绘图

例子

plotOhlc(open, high,low,close, title='ohlc', color='blue')

预警函数

alertcondition

创建预警条件，在创建预警对话框中可用。请注意，alertcondition不会创建预警，它只会在创建预警对话框中为您提供预警条件选项。此外，alertcondition效果在图表上是看不见的。

alertcondition(source, title, direction)

类型

函数

参数说明

名称	类型	默认值	说明
source	布尔值	(必要参数)	布尔类型的序列数据
title	字符串	(必要参数)	警报条件的标题
direction	字符串	(非必要参数)	警报条件的方向，取值为buy或sell，buy为看涨，sell为看跌（PC 2.7.4 及以上版本才有效）

例子

[dif, dea, macd] = macd(close, 12, 26, 9, 'EMA', 'EMA');
cross_down_zero = crossdown(dea, 0);
alertcondition(cross_down_zero, title='MACD(12,26,9)下穿零轴',direction = 'sell');

linearAlert

创建线性预警，返回线性数据是否在图标k线数据上

linearAlert(startPoint, endPoint, type)

类型

函数

返回值

第一个值为是否触发，类型为bool，第二个值为线上的数值

参数说明

名称	类型	默认值	说明
point	数组	(必要参数)	点的坐标
type	字符串	(必要参数)	画线的类型，seg为线段，straight为直线，ray为射线

例子

isLocated,value = linearAlert([1700737200, 1000], [1700791200, 2000], 'straight')

条件表达式

?:

三元运算 (如果...那么...否则...)，适用于判断选择

condition ? expr1 : expr2

例子

// 如果是阳柱，赋值 1 否则赋值 -1
a = close > open ? 1 : -1 ;

if else

判断分支，(如果...否则...)，适用于判断选择

if(condition){
expr1 ;
}
else{
expr2 ;
}

例子

// 如果是阳柱，赋值 1 否则赋值 -1
if(close > open) {
a=1;
}else{
a=-1;
}

for

循环结构，限制循环数量为500次，若单次循环超过500则报错

● init：一般为赋值表达式，给控制变量赋初值；
● condition：关系表达式或逻辑表达式，循环控制条件；
● post：一般为赋值表达式，给控制变量增量或减量。

for (init; condition; post) {
statement;
}
for (condition){
statement;
}

语法版本需要 // @version=2

例子

b = nan;
for(i=0;i<10;i++){
b := i;
}

range

用于遍历数组或dict类结构

for key, value = range dict

例子

a = {"key1":10,'key2':20}
any b, c
for key,value = range a {
b := key
c := value
}

iff

三元运算 (如果...那么...否则...)，适用于判断选择

iff(condition ,expr1 ,expr2)

例子

open, 1 , -1)","range":{"gcpBegin":22,"len":0}},"builtinStyleName":""},{"operationType":"ModifyRunProp","param":{"range":{"gcpBegin":22,"len":29},"property":{"i":{"val":false},"u":{"val":"STUnderline_none"},"strike":{"val":false},"b":{"val":false},"spacing":{"val":0},"author":"p.13102701337525538"},"mode":1},"propertyType":"RunProperty","builtinStyleName":""},{"operationType":"InsertText","param":{"text":"\r","range":{"gcpBegin":51,"len":0}},"builtinStyleName":""},{"operationType":"ModifyRunProp","param":{"range":{"gcpBegin":51,"len":1},"property":{"isPlaceholder":true,"author":"p.13102701337525538"},"mode":1},"propertyType":"RunProperty","builtinStyleName":""},{"operationType":"ModifyParagraphProp","param":{"range":{"gcpBegin":51,"len":1},"property":{"spacing":{"line":240},"snapToGrid":{"val":true},"numPr":{}},"mode":1},"propertyType":"ParagraphProperty","builtinStyleName":""}],"subStory":[],"srcGlobalPadId":"w3_ATIALwZtAI8BTX2nK6JSIGtqeM02v","copyStart":2147}">// 如果是阳柱，赋值 1 否则赋值 -1

a = iff(close > open, 1 , -1)

关联阅读：

AICoin自定义指标函数文档——行情数据

AICoin自定义指标函数文档——指标函数

AICoin自定义指标函数文档——计算函数

AICoin自定义指标函数文档——配置及交易函数

AICoin自定义指标函数文档——运算符汇总

AICoin自定义指标函数文档——数据类型及函数定义

免责声明：本文章仅代表作者个人观点，不代表本平台的立场和观点。本文章仅供信息分享，不构成对任何人的任何投资建议。用户与作者之间的任何争议，与本平台无关。如网页中刊载的文章或图片涉及侵权，请提供相关的权利证明和身份证明发送邮件到support@aicoin.com，本平台相关工作人员将会进行核查。