# Angora Pattern Recognition · Руководство пользователя

Angora Pattern Recognition — это индикатор cTrader, который автоматически находит, рисует и отслеживает классические графические модели. Для каждой модели он показывает оценку, состояние, уровень пробоя, цель и уровень аннулирования.

> Этот индикатор является инструментом анализа, а не инвестиционной рекомендацией. Оценки и цели основаны на прошлой геометрии цен; они не гарантируют будущие цены.

## 1. Установка

1. Купите и установите индикатор из cTrader Store (или дважды щелкните файл `.algo`).

2. Откройте график и выберите **AngoraPatternRecognition** в меню **Indicators**.

3. Проверьте настройки и нажмите **OK**. Значения по умолчанию подходят для большинства символов и таймфреймов.

## 2. Как это работает

**Используются только закрытые свечи.** Свеча, которая еще формируется, никогда не попадает в движок. Следовательно, модель, нарисованная на графике, никогда не смещается, не перемещается и не исчезает сама по себе (нет перерисовки). Единственное, что меняется — это её состояние, например, с COMPLETED на CONFIRMED.

**Модель рисуется после её формирования.** Swing high или low подтверждается только после закрытия **Swing Length** свечей и отката цены минимум на **Swing Sensitivity** × ATR. Модель появляется, когда подтверждается последний свинг. На историческом графике все модели появляются одновременно, что может выглядеть как предвидение; чтобы увидеть последовательность в реальном времени, запустите индикатор в визуальном бэктестинге cTrader и переходите свеча за свечой.

**Для ранних предупреждений** включите слой Forming (раздел 6). Этот слой перерисовывается и рисуется отдельным цветом.

**Меры на основе ATR.** Все допуски выражены в ATR (Average True Range), поэтому одинаковые настройки ведут себя схоже на EURUSD, золоте или BTC, на M15 или дневных графиках.

## 3. Модели

| Модель | Направление | Уровень пробоя | Аннулирование | Цель |

| --- | --- | --- | --- | --- |

| Double Top | Медвежье | Минимум между вершинами (шея) | Выше более высокой вершины | Шея − высота модели |

| Double Bottom | Бычье | Максимум между впадинами | Ниже более низкой впадины | Шея + высота модели |

| Head & Shoulders | Медвежье | Шея через две впадины (может быть наклонена) | Выше головы | Шея − расстояние от головы до шеи |

| Inverse H&S | Бычье | Шея через два пика | Ниже головы | Шея + расстояние от головы до шеи |

| Ascending Triangle | Бычье | Плоская верхняя линия | Восходящая нижняя линия; после пробоя — последний минимум | Пробой + самая широкая часть треугольника |

| Descending Triangle | Медвежье | Плоская нижняя линия | Нисходящая верхняя линия; после пробоя — последний максимум | Пробой − самая широкая часть треугольника |

| Symmetrical Triangle | Любое | Линия, которая пробивается | Противоположная линия; после пробоя — последний свинг с другой стороны | Пробой ± самая широкая часть треугольника |

| Rising Wedge | Медвежье | Восходящая нижняя линия | Верхняя линия | Пробой − самая широкая часть клина |

| Falling Wedge | Бычье | Нисходящая верхняя линия | Нижняя линия | Пробой + самая широкая часть клина |

| Rectangle | Любое | Линия, которая пробивается | Противоположная линия | Пробой ± высота диапазона |

Треугольники и клинья должны пробиваться в пределах первых 75% пути от первого касания до вершины, где сходятся границы линий (**Triangle Breakout Window**). Пробои очень близко к вершине считаются слабыми, поэтому модель, чей последний свинг уже за этой точкой, не показывается, а та, что не пробивается вовремя, истекает.

Цели — это ориентировочные уровни по классическому методу измеренного движения, а не гарантированные ценовые цели.

## 4. Состояния и цвета

| Состояние | Значение | Цвет |

| --- | --- | --- |

| COMPLETED | Модель сформирована, ожидается пробой | Оранжевый |

| AWAITING RETEST | Пробой произошел, ожидается повторное тестирование (только режим CloseAndRetest) | Оранжевый |

| CONFIRMED | Пробой подтвержден; отображается линия цели | Зеленый при бычьем, красный при медвежьем |

| INVALIDATED | Цена закрылась за уровнем аннулирования до пробоя | Серый (если отображается) |

| EXPIRED | Пробой не произошел вовремя | Серый (если отображается) |

| FAILED BREAKOUT | После подтверждения цена закрылась обратно за уровнем аннулирования | Серый (если отображается) |

Метка показывает название модели, оценку и состояние, например `Rising Wedge 68 CONFIRMED`.

**Оценка (0–100)** измеряет, насколько форма соответствует учебной модели: структура, геометрия, симметрия, объем, контекст тренда и сила пробоя. Это не вероятность успеха.

## 5. Панель моделей

Панель в левом верхнем углу показывает активные модели, сначала с лучшей оценкой (до 5). Когда включен слой Forming, формирующиеся модели перечислены ниже в разделе "forming". Отключите её с помощью **Show Pattern Panel**.

## 6. Слой формирования (раннее предупреждение)

По умолчанию выключен. При включении **Show Forming Patterns** индикатор на каждой закрытой свече спрашивает: "В каком ценовом диапазоне должен сформироваться следующий swing high или low, чтобы завершить модель?"

- Часть модели, уже сформированная, рисуется пунктиром; ожидаемый диапазон для недостающего свинга — затемнённый прямоугольник.

- Метка показывает `Double Top? 72 FORMING` или `IN ZONE`, если цена уже внутри прямоугольника.

- **Эти предупреждения перерисовываются:** они меняются по мере развития цены и исчезают при пробое. Подтверждённые модели не затрагиваются.

- На исторических данных около 15–21% предупреждений превращались в реальные модели, и 30–34% после входа цены в зону. Используйте их как список для наблюдения, а не как торговые сигналы.

## 7. Оповещения

| Настройка | По умолчанию | Описание |

| --- | --- | --- |

| Alert On New Pattern | Off | При появлении новой модели |

| Alert On Confirmation | On | При подтверждении модели пробоем |

| Alert On Failure | Off | При провале подтверждённой модели |

| Popup Alert | On | Всплывающее уведомление в cTrader |

| Sound Alert | On | Звуковое уведомление |

Оповещения срабатывают только на живых данных; загрузка графика не вызывает оповещения по историческим моделям.

## 8. Настройки

### Обнаружение

| Настройка | По умолчанию | Описание |

| --- | --- | --- |

| Swing Length | 5 | Количество свечей с каждой стороны свинга для проверки. Большее значение находит меньше, но крупнее модели, и свинги подтверждаются позже. |

| Swing Sensitivity (ATR) | 1.0 | Минимальное движение между двумя свингами. Большее значение игнорирует мелкие колебания. |

| Minimum Pattern Score | 50 | Модели с оценкой ниже скрываются. Значение около 65 даёт более избирательный вид. |

| Maximum Pattern Age (bars) | 60 | Количество свечей после последнего свинга модели, в течение которых должен произойти пробой. |

### Допуски

| Настройка | По умолчанию | Описание |

| --- | --- | --- |

| Price Tolerance (ATR) | 0.75 | Допустимая разница между двумя вершинами/впадинами для Double Top/Bottom. |

| Symmetry Tolerance (ATR) | 1.5 | Допустимая разница между двумя плечами Head & Shoulders. |

| Trendline Deviation (ATR) | 0.5 | Насколько далеко свинг может находиться от линии треугольника/клина/прямоугольника и считаться касанием. |

| Triangle Breakout Window (%) | 75 | Доля пути до вершины, в пределах которой треугольники и клинья могут пробиваться. |

| Minimum Pattern Height (ATR) | 2.0 | Меньшие модели игнорируются. |

| ATR Period | 14 | Период ATR. |

### Подтверждение

| Настройка | По умолчанию | Описание |

| --- | --- | --- |

| Breakout Mode | CandleClose | **CandleClose:** одно закрытие за уровнем пробоя. **TwoCandleClose:** два закрытия подряд. **CloseAndRetest:** одно закрытие, затем цена возвращается к уровню и удерживается. |

| Volume Confirmation | Off | Объем тиков свечи пробоя должен быть не меньше среднего за предыдущие 20 свечей. Пропускается, если данные не содержат объем. |

### Модели

Каждую модель можно включить или выключить.

### Отображение и цвета

Метки, оценка, линии модели, цели, уровень аннулирования, проваленные модели, линии свингов и метки (HH/HL/LH/LL), развивающийся свинг и панель — всё можно включать и выключать. Цвета принимают имя (`LimeGreen`) или шестнадцатеричный код (`#32CD32`).

## 9. FAQ

**Почему модель появляется через несколько свечей после последней вершины?** Свинг подтверждается только после закрытия Swing Length свечей. Уменьшите Swing Length или включите слой Forming, чтобы видеть модели раньше.

**Меняются ли модели при повторном открытии графика?** Нет. Те же данные и настройки всегда дают одинаковый результат. Изменение настроек пересчитывает модели.

**Я вижу слишком много моделей.** Повышайте Minimum Pattern Score до 60–65 и Minimum Pattern Height до 3, или отключайте модели, которые не используете.

**Я не вижу моделей.** Убедитесь, что на графике достаточно истории (не менее нескольких сотен свечей) и понизьте Minimum Pattern Score.