AG Pro Regression Range Map [AGPro Series]

Mar 24

AG Pro Regression Range Map [AGPro Series]

OVERVIEW

AG Pro Regression Range Map is a statistical corridor overlay built to answer one practical question as clearly as possible: what type of active movement corridor is price traveling in right now?

Instead of treating the market as a sequence of isolated signals, the script models the current price path as a rolling regression backbone surrounded by residual dispersion bands. This allows the chart to be read as a live structure: a directional corridor, a flat corridor, or a weakening corridor that is losing discipline.

The result is a clean visual framework that helps users judge whether price is progressing inside an organized range map or drifting without stable structure. The script is designed as an analytical overlay, not as a forecasting engine.



UNIQUE EDGE

The core idea here is different from indicators that measure simple distance from a moving average, fixed volatility envelopes, or breakout-style event detection.

This script does not ask, “How far is price from a reference?” It asks, “Given the current regression slope and the current residual dispersion, what movement corridor is active now?”

That distinction matters.

The center line is not a generic average. It is a rolling linear regression backbone. The bands are not ATR shells or standard deviation bands around price itself. They are built from the residual dispersion around the active regression backbone. In other words, the script maps drift and dispersion together.

This produces a different analytical lens:
- the backbone defines directional drift
- the corridor width reflects residual dispersion around that drift
- the containment rate shows whether price is respecting that corridor
- the quality score estimates how coherent the corridor currently is

This makes the tool suitable for users who want to evaluate market structure in a disciplined way without turning the chart into a signal-heavy dashboard.

WHAT THE SCRIPT DOES

The script plots:
- a rolling regression backbone
- an inner corridor around that backbone
- an outer corridor around that backbone
- subtle fill to make the active corridor readable without obscuring price
- a compact mini panel with corridor metrics

It also classifies the current corridor state into one of three modes:
- Uptrend Range
- Flat Range
- Downtrend Range

The intention is to show whether price is currently traveling inside an upward corridor, a neutral corridor, or a downward corridor, while also indicating how stable that corridor is.

METHODOLOGY

1) Regression backbone
The center line is a rolling linear regression calculated over the selected lookback window. This backbone is used as the active structural reference for the current chart state.

2) Residual dispersion corridor
After calculating the backbone, the script measures the residual distance between price and the regression line. The standard deviation of those residuals becomes the corridor unit.

The inner and outer bands are then built by multiplying that residual dispersion unit by user-defined multipliers.

This means the corridor is not based on absolute price volatility alone. It is based on how price is dispersing around the active regression path.

3) Normalized slope
The slope of the regression backbone is normalized relative to ATR so the directional reading is more comparable across instruments and conditions.

That normalized slope is then used to classify the corridor as upward, flat, or downward.

4) Containment
Containment measures how consistently price has remained inside the outer corridor over the selected lookback period.

A high containment reading suggests that price is respecting the active corridor. A lower reading suggests that the corridor is less representative of current behavior.

5) Range Width
Range Width expresses the outer corridor width relative to the current center value. This helps users quickly judge whether the active map is relatively tight or relatively wide.

6) Width Stability
Width Stability estimates how stable the corridor width has been over time. This helps distinguish between a corridor that is behaving consistently and one that is expanding or contracting too erratically.

7) Drift Quality
Drift Quality is a composite score derived from containment, normalized slope strength, width stability, and fit quality. It is not a prediction score. It is a structural quality score describing how coherent the active corridor currently is.

HOW TO USE IT

A practical way to read the script is to begin with the mode, then confirm the quality of the structure.

Mode
Start with the mode label:
- Uptrend Range suggests the active regression backbone is rising with enough normalized slope to avoid being treated as flat
- Flat Range suggests directional drift is weak relative to the selected threshold
- Downtrend Range suggests the active regression backbone is declining with enough normalized slope to define a downward corridor

Containment
Then check containment. High containment means price has been spending most of its recent time inside the outer corridor. This usually indicates that the displayed map is representative of the current market path.

Drift Quality
Use Drift Quality to judge whether the active corridor is coherent enough to be worth respecting as a structure. Higher values suggest cleaner organization. Lower values suggest weaker corridor integrity.

Range Width and Width Stability
Use these two together. A corridor can be narrow but unstable, or wide but orderly. The combination is often more informative than either metric alone.

VISUAL INTERPRETATION

In practice, the script is designed to help with questions such as:
- Is price traveling inside an orderly directional corridor or just moving noisily?
- Is the current range map still representative of behavior, or is it degrading?
- Is the structure flat, directional, tight, or loose?
- Is the current drift readable enough to justify a structure-based chart interpretation?

This makes the tool useful for context reading, corridor analysis, and chart organization. It is intentionally restrained in its presentation so price remains the primary object on the chart.

KEY INPUTS

Source
Selects the price source used to build the regression backbone.

Regression Length
Controls the lookback window used for the rolling linear regression center line. Shorter values make the map more reactive. Longer values make it smoother and more structural.

Containment Lookback
Defines the number of bars used to measure how consistently price remains inside the outer corridor.

Inner Band Multiplier
Controls the distance of the inner corridor around the regression backbone.

Outer Band Multiplier
Controls the distance of the outer corridor around the regression backbone.

Flat Threshold
Defines the normalized slope threshold below which the corridor is classified as flat.

Theme Preset
Provides a dark and light visual preset for better chart integration.

Mini Panel Controls
The panel can be shown or hidden and positioned in different chart corners depending on layout preference.

WHAT THIS SCRIPT IS NOT

This script is not a future path projection model.
It does not forecast a target.
It does not mark buy or sell entries.
It does not attempt to predict reversals.
It does not replace execution logic, confirmation logic, or risk management.

Its job is narrower and more disciplined: it maps the active regression corridor and summarizes how coherent that corridor currently is.

LIMITATIONS AND TRANSPARENCY

Like any rolling statistical model, this script is sensitive to lookback selection. Shorter lengths will react faster but may produce more frequent structural changes. Longer lengths will be smoother but slower to adapt.

Because the corridor is recalculated on a rolling basis, the map should be interpreted as a live description of current structure, not as a permanent historical truth.

The script also simplifies market behavior into a corridor framework. Strong news shocks, gap-like behavior, or abrupt volatility expansion can temporarily reduce corridor usefulness.

Drift Quality is a descriptive composite score, not an absolute truth metric. It should be used as context, not as a standalone trading decision.

HOW I THINK IT IS BEST USED

In my view, this tool works best when combined with discretionary chart reading or a broader structured workflow.

Examples:
- use it to decide whether a chart currently deserves trend-continuation thinking or range-neutral thinking
- use it to evaluate whether pullbacks are occurring inside a disciplined corridor or inside a deteriorating structure
- use it to compare the cleanliness of movement across symbols or timeframes
- use it as a chart-organization layer before applying separate execution logic

It is especially useful when the goal is not to chase events, but to understand the condition of the active movement map.

RISK DISCLOSURE

This script is an analytical indicator for chart interpretation. It does not provide financial advice, investment advice, or trading guarantees.

All trading decisions involve risk. Users should evaluate settings, market context, and risk management independently before using any indicator in live decision-making.

Mar 28

Release Notes

UPDATE NOTES - V1.2

This first update focuses on presentation quality, chart readability, and faster visual interpretation.

AG Pro Regression Range Map continues to serve the same core purpose: mapping a rolling regression backbone and its surrounding range structure so users can evaluate directional drift, corridor containment, and range behavior in context. This release does not change that core analytical role. Instead, it improves how the active corridor is emphasized and how the current structure is read directly from the chart.

What changed

• Added Active Focus Zone
A dedicated highlight area now emphasizes the most recent active corridor window. This helps the current regression range stand out more clearly from earlier sections of the chart.

• Added stronger center-line presentation
The regression backbone now has a more visible visual treatment so the active directional path is easier to track at a glance.

• Added corridor edge tags
The current outer range boundaries can now be labeled directly on the chart with Range High and Range Low tags for faster structural reference.

• Added edge tag text-size control
A new setting allows users to adjust edge-tag text size based on screen density, layout preference, and chart zoom conditions.

• Improved edge-tag contrast
The label styling has been refined so the text remains more readable against its background, especially when the chart uses lighter visual presets.

• Refined mini-panel presentation
The summary panel has been updated with clearer visual hierarchy, more deliberate color separation, and better row readability.

• Improved dark-theme readability
Panel contrast has been rebalanced so dark-mode users can read key values more easily without losing the visual identity of the panel.

Why this update was made

The goal of this release is to make the script easier to understand in the first few seconds of viewing the chart. The regression corridor, the active zone, and the current outer boundaries now communicate more directly without changing the underlying framework.

What remains unchanged

• The script remains a regression-range mapping tool, not a prediction engine.
• Core regression, containment, width, and stability calculations remain aligned with the original design.
• This release is primarily a visual and usability refinement.

Notes

As with the original version, this tool is intended to help organize market structure and range behavior on the chart. It should be interpreted together with broader market context, timeframe selection, and the user's own process.

Apr 12

Release Notes

AG Pro Regression Range Map [AGPro Series]
Update Notes - V1.3

This update focuses on visual structure, panel consistency, and chart readability.

• Refined the summary panel with a cleaner single-line title row.
• Aligned the panel layout with the current AG Pro visual standard.
• Set the default panel text size to Small for a more compact chart footprint.
• Kept edge labels at Normal size for better visibility on publish screenshots.
• Added Range High, Range Mid, and Range Low right-edge markers for faster corridor reading.
• Added a Range Position readout to improve active location awareness inside the current regression corridor.
• Improved overall overlay clarity without changing the core regression range mapping purpose of the script.

This update is intended to make the tool easier to read and more consistent in live chart and publish-view usage.

Apr 22

Release Notes

Regression Range Map [AGPro Series] — v2.0 Update Notes

Major visual and engine overhaul.

What's new

– Regime Cycle Memory. Each completed corridor cycle now commits its terminal High, Mid, and Low as horizontal reaction lines, turning the chart into a structural map of past compression and expansion zones.

– Optional Reaction Zones. Thin rectangles can be drawn around each prior cycle's High and Low extremes for a cleaner zone-style read.

– Dual-filter state engine. State classification now requires both slope magnitude and goodness-of-fit to confirm a directional corridor. Reduces false-trend classification during flat drift.

– Trend Fit (R²) score. New 0–100 metric that reflects how cleanly the regression tracks price, surfaced on the panel and used in state logic.

– Minimum Regime Bars filter. Short-lived state flips no longer clutter the map.

– Breakout event marks. Descriptive marks when price closes beyond the outer corridor after a sustained containment phase.

– Alerts added: Upper Range Breakout, Lower Range Breakdown, Mid Line Cross.

Visual refinements

– Full AGPro color palette applied (brand, panel, state colors).
– Dark and Light theme presets.
– Right-edge tags offset to avoid candle overlap.
– Panel reorganized: merged blue header, state-colored rows, Trend Fit metric added, six panel position options, Normal text size default.
– Label text size input added.

Notes

– All marks and levels are descriptive, analytical context only. This script is not a strategy and does not generate trade signals.

Apr 23

Release Notes

v2.1 - Reaction Shelf Update

This update improves the visual hierarchy, chart readability, and structural memory of Regression Range Map while keeping the original regression-corridor concept intact.

What changed:

- Added forward-projected Reaction Shelves around completed regime High and Low levels.
- Reaction Shelves convert completed regression regimes into clean support/resistance style memory zones without adding a separate pivot or S/R engine.
- Reduced the default visual density for a cleaner, more editorial chart view.
- Regime Cycles to Keep now defaults to 3 for a more selective reaction map.
- Breakout Tag Density now defaults to Low to prevent label overload.
- State Shift Tags are now optional and disabled by default.
- Refined breakout tags so they appear more selectively and stay away from candle bodies.
- Improved right-edge Range High, Range Mid, and Range Low labels for better readability.
- Added configurable Shelf Projection Bars and Shelf Thickness controls.
- Added configurable label and panel text sizes, both defaulting to Normal.
- Added optional candle coloring by corridor state, disabled by default.
- Refined the panel with a single merged blue header row and cleaner Reaction Shelves status wording.
- Updated the script title format to Regression Range Map [AGPro Series], with the AG Pro label kept only inside the panel header.
- Improved professional English tooltips across the settings panel.
- Cleaned and optimized the code for a lighter, publication-ready update.

This update does not turn the indicator into a strategy or signal generator. It remains focused on regression corridor context, containment quality, drift structure, and completed-regime reaction mapping.

May 9

Release Notes

🔧 UPDATE NOTES - V2.2

This update focuses on readability, decision-state clarity, publication-quality visuals, and chart usability.

The core purpose of the script remains unchanged.
This release improves how the existing regression range logic is presented, organized, and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added a clearer Range Score framework
The panel now summarizes the active corridor with a 0-100 Range Score and grade. The score combines fit quality, containment, width stability, slope quality, and edge balance into a more readable decision-support layer.

• Added next-action range states
The script now shows clearer action states such as MEAN REVERSION WATCH, TREND RANGE READY, UPPER EDGE REVIEW, LOWER EDGE REVIEW, UP BREAK REVIEW, and DOWN BREAK REVIEW.

• Added an active regression range box
The current regression corridor now includes a subtle projected range box with centered text. This improves first-glance chart interpretation and gives the script a stronger premium publication look.

• Improved reaction shelf readability
Completed regime shelves can now display centered text inside the zones. This makes prior high and prior low reaction shelves easier to identify without adding extra labels.

• Refined label controls
Label density is now controlled with cooldown, maximum label count, and memory settings. This keeps the chart active enough for publication while reducing stale label clutter.

• Improved right-side tags
Right-side tags now include range high, midpoint, range low, and active score. This makes the current regression structure easier to read without relying only on the panel.


------------------------
Visual Improvements
------------------------

• Improved chart readability by adding a cleaner active range box and centered corridor text

• Reduced visual clutter through label cooldown and historical label memory controls

• Refined visual hierarchy so the regression backbone, corridor edges, score tag, and reaction shelves stand out more clearly

• Adjusted right-side tags to avoid hiding inside candles and to make the current range structure easier to read

• Added centered shelf text for prior high and prior low reaction zones


------------------------
Interface & Usability
------------------------

• Optimized the panel layout for faster interpretation

• Replaced a data-heavy panel flow with a more decision-oriented summary

• Improved label readability with adjustable label font size and controlled default density

• Kept panel show/hide, location, theme, and font size controls available

• Preserved the single merged blue AG Pro panel header


------------------------
Behavior Notes
------------------------

This update does not change the core analytical idea of the script.

The goal is to improve clarity, usability, and publication strength, not to introduce predictive behavior.

Users should interpret the script as a regression range context tool. The updated action states are context labels, not trade instructions.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, trend speed, and timeframe selection may affect how regression corridors and reaction shelves appear.

Linear regression channels can adapt quickly during strong directional repricing, so users should interpret outputs within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions, execution, and risk management.

Jun 21

Release Notes

🔧 UPDATE NOTES - v2.3

This update focuses on reliability transparency, label contrast, and right-side tag clarity.

The core purpose of the script remains unchanged. This release adds a self-measured breakout follow-through rate, standardizes label contrast across themes, and removes right-side tag overlap. It continues to function as an analytical and visualization tool. It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added a Breakout Hit Rate readout.
After each breakout review event, the map waits a configurable proof window and checks whether price is still beyond the broken outer corridor in the breakout direction, then reports an honest, self-measured follow-through rate in the panel.

• Standardized label contrast across themes.
Event labels, right-side tags, the active range badge, and the panel state cells now compute readable text color from their background, and shelf text adapts to the active theme, so everything stays legible in both dark and light layouts.

• Fixed right-side tag overlap.
The active score tag is now anchored to the inner band, so it no longer collapses onto the centered Mid tag in a flat range.

• Decluttered the reaction map.
Shelf badges are now anchored at each shelf's own origin so they spread out by time instead of stacking, near-equal-level shelf badges are suppressed so the map never shows two identical labels at the same level, and the default number of retained regime cycles was reduced for a cleaner first-glance view.

• Upgraded the active range label and the reaction-shelf labels to solid centered badges.
The active corridor identity and every Prior High / Prior Low shelf label now render as filled badges with contrast-aware text rather than translucent box text, improving readability and premium feel on every theme.

• Hardened the volatility reference.
The ATR baseline now falls back to true range and a minimum tick on early bars, keeping band sizing, scoring, and label spacing stable from the first candles.


------------------------
Visual Improvements
------------------------

• Removed overlap between the centered Mid tag and the active score tag.

• Improved contrast of every on-chart label, tag, and badge across themes.

• Replaced all translucent box text (active box and reaction shelves) with solid centered badges.

• Preserved the regression backbone, corridors, reaction shelves, and map levels.


------------------------
Interface & Usability
------------------------

• Added a Breakout Hit Rate row to the panel for at-a-glance reliability context.

• Improved readability of every on-chart element across dark and light themes.

• Kept panel layout and information flow consistent and easy to scan.

• Enhanced overall user experience without changing the core regression logic.


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The goal is to improve clarity and reliability transparency, not to introduce new predictive behavior.

Users should interpret outputs the same way as before, now with an added follow-through reference.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, and timeframe differences may affect how corridors, shelves, breakouts, and the hit rate appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.

2 days ago

Release Notes

Version 2.5 – Collision-Safe Evidence Layout

This release resolves visual competition between active-map references, prior shelves, and event evidence while preserving the regression-range model.

• Anchored active range references beyond the projected map edge so the center badge and Mid badge remain independently readable.

• Added ATR-aware vertical clearance between breakout or edge evidence and nearby historical shelf levels.

• Increased repeated-event spacing and shortened edge badge copy to prevent historical badge stacking.

• Widened prior-shelf merge tolerance so materially similar references do not create redundant badges.

• Preserved the existing regression calculation, range score, breakout evidence, alerts, and panel workflow.