Gann Matrix Pro

Here is the English description for your MQL5 publication or repository:

Gann Matrix Pro + Levels & Alerts Indicator is an analytical tool for MetaTrader 5 designed to automatically or manually project price and time targets based on W.D. Gann's core balancing principles (Square of 9 / Price-Time Equilibrium).

The indicator measures impulse geometry, projects a dynamic ray fan, identifies future time reversal points, and draws static horizontal support/resistance levels with customizable alerts.

User Guide for MQL5

1. Calculation Modes ( InpCalcMode )

• MODE_ZIGZAG (Automatic): The indicator identifies the latest two swings of the built-in ZigZag indicator and automatically draws the matrix over the active price impulse. As new peaks or troughs form, the projections update dynamically.

• MODE_MANUAL (Drag & Drop): Places a base trendline on your chart (blue by default). You can manually attach its endpoints to any wave of interest (e.g., from a major low to a high) on any timeframe.

2. Understanding Graphic Elements

• Base Segment (Blue): The core market impulse that defines the primary price ($\Delta P$) and time ($\Delta T$) range.

• Vertical Line (Magenta Dot): Future time projection ($T_{future} = T_2 + \Delta T$). Represents the exact time bar where the wave completes its full time cycle.

• Angled Rays (Gann Fan):

  • 1:1 (Red): Primary equilibrium ray ($100\%$ price over $100\%$ time).

  • 1:2 (Green): Accelerated ray ($200\%$ price over $100\%$ time).

  • 2:1 (Orange): Decelerated ray ($50\%$ price over $100\%$ time).

• Horizontal Levels (Support / Resistance): Static lines extending rightwards through the intersection points of the Gann rays and the future time vertical line. They highlight target price zones where the market seeks balance.

3. Trading Scenarios & Application Logic

1. Target Identification (Take Profit):

   During corrections or trend continuations, horizontal levels act as price magnets. The strongest bounce reactions typically occur at the $2:1$ (orange) and $1:1$ (red) horizontal support/resistance levels.

2. Confluence Points (Price + Time):

   High-probability reversal setups occur when price simultaneously touches an angled ray near a horizontal price level or the vertical time axis.

3. Multi-Timeframe Analysis:

   Plot the matrix on a higher timeframe (e.g., D1) and switch down to lower timeframes (H1, M15). The horizontal levels and angled rays remain in place, providing macro support/resistance zones for intraday trades.

4. Alert System Settings

The indicator calculates real-time proximity between price and the Gann rays:

• InpDistancePips: Touch tolerance zone in pips/points (default: 5).

• Notification Channels: Supports native MT5 pop-ups ( PopUp ), sound files ( Sound ), and mobile push notifications ( Push ).

5. Key Input Parameters