WHALE ENGINE
Documentation

Highest

[[highest]] produit la borne supérieure glissante d’une série : sur chaque bougie, il renvoie la valeur la plus élevée observée dans la fenêtre des length dernières bougies. La bougie courante fait partie de cette fenêtre, de sorte qu’un nouveau maximum apparaît immédiatement dans la série produite.

La borne reste inchangée tant qu’aucune valeur plus élevée n’entre dans la fenêtre et que le maximum existant n’en sort pas. Lorsqu’il en sort, il est remplacé par la plus grande des valeurs restantes. Contrairement à une moyenne, [[highest]] ne combine pas les observations de la fenêtre : il en conserve uniquement l’extrême supérieur. Avec la source par défaut high, cet extrême est le plus haut récent des bougies ; avec une autre source, il est le maximum récent de cette série.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[highest]]. Chaque bloc produit une série numérique : la valeur du maximum glissant.

Exemples

Configuration minimale

Ce bloc utilise la source implicite "high" et suit donc le plus haut observé sur les 20 dernières barres.

[[highest]]
id     = "highest"
length = 20

Source personnalisée et recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length à partir des clôtures afin d’identifier la longueur la plus performante.

[[highest]]
id           = "highest"
source       = "close"
length.start = 10
length.stop  = 30

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire		Identifiant unique de la série produite.
source
 Texte
 ou Tableau
 Optionnel		Série d’entrée utilisée pour le calcul.
Formats acceptés : source = "hl2" ou source = ["close", "hl2"].
Chaque valeur peut être soit une source de prix standard (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume), soit l’id d’un autre indicateur.
Valeur par défaut : "high"
length
 Entier
 Obligatoire		Taille de la fenêtre, doit être ≥ 1.

Usage :
• Fixe : length = valeur
• Grille :
 – length.start = valeur_minimale
 – length.stop = valeur_maximale
 – length.step = valeur (optionnel, par défaut 1)
symbol
 Texte ou Tableau
 Optionnel		Symbole(s) de marché utilisé(s) lorsque source ne contient que des prix standard (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume).
Si source mélange des prix standard et des identifiants d’indicateurs, symbol s’applique uniquement aux combinaisons basées sur des prix standard.
Si source ne contient que des identifiants d’indicateurs, symbol est ignoré.
Si symbol est omis, le bloc utilise le symbole principal défini dans [backtest].
Pour le format, les tableaux et l’alignement, voir Exchanges, Symboles et Timeframes.
timeframe
 Texte ou Tableau
 Optionnel		Timeframe sur lequel cet indicateur est calculé.
Si timeframe est omis, le calcul se fait sur le timeframe principal de la grille défini dans [backtest].
Pour les formats acceptés et les règles d’alignement entre timeframes, voir Exchanges, Symboles et Timeframes.

Variables disponibles

Utilisez directement les identifiants ci-dessous dans vos expressions. Le bloc highest expose une série numérique et ses paramètres (length, source, symbol, timeframe).

Supposons le bloc configuré ainsi :

[[highest]]
id     = "highest"
length = 20

Alors :

VariableDescription
highest ou highest[0]
Décimal		Maximum glissant courant (première valeur valide après length - 1 bougies).
highest[n]
Décimal		Valeur du maximum il y a n bougies (highest[1] pour la bougie précédente).
highest.length
Décimal		Longueur effectivement utilisée (utile en optimisation).
highest.source
Texte		Source réelle (high, close, autre indicateur).
highest.symbol
Texte		Symbole employé par ce bloc.
highest.timeframe
Texte		Timeframe appliqué à l’indicateur.
Préc
Falling
Suiv
Highest Bars (highestbars)