Aller au contenu

Méthode Chartshot

Ce guide explique comment utiliser la méthode TakeChartshot() lors de la création d'algorithmes cTrader. Si vous êtes impatient de commencer, lisez simplement notre résumé d'une minute ci-dessous.

Les méthodes Chartshot en une minute !

  • La méthode TakeChartshot() permet aux algorithmes cTrader de prendre des Chartshots des graphiques sur lesquels ils s'exécutent, mais uniquement si ce graphique est visible.
  • Les Chartshots sont un excellent outil pour communiquer avec d'autres traders et partager des analyses techniques. Avec la méthode TakeChartshot(), ce processus devient beaucoup plus facile.
  • La méthode TakeChartshot() renvoie un tableau d'octets, ce qui signifie que vous pouvez facilement partager des Chartshots sous forme de fichiers .PNG. Vous pouvez également partager le Chartshot sur Internet en utilisant la fonctionnalité d'accès réseau.
  • La méthode TakeChartshot() est essentielle si vous souhaitez créer des Chartshots chaque fois que vos algorithmes font quelque chose (par exemple, lorsqu'un cBot passe un ordre). Cette fonctionnalité fournit une aide visuelle précieuse pour quiconque souhaite évaluer les performances de ses solutions sans garder un œil sur le graphique 24h/24 et 7j/7.

Utilisation de la méthode TakeChartshot()

Les Chartshots offrent un moyen de créer rapidement des captures d'écran de graphiques de trading. Si vous créez un Chartshot manuellement via la barre d'outils cTrader, la capture d'écran est enregistrée sur votre machine locale en plus d'être automatiquement téléchargée sur un portail spécial qui offre plusieurs façons de la partager (par exemple, via du code HTML intégrable).

À son tour, notre API permet de créer des Chartshots automatiquement. Contrairement aux Chartshots ordinaires, les Chartshots créés par les algorithmes cTrader ne sont enregistrés nulle part par défaut. Au lieu de cela, ces Chartshots sont renvoyés sous forme de tableaux d'octets que vous êtes libre d'enregistrer où vous le souhaitez en spécifiant une action supplémentaire dans le code.

La méthode byte[] TakeChartshot() fonctionne comme suit :

  • byte[] TakeChartshot(). Prend un Chartshot du graphique sur lequel l'algorithme s'exécute et le renvoie sous forme de tableau d'octets.

Notez que la méthode ne fonctionne que si un graphique est visible. Pour permettre de vérifier facilement la visibilité du graphique, l'interface Chart inclut la propriété IsVisible. Elle est égale à true pour un graphique visible et false pour un graphique invisible.

Chartshots dans le backtesting et l'optimisation

  • Dans l'optimisation et le backtesting non visuel, la méthode TakeChartshot() renvoie toujours null et invoque le gestionnaire OnException() si vous l'avez spécifié.
  • Dans le backtesting en mode visuel, la méthode fonctionne comme prévu.

Créer un exemple de cBot

Pour démontrer comment fonctionne la prise de Chartshots, nous allons créer un cBot simple qui créera un chartshot du graphique actuel et l'enregistrera dans le système de fichiers de votre machine locale.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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);

            }
        }
    }
}

Au démarrage, le fichier .PNG contenant le chartshot du graphique auquel nous avons attaché l'instance du cBot sera ajouté à D://examplePath/.

Résumé

La méthode TakeChartshot() permet aux algorithmes cTrader de créer des Chartshots facilement partageables, ce qui la rend essentielle pour quiconque souhaite partager des informations avec d'autres traders ou suivre les performances de ses solutions automatisées en réponse à certaines conditions. Cette méthode est également utilisable dans le backtesting visuel, vous permettant de faire correspondre facilement les actions de vos cBots aux événements se produisant sur les graphiques.