Visuals and Logic

This is the page to read when the pane is drawing correctly but you are not yet sure how to read it. Every STR element lives inside one bounded 0 to 100 pane, and that shared frame is what makes the structural extras legible: when the blended fast, the Keltner bands, the BBWP columns, the Donchian corridor, and the divergence markers all occupy the same bounded coordinate system, you can hold them against each other without mentally converting between different scales. That is the architectural bet behind STR, and this page is where it pays off — or fails to, if you read the pane shallowly.

Before the layers, one frame worth naming. The shallow reading of this pane is "green and above 70 is bullish, red and below 30 is bearish." That reading is not categorically wrong; in a clean trending session it can be the correct read. It is also how most readers misuse the indicator, because the pane is built to support a different question. The mature reading is about shape — whether the oscillator is expanding or compressing, whether it is pressing its own envelope, where inside its own range it is sitting, whether it is agreeing or disagreeing with chart price at a confirmed pivot. The shape questions are what STR is actually good at. Whenever you catch yourself doing the shallow read, ask whether the situation genuinely warrants it or whether you are defaulting to the easier read because the pane feels busy.

The pane from back to front

The pane is drawn in layers. From the backmost layer to the frontmost, what you are seeing is:

1. The Keltner envelope around the blended fast line (optional, off by default).

2. The BBWP columns at the base of the pane (on by default).

3. The Donchian corridor around the blended fast line (on by default).

4. The per-slot fast oscillator lines, up to five.

5. The blended fast and blended slow lines, with an area fill between them.

6. The divergence markers, bullish triangles near the floor and bearish triangles near the ceiling.

It helps to see the pane as a stack rather than a list. Something that looks wrong on the front layer is often explained by a behavior on a back layer, and the ordering here is the order in which the information was built.

1. The Keltner envelope (optional)

When enabled, a pair of orange bands appears around the blended fast line, with an optional basis line in the middle. The bands are an oscillator-native envelope — they are drawn from the blended fast line's own range behavior, not from chart-price range. They widen when the oscillator is expanding and contract when it is compressing.

What to look at:

• Band width. A wide band means the oscillator has been moving; a narrow band means it has been still. Narrow bands that persist across many bars can precede a widening event; the bands themselves do not tell you which direction that widening will take.

• Blended fast pressing the upper or lower band. A "hug" on the upper band means the oscillator has been making upward progress at a rate close to the recent average. This is not the same as price making upward progress. Treat it as a report on the oscillator, not on price.

• Band clamp against the pane ceiling or floor. If the upper band is flat against 100 or the lower band is flat against 0, the configuration has pushed the envelope off the useful range. Usually this is a symptom of KC Mult: being too high. The bands are clamped into the pane on purpose; a flat-topped envelope is the tool refusing to lie about where the band actually wants to go.

What not to look at:

• Band tags as reversal signals. A blended fast line touching the upper Keltner is the oscillator at its envelope, not a sell trigger.

• Keltner agreement with a price Keltner plotted separately. The two bands are not measuring the same thing and will disagree often. That is correct behavior.

2. The BBWP columns

When enabled, colored columns rise from 0 at the base of the pane toward 100. Each column represents a percentile rank: where the current width of the blended fast line sits against its own recent history. High columns mean the oscillator has been wide lately compared to its past. Low columns mean the oscillator has been compressed.

What to look at:

• The trend of the columns. A column count that has been rising over several bars is telling you the oscillator is expanding. A column count that has been drifting low for a stretch is telling you the oscillator has been compressed and has been sitting there long enough to rank below most of its past.

• The threshold colour. The colour tells you which side of your threshold each column sits on. It is a visual aid for your eye, not a signal.

• BBWP in combination with the Keltner. Low BBWP usually coincides with narrow Keltner bands. They are two views of the same underlying state. When they disagree, something unusual is happening in the construction and you should recheck whether KC Length and BBWP Length: have been tuned to very different values.

What not to look at:

• BBWP as a read on chart-price volatility. It is not. It is a read on the blended oscillator's width. Price volatility can be rising while BBWP here falls, and vice versa. The two can correlate, but they are not the same statement.

• Column height as a timing signal. A low column says the oscillator has been compressed recently. It does not say expansion is about to happen. It says compression has happened.

• Cranking the threshold until the colours look better. The threshold is cosmetic; the percentile under it does not change.

3. The Donchian corridor

When enabled, a pair of silver step-lines draws the highest and lowest values the blended fast has reached inside the recent lookback window. An optional midpoint can be drawn. The corridor wraps the oscillator's recent range.

What to look at:

• The width of the corridor. Wide corridors mean the oscillator has swung a lot recently; narrow corridors mean it has traded inside a tight range.

• The blended fast tagging the upper or lower line. This says the oscillator has just reached the top or bottom of its recent range. It is a report about the oscillator's geometry, not about price.

• The step behavior. Donchian lines step, not slide. A sudden step down on the upper line means an older, higher value just fell out of the lookback window and a lower one is now the local maximum. Reading the step as "something changed in the market" is incorrect; what changed is what is inside the lookback window.

What not to look at:

• Oscillator-Donchian breakouts as price breakouts. The two are related only loosely. Treat them independently.

• The corridor as a trade envelope. It tells you where the oscillator has been, not where it is going.

4. The per-slot fast oscillator lines

Each enabled slot draws its own fast oscillator line into the same 0 to 100 pane. Up to five colored lines can appear: teal for MA 01, aqua for MA 02, blue for MA 03, orange for MA 04, and yellow for MA 05. Each slot's colour modulates by transparency when its fast is below its slow — a dimmer version of the colour tells you that slot is currently leaning bearish.

What to look at:

• Slot agreement. When all the visible slot lines are drifting in the same direction and at similar speeds, your timeframes are agreeing. That agreement is a useful input — and it is not itself a trade call.

• Slot divergence inside the pane. When the fastest slot is heading one way and the slowest slot is heading the other, your timeframes are disagreeing. That is often where the interesting decisions live. The blend reports the net, but looking at the per-slot lines tells you what is hiding inside that net.

• Slot transparency. A slot going dim means its fast has crossed below its slow. That is a per-slot state change that may or may not be reflected yet in the blend.

What not to look at:

• The per-slot lines as independent signals. Five slots is not five votes. The slots exist so you can see what the blend is resolving.

• A hidden slot as an absent slot. Hidden slots are still contributing to the blend. If you see blend behavior you did not expect, check which slots are enabled with weight even if they are not drawn.

5. The blended fast and blended slow

The blended fast is drawn as a colored line — lime when above the blended slow, red when below — with a soft area fill between it and the blended slow. The blended slow is a steady grey. The fill tints the same colour family as the fast.

What to look at:

• Crosses between blended fast and blended slow. These are state changes in the weighted aggregate. The colour of the blended fast flips when a cross happens.

• Where the cross happens inside the pane. A cross inside the middle band (between 30 and 70) reads very differently from a cross near the overbought or oversold guide. The pane provides the geography; you still supply the interpretation.

• The gap between fast and slow. A wide gap means the fast is pulling ahead of the slow; a narrow gap means they are drifting together. The fill makes this easy to see at a glance.

• Master Smoothing, if on. If you enabled smoothing, the blended fast and slow are one smoothing pass removed from the true blend. Crosses will be reported a bar late relative to the unsmoothed blend. This is the price you accepted when you turned smoothing on.

What not to look at:

• Blend colour alone. Green-and-above-70 is not a verdict. Look at BBWP, Keltner position, and recent divergence before you call it a continuation.

• Single-slot blends. If your weights collapse to one slot, the "blend" is a single-slot read with a different label on it. The colour still flips; the meaning of the flip has changed.

6. The divergence markers

Bullish divergence prints as a small lime triangle near the pane floor, and bearish divergence prints as a small red triangle near the ceiling. Each triangle marks a confirmed pivot where the blended fast line disagreed with chart price.

What the marker says:

• Bullish. Chart price made a lower low at the pivot, and the blended fast made a higher low at the same pivot. Momentum, expressed through this oscillator, did not confirm price's new low.

• Bearish. Chart price made a higher high at the pivot, and the blended fast made a lower high. Momentum did not confirm price's new high.

Where the marker is drawn:

• With Plot On Pivot? off (default). The triangle appears on the confirmation bar, which is Pivot Len: bars after the pivot itself. This is the most honest presentation because the divergence only became knowable on the confirmation bar.

• With Plot On Pivot? on. The triangle is back-offset to rest on the pivot bar. The information is the same; the drawing has moved.

What the marker is not:

• A reversal call. A confirmed divergence is the oscillator and price telling different stories at a pivot. What price does next is not in the triangle.

• A high-frequency event. Divergence triangles are supposed to be rare; if yours are appearing often, Pivot Len: is probably too short.

• A read on the developing bar. Divergence is computed on confirmed bars only.

See MTF and Repainting for the full confirmation walk-through and the cost of reading a back-offset triangle as "early."

The shallow read vs the mature read

A worked example makes this concrete. Suppose the blended fast is lime, above the 70 overbought guide, and holding there. The shallow reading says "this is bullish and extending." The mature reading pulls in more of the pane:

• Is BBWP low? If the BBWP columns are well below their threshold and have been for several bars, the oscillator is extending into overbought on compressed oscillator volatility. That combination is a "fast-unwind risk" pattern, not a clean continuation. The oscillator is stretched on a tight range.

• Is the Keltner upper band hugging the blended fast? A tight hug reinforces the compression read; the oscillator is pressing its own envelope and that envelope is narrow.

• Is a bearish divergence triangle recent? If one printed one or two confirmed price pivots ago, the oscillator has already disagreed with price at a high. That disagreement may or may not resolve into a reversal; the triangle is a context bar, not a trigger.

The mature read is not "sell this." It is "I see a stretched but compressed read that has already produced one divergence. Continuation is possible, but the conditions for a fast unwind are stacked. I want confirmation of either outcome before I commit: I will watch for the blended fast to roll through the slow, or for BBWP to start rising as expansion returns."

That kind of read is what STR is built for. The shallow read is fine in clean trending conditions. The moment the pane becomes interesting, you want the mature read to be available in the same frame.

Interpretation under conflict

Three conflict patterns come up often enough that they are worth teaching directly. Each one has a correct read and a common misread.

Conflict 1 — BBWP low while blend is near overbought

The blended fast is above 70, lime, and pressing forward. The BBWP columns are well under the threshold and have been for a while.

• Correct read. The oscillator has extended into overbought but its own width has been compressed. That is a stretched reading on a tight range. It resolves in one of two ways: either width starts to rise (expansion confirms the move) or the blended fast rolls back (unwind resolves the stretch). You do not know which in advance.

• Common misread. "Momentum is strong." Height is not strength. Height with low width is stretch. Strength shows up as height and expanding width.

Conflict 2 — Alignment bullish while divergence is bearish

All the visible per-slot lines are above their slow lines (all-slots-bullish alignment). A bearish divergence triangle printed recently.

• Correct read. Every timeframe is currently leaning bullish, but at the last confirmed high the oscillator disagreed with price. The alignment says "right now, we are all leaning the same way." The divergence says "at the last pivot, that lean did not match price's new high." Those are different statements about different moments in time and they are allowed to coexist.

• Common misread. Treating alignment as confirmation that the divergence is wrong, or treating the divergence as confirmation that alignment is wrong. Neither is a signal to cancel the other.

Conflict 3 — Keltner hug while Donchian is still inside range

The blended fast is pressing the upper Keltner band. The Donchian upper line is still well above the current read.

• Correct read. The oscillator is expanding inside its recent range but has not yet tagged its recent high. The hug says "expansion is happening now." The Donchian position says "there is headroom in the recent range." Together they suggest the oscillator is still inside its recent regime even though it is stretching inside that regime.

• Common misread. Reading the Keltner hug as a breakout because it looks dramatic. It is a press against the short-range envelope, not a break through the recent range. The Donchian is reporting the recent range directly; trust it for that question.

What state changes matter, what state changes do not

A fast and useful habit when reading the pane is learning which transitions demand attention and which are background noise.

State changes worth noticing:

• Blended fast crossing blended slow near or inside the middle band (between 30 and 70). These are the cleanest state changes because the pane is not already stretched.

• BBWP crossing its threshold in the direction of expansion after a compressed stretch. This reports that width is starting to rise, which is the condition that precedes a directional release — either up or down.

• Per-slot alignment flipping — all slots becoming bullish or bearish together after disagreement. The flip says the timeframes have converged.

• A divergence triangle printing at an extreme (well above 70 or below 30). Divergences at extremes are the ones most likely to matter because the oscillator has more room to unwind.

State changes that are often cosmetic:

• A per-slot line briefly dipping dim near a cross when the fast and slow are already nearly coincident. That transparency flip is accurate but not load-bearing.

• A Donchian step when an older extreme falls out of the lookback window. What changed is what is in the window, not what is in the market.

• BBWP columns changing colour while still hovering close to the threshold. That is a threshold effect, not a width change worth acting on.

How to pull the layers back together

The pane is built so that no single element carries the decision. If you are reading well, at any moment you can state six things:

• Where the blended fast sits inside the pane — basement, middle band, or upper band.

• Whether the blended fast is above or below the blended slow, and where inside the pane the last cross happened.

• Whether BBWP is compressed, expanded, or drifting through the middle right now, and whether it has been trending in one direction over the last several bars.

• Whether the Keltner envelope is wide or narrow, and whether the blended fast is pressing a band or sitting in the middle.

• Where the blended fast is sitting inside the Donchian corridor — against an edge, against the basis, or somewhere in between.

• Whether a divergence printed recently, at what level inside the pane, and whether the price pivot it marked stood out or was shallow.

None of those six statements alone is an action. Together they form a reading, and the discipline of naming each one — even silently, in your own head — is what separates reading the pane from being decorated by it. When a fast decision is in front of you and the pane feels ambiguous, it is almost always because one of the six has gone unstated. Find the missing one. The decision will either resolve or defer, and both outcomes are better than the third, which is acting on an incomplete read and finding out later which statement you should have made.

It is worth practicing the six in calm conditions where the stakes are low, so that the habit is already in place when a session is loud. Readers who try to learn the read under pressure usually learn it as a different habit — one that collapses the six into a shorter checklist under stress and loses exactly the statements the pane exists to support.