Donchian-Channels-Trend/README.md

### 🇺🇸 English

### Donchian Channels Trend v1.0
A trend-following breakout indicator that encapsulates price action within a dynamic envelope based on historical highs and lows. Originally conceptualized for TradingView, this tool provides a clear visualization of the directional bias using state memory.

**How it works**
The algorithm calculates the absolute maximum and minimum values over a specified lookback period. It utilizes a finite state machine (FSM) to maintain the current trend direction based on structural price breaks:
* **Bullish State**: Activated when the current price high crosses above the previous period's upper band.
* **Bearish State**: Activated when the current price low crosses below the previous period's lower band.

**Visual features**
* Upper and Lower dynamic threshold bands.
* Central Basis line representing the median point.
* Dynamic color routing that changes the entire channel's color based on the active trend state.
* Signal generation on trend shifts.

**Parameters**

| Parameter | Default | Description |
| :--- | :--- | :--- |
| `InpLength` | 20 | Lookback period for calculating highs and lows. |
| `InpEnableAlerts` | false | Master switch to enable or disable all alerts. |
| `InpAlertPopup` | true | Enables terminal popup alerts. |
| `InpAlertSound` | true | Enables sound notifications. |
| `InpAlertPush` | false | Enables push notifications to the mobile terminal. |
| `InpAlertEmail` | false | Enables email notifications. |

**Key characteristics**
* Non-repainting logic: state changes are confirmed only upon bar close.
* Consistent operation across both MQL4 and MQL5 environments.
* Multi-channel structured alert system.
* Compatible with any timeframe and financial instrument.

**Original source**
Ported from the TradingView Pine Script "Donchian Channels Trend" developed by `holdon_to_profits`.

---

### 🇲🇽 Español

### Donchian Channels Trend v1.0
Un indicador de seguimiento de tendencias basado en rupturas que encapsula la acción del precio dentro de una envolvente dinámica determinada por máximos y mínimos históricos. Originalmente conceptualizado para TradingView, esta herramienta proporciona una visualización clara del sesgo direccional utilizando memoria de estado.

**Cómo funciona**
El algoritmo calcula los valores máximos y mínimos absolutos durante un período retrospectivo específico. Utiliza una máquina de estados finitos (FSM) para mantener la dirección de la tendencia actual basada en rupturas estructurales del precio:
* **Estado Alcista**: Se activa cuando el máximo del precio actual cruza por encima de la banda superior del período anterior.
* **Estado Bajista**: Se activa cuando el mínimo del precio actual cruza por debajo de la banda inferior del período anterior.

**Características visuales**
* Bandas dinámicas de umbral superior e inferior.
* Línea base central que representa el punto medio.
* Enrutamiento de color dinámico que cambia el color de todo el canal según el estado de tendencia activo.
* Generación de señales en los cambios de tendencia.

**Parámetros**

| Parámetro | Por defecto | Descripción |
| :--- | :--- | :--- |
| `InpLength` | 20 | Período retrospectivo para el cálculo de máximos y mínimos. |
| `InpEnableAlerts` | false | Interruptor principal para habilitar o deshabilitar todas las alertas. |
| `InpAlertPopup` | true | Habilita alertas emergentes en el terminal. |
| `InpAlertSound` | true | Habilita notificaciones de sonido. |
| `InpAlertPush` | false | Habilita notificaciones push al terminal móvil. |
| `InpAlertEmail` | false | Habilita notificaciones por correo electrónico. |

**Características clave**
* Lógica sin repintado: los cambios de estado se confirman solo al cierre de la vela.
* Operación consistente en entornos MQL4 y MQL5.
* Sistema estructurado de alertas multicanal.
* Compatible con cualquier marco temporal e instrumento financiero.

**Fuente original**
Adaptado del Pine Script de TradingView "Donchian Channels Trend" desarrollado por `holdon_to_profits`.

---

### 🇷🇺 Русский

### Donchian Channels Trend v1.0
Индикатор следования за трендом на основе пробоев, который заключает ценовое движение в динамическую оболочку, основанную на исторических максимумах и минимумах. Изначально созданный для TradingView, этот инструмент обеспечивает четкую визуализацию направления тренда с использованием памяти состояний.

**Как это работает**
Алгоритм вычисляет абсолютные максимальные и минимальные значения за заданный период ретроспективного анализа. Он использует конечный автомат (FSM) для сохранения текущего направления тренда на основе структурных пробоев цены:
* **Бычье состояние**: Активируется, когда текущий максимум цены пересекает верхнюю полосу предыдущего периода снизу вверх.
* **Медвежье состояние**: Активируется, когда текущий минимум цены пересекает нижнюю полосу предыдущего периода сверху вниз.

**Визуальные характеристики**
* Динамические верхняя и нижняя пороговые полосы.
* Центральная базовая линия, представляющая среднюю точку.
* Динамическое изменение цвета всего канала в зависимости от активного состояния тренда.
* Генерация сигналов при смене тренда.

**Параметры**

| Параметр | По умолчанию | Описание |
| :--- | :--- | :--- |
| `InpLength` | 20 | Период для расчета максимумов и минимумов. |
| `InpEnableAlerts` | false | Главный переключатель для включения или отключения всех алертов. |
| `InpAlertPopup` | true | Включает всплывающие оповещения в терминале. |
| `InpAlertSound` | true | Включает звуковые уведомления. |
| `InpAlertPush` | false | Включает push-уведомления на мобильный терминал. |
| `InpAlertEmail` | false | Включает уведомления по электронной почте. |

**Ключевые особенности**
* Логика без перерисовки: изменения состояния подтверждаются только по закрытию бара.
* Стабильная работа в средах MQL4 и MQL5.
* Многоканальная структурированная система оповещений.
* Совместимость с любым таймфреймом и финансовым инструментом.

**Оригинальный источник**
Адаптировано из скрипта TradingView Pine "Donchian Channels Trend", разработанного `holdon_to_profits`.

---

### 🇯🇵 日本語

### Donchian Channels Trend v1.0
過去の高値と安値に基づく動的なエンベロープ内に価格アクションをカプセル化する、ブレイクアウトベースのトレンドフォローインジケーターです。元々はTradingView用に概念化されたこのツールは、状態メモリを使用して方向性のバイアスを明確に視覚化します。

**仕組み**
アルゴリズムは、指定されたルックバック期間における絶対的な最大値と最小値を計算します。構造的な価格のブレイクに基づいて現在のトレンド方向を維持するために、有限状態機械（FSM）を利用します。
* **強気状態**: 現在の価格の高値が、前の期間のアッパーバンドを上抜けたときにアクティブになります。
* **弱気状態**: 現在の価格の安値が、前の期間のロワーバンドを下抜けたときにアクティブになります。

**視覚的機能**
* 動的なアッパーバンドとロワーバンド。
* 中間点を表す中央のベースライン。
* アクティブなトレンド状態に基づいてチャネル全体の色を変更する動的なカラーリング。
* トレンド転換時のシグナル生成。

**パラメーター**

| パラメーター | デフォルト | 説明 |
| :--- | :--- | :--- |
| `InpLength` | 20 | 高値と安値を計算するためのルックバック期間。 |
| `InpEnableAlerts` | false | すべてのアラートを有効または無効にするマスタースイッチ。 |
| `InpAlertPopup` | true | ターミナルのポップアップアラートを有効にします。 |
| `InpAlertSound` | true | 音声通知を有効にします。 |
| `InpAlertPush` | false | モバイル端末へのプッシュ通知を有効にします。 |
| `InpAlertEmail` | false | 電子メール通知を有効にします。 |

**主な特徴**
* リペイントなしのロジック：状態の変化はバーの確定時（クローズ時）にのみ確認されます。
* MQL4およびMQL5環境での一貫した動作。
* マルチチャネルの構造化されたアラートシステム。
* 任意のタイムフレームおよび金融商品と互換性があります。

**元のソース**
`holdon_to_profits`によって開発されたTradingViewのPineスクリプト「Donchian Channels Trend」から移植されました。

---

### 🇨🇳 中文

### Donchian Channels Trend v1.0
基于突破的趋势跟踪指标，它将价格行为封装在基于历史高点和低点的动态包络线中。该工具最初为TradingView设计，通过使用状态记忆提供方向偏差的清晰可视化。

**工作原理**
该算法计算指定回溯期内的绝对最大值和最小值。它利用有限状态机 (FSM) 根据结构性价格突破来维持当前的趋势方向：
* **看涨状态**：当当前价格高点向上突破前一期的上轨时激活。
* **看跌状态**：当当前价格低点向下突破前一期的下轨时激活。

**视觉特征**
* 动态的上下阈值通道线。
* 代表中点的中心基准线。
* 基于当前活动趋势状态改变整个通道颜色的动态颜色路由。
* 趋势转换时生成信号。

**参数**

| 参数 | 默认值 | 描述 |
| :--- | :--- | :--- |
| `InpLength` | 20 | 用于计算高点和低点的回溯期。 |
| `InpEnableAlerts` | false | 启用或禁用所有警报的主开关。 |
| `InpAlertPopup` | true | 启用终端弹出警报。 |
| `InpAlertSound` | true | 启用声音通知。 |
| `InpAlertPush` | false | 启用发送到移动终端的推送通知。 |
| `InpAlertEmail` | false | 启用电子邮件通知。 |

**主要特点**
* 无重绘逻辑：状态变化仅在K线收盘时确认。
* 在MQL4和MQL5环境中的一致操作。
* 多渠道结构化警报系统。
* 兼容任何时间范围和金融工具。

**原始来源**
从`holdon_to_profits`开发的TradingView Pine脚本“Donchian Channels Trend”移植而来。

---

### 🇧🇷 Português

### Donchian Channels Trend v1.0
Um indicador de acompanhamento de tendência baseado em rompimentos que encapsula a ação do preço dentro de um envelope dinâmico determinado por máximas e mínimas históricas. Originalmente conceituado para o TradingView, esta ferramenta fornece uma visualização clara do viés direcional usando memória de estado.

**Como funciona**
O algoritmo calcula os valores máximos e mínimos absolutos durante um período de lookback especificado. Ele utiliza uma máquina de estados finitos (FSM) para manter a direção da tendência atual com base em rompimentos estruturais de preços:
* **Estado de Alta (Bullish)**: Ativado quando a máxima do preço atual cruza acima da banda superior do período anterior.
* **Estado de Baixa (Bearish)**: Ativado quando a mínima do preço atual cruza abaixo da banda inferior do período anterior.

**Características visuais**
* Bandas de limite superior e inferior dinâmicas.
* Linha de base central representando o ponto médio.
* Roteamento dinâmico de cores que altera a cor de todo o canal com base no estado da tendência ativa.
* Geração de sinais em mudanças de tendência.

**Parâmetros**

| Parâmetro | Padrão | Descrição |
| :--- | :--- | :--- |
| `InpLength` | 20 | Período de lookback para calcular máximas e mínimas. |
| `InpEnableAlerts` | false | Chave principal para ativar ou desativar todos os alertas. |
| `InpAlertPopup` | true | Ativa alertas pop-up no terminal. |
| `InpAlertSound` | true | Ativa notificações sonoras. |
| `InpAlertPush` | false | Ativa notificações push para o terminal móvel. |
| `InpAlertEmail` | false | Ativa notificações por e-mail. |

**Características principais**
* Lógica sem repintura (no-repaint): as mudanças de estado são confirmadas apenas no fechamento da barra.
* Operação consistente nos ambientes MQL4 e MQL5.
* Sistema de alerta estruturado multicanal.
* Compatível com qualquer tempo gráfico e instrumento financeiro.

**Fonte original**
Adaptado do Pine Script do TradingView "Donchian Channels Trend" desenvolvido por `holdon_to_profits`.

---

### 🇰🇷 한국어

### Donchian Channels Trend v1.0
과거의 고점과 저점을 기반으로 하는 동적 엔벨로프 내에 가격 움직임을 캡슐화하는 돌파 기반 추세 추종 지표입니다. 원래 TradingView용으로 개념화된 이 도구는 상태 메모리를 사용하여 방향성 편향의 명확한 시각화를 제공합니다.

**작동 방식**
알고리즘은 지정된 룩백(lookback) 기간 동안의 절대적인 최대값과 최소값을 계산합니다. 구조적인 가격 돌파를 기반으로 현재 추세 방향을 유지하기 위해 유한 상태 기계(FSM)를 활용합니다.
* **강세 상태**: 현재 가격의 고점이 이전 기간의 상단 밴드를 상향 돌파할 때 활성화됩니다.
* **약세 상태**: 현재 가격의 저점이 이전 기간의 하단 밴드를 하향 돌파할 때 활성화됩니다.

**시각적 특징**
* 동적인 상단 및 하단 임계 밴드.
* 중간점을 나타내는 중앙 기준선.
* 활성 추세 상태에 따라 채널 전체의 색상을 변경하는 동적 색상 라우팅.
* 추세 전환 시 시그널 생성.

**매개변수**

| 매개변수 | 기본값 | 설명 |
| :--- | :--- | :--- |
| `InpLength` | 20 | 고점과 저점을 계산하기 위한 룩백 기간. |
| `InpEnableAlerts` | false | 모든 알림을 활성화하거나 비활성화하는 마스터 스위치. |
| `InpAlertPopup` | true | 터미널 팝업 알림을 활성화합니다. |
| `InpAlertSound` | true | 소리 알림을 활성화합니다. |
| `InpAlertPush` | false | 모바일 터미널로의 푸시 알림을 활성화합니다. |
| `InpAlertEmail` | false | 이메일 알림을 활성화합니다. |

**주요 특징**
* 리페인트 방지 로직: 상태 변화는 캔들 마감 시에만 확인됩니다.
* MQL4 및 MQL5 환경에서 일관된 작동.
* 다중 채널 구조화된 알림 시스템.
* 모든 시간대 및 금융 상품과 호환 가능.

**원본 출처**
`holdon_to_profits`가 개발한 TradingView 파인 스크립트 "Donchian Channels Trend"에서 이식되었습니다.