ProRealTime · ProScreener
SCREENER, SORT BY et filtres : maîtriser l’instruction de sélection
Les formes de l’instruction SCREENER, la combinaison de conditions avec AND et OR, le critère de tri entre parenthèses ou avec SORT BY, les critères multiples et les colonnes nommées : la référence de la sélection dans ProScreener.
L’instruction SCREENER conclut tout code ProScreener. Sa forme minimale est SCREENER[condition] : les instruments pour lesquels la condition est vraie sont sélectionnés. On y ajoute un critère de tri, soit entre parenthèses (SCREENER[c1](critere AS "Nom")), soit avec la forme SCREENER[c1] SORT BY critere AS "Nom". Le mot-clé AS nomme la colonne affichée dans les résultats. Plusieurs conditions se combinent avec AND et OR à l’intérieur des crochets, et plusieurs critères de tri peuvent être séparés par des virgules, dans la limite de 3 ou 6 selon la version de la plateforme. Le sens du tri, lui, ne s’écrit pas : il se choisit dans la fenêtre de programmation.
Cette page sert de référence pour toutes les autres de la rubrique ProScreener : scanner le marché. Pour les conditions elles-mêmes (opérateurs, comparaisons, croisements), voir IF, ELSE, ENDIF.
Les formes de l’instruction
| Forme | Rôle |
|---|---|
SCREENER[c] | sélection sans critère de tri |
SCREENER[c](critere) | sélection et tri selon critere |
SCREENER[c](critere AS "Nom") | idem, avec une colonne nommée |
SCREENER[c] SORT BY critere AS "Nom" | forme alternative du tri, sans parenthèses |
SCREENER[c](crit1 AS "A", crit2 AS "B") | plusieurs critères séparés par des virgules |
Le manuel présente les deux écritures du tri, entre parenthèses et avec SORT BY. Elles produisent le même type de résultat : choisissez-en une et tenez-vous-y pour la lisibilité. Le manuel ne mentionne pas de mots-clés de sens de tri dans le code : n’écrivez pas ASC ou DESC, réglez le sens dans la fenêtre.
Les conditions entre crochets
La condition placée entre crochets est une expression booléenne. Elle peut être écrite directement ou, plus lisiblement, préparée dans des variables :
// Conditions préparées dans des variables nommées
tendance = Close > Average[50](Close)
momentum = RSI[14](Close) > 50
liquidite = Average[20](Volume) > 100000
// Combinaison : tendance ET momentum, et liquidité suffisante
SCREENER[tendance AND momentum AND liquidite](RSI[14](Close) AS "RSI 14")
Les opérateurs AND et OR se combinent comme dans le reste du langage. Utilisez des parenthèses dès que vous les mélangez, pour lever toute ambiguïté : SCREENER[(c1 OR c2) AND c3] n’a pas le même sens que SCREENER[c1 OR (c2 AND c3)].
Préparer les conditions dans des variables a un autre avantage : pour comprendre pourquoi une valeur est absente des résultats, vous pouvez retirer une condition à la fois et observer l’effet sur la liste.
Le critère de tri
Le critère est une valeur numérique calculée pour chaque instrument sélectionné. Il remplit deux fonctions :
- Ordonner les résultats. Avec un affichage limité à 50 résultats (100 sur les plateformes Premium), le tri décide de ce que vous voyez lorsque la condition retient beaucoup d’instruments.
- Afficher une information. La valeur apparaît dans une colonne, ce qui vous évite d’ouvrir chaque graphique pour la connaître.
Un bon critère est comparable d’un instrument à l’autre. Un écart en points n’a pas de sens entre une action à 5 € et une action à 500 € ; un écart en pourcentage ou en multiple d’ATR en a un.
// Tri par écart relatif, comparable entre instruments
mm = Average[20](Close)
atr = AverageTrueRange[14](Close)
c1 = Close > mm
ecartATR = (Close - mm) / atr // écart exprimé en ATR
SCREENER[c1] SORT BY ecartATR AS "Écart MM20 (ATR)"
Plusieurs critères de tri
Le manuel indique que l’on peut définir plusieurs critères au sein d’une même instruction SCREENER, séparés par des virgules, dans la limite de 3 ou 6 selon la version de ProRealTime. Cette possibilité n’est disponible que si le code ne contient qu’une seule instruction SCREENER.
// Plusieurs colonnes d'information dans les résultats
monRSI = RSI[14](Close)
volMoyen = Average[20](Volume)[1]
IF volMoyen > 0 THEN
volRel = Volume / volMoyen
ELSE
volRel = 0
ENDIF
perf5 = (Close - Close[5]) / Close[5] * 100 // performance sur 5 barres en %
c1 = monRSI > 60 AND volRel > 1.5
SCREENER[c1](monRSI AS "RSI", volRel AS "Vol. relatif", perf5 AS "Perf 5 barres %")
Chaque critère produit une colonne. Vous obtenez ainsi un tableau de bord compact : la liste des valeurs sélectionnées et, pour chacune, les informations utiles à la décision.
Formats d’affichage
Le manuel mentionne des fonctions de formatage des colonnes (PERCENTFORMAT, STRINGFORMAT, NUMBERFORMAT, DATEFORMAT). Leur syntaxe précise et leurs options dépendent de la version de la plateforme : reportez-vous à l’aide intégrée ou au bouton « Insérer Fonction » de l’éditeur avant de les utiliser, et vérifiez le rendu sur une exécution de test.
Une condition en plusieurs étapes avec IF
Les conditions ne s’écrivent pas forcément en une ligne. Pour une logique plus riche, un bloc IF peut préparer une variable de sélection, qui est ensuite placée dans les crochets :
// Sélection préparée par un bloc IF
mm50 = Average[50](Close)
monRSI = RSI[14](Close)
selection = 0
IF Close > mm50 AND monRSI < 40 THEN
selection = 1 // repli dans une tendance haussière
ELSIF Close < mm50 AND monRSI > 60 THEN
selection = 1 // rebond dans une tendance baissière
ENDIF
SCREENER[selection = 1](monRSI AS "RSI")
Cette écriture est plus longue mais plus facile à relire et à modifier qu’une longue expression avec AND et OR imbriqués. Elle mélange toutefois les deux sens dans une même liste : pour une lecture claire, la colonne RSI indique de quel cas il s’agit (inférieur à 40 ou supérieur à 60).
Concevoir un bon filtre
- Partez d’une condition principale, celle qui définit ce que vous cherchez (cassure, excès, croisement).
- Ajoutez des filtres de qualité un par un : tendance, liquidité, volatilité minimale. Après chaque ajout, observez combien de valeurs restent.
- Visez une liste exploitable. Quelques valeurs à quelques dizaines selon votre usage. Au-delà, le filtre est trop large ; s’il ne renvoie jamais rien, il est trop strict.
- Choisissez le tri en dernier, en fonction de ce qui vous permet de prioriser parmi les résultats.
Déboguer une sélection inattendue
Lorsqu’un instrument apparaît dans la liste alors qu’il ne devrait pas, ou l’inverse, procédez par élimination :
- Affichez les conditions comme colonnes. Placez temporairement les variables booléennes en critères de tri : chaque colonne montre 1 ou 0, et vous voyez immédiatement quelle condition est vraie ou fausse.
- Retirez les conditions une par une des crochets et observez l’évolution du nombre de résultats.
- Reproduisez le calcul en indicateur sur le graphique de l’instrument concerné, dans la même unité de temps.
- Utilisez
PRINTsi votre version le permet, en tenant compte des restrictions décrites par le manuel : l’instrument doit faire partie de la liste scannée et l’affichage est limité à 10 instruments.
Les erreurs fréquentes
- Écrire un sens de tri dans le code. Il se règle dans la fenêtre.
- Utiliser plusieurs critères avec plusieurs instructions
SCREENER. Les critères multiples supposent une instructionSCREENERunique. - Trier sur une valeur absolue alors que la liste mélange des instruments de prix très différents.
- Oublier la limite d’affichage. Avec plus de 50 valeurs sélectionnées, certaines ne s’affichent pas : resserrez la condition plutôt que de compter sur le tri.
- Laisser des conditions inutilisées. Une variable calculée mais absente des crochets n’a aucun effet sur la sélection ; vérifiez que chaque filtre est bien intégré.
Les combinaisons de conditions issues de plusieurs unités de temps sont traitées dans le screener multi-timeframe, et la création pas à pas dans Premier ProScreener.
FAQ
Quelle différence entre SCREENER[c](critere) et SORT BY ?
Ce sont deux écritures du critère de tri présentées par le manuel : entre parenthèses après les crochets, ou avec le mot-clé SORT BY. Dans les deux cas, AS permet de nommer la colonne.
Peut-on trier par ordre croissant ou décroissant dans le code ?
Non. Le manuel ne prévoit pas de mot-clé de sens de tri dans le code : le sens se choisit dans la fenêtre de programmation du screener.
Combien de critères de tri peut-on utiliser ?
Trois ou six selon la version de ProRealTime, séparés par des virgules, et uniquement si le code ne contient qu’une seule instruction SCREENER.
