发明者量化-小小梦
Utilice la función KLineChart para facilitar el diseño de dibujos de estrategias
3
2617
Utilice la función KLineChart para facilitar el diseño de dibujos de estrategias
Al diseñar una estrategia, a menudo es necesario diseñar un gráfico de visualización de la estrategia cuando se utiliza JavaScript o Python para escribir la estrategia. Los usuarios que no están familiarizados con la programación o la biblioteca de gráficos utilizada por la plataforma FMZ a menudo tienen dificultades con el diseño del código para dibujar en gráficos personalizados. Entonces, ¿cómo podemos dibujar un diagrama de estrategia con contenido enriquecido escribiendo solo una pequeña cantidad de código?
Este método de dibujo simple pero poderoso se puede ver en el lenguaje Pine, que es famoso por sus ricas funciones de dibujo. Si la interfaz de dibujo del lenguaje Pine se puede conectar a las estrategias de los lenguajes JavaScript y Python, facilitará enormemente a los desarrolladores diseñar la función de dibujo de la estrategia. En base a esta demanda, la plataforma FMZ actualizó la función de dibujo personalizado y amplió su uso.KLineChartLa función realiza el dibujo de gráficos personalizados. Puede consultar la documentación de la API: https://www.fmz.com/api#klinechart
Utilicemos JavaScript para escribir un ejemplo simple para realizar una transición.
Ejemplo sencillo
/*backtest
start: 2022-03-21 09:00:00
end: 2022-06-21 15:00:00
period: 30m
basePeriod: 15m
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/
function main() {
var c = KLineChart()
while (true) {
var bars = _C(exchange.GetRecords)
for (var i = 0 ; i < bars.length ; i++) {
var bar = bars[i]
c.begin(bar)
c.plot(bar.Volume, "volume")
c.close()
}
Sleep(1000)
}
}
Este ejemplo es muy simple. Simplemente dibuja un gráfico de velas en el área de dibujo personalizada de la estrategia y dibuja una curva de volumen correspondiente a cada barra de velas en la posición del subgráfico del gráfico.
En el código que usamos primerovar c = KLineChart()Cree un objeto gráfico y luego llame a sus métodos para dibujar. Luego, en el bucle obtenemos los datos de la línea K (estructura de la matriz) y recorremos la matriz de la línea K. Puede utilizar un bucle for simple para recorrer como en el ejemplo, o puede utilizar otros métodos para recorrer.
Las operaciones de dibujo deben realizarse desdec.begin(bar)La función se inicia,c.close()La función finaliza.begin、closeLas funciones son métodos del objeto gráfico c. A continuación, utilice la función de dibujo más utilizadaplotDibuje la curva de volumen en cada BARRA.
Un ejemplo más complejo
Supongamos que queremos diseñar un gráfico con indicadores de Bollinger. ¡Oh sí! También es necesario adjuntar un gráfico de volumen para cada BAR, que puede diseñarse de la siguiente manera:
/*backtest
start: 2022-03-21 09:00:00
end: 2022-06-21 15:00:00
period: 1d
basePeriod: 1h
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/
function main() {
var c = KLineChart()
// 策略主循环
while(true) {
// 轮询间隔
Sleep(500)
// 获取K线数据
let bars = exchange.GetRecords()
if (!bars || bars.length <= 20) {
continue
}
// 计算布林指标
var boll = TA.BOLL(bars)
bars.forEach(function(bar, index) {
c.begin(bar)
// 画图操作
c.plot(boll[0][index], "Boll_Up", {overlay: true}) // 画在图表主图
c.plot(boll[1][index], "Boll_Mid", {overlay: true}) // 画在图表主图
c.plot(boll[2][index], "Boll_Down", {overlay: true}) // 画在图表主图
c.plot(bar.Volume, "volume") // 画在图表副图
c.close()
})
// 策略交易逻辑
// ...
// ..
}
}
Puedes ver en el código que nuestra información de configuración de backtest en la plataforma FMZ es:
/*backtest
start: 2022-03-21 09:00:00
end: 2022-06-21 15:00:00
period: 1d
basePeriod: 1h
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/
Esta configuración se ha probado en backtest utilizando el objeto de intercambio al contado de Binance. Los resultados de la prueba retrospectiva se muestran en la figura:
Se puede ver que utilizamos el método de dibujo de Pine para simplificar en gran medida el código de dibujo en lenguaje JavaScript.
Escribe indicadores y otros datos para dibujar imágenes.
Operaciones como la obtención de datos de la línea K y el cálculo de indicadores son comunes y muy simples en los ejemplos de estrategia y documentos API del cuadro de estrategia de la plataforma.
// 获取K线数据
let bars = exchange.GetRecords()
if (!bars || bars.length <= 20) {
// 如果获取K线失败，即!bar为真则执行continue，忽略之后的代码，重新执行循环
// 如果bars.length小于等于20，即K线BAR（柱）数量小于20，无法计算指标，也执行continue
continue
}
// 计算布林指标
var boll = TA.BOLL(bars)
Función de cálculo del indicador de Bollinger TA.BOLL, si no especifica los parámetros del indicador de Bollinger, se utilizan los parámetros predeterminadosBOLL(20, 2). El indicador Bollinger tiene tres líneas, por lo que los datos devueltos por la función TA.BOLL son una matriz bidimensional. cápsula[0]、boll[1]、boll[2] son los tres elementos de la matriz boll, cada uno de los cuales representa una línea y es una matriz.
- boll[0]: Bandas de Bollinger en línea
- boll[1]: Línea media de las bandas de Bollinger
- boll[2]: Las bandas de Bollinger bajan
A continuación veremos cómo dibujar el volumen de los datos de la línea K, es decir, el volumen de negociación, y los datos calculados del indicador Bollinger en el gráfico.
Dibujamos los datos de la línea K barra por barra, por lo que necesitamos recorrer toda la matriz de la línea K, es decir, recorrer la matriz de barras en el código. Aquí usamosforEachEl recorrido del método también se puede realizar mediante el bucle for.
bars.forEach(function(bar, index) {
c.begin(bar)
// 画图操作
c.plot(boll[0][index], "Boll_Up", {overlay: true}) // {overlay: true}参数控制，画在图表主图
c.plot(boll[1][index], "Boll_Mid", {overlay: true}) // 画在图表主图
c.plot(boll[2][index], "Boll_Down", {overlay: true}) // 画在图表主图
c.plot(bar.Volume, "volume") // 画在图表副图
c.close()
})
Se debe tener en cuenta que cada vez que comience a dibujar un gráfico en una barra, primero debec.begin(bar)Llamadas de función,beginUna función es un método de nuestro objeto gráfico c. Cuando finalice la operación de dibujo, deberá llamarc.close(). existirbeginFunciones ycloseEntre las funciones se encuentran las funciones de dibujo que llamamos que son similares al método de dibujo del lenguaje Pine. apoyo:barcolor bgcolor plot fill hline plotarrow plotshape plotchar plotcandle signal, puedes dibujar líneas, flechas, marcar información, etc. Los parámetros de estas funciones son consistentes con los parámetros de función correspondientes del lenguaje Pine, y las funciones de dibujo también son consistentes.
Se agregaron flechas de señales comerciales, marcadores, líneas horizontales, etc.
Agregue algunas flechas de señales comerciales, marcadores y líneas horizontales al ejemplo de dibujo del indicador de Bollinger anterior.
/*backtest
start: 2022-03-21 09:00:00
end: 2022-06-21 15:00:00
period: 1d
basePeriod: 1h
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/
function main() {
var c = KLineChart()
// 策略主循环
while(true) {
// 轮询间隔
Sleep(500)
// 获取K线数据
let bars = exchange.GetRecords()
if (!bars || bars.length <= 20) {
continue
}
// 计算布林指标
var boll = TA.BOLL(bars)
bars.forEach(function(bar, index) {
c.begin(bar)
// 画图操作
c.plot(boll[0][index], "Boll_Up", {overlay: true}) // 画在图表主图
c.plot(boll[1][index], "Boll_Mid", {overlay: true}) // 画在图表主图
c.plot(boll[2][index], "Boll_Down", {overlay: true}) // 画在图表主图
c.plot(bar.Volume, "volume") // 画在图表副图
c.hline(bar.Open, {overlay: true}) // 水平线
c.plotarrow(bar.Close - bar.Open, {overlay: true}) // 箭头
c.plotshape(bar.Close - bar.Open > 0, {style: 'square', overlay: true}) // 画方块标记
c.plotchar(bar.Close - bar.Open < 0, {char: '❄', size: "20px", overlay: true}) // 画出字符❄
if (boll[0][index] && bar.Close > boll[0][index]) {
c.signal("long", bar.Close, 1.5)
} else if (boll[2][index] && bar.Close < boll[2][index]) {
c.signal("closelong", bar.Close, 1.5)
}
c.close()
})
// 策略交易逻辑
// ...
// ..
}
}
Dado que la operación de orden de estrategia del lenguaje Pine marcará automáticamente la señal en el gráfico,KLineChartEl objeto gráfico creado por la función también se amplía con una función para dibujar marcadores de señales de compra y venta:c.signal。
Objeto de configuración de gráfico
Puede declarar una estructura para configurar el estilo del gráfico. Por ejemplo, la siguiente variable chartCfg representa la información de configuración de una línea de cuadrícula.
var chartCfg = {
grid: {
show: true,
// 网格水平线
horizontal: {
show: true,
size: 2,
color: '#FF0000', // 水平网格线的颜色
// 'solid'|'dash'
style: 'dash', // 线的类型
dashValue: [2, 2]
},
// 网格垂直线
vertical: {
show: true,
size: 2,
color: '#32CD32',
// 'solid'|'dash'
style: 'solid',
dashValue: [2, 2]
}
},
}
El objeto de configuración de gráfico es una estructura de datos que establece algunas propiedades y la apariencia del gráfico. Por ejemplo, en el ejemplo se utiliza una configuración de estilo de línea de cuadrícula. También hay muchas opciones que se pueden configurar y modificar, como las configuraciones relacionadas del eje X y el eje Y, las configuraciones de la línea del cursor, las configuraciones de la información del mensaje, las configuraciones del estilo del indicador técnico, la configuraciones del estilo BAR de K-line, etc.
Por supuesto, si no estás familiarizado con estos,KLineChartNo es necesario pasar el objeto de configuración del gráfico a la función al crear un objeto de gráfico. El gráfico creado es del estilo predeterminado. Utilizando las funciones API de la plataforma FMZKLineChartFunción para crear un objeto gráfico:
var c = KLineChart(chartCfg)
Código de prueba para dibujar líneas de cuadrícula:
/*backtest
start: 2022-03-21 09:00:00
end: 2022-06-21 15:00:00
period: 1d
basePeriod: 1h
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/
function main() {
var chartCfg = {
grid: {
show: true,
// 网格水平线
horizontal: {
show: true,
size: 2,
color: '#FF0000',
// 'solid'|'dash'
style: 'dash',
dashValue: [2, 2]
},
// 网格垂直线
vertical: {
show: true,
size: 2,
color: '#32CD32',
// 'solid'|'dash'
style: 'solid',
dashValue: [2, 2]
}
},
}
var c = KLineChart(chartCfg)
// 策略主循环
while(true) {
// 轮询间隔
Sleep(500)
// 获取K线数据
var bars = _C(exchange.GetRecords)
bars.forEach(function(bar, index) {
c.begin(bar)
c.close()
})
// 策略交易逻辑
// ...
// ..
}
}
Ejemplo de estilo de configuración de gráfico
Se puede utilizar para hacer referencia a la configuración del estilo de configuración del gráfico.
{
// 网格线
grid: {
show: true,
// 网格水平线
horizontal: {
show: true,
size: 1,
color: '#393939',
// 'solid'|'dash'
style: 'dash',
dashValue: [2, 2]
},
// 网格垂直线
vertical: {
show: false,
size: 1,
color: '#393939',
// 'solid'|'dash'
style: 'dash',
dashValue: [2, 2]
}
},
// 蜡烛图
candle: {
// 蜡烛图上下间距，大于1为绝对值，大于0小余1则为比例
margin: {
top: 0.2,
bottom: 0.1
},
// 蜡烛图类型 'candle_solid'|'candle_stroke'|'candle_up_stroke'|'candle_down_stroke'|'ohlc'|'area'
type: 'candle_solid',
// 蜡烛柱
bar: {
upColor: '#26A69A',
downColor: '#EF5350',
noChangeColor: '#888888'
},
// 面积图
area: {
lineSize: 2,
lineColor: '#2196F3',
value: 'close',
backgroundColor: [{
offset: 0,
color: 'rgba(33, 150, 243, 0.01)'
}, {
offset: 1,
color: 'rgba(33, 150, 243, 0.2)'
}]
},
priceMark: {
show: true,
// 最高价标记
high: {
show: true,
color: '#D9D9D9',
textMargin: 5,
textSize: 10,
textFamily: 'Helvetica Neue',
textWeight: 'normal'
},
// 最低价标记
low: {
show: true,
color: '#D9D9D9',
textMargin: 5,
textSize: 10,
textFamily: 'Helvetica Neue',
textWeight: 'normal',
},
// 最新价标记
last: {
show: true,
upColor: '#26A69A',
downColor: '#EF5350',
noChangeColor: '#888888',
line: {
show: true,
// 'solid'|'dash'
style: 'dash',
dashValue: [4, 4],
size: 1
},
text: {
show: true,
size: 12,
paddingLeft: 2,
paddingTop: 2,
paddingRight: 2,
paddingBottom: 2,
color: '#FFFFFF',
family: 'Helvetica Neue',
weight: 'normal',
borderRadius: 2
}
}
},
// 提示
tooltip: {
// 'always' | 'follow_cross' | 'none'
showRule: 'always',
// 'standard' | 'rect'
showType: 'standard',
labels: ['时间', '开', '收', '高', '低', '成交量'],
values: null,
defaultValue: 'n/a',
rect: {
paddingLeft: 0,
paddingRight: 0,
paddingTop: 0,
paddingBottom: 6,
offsetLeft: 8,
offsetTop: 8,
offsetRight: 8,
borderRadius: 4,
borderSize: 1,
borderColor: '#3f4254',
backgroundColor: 'rgba(17, 17, 17, .3)'
},
text: {
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
color: '#D9D9D9',
marginLeft: 8,
marginTop: 6,
marginRight: 8,
marginBottom: 0
}
}
},
// 技术指标
technicalIndicator: {
margin: {
top: 0.2,
bottom: 0.1
},
bar: {
upColor: '#26A69A',
downColor: '#EF5350',
noChangeColor: '#888888'
},
line: {
size: 1,
colors: ['#FF9600', '#9D65C9', '#2196F3', '#E11D74', '#01C5C4']
},
circle: {
upColor: '#26A69A',
downColor: '#EF5350',
noChangeColor: '#888888'
},
// 最新值标记
lastValueMark: {
show: false,
text: {
show: false,
color: '#ffffff',
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
paddingLeft: 3,
paddingTop: 2,
paddingRight: 3,
paddingBottom: 2,
borderRadius: 2
}
},
// 提示
tooltip: {
// 'always' | 'follow_cross' | 'none'
showRule: 'always',
// 'standard' | 'rect'
showType: 'standard',
showName: true,
showParams: true,
defaultValue: 'n/a',
text: {
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
color: '#D9D9D9',
marginTop: 6,
marginRight: 8,
marginBottom: 0,
marginLeft: 8
}
}
},
// x轴
xAxis: {
show: true,
height: null,
// x轴线
axisLine: {
show: true,
color: '#888888',
size: 1
},
// x轴分割文字
tickText: {
show: true,
color: '#D9D9D9',
family: 'Helvetica Neue',
weight: 'normal',
size: 12,
paddingTop: 3,
paddingBottom: 6
},
// x轴分割线
tickLine: {
show: true,
size: 1,
length: 3,
color: '#888888'
}
},
// y轴
yAxis: {
show: true,
width: null,
// 'left' | 'right'
position: 'right',
// 'normal' | 'percentage' | 'log'
type: 'normal',
inside: false,
reverse: false,
// y轴线
axisLine: {
show: true,
color: '#888888',
size: 1
},
// y轴分割文字
tickText: {
show: true,
color: '#D9D9D9',
family: 'Helvetica Neue',
weight: 'normal',
size: 12,
paddingLeft: 3,
paddingRight: 6
},
// y轴分割线
tickLine: {
show: true,
size: 1,
length: 3,
color: '#888888'
}
},
// 图表之间的分割线
separator: {
size: 1,
color: '#888888',
fill: true,
activeBackgroundColor: 'rgba(230, 230, 230, .15)'
},
// 十字光标
crosshair: {
show: true,
// 十字光标水平线及文字
horizontal: {
show: true,
line: {
show: true,
// 'solid'|'dash'
style: 'dash',
dashValue: [4, 2],
size: 1,
color: '#888888'
},
text: {
show: true,
color: '#D9D9D9',
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
paddingLeft: 2,
paddingRight: 2,
paddingTop: 2,
paddingBottom: 2,
borderSize: 1,
borderColor: '#505050',
borderRadius: 2,
backgroundColor: '#505050'
}
},
// 十字光标垂直线及文字
vertical: {
show: true,
line: {
show: true,
// 'solid'|'dash'
style: 'dash',
dashValue: [4, 2],
size: 1,
color: '#888888'
},
text: {
show: true,
color: '#D9D9D9',
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
paddingLeft: 2,
paddingRight: 2,
paddingTop: 2,
paddingBottom: 2,
borderSize: 1,
borderColor: '#505050',
borderRadius: 2,
backgroundColor: '#505050'
}
}
},
// 图形
shape: {
point: {
backgroundColor: '#2196F3',
borderColor: '#2196F3',
borderSize: 1,
radius: 4,
activeBackgroundColor: '#2196F3',
activeBorderColor: '#2196F3',
activeBorderSize: 1,
activeRadius: 6
},
line: {
// 'solid'|'dash'
style: 'solid'
color: '#2196F3',
size: 1,
dashValue: [2, 2]
},
polygon: {
// 'stroke'|'fill'
style: 'stroke',
stroke: {
// 'solid'|'dash'
style: 'solid',
size: 1,
color: '#2196F3',
dashValue: [2, 2]
},
fill: {
color: 'rgba(33, 150, 243, 0.1)'
}
},
arc: {
// 'stroke'|'fill'
style: 'stroke',
stroke: {
// 'solid'|'dash'
style: 'solid',
size: 1,
color: '#2196F3',
dashValue: [2, 2]
},
fill: {
color: '#2196F3'
}
},
text: {
style: 'fill',
color: '#2196F3',
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
offset: [0, 0]
}
},
annotation: {
// 'top' | 'bottom' | 'point'
position: 'top',
offset: [20, 0]
symbol: {
// 'diamond' | 'circle' | 'rect' | 'triangle' | 'custom' | 'none'
type: 'diamond',
size: 8,
color: '#2196F3',
activeSize: 10,
activeColor: '#FF9600'
}
},
tag: {
// 'top' | 'bottom' | 'point'
position: 'point',
offset: 0,
line: {
show: true,
style: LineStyle.DASH,
dashValue: [4, 2],
size: 1,
color: '#2196F3'
},
text: {
color: '#FFFFFF',
backgroundColor: '#2196F3',
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
paddingLeft: 2,
paddingRight: 2,
paddingTop: 2,
paddingBottom: 2,
borderRadius: 2,
borderSize: 1,
borderColor: '#2196F3'
},
mark: {
offset: 0,
color: '#FFFFFF',
backgroundColor: '#2196F3',
size: 12,
family: 'Helvetica Neue',
weight: 'normal',
paddingLeft: 2,
paddingRight: 2,
paddingTop: 2,
paddingBottom: 2,
borderRadius: 2,
borderSize: 1,
borderColor: '#2196F3'
}
}
}
¿No hace esto más fácil el diseño y la elaboración de estrategias?