ProRealTime · ProBuilder
CALL en ProBuilder : appeler un indicateur personnel et récupérer ses valeurs
Réutiliser un indicateur personnel avec CALL en ProBuilder : syntaxe, paramètres entre crochets, valeurs multiples, mot-clé ignored et bonnes pratiques, faute de fonctions utilisateur.
L’instruction CALL permet d’utiliser, dans un code ProBuilder, un indicateur personnel que vous avez déjà programmé. La syntaxe de base est valeur = CALL "NomDeLIndicateur", complétée si besoin par des paramètres entre crochets : valeur = CALL "NomDeLIndicateur"[14, 2]. Si l’indicateur renvoie plusieurs valeurs, on les récupère dans l’ordre de son RETURN : haut, bas = CALL "MonCanal". C’est le seul moyen de réutiliser un calcul en ProBuilder, car le langage n’a pas de fonctions définies par l’utilisateur : l’indicateur appelé joue le rôle d’une fonction.
Cette page explique comment appeler un indicateur, lui transmettre des paramètres, récupérer une ou plusieurs valeurs et éviter les pièges de maintenance. Elle fait partie de la rubrique Le langage ProBuilder.
Pourquoi CALL est indispensable
Dans un langage comme MQL5, on écrirait une fonction CalculerCanal(periode, multiplicateur) et on l’appellerait à plusieurs endroits. ProBuilder ne le permet pas. Pour éviter de copier-coller le même calcul dans plusieurs codes, avec le risque qu’ils divergent au fil des modifications, on l’écrit une seule fois dans un indicateur, puis on l’appelle avec CALL depuis :
- un autre indicateur qui combine plusieurs calculs ;
- un système de trading ProBacktest ou ProOrder, qui utilise le signal pour passer des ordres ;
- un screener ProScreener, qui filtre les valeurs selon ce même signal.
C’est la meilleure manière de garantir que l’indicateur affiché sur le graphique, le backtest et le screener utilisent exactement la même logique. Le passage au backtest est présenté dans le guide Premier backtest ProBacktest.
Insérer un appel depuis l’éditeur
Le manuel officiel décrit la procédure : dans l’éditeur, ouvrez la fenêtre d’insertion de fonction, choisissez la catégorie des indicateurs utilisateur, sélectionnez votre indicateur et validez. L’éditeur insère alors une ligne CALL avec un nom de variable proposé automatiquement : dans l’exemple du manuel, l’indicateur « HistoMACD » est inséré sous la forme myHistoMACD = CALL "HistoMACD". Vous pouvez renommer la variable de gauche comme vous le souhaitez ; c’est le nom entre guillemets qui doit correspondre exactement à celui de l’indicateur.
Les formes de l’instruction
Une seule valeur
monHisto = CALL "HistoMACD"
RETURN monHisto
Plusieurs valeurs
Si l’indicateur appelé se termine par RETURN a, b, on récupère les deux valeurs dans le même ordre, séparées par des virgules à gauche du signe égal :
mmExpo, mmSimple = CALL "Moyennes"
La documentation de ProRealCode précise qu’une valeur dont vous n’avez pas besoin peut être ignorée avec le mot-clé ignored à sa position : v1, ignored, v3 = CALL "MonIndicateur".
Avec des paramètres
Lorsque l’indicateur appelé possède des variables paramétrables (définies dans sa fenêtre de variables), on peut leur transmettre des valeurs entre crochets. Les paramètres doivent correspondre en nombre et en type à ceux qu’attend l’indicateur, dans l’ordre où ses variables sont définies :
valeur = CALL "Mon indicateur personnel"[7, 14]
Sans crochets, l’indicateur est calculé avec les valeurs par défaut de ses variables. La création de ces variables paramétrables est détaillée dans le guide Variables optimisables.
Exemple complet : un canal ATR réutilisable
Créons d’abord l’indicateur appelé, nommé « CanalATR ». Il possède deux variables paramétrables définies dans l’éditeur : periode (entier, 20 par défaut) et mult (décimal, 2 par défaut). Ces variables ne sont donc pas affectées dans le code.
// Indicateur "CanalATR"
// Variables paramétrables définies dans l'éditeur : periode (20), mult (2)
milieu = ExponentialAverage[periode](Close)
largeur = AverageTrueRange[periode](Close) * mult
haut = milieu + largeur
bas = milieu - largeur
RETURN haut AS "Haut", bas AS "Bas", milieu AS "Milieu"
Écrivons ensuite un second indicateur qui l’appelle avec d’autres paramètres et en déduit un signal de sortie du canal :
// Indicateur "SortieCanal" : utilise CanalATR sans recopier son calcul
hautC, basC, ignored = CALL "CanalATR"[50, 2.5] // période 50, multiplicateur 2,5 ; le milieu est ignoré
signal = 0
IF Close CROSSES OVER hautC THEN
signal = 1 // clôture au-dessus du canal
ELSIF Close CROSSES UNDER basC THEN
signal = -1 // clôture sous le canal
ENDIF
RETURN signal AS "Sortie de canal"
Si vous modifiez plus tard la formule du canal (une moyenne simple à la place de l’exponentielle, par exemple), le second indicateur en profitera automatiquement. L’ATR est présenté sur la page AverageTrueRange.
Bien concevoir un indicateur destiné à être appelé
- Un
RETURNstable : l’ordre des valeurs renvoyées est le contrat entre l’indicateur et les codes qui l’appellent. Ajouter une valeur au milieu duRETURNdécale toutes les autres. Ajoutez plutôt les nouvelles valeurs à la fin. - Des valeurs nommées avec
ASpour documenter ce que représente chaque position. - Des paramètres explicites : tout ce qui pourrait varier (période, seuil, multiplicateur) gagne à être une variable paramétrable plutôt qu’une constante codée en dur.
- Pas d’instructions graphiques superflues : un indicateur de calcul pur est plus léger à appeler. Gardez les flèches et textes dans un indicateur d’affichage séparé.
- Un nom définitif : l’appel se fait par le nom entre guillemets. Si vous renommez l’indicateur, tous les codes qui l’appellent doivent être mis à jour.
CALL ou copie du code : comment trancher
CALL n’est pas toujours la meilleure option. Pour un calcul d’une ou deux lignes, comme une moyenne mobile ou un écart de prix, recopier la formule est plus simple et évite une dépendance entre deux codes. CALL devient préférable dès que le calcul dépasse quelques lignes, qu’il est utilisé à plusieurs endroits, ou qu’il est susceptible d’évoluer. Un bon critère : si une modification de la logique devrait s’appliquer partout en même temps, centralisez-la dans un indicateur appelé.
Vérifier un appel avant de s’y fier
Avant d’utiliser une valeur obtenue par CALL dans une logique de trading, contrôlez-la visuellement. Appliquez l’indicateur appelé sur le graphique avec les mêmes paramètres, puis renvoyez la valeur récupérée dans un indicateur de test : les deux courbes doivent se superposer exactement. Un écart signale presque toujours une erreur d’ordre dans les valeurs renvoyées ou dans les paramètres transmis. Ce contrôle de quelques minutes évite d’interpréter un backtest construit sur une valeur erronée.
Pièges et limites
- Nom inexact : le nom entre guillemets doit correspondre exactement à celui de l’indicateur existant.
- Nombre de valeurs incohérent : si vous demandez trois valeurs à un indicateur qui n’en renvoie que deux, ou si vous transmettez un nombre de paramètres différent de celui attendu, le code ne peut pas être validé ou donne un résultat faux.
- Coût de calcul : l’indicateur appelé est calculé sur l’historique comme s’il était affiché. Multiplier les appels à des indicateurs lourds, ou appeler un indicateur qui en appelle lui-même d’autres, ralentit l’ensemble.
- Partage de code : un système qui utilise
CALLdépend de l’indicateur appelé. Si vous exportez ou partagez le système, l’indicateur doit l’accompagner. - Traitement en temps réel : un indicateur appelé hérite des mêmes questions de barre non clôturée que l’indicateur d’origine.
Ces erreurs de validation sont recensées, avec les autres, dans le guide des erreurs fréquentes en ProBuilder.
FAQ
Peut-on créer une fonction personnalisée en ProBuilder ?
Non, ProBuilder ne permet pas de définir des fonctions avec paramètres. La solution consiste à écrire le calcul dans un indicateur séparé, avec des variables paramétrables, puis à l’appeler avec CALL en lui transmettant des valeurs entre crochets.
Comment récupérer plusieurs valeurs d’un indicateur appelé ?
Placez plusieurs variables séparées par des virgules à gauche du signe égal : a, b, c = CALL « MonIndicateur ». Elles reçoivent les valeurs dans l’ordre du RETURN de l’indicateur appelé. Le mot-clé ignored permet de sauter une valeur inutile.
Que se passe-t-il si je modifie l’indicateur appelé ?
Tous les codes qui l’appellent utilisent automatiquement la nouvelle version. C’est l’intérêt de CALL, mais aussi un risque : modifier l’ordre des valeurs du RETURN ou le nombre de paramètres peut fausser silencieusement les codes appelants.
Peut-on utiliser CALL dans un système de trading ?
Oui, c’est même l’usage le plus courant : le système appelle l’indicateur qui produit le signal et se contente de passer les ordres. Les mêmes règles de syntaxe s’appliquent dans ProBacktest, ProOrder et ProScreener.
