Créer un indicateur MT5 : tampons, OnCalculate et recalcul fiable

Créer un indicateur MT5 : tampons, OnCalculate et recalcul fiable

Commencez avec une valeur que vous pouvez expliquer

Un indicateur personnalisé utile a un contrat précis avant d'avoir des couleurs attrayantes. Notre exemple indique où la clôture actuelle se situe dans la plage du plus haut au plus bas des N dernières barres. Il produit un nombre compris entre 0 et 100, ou une valeur vide lorsque la fenêtre est incomplète. Il n'envoie pas de commandes. Cela le rend approprié pour apprendre le calcul, l'affichage et la vérification en tant que responsabilités distinctes.

Rédigez le contrat explicitement : utilisez le symbole du graphique et la période, incluez la barre en cours de calcul, utilisez des hauts et des bas plutôt que des clôtures pour établir la plage et renvoyez 50 pour une fenêtre plate. Une clôture en dehors de la plage haute-basse de sa propre barre est une entrée incohérente à enquêter, et non une raison pour bloquer silencieusement la sortie. Ces décisions comptent plus que le nom de l'indicateur.

Le calcul est 100 × (proche − plus bas) / (plus haut − plus bas). Il s'agit d'un exemple pédagogique de plage de position, et non d'une prétention à reproduire l'indicateur stochastique lissé. Si vous ajoutez ultérieurement un lissage, modifiez la formule et ses exigences de préchauffage.

Gardez les contrats de calcul et de dessin séparés

Utilisez un tampon de données et un tracé linéaire. Le terminal possède la taille du tampon lié ; votre code fournit des valeurs. Choisissez explicitement l'indexation la plus ancienne en premier après la liaison et pour les tableaux d'entrée utilisés dans la boucle. Ensuite, l'indice i fait référence à la même barre en haut, en bas et en clôture. Évitez de mélanger cette convention avec des requêtes CopyBuffer basées sur la position, où la position zéro signifie la barre actuelle.

Les N−1 premières cellules n'ont pas de fenêtre complète. Donnez-leur EMPTY_VALUE et définissez la propriété de valeur vide du tracé sur la même sentinelle. Zéro est un résultat de plage-position valide et ne peut pas signifier « pas prêt ». PLOT_DRAW_BEGIN contrôle la présentation, mais l'initialisation explicite des cellules indisponibles facilite également l'inspection du contrat de données.

Les indices du tampon indicateur commencent à zéro, tandis que les suffixes de déclaration tels que Indicator_type1 font référence au premier tracé. Documentez à la fois le tampon de données et le tracé ; ce ne sont pas des identifiants interchangeables.

Une implémentation pédagogique complète

Créez un indicateur personnalisé dans MetaEditor et utilisez l'exemple original suivant comme source. Le code utilise délibérément un balayage O(N) transparent pour chaque barre recalculée. Il s'agit d'une implémentation de référence à inspecter et à compiler dans votre terminal, et non d'un package de livraison compilé ou d'une réclamation de référence.

#property indicator_separate_window
#property indicator_buffers 1
#property indicator_plots 1
#property indicator_label1 "Range position"
#property indicator_type1 DRAW_LINE
#property indicator_color1 clrRoyalBlue
#property indicator_minimum 0
#property indicator_maximum 100
input int Period = 14;
double RangePosition[];

int OnInit()
{
   if(Period < 2) return INIT_PARAMETERS_INCORRECT;
   if(!SetIndexBuffer(0, RangePosition, INDICATOR_DATA))
      return INIT_FAILED;
   ArraySetAsSeries(RangePosition, false);
   PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, Period - 1);
   PlotIndexSetDouble(0, PLOT_EMPTY_VALUE, EMPTY_VALUE);
   IndicatorSetInteger(INDICATOR_DIGITS, 2);
   return INIT_SUCCEEDED;
}

int OnCalculate(const int rates_total,
                const int prev_calculated,
                const datetime &time[],
                const double &open[],
                const double &high[],
                const double &low[],
                const double &close[],
                const long &tick_volume[],
                const long &volume[],
                const int &spread[])
{
   ArraySetAsSeries(high, false);
   ArraySetAsSeries(low, false);
   ArraySetAsSeries(close, false);
   bool reset = (prev_calculated <= 0 || prev_calculated > rates_total);
   if(reset) ArrayInitialize(RangePosition, EMPTY_VALUE);
   if(rates_total < Period) return 0;
   int start = reset ? Period - 1 : MathMax(Period - 1, prev_calculated - 1);
   for(int i = start; i < rates_total; ++i)
   {
      double hi = high[i], lo = low[i];
      for(int j = i - Period + 1; j < i; ++j)
      {
         hi = MathMax(hi, high[j]);
         lo = MathMin(lo, low[j]);
      }
      RangePosition[i] = (hi == lo) ? 50.0 :
                        100.0 * (close[i] - lo) / (hi - lo);
   }
   return rates_total;
}

Comprendre les quatre cas de recalcul

Lors du premier chargement, calculez chaque fenêtre complète. Lors d'un autre tick de la même barre, recalculez la dernière barre : son haut, son bas et sa clôture peuvent changer. Lorsqu'une nouvelle barre arrive, recalculez l'ancienne dernière barre et calculez la nouvelle. Lorsque le terminal réinitialise prev_calculated après un changement d'historique, reconstruisez le résultat plutôt que de faire confiance à l'ancien préfixe. La référence OnCalculate décrit ce comportement de réinitialisation.

Le retour de rate_total indique à l'invocation suivante la quantité traitée ; cela ne rend pas la barre actuelle définitive. Un consommateur qui souhaite une valeur de barre fermée choisit toujours un horodatage fermé approprié. Le dernier point tracé se déplaçant au cours d'une bougie inachevée est attendu dans le cadre de ce contrat.

N'optimisez pas en gardant uniquement un plus haut plus haut en cache, sauf si vous gérez également la barre qui l'a fourni en quittant la fenêtre. Une file d'attente monotone peut réduire le travail, mais la réinitialisation de l'historique, l'égalité des sommets et la révision de la barre actuelle nécessitent toutes une gestion explicite. Conservez cette version simple comme oracle numérique lors de l'introduction d'un algorithme plus rapide.

Vérifiez avec un petit appareil numérique

Utilisez N=3 et les barres les plus anciennes en premier. Soit les hauts [12,13,14,15], les bas [8,9,10,11] et les clôtures [10,12,13,11]. Les deux premières sorties sont vides. A l'indice 2, la plage est de 8 à 14 et le résultat est 83,333333. À l'index 3, la fenêtre avance de 9 à 15 et le résultat est 33,333333. Ce sont des exemples arithmétiques synthétiques, pas des résultats de marché.

Modifiez maintenant uniquement la dernière clôture de 11 à 14 : seule la dernière sortie devrait changer, à 83,333333. Une fenêtre plate à trois barres avec tous les prix égaux produit 50. Testez une période d'entrée de 1 et confirmez que l'initialisation la rejette. Testez moins de trois barres et confirmez que l'indicateur n'expose aucun signal zéro fabriqué.

Comparez une passe complète avec des passes incrémentielles sur le même jeu de données de test. Ajoutez ensuite les anciennes barres et forcez un nouveau calcul. Comparez les sorties par horodatage, en tenant compte de la région d'échauffement modifiée. Une ligne visuellement lisse ne suffit pas à établir l'une de ces propriétés.

Diagnostiquer un tracé vide ou trompeur

Si rien n'apparaît, vérifiez les résultats d'initialisation, les barres disponibles, le type de tracé, les paramètres de valeur vide et les messages Experts/Journal. Utilisez la fenêtre de données pour distinguer une valeur valide masquée par le style d'une cellule non calculée. Une échelle fixe de 0 à 100 est appropriée ici car le contrat a cette plage ; cela cacherait de nombreux indicateurs libellés en prix.

Lors de l'ajout ultérieur d'un lecteur EA, documentez que le tampon 0 est la position d'une plage numérique, et non un signal d'achat/vente. Enregistrez l'horodatage de la barre sélectionnée avec chaque valeur. Une copie ratée doit rester une observation manquante. Cela empêche les bugs d'affichage, les problèmes de préparation des données et les décisions relatives aux règles de trading d'être combinés dans un vague rapport « l'indicateur ne fonctionne pas ».

Fichiers pratiques

Ces fichiers CSV contiennent des données pédagogiques synthétiques, et non des observations de marché ou des résultats d’investissement.

L’exemple MQ5 n’a pas été compilé ni exécuté dans MT5 dans le cadre de cet article.

Sources et lectures complémentaires

Retour en haut
Analyses d’EA4 min

One Gold MT5 8.1 : + 2,775.95 % dans le dernier test d'or du mois 12

XAUUSD · Dimensionnement du compte basé sur le solde, signaux configurables et gestion des positions commerciales. Découvrez un rendement de simulation historique de + 2,775.95 %, un retrait maximum des capitaux propres du compte de 29.12 % et les paramètres derrière le résultat.

MQLume Bespoke

À la hauteur de vos ambitions.

Découvrir le sur-mesure →

Une idée plus précise en tête ?

Parlons de développement sur mesure. Décrivez vos besoins par messagerie privée ou e-mail ; périmètre et devis sont définis séparément.

100% engagés dans le suivi de votre livraison et de vos demandes d’assistance.

Des téléchargements gratuits. Du vrai code.

GRATUIT

Lizard [MQLume]

MQL5 / MT5Version v2.21

Projet gratuit et modifiable de cassures sur l’or : six moteurs sélectionnables, filtres horaires et taille de position flexible.

US$149.00GRATUIT
GRATUIT

Scraper Gold [MQLume]

MQL5 / MT5Version v3.7

Code source modifiable gratuit avec EX5 : quatre moteurs de cassure sur l’or, avec profils, volumes, directions et sorties indépendants.

US$95.00GRATUIT
GRATUIT

EA Black Dragon [MQLume]

MQL5 / MT5Version v13.0

Entrées de tendance avec renforts en grille facultatifs, contrôle par sens et sorties virtuelles.

US$30.00GRATUIT
GRATUIT

Hamster Scalping [MQLume]

MQL5 / MT5Version v21.0

Entrées RSI avec deux filtres ATR, plages horaires réglables et grille facultative.

US$30.00GRATUIT
MQLume

À découvrir ensemble. À partager en communauté.

Retrouvez MQLume sur votre plateforme préférée.

YouTube

Découvrez nos EA en action : backtests, démonstrations et guides pratiques.

Voir sur YouTube

Telegram

Échangez avec d’autres utilisateurs d’EA, partagez vos idées et suivez les nouveautés.

Rejoindre la communauté Suivre les annonces officielles

Panier

Une licence personnelle par projet. Chaque projet ne peut être ajouté qu’une fois.

Votre panier attend son premier passager.

Choisissez une édition EA ou source.

Continuer les achats