Indicateurs
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.
















