WHALE ENGINE
Documentation

Center of Gravity (cog)

[[cog]] est un oscillateur non borné qui mesure la position des prix récents à l’intérieur d’une fenêtre d’observation. Vous l’utilisez pour repérer des retournements potentiels, comparer plusieurs configurations de stratégie ou construire des signaux à partir de croisements avec d’autres séries.

Le COG réagit aux déplacements des prix les plus récents. Quand sa courbe varie rapidement, cela traduit un changement marqué dans l’équilibre des dernières bougies. Quand ses variations sont plus faibles, le comportement récent du prix est plus stable.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[cog]]. Chaque bloc [[cog]] produit une série numérique unique, identifiée par son champ id.

Exemples

Configuration minimale

Ce bloc calcule le COG sur la source close, avec le symbole et le timeframe principaux définis dans [backtest].

[[cog]]
id     = "cog"
length = 10

Recherche de la longueur optimale

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

[[cog]]
id           = "cog"
length.start = 5
length.stop  = 20

Tester close et hlc3 comme sources

Ce bloc teste le COG avec deux sources d’entrée, close et hlc3 (moyenne de high, low, close). Une combinaison est générée pour chaque source. Le bloc utilise toujours le symbole et le timeframe principaux.

[[cog]]
id     = "cog"
source = ["close", "hlc3"]
length = 10

Timeframe dédié

Dans cette configuration, le COG est calculé sur un timeframe journalier dédié, indépendamment du timeframe principal utilisé par le reste de la stratégie. Voir la page Exchanges, Symboles et Timeframes pour les règles d’alignement entre ce timeframe et le timeframe principal.

[[cog]]
id        = "cog"
length    = 10
timeframe = "D"

Symbole spécifique

Ce bloc utilise un symbole de marché spécifique pour les prix d’entrée du COG. Il lit sa série source sur BINANCE:ETHUSDT, tandis que le reste de la stratégie peut fonctionner sur un autre instrument.

[[cog]]
id     = "cog"
length = 10
symbol = "BINANCE:ETHUSDT"

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire		Nom unique utilisé pour identifier la série COG.
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 : "close"
length
 Entier
 Obligatoire		Taille de la fenêtre de calcul ; doit être strictement supérieure à 0.

Usage :
• Fixe : length = 10
• 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 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é.
Pour le format et les règles d’alignement, voir le guide Exchanges, Symboles et Timeframes.
timeframe
 Texte
 ou Tableau
 Optionnel		Timeframe sur lequel cet indicateur est calculé. Si omis, le calcul se fait sur le timeframe principal de la grille. Pour les formats acceptés et le comportement multi‑timeframes, voir Exchanges, Symboles et Timeframes.

Variables disponibles

Le bloc COG expose une série numérique, ses paramètres de configuration et des métadonnées sur la source d’entrée, le symbole et le timeframe. Vous pouvez utiliser directement ces identifiants dans vos expressions.

Supposons le bloc configuré ainsi :

[[cog]]
id     = "cog"
source = "close"
length = 10

Alors :

VariableDescription
cog ou cog[0]
Décimal		Valeur actuelle du COG.
cog[n]
Décimal		Valeur du COG il y a n bougies.
cog.length
Décimal		Longueur de fenêtre effectivement utilisée.
cog.source
Texte		Nom de la série d’entrée utilisée.
cog.symbol
Texte		Symbole de marché à partir duquel les données d’entrée sont lues.
cog.timeframe
Texte		Timeframe sur lequel le COG est calculé.

Notes

  • Les variables numériques se combinent librement (arithmétique, comparaisons, opérateurs logiques).
  • Les variables textuelles sont destinées aux comparaisons d’égalité/inégalité ou à la journalisation et à l’export.
Préc
Export Pine Script
Suiv
Crossunder