Phoenix Range Detector

À propos

Phoenix Range Detector trouve les périodes calmes sur un graphique. Pendant ces périodes, le prix reste dans une bande étroite. Il dessine chacune d'elles sous forme de rectangle ou de canal en pente.

Pour l'ajouter, cliquez sur Indicateurs (Indicators) en haut du graphique, dans KAGAMI. Il se trouve dans le groupe KAGAMI, sous le nom Phoenix Range Detector. Sur le graphique, son nom s'affiche ainsi : Phoenix RD.

Cet indicateur n'est pas encore dans la liste des indicateurs de tous les comptes.

KAGAMI calcule les dessins sur ses propres serveurs. Il suit les règles du script d'origine, qui a été écrit pour TradingView.

Ce que vous voyez sur le graphique

Une bougie (ou barre) est une tranche de temps sur le graphique, par exemple 15 minutes. Un range est une suite de bougies qui restent dans une bande étroite.

• Un rectangle doré est un range plat. Le prix y a avancé à l'horizontale.
• Un canal bleu clair est un range en pente. Il a deux bords bleus continus, avec un léger remplissage bleu entre eux.
• Une ligne rouge en tirets passe au milieu. Elle marque la moitié.
• Deux lignes en pointillés marquent les quarts : à un quart et à trois quarts de la hauteur.
• Une petite étiquette se place en haut, au bout droit. Elle indique STATIC pour un rectangle et DYNAMIC pour un canal.

Le range le plus récent grandit à chaque clôture de bougie. Son bord droit avance avec le graphique.

Quand un range se termine, voici ce qui change :

• Une bougie a clôturé au-dessus : il devient vert.
• Une bougie a clôturé en dessous : il devient rouge.
• Il s'est simplement arrêté, parce qu'il était devenu trop long ou trop large : il garde sa couleur.
• Un canal reçoit de courtes lignes en tirets. Elles le prolongent de deux bougies.
• Une fine ligne en tirets part vers la droite depuis le haut ou le bas du range. Elle s'arrête quand une bougie clôture à travers elle, ou après 100 bougies.

Un seul range grandit à la fois. Les ranges ne se chevauchent jamais.

Comment les traders le lisent souvent

• Beaucoup de traders appellent une période sans direction un range ou une consolidation.
• Beaucoup de traders lisent le haut et le bas d'un range comme des prix où les mouvements se sont arrêtés avant.
• Certains traders regardent la couleur que prend un range. Elle montre de quel côté une bougie a clôturé quand il s'est terminé.
• Certains regardent la ligne en tirets après la fin d'un range. Ils regardent si le prix y revient.
• Certains utilisent la ligne du milieu. Elle montre si le prix est dans la moitié du haut ou dans celle du bas.

Un indicateur décrit seulement les prix passés. Il ne peut pas prédire l'avenir.

Les paramètres

Cet indicateur n'a aucun paramètre à changer. Il utilise toujours les mêmes valeurs fixes :

• Un nouveau range couvre 10 bougies. Un range dure 150 bougies au plus.
• Un nouveau range peut faire au plus 2 fois l'ATR de haut.
• ATR veut dire average true range, l'amplitude vraie moyenne. C'est la taille moyenne du mouvement d'une bougie, sur les 14 dernières bougies.
• Un range qui grandit peut s'élargir un peu, jusqu'à 2,4 fois l'ATR.
• Un range se termine quand une bougie clôture au-delà de son bord de plus de 0,15 fois l'ATR.
• Les couleurs : doré pour les rectangles, bleu clair pour les canaux, vert et rouge quand un range se termine.

Quand il peut tromper

• Il trouve les ranges après coup. Un range apparaît seulement une fois que 10 bougies ont clôturé dedans. Il commence donc 10 bougies en arrière.
• Le range le plus récent peut encore changer. Tant qu'il n'est pas terminé, son haut, son bas, sa pente et son type peuvent changer à chaque clôture.
• Une couleur n'est pas une tendance. Vert ou rouge dit seulement où une bougie a clôturé. Le prix peut revenir dedans peu après.
• Les grandes bougies élargissent les règles. Toutes les limites suivent l'ATR. Quand les bougies sont grandes, une bande large compte quand même comme étroite.
• Les toutes petites bougies les resserrent. Quand le marché est très calme, un petit mouvement peut terminer un range.
• Les sauts de prix comptent comme des mouvements. Un saut entre deux bougies, comme le saut d'une action pendant la nuit, peut terminer un range.
• La bougie en train de se former est ignorée. La bougie encore en train de se former ne compte pas avant sa clôture.
• Les anciens dessins peuvent être différents. Tout à gauche, les dessins peuvent ne pas correspondre à ceux de TradingView. KAGAMI lit peut-être moins de bougies passées.

Les graphiques servent à apprendre. Ce ne sont pas des conseils. Lisez notre Avertissement sur les risques.

Un exemple

Prenez NASDAQ:AAPL sur un graphique en 15 minutes. Chaque bougie dure 15 minutes. Les chiffres ci-dessous sont inventés.

1. Disons que l'ATR vaut 0,50 et reste à ce niveau.
2. Pendant 10 bougies, AAPL avance à l'horizontale entre 100,00 et 100,80. La bande fait 0,80 de haut.
3. La limite est 2 × 0,50 = 1,00. La bande y tient, donc un rectangle doré STATIC apparaît.
4. D'autres bougies clôturent dedans. Le rectangle grandit vers la droite.
5. Puis une bougie clôture à 100,90. Le haut du rectangle est à 100,80.
6. Le niveau de cassure est 100,80 + 0,15 × 0,50 = 100,875. La clôture est au-dessus.
7. Le range se termine et le rectangle devient vert. Il se termine à la bougie d'avant la cassure.
8. Une ligne verte en tirets part vers la droite depuis le bas du rectangle, à 100,00.
9. Cette ligne s'arrête à la première clôture sous 99,925, ou après 100 bougies.

Détails techniques

Cette partie donne les règles exactes, pour les lecteurs qui les veulent. Chaque règle s'applique seulement aux bougies clôturées, une bougie à la fois, de la bougie la plus ancienne que KAGAMI lit jusqu'à la plus récente.

Le calcul

Les termes utilisés par les règles :

• L'amplitude vraie d'une bougie = la plus grande valeur entre high − low, |high − previous close| et |low − previous close|. Sur la toute première bougie, c'est high − low.
• ATR = la moyenne de Wilder de l'amplitude vraie sur 14 bougies. Le premier ATR est la moyenne simple des 14 premières amplitudes vraies. Ensuite, ATR = (true range + 13 × previous ATR) ÷ 14. Les 13 premières bougies n'ont pas d'ATR.
• Le milieu d'une bougie = (high + low) ÷ 2.
• La droite d'ajustement = la droite des moindres carrés qui passe par les milieux des bougies du range (formules plus bas).
• L'écart du haut = le plus grand high − fit(x) parmi les bougies du range. L'écart du bas = le plus petit low − fit(x) (en général sous zéro). Les bords du canal sont fit(x) + upper offset et fit(x) + lower offset. Ils touchent donc le vrai plus haut le plus haut et le vrai plus bas le plus bas autour de la droite.
• La hauteur statique = le plus haut le plus haut moins le plus bas le plus bas des bougies du range.
• La hauteur dynamique = l'écart du haut moins l'écart du bas.
• La pente totale = |slope| × (n − 1) : de combien la droite d'ajustement monte ou descend sur toute la longueur du range.
• Plat : la pente totale ≤ 0.35 × the larger of (static height, tick size).
• La taille du tick = le plus petit pas de prix. KAGAMI utilise 0.01 pour les actions américaines (0.0001 quand la dernière clôture est sous 1), et une unité de la précision de prix du graphique pour tous les autres marchés. Elle compte seulement dans le test « plat ».

La droite d'ajustement : numérotez les bougies du range x = 0, 1, 2 … à partir de sa première bougie, avec y = le milieu de la bougie et n = le nombre de bougies. Alors :

• slope = (n × Σxy − Σx × Σy) ÷ (n × Σx² − (Σx)²), ou 0 quand le bas de cette fraction vaut 0
• start = (Σy − slope × Σx) ÷ n
• fit(x) = start + slope × x

L'ATR de chaque test ci-dessous est l'ATR de la bougie jugée.

Le début d'un range

Sur chaque bougie clôturée, tant qu'aucun range ne grandit :

1. Au moins 10 bougies doivent venir avant celle-ci.
2. La fenêtre, c'est cette bougie et les 9 d'avant : 10 bougies. La fenêtre doit commencer après la dernière bougie du range précédent.
3. Calculez la droite d'ajustement, la hauteur statique et la hauteur dynamique sur la fenêtre.
4. Le statique tient quand la hauteur statique ≤ 2.0 × ATR. Le dynamique tient quand la hauteur dynamique ≤ 2.0 × ATR.
5. Quand l'un des deux tient, un range commence à la première bougie de la fenêtre.
6. Il est dynamique quand le dynamique tient, et que soit le statique ne tient pas, soit la fenêtre n'est pas plate et la hauteur dynamique ≤ 0.85 × static height. Sinon, il est statique.

Après la fin d'un range, la fenêtre suivante peut commencer au plus tôt à la bougie qui l'a terminé. Le range suivant peut donc apparaître au plus tôt 9 bougies après la fin.

Un range qui grandit ou qui se termine

Sur chaque bougie clôturée suivante, avec n = le nombre de bougies de la première bougie du range jusqu'à celle-ci :

1. Calculez de nouveau la droite d'ajustement, avec cette bougie comprise. La hauteur statique comprend maintenant aussi le plus haut et le plus bas de cette bougie.
2. La limite est 2.0 × ATR × 1.20, c'est-à-dire 2.4 × ATR.
3. Le statique tient quand la hauteur statique ≤ la limite. Le dynamique tient quand la hauteur dynamique ≤ la limite.
4. Cassure vers le haut : la clôture > l'ancien haut + 0.15 × ATR. Cassure vers le bas : la clôture < l'ancien bas − 0.15 × ATR. Ancien veut dire le range tel qu'il était après la dernière bougie : le haut et le bas d'un rectangle, ou les bords d'un canal à la dernière bougie.
5. La marge pour les mèches, seulement tant que le range est statique : le rectangle tient encore quand il n'y a pas de cassure et que la hauteur statique ≤ la limite + 0.60 × ATR (soit 3.0 × ATR). Une mèche peut dépasser et étirer le rectangle ; seule une clôture en dehors le casse.
6. Le range se termine quand il contient déjà 150 bougies (n > 150), ou qu'il y a une cassure vers le haut ou vers le bas, ou que ni le statique (avec la marge pour les mèches) ni le dynamique ne tiennent.
7. Sinon, cette bougie rejoint le range. Le rectangle prend en compte son plus haut et son plus bas, et la droite d'ajustement est mise à jour.
8. Le type est choisi de nouveau : dynamique quand le dynamique tient, et que soit le statique (avec la marge pour les mèches) ne tient pas, soit le range n'est pas plat et la hauteur dynamique ≤ 0.85 × static height. Sinon, statique.

Un range qui grandit peut donc passer de STATIC à DYNAMIC, et changer de couleur en même temps.

Ce qui est dessiné

Pendant qu'un range grandit, il est redessiné à chaque bougie clôturée, de sa première bougie jusqu'à la bougie clôturée la plus récente.

L'étiquette pointe vers le bas, vers son emplacement. Elle est remplie avec la couleur du range, transparente à 15 %, avec un texte blanc #FFFFFF en petite taille. Sur un canal en baisse, l'étiquette flotte au-dessus du bout droit du canal, à la hauteur de son bout gauche.

Quand un range se termine

Le range terminé garde le dessin de la bougie d'avant. Son bord droit est la dernière bougie qu'il contient ; la bougie qui l'a terminé n'en fait pas partie. Ensuite :

1. Le changement de couleur, seulement après une cassure. Le bord et le remplissage du rectangle, les bords et le remplissage du canal, les lignes des 25 % et 75 % et l'étiquette deviennent vert bleuté #26A69A après une cassure vers le haut, ou rouge #EF5350 après une cassure vers le bas. Ils gardent leurs transparences (remplissage 92 %, lignes des quarts 40 %, étiquette 15 %). La ligne des 50 % reste rouge. L'étiquette garde son mot.
2. Le prolongement, seulement pour un range dynamique. Deux lignes en tirets de 2 px prolongent le bord du haut et le bord du bas avec la même pente, de la dernière bougie du range jusqu'à 2 bougies plus tard. Elles prennent la couleur finale : vert, rouge, ou bleu clair quand le range s'est simplement arrêté. Une ligne rouge en pointillés de 1 px prolonge la ligne des 50 % de la même façon. Le prolongement se termine une bougie après la bougie qui a terminé le range.
3. Les niveaux : le plafond et le plancher peuvent continuer vers la droite (voir plus bas).

Le plafond est le haut du range à sa dernière bougie ; pour un canal, la valeur du bord du haut à cet endroit. Le plancher est le bas, de la même façon.

• Le plafond continue quand la bougie de fin n'a pas clôturé au-dessus de ceiling + 0.15 × ATR. Le plancher continue quand elle n'a pas clôturé sous floor − 0.15 × ATR.
• Après une cassure vers le haut, seul le plancher continue donc ; après une cassure vers le bas, seul le plafond ; et quand un range s'est simplement arrêté, les deux continuent.
• Un niveau est une ligne plate en tirets, de 1 px, dans la couleur finale, transparente à 20 %. Elle est plate aussi pour un canal.
• Sur chaque bougie clôturée suivante, il s'étend jusqu'à cette bougie. Il s'arrête à la première bougie qui clôture au-dessus de ceiling + 0.15 × ATR (pour un plafond) ou sous floor − 0.15 × ATR (pour un plancher), ou 100 bougies après la dernière bougie du range.
• Un niveau arrêté reste sur le graphique, là où il s'est arrêté.

Combien de dessins restent

Chaque range terminé reste sur le graphique. KAGAMI garde les limites du script d'origine : 500 rectangles, 500 lignes et 500 étiquettes. Au-delà de 500 d'une même sorte, le plus ancien de cette sorte est retiré, quel que soit le range auquel il appartient. Le remplissage d'un canal disparaît quand l'un de ses bords disparaît.

Ce sont les lignes qui s'épuisent en premier. Un range statique laisse jusqu'à 5 lignes ; un range dynamique jusqu'à 10. Sur un long historique, les ranges les plus anciens, à gauche, perdent donc leurs lignes en premier. Un rectangle peut rester sans sa ligne des 50 %.

Paramètres en entrée

KAGAMI n'affiche aucun paramètre pour cet indicateur. Il utilise toujours les valeurs par défaut du script d'origine :

Non proposé dans KAGAMI :

• changer l'une des valeurs ci-dessus ;
• le groupe Moving Averages du script d'origine (MA type, Source, Line width, et trois moyennes mobiles de 20, 50 et 200 bougies). Il est désactivé par défaut dans le script d'origine. KAGAMI ne le dessine pas.

Quand les valeurs changent

• KAGAMI juge seulement les bougies clôturées. La bougie en train de se former ne compte jamais. Rien ne bouge donc pendant qu'une bougie se forme.
• La page demande les dessins aux serveurs de KAGAMI à chaque nouvelle bougie clôturée, et toutes les 60 secondes. Sur les unités de temps très courtes, au plus une fois toutes les 2 secondes.
• Le range qui grandit change à chaque clôture. Son bord droit, son haut, son bas, sa pente, son type et sa couleur peuvent tous changer. Sa première bougie reste la même.
• Un range terminé reste fixe. Seuls ses niveaux continuent de grandir jusqu'à leur arrêt, et les limites de 500 peuvent retirer ses parties les plus anciennes.
• KAGAMI lit jusqu'aux 2 000 dernières bougies et commence les règles à la plus ancienne. Quand de nouvelles bougies arrivent, ce début avance. Les ranges les plus anciens, tout à gauche, peuvent donc changer ou disparaître.

Unités de temps

• Les règles sont les mêmes sur toutes les unités de temps. Elles comptent des bougies, pas des heures. L'ATR vient des bougies du graphique.
• Les unités de temps en secondes (1, 5, 10, 15 et 30 secondes) existent seulement pour les cryptos. Les actions et les devises commencent à 1 minute.
• Les bougies des actions américaines couvrent les heures du marché (09:30–16:00, heure de New York). Les règles ne connaissent pas les séances. Un range peut traverser une nuit ou un week-end, et le saut à l'ouverture compte comme n'importe quel autre mouvement.
• Sur un graphique en 1 seconde, les dessins se mettent à jour au plus une fois toutes les 2 secondes.

Différences avec le script Pine d'origine

KAGAMI dessine les mêmes ranges, lignes, étiquettes et couleurs que le script d'origine avec ses paramètres par défaut. Ce qui diffère :

1. Pas de paramètres. Chaque paramètre est fixé à la valeur par défaut du script d'origine.
2. Pas de moyennes mobiles. Les trois moyennes mobiles en option du script d'origine ne sont pas dessinées. Elles y sont désactivées par défaut.
3. Pas d'alertes. Les deux alertes du script d'origine, pour un range qui se forme et pour un range qui se termine ou qui casse, n'existent pas dans KAGAMI.
4. Toujours les bougies clôturées. Dans TradingView, Evaluate on bar close only peut être désactivé. Dans KAGAMI, il est toujours activé.
5. L'historique. KAGAMI lit jusqu'aux 2 000 dernières bougies. TradingView en a souvent plus. Les ranges les plus anciens peuvent différer.
6. Les données des bougies. KAGAMI utilise ses propres données de marché. Une petite différence dans une bougie peut changer les ranges trouvés.
7. La taille du tick. KAGAMI utilise sa propre règle (voir le calcul). Elle compte seulement dans le test « plat ».
8. Les limites d'objets. TradingView dit que sa limite de 500 est approximative. KAGAMI garde exactement les 500 plus récents de chaque sorte.
9. L'aspect. KAGAMI utilise les outils de dessin du graphique : un rectangle, des lignes de tendance, une forme de canal pour le remplissage et une bulle pour l'étiquette. Les tailles et les polices sont un peu différentes. Vous ne pouvez pas sélectionner, déplacer ni modifier ces dessins, et ils ne sont pas enregistrés.
10. Les points dans le futur. Le prolongement d'un canal peut aller une bougie après la bougie clôturée la plus récente. KAGAMI place ce point une durée de bougie plus tard, en temps d'horloge. TradingView compte des barres.

Cas particuliers

• Moins de 3 bougies clôturées : rien n'est dessiné.
• Les 13 premières bougies n'ont pas d'ATR. Aucun range ne peut donc commencer. Le premier range peut apparaître au plus tôt sur la 14e bougie.
• Des prix qui ne bougent pas du tout : l'ATR vaut 0. Un rectangle de hauteur nulle peut apparaître, et tout mouvement plus tard le termine.
• Un seul range à la fois. Les ranges ne partagent jamais de bougies.
• Les longues périodes calmes : un range se termine à 150 bougies, même si le prix reste calme. Le suivant peut commencer 9 bougies plus tard.
• Les grands sauts de prix font monter l'amplitude vraie, donc l'ATR grandit. Cela élargit les limites pour les bougies suivantes.
• Les bougies manquantes : les règles comptent des bougies. Un trou dans les données est donc simplement sauté.