FreeOpen sourcePine Script v6
Keep canonical Parabolic SAR visible while examining extreme-point distance, run age, observed acceleration and the part of a free SAR step removed by the prior-two-bar guardrail.
The plotted series remains ta.sar(). The study does not adapt SAR, filter side changes, optimize factors or rank opportunities. It distinguishes runs observed from their beginning from runs already underway when tracking starts.
Defaults show cyan/pink SAR dots, green/amber extreme traces, translucent arc fill, small side-change markers, yellow material-constraint halos and a compact upper-right panel. Candidate points, bridges, midline, origin line and detailed labels are optional.
Free candidate = previous SAR + previous observed AF × (previous EP − previous SAR). Below price, the guarded candidate is the minimum of the candidate and prior two lows; above price, the maximum with prior two highs. Related percentages require agreement with ta.sar() within tolerance.
Arc = abs(SAR − tracked EP). Retention = 100 × current arc / widest arc in this run. Defaults enter TIGHT after five bars at or below 35%; release requires a new EP and at least 55% retention. Crossing 35% alone does not release the state.
Load = 100 × removed distance / free step. TX = 100 × guarded directional step / free directional step. Both need synchronization and a valid positive denominator and are bounded to 0–100%. A ten-tick step reduced to six gives 40% load and 60% TX.
Observed AF = min(start + recorded EP updates × increment, effective maximum). It is reconstructed, not an exposed internal ta.sar() AF. PARTIAL runs cannot recover unobserved EP updates and do not enter completed-run history.
Start on standard candles or bars. Identify canonical dots, the extreme-point trace, arc, yellow halos and panel before changing one input at a time.
Open the public Parabolic SAR Constraint Kinematics & Run Geometry page and add it to TradingView. No SG Group account is required.
Overlapping lines, bands, backgrounds or tables can be duplicate drawings of the same kind of information. Never treat visual overlap by itself as stronger evidence or signal agreement. Another SAR with matching factors duplicates the dots. Trailing stops, ATR exit lines, extreme traces, backgrounds and fixed tables can overlap. Identify candidate points separately from canonical SAR.
Check FULL/PARTIAL, ARC and STEP before MOTION. The panel shows the latest execution, not the historical bar under the cursor. Enable extended Data Window output for historical values inside the research window.
BELOW/ABOVE describes the tracked SAR side. RUN “11b ✳3 ∥4” means eleven bars, three EP updates and four bars since the latest EP.
ARC gives normalized distance and retention. STEP gives absolute one-bar SAR movement and its ratio to the remaining arc; that ratio can exceed 100% and is not a return.
CODE A/F/P/C means arc retention, AF progress, EP pause share and current load. A/F/P use fixed 25% bands 1–4. C0 is valid load below 1%; C1 is 1–<25%, then C2/C3/C4 start at 25/50/75%. C- is unavailable. These are not sample quartiles or rankings.
Observed from the start / tracking began mid-run. Only completed FULL runs enter history.
Ineligible reconstruction / mismatch beyond tolerance. Related percentages are withheld.
Below measurable thresholds / measurable but below materiality. FREE need not mean exactly zero.
Material load with guarded directional step above / at or below a quarter tick.
Step transmission / AF reconstructed from tracked EP updates.
Four-axis signature / sample count, mean duration and brief share when signature is hidden. n20 means twenty retained runs.
P = 100 × bars since EP / (age − 1), zero at age one. C- means load unavailable.
Non-standard transformed chart / latched arc-contraction state.
The labels below match the published script’s English Inputs panel. Defaults reflect the public source at the time of review and may change in a later TradingView update.
On small screens, each input is reformatted as a readable stacked card.
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Calculation scope | Recent bars / options: Recent bars, All available bars | Recent bars limits the script's custom run-state, constraint, drawing, alert, and history work to a user-selected window. All available bars removes that code-level limit and can increase runtime substantially on deep intraday datasets. |
Recent-bar research window | 3000 / min 500, max 50000 | Number of recent historical bars processed by the custom research layer when Calculation scope is Recent bars. The boundary is fixed when the script loads or an input changes; subsequent realtime bars are included. Canonical ta.sar() and the selected normalization series still evaluate before the boundary so values remain valid at the first processed bar. Higher values increase runtime. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Starting acceleration factor | 0.02 / min 0.0001, max 1 | Acceleration factor used when a new Parabolic SAR run begins. |
Acceleration increment | 0.02 / min 0.0001, max 1 | Amount added to the observed acceleration-factor stage after each newly recorded extreme point. |
Maximum acceleration factor | 0.2 / min 0.0001, max 2 | Upper limit of the Parabolic SAR acceleration factor. A value below the starting factor is internally raised to the starting factor. |
Confirm state changes at bar close | On | Recommended for reproducible study. When enabled, run changes, extreme-point updates, and descriptive events are committed only on confirmed bars. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Normalization length | 14 / min 1, max 500 | Lookback used only when ATR normalization is selected. It does not alter Parabolic SAR state changes. |
Normalization smoothing | RMA / options: RMA, SMA, EMA, WMA | Smoothing method for the normalization range. This is a measurement choice, not a directional filter. |
Distance unit | ATR at run start / options: ATR at run start, Percent from run origin, Ticks, Raw price | Unit used for excursion and arc-distance statistics. ATR is frozen at the beginning of each fully observed run. |
Completed-run memory | 20 / min 3, max 100 | Number of fully observed completed runs retained for duration, constraint-occupancy, and brief-run statistics. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Material constraint threshold (%) | 12.5 / min 1, max 100 | Minimum share of the free Parabolic SAR step removed by the canonical two-bar range guardrail before the bar is classified as materially constrained. Effects below 1% remain in the FREE state. |
Kinematic sync tolerance (ticks) | 2 / min 0.1, max 20 | Maximum difference, measured in minimum ticks, allowed between the reconstructed guarded candidate and TradingView's ta.sar() value. Constraint metrics are withheld when this check is not satisfied. |
Show material-constraint halo | On | Places a restrained neon halo behind the canonical SAR dot when the two-bar guardrail materially reduces its free parabolic step. |
Constraint halo width | 4 / min 2, max 5 | Sets constraint halo width. This is a display control; it does not alter the canonical SAR calculation. |
Show unconstrained candidate point | Off | Shows the mechanically reconstructed SAR candidate before the canonical two-bar range guardrail is applied on materially constrained bars. Disabled by default to keep publication charts clean. |
Fill free-to-guarded constraint bridge | Off | Fills the distance removed by the two-bar range guardrail on materially constrained bars. Disabled by default for visual restraint. |
Show normalized run signature in panel | On | Displays a four-axis descriptive address: Arc retention, AF progress, Extreme-point pause share, and current constraint load. It is a state fingerprint, not a score or forecast. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Minimum age for arc contraction | 5 / min 2, max 100 | A run must reach this age before SAR-to-extreme-point contraction can be classified as a tight arc. |
Tight-arc retention threshold (%) | 35 / min 5, max 95 | A tight arc begins when the current SAR-to-extreme-point distance is at or below this percentage of the widest distance recorded in the same run. |
Re-expansion hysteresis (percentage points) | 20 / min 1, max 90 | After a tight arc, a new extreme point must raise retention by this additional amount before re-expansion is recorded. |
Run-age milestone (bars) | 12 / min 2, max 500 | One-time age observation for each fully observed run. |
Extreme-point pause milestone (bars) | 5 / min 1, max 100 | Records a pause episode when no new run extreme point has appeared for this many confirmed bars. |
Brief completed run (bars or fewer) | 4 / min 1, max 50 | A fully observed run ending at or below this duration is classified as brief for descriptive statistics only. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Show Parabolic SAR dots | On | Sets show parabolic sar dots. This is a display control; it does not alter the canonical SAR calculation. |
SAR dot width | 2 / min 1, max 5 | A width of 2 keeps the dots clear without obscuring candle structure. |
Show extreme-point trace | On | Plots the highest high while SAR is below price, or the lowest low while SAR is above price. |
Extreme-point trace width | 1 / min 1, max 4 | Sets extreme-point trace width. This is a display control; it does not alter the canonical SAR calculation. |
Fill the SAR-to-extreme-point arc | On | Fills the measured space between Parabolic SAR and the active run extreme point. |
Normal arc transparency | 90 / min 70, max 100 | Higher values make the normal arc fill less prominent. |
Tight-arc transparency | 78 / min 60, max 100 | The fill becomes slightly more visible while the active run is in a tight-arc state. |
Show current run origin line | Off | Draws one dotted line for the current fully observed run only. It is disabled by default because historical origin levels can resemble support or resistance. |
Show arc midline | Off | Sets show arc midline. This is a display control; it does not alter the canonical SAR calculation. |
Event marker presentation | Icons / options: Off, Icons, Text badges | Icons provide the cleanest chart. Text badges are intended for detailed inspection rather than publication thumbnails. |
Show PSAR side-change markers | On | Places a neutral marker at the PSAR point when SAR changes sides relative to price. |
Show tight / wide arc markers | Off | Disabled by default because fill intensity and the study panel already show the arc state. Enable these neutral markers for detailed inspection. |
Show age / AF / pause / brief markers | Off | Disabled by default to prevent label congestion. Enable for detailed run research. |
Show every new extreme point | Off | Useful for inspecting observed AF progression. Disabled by default for chart clarity. |
Marker spacing (range units) | 0.16 / min 0, max 2 | Offsets non-turn markers away from the extreme-point trace using the selected normalization range. |
Show completed-run summaries | Off | Detailed summaries are disabled by default because they can obscure price. Old summaries are automatically deleted at the selected limit. |
Maximum completed-run summaries | 12 / min 1, max 60 | Sets maximum completed-run summaries. This is a display control; it does not alter the canonical SAR calculation. |
Maximum descriptive event markers | 60 / min 20, max 180 | Caps historical markers to preserve readability and remain comfortably below the label-object limit. |
Tint bars by current PSAR side | Off | Optional contextual coloring only. Disabled by default. |
Shade active tight-arc state | Off | Optional background emphasis only. Disabled by default. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Show study panel | On | Sets show study panel. This is a display control; it does not alter the canonical SAR calculation. |
Panel layout | Compact / options: Compact, Ribbon | Compact uses a three-row paired grid. Ribbon groups the same metrics into a horizontal reading order. |
Panel position | Top right / options: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right | Sets panel position. This is a display control; it does not alter the canonical SAR calculation. |
Right-edge clearance (%) | 1 / min 0, max 3 | Adds a transparent gutter to right-anchored panel positions. The default shifts the visible upper-right panel slightly left without moving it away from the upper-right area. |
Panel text size | Normal / options: Tiny, Small, Normal, Large | Sets panel text size. This is a display control; it does not alter the canonical SAR calculation. |
Bold panel text | On | Uses Pine Script text formatting to emphasize all visible panel cells. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
SAR below price | #00D9FF | Sets sar below price. This is a display control; it does not alter the canonical SAR calculation. |
SAR above price | #FF4D8D | Sets sar above price. This is a display control; it does not alter the canonical SAR calculation. |
Extreme trace while SAR is below | #7CFF6B | Sets extreme trace while sar is below. This is a display control; it does not alter the canonical SAR calculation. |
Extreme trace while SAR is above | #FFC857 | Sets extreme trace while sar is above. This is a display control; it does not alter the canonical SAR calculation. |
Current run origin | #F3F6FC | Sets current run origin. This is a display control; it does not alter the canonical SAR calculation. |
Tight-arc event | #FFD166 | Sets tight-arc event. This is a display control; it does not alter the canonical SAR calculation. |
Re-expansion event | #B388FF | Sets re-expansion event. This is a display control; it does not alter the canonical SAR calculation. |
Research milestone | #E6EDF7 | Sets research milestone. This is a display control; it does not alter the canonical SAR calculation. |
Constraint mechanics | #EFFF00 | Sets constraint mechanics. This is a display control; it does not alter the canonical SAR calculation. |
Panel background | #08101F | Sets panel background. This is a display control; it does not alter the canonical SAR calculation. |
Panel label cells | #12253F | Sets panel label cells. This is a display control; it does not alter the canonical SAR calculation. |
Panel text | #F8FCFF | Sets panel text. This is a display control; it does not alter the canonical SAR calculation. |
| Input label | Default / options | What it controls and when to adjust it |
|---|---|---|
Enable descriptive alert conditions | Off | Disabled by default. Alerts report observed state changes and geometry events only. |
Expose extended metrics in Data Window | Off | Optional advanced output. Enable when inspecting numeric series in the Data Window; leave disabled for the lightest normal chart runtime. |
Enable descriptive alert conditions, then create the desired TradingView alert. The events describe observations and do not place orders.
This tool is for analysis and visualization. It is not investment advice, a trade recommendation, a forecast, or a promise of profit or accuracy. Results depend on inputs, symbol, timeframe, and data feed. You remain responsible for every trading decision.
Bar-close confirmation commits state and event records, but the live SAR, geometry, constraint calculations, halos and current signature may still change before close. The script is not completely non-repainting.
Default tolerance is two ticks. Agreement does not prove exact recovery of all internal states or a predictive edge. CHECK withholds percentages, INIT means ineligible, and invalid denominators yield unavailable data.
The initial 3000-bar boundary rebuilds on reload, rather than sliding continuously. SYNTHETIC charts measure transformed OHLC. Only completed FULL runs enter history; valid occupancy history may use a different sample from duration and brief-run history.
Dots, traces, arcs, halos and signatures share related inputs. Their coincidence is not independent confirmation, a win rate or a reversal probability.
Clarify provisional values, reconstruction limits, incomplete observation and historical inspection.
It is a free open-source TradingView indicator. Check the publication terms before redistribution.
No. It marks a synchronized material constraint on the SAR step.
The indicator does not place orders. Alerts report observed descriptive events.
The panel shows the latest execution. Enable extended Data Window metrics for historical numeric inspection.
This guide is grounded in SG Group’s live catalogue, the script’s published TradingView description, and the user-facing inputs in its open source. Labels and defaults can change after a script update.
