; MyBar = i; } } HighestBar = MyBar; Return MyVal;End
用户函数的调用用户函数成功创建之后(编译/保存成功),您可以在其他的用户函数、技术分析、交易指令等公式中调用用户函数,调用用户函数时需要注意保持参数类型的匹配,即用户函数参数的声明数据类型需和调用时传入参数的数据匹配,这是所指的匹配是指基本数据类型:数值型,布尔型,字符串三种类型匹配,并且保持序列参数和传入变量类型的对应。我们可以对用户函数定义为Numeric或者NumericRef的参数使用Numeric类型的变量作为传入参数;但不能将在定义为NumericSeries类型的参数时传入Numeric。具体的对应关系如下表:
函数参数声明类型 | |
| Numeric,NumericRef,NumericSeries |
| Numeric,NumericRef,NumericSeries |
| |
| |
| |
| |
| String,StringRef,StringSeries |
| String,StringRef,StringSeries |
| |
对于函数的返回值,您也可以将用户函数的Numeric返回值赋值给NumericSeries或NumericRef变量。即在用户函数的返回值使用时,忽略其扩展数据类型。比如我们在调用Average求平均值时,可以这样调用:
Vars Numeric Value1;Begin Value1 = Average(Close,10); ...End
我们也可以按照以下方式进行调用:
Vars NumericSeries Value1;Begin Value1 = Average(CloseTmp,10); ...End
A用户函数调用自身,我们称之为直接递归;A用户函数可以调用B用户函数,同时B用户函数也可以调用A用户函数,对于这种的情况,我们称之为间接递归;
不管是直接递归还是间接递归,用户函数在执行的时候,都可能遇到递归调用没有出口,导致死循环的情况。因此,我们在编写公式的时候,要注意避免使用递归算法,如果一定需要使用递归算法,要注意保证递归算法都有出口。
用默认参数调用用户函数用户函数在被调用的时候,如果传入的参数和参数的默认值一样,可以省略输出参数,使用默认值来调用用户参数。只能够对排列在后面的那些参数使用默认参数,默认参数的定义参见参数。
对于用户函数的直接递归调用,默认参数调用有一些特殊的意义,如下所示,用户函数Fun1:
Params NumericSeries Price(1);Vars Numeric CumValue(0);Begin If(CurrentBar == 0) { CumValue = Price; }else { CumValue = Fun1[1] + Price; } Return CumValue;End
技术指标Ind1调用Fun1的代码如下:
Value1 = Fun1(Close);
以上的用户函数通过默认参数调用Fun1的意思不是调用Fun1(1),而是将Ind1调用Fun1的Close传递下去,即求Fun1(Close)的上一个Bar的值。以上Ind1调用Fun1的计算结果和调用如下的Fun2计算结果一致。
用户函数Fun2:
Params NumericSeries Price(1);Vars Numeric CumValue(0);Begin If(CurrentBar == 0) { CumValue = Price; }else { CumValue = Fun1(Close)[1] + Price; } Return CumValue;End
用户字段用户字段作为一种特殊用途的公式,它主要用于在报价类窗体中使用,最大的特点在于:用户字段不像其他公式,它只需要最后一个Bar的输出数据,而不是所有Bar的输出数据。因此,对于用户字段的处理和其他公式都不相同,我们对用户字段的使用规则归纳如下:
§ 支持三种基本类型的参数定义,支持指定参数默认值;
§ 不支持使用引用参数;
§ 支持六种类型的变量定义,支持指定变量的默认值;
§ 可以访问Data0-Data49个数据源的Bar数据;
§ 可以访问行情数据属性数据;
§ 必须通过FieldNumeric、FieldBool、FieldString返回数据,返回数据类型为三种基本类型的组合;
§ 可以支持Alert来进行报警;
§ 用户字段可以调用所有的用户函数进行计算;
§ 用户字段可以根据设置调用部分的系统函数;
§ 用户字段在执行时,必须要指定相应的数据源和周期,需要调用历史数据的,只有历史数据存在的情况下才能返回正确的值。
例如,用户字段Field1计算最近5个Bar的收盘价的最大价,用户函数Highest计算最大值。脚本如下:
Params Numeric Length(5);Vars Numeric HighValue(0);Begin HighValue = Highest(Close,Length); FieldNumeric("Highest Bar", HighValue);End
在用户字段中只能输出一组数据,该组数据通过FieldNumeric/FieldBool/FieldString的第一个参数:输出值的名称来进行识别,在一个用户字段中,不能出现两个不同的输出值名称,以下为错误的代码:
FieldNumeric("Test1",Close);FieldNumeric("Test2",Open);FieldBool("Test1",True);
以下为正确的代码:
FieldNumeric("Test1",10);FieldBool("Test1",True);FieldString("Test1","Test String");
技术指标技术指标是最常用的一类公式,它通过计算一系列的数学公式,在每个Bar都返回值,这些值在图表模块中输出为线条、柱状图、点等表现形式,通过分析图形特点、走势和曲线帮助客户分析行情走势,得出合理的交易判断。
当技术指标应用在图表中时,您可以设置技术指标各输出值的表现形式,以及颜色、粗细等,如下图的点,线,柱状图所示:
技术指标的使用规则归纳如下:
§ 支持三种基本类型的参数定义,支持指定参数默认值;
§ 不支持使用引用参数;
§ 支持六种类型的变量定义,支持指定变量的默认值;
§ 可以访问Data0-Data49个数据源的Bar数据;
§ 可以访问行情数据、属性数据;
§ 必须通过PlotNumeric、PlotBool、PlotString返回数据,返回数据类型为三种基本类型的组合;
§ 可以输出多组数据,通过PlotNumeric、PlotBool、PlotString的第一个参数,即输出名称来区分输出数据;
§ 可以支持Alert来进行报警;
§ 技术指标可以调用所有的用户函数进行计算;
§ 技术指标可以根据设置调用部分的系统函数;
§ 技术指标在执行时,必须要指定相应的数据源和周期,需要调用历史数据的,只有历史数据存在的情况下才能返回正确的值。
示例,技术指标RSI,脚本如下:
Params Numeric Length(14); Numeric OverSold(20); Numeric OverBought (80);Vars Numeric RSIValue(0); Numeric RSIColor(-1);Begin RSIValue = RSI(Close,Length); If (RSIValue > OverBought) { RSIColor = RED; }Else If (RSIValue < OverSold) { RSIColor = CYAN; } PlotNumeric("RSI1", RSIValue, RSIColor); PlotNumeric("超卖", OverSold); PlotNumeric("超买", OverBought); If CrossOver(RSIValue,OverSold) { Alert("Indicator exiting oversold zone"); } If CrossUnder(RSIValue, OverBought) { Alert("Indicator exiting overbought zone"); }End
技术指标RSI调用RSI内建用户函数计算出结果,然后判断其返回值和超买,超卖的关系,设置显示颜色,并产生报警信息。
技术指标在输出数据时,我们是通过输出值的名称来进行识别,名称相同则认为是一个数据,如下的代码,后面语句的输出数据将会覆盖前面语句的输出数据。
PlotNumeric("Test",10);PlotNumeric("Test",20);
最后"Test"输出的数据为20,而不是10。
K线型态K线型态是另外一种形式的技术分析公式,它对满足设定条件的Bar进行标记,使之醒目,便于客户进行分析。
当K线型态应用在图表中时,您可以设置其输出值的颜色、风格和粗细,如图所示:
K线型态的使用规则归纳如下:
§ 支持三种基本类型的参数定义,支持指定参数默认值;
§ 不支持使用引用参数;
§ 支持六种类型的变量定义,支持指定变量的默认值;
§ 可以访问Data0-Data49个数据源的Bar数据;
§ 可以访问行情数据、属性数据;
§ 必须通过PlotBar返回数据;
§ 只能输出一组数据,用名称进行区分;
§ 可以支持Alert来进行报警;
§ K线型态可以调用所有的用户函数进行计算;
§ K线型态可以根据设置调用部分的系统函数;
§ K线型态在执行时,必须要指定相应的数据源和周期,需要调用历史数据的,只有历史数据存在的情况下才能返回正确的值。
示例,K线型态十字星,脚本如下:
Vars Bool Condition(False);Begin Condition = (Abs(Close-Open)*10<(High-Low)) And (High <> Close) And (Low <> Close); If (Condition) { PlotBar("SZX",High,Low) }End
K线型态十字星判断条件,条件满足的情况下用PlotBar输出信息。
特征走势特征走势是另外一种形式的技术分析公式,它对满足设定条件的Bar进行标记,使之醒目,便于客户进行分析。特征走势和K线型态有很多相似之处,最大的不同在于,K线型态和特征走势的数据输出方式。
当特征走势应用在图表中时,您可以设置其输出值的表现形式,以及颜色、风格和粗细,如图所示:
特征走势的使用规则归纳如下:
§ 支持三种基本类型的参数定义,支持指定参数默认值;
§ 不支持使用引用参数;
§ 支持六种类型的变量定义,支持指定变量的默认值;
§ 可以访问Data0-Data49个数据源的Bar数据;
§ 可以访问行情数据、属性数据;
§ 必须通过PlotNumeric、PlotBool、PlotString返回数据,返回数据类型为三种基本类型的组合;
§ 只能输出一组数据,用名称进行区分;
§ 可以支持Alert来进行报警;
§ 特征走势可以调用所有的用户函数进行计算;
§ 特征走势可以根据设置调用部分的系统函数;
§ 特征走势在执行时,必须要指定相应的数据源和周期,需要调用历史数据的,只有历史数据存在的情况下才能返回正确的值。
示例,特征走势创历史新高,脚本如下:
Params Numeric Length(5);Vars Bool Condition(False);Begin Condition = (High ==Highest(High,Length)) ; If (Condition) { PlotNumeric("CLSXG",High) }End
特征走势创历史新高判断条件,条件满足的情况下用PlotNumeric、PlotBool、PlotString输出信息。
交易指令TradeBlazer公式提供一种简单的方法表达您的交易思想,那就是使用交易指令,一个简单的交易指令如下:
If (Condition) Buy (1,Close);
以上的语句表达的意思是:当某些条件满足了,将用当前Bar的收盘价买入1手指定商品。就像您平时通过经纪商进行交易操作一样,TradeBlazer公式提供四个系统函数和现实中的四种交易动作进行对应,如下:
交易指令的使用规则归纳如下:
§ 支持三种基本类型的参数定义,支持指定参数默认值;
§ 不支持使用引用参数;
§ 支持六种类型的变量定义,支持指定变量的默认值;
§ 可以访问Data0-Data49个数据源的Bar数据;
§ 可以访问行情数据、属性数据;
§ 通过Buy、Sell、SellShort和BuyToCover产生交易动作,也可以使用各种内建平仓指令产生交易动作;
§ 每个交易指令至少包含一个交易动作;
§ 交易指令可以调用所有的用户函数进行计算;
§ 交易指令可以根据设置调用部分的系统函数;
§ 交易指令在执行时,必须要指定相应的数据源和周期,需要调用历史数据的,只有历史数据存在的情况下才能返回正确的值。
示例,交易指令MACD_LE,脚本如下:
Params Numeric FastLength( 12 ); Numeric SlowLength( 26 ); Numeric MACDLength( 9 ); Numeric BuyLots(1);Vars NumericSeries MACDValue; NumericSeries AvgMACD; Numeric MACDDiff; Bool Condition1; Bool Condition2;Begin MACDValue = XAverage( Close, FastLength ) - XAverage( Close, SlowLength ) ; AvgMACD = XAverage(MACDValue,MACDLength); MACDDiff = MACDValue - AvgMACD; Condition1 = CrossOver(MACDValue, AvgMACD) ; Condition2 = MACDValue > 0; if (Condition1 And Condition2) { Buy(BuyLots,Close); }End
MACD_LE在零轴之上,当MACDValue向上穿过AvgMACD值时为产生多头买入指令。
关于Delay默认情况下,4个交易函数产生的委托单即时发送;当参数Delay=True时,委托单将延迟到下一个Bar发送,这样设计的原因在于:只有延迟的委托单才会保证发送的交易指令的正确性。
假定在某商品A的周期为5分钟的数据上应用交易指令,A商品每1秒钟会产生一个Tick数据,因此一段时间内(<5分钟)A商品最后一个Bar的数据的收盘价,最高价,最低价以及成交量等数据,会随着Tick的变化和累计而产生相应的变化。在某种情况下,上一个Tick更新时,Buy的预设条件可能为False,下一个Tick更新时,Buy的预设条件为True。如果不延迟,将会马上发送该委托单到交易所。但是,当更多的Tick累计,产生一个新的Bar时,Buy的预设条件可能会变成False。在这种情况,前面产生的委托单将会丢失,不会在测试和优化报表中出现。该委托单实际上是由于噪音数据产生的错误讯号导致,为了避免这种情况的出现,一定要等最后Bar数据更新结束之后,新Bar产生第一个Tick时,才会发送上一个Bar产生的委托单。
当交易函数的延迟设置为False。将会实时发送产生的委托单,按Tick进行更新。在使用该参数时,需要确认自己所编写的公式不会用到这些无效的中间数据,从而影响交易结果。
注意: Delay参数对交易会产生重要的影响,请在确认理解含义之后才进行真实的交易。