Método Chartshot

Esta guía de usuario explica cómo usar el método TakeChartshot() al crear algos de cTrader. Si está ansioso por comenzar, simplemente lea nuestro resumen de un minuto a continuación.

¡Métodos de Chartshot en un minuto!

El método TakeChartshot() permite a los algos de cTrader tomar Chartshots de los gráficos en los que se están ejecutando, pero solo si este gráfico es visible.
Los Chartshots son una gran herramienta para comunicarse con otros operadores y compartir análisis técnicos. Con el método TakeChartshot(), este proceso se vuelve mucho más fácil.
El método TakeChartshot() devuelve una matriz de bytes, lo que significa que puede compartir fácilmente Chartshots como archivos .PNG. También puede compartir el Chartshot en Internet usando la función de acceso a la red.
El método TakeChartshot() es esencial si desea hacer Chartshots cada vez que sus algos hacen algo (como cuando un cBot coloca una orden). Esta función proporciona una gran ayuda visual para cualquiera que quiera evaluar cómo se desempeñan sus soluciones sin tener que estar pendiente del gráfico las 24 horas del día, los 7 días de la semana.

Usando el método TakeChartshot()

Los Chartshots ofrecen una forma de crear rápidamente capturas de pantalla de gráficos de operaciones. Si crea un Chartshot manualmente a través de la barra de herramientas de cTrader, la captura de pantalla se guarda en su máquina local además de cargarse automáticamente en un portal especial que ofrece varias formas de compartirla (por ejemplo, a través de código HTML incrustable).

A su vez, nuestra API permite hacer Chartshots automáticamente. A diferencia de los Chartshots regulares, los Chartshots hechos por algos de cTrader no se guardan en ningún lugar por defecto. En su lugar, dichos Chartshots se devuelven como matrices de bytes que usted es libre de guardar donde quiera especificando una acción adicional en el código.

El método byte[] TakeChartshot() funciona de la siguiente manera:

byte[] TakeChartshot(). Toma un Chartshot del gráfico en el que se está ejecutando el algoritmo y lo devuelve como una matriz de bytes.

Tenga en cuenta que el método solo funciona si un gráfico es visible. Para permitir verificar fácilmente la visibilidad del gráfico, la interfaz Chart incluye la propiedad IsVisible. Es igual a true para un gráfico visible y false para uno invisible.

Chartshots en backtesting y optimización

En la optimización y el backtesting no visual, el método TakeChartshot() siempre devuelve null e invoca el manejador OnException() si lo ha especificado.
En el backtesting en modo visual, el método funciona como se espera.

Crear un cBot de ejemplo

Para demostrar cómo funciona la toma de Chartshots, crearemos un cBot simple que hará un chartshot del gráfico actual y lo guardará en el sistema de archivos de su máquina local.

using System;
using System.IO;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using cAlgo.API;
using cAlgo.API.Collections;
using cAlgo.API.Indicators;
using cAlgo.API.Internals;

namespace cAlgo.Robots
{
    [Robot(AccessRights = AccessRights.FullAccess)]
    public class ChartshotTest : Robot
    {
        protected override void OnStart()
        {
            if (Chart.IsActive)
            {
                var chartshot = Chart.TakeChartshot();

                File.WriteAllBytes(@"D://examplePath/chartshot.png", chartshot);

            }
        }
    }
}

Al inicio, el archivo .PNG que contiene el chartshot del gráfico al que hemos adjuntado la instancia del cBot se agregará a D://examplePath/.

Resumen

El método TakeChartshot() permite a los algos de cTrader hacer Chartshots fácilmente compartibles, lo que lo hace esencial para cualquiera que quiera compartir información con otros operadores o rastrear cómo se desempeñan sus soluciones automatizadas en respuesta a ciertas condiciones. Este método también se puede utilizar en el backtesting visual, lo que le permite comparar fácilmente las acciones de sus cBots con los eventos que ocurren en los gráficos.