KDJ 指标的图形化显示 基于BotVS量化平台

在使用 BotVS 的指标 API 的时候，有时候很想图形化显示一下指标线（其实我初学的时候也是有这个想法，很想画出指标看看）。第一是想练习如何运用指标API， 比如返回的数据的使用。 第二很是好奇，想自己画出来和其它软件或者网站上的对比。近期也有不少朋友提出这个问题，于是我写了一个小DEMO 测试，我们就拿 KDJ指标做示范。

代码：测试的合约为 商品期货 rb1710 合约

// 画 KDJ 指标的 DEMO 程序
// 需要引用  画线类库  模板  有兴趣的可以看下 源码对于学习编写 策略图表显示 很有帮助 ： https://www.botvs.com/bbs-topic/608   也是注释版的。

var preTime = 0;                                 // 声明一个变量用来记录 前一个K线 Bar 的时间戳 
var ChartObj = null;                             // 声明一个变量 用来 引用 图形API   Chart 函数
function main(){                                 // 测试例子的  主函数 ， 本例 代码全部都写在 main 函数中。
    LogReset(1);                                 // 清空所有日志 ， 仅保留本次运行的第一条（所以参数传入1）
    ChartObj = Chart(null);                      // 调用 Chart 函数 初始化图表对象
    ChartObj.reset();                            // 清空之前的图表内容
    
    var records = null;                          // 声明一个 变量 records 用于 记录 获取到的K线数据
    var MACD = null;                             // 声明一个 变量 KDJ 用于记录 指标API函数 返回的 数据。
    
    while(exchange.IO("status") == false){       // 程序需要在 和 期货公司前置服务器 连接的状态下 才可以继续操作，
                                                 // 所以会不断调用 exchange.IO("status") 检查连接状态， 连接状态 exchange.IO("status") 返回 true 
        Sleep(5000);                             // 每次检测 暂停5秒（5000毫秒），避免过于 访问频繁
    }

    var ContractTypeInfo = _C(exchange.SetContractType, "rb1710");      
                                                 // 设置要操作的合约为  rb1710 合约，并赋值给 ContractTypeInfo 变量, _C() 函数用来容错API 详见API文档
    
    ChartObj = $.GetCfg();                       // 调用模板   画线类库   的导出函数 $.GetCfg()  获取 图表对象 引用给 变量 ChartObj 
    
    // 处理 指标轴------------------------         // 由于KDJ 指标数值 与 K线 中价格的 数值 相差很远，所以需要 用2个不同的Y轴显示，否则图像压缩，看不到 指标线、K线变动。
    ChartObj.yAxis = [{
            title: {text: 'K线'},//标题
            style: {color: '#4572A7'},//样式 
            opposite: false  //生成右边Y轴
        },
        {
            title:{text: "指标轴"},
            opposite: true,  //生成右边Y轴 ， 图表第二个Y轴
        }
    ];

    // 初始化指标线
    while(!records || records.length < 30){     // 如果 records 为 null 或者 records.length 小于 30  ，执行该循环
        records = _C(exchange.GetRecords);      // 调用 获取K线 API 函数 ：  GetRecords （即 exchange 对象的成员函数 ），用_C()函数对其进行容错处理， 获取到的数据赋值给records
        LogStatus("records.length:", records.length);  // 在状态栏显示 获取的K线数据长度的信息。
        Sleep(1000);
    }
    
    $.PlotRecords(records, 'rb1710');           // 调用 画线类库 模板的导出函数 $.PlotRecords 画K线
    $.PlotLine('K', 0, records[records.length - 1].Time);  // 添加 KDJ 中的  K指标线
    $.PlotLine('D', 0, records[records.length - 1].Time);  // 添加 KDJ 中的  D指标线
    var chart = $.PlotLine('J', 0, records[records.length - 1].Time);  // 添加 KDJ 中的  J指标线 ， 并将 $.PlotLine 函数返回的图表控制对象
    // 修改指标线 坐标轴Y轴
    for(var key in ChartObj.series){                                   // 遍历 图表对象 的数据系列 将数据系列 名称为 'K' 'D' 'J' 的数据绑定在 索引为1的Y轴（即第二个Y轴，第一个Y轴的索引是0）
        if(ChartObj.series[key].name == 'K' || ChartObj.series[key].name == 'D' || ChartObj.series[key].name == 'J'){
            ChartObj.series[key].yAxis = 1;
        }
    }
    chart.update(ChartObj);                                            // 用修改后 图表对象 作为参数 传递给 图表控制对象的成员函数 update ， 更新图表设置。
    chart.reset();                                                     // 清空图表数据
    
    while(true){                                                       // 主要的画图循环，设定为死循环。
        if(exchange.IO("status")){                                     // 同样，在画图的时候 必须要确定是 和 服务器 连接状态 （即 不是休市时间）
            records = _C(exchange.GetRecords);                         // 通过容错函数_C() ，  调用 API  获取 K线，赋值给 records
            if(records.length > 50){                                   // 需要K线数量 大于 50 
                $.PlotRecords(records, 'OK期货');                       // 调用  模板  “画线类库”  的导出函数  $.PlotRecords  画K线
                KDJ = TA.KDJ(records);                                 // 调用 TA.KDJ  指标API  用传入的 records K线数据 计算 KDJ指标数据
                var K = KDJ[0];                                        // KDJ 数据结构是一个 二维数组 ，包含三个数组，第一个是 指标K线  ，第二个是指标D线，第三个是指标J线。
                var D = KDJ[1];                                        // 分别赋值 变量 K,D,J
                var J = KDJ[2];                                        // 
                if(preTime !== records[records.length - 1].Time){      // 用 records K线数据的倒数第一个 bar 的时间戳（即： records[records.length - 1].Time）
                                                                       // 和 preTime 变量记录的时间戳 对比，判断是否是有新K线Bar出现，如果出现 处理图表 并在处理后更新preTime 变量用于下次判断是否有新K线出现
                    $.PlotLine('K', K[K.length - 2], records[records.length - 2].Time);   // 调用 模板 “画线类库”  导出函数 $.PlotLine 画  指标 K
                    $.PlotLine('D', D[D.length - 2], records[records.length - 2].Time);   // ...  要注意的是，新Bar 出现后，出现前那个曾经是最新的Bar各个数值才确定。
                    $.PlotLine('J', J[J.length - 2], records[records.length - 2].Time);   // 所以要用此刻的倒数第二个Bar去画在图表上 以确定数值
                
                    $.PlotLine('K', K[K.length - 1], records[records.length - 1].Time);   // 然后再画 最新的 数据。
                    $.PlotLine('D', D[D.length - 1], records[records.length - 1].Time);
                    $.PlotLine('J', J[J.length - 1], records[records.length - 1].Time);
                
                    preTime = records[records.length - 1].Time;                           // 更新时间戳 用于对比。
                }else{                                                                    // 如果 preTime == records[records.length - 1].Time， 即没有新的Bar出现
                    $.PlotLine('K', K[K.length - 1], records[records.length - 1].Time);   // 用最新的数据 更新 倒数第一 Bar 在图表上。
                    $.PlotLine('D', D[D.length - 1], records[records.length - 1].Time);
                    $.PlotLine('J', J[J.length - 1], records[records.length - 1].Time);
                }
            }
            LogStatus("records.length:", records.length, records[records.length - 1]);
        
            Sleep(1000);
        }else{
            LogStatus("休市..");                                                           // 如果 exchange.IO("status") 返回 false 则为休市（一般情况，未连接服务器）
        }
    }
}

对比文华上的行情图表

有兴趣的同学可以剖析这个DEMO源码 和 “画线类库” 模板的源码： BotVS**
测试的时候需要引用上“画线类库”，否则是画不出图表的。

初学者如有错误欢迎各位读者指正！
玩转量化快来BotVS 吧~