Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Strategy Tester

Frames MQL5 : exporter les résultats d’optimisation avec FrameAdd et OnTesterPass

Envoyer des données de chaque passe d’optimisation au terminal avec FrameAdd, les lire dans OnTesterPass avec FrameNext et FrameInputs, et les exporter en CSV : exemple MQL5 complet.

Mis à jour le 23 octobre 2026Lecture : 9 minPar Alix, OptiBot Trading

Les frames (« cadres ») sont le mécanisme de MQL5 qui permet à chaque passe d’une optimisation d’envoyer des données au terminal, au-delà du simple score affiché dans le tableau des résultats. Sur l’agent, à la fin de la passe, FrameAdd() emballe un nom, un identifiant, une valeur et un tableau de données ; sur le terminal, l’Expert Advisor reçoit ces frames dans OnTesterPass() au fil de l’optimisation, les lit avec FrameNext() et récupère les paramètres de la passe avec FrameInputs(). C’est la méthode adaptée pour exporter vers un fichier CSV des statistiques sur mesure, y compris quand les passes tournent sur des agents distants ou dans le MQL5 Cloud Network.

Cette page fait partie de la rubrique Strategy Tester et optimisation. Elle suppose connue la fonction OnTester, d’où les frames sont envoyées.

Pourquoi ne pas écrire directement dans un fichier

Pendant un test, chaque agent travaille dans son propre bac à sable de fichiers (<agent>/MQL5/Files). Un fichier écrit par une passe reste donc sur l’agent, et les agents distants ou du cloud ne renvoient pas vos fichiers. La documentation MQL5 recommande d’ailleurs, pour le MQL5 Cloud Network, d’envoyer des frames plutôt que d’écrire sur disque. Les frames voyagent avec le résultat de la passe jusqu’au terminal, quel que soit l’agent.

Les fonctions et événements en jeu

ÉlémentOù il s’exécuteRôle
OnTester() + FrameAdd()Agent, fin de chaque passeCréer et envoyer une frame
OnTesterInit()Terminal, avant la première passePréparer la réception (ouvrir un fichier…)
OnTesterPass()Terminal, à la réception de framesLire et traiter les frames arrivées
OnTesterDeinit()Terminal, après la dernière passeTraitement final, fermeture
FrameNext(), FrameFirst(), FrameFilter()TerminalParcourir les frames reçues
FrameInputs()TerminalParamètres d’entrée de la passe d’origine

Les signatures, d’après la documentation :

bool FrameAdd(const string name, long id, double value, const void &data[]);
bool FrameAdd(const string name, long id, double value, const string filename);

bool FrameNext(ulong &pass, string &name, long &id, double &value);
bool FrameNext(ulong &pass, string &name, long &id, double &value, void &data[]);

bool FrameInputs(ulong pass, string &parameters[], uint &parameters_count);
bool FrameFirst();
bool FrameFilter(const string name, long id);

Au démarrage de l’optimisation, un Expert Advisor qui déclare OnTesterPass() ou OnTesterDeinit() est automatiquement chargé sur un graphique séparé du terminal, avec le symbole et la période du test. C’est cette instance qui reçoit les frames ; pendant ce temps, les passes s’exécutent sur les agents. MQLInfoInteger(MQL_FRAME_MODE) vaut true dans cette instance de collecte.

FrameInputs() renvoie les paramètres sous forme de chaînes "nom=valeur". FrameFilter("", ULONG_MAX) équivaut à FrameFirst(), c’est-à-dire à l’absence de filtre.

Exemple complet : exporter chaque passe dans un CSV

Cet Expert Advisor envoie, à la fin de chaque passe, un tableau de statistiques ; le terminal les écrit au fur et à mesure dans optim_passes.csv, avec les paramètres de la passe.

//+------------------------------------------------------------------+
//| Export des passes d'optimisation via les frames                  |
//+------------------------------------------------------------------+
input int    InpFast = 10;      // Paramètres optimisés (exemple)
input int    InpSlow = 50;

#define FRAME_ID 1              // identifiant public de nos frames

int g_fichier = INVALID_HANDLE; // fichier ouvert côté terminal

//--- côté agent ----------------------------------------------------
int OnInit()
  {
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   // ... logique de trading utilisant InpFast et InpSlow ...
  }

double OnTester()
  {
   double stats[6];
   stats[0] = TesterStatistics(STAT_PROFIT);
   stats[1] = TesterStatistics(STAT_TRADES);
   stats[2] = TesterStatistics(STAT_PROFIT_FACTOR);
   stats[3] = TesterStatistics(STAT_EQUITY_DDREL_PERCENT);
   stats[4] = TesterStatistics(STAT_RECOVERY_FACTOR);
   stats[5] = TesterStatistics(STAT_SHARPE_RATIO);

   double score = stats[0] / MathMax(TesterStatistics(STAT_EQUITY_DD), 1.0);

   // Envoi au terminal : nom, id, valeur, tableau de données
   if(!FrameAdd("stats", FRAME_ID, score, stats))
      Print("FrameAdd a échoué, erreur ", GetLastError());
   return(score);
  }

//--- côté terminal -------------------------------------------------
int OnTesterInit()
  {
   g_fichier = FileOpen("optim_passes.csv", FILE_WRITE | FILE_CSV | FILE_ANSI, ';');
   if(g_fichier == INVALID_HANDLE)
      return(INIT_FAILED);            // l'optimisation ne démarre pas
   FileWrite(g_fichier, "passe", "parametres", "score", "profit", "trades",
             "pf", "dd_eq_pct", "recovery", "sharpe");
   return(INIT_SUCCEEDED);
  }

void OnTesterPass()
  {
   ulong  pass;
   string name;
   long   id;
   double value;
   double data[];

   // Lit toutes les frames arrivées depuis le dernier appel
   while(FrameNext(pass, name, id, value, data))
     {
      if(id != FRAME_ID || ArraySize(data) < 6)
         continue;

      string params[];
      uint   nb = 0;
      string texte = "";
      if(FrameInputs(pass, params, nb))
         for(uint i = 0; i < nb; i++)
            texte += (i > 0 ? " " : "") + params[i];   // "nom=valeur"

      FileWrite(g_fichier, (long)pass, texte, value,
                data[0], data[1], data[2], data[3], data[4], data[5]);
     }
  }

void OnTesterDeinit()
  {
   if(g_fichier != INVALID_HANDLE)
     {
      FileClose(g_fichier);
      g_fichier = INVALID_HANDLE;
     }
   Print("Export terminé : MQL5\\Files\\optim_passes.csv");
  }

FrameInputs() renvoie tous les paramètres d’entrée, pas seulement ceux qui sont optimisés. Le fichier est créé dans le dossier MQL5\Files du terminal, car OnTesterInit(), OnTesterPass() et OnTesterDeinit() s’exécutent sur le terminal. Ouvrez-le ensuite dans un tableur ou avec Python pour tracer des cartes de sensibilité plus riches que le graphique du testeur.

Relire toutes les frames en fin d’optimisation

OnTesterPass() traite les frames au fil de l’eau, mais certains calculs n’ont de sens qu’une fois toutes les passes terminées : rang de chaque passe, médiane des scores, recherche de la zone de paramètres la plus stable. Dans OnTesterDeinit(), appelez FrameFirst() pour replacer le pointeur de lecture au début, puis parcourez de nouveau toutes les frames avec FrameNext(). Si vous envoyez plusieurs types de frames (par exemple des statistiques sous le nom « stats » et une courbe d’equity sous le nom « courbe »), FrameFilter("courbe", 2) limite la lecture aux frames portant ce nom et cet identifiant. Passer une chaîne vide comme nom ne filtre que sur l’identifiant ; passer ULONG_MAX comme identifiant ne filtre que sur le nom.

Cette relecture complète est aussi le bon endroit pour écrire un fichier de synthèse distinct du fichier brut : la liste des dix meilleures passes selon votre score, ou la moyenne du score par valeur de chaque paramètre, qui révèle immédiatement les paramètres auxquels la stratégie est sensible.

Envoyer un fichier plutôt qu’un tableau

La seconde forme de FrameAdd() accepte un nom de fichier au lieu d’un tableau. Le fichier doit se trouver dans le dossier MQL5/Files de l’agent, donc avoir été écrit par la passe elle-même, par exemple un journal détaillé des trades. Son contenu est transmis dans la frame et récupéré côté terminal dans le tableau data[] de FrameNext(), sous forme d’octets : déclarez alors un tableau uchar et réécrivez-le dans un fichier avec FileWriteArray(). Réservez cette méthode aux passes que vous voulez réellement analyser en détail, par exemple en ne l’activant que lorsque le score dépasse un seuil, sous peine de transférer des volumes considérables.

Ce que permettent les frames

  • Exporter des statistiques absentes du tableau : Z-Score recalculé, durée moyenne en drawdown, profit par année, ratio long/short.
  • Envoyer la courbe d’equity de chaque passe : un tableau de valeurs échantillonnées par jour ou par semaine, pour comparer visuellement les courbes des meilleures passes et détecter celles qui doivent tout à une seule période.
  • Suivre l’optimisation en direct : OnTesterPass() étant appelée au fil de l’eau, vous pouvez afficher sur le graphique la meilleure passe trouvée à ce stade.
  • Alimenter une analyse de robustesse : l’export brut de toutes les passes est la matière première d’une recherche de plateaux, que l’on prolonge avec le walk-forward.

La lecture et l’écriture de fichiers en MQL5 sont détaillées dans Sauvegarder l’état dans des fichiers.

Pièges fréquents

  • Oublier qu’OnTester() tourne sur l’agent. Y ouvrir le fichier d’export écrirait dans le bac à sable de l’agent, pas sur votre terminal.
  • Envoyer des frames trop lourdes. Chaque frame voyage sur le réseau et s’accumule sur le terminal ; une courbe tick par tick sur des milliers de passes devient vite ingérable. Échantillonnez.
  • Ne pas tester en passe simple. En test simple, OnTesterPass() n’est pas appelée : déboguez l’envoi avec une petite optimisation de quelques passes.
  • Mal interpréter l’ordre d’arrivée. Les frames arrivent dans l’ordre où les agents terminent, pas dans l’ordre des numéros de passe ; triez le fichier ensuite.
  • Compter sur Print() côté agent. En optimisation, Print() n’est pas exécutée hors OnInit(), et les agents distants n’ajoutent pas ces messages au journal.
Exporter toutes les passes donne une vision plus complète de l’optimisation, mais n’en change pas la nature : ce sont des résultats passés. Une stratégie doit être validée hors échantillon et en démo avant toute utilisation sur un compte réel.

FAQ

Où est créé le fichier écrit dans OnTesterPass ?

Dans le dossier MQL5\Files du terminal, car OnTesterInit, OnTesterPass et OnTesterDeinit s’exécutent sur le terminal, dans une instance de l’EA chargée sur un graphique séparé.

Les frames fonctionnent-elles avec le MQL5 Cloud Network ?

Oui, c’est même la méthode recommandée par la documentation MQL5 pour récupérer des données sans écrire sur le disque des agents.

Comment récupérer les paramètres d’une passe ?

Avec FrameInputs(pass, parametres, nombre), qui remplit un tableau de chaînes de la forme « nom=valeur ».

Pourquoi OnTesterPass n’est-elle jamais appelée ?

Vérifiez que vous lancez bien une optimisation et non un test simple, que FrameAdd renvoie true dans OnTester, et que l’EA déclare OnTesterPass ou OnTesterDeinit, condition pour qu’il soit chargé sur le graphique de collecte du terminal.

Peut-on envoyer plusieurs frames par passe ?

Oui, FrameAdd peut être appelée plusieurs fois avec des noms ou identifiants différents, que FrameFilter permet ensuite de trier à la lecture.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.