MQL5 · Bases du langage
Paramètres input et sinput en MQL5 : rendre un EA réglable et optimisable
Déclarer des paramètres externes avec input, exclure certains réglages de l’optimisation avec sinput, les regrouper avec input group et proposer des listes déroulantes grâce aux énumérations.
Le modificateur input transforme une variable globale en paramètre externe : sa valeur apparaît dans l’onglet « Paramètres » de la fenêtre des propriétés du programme et dans le Strategy Tester, où elle peut être optimisée. sinput (pour *static input*) crée aussi un paramètre réglable au lancement, mais que le testeur n’optimise pas. La règle à retenir : un paramètre input ou sinput se lit dans le code mais ne se modifie jamais par le code. Utilisez input pour ce que vous voulez optimiser (périodes, seuils, distances) et sinput pour ce qui ne doit pas l’être (magic number, commentaire d’ordre, options d’affichage).
Cette page fait partie de la rubrique Les bases du langage MQL5.
Syntaxe d’un paramètre input
Le modificateur se place devant le type, au niveau global du fichier :
input int InpPeriodeMA = 50; // Periode de la moyenne mobile
input double InpRisquePct = 1.0; // Risque par trade (%)
input bool InpFiltreSpread = true; // Activer le filtre de spread
Le commentaire placé en fin de ligne sert de libellé dans l’onglet des paramètres : l’utilisateur voit « Periode de la moyenne mobile » au lieu de InpPeriodeMA. La documentation limite ce commentaire à 63 caractères. Elle décrit aussi une forme explicite, input(name="MA period") int InpMAPeriod = 14;, qui accepte uniquement une chaîne littérale ; si les deux formes sont présentes, c’est la valeur de name qui l’emporte.
Les contraintes documentées sont les suivantes :
- le nom de la variable est limité à 63 caractères ;
- un tableau ou une variable de type complexe (structure, classe) ne peut pas être un paramètre
input; - la valeur d’un paramètre
stringest limitée à une longueur comprise entre 191 et 253 caractères selon la longueur du nom du paramètre ; - la valeur ne peut être modifiée que par l’utilisateur ; le programme peut la lire mais pas l’écrire.
Le préfixe Inp n’est pas obligatoire, mais c’est une convention répandue, y compris dans les exemples de MetaQuotes : il signale immédiatement au lecteur qu’il s’agit d’un paramètre externe.
Quand les valeurs sont-elles appliquées ?
Selon la documentation, les paramètres sont réinitialisés juste avant l’appel de OnInit(). Lorsque l’utilisateur modifie un paramètre sur un graphique, l’EA est désinitialisé avec le motif REASON_PARAMETERS, puis OnInit() est rappelée avec les nouvelles valeurs. C’est donc dans OnInit() qu’il faut vérifier la cohérence des paramètres.
sinput : un paramètre exclu de l’optimisation
sinput est équivalent à static input. Le paramètre reste modifiable au lancement de l’EA, mais dans le Strategy Tester les champs « Début », « Pas » et « Fin » sont indisponibles : le testeur ne fait jamais varier sa valeur. La documentation signale une seule exception : la fonction ParameterSetRange(), appelée dans OnTesterInit(), permet malgré tout de définir une plage d’optimisation pour un sinput.
Pourquoi est-ce utile ? Parce qu’une optimisation génétique sur 15 paramètres dont 5 n’ont aucun sens à optimiser (magic number, couleur, texte du commentaire) gaspille du temps de calcul et pollue l’interface. Marquer ces paramètres en sinput rend l’intention explicite et évite les fausses manipulations. Le fonctionnement de l’optimiseur est détaillé dans Optimisation génétique.
Organiser les paramètres avec input group
Au-delà de dix paramètres, l’onglet devient illisible. La directive input group "Nom du groupe" ouvre un bloc qui reste actif jusqu’au input group suivant. Dans la fenêtre des propriétés, les paramètres apparaissent sous des en-têtes ; dans le Strategy Tester, la documentation précise qu’un groupe peut être replié ou déplié, et qu’une case permet de sélectionner tous ses paramètres pour l’optimisation.
Un découpage efficace pour un EA suit la logique du code : « Signal », « Gestion du risque », « Filtres », « Identification ».
Paramètres de type énumération
Une énumération déclarée par vos soins peut servir de type à un paramètre. Chaque valeur apparaît alors dans une liste déroulante, et le commentaire placé après chaque membre de l’énumération remplace son nom technique dans la liste. C’est la meilleure façon de proposer un choix fermé (mode de calcul du lot, sens autorisé, type de stop) sans risquer une saisie invalide. Les énumérations intégrées, comme ENUM_TIMEFRAMES ou ENUM_MA_METHOD, fonctionnent de la même manière. La création d’énumérations est détaillée dans Énumérations (enum) personnalisées.
Pour un script, les paramètres ne s’affichent pas automatiquement : il faut ajouter #property script_show_inputs.
Exemple complet : un EA aux paramètres bien organisés
//+------------------------------------------------------------------+
//| Parametres organises : groupes, enum, input et sinput |
//+------------------------------------------------------------------+
enum ENUM_MODE_LOT
{
LOT_FIXE = 0, // Lot fixe
LOT_RISQUE = 1 // Lot calcule selon le risque
};
input group "Signal"
input int InpPeriodeRapide = 10; // Periode MA rapide
input int InpPeriodeLente = 50; // Periode MA lente
input ENUM_TIMEFRAMES InpTimeframe = PERIOD_H1; // Unite de temps du signal
input group "Gestion du risque"
input ENUM_MODE_LOT InpModeLot = LOT_RISQUE; // Mode de calcul du lot
input double InpLotFixe = 0.10; // Lot fixe
input double InpRisquePct = 1.0; // Risque par trade (%)
input int InpStopPts = 300; // Stop loss (points)
input group "Identification"
sinput ulong InpMagic = 240501; // Magic number
sinput string InpCommentaire = "EA croisement"; // Commentaire des ordres
int OnInit()
{
// Les parametres ne sont pas modifiables : on les valide et on refuse si incoherents
if(InpPeriodeRapide <= 0 || InpPeriodeRapide >= InpPeriodeLente)
{
Print("Parametres invalides : la periode rapide doit etre > 0 et < periode lente");
return(INIT_PARAMETERS_INCORRECT);
}
if(InpRisquePct <= 0.0 || InpRisquePct > 5.0)
{
Print("Risque par trade hors limites (0 a 5 %)");
return(INIT_PARAMETERS_INCORRECT);
}
// Pour adapter une valeur, on copie le parametre dans une variable de travail
double lotInitial = (InpModeLot == LOT_FIXE) ? InpLotFixe : 0.0;
PrintFormat("Mode %s, lot initial %.2f, magic %I64u",
EnumToString(InpModeLot), lotInitial, InpMagic);
return(INIT_SUCCEEDED);
}
void OnTick()
{
// Logique de trading...
}
Deux points méritent l’attention. D’abord, la validation dans OnInit() renvoie INIT_PARAMETERS_INCORRECT : en optimisation, la documentation indique que la passe correspondante est rejetée sans nouvelle tentative, ce qui évite de tester des combinaisons absurdes comme une moyenne rapide plus lente que la lente. Ensuite, quand une valeur doit être ajustée (par exemple un lot arrondi au pas du symbole), on la copie dans une variable de travail au lieu de tenter de modifier le paramètre.
Choisir le bon type pour chaque paramètre
Le type d’un paramètre conditionne ce que l’utilisateur peut saisir et la manière dont le testeur l’optimise. Quelques règles simples :
- Périodes, distances en points, nombre de barres :
int. Le testeur propose alors des pas entiers, ce qui évite des valeurs comme 14,37 barres. - Lots, pourcentages, multiplicateurs d’ATR :
double. Pensez à fixer un pas d’optimisation raisonnable (0,1 ou 0,25) pour limiter le nombre de combinaisons. - Activation d’un filtre :
bool. Le testeur peut optimiser un booléen, ce qui permet de mesurer l’apport réel d’un filtre. - Unité de temps :
ENUM_TIMEFRAMESplutôt qu’un entier, pour obtenir une liste déroulante lisible. - Heures de session : deux
int(heure et minute) sont plus faciles à optimiser qu’une chaîne"09:30", qu’il faudrait de toute façon convertir. - Magic number :
ulongoulongensinput, jamais optimisé.
Un paramètre bien typé est aussi un paramètre plus difficile à mal régler : l’utilisateur ne peut pas saisir de texte dans un champ numérique, et une énumération interdit toute valeur hors liste.
Pièges et bonnes pratiques
- Modifier un input dans le code : le compilateur le refuse. Copiez la valeur dans une variable globale ordinaire si vous devez l’ajuster.
- Optimiser le magic number : cela n’a aucun sens et multiplie les passes. Utilisez
sinput. Le rôle du magic number est expliqué dans Le magic number. - Paramètres en points ou en prix : précisez toujours l’unité dans le libellé (« points », « % », « minutes »). Une distance de 30 peut signifier 30 points ou 3 pips selon le nombre de décimales du symbole.
- Trop de paramètres optimisables : chaque paramètre supplémentaire augmente le risque de sur-optimisation. Optimisez peu de paramètres, figez les autres en
sinput, et validez hors échantillon. Le sujet est développé dans Sur-optimisation. - Changer un paramètre sur un EA en cours : cela déclenche une réinitialisation complète, donc la perte des variables globales. Prévoyez la reconstruction de l’état dans
OnInit().
FAQ
Peut-on modifier la valeur d’un input pendant l’exécution ?
Non. Le programme peut lire un paramètre input mais pas l’écrire : seul l’utilisateur peut le changer, et chaque changement provoque une réinitialisation de l’EA. Copiez la valeur dans une variable ordinaire si vous devez la transformer.
Quelle est la différence entre input et sinput ?
Les deux créent un paramètre réglable au lancement. Un paramètre sinput n’est en revanche pas optimisable dans le Strategy Tester : ses champs de plage sont désactivés, sauf si vous utilisez ParameterSetRange() dans OnTesterInit().
Comment afficher une liste déroulante dans les paramètres ?
Déclarez une énumération et utilisez-la comme type du paramètre input. Chaque membre devient une option, et le commentaire placé après chaque membre sert de libellé dans la liste.
Pourquoi mon script n’affiche-t-il pas ses paramètres ?
Un script n’ouvre pas la fenêtre des paramètres par défaut. Ajoutez la directive #property script_show_inputs en tête du fichier principal.
- Types de données en MQL5
- Variables, constantes et portée
- Opérateurs et expressions
- Conditions if, else et switch
- Boucles for, while et do while
- Écrire ses propres fonctions
- Tableaux statiques et dynamiques
- ArraySetAsSeries et indexation des séries
- Manipuler les chaînes de caractères
- Dates, heures et fuseaux
- Structures (struct) et MqlRates, MqlTick
- Énumérations (enum) personnalisées
- #include, #define et #property
- Les fonctions événementielles
- Print, Comment, Alert : déboguer avec le journal
- NormalizeDouble et précision des prix
- SymbolInfoDouble, SymbolInfoInteger
- AccountInfoDouble : lire les informations du compte
- Bien utiliser MetaEditor
