智能交易脚本是量化交易思路的表达形式

==虚盘与实盘==

==ThisBar 与 NextBar==

==交易语句==

基本的交易可以通过 Buy/Sell/SellShort/BuyToCover 函数或语句完成。

{| class="wikitable"
|-
! 指令 !! 中文 !! 含义
|-
| Buy || 买入 || 多头开仓
|-
| Sell || 卖出 || 多头平仓
|-
| SellShort || 卖开 || 空头开仓
|-
| BuyToCover || 买平 || 空头平仓
|}

'''交易函数'''

作为函数时，与一般的函数调用一样，目前只支持逐根运行的模式。

Buy('symbol', Lots, Price=0, Slippage=0, OT=OT_Market, KT=KT_NextBar, Comment='')
SellShort('symbol', Lots, Price=0, Slippage=0, OT=OT_Market, KT=KT_NextBar, Comment='')
Sell('Symbol', lots, price, slippage, OT, KT, 'Comment') [From 'EntryName']
BuyToCover('Symbol', lots, price, slippage, OT, KT, 'Comment') [From 'EntryName']

Symbol: 下单品种

Lots: 下单数量，填Default时下单数量由界面控制

Price: 下单价格，市价单 OT_Market 时价格可以填 0

Slippage: 下单滑价，滑价是在实盘成交时起作用的，不影响虚盘的成交价格，但会影响测评报告的绩效计算。滑价填0时由界面控制滑价。

OT: Order Type 有以下的类型：

*OT_OPEN 开盘竞价，暂不支持
*OT_CLOSE 收盘竞价，暂不支持
*OT_MARKET 市价单，以当前价格成交
*OT_LIMIT 限价单，当买方向价格低于下单价格时成交（或卖方向高于此价格）
*OT_STOP 追价单，当买方向价格高于下单价格时成交（或卖方向低于此价格）

KT: K线类型有以下几种：

*KT_ThisBar, 当前一根K线，只能配合 OT_Market
*KT_NextBar, 下一根K线，可以配合 OT_Market/OT_Stop/OT_Limit

Comment: 下单注释，开仓时作为仓位标记

EntryName: 平仓时可以指定只操作某个标记的仓位

返回值：这4个交易函数都是操作虚盘的，操作能保证成功，所以函数没有返回值

'''交易语句'''

作为交易语句时，功能与交易函数一样，但写法更易于理解

('SellShort' | 'Sell' 'Short') ['(' "EntryLabel" ')'] [TradeSize] EntryType
'Buy' ['(' "EntryLabel" ')'] [TradeSize] EntryType
'Sell'['(' "ExitLabel" ')'] [From Entry("EntryLabel")] [TradeSize[Total]] ExitType
('BuyToCover' | 'Buy' 'To' 'Cover' ) [("ExitLabel")][From Entry("EntryLabel")] [TradeSize[Total]] ExitType

EntryType: ( This Bar[On]Close | Next Bar[At]Open or Next Bar[At]Market | Next Bar[At]Price Limit | Next Bar[At]Price Stop )
ExitType: ( This Bar[On]Close | Next Bar[At]Open or Next Bar[At]Market | Next Bar[At]Price Limit | Next Bar[At]Price Stop )

('次周期'|'本周期') [价格] [类型] ('买入'|'卖开') [数量] ['标记为' '开仓标记'];
('次周期'|'本周期') [价格] [类型] ['从标记' '开仓标记'] ('卖出'|'买平') [数量] ['标记为' '平仓标记'];

类型: ('追价'|'限价'|'市价')

==实盘函数==

==限价，追价，市价单==

==止盈，止损，跟踪止损，震荡止损，保本止损==

智能交易公式

2013-06-14T07:06:30Z

John: /* 交易语句 */

智能交易脚本是量化交易思路的表达形式

==交易语句==

基本的交易可以通过 Buy/Sell/SellShort/BuyToCover 函数或语句完成。

{| class="wikitable"
|-
! 指令 !! 中文 !! 含义
|-
| Buy || 买入 || 多头开仓
|-
| Sell || 卖出 || 多头平仓
|-
| SellShort || 卖开 || 空头开仓
|-
| BuyToCover || 买平 || 空头平仓
|}

'''交易函数'''

作为函数时，与一般的函数调用一样，目前只支持逐根运行的模式。

Buy('symbol', Lots, Price=0, Slippage=0, OT=OT_Market, KT=KT_NextBar, Comment='')
SellShort('symbol', Lots, Price=0, Slippage=0, OT=OT_Market, KT=KT_NextBar, Comment='')
Sell('Symbol', lots, price, slippage, OT, KT, 'Comment') [From 'EntryName']
BuyToCover('Symbol', lots, price, slippage, OT, KT, 'Comment') [From 'EntryName']

Symbol: 下单品种

Lots: 下单数量，填Default时下单数量由界面控制

Price: 下单价格，市价单 OT_Market 时价格可以填 0

Slippage: 下单滑价，滑价是在实盘成交时起作用的，不影响虚盘的成交价格，但会影响测评报告的绩效计算。滑价填0时由界面控制滑价。

OT: Order Type 有以下的类型：

*OT_OPEN 开盘竞价，暂不支持
*OT_CLOSE 收盘竞价，暂不支持
*OT_MARKET 市价单，以当前价格成交
*OT_LIMIT 限价单，当买方向价格低于下单价格时成交（或卖方向高于此价格）
*OT_STOP 追价单，当买方向价格高于下单价格时成交（或卖方向低于此价格）

KT: K线类型有以下几种：

*KT_ThisBar, 当前一根K线，只能配合 OT_Market
*KT_NextBar, 下一根K线，可以配合 OT_Market/OT_Stop/OT_Limit

Comment: 下单注释，开仓时作为仓位标记

EntryName: 平仓时可以指定只操作某个标记的仓位

返回值：这4个交易函数都是操作虚盘的，操作能保证成功，所以函数没有返回值

'''交易语句'''

作为交易语句时，功能与交易函数一样，但写法更易于理解

('SellShort' | 'Sell' 'Short') ['(' "EntryLabel" ')'] [TradeSize] EntryType
'Buy' ['(' "EntryLabel" ')'] [TradeSize] EntryType
'Sell'['(' "ExitLabel" ')'] [From Entry("EntryLabel")] [TradeSize[Total]] ExitType
('BuyToCover' | 'Buy' 'To' 'Cover' ) [("ExitLabel")][From Entry("EntryLabel")] [TradeSize[Total]] ExitType

EntryType: ( This Bar[On]Close | Next Bar[At]Open or Next Bar[At]Market | Next Bar[At]Price Limit | Next Bar[At]Price Stop )
ExitType: ( This Bar[On]Close | Next Bar[At]Open or Next Bar[At]Market | Next Bar[At]Price Limit | Next Bar[At]Price Stop )

('次周期'|'本周期') [价格] [类型] ('买入'|'卖开') [数量] ['标记为' '开仓标记'];
('次周期'|'本周期') [价格] [类型] ['从标记' '开仓标记'] ('卖出'|'买平') [数量] ['标记为' '平仓标记'];

类型: ('追价'|'限价'|'市价')

==虚盘与实盘同步==

==实盘函数==

==限价，追价，市价单==

==止盈，止损，跟踪止损，震荡止损，保本止损==

测评报告之二

2013-06-14T06:11:38Z

John:

[[Image:Ceping7.jpg]]

月绩效分析表

测试期内所有相同月份交易绩效的统计。

如上图，是2005-2012年的月绩效统计，3、7、9月份的绩效如此不堪，

可考虑这几个月份减小投入资金或不做交易。4、10月份的绩效惊人，可考虑这几个月份加大投入。

月度分析

与【月绩效分析表】不同，该表是测试期内每个自然月的交易绩效的统计

年度分析

测试期内每个自然年的交易绩效的统计

最大浮盈浮亏表

【交易明细】表中有每笔交易曾达到的最大浮盈、最大浮亏，该表对此进行总体统计，

包括最大值、发生日期、平均值、标准差等。

[[Image:Ceping8.jpg]]

最大浮盈散点图

横坐标是交易序号，每个点表示该笔交易的最大浮盈，水平线是最大浮盈的平均值

[[Image:Ceping9.jpg]]

最大浮亏散点图

横坐标是交易序号，每个点表示该笔交易的最大浮亏，水平线是最大浮亏的平均值。

双击鼠标出现十字光标可查看各点数值。

[[Image:Ceping10.jpg]]

最大浮盈-平仓盈亏柱形图

横坐标是交易序号，每个柱的高点都在0线之上，是该笔交易的最大浮盈，

低点是该笔交易的平仓盈亏，柱形高度表示最大浮盈与平仓盈亏间的差距。

红色表示该笔交易是盈利的，绿色表示该笔交易是亏损的。

[[Image:Ceping11.jpg]]

最大浮亏-平仓盈亏柱形图

横坐标是交易序号，每个柱的低点都在0线之下，是该笔交易的最大浮亏，高点是该笔交易的平仓盈亏，

柱形高度表示最大浮亏与平仓盈亏间的差距。红色表示该笔交易是盈利的，绿色表示该笔交易是亏损的。

双击鼠标出现十字光标可查看各点数值。

[[Image:Ceping12.jpg]]

最大浮盈-平仓盈亏散点图

该图描绘了每笔交易的盈亏与最大浮动盈利间的关系。

纵坐标是平仓盈亏的绝对值。红色表示盈利交易，绿色表示亏损交易。

[[Image:Ceping13.jpg]]

最大浮亏-平仓盈亏散点图

该图描绘了每笔交易的盈亏额与最大浮动亏损间的关系。

纵坐标是平仓盈亏的绝对值。红色表示盈利交易，绿色表示亏损交易。

双击鼠标出现十字光标可查看各点数值。

[[Image:Ceping14.jpg]]

与资产及水下（回撤曲线）图相似，但带有过夜占用保证金曲线

[[Image:Ceping15.jpg]]

累计成本 = 累计的手续费+滑价成本

==时间仓位分析==

'''总交易时间'''：第一笔交易到最后一笔交易之间的天数，包括周末

'''持仓时间（天）'''：有持仓的天数

'''持仓时间（%）'''：有持仓的天数占交易总时间的百分比

'''最大空仓时间（天）'''：没有持仓持续的最大天数

'''总交易月数'''：第一笔交易到最后一笔交易之间的月数

'''盈利月数'''：盈利的月份总数

'''资产增值天数'''：动态权益增长的总天数

'''资产减值天数'''：动态权益减少的总天数

'''获利日占比'''：（增值时间%）资产增值天数/总交易时间*100%

'''最大浮盈日期'''：持仓浮动盈利最大的日期，检视是什么仓位和走势产生的

'''最大浮亏日期'''：持仓浮动亏损最大的日期，检视是什么仓位和走势产生的

'''持仓周期'''：持仓期间的K线数量

'''平均持仓周期'''：每笔交易的持仓K线数量和/交易次数

'''平均盈利周期'''：盈利交易平均持仓周期，K线数

'''平均亏损周期'''：亏损交易平均持仓周期，K线数

'''最大持仓数量'''：统计历史上曾经的最大的持仓合约数，按天结算的，不是盘中实时最大的。

'''最大占用资金'''：统计历史上最大投入的资金额，开仓到最大仓位时投入的资金，按天结算。

'''最小账户资金'''：最大资产回撤+占用的保证金

'''平均仓位'''：对每根K线取样计算持仓占用的资金/资产的百分比平均值

编译预处理

2013-06-09T08:18:55Z

John: 以“编译预处理是指编译前对编译器的一些设定，不参与到公式的语法分析中编译预处理有下面的种类： #Mainchart #Subchart #NoDe...”为内容创建页面

编译预处理是指编译前对编译器的一些设定，不参与到公式的语法分析中

编译预处理有下面的种类：

#Mainchart
#Subchart
#NoDefaultOutput
#Trade
#Opt
#Note
#Template
#InvalidPeriod
#DefaultPeriod
#RunMode
#Run_By_Bar
#Run_By_Serie
#Run_Every_Tick
#Run_Every_Bar
#NoTitle
#Use
#Define
#RefLine

首页

2013-06-09T08:13:28Z

John: /* 公式教程 */

==简介==
北斗星是一款具有划时代意义的程式化交易平台软件。 [http://www.hs633.com/pro 北斗星下载]
*内置强大的金语言系统，支持中文编写策略；
*兼容国内主流证券软件，如飞狐交易师、大智慧、通达信等的指标语言
*很大程度上兼容技术分析和程式交易的工业标准语言 Easy Language/Power Language。

[http://www.hs633.com/forum.php 用户论坛----资讯发布，用户反馈，心得交流，专人帮助]

[http://www.hs633.com/forum.php?mod=viewthread&tid=2850&extra=page%3D1 教学视频]

看一看 [http://www.hs633.com/pro/gl.php 这个] 对金语言有一个大致的了解。

==主客户端的使用==
===关于北斗星===
#[[系统简介]]

===关于联机帮助系统===
#[[关于联机帮助系统的使用]]
#[[常用术语]]

===下载和安装===
#[[如何下载软件]]
#如何安装软件
##[[如何安装软件]]
##[[系统配置要求]]
#[[如何进入系统]]

===功能详解===
====系统菜单简介====
#[[系统菜单]]
#[[量化交易菜单]]
#[[查看菜单]]
#[[画面菜单]]
#[[工具菜单]]
#[[窗口菜单]]
#[[帮助菜单]]
====行情观看====
=====行情机制=====
#[[行情数据类型]]
#[[全推和点播]]

=====如何灵活使用工作区=====
#[[工作区有什么作用？]]
#[[如何新建工作区？]]
#[[如何关闭工作区？]]
#[[如何删除工作区？]]
#[[如何调整工作区位置？]]
=====报价窗口=====
#[[如何在报价表中打开分析窗口？]]
#[[如何添加与关闭报价板块？]]
#[[如何调整报价板块位置？]]
#[[如何调整显示栏目？]]
#[[如何调整列宽？]]
#[[如何选中多个证券？]]
#[[如何排序并取消？]]
#[[如何添加、取消特别标记？]]
#[[如何将证券加入到自选或自定义板块？]]
#[[如何复制表中数据？]]
#[[如何添加、删除常用板块？]]
#[[如何使用键盘加入证券到自选板块？]]
#[[如何调整自选或自定义板块中的证券显示位置？]]
=====键盘精灵和快捷键=====
#[[键盘精灵详解]]
#[[系统快捷键列表]]

====技术分析====
#[[如何切换证券分析周期？]]
#[[如何查看除权、复权走势图？]]
#[[如何查看多日分时走势？]]
#[[如何切换主图类型？]]
#[[如何添加、删除、最大化附图？]]
#[[如何显示指标公式？]]
#[[如何移动分析画面？]]
#[[如何叠加、清除其他品种走势？]]
#[[如何同时查看多个品种走势图？]]
#[[如何在附图指标上叠加k线？]]
#[[如何查看历史某天分时走势？]]
#[[如何切换横、纵坐标类型？]]
#[[如何显示、隐藏常用指标栏？]]
#[[如何显示、隐藏最新价线？]]
#[[如何设置主图k线显示数量？]]
#[[如何显示、隐藏策略信息？]]
#[[分析窗口如何自动翻页？]]
#[[如何在k线图上显示波段高低点数值？]]
#[[如何反转走势图形？]]
#[[如何在分析窗口复制数据？]]
#[[如何快速找到所要的k线？]]
#[[如何锁定k线图显示时段？]]
#[[如何统计时段数据？]]
#[[历史回忆的意义与使用？]]
#[[如何打造自定义数据库？]]
#[[如何使用太阳风暴功能？]]
#[[如何利用训练模式自我提高？]]
#[[如何使用预警系统，打造自己的监控体系？]]
#[[如何进行条件选股？]]

====画线工具介绍====

====量化分析和交易====
=====智能评测=====
#[[如何将策略模拟信号显示在k线图上？]]
#[[如何快速查看测评报告？]]
#[[如何使用智能测评全面评估策略？]]
#[[如何设置测评？]]
#[[如何查看详细测评报告？]]
#[[如何查看策略分析？]]
#[[如何查看交易分析？]]
#[[如何查看时段分析？]]
#[[如何将自己的测评结果上传到花生网？]]

=====测评报告详解=====
#[[测评报告之一]]
#[[测评报告之二]]
#[[历史回测]]

=====手工下单及交易账户信息查询=====
#[[如何登入、注销交易账户？]]
#[[如何查看账户资金？]]
#[[如何查看委托状态？]]
#[[如何查看当前持仓？]]
#[[如何查看历史成交？]]
#[[如何查看、修改各合约配置？]]
#[[如何手工下单？]]
#[[如何将账户数据上传到花生网？]]

=====闪电下单和图形下单=====
#[[如何闪电下单]]
#[[如何图形化下单]]
=====本地模拟=====
#[[如何本地模拟]]
=====程式交易=====
#[[如何程式化交易]]
=====后台交易=====
#[[后台交易详解]]

====策略公式编辑器====
#[[策略公式编辑器]]
#[[打开新建指标]]
#[[编辑指标]]
#[[编译指标]]
#[[函数字典]]
#[[菜单]]
#[[工具条]]
#[[公式参数精灵面板]]

==数据定义==

===基本数据定义===
#[[报价表]]（Report）
#[[成交分笔]]（TICK）
#[[一分钟]]（MIN1）
#[[五分钟]]（MIN5）
#[[日线]]

===多周期数据定义===
#[[K线切分方式计算标准]]

===特殊复权===
#[[期货主连复权]]
#[[日间复权]]

===主连换月规则===

#[[主连换月规则]]

==目录结构及文件用途==
#[[目录结构及文件]]

==公式系统教程==
===公式教程===
#[[公式系统入门]]
#[[公式类型]]
#[[数据类型]]
#[[参数和变量]]
#[[执行模式]]
#[[保留字]]
#[[操作符]]
#[[表达式]]
#[[控制语句]]
#[[指标输出和线形描述]]
#[[注释，公式描述，参数精灵]]
#[[编译预处理]]
#[[智能交易公式]]
#[[数据引用与指标引用]]
#[[公共函数]]
#[[DLL扩展]]
#[[函数索引]]

===经典分析指标详解===
#[[移动平均线MA]]
#[[布林通道BOLL]]
#[[指数平滑异同移动平均线MACD]]
#[[随机指标KDJ]]
#[[相对强弱指标RSI]]

===交易脚本样例详解===
#[[交易指令基础]]
#[[交易指令进阶]]
#[[日内交易之开盘区间突破]]
#[[分批开平仓]]
#[[指标背离交易及风险控制策略]]
#[[自动趋势线交易策略]]
#[[网格交易和鞅加仓策略]]
#[[点数图突破交易策略]]
#[[均线与趋势线交叉加仓位管理]]

==应用文库==
#F10扩展功能

==相关链接==
Here are some helpful links:
*[http://www.hs633.com/pro/about.php "Beginner's Guide To 交易平台"]
*[http://www.hs633.com/pro/problem.php FAQ for frequent beginner questions]
*[http://www.hs633.com/download_Futures.php/ 下载北斗星]

==WIKI 使用帮助==
[http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting WIKI使用帮助]

[http://en.wikipedia.org/wiki/Help:Table WIKI表格制作]

[[SandBox|试验田]]

[[category:在线帮助]]

注释，公式描述，参数精灵

2013-06-09T08:10:04Z

John: /* 全文本公式 */

==公式注释==

公式编写中，往往需要插入描述性文字，这些文字在编译时是忽略的。

注释分为单行注释和整个段落注释，使用 // 注释单行，直至行末；使用{}注释整个段落

例如下面的例子：

[[Image:Fmlgszs.png]]

在公式编辑器里，注释呈现绿色

==公式描述==

为了方便用户理解，公式可以附带一些说明性的文字。在编辑器的参数面板里面可以

点击用法注释按钮来添加公式描述：

[[Image:Fmlyfzs.png]]

编译后，当用户运行公式时，只要鼠标移动到指标名称上，软件就会浮现用户添加的用法注释：

[[Image:Fmlyfzs2.png]]

==参数精灵==

参数精灵也是公式的一种说明描述，显示在调整公式参数面板上：

[[Image:Fmlcsjl.png]]

参数精灵通过 Param#No 或 SParam#No 来对应参数的类型和第几个参数，Param是数值型，SParam是字符串类型。

注意它们是大小写敏感的，No是数字，代表第几个参数，下面是例子：

这是第一个参数 #Param#1, 数值类型
这是第二个参数 #SParam#2, 字符串类型

==全文本公式==

注释，公式描述和参数精灵，包括参数设置本身都可以内嵌到公式的文本里，完全无界面化。

#Note '公式描述
换行 '

#Template '参数精灵第一个参数 Param#1
第二个参数 SParam#2
'

input:
aa(1.2),
bb('test1');

注释，公式描述，参数精灵

2013-06-09T08:09:42Z

John: /* 全文本公式 */

数据引用与指标引用

2013-06-09T07:49:02Z

John: 以“==数据引用== 数据引用与数据对齐前1根和前1天分支里面的数据回溯 ==指标引用==”为内容创建页面

==数据引用==
数据引用与数据对齐
前1根和前1天
分支里面的数据回溯

==指标引用==

首页

2013-06-09T07:48:34Z

2013-06-09T07:08:16Z

John: /* 公式注释 */

==公式注释==

公式编写中，往往需要插入描述性文字，这些文字在编译时是忽略的。

注释分为单行注释和整个段落注释，使用 // 注释单行，直至行末；使用{}注释整个段落

例如下面的例子：

[[Image:Fmlgszs.png]]

在公式编辑器里，注释呈现绿色

==公式描述==

==参数精灵==

==全文本公式==

注释，公式描述，参数精灵

2013-06-09T07:07:37Z

John: /* 公式注释 */

==公式注释==

公式编写中，往往需要插入描述性文字，这些文字在编译时是忽略的。

注释分为单行注释和整个段落注释，使用 // 注释单行，直至行末；使用{}注释整个段落

例如下面的例子：

// 这是注释
k1:close,CrossDot

{
整段的注释说明
说明1
说明2
}

在公式编辑器里，注释呈现绿色

[[Image:Fmlgszs.png]]

==公式描述==

==参数精灵==

==全文本公式==

文件:Fmlgszs.png

2013-06-09T07:06:30Z

John:

注释，公式描述，参数精灵

2013-06-09T07:04:10Z

John:

==公式注释==

公式编写中，往往需要插入描述性文字，这些文字在编译时是忽略的。

注释分为单行注释和整个段落注释，使用 // 注释单行，直至行末；使用{}注释整个段落

例如下面的例子：

// 这是注释
k1:close,CrossDot

{
整段的注释说明
说明1
说明2
}

==公式描述==

==参数精灵==

==全文本公式==

执行模式

2013-06-09T06:44:38Z

John: /* 计算频率开关 */

=逐根和逐行=

星语言中，公式有两种执行模式，一种叫逐行模式，一种叫逐根模式。

'''逐行运行''' 就是说根据代码，从上到下，第一行运行到最后一行：

[[Image:RunBySeries.png]]

'''逐根运行''' 就是说根据K线，从左边第一根K线，运行到右面最后一根K线：

[[Image:RunByBar.png]]

逐根运行在运行每一根K线时，也是把代码从第一行运行到最后一行的。逐根运行与逐行运行的区别是：

每行代码只运行当前的一个值，而逐行模式是整条序列。

例如如果代码是 Close+1，那么在逐行模式下，Close 代表图上所有的收盘价，加一后，得到所有收盘价+1的一条序列；

而在逐根运行时，Close 只代表当前一根k线的收盘价，加一后，得到当前收盘价+1的一个单值，从第一根运行到最后一根，

每一根都得到1个单值，等所有K线运行完毕后，才得到完整的序列。

由此可见，逐根模式比逐行模式多运行了许多遍：如果图上有1000根K线，公式代码将会被执行1000遍，

只不过每次运算只算1个值，而不像逐行模式那样每次运算一整条序列。总的来说逐根运行要比逐行耗时，

但是逐根运算能表达逐行运算所不能完成的条件分支逻辑，这是交易脚本所必须的逻辑。

另外，逐根模式在第一次运行完毕后，后续行情到来时，只需要运算最后一根的变化，这要比逐行的开销少多了。

关于这两种模式的运行机制更多讨论：[[逐行和逐根]]。

公式是怎样选择运行模式的呢？通过编译开关来控制：
#Run_By_Bar
#Run_By_Series

其中，#Run_By_Bar表示使用逐根模式，#Run_By_Series表示使用逐行模式。

这两个开关也可以不写，在不同的指标类型中，分别有不同的默认值。

在“技术指标”、“条件选股”、“交易系统”、“五彩K线”这四种指标中，默认是逐行模式。

在“智能策略”、“公共函数”、“优化评价”这三种指标中，默认是逐根模式（而且只能是逐根，指定逐行开关无效）。

=计算频率开关=

对于逐根模式，我们知道，每次都是只计算一根。

现在问题来了，K线的最后一根，并非是一次成型的，是在一段时间内不断变化的。

那么，是在每次变化时，都计算，还是最后成型时才计算呢？为此，准备了开关来控制这个行为。

#Run_Every_Tick
#Run_Every_Bar

*Run_Every_Tick 表示，最后一根K线每次变化的时候，都重新计算。

*Run_Every_Bar，则在下一根K线产生的一瞬间，才计算当前的K线。

[[Image:RunEveryTick.png]]

在 Buy Next Bar Open 这种类型的公式里，为了避免信号抖动，需要在K线完全走完时才发出信号，在下根K线中成交。

对于这种类型的公式，可以使用#Run_Every_Bar模式，减少不必要的运算。

在 Buy This Bar Market 这种类型的公式里，需要根据最新行情来计算是否交易。此时公式运行需要 #Run_Every_Tick模式

=事件触发=

在公式中，可以编写一小段代码，这段代码是在某些事件发生的时候才执行。

这类事件包括'''初始化'''和'''执行完毕'''

===初始化===
只要编写一个内置函数，并且命名为OnInit，那么它就会在初始化时执行。

fucntion OnInit
Begin
//做一些只需要做一次，没有必要每次行情来时都做的工作。例如，设置画线的颜色，设置账号。等等。
End

那么，OnInit究竟具体在什么时候会发生呢。
包括并且不限于以下情况，例如：

1.切换成其他品种；

2.切换成其他周期；

3.服务器推送来一些旧的历史数据（某种情况下，可能客户端会先请求最新一段数据，再请求旧的数据）

初始化事件会让公式清除所有状态重新运行计算1次，后续行情到来不再计算。

===执行完毕===
只要编写一个内置函数，并且命名为OnExit,那么它就会在公式执行到末尾时执行。

function OnExit
Begin
//做一些收尾工作
End

为什么需要OnExit呢，是因为目前公式引擎支持“中断”。所谓中断，就是如果某些公式计算一次时间特别长，有时公式运行到一半，还没计算完，用户切换到其他品种了，那之前的计算就没有必要继续下去，这时候，系统就会强行中断计算。

但是，用户可能希望某些计算是必须要执行的，例如，这个公式可能是调用DLL的，DLL可能在开始分配了一些资源，而且必须在运算完毕后释放，这部分计算就可以写在OnExit中，正常情况下它们会在公式主体运行结束之后被执行。如果公式主体被中断，它们会在中断后执行。

===公式主体===
公式的主体是名为OnStart的函数，象这样：

Function OnStart
Begin
mm:ma(c, close );
End

但是，为了方便编写，上述的“Function OnStart”可以省略。
也就是可以只写
mm: ma( c, Close );

凡是没有包在其它函数体里面的代码都被认为是 OnStart 函数的内容。除非显式声明了 OnStart 函数。如果既声明了OnStart函数，又写了一段没有被任何函数包裹的代码，那么没有被包裹的代码被直接忽略，认为是空白。

执行模式

2013-06-09T06:42:27Z

John: /* 计算频率开关 */

=逐根和逐行=

星语言中，公式有两种执行模式，一种叫逐行模式，一种叫逐根模式。

'''逐行运行''' 就是说根据代码，从上到下，第一行运行到最后一行：

[[Image:RunBySeries.png]]

'''逐根运行''' 就是说根据K线，从左边第一根K线，运行到右面最后一根K线：

[[Image:RunByBar.png]]

逐根运行在运行每一根K线时，也是把代码从第一行运行到最后一行的。逐根运行与逐行运行的区别是：

每行代码只运行当前的一个值，而逐行模式是整条序列。

例如如果代码是 Close+1，那么在逐行模式下，Close 代表图上所有的收盘价，加一后，得到所有收盘价+1的一条序列；

而在逐根运行时，Close 只代表当前一根k线的收盘价，加一后，得到当前收盘价+1的一个单值，从第一根运行到最后一根，

每一根都得到1个单值，等所有K线运行完毕后，才得到完整的序列。

由此可见，逐根模式比逐行模式多运行了许多遍：如果图上有1000根K线，公式代码将会被执行1000遍，

只不过每次运算只算1个值，而不像逐行模式那样每次运算一整条序列。总的来说逐根运行要比逐行耗时，

但是逐根运算能表达逐行运算所不能完成的条件分支逻辑，这是交易脚本所必须的逻辑。

另外，逐根模式在第一次运行完毕后，后续行情到来时，只需要运算最后一根的变化，这要比逐行的开销少多了。

关于这两种模式的运行机制更多讨论：[[逐行和逐根]]。

公式是怎样选择运行模式的呢？通过编译开关来控制：
#Run_By_Bar
#Run_By_Series

其中，#Run_By_Bar表示使用逐根模式，#Run_By_Series表示使用逐行模式。

这两个开关也可以不写，在不同的指标类型中，分别有不同的默认值。

在“技术指标”、“条件选股”、“交易系统”、“五彩K线”这四种指标中，默认是逐行模式。

在“智能策略”、“公共函数”、“优化评价”这三种指标中，默认是逐根模式（而且只能是逐根，指定逐行开关无效）。

=计算频率开关=

对于逐根模式，我们知道，每次都是只计算一根。

现在问题来了，K线的最后一根，并非是一次成型的，是在一段时间内不断变化的。

那么，是在每次变化时，都计算，还是最后成型时才计算呢？为此，准备了开关来控制这个行为。

#Run_Every_Tick
#Run_Every_Bar

#Run_Every_Tick 表示，最后一根K线每次变化的时候，都重新计算。

而#Run_Every_Bar，则在下一根K线产生的一瞬间，才计算当前的K线。

[[Image:RunEveryTick.png]]

在 Buy Next Bar Open 这种类型的公式里，为了避免信号抖动，需要在K线完全走完时才发出信号，在下根K线中成交。

对于这种类型的公式，可以使用#Run_Every_Bar模式，减少不必要的运算。

在 Buy This Bar Market 这种类型的公式里，需要根据最新行情来计算是否交易。此时公式运行需要 #Run_Every_Tick模式

=事件触发=

在公式中，可以编写一小段代码，这段代码是在某些事件发生的时候才执行。

这类事件包括'''初始化'''和'''执行完毕'''

===初始化===
只要编写一个内置函数，并且命名为OnInit，那么它就会在初始化时执行。

fucntion OnInit
Begin
//做一些只需要做一次，没有必要每次行情来时都做的工作。例如，设置画线的颜色，设置账号。等等。
End

那么，OnInit究竟具体在什么时候会发生呢。
包括并且不限于以下情况，例如：

1.切换成其他品种；

2.切换成其他周期；

3.服务器推送来一些旧的历史数据（某种情况下，可能客户端会先请求最新一段数据，再请求旧的数据）

初始化事件会让公式清除所有状态重新运行计算1次，后续行情到来不再计算。

===执行完毕===
只要编写一个内置函数，并且命名为OnExit,那么它就会在公式执行到末尾时执行。

function OnExit
Begin
//做一些收尾工作
End

为什么需要OnExit呢，是因为目前公式引擎支持“中断”。所谓中断，就是如果某些公式计算一次时间特别长，有时公式运行到一半，还没计算完，用户切换到其他品种了，那之前的计算就没有必要继续下去，这时候，系统就会强行中断计算。

但是，用户可能希望某些计算是必须要执行的，例如，这个公式可能是调用DLL的，DLL可能在开始分配了一些资源，而且必须在运算完毕后释放，这部分计算就可以写在OnExit中，正常情况下它们会在公式主体运行结束之后被执行。如果公式主体被中断，它们会在中断后执行。

===公式主体===
公式的主体是名为OnStart的函数，象这样：

Function OnStart
Begin
mm:ma(c, close );
End

但是，为了方便编写，上述的“Function OnStart”可以省略。
也就是可以只写
mm: ma( c, Close );

凡是没有包在其它函数体里面的代码都被认为是 OnStart 函数的内容。除非显式声明了 OnStart 函数。如果既声明了OnStart函数，又写了一段没有被任何函数包裹的代码，那么没有被包裹的代码被直接忽略，认为是空白。