WHALE ENGINE
Documentation

Mode (mode)

[[mode]] renvoie la valeur la plus fréquente de sa source parmi les length dernières valeurs valides. Il produit une série numérique qui représente, à chaque bougie, le niveau dominant de cette fenêtre.

Sur une série discrète, arrondie ou regroupée par niveaux, cette sortie fait apparaître la valeur qui revient le plus souvent plutôt que le centre ou la moyenne de la fenêtre. En cas d’égalité entre plusieurs valeurs de fréquence maximale, le bloc renvoie toujours la plus petite.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[mode]]. Chaque bloc produit une série numérique : le mode de la source sur la fenêtre configurée.

Exemples

Configuration minimale

Ce bloc calcule le mode de close sur 20 valeurs. Comme source est omis, le bloc utilise la valeur par défaut "close".

[[mode]]
id     = "mode"
length = 20

Source spécifique

Ce bloc calcule le mode sur la source hlc3 plutôt que sur close.

[[mode]]
id     = "mode"
source = "hlc3"
length = 20

Source issue d’un autre indicateur

Ce bloc calcule la valeur la plus fréquente de la série produite par le bloc rsi sur 10 valeurs.

[[rsi]]
id     = "rsi"
length = 14

[[mode]]
id     = "rsi_mode"
source = "rsi"
length = 10

Recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length afin d’identifier la fenêtre la plus performante.

[[mode]]
id           = "mode"
length.start = 10
length.stop  = 30

Symbole et timeframe dédiés

Ce bloc calcule le mode sur la série journalière de BINANCE:ETHUSDT, indépendamment du symbole et du timeframe principaux définis dans [backtest]. Voir la page Exchanges, Symboles et Timeframes pour les règles d’alignement.

[[mode]]
id        = "mode"
length    = 20
symbol    = "BINANCE:ETHUSDT"
timeframe = "D"

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire		Nom unique identifiant la série mode ; le bloc expose une série numérique portant cet identifiant.
source
 Texte
 ou Tableau
 Optionnel		Série d’entrée utilisée pour le calcul.
Formes acceptées : source = "hlc3" ou source = ["close", "hlc3"].
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 : "close"
length
 Entier
 Obligatoire		Nombre de valeurs de la fenêtre utilisées pour calculer le mode ; 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é fournissant la série source lorsque source contient des prix standards (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume).
Si source mélange des prix standards et des ids d’indicateurs, symbol ne s’applique qu’aux combinaisons fondées sur des prix standards.
Si source ne contient que des ids d’indicateurs, symbol est ignoré.
Pour le format et les règles d’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

Le bloc mode expose une série numérique, sa longueur de calcul et des métadonnées sur la source d’entrée, le symbole et le timeframe. Ces identifiants s’emploient directement dans vos expressions.

Supposons le bloc configuré ainsi :

[[mode]]
id     = "mode"
length = 20

Alors :

VariableDescription
mode ou mode[0]
Décimal		Valeur actuelle du mode.
mode[n]
Décimal		Valeur du mode il y a n bougies.
mode.length
Décimal		Longueur de la fenêtre utilisée.
mode.source
Texte		Nom de la série d’entrée (par exemple close, hlc3, ou l’id d’un autre indicateur).
mode.symbol
Texte		Symbole à partir duquel les données d’entrée sont lues.
mode.timeframe
Texte		Timeframe sur lequel le mode est calculé.

Notes

  • Pendant la phase d’amorçage, tant que la fenêtre ne contient pas length valeurs, la série vaut NaN.
  • Les bougies dont la source vaut NaN ne sont pas comptées : la fenêtre conserve les length dernières valeurs valides.
  • En cas d’égalité de fréquence, la plus petite valeur est renvoyée.
  • Les variables numériques se combinent librement (arithmétique, comparaisons, opérateurs logiques).
  • Les variables textuelles sont des chaînes destinées aux comparaisons d’égalité/inégalité uniquement.
Préc
Median (median)
Suiv
Momentum (mom)