Get started

Display

Traders_Reality_Lib_v6This library contains common utility functions used in Traders Reality scripts, including PVSRA calculations, ADR/AWR/AMR/RD/RW helpers, session tools, labels, pivots, vector candle zones, and psychological level calculations. This version is only a Pine Script v6 migration/update of the original library. I am not the original author, and I do not claim ownership of the underlying work. All rights, credits, and authorship belong to the original creator(s).
Pine Script® library
by Inoffensive
CyberVisLib# CyberVisLib v5 CyberVisLib provides rendering and visualization utilities for multi-oscillator indicators: color blending, sub-pane management, diagnostic tables, and tooltip formatting. Pure visualization layer—no market logic. ## What it does Delivers four capabilities: color utilities (RGB blending, diverging/sequential gradients, confidence-to-transparency), sub-pane management (vertical space allocation for multiple oscillators), diagnostic tables (key-value pairs, dynamic coloring), and tooltip formatting. Stack RSI, MACD, Stochastic in non-overlapping vertical bands. Outputs color values, MiniSubPane structs (band coordinates), table objects, formatted strings. All stateless, rendering-focused. ## How it works Color blending: `RGB_out = (1-t)×RGB_a + t×RGB_b`. Diverging gradients split at zero (negative→red-yellow, positive→yellow-green). Transparency: `90 - 60×confidence`. Sub-pane management: 1. Register oscillators (MiniOscMeta) 2. Finalize layout (STACK_TOP/BOTTOM/EQUAL_SPLIT policies) 3. Map values: `pane.band_y(unit_val)` converts to vertical coordinate Diagnostic tables: key-value pairs, multi-column grids, conditional formatting. ## Why this is original Only TradingView library with complete rendering toolkit. Existing libraries mix rendering with market logic. Unique features: - Sub-pane vertical allocation (automatic band calculation) - Lightweight UDT variants (co-import with OscLib) - Diverging gradients with zero-centering - Confidence-to-transparency mapping - Regime color enum (consistent color mapping) Separation of concerns: VisLib (rendering), NumLib (math), SignalLib (signals). ## How to use it ```pine //@version=6 indicator("CyberVisLib Demo", overlay=false) import cybermediaboy/CyberVisLib/5 as VL // Diverging gradient rsi = ta.rsi(close, 14) z_rsi = (rsi - 50.0) / 25.0 color rsi_color = VL.f_diverging_rgyg(z_rsi) plot(rsi, "RSI", color=rsi_color) // Sub-pane management var spm = VL.f_subpane_manager_new(VL.SubPanePolicy.EQUAL_SPLIT, 5.0) if barstate.isfirst spm.register(VL.f_meta_unipolar0100("rsi", "RSI", color.blue)) spm.register(VL.f_meta_bipolar("macd", "MACD", color.orange)) spm.finalize() var pane_rsi = array.get(spm.panes, 0) rsi_y = pane_rsi.band_y(pane_rsi.meta.to_unit(rsi)) plot(rsi_y, "RSI Pane", color.blue) // Confidence transparency conf = math.abs(rsi - 50.0) / 50.0 bgcolor(color.new(color.green, VL.f_transp(conf))) ``` ## Key functions - `f_blend()` - RGB color blending - `f_diverging_rgyg()` - Diverging gradient (zero-centered) - `f_transp()` - Confidence-to-transparency mapping - `f_subpane_manager_new()` - Sub-pane allocation - `f_regime_color()` - Regime color enum - `f_kv_tooltip()` - Tooltip formatting ## Limitations - Sub-pane allocation static after finalize - RGB-only blending (no HSL/HSV) - No automatic label/line cleanup - Tables require manual cell updates - Assumes `overlay=false` (separate pane indicators only)
Pine Script® library
by cybermediaboy
aether_regime_v1Library "aether_regime_v1" getRegime(adxLen, chopLen, adxThreshold, chopLowFib, chopHighFib)   Parameters:      adxLen (simple int)      chopLen (simple int)      adxThreshold (simple float)      chopLowFib (simple float)      chopHighFib (simple float) regimeColor(regimeStr)   Parameters:      regimeStr (simple string) regimeConfidence(adxVal, adxThreshold)   Parameters:      adxVal (simple float)      adxThreshold (simple float)
Pine Script® library
by lilbenxo
K21CommonLibrary "K21Common" minDollarMove()   Calculates the minimum dollar move per tick for the current symbol   Returns: (float) Dollar value per tick movement @description Uses syminfo.pointvalue (contract value per point) and syminfo.minmove (minimum tick movement) to calculate the dollar value of a single tick. This works across all futures contracts without manual configuration. replaceTradeTemplateTags(template, entry_num, description, entry_price, stop_price, tp_price, contracts, risk_dollars, reward_dollars, rr_ratio, max_risk)   Replaces trade related template tags with actual values   Parameters:      template (string) : (string) Template string with tags      entry_num (int) : (int) Entry number (1-5)      description (string) : (string) Entry description      entry_price (float) : (float) Entry price      stop_price (float) : (float) Stop price      tp_price (float) : (float) TP price      contracts (int) : (int) Number of contracts      risk_dollars (float) : (float) Risk in dollars      reward_dollars (float) : (float) Reward in dollars      rr_ratio (float) : (float) Risk:Reward ratio      max_risk (float) : (float) Maximum allowed risk   Returns: (string) Processed template string isLightColor(clr)   Checks if a color is light based on luminance calculation   Parameters:      clr (color) : (color) The color to check   Returns: (bool) True if the color is light isDarkColor(clr)   Checks if a color is dark based on luminance calculation   Parameters:      clr (color) : (color) The color to check   Returns: (bool) True if the color is dark isLightScheme()   Checks if the current chart color scheme is light   Returns: (bool) True if the chart uses a light color scheme isDarkScheme()   Checks if the current chart color scheme is dark   Returns: (bool) True if the chart uses a dark color scheme getBarIndexFromTime(target_time)   Finds the bar_index for a given timestamp by searching historical bars   Parameters:      target_time (int) : (int) The timestamp to find   Returns: (int) The bar_index where time matches or is closest to target_time
Pine Script® library
by Knighted21
Pivot_Labels_Output_UtilitiesThis library contains reusable pivot label output helpers for Pine scripts that already have their own pivot, structure, or signal logic but want a shared label-rendering layer. It centralizes the parts of the workflow that tend to get rewritten across label-heavy scripts: label-size resolution, compact percent and price formatting, one-shot pivot label plotting, live directional label management, confirmed/local/current-RSI text builders, early-label emoji output, and live-stack text / object helpers. On the example chart, the visible label workflows are materially driven by the library, whether through the confirmed pivot label text, the local pivot label text, the current RSI + SMA above-bar label, the early directional labels, or the live stack text and label-object lifecycle helpers used to keep those outputs updated cleanly on the chart. How to use Import the library near the top of your script in global scope, alongside any other imports, before you start calling its helpers. Typical placement: // @version=6 indicator(...) or strategy(...) import MYNAMEISBRANDON/PivotLabelsOutput_Utilities/1 as PLutils This library does not confirm pivots, resolve structure tags, or choose label colors for you. Instead, it expects your script to already know the values it wants to display, then uses those resolved inputs to build the output layer. For more information on libraries and incorporating them into your scripts, see the Libraries section of the Pine Script User Manual. ➖Label Size Helpers➖ These helpers convert simple UI-facing size strings into Pine label-size enums so scripts can keep one consistent size resolver across confirmed pivot labels, local pivot labels, current RSI labels, early labels, and live stack labels. labelSizeFromString(sizeIn) Resolves a Pine label size from a string input. Parameters: sizeIn (simple string): Size string. Expected values: "Tiny", "Small", "Normal", "Large", or "Huge" Returns: Pine label size enum ➖Numeric Formatting Helpers➖ These helpers handle compact numeric formatting for label-driven scripts. They let a script calculate percent change safely, format that change in a label-friendly way, and convert larger price values into compact significant-figure style text. labelPercentChange(curr, prev) Returns percent change from prev to curr. Parameters: curr (float): Current value prev (float): Previous reference value Returns: Percent change or na when invalid labelFormatPercent(p) Formats a percent value for compact label output. Parameters: p (float): Percent value Returns: Formatted percent string labelFormatCompactNumber(x, sig) Formats a number using significant-figure style suffix output. Parameters: x (float): Value to format sig (simple int): Significant figures to preserve Returns: Compact number string ➖Static Label Plot Helpers➖ These helpers create one-shot label outputs for scripts that want to place confirmed or local pivot labels on historical pivot bars, or simple above-bar informational labels, without managing a live label object afterward. plotPivotLabel(x, y, txt, textColor, isHigh, sizeIn) Creates a pivot label on a specific bar. Parameters: x (int): Label x position y (float): Label y position txt (string): Label text textColor (color): Label text color isHigh (bool): True for a high-side label, false for a low-side label sizeIn (simple string): Label size string Returns: Created label reference plotAboveBarLabel(x, y, txt, textColor, sizeIn) Creates an above-bar informational label. Parameters: x (int): Label x position y (float): Label y position txt (string): Label text textColor (color): Label text color sizeIn (simple string): Label size string Returns: Created label reference ➖Directional Label Object Helpers➖ These helpers manage the lifecycle of live high-side and low-side label objects so scripts can create, update, or delete directional labels without repeating the same object-management logic each time. manageDirectionalLabel(lbl, show, x, y, txt, textColor, isHigh, sizeIn) Creates, updates, or deletes a directional label object. Parameters: lbl (label): Existing label reference show (bool): Whether the label should exist x (int): Label x position y (float): Label y position txt (string): Label text textColor (color): Label text color isHigh (bool): True for a high-side label, false for a low-side label sizeIn (simple string): Label size string Returns: Updated label reference ➖Pivot Text Helpers➖ These helpers build the final text used by confirmed pivot labels, local pivot labels, confirmed pivot alerts, and the current RSI / SMA above-bar label. In other words, this region keeps the script’s visible wording consistent while leaving structure resolution and color decisions to the calling script. buildMajorPivotLabelText(mode, priceText, priceStruct, rsiText, oscStruct, percentText, pivotLen, showLen) Builds confirmed pivot label text. Parameters: mode (simple string): Label mode. Expected values: "Full" or "RSI Only" priceText (string): Formatted pivot price priceStruct (string): Price-side structure tag rsiText (string): Formatted pivot RSI oscStruct (string): RSI-side structure tag percentText (string): Formatted percent-change text pivotLen (int): Pivot length value showLen (bool): Whether pivot length should be shown Returns: Confirmed pivot label text buildLocalPivotLabelText(priceText, priceStruct, rsiText, rsiStruct, pivotLen, showPrice, showLen) Builds local pivot label text. Parameters: priceText (string): Formatted local pivot price priceStruct (string): Price-side structure tag rsiText (string): Formatted local pivot RSI rsiStruct (string): RSI-side structure tag pivotLen (int): Pivot length value showPrice (bool): Whether the price line should be shown showLen (bool): Whether pivot length should be shown Returns: Local pivot label text buildPivotAlertText(isHigh, priceText, pctText, rsiText, structTag, rsiValue, rsiOB, rsiOS) Builds confirmed pivot alert text. Parameters: isHigh (bool): True for a high pivot, false for a low pivot priceText (string): Formatted pivot price pctText (string): Formatted percent-change text rsiText (string): Formatted pivot RSI structTag (string): RSI-side structure tag rsiValue (float): Raw RSI value at the pivot rsiOB (int): Overbought level rsiOS (int): Oversold level Returns: Alert message text buildCurrentRsiAboveBarText(currRsiText, structTag, smaText) Builds current RSI / SMA above-bar label text. Parameters: currRsiText (string): Formatted current RSI text structTag (string): Current live structure tag smaText (string): Formatted SMA text Returns: Current RSI above-bar label text ➖Early Pivot Label Helpers➖ These helpers provide the reusable output primitive used by early pivot labels. This region intentionally stops at emoji selection so scripts with different structure-tag models and color logic can still reuse the same active-vs-carried-forward label cue. earlyPivotEmoji(isHigh, isCurrentCandidateBar) Returns the early-pivot emoji for the active side and candidate state. Parameters: isHigh (bool): True for a high-side early label, false for a low-side early label isCurrentCandidateBar (bool): True when the candidate bar is the current bar Returns: Early-pivot emoji ➖Live Stack Text Helpers➖ These helpers build the reusable text layer behind live stack labels. They handle padded line construction, signed delta wording, movement glyphs, and the multi-line center block used to display price, anchor tag, RSI, RSI delta, SMA, and SMA delta. stackSignedRoundText(x) Returns a rounded signed text value for live-stack display. Parameters: x (float): Value to round Returns: Signed rounded text stackMoveGlyph(delta) Returns the move glyph used by live-stack delta text. Parameters: delta (float): Delta value Returns: Move glyph stackDeltaText(change, structTag, isPercent, pad) Builds padded delta text for the live stack. Parameters: change (float): Delta value structTag (string): Structure tag to append isPercent (bool): Whether the delta should be formatted as a percent pad (int): EM-space padding count Returns: Padded delta text stackRsiDiffText(delta, structTag, pad) Builds padded RSI-delta text for the live stack. Parameters: delta (float): RSI delta value structTag (string): Structure tag to append pad (int): EM-space padding count Returns: Padded RSI-delta text stackCenterText(price, rsiVal, rsiDelta, rsiSma, rsiSmaDelta, anchorTag, pad, sigFigs) Builds the live-stack center block text. Parameters: price (float): Current price rsiVal (float): Current RSI value rsiDelta (float): Current bar-to-bar RSI delta rsiSma (float): Current RSI SMA value rsiSmaDelta (float): Current bar-to-bar RSI SMA delta anchorTag (string): Active anchor tag such as "➜H" or "➜L" pad (int): EM-space padding count sigFigs (simple int): Significant figures used for price formatting Returns: Center live-stack text block ➖Live Stack Label Object Helpers➖ These helpers manage the lifecycle of live center-style stack labels so scripts can create, update, or delete the visible stack objects without repeatedly rewriting that object-management logic. manageCenterLabel(lblPrev, show, yVal, txt, textColor, xPos, linesBefore, linesAfter, sizeIn) Creates, updates, or deletes a center-style live-stack label. Parameters: lblPrev (label): Existing label reference show (bool): Whether the label should exist yVal (float): Label y position txt (string): Label text textColor (color): Label text color xPos (int): Label x position linesBefore (int): Blank lines inserted before the text block linesAfter (int): Blank lines inserted after the text block sizeIn (simple string): Label size string Returns: Updated label reference Local Pivot label demo (with pin emoji)— shows the library’s smaller same-side pivot label format on its own for a cleaner view of the local-label workflow.
Pine Script® library
by MYNAMEISBRANDON
PivotStructureOutline_UtilitiesThis library contains reusable pivot structure outline helpers for Pine scripts that already work with confirmed pivot highs and lows. It is designed to provide the reusable outline and anchor-box layer for scripts that already have their own pivot-confirmation logic, so those scripts can keep their structure visuals consistent without repeatedly rebuilding the same framework. It brings together the parts of the workflow that are often rewritten in structure-based scripts: resolving pivot-close anchors, selecting wick vs close anchor behavior, building live outline geometry, building pivot structure anchor-box geometry, and managing the line and box objects that render those visuals. Everything on the example chart is materially driven by the library, whether through the selected outline anchor source, the outline geometry itself, the midpoint-start logic, the pivot structure anchor boxes, or the shared line/box lifecycle helpers used to keep those visuals updated cleanly on the chart. How to use Import the library near the top of your script in global scope, alongside any other imports, before you start calling its helpers. This mirrors the import-first usage pattern shown on your recent library page. Typical placement: //@version=6 indicator(...) or strategy(...) import MYNAMEISBRANDON/PivotStructureOutline_Utilities/1 as PSOutils This library is engine-agnostic. It does not confirm pivots for you. Instead, it expects your script to already know its confirmed high/low pivot indexes and anchor values, then uses those resolved inputs to build the outline and anchor-box layer. ➖Outline Line Style Helpers➖ These helpers convert simple UI-facing style strings into Pine line style enums so scripts can keep one consistent style resolver across outline lines, midpoint lines, and connector lines. outlineLineStyle(styleIn) Resolves a Pine line style from a string input. Parameters: styleIn (simple string): Style string. Expected values: "Solid", "Dashed", or "Dotted" Returns: Pine line style enum ➖Pivot Structure Outline Helpers➖ These helpers build the actual pivot structure outline framework from already-confirmed high/low pivot anchors. They let a script resolve a pivot-close anchor, choose whether the outline should use wick or close anchors, and generate the live geometry needed for the top line, bottom line, midpoint, and left-side connectors. outlinePivotCloseFromIdx(pivotIdx, closeValue) Returns the close value belonging to a confirmed pivot index. Parameters: pivotIdx (int): Confirmed pivot bar_index closeValue (float): Close series Returns: Confirmed pivot close value outlineSelectedAnchors(anchorMode, highWickAnchor, lowWickAnchor, highCloseAnchor, lowCloseAnchor) Selects the active outline anchors from Wick or Close mode. Parameters: anchorMode (simple string): Anchor mode. Expected values: "Wick" or "Close" highWickAnchor (float): Confirmed high-side wick anchor lowWickAnchor (float): Confirmed low-side wick anchor highCloseAnchor (float): Confirmed high-side close anchor lowCloseAnchor (float): Confirmed low-side close anchor Returns: Selected high anchor, selected low anchor, is outline-valid outlineGeometry(highPivotIdx, lowPivotIdx, highAnchor, lowAnchor, connectorSourceMode, midlineStartMode, highValue, lowValue, closeValue) Returns the live geometry for the pivot structure outline system. Parameters: highPivotIdx (int): Confirmed high pivot bar_index lowPivotIdx (int): Confirmed low pivot bar_index highAnchor (float): Selected top outline anchor lowAnchor (float): Selected bottom outline anchor connectorSourceMode (simple string): Connector source mode. Expected values: "Wick" or "Close" midlineStartMode (simple string): Midline start mode. Expected values: "Most Recent Pivot" or "Left Outline" highValue (float): High series lowValue (float): Low series closeValue (float): Close series Returns: ok, leftX, rightX, midX1, topY, bottomY, midY, leftTopConnectorY, leftBottomConnectorY ➖Pivot Structure Anchor Box Helpers➖ These helpers build directional top and bottom pivot structure anchor boxes from confirmed pivot bars. They let a script choose whether those boxes use wick-only extension from the candle body or the full candle body, then return the live coordinates needed to render those boxes forward to the current bar. outlineAnchorBoxGeometry(highPivotIdx, lowPivotIdx, boxAreaMode, openValue, highValue, lowValue, closeValue) Returns the live geometry for top and bottom pivot structure anchor boxes. Parameters: highPivotIdx (int): Confirmed high pivot bar_index lowPivotIdx (int): Confirmed low pivot bar_index boxAreaMode (simple string): Box area mode. Expected values: "Wick" or "Body" openValue (float): Open series highValue (float): High series lowValue (float): Low series closeValue (float): Close series Returns: showHighBox, showLowBox, highLeftX, lowLeftX, boxRightX, highTopY, highBottomY, lowTopY, lowBottomY ➖Line Object Helpers➖ These helpers manage the lifecycle of live line objects so scripts can create, update, or delete outline-related lines without rewriting that object-management logic each time. outlineManageLine(enabled, ln, x1, y1, x2, y2, col, width, style) Creates, updates, or deletes a line object. Parameters: enabled (bool): Whether the line should exist ln (line): Existing line reference x1 (int): Start x position y1 (float): Start y position x2 (int): End x position y2 (float): End y position col (color): Line color width (int): Line width style (string): Line style Returns: Updated line reference ➖Box Object Helpers➖ These helpers manage the lifecycle of live box objects so scripts can create, update, or delete pivot structure anchor boxes without repeating the same box-management code in every script. outlineManageBox(enabled, bx, left, top, right, bottom, bgColor, borderColor, borderStyle, borderWidth) Creates, updates, or deletes a box object. Parameters: enabled (bool): Whether the box should exist bx (box): Existing box reference left (int): Left x position top (float): Top y position right (int): Right x position bottom (float): Bottom y position bgColor (color): Box background color borderColor (color): Box border color borderStyle (string): Box border style borderWidth (int): Box border width Returns: Updated box reference
Pine Script® library
by MYNAMEISBRANDON
Pine3D: A Native 3D Graphical Rendering EnginePine3D is a full 3D rendering engine for TradingView, powered by Pine Script™ v6. Pine3D pushes forward the frontier of TradingView 3D rendering capabilities, providing a fully fledged graphical engine under an intuitive, chainable, object oriented API. Build meshes, transform them in world space, light them, cast shadows, project them through a perspective camera, and render the result directly on your chart, all without ever bothering about trigonometry synchronization or optimization. The library brings forth a streamlined process for anyone that wishes to visualize data in 3D, without needing to know anything about the complex math that has previously gatekept such indicators. Pine3D does all the heavy lifting, including extreme optimization techniques designed for production ready indicators. The entire API is chainable and tag addressable, so spawning a mesh, registering it, pointing the camera at it, and rendering the frame is a four line affair: Mesh mybox = cube(40.0, color.orange).setTag("hero").rotateBy(0.0, 45.0, 0.0) scene.add(mybox) scene.lookAt("hero") render(scene) 🔷 SURFACES: CONTOUR BAND RENDERING Pine Script imposes a hard ceiling of 100 polylines and 500 lines per indicator . On the surface this looks fatal for dense 3D meshes: every triangle drawn naively burns one of those 100 slots, or two of the 500, and the budget evaporates within a few hundred faces. The conventional escape hatch is strip stitching , tracing a polyline forward along one row of a grid and back along the next, packing a ribbon of quads into a single drawing slot. It buys a meaningful multiplier, but it pays for that multiplier with two structural constraints baked into the geometry itself: One color per strip. A polyline carries a single stroke and fill color, so every cell along the ribbon must share the same shade. The moment you want per cell lighting, contour banding, or value driven gradients, every color change forces a new polyline and the budget collapses. One contiguous ribbon per slot. Strips can only describe topologically connected runs of cells. Disjoint regions, holes, islands, and value clustered fragments scattered across the surface each demand their own polyline. Pine3D breaks both constraints at once. At the core of the engine sits an innovation that redefines the limits for visual fidelity: contour band rendering using degenerate bridge stitching . The technique quantizes a surface's elevation into colored bands, then collapses every cell that falls inside the same band, no matter where it sits on the screen , into one continuous, hole aware polyline path per band, threading invisible zero width bridges between disjoint islands so that a single polyline can carry thousands of polygon equivalent fragments scattered across the geometry. The result: A single polyline can render up to 2,000 disconnected triangle equivalents , spread across arbitrarily separated regions of the surface. Theoretical ceiling of around 200,000 disconnected faces inside the 100 polyline budget, a regime that strip based stitching cannot enter at any color count above one. A 40 x 40 heightmap (around 3,000 triangles) renders inside the budget with full per band contour coloring and room to spare. Stress harnesses have run 40 x 80 grids . Each band's path is depth sorted and near plane culled, and cached between bars , so once geometry is built only the screen space projection runs per frame. This algorithm enables scenes with extreme detail relative to the 100 polyline limit, and shifts the optimization focus from "drawing limits" to "CPU limits", which Pine3D natively handles with aggressive caching at every layer of the pipeline. The contour technique is currently integrated into the surface() function, with the same compression strategy generalizable to any mesh class and ultimately full scene rendering in future versions. Non-uniform grids out of the box. surface() accepts optional axisX and axisZ arrays that override the default uniform spacing with custom column and row positions. This means logarithmic strike spacing on an option volatility surface, irregular timestamp spacing on a market depth heatmap, or any other non-evenly-sampled grid renders correctly without resampling the data first. The contour band engine, axis ticks, and gridBox cage all snap to the custom positions automatically. A full contour surface is just a handful of lines; the damped ripple below builds once and never needs updating: //@version=6 indicator("Pine3D - Contour Surface", overlay = false, max_polylines_count = 100, max_lines_count = 500, max_labels_count = 500) import Alien_Algorithms/Pine3D/1 as p3d var p3d.Scene scene = p3d.newScene() var p3d.Mesh heatmap = na if barstate.isfirst // Damped cosine ripple int N = 20 matrix data = matrix.new(N, N, 0.0) for r = 0 to N - 1 for c = 0 to N - 1 float dx = c - (N - 1) / 2.0 float dz = r - (N - 1) / 2.0 float d = math.sqrt(dx * dx + dz * dz) * 0.7 data.set(r, c, math.cos(d) * math.exp(-d * 0.12) * 50.0) heatmap := p3d.surface(data, 200.0, color.blue, color.red, 24) .gridBox() .gridLabels(color.white, "X", "Amplitude", "Z") scene.add(heatmap) scene.camera.orbit(35.0, 25.0, 380.0) if barstate.islast p3d.render(scene, lighting = true) 🔷 TRAIL3D: STREAMED OSCILLATOR PATHS Trail3D is a first class streaming primitive built for visualizing two correlated time series as a 3D ribbon evolving through time. You give it a rolling buffer capacity and push (u, v) samples bar by bar; the primitive maintains the buffer, builds the ribbon geometry, and renders it inside a normalized bounding cube so the path always fits cleanly in view regardless of the underlying data range. Under the hood, Trail3D is a coordinated bundle of polylines: one for the main ribbon, two for optional shadow projections onto the back wall and floor, and one for the wireframe cage. All four are depth sorted and occlusion clipped against the rest of the scene, and the primitive auto normalizes incoming samples against the rolling window's min/max so streaming data always fills the cube without manual scaling. This enables a class of visualizations that would otherwise require dozens of polylines and manual buffer management: phase space portraits, Lissajous figures, oscillator pair correlations, attractor trajectories, and any "two indicators evolving together over time" study. The demo above shows a sine and cosine pair pushing samples each bar to trace a clean spiral inside the cage, the same pattern you would use to plot RSI vs MFI, momentum vs volatility, or any custom (u, v) signal pair. A full streamed scene is a handful of lines: //@version=6 indicator("Pine3D - Trail3D", overlay = false, max_polylines_count = 100, max_lines_count = 500, max_labels_count = 500) import Alien_Algorithms/Pine3D/1 as p3d var p3d.Scene scene = p3d.newScene() var p3d.Trail3D trail = na if barstate.isfirst trail := p3d.trail3D(220.0, 200, color.yellow) .cage(true) .axisLabels("sin", "cos", color.white) trail._uProj.col := #00ffff69 trail._vProj.col := #ff00ff71 scene.add(trail) scene.camera.orbit(215.0, 20.0, 360.0) float phase = bar_index * 0.15 float sinX = math.sin(phase) * 100.0 float cosY = math.cos(phase) * 100.0 if barstate.isconfirmed trail.pushSample(sinX, cosY) p3d.render(scene) 🔷 BARS3D: CATEGORICAL 3D BAR CHARTS bars3D() turns any series of values into a fully lit, depth sorted 3D bar chart in a single call. Each bar is height mapped to its value, color graded between a low and high color, and packed into one combined mesh with per bar depth grouping so individual bars sort correctly even inside the merged geometry. The companion updateBars() mutator refreshes heights, colors, and labels in place every bar without rebuilding geometry, making it suitable for live rankings, rolling windows, and animated comparisons. The chainable barLabels(catNames, valNames) helper attaches category labels at the base of each bar and value labels at the top, both depth sorted with the rest of the scene. Category labels are set once at build time, while value labels can be passed to updateBars(values, valLabels = ...) each frame to reflect live data. Combined with wireGrid() for the floor and a contour surface() in the background, bars3D() becomes the centerpiece of dashboards comparing assets, sectors, timeframes, or any categorical metric. Negative values are handled automatically: bars below zero extrude downward from the base plane with reversed face winding, so signed series like PnL, delta, or momentum histograms render correctly without any extra setup. A complete labeled bar chart is just a few lines: //@version=6 indicator("Pine3D - Bars3D", overlay = false, max_polylines_count = 100, max_lines_count = 500, max_labels_count = 500) import Alien_Algorithms/Pine3D/1 as p3d var p3d.Scene scene = p3d.newScene() var p3d.Mesh bars = na array values = array.from(volume - volume , volume - volume , volume - volume , volume - volume , volume - volume , volume - volume ) array names = array.from("ΔV0", "ΔV-1", "ΔV-2", "ΔV-3", "ΔV-4", "ΔV-5") if barstate.isfirst bars := p3d.bars3D(values, 30.0, 30.0, 10.0, color.blue, color.red, 200.0) .barLabels(names) scene.add(bars) p3d.wireGrid(scene, 300.0, 300.0, 6, 6, color.new(color.gray, 80)) scene.camera.orbit(215.0, 25.0, 360.0) if barstate.islast bars.updateBars(values) p3d.render(scene, lighting = true) Omitting valLabels in updateBars() tells the engine to auto format each numeric value via str.tostring() . Pass valLabels only when you need custom strings. 🔷 SCATTER CLOUDS: POINTS IN 3D SPACE Pine3D treats scatter clouds as a first class use case without needing a dedicated scatter API. Because Label3D is the primitive and scene.add(array) is a single batch operation, you can scatter up to 500 points anywhere in 3D space, each with independent color, symbol, size, and tooltip , and have them depth sorted and occlusion clipped against the rest of the scene automatically. Each point is a fully addressable Label3D with mutable fields. You can change position , textColor , bgColor , labelStyle (any label.style_* glyph including circles, squares, diamonds, triangles, crosses, arrows, flags), labelSize (any size.* preset), and text per point per bar. The renderer reads these mutations every frame, so animation is just direct field assignment. This unlocks a wide class of visualizations: clustered data scatter, K means visualizations, particle systems, parametric surfaces sampled as point clouds, gradient colored attractors, multi class classification overlays, and structured curves like the demo above. The double helix demo plots two intertwined parametric strands as ~500 points with alternating colors and per point sizing, all inside the standard scene.add(array) pipeline. The pattern is straightforward: build the array once in barstate.isfirst , add it to the scene, then mutate point fields per bar to animate. //@version=6 indicator("Pine3D - Scatter Cloud", overlay = false, max_polylines_count = 100, max_lines_count = 500, max_labels_count = 500) import Alien_Algorithms/Pine3D/1 as p3d var p3d.Scene scene = p3d.newScene() var array points = array.new() if barstate.isfirst for i = 0 to 499 p3d.Vec3 pos = p3d.vec3(0.0, 0.0, 0.0) points.push(p3d.Label3D.new(position = pos, txt = "•")) scene.add(points) scene.camera.orbit(35.0, 20.0, 400.0) if barstate.islast for i = 0 to points.size() - 1 float t = i * 0.05 + bar_index * 0.01 p3d.Label3D pt = points.get(i) pt.position := p3d.vec3(80.0 * math.cos(t), i * 0.4 - 100.0, 80.0 * math.sin(t)) pt.textColor := i % 2 == 0 ? color.aqua : color.fuchsia p3d.render(scene) ---------------------------------------------------------------------------------------------------------------- 🔷 TWO LAYER ARCHITECTURE Pine3D ships as a clean, two layer library: 🔸 Layer 1 - DIY API. First principle building blocks ( Vec3 , Mesh , Camera , Light , Scene , plus world space overlay primitives) for total creative control. Author your own geometry, camera behavior, lighting setup, and scene graph from scratch. 🔸 Layer 2 - High Level Helpers. Production ready wrappers like surface() , bars3D() , trail3D() , updateBars() , updateSurface() , sphere() , torus() , cylinder() , and wireGrid() , plus chainable contour helpers gridBox() and gridLabels() that wrap the primitives into a few lines of code. Scatter clouds use the standard Label3D primitive directly. The object model is chainable and scene oriented, so complex setups still read cleanly. 🔷 FEATURE LIST Contour Surface Rendering - The most powerful 3D surface engine ever released for Pine Script. Render tens of thousands of polygon equivalent faces using a single polyline per contour band, delivering smooth, continuous terrain with natural ridges and valleys. Adaptive Rail Sharing - Solid meshes drawn with the default linefill backend reuse one edge line between adjacent coplanar faces, averaging roughly 1.6 lines per face instead of the naive two, pushing practical mesh capacity up to ~360 faces depending on topology. Interior Face Culling on Merge - mergeMeshes(meshes, removeInterior = true) detects coincident faces with opposing normals and strips them, so voxel style scenes (stacked cubes, block walls, lattice geometry) ship only their exterior shell and spend no budget on hidden interior faces. True Perspective Camera System - Full 3D camera with position, target, fov, and orbit() controls. Supports cinematic camera movement, lookAt by mesh tag, and realistic depth. Real Time Lighting and Shadows - Directional and point lights with configurable ambient, shadow strength, self shadowing, and a spatial grid acceleration structure for fast shadow queries. High Performance Update System - updateSurface() and updateBars() let you animate massive datasets bar by bar without rebuilding geometry, keeping CPU usage minimal. Rich Primitive Library - Cubes, cuboids, spheres, cylinders, tori, pyramids, planes, discs, circles, custom meshes, and the groundbreaking bars3D() with automatic labels. Streamed Trail Primitive - trail3D() maintains a rolling buffer of (u, v) samples and renders them as a 3D ribbon inside a bounding cube, with optional projections onto the back wall and floor and a wireframe cage. Depth Sorted Overlays - 3D labels, lines, polylines, wire grids, and trails, all correctly occluded and painter sorted against the rest of the scene. Professional Contour Helpers - gridBox() and gridLabels() automatically add clean bounding boxes and axis titles, ticks, and series names that refresh on every updateSurface() call. Tag Based Scene Graph - Every Mesh , Label3D , Line3D , and Polyline3D can carry a string tag. Scene exposes getMesh() , getLabel() , getLine() , getPolyline() , lookAt() , and remove() by tag, turning your scene into a lookup by name graph instead of an index juggling exercise. Chainable, Intuitive API - Everything is designed for maximum readability and speed of development. Build complex scenes in just a few lines. Production Ready Optimizations - World vertex caching, view projection caching, face preprocessing cache, shadow grid cache, and contour geometry cache, all managed automatically. ---------------------------------------------------------------------------------------------------------------- 🔷 THE RENDERER Every frame is produced by a single call to render(scene, ...) . The renderer runs the full pipeline: world transform, camera transform, back face culling, occlusion culling, depth sort, directional or point lighting with shadows, and perspective projection. ⚠ render() clears the entire chart drawing pool at the start of every call - every polyline , line , label , and linefill on the chart is deleted before Pine3D redraws, not just the ones it created. If you mix Pine3D with manual label.new() , line.new() , or similar calls, those drawings must be emitted after render() or they will be wiped every frame. 🔸 Setup Requirements. Pine3D consumes polylines, lines, and labels simultaneously, so your indicator() declaration must raise all three budgets, and the library must be imported under an alias: indicator("My 3D Scene", overlay = false, max_polylines_count = 100, max_lines_count = 500, max_labels_count = 500) import Alien_Algorithms/Pine3D/1 as p3d 🔸 render() parameters. maxFaces (int, default 100). Hard cap on solid faces drawn per frame. Contour bands, wireframe edges, labels, lines, and overlay polylines are not counted against this cap, and are bounded only by TradingView's global 100 polyline / 500 line / 500 label budgets. culling (bool, default true). Enable back face culling. lighting (bool, default false). Enable diffuse shading. Reads scene.light if set; otherwise falls back to the render() args. lightDir (Vec3). Overrides scene.light.direction when provided. Points toward the light. ambient (float, default 0.3). Minimum brightness for shadowed faces (0.0-1.0). wireframe (bool, default false). Force outline only output for the entire scene. occlusion (bool, default true). Sparse raster pass that drops hidden faces before drawing. Major perf win on dense scenes. occlusionRaster (int, default 768). Raster resolution of the occlusion buffer. Lower = faster but coarser; higher = stricter hidden face rejection. Explicit render() args always win over scene.light , which makes render() the right place for ad hoc, per frame lighting tweaks. ---------------------------------------------------------------------------------------------------------------- 🔷 MESH DRAWING MODES Two independent axes control how a mesh appears on the chart: 🔸 Style (via mesh.setStyle(...) ) - what gets drawn: "solid" . Filled faces. Default. "wireframe" . All edges, no fill. Shows interior geometry. "wireframe_front" . Only front facing edges. Cleaner silhouette for convex meshes. 🔸 Draw Mode (via mesh.drawMode ) - which TradingView primitive carries the solid faces: "linefill" (default). Uses the line and linefill budgets. An adaptive rail sharing optimization reuses one edge line between adjacent coplanar faces, pushing practical capacity up to ~360 faces per mesh depending on topology. Supports in place updates via updateSurface() and updateBars() . Rails are drawn transparent, so solid faces in this mode have no visible outline - use a wireframe style or "poly" drawMode if you need stroked edges. Recommended for all new code. "poly" . Legacy polyline backend. Capacity ~100 faces, no in place updates, but renders the face outline using mesh.lineStyle and mesh.lineWidth . Use only when you need styled solid face outlines. Wireframe styles always render with line primitives regardless of drawMode. Stroke width and style on edges (and on poly mode face outlines) come from mesh.lineWidth and mesh.lineStyle , which you mutate by direct field assignment. ---------------------------------------------------------------------------------------------------------------- 🔷 QUICK START The best practice lifecycle is simple: Create one persistent Scene with newScene() . Build meshes and helper overlays once in barstate.isfirst . On later bars, mutate objects in place with transforms or helper mutators like updateBars() and updateSurface() . Call render(scene, ...) once per frame. It automatically clears the previous chart drawings. A complete, lit, animated 3D scene is still a handful of lines: //@version=6 indicator("My First 3D Scene", overlay = false, max_polylines_count = 100, max_lines_count = 500, max_labels_count = 500) import Alien_Algorithms/Pine3D/1 as p3d var p3d.Scene scene = p3d.newScene() var p3d.Mesh sun = na if barstate.isfirst scene.setLightDir(1.0, -1.0, 0.5).setAmbient(0.3) sun := p3d.sphere(50.0, 16, 12, color.orange).setTag("sun") scene.add(sun) p3d.wireGrid(scene, 300.0, 300.0, 6, 6, color.new(color.gray, 80)) scene.camera.orbit(35.0, 25.0, 220.0) if barstate.islast sun.rotateBy(0.0, 1.5, 0.0) p3d.render(scene, lighting = true) ---------------------------------------------------------------------------------------------------------------- 🔷 RECOMMENDED USAGE PATTERN Use your Scene and major meshes in var . Build geometry once in barstate.isfirst . Use updateSurface() and updateBars() on later bars instead of rebuilding meshes. Use scene level helpers like wireGrid() when you want overlays added immediately. Use trail3D() when you want a streamed oscillator style path with built in wall projections and cage geometry. For scatter clouds, build an array once, hand it to scene.add(pts) , then mutate pt.position , pt.textColor , etc. each bar to animate. Use mesh level gridBox() and gridLabels() (contour) and barLabels() (bars) to attach overlays to the mesh setup chain. They are drained into the scene by scene.add(mesh) . 🔷 CONSIDERATIONS scene.clear() vs render(). scene.clear() removes objects from the scene graph (meshes, labels, lines, polylines). render() only clears the previous frame's TradingView drawings and redraws from the current scene graph. You almost never need scene.clear() in the build once and update pattern. Global scope series for updateSurface() / updateBars(). If your data uses Pine's history operator ( ) or calls functions like ta.rsi() , ta.atr() , request.security() , those must be declared at global scope so Pine tracks their bar by bar history. Calling them inside barstate.islast produces inconsistent results or compiler errors. gridLabels() tick values auto refresh. When you call updateSurface() , any tick value labels created by gridLabels() are automatically updated to reflect the new data range. Axis titles and positions stay constant. You don't need to rebuild them. barLabels() value labels via updateBars(). Create category labels once with mesh.barLabels(catNames) at build time, then pass valLabels to updateBars() on each frame. Value labels are refreshed automatically. Don't call barLabels() again. Lighting convenience methods are chainable. scene.setLightDir() , setLightPos() , setLightMode() , setAmbient() , setShadowStrength() , and showLightSource() all return Scene and can be chained: scene.setLightMode("point").setLightPos(0, 200, 150).setAmbient(0.25) . Mesh transforms return Mesh. moveTo() , moveBy() , rotateTo() , rotateBy() , scaleTo() , scaleUniform() , setTag() , setStyle() , setColor() , show() , hide() all return Mesh for chaining: mesh.moveTo(0, -20, 0).rotateTo(0, 45, 0).setStyle("solid") . Degrees vs radians. rotateTo() and rotateBy() on Mesh expect degrees. The low level Vec3.rotateX/Y/Z() methods expect radians. scene.lookAt() is tag only. scene.lookAt(t) accepts a string tag and points the camera at that mesh. To aim the camera at an arbitrary Vec3 , call scene.camera.lookAt(vec) directly. remove(tag) removes one object. The search order is meshes, then labels, then lines, then polylines, and the first hit wins. Avoid reusing tags across primitive types if you intend to delete by tag. Shadow grid acceleration is directional light only. The spatial shadow grid is only built when lightMode == "directional" . Point lights fall back to a linear O(M) scan, so heavy shadow scenes are fastest in directional mode. guiShift and yOffset. scene.guiShift and scene.yOffset position the 3D viewport on the chart without consuming historical bar slots. Increase guiShift to push the scene rightward into future bar space; adjust yOffset to slide it vertically in price units. bar_time projection. All chart drawings are emitted with xloc.bar_time , so the scene can sit arbitrarily far left or right of bar_index without forcing Pine to extend its history buffer. This is what keeps the engine stable on long charts and future projected scenes. barLabels() without values. When you call mesh.barLabels(catNames) and omit value labels, every later updateBars(values) auto formats the numeric values via str.tostring() . Pass valLabels only when you need custom strings. Direct mesh.vertices mutation requires invalidateCache(). Transform mutators ( moveTo , rotateBy , scaleTo , etc.) invalidate the world vertex cache on their own. Only raw index writes like mesh.vertices.set(i, newVec) need a manual mesh.invalidateCache() call to force re-projection. Skipping it will make the renderer draw stale geometry. Drawing budgets fail silently. If a scene emits more than 100 polylines, 500 lines, or 500 labels in a single frame, TradingView silently drops the overflow without raising a runtime error. Missing geometry almost always means a budget overrun - lower maxFaces , drop a contour level, or simplify overlay primitives to bring the frame back inside the caps. render() deletes non Pine3D drawings too. Every render() call clears polyline.all , line.all , label.all , and linefill.all before redrawing. Any manual label.new() , line.new() , etc. issued before render() in the same frame will be wiped. Issue custom drawings after the render call if you need them to persist. mergeMeshes() preserves depth grouping. When every source mesh passed into mergeMeshes() has the same vertex and face count (e.g. identical primitives in a voxel grid), the merged mesh auto derives depth group boundaries so the combined geometry still sorts correctly per original instance. Mixing primitives with different topologies disables the grouping. CPU timeouts: knobs to turn. Pine Script enforces a per bar execution budget, and dense scenes can trip it before the drawing budget ever does. If a scene compiles but times out at runtime, reach for these levers in order: lower occlusionRaster (e.g. 768 -> 384) for the biggest single perf win, reduce maxFaces to cap the solid face pool, drop levels on contour surfaces, simplify sphere/torus segment counts, and gate heavy work behind barstate.islast so history bars only build geometry rather than render it. ---------------------------------------------------------------------------------------------------------------- 🔷 MORE EXAMPLES The following scenes were all built entirely in Pine Script™ v6 using Pine3D as the rendering layer. They exist to demonstrate that the library is a real engine capable of complex, production grade visualizations. 🔸 4D Hypercube (Tesseract). A rotating tesseract, projected from 4D to 3D to 2D in real time using a custom 4D rotation matrix layered on top of Pine3D's standard projection pipeline. 🔸 Solar System. Following the publication of my 3D Solar System back in 2024, which introduced new graphical rendering concepts into Pine Script, we have seen a wave of various interpretations of the underlying vector classes, ranging from tutorials to niche specific integrations using hardcoded math. It became clear that a unified architecture was needed, one that would lower the barrier to entry while simultaneously handling the optimization process, which is both complex and error prone to do manually. That architecture is what Pine3D delivers. Below is a re-creation of the classic 3D Solar System rebuilt entirely on top of the library. It uses a fraction of the original code , renders roughly 5x faster , and adds real lighting cast directly from the Sun , all while consuming only a third of the available drawing budget thanks to the occlusion and culling mechanisms Pine3D handles out of the box. ---------------------------------------------------------------------------------------------------------------- 🔷 API REFERENCE 🔸 Top Level Entry Points. newScene() creates a ready to use Scene with a default camera and light. render(scene, ...) draws the current frame and auto clears the previous frame's chart drawings; see the Renderer section above for the full parameter list. vec3(x, y, z) creates a Vec3. colorBrightness() is an exported color utility helper. 🔸 Mesh Factories. Primitives - cube() , cuboid() , pyramid() , plane() , sphere() , cylinder() , torus() , grid() , disc() , circle() for ready made geometry. customMesh(verts, faces) - Low level escape hatch for authoring your own topology. mergeMeshes(meshes, tag, removeInterior) - Bakes transforms and combines many meshes into one. With removeInterior = true , coincident faces with opposing normals (e.g. shared walls between adjacent cubes in a grid) are culled so only the exterior shell survives, a major optimization for dense voxel style scenes. surface(heights, size, lowCol, highCol, levels, axisX, axisZ) - Creates a contour surface mesh. bars3D(values, barWidth, barDepth, spacing, lowCol, highCol, maxHeight) - Creates a combined 3D bar chart mesh; add labels with the chainable barLabels(names, values) method. 🔸 UDT Constructors. Overlay primitives and face descriptors are plain UDTs. Because these types have many fields, always instantiate them with named arguments rather than positional, e.g. Label3D.new(position = pos, txt = "•") : Face - fields: vi (array of vertex indices into the parent mesh), col . Used when authoring customMesh() topology; every face must have at least 3 indices and should be planar. Label3D - fields: position , txt , textColor , bgColor , labelStyle , labelSize , fontFamily , tooltip , visible , tag . Only position is required. Line3D - fields: start , end , col , width , visible , tag , lineStyle . Polyline3D - fields: points , col , fillColor , width , closed , visible , tag , lineStyle . Vec3.new(x, y, z) or the vec3(x, y, z) shorthand. 🔸 Trail Primitive. trail3D(size, capacity, trailCol, minSamples) creates a streamed Trail3D primitive with a main trail, two projection polylines, and a cage polyline. capacity is internally clamped to 300 samples to keep the rolling buffer inside Pine's execution budget; passing a larger value silently resolves to 300. minSamples (default 60) is the sample count at which the cage reaches its full cube width: below that the cage stays cube shaped and samples stretch across it; above that the cage grows rightward at a fixed step until capacity is hit. scene.add(trail) registers the sub primitives into the scene. Trail3D methods: pushSample() , axisLabels() , cage() , moveTo() , show() , hide() . 🔸 Mesh Methods. Transform - moveTo() , moveBy() , rotateTo() , rotateBy() , scaleTo() , scaleUniform() . Appearance - setColor() , setFaceColor() , setStyle() , show() , hide() , setTag() . Stroke styling (direct) - mesh.lineWidth := 3 and mesh.lineStyle := line.style_dashed control width and style of every visible mesh edge in wireframe modes and the outline of solid faces in drawMode = "poly" . Shadow opt out (direct) - mesh.castShadow := false excludes the mesh from shadow casting while still receiving light. Useful for ghost overlays, debug geometry, or semi transparent meshes you do not want occluding the scene. Lifecycle - clone() , faceCount() , invalidateCache() . Data mutation - updateSurface() and updateBars() refresh persistent meshes in place. updateBars() refreshes any bar label positions automatically; pass catLabels / valLabels to also update the text. Contour helpers - gridBox() and gridLabels() queue overlays on the mesh and hand them to the scene when you call scene.add(mesh) . Bar helpers - barLabels() is chainable on a bars3D() mesh and queues its category and value labels for the next scene.add(mesh) . Note: rotateTo() and rotateBy() expect degrees. The low level Vec3.rotateX/Y/Z() methods work in radians. 🔸 Scene Methods. Lighting - setLightDir() , setLightPos() , setLightMode() , setAmbient() , setShadowStrength() , showLightSource() . Scene graph - add(mesh) , add(label) , add(array) , add(line) , add(polyline) , add(trail) , remove(index) , remove(tag) , clear() . Lookup and navigation - getMesh() , getLabel() , getLine() , getPolyline() , lookAt() , totalFaces() . Cache control - invalidateLightCache() after mutating light direction or scene bounds externally; invalidateAllCaches() to also invalidate every mesh's world vertex cache (use after directly mutating mesh.vertices ). Note: scene.clear() clears the scene graph itself. render() only clears the previous frame's TradingView drawings. 🔸 Camera Methods. setPosition(x, y, z) moves the camera. lookAt(x, y, z) / lookAt(vec3) points at a world space target. orbit(angleX, angleY, distance) does a spherical orbit around the current target. setFov(val) sets the perspective scale factor. Camera fields ( position , target , fov ) are also directly mutable via assignment when you need to tune them outside the provided setters, e.g. scene.camera.fov := 1200.0 . 🔸 Light Field Mutation. In addition to the scene level convenience setters, every field on scene.light is directly mutable for fine grained tuning: scene.light.selfShadow := true enables self shadowing, scene.light.shadowBias := 0.2 adjusts the shadow acne offset, scene.light.shadowStrength and scene.light.ambient are also exposed. Mutate them after newScene() or between frames; the renderer reads them every call. 🔸 Vec3 Methods. Core math: add() , sub() , scale() , negate() , dot() , cross() , length() , normalize() , distanceTo() , lerp() . Rotation and helpers: rotateX() , rotateY() , rotateZ() , copy() , toString() . 🔸 Overlay Primitive Methods. Label3D - moveTo() , moveBy() , setText() , setTextColor() , setTooltip() , show() , hide() , setTag() . Line3D - setStart() , setEnd() , setPoints() , setColor() , show() , hide() , setTag() . Polyline3D - setColor() , show() , hide() , setTag() . Every UDT field is mutable via direct assignment for properties without a chainable setter: Label3D - bgColor , labelStyle (label.style_*), labelSize (size.*), fontFamily (font.family_*), visible . Line3D - width , lineStyle (line.style_solid / _dashed / _dotted / _arrow_left / _arrow_right / _arrow_both), visible . Polyline3D - width , lineStyle (line.style_solid / _dashed / _dotted only; arrow styles are not supported by TradingView's polyline primitive), fillColor , closed , visible . Mutations are read per frame by the renderer, so they animate freely. 🔸 High Level Scene Helpers. wireGrid(scene, w, d, divX, divZ, col) adds a depth sorted ground grid. scene.add(array) adds a batch of labels in one call - the idiomatic way to push a scatter cloud into the scene. 🔸 Mesh Level Chainable Overlays. mesh.barLabels(names, values, ...) adds category and value labels on a bars3D() mesh. mesh.gridBox(col, divs) adds a wireframe bounding box cage on a surface() mesh. mesh.gridLabels(col, xName, yName, zName, ticks, fmt) adds axis titles and tick value labels on a surface() mesh; tick values auto refresh on updateSurface() . All three are queued on the mesh and drained into the scene by scene.add(mesh) . ---------------------------------------------------------------------------------------------------------------- This work is licensed under (CC BY-NC-SA 4.0) , meaning usage is free for non-commercial purposes given that Alien_Algorithms is credited in the description for the underlying software. For commercial use licensing, contact Alien_Algorithms
Pine Script® library
by Alien_Algorithms
8
PriceActionLibrary "PriceAction" Will draw out the market structure for the disired pivot length. SetBarIndices(pivotHigh, pivotLow)   Sets the 'BarIndex' value of the 'Pivot' object. Useful if the pivot is from an other timeframe.   Parameters:      pivotHigh (Pivot) : The 'Pivot' object for the high pivot.      pivotLow (Pivot) : The 'Pivot' object for the low pivot. Alert(turtleSoupsContext, settings)   Will fire off an alert if there is one. To be used lastly in the calling script.   Parameters:      turtleSoupsContext (TurtleSoups) : The context of all turtle soups.      settings (TurtleSoupSettings) : The settings for turtle soups. VisualizeTurtleSoups(pivots, turtleSoups, turtleSoupsContext, settings)   Will visulize found turtle soups and add alert messages for it.   Parameters:      pivots (array) : All current pivots (high or low).      turtleSoups (array) : All bullish or bearish turtle soups.      turtleSoupsContext (TurtleSoups) : The context of all turtle soups.      settings (TurtleSoupSettings) : The settings for turtle soups. GetPivots(settings)   Will get available pivots. Can be called from another timeframe.   Parameters:      settings (TurtleSoupSettings) : The settings for turtle soups.   Returns: A tuple of high and then low pivots. SetPivots(turtleSoupsContext, settings, pivotHigh, pivotLow)   Will set the new pivots in turtleSoupsContext.   Parameters:      turtleSoupsContext (TurtleSoups) : The context of all turtle soups.      settings (TurtleSoupSettings) : The settings for turtle soups.      pivotHigh (Pivot) : The 'Pivot' object for the high pivot.      pivotLow (Pivot) : The 'Pivot' object for the low pivot. Confirm(turtleSoups, turtleSoupsContext, settings, previousStructureBreakBarIndex, screener)   Will visualize turtle soups. To be called if 'TurtleSoupSettings.Confirmation' is true.   Parameters:      turtleSoups (array) : All bullish or bearish turtle soups.      turtleSoupsContext (TurtleSoups) : The context of all turtle soups.      settings (TurtleSoupSettings) : The settings for turtle soups.      previousStructureBreakBarIndex (int) : The bar index of the previous structure break (BOS/CHoCH/CHoCH+).      screener (Screener) : The 'Screener' object to be used for Pine Screening by Tradingview. The function will set 'TurtleSoupUntilBarIndex' if there's a confirmed turtle soup. Liqudity(liquidity)   Will draw liquidity.   Parameters:      liquidity (Liquidity) : The 'PriceAction.Liquidity' object. Pivot(structure)   Sets the pivots in the structure.   Parameters:      structure (Structure) PivotLabels(structure)   Draws labels for the pivots found.   Parameters:      structure (Structure) EqualHighOrLow(structure)   Draws the boxes for equal highs/lows. Also creates labels for the pivots included.   Parameters:      structure (Structure) BreakOfStructure(structure)   Will create lines when a break of strycture occures.   Parameters:      structure (Structure)   Returns: The 'Pivot' that caused the break of structure, na otherwise. ChangeOfCharacter(structure)   Will create lines when a change of character occures. This line will have a label with "CHoCH" or "CHoCH+".   Parameters:      structure (Structure)   Returns: The 'Pivot' that caused the change of character, na otherwise. VisualizeCurrent(structure)   Will create a box with a background for between the latest high and low pivots. This can be used as the current trading range (if the pivots broke strucure somehow).   Parameters:      structure (Structure) StructureBreak   Holds drawings for a structure break.   Fields:      Line (series line) : The line object.      Label (series label) : The label object. Pivot   Holds all the values for a found pivot.   Fields:      Price (series float) : The price of the pivot.      BarIndex (series int) : The bar_index where the pivot occured.      Type (series int) : The type of the pivot (-1 = low, 1 = high).      Time (series int) : The time where the pivot occured.      BreakOfStructureBroken (series bool) : Sets to true if a break of structure has happened.      LiquidityBroken (series bool) : Sets to true if a liquidity of the price level has happened.      ChangeOfCharacterBroken (series bool) : Sets to true if a change of character has happened. Structure   Holds all the values for the market structure.   Fields:      LeftLength (series int) : Define the left length of the pivots used.      RightLength (series int) : Define the right length of the pivots used.      Type (series Type) : Set the type of the market structure. Two types can be used, 'internal' and 'swing' (0 = internal, 1 = swing).      Trend (series int) : This will be set internally and can be -1 = downtrend, 1 = uptrend.      EqualPivotsFactor (series float) : Set how the limits are for an equal pivot. This is a factor of the Average True Length (ATR) of length 14. If a low pivot is considered to be equal if it doesn't break the low pivot (is at a lower value) and is inside the previous low pivot + this limit.      ExtendEqualPivotsZones (series bool) : Set to true if you want the equal pivots zones to be extended.      ExtendEqualPivotsStyle (series string) : Set the style of equal pivot zones.      ExtendEqualPivotsColor (series color) : Set the color of equal pivot zones.      EqualHighs (array) : Holds the boxes for zones that contains equal highs.      EqualLows (array) : Holds the boxes for zones that contains equal lows.      BreakOfStructures (array) : Holds all the break of structures within the trend (before a change of character).      Pivots (array) : All the pivots in the current trend, added with the latest first, this is cleared when the trend changes.      FontSize (series int) : Holds the size of the font displayed.      AlertChangeOfCharacter (series bool) : Holds true or false if a change of character should be alerted or not.      AlertBreakOfStructure (series bool) : Holds true or false if a break of structure should be alerted or not.      AlerEqualPivots (series bool) : Holds true or false if equal highs/lows should be alerted or not. Liquidity   Holds all the values for liquidity.   Fields:      LiquidityPivotsHigh (array) : All high pivots for liquidity.      LiquidityPivotsLow (array) : All low pivots for liquidity.      LiquidityConfirmationBars (series int) : The number of bars to confirm that a liquidity is valid.      LiquidityPivotsLookback (series int) : A number of pivots to look back for.      FontSize (series int) : Holds the size of the font displayed. PriceAction   Holds all the values for the general price action and the market structures.   Fields:      Liquidity (Liquidity)      Swing (Structure) : Placeholder for all objects used for the swing market structure.      Internal (Structure) : Placeholder for all objects used for the internal market structure. TurtleSoupSettings   Holds sll the values for the settings for turtle soups.   Fields:      PivotLeftLenght (series int) : Define the left length of the pivots used.      PivotRightLenght (series int) : Define the right length of the pivots used.      Lookback (series int) : Set how many pivots back that will be used.      Confirmation (series bool) : Set if you want confirmation to be needed for q turtle soup to be formed (e g. a CHoCH).      Color (series color) : The color of turtle soups.      ScreenerKeep (series int) : Set the number of bars that the plot 'Turtle soup' will have a value after a turtle soup is found.      AlertFrequency (series string) : Set the frequency of alerts, possible values are 'alert.freq_all', 'alert.freq_once_per_bar' or 'alert.freq_once_per_bar_close'. TurtleSoup   To be used when a turtle soup is found and holds all values needed for it.   Fields:      Line (series line) : The line object between the pivot and the turtle soup.      Box (series box) : The bos for the turtle soup.      Start (series int) : The first bar of the turtle soup.      End (series int) : The last bar of the turtle soup.      Pivot (Pivot) : The pivot which liquidity was taken by the turtle soup. Screener   Holds all values to be used in the Pine Screener by Tradingview.   Fields:      TurtleSoupUntilBarIndex (series int) : Pine Screener value for turtle soups. TurtleSoups   TurtleSoups The entire context for all turtle soups.   Fields:      Highs (array) : The high pivots.      Lows (array) : The low pivots.      Bullish (array) : Bullish turtle soups.      Bearish (array) : Bearish turtle soups.      AlertMessages (array) : All messages for the current iteration.
Pine Script® library
by jhong2290
OriginLifecycleLibrary "OriginLifecycle" Strict Highlander v7 origin lifecycle for engulfing indicators. Exports enums, an OriginCandidate UDT, and four helper functions used by engulfing_opportunities_v20.6+ to detect, track, promote, invalidate, and consume origin levels discovered on lower timeframes inside an engulfment zone. Published-as-library rationale: the engulfing indicator is already at Pine v6's top-level-declaration limit (CE10295). Moving these types and functions into a library frees ~7 declarations in the main script without changing semantics. Reference: highlander_v7.pine:212-293 for the state-transition rules this implementation mirrors. tickStateMachine(c, bO, bH, bL, bC, bTime)   Pure state-transition function. One closed LTF bar in, updated candidate out. Mirrors highlander_v7.pine:212-293.   Parameters:      c (OriginCandidate) : The current candidate state.      bO (float) : Bar open.      bH (float) : Bar high.      bL (float) : Bar low.      bC (float) : Bar close.      bTime (int) : Bar start time in ms.   Returns: Updated OriginCandidate with `lastProcessedTime := bTime`. Caller is responsible for: - Only passing CLOSED LTF bars. - Skipping bars whose time <= c.lastProcessedTime. - On BROKEN_BSUT, looking for a retest in subsequent bars to delete. scanForBreakCandidates(isBullish, zoneLow, zoneHigh, prevO, prevH, prevL, prevC, prevT, currO, currH, currL, currC, currT, ltfValid, ltfMin, tfLabel, outCandidates)   Find new BREAK pairs in the engulfment zone and push them to `outCandidates` if not already tracked. De-dup key is (price, createdTime, tfLabel).   Parameters:      isBullish (bool) : true -> look for SUPPORT (green-green) pairs; false -> look for RESISTANCE (red-red) pairs.      zoneLow (float) : Lower bound of the engulfment zone (inclusive).      zoneHigh (float) : Upper bound of the engulfment zone (inclusive).      prevO (array)      prevH (array)      prevL (array)      prevC (array)      prevT (array)      currO (array)      currH (array)      currL (array)      currC (array)      currT (array)      ltfValid (bool) : Pre-computed validity flag for this LTF.      ltfMin (int) : LTF length in minutes (baked into each new candidate).      tfLabel (string) : Display string, e.g. "1H".      outCandidates (array) : The per-pattern candidate array to push into.   Returns: Nothing (mutates outCandidates). processNewLTFBars(candidates, ltfMin, prevO, prevH, prevL, prevC, prevT, currO, currH, currL, currC, currT, ltfValid)   Drive the state machine across unprocessed LTF bars for every candidate whose `ltfMinutes == ltfMin`. Removes candidates that reach BROKEN_BSUT AND see a retest within the buffer.   Parameters:      candidates (array) : The per-pattern candidate array to update.      ltfMin (int) : The LTF length this buffer represents; candidates with a different ltfMinutes are skipped.      prevO (array)      prevH (array)      prevL (array)      prevC (array)      prevT (array)      currO (array)      currH (array)      currL (array)      currC (array)      currT (array)      ltfValid (bool) : Validity flag.   Returns: Nothing (mutates candidates). applyConsumedOnTouch(candidates, greedyEntries, greedyConsumedFlags, isBullish, curLow, curHigh)   Per-tick sweep. Marks CONFIRMED origins and untouched greedy entries as consumed once price wicks into them. Caller passes `curLow`/`curHigh` because library functions cannot reference the `low`/`high` chart globals directly.   Parameters:      candidates (array) : Per-pattern origin-candidate array.      greedyEntries (array) : Per-pattern greedy-entry price array.      greedyConsumedFlags (array) : Parallel bool array — resized lazily to match greedyEntries size.      isBullish (bool) : Drives the touch check for greedy entries (origins use their own per-candidate dir).      curLow (float) : Current bar low (pass `low` from caller).      curHigh (float) : Current bar high (pass `high` from caller).   Returns: Nothing (mutates both arrays). OriginCandidate   A single tracked origin candidate.   Fields:      tfLabel (series string) : Display string ("1H", "5m" etc.).      ltfMinutes (series int) : Lower-timeframe length in minutes; used for the      price (series float) : The origin level price.      dir (series OriginDir) : UP (support) or DOWN (resistance).      state (series OriginState) : Current lifecycle state.      firstTouchTime (series int) : ms timestamp of first touch (0 if `touchSeen == false`).      touchSeen (series bool) : True once this candidate has been touched at least once.      createdTime (series int) : ms timestamp of the d1 bar that formed the BREAK pair.      lastProcessedTime (series int) : ms timestamp of the last LTF bar fed through the      consecutiveDirCount (series int) : Counter for 2-bar CONFIRMED confirmation, 0-2.
Pine Script® library
by HybriD_ez
HeikinAshiTrendUtilities Library HeikinAshiTrendUtilities This library contains reusable Heikin Ashi helpers for building Pine scripts that use Heikin Ashi as more than a candle style. It centralizes the Heikin Ashi foundation, HA-based oscillator engines, streak and confirmed-trend logic, Pressure Meter helpers, max-move scanning, Fib Backbone structure helpers, and Primary Trend helpers so those parts do not need to be rewritten across multiple scripts. Everything on the example chart is materially driven by the library, whether through the Heikin Ashi calculations themselves, the HA-based oscillator and pressure engine, the predictive close logic, the smoothed HA overlay, the Fib Backbone context window, or the structure geometry used to project key analytical visuals. How to use Import the library near the top of your script in global scope, alongside any other imports, before you start calling its helpers. Typical placement: • //@version=6 • indicator(...) or strategy(...) • import MYNAMEISBRANDON/HeikinAshiTrendUtilities/1 as haUtils For more information on libraries and incorporating them into your scripts, see the Libraries section of the Pine Script User Manual: www.tradingview.com ➖Heikin Ashi Core Helpers➖ These helpers handle the basic building blocks of Heikin Ashi. They let a script create standard HA candles, estimate the price needed to flip the current HA candle, and generate a smoothed HA version for a cleaner trend view. In other words, this region provides the core HA math used to build the rest of the library’s trend, engine, and structure tools. heikinAshi(openValue, closeValue, highValue, lowValue, haOpenPrev, haClosePrev) Builds one Heikin Ashi candle from real OHLC and prior HA state Parameters: openValue (float): Real open closeValue (float): Real close highValue (float): Real high lowValue (float): Real low haOpenPrev (float): Prior Heikin Ashi open haClosePrev (float): Prior Heikin Ashi close Returns: HA open, HA close, HA high, HA low, is HA up, is HA down haPredictClose(haOpen, openValue, highValue, lowValue) Estimates the real close price needed to flip the current HA candle Parameters: haOpen (float): Current Heikin Ashi open openValue (float): Real open highValue (float): Real high lowValue (float): Real low Returns: Predicted real close needed to flip the HA candle smoothedHeikinAshi(openValue, highValue, lowValue, closeValue, len1, len2) Builds double-smoothed Heikin Ashi values from real OHLC inputs Parameters: openValue (float): Real open highValue (float): Real high lowValue (float): Real low closeValue (float): Real close len1 (simple int): First EMA smoothing length applied to real OHLC len2 (simple int): Second EMA smoothing length applied to HA OHLC Returns: Smoothed HA open, smoothed HA high, smoothed HA low, smoothed HA close, is smoothed HA up, is smoothed HA down ➖HA Oscillator Foundation Helpers➖ These helpers turn raw Heikin Ashi candle movement into a usable oscillator foundation. They measure the HA candle’s bullish or bearish range, normalize that movement so it can be compared more consistently across bars, and build upper/lower guide levels that help a script judge when that oscillator is stretching into stronger trend pressure. In other words, this region creates the base signal that the HA Blend, HA Range Base, color engine, and Pressure Meter can build from. haSignedRangePct(haHigh, haLow, haClose, haIsBull, haIsBear) Returns the signed HA range-percent foundation used by the oscillator engine Parameters: haHigh (float): Heikin Ashi high haLow (float): Heikin Ashi low haClose (float): Heikin Ashi close haIsBull (bool): True when the current HA candle is bullish haIsBear (bool): True when the current HA candle is bearish Returns: Signed HA range-percent foundation haPreparedOscSource(signedSrc, normLen, useClamp, clampRange) Returns the normalized / optionally clamped HA oscillator source Parameters: signedSrc (float): Signed HA foundation normLen (simple int): Normalization lookback length useClamp (simple bool): Whether the normalized result should be clamped clampRange (float): Absolute clamp boundary when useClamp is true Returns: Prepared HA oscillator source haOscGuides(src, lookback, guideFactor) Returns upper and lower threshold guides from an oscillator series Parameters: src (float): Oscillator series lookback (simple int): Guide lookback window guideFactor (float): Scaling factor applied to the highest/lowest values Returns: Upper guide, lower guide ➖HA Blend Engine Helpers➖ These helpers take the prepared HA oscillator source and turn it into a smoother trend engine by blending multiple EMA pairs together. They let the script choose a faster, more balanced, or slower blend profile, then optionally smooth that final output one more time. In other words, this region builds the more layered, trend-following version of the HA oscillator engine. haBlendPairStackText(pairSet) Returns the active EMA pair-stack text for the selected HA Blend pair set Parameters: pairSet (simple string): Pair-set label. Expected values: "Fast", "Balanced", or "Slow" Returns: Pair-stack text haBlendEngineCore(src, pairSet) Returns the raw HA Blend engine core before final smoothing Parameters: src (float): Prepared HA signed source used by the blend engine pairSet (simple string): Pair-set label. Expected values: "Fast", "Balanced", or "Slow" Returns: Raw HA Blend engine core haBlendEngine(src, pairSet, useFinalSmooth, finalSmoothLen, finalSmoothType) Returns the final HA Blend engine with optional final smoothing Parameters: src (float): Prepared HA signed source used by the blend engine pairSet (simple string): Pair-set label. Expected values: "Fast", "Balanced", or "Slow" useFinalSmooth (simple bool): Whether final smoothing should be applied finalSmoothLen (simple int): Final smoothing length finalSmoothType (simple string): Final smoothing type. Expected values: "EMA" or "SMA" Returns: Final HA Blend engine ➖HA Range Base Engine Helpers➖ These helpers take the prepared HA oscillator source and smooth it in a more direct way than the Blend engine. Instead of combining multiple EMA pairs, they use one selected smoothing length and MA type to create a cleaner base trend signal, with the option to smooth that result one more time. In other words, this region builds the simpler, more straightforward version of the HA oscillator engine. haRangeEngineCore(src, rangeLen, rangeMaType) Returns the raw HA Range Base engine core before final smoothing Parameters: src (float): Prepared HA signed source used by the Range Base engine rangeLen (simple int): Core smoothing length used by the Range Base engine rangeMaType (simple string): Core smoothing type. Expected values: "EMA" or "SMA" Returns: Raw HA Range Base engine core haRangeEngine(src, rangeLen, rangeMaType, useFinalSmooth, finalSmoothLen, finalSmoothType) Returns the final HA Range Base engine with optional final smoothing Parameters: src (float): Prepared HA signed source used by the Range Base engine rangeLen (simple int): Core smoothing length used by the Range Base engine rangeMaType (simple string): Core smoothing type. Expected values: "EMA" or "SMA" useFinalSmooth (simple bool): Whether final smoothing should be applied finalSmoothLen (simple int): Final smoothing length finalSmoothType (simple string): Final smoothing type. Expected values: "EMA" or "SMA" Returns: Final HA Range Base engine ➖HA Threshold Color Helpers➖ This helper takes centered oscillator behavior and turns it into a usable visual color state. It helps a script decide when the HA-based oscillator is rising or falling above or below its guide levels so candles, rows, or other visuals can reflect stronger or weaker trend pressure. haThresholdStateColor(src, upperGuide, lowerGuide, aboveUpperRiseColor, aboveZeroRiseColor, aboveZeroFallColor, belowZeroFallColor, belowLowerFallColor, belowZeroRiseColor) Resolves a visual color from centered-oscillator threshold state Parameters: src (float): Source series upperGuide (float): Upper threshold guide lowerGuide (float): Lower threshold guide aboveUpperRiseColor (color): Color used when src is above the upper guide and rising aboveZeroRiseColor (color): Color used when src is above zero and rising aboveZeroFallColor (color): Color used when src is above zero and falling belowZeroFallColor (color): Color used when src is below zero and falling belowLowerFallColor (color): Color used when src is below the lower guide and falling belowZeroRiseColor (color): Color used when src is below zero and rising Returns: Resolved visual color ➖HA Structure Scan Helpers➖ This helper scans a chosen lookback window and finds the strongest completed move inside it. It compares bullish and bearish candidates in the same scan, then returns whichever move was stronger along with the start and end anchors. In other words, this region gives a script a reusable way to locate the dominant move that can later be used for Fib Backbone structure, Primary Max Move logic, or other trend-structure work. :contentReference {index=0} :contentReference {index=1} haScanMaxMove(lookback, includeCurrentBar, highSeries, lowSeries) Scans a lookback window for the strongest upward or downward percentage move Parameters: lookback (simple int): Number of bars to scan includeCurrentBar (simple bool): Whether bar 0 should be included in the scan highSeries (float): High series used for upward and downward move detection lowSeries (float): Low series used for upward and downward move detection Returns: Winning direction, winning percent move, winning start bars-ago, winning end bars-ago, winning span bars ➖HA Streak Helpers➖ These helpers let a script keep track of active Heikin Ashi streaks. They determine whether the current HA sequence is bullish or bearish, count how long that streak has been running, assign a tier color based on streak length, and measure how far price has moved from the streak’s starting point. In other words, this region helps turn raw HA trend runs into usable streak state, color, and percent-move data for candles, rows, labels, and trend readouts. :contentReference {index=0} haStreakState(haOpen, haClose, bullCountPrev, bearCountPrev) Resolves raw HA bull/bear state, streak counts, and streak start offset Parameters: haOpen (float): Current Heikin Ashi open haClose (float): Current Heikin Ashi close bullCountPrev (int): Prior bullish streak count bearCountPrev (int): Prior bearish streak count Returns: is HA bullish, is HA bearish, bullish streak count, bearish streak count, current streak length, streak start bars-ago haStreakTierColor(isHaBull, isHaBear, bullCount, bearCount, streakTierBars, bullTier1, bullTier2, bullTier3, bullTier4, bearTier1, bearTier2, bearTier3, bearTier4, neutralColor) Returns the active streak-tier color from bull/bear streak counts Parameters: isHaBull (bool): True when the current HA streak is bullish isHaBear (bool): True when the current HA streak is bearish bullCount (int): Current bullish streak count bearCount (int): Current bearish streak count streakTierBars (simple int): Number of bars required before advancing to the next tier bullTier1 (color): Bullish tier 1 color bullTier2 (color): Bullish tier 2 color bullTier3 (color): Bullish tier 3 color bullTier4 (color): Bullish tier 4 color bearTier1 (color): Bearish tier 1 color bearTier2 (color): Bearish tier 2 color bearTier3 (color): Bearish tier 3 color bearTier4 (color): Bearish tier 4 color neutralColor (color): Fallback color when no active streak is available Returns: Active streak-tier color haStreakPct(isHaBull, isHaBear, streakBars, highSeries, lowSeries) Returns the wick-based percent move from the streak start to the current bar Parameters: isHaBull (bool): True when the current HA streak is bullish isHaBear (bool): True when the current HA streak is bearish streakBars (int): Current active streak length highSeries (float): High series used for streak measurement lowSeries (float): Low series used for streak measurement Returns: Wick-based streak percent move ➖Confirmed HA Trend Helpers➖ These helpers let a script work with a slower, confirmation-based HA trend instead of flipping immediately on the first opposite HA candle. They track the currently confirmed direction, count how many opposite candles are building toward the next possible flip, project the confirmed trend using regular-price body or wick anchors, and measure how far that confirmed trend has moved from its confirmed start. In other words, this region helps scripts build a more stable HA trend model that filters out some of the noise of raw HA flips. :contentReference {index=0} :contentReference {index=1} haConfirmedTrendState(enabled, rawDir, confirmBars, dirPrev, oppCountPrev, startBarPrev, firstOppBarPrev) Resolves confirmed trend direction, build count, and confirmed start bar Parameters: enabled (simple bool): Whether the confirmed-trend engine is active rawDir (int): Current raw HA direction: +1 bull, -1 bear, 0 neutral confirmBars (simple int): Consecutive opposite raw HA bars required to confirm a flip dirPrev (int): Prior confirmed direction oppCountPrev (int): Prior opposite-side build count startBarPrev (int): Prior confirmed trend start bar index firstOppBarPrev (int): Prior first opposite raw HA bar index Returns: Confirmed direction, opposite-side build count, confirmed start bar index, first opposite raw HA bar index, confirmed leg bars, confirmed start bars-ago haConfirmedTrendProjection(confirmedDir, startOffset, openValue, highValue, lowValue, closeValue, anchorMode, pathMode, forwardBars) Returns confirmed trend projection geometry from body/wick anchor rules Parameters: confirmedDir (int): Confirmed direction: +1 bull, -1 bear, 0 neutral startOffset (int): Confirmed start bars-ago offset openValue (float): Regular-price open highValue (float): Regular-price high lowValue (float): Regular-price low closeValue (float): Regular-price close anchorMode (simple string): Projection anchor mode: "Body" or "Wick" pathMode (simple string): Projection path mode: "Same Side" or "Opposite Side" forwardBars (simple int): Number of bars forward for projection Returns: Has valid projection, start Y, current Y, future Y, slope haConfirmedTrendPct(confirmedDir, startOffset, highSeries, lowSeries) Returns confirmed streak percent movement from the confirmed start bar Parameters: confirmedDir (int): Confirmed direction: +1 bull, -1 bear, 0 neutral startOffset (int): Confirmed start bars-ago offset highSeries (float): HA high series used for confirmed move measurement lowSeries (float): HA low series used for confirmed move measurement Returns: Confirmed streak percent move ➖HA Pressure Meter Helpers➖ These helpers take the HA-based oscillator engine and convert it into an easier 0–100 pressure reading. They help a script decide when bullish or bearish pressure is becoming active, assign matching tier colors for rows or other visuals, and return the color state for a pressure strip or similar chart-edge signal. In other words, this region turns the HA oscillator into a simpler pressure model that is easier to read at a glance. haPressureMeter(rawOsc, bullAnchor, bearAnchor) Normalizes a raw oscillator value into a 0-100 Pressure Meter Parameters: rawOsc (float): Raw oscillator value bullAnchor (float): Raw oscillator value that should map to 100 bearAnchor (float): Raw oscillator value that should map to 0 Returns: Pressure Meter value in the 0-100 range haPressureState(pressureMeter, bullThreshold, bearThreshold) Resolves bullish, bearish, and neutral threshold state from the Pressure Meter Parameters: pressureMeter (float): Normalized Pressure Meter value bullThreshold (float): Meter level where bullish pressure becomes active bearThreshold (float): Meter level where bearish pressure becomes active Returns: Bull-active, bear-active, neutral-between haPressureTierColors(pressureMeter, bullTier1, bullTier2, bullTier3, bullTier4, bearTier1, bearTier2, bearTier3, bearTier4, fallbackBg) Returns tier-based pressure-row background and readable text color Parameters: pressureMeter (float): Normalized Pressure Meter value bullTier1 (color): Bull tier 1 color bullTier2 (color): Bull tier 2 color bullTier3 (color): Bull tier 3 color bullTier4 (color): Bull tier 4 color bearTier1 (color): Bear tier 1 color bearTier2 (color): Bear tier 2 color bearTier3 (color): Bear tier 3 color bearTier4 (color): Bear tier 4 color fallbackBg (color): Fallback background when the meter is na Returns: Row background color, row text color haPressureStripColor(pressureMeter, bullThreshold, bearThreshold, bullTier1, bullTier2, bullTier3, bullTier4, bearTier1, bearTier2, bearTier3, bearTier4, neutralColor, activeTransp, neutralTransp) Returns active or neutral strip color from the Pressure Meter state Parameters: pressureMeter (float): Normalized Pressure Meter value bullThreshold (float): Meter level where bullish pressure becomes active bearThreshold (float): Meter level where bearish pressure becomes active bullTier1 (color): Bull tier 1 color bullTier2 (color): Bull tier 2 color bullTier3 (color): Bull tier 3 color bullTier4 (color): Bull tier 4 color bearTier1 (color): Bear tier 1 color bearTier2 (color): Bear tier 2 color bearTier3 (color): Bear tier 3 color bearTier4 (color): Bear tier 4 color neutralColor (color): Neutral-zone base color activeTransp (int): Transparency used when bull or bear pressure is active neutralTransp (int): Transparency used inside the neutral zone Returns: Strip color ➖Fib Backbone Structure Helpers➖ These helpers take a winning max-move scan and turn it into the structure a script can use for Fib Backbone analysis. They define the backbone’s start and end anchors, determine the related support/resistance anchor geometry, calculate Fib level prices between those anchors, and measure how far current price is from those levels. In other words, this region helps convert a dominant move into a reusable backbone structure that can support diagonals, S/R anchors, boxes, and Fib-based readouts. haFibBackboneStructure(dir, startBA, endBA, openValue, highValue, lowValue, closeValue) Returns backbone coordinates, S/R anchors, and anchor-box geometry Parameters: dir (int): Winning move direction: +1 bull, -1 bear, 0 none startBA (int): Winning move start bars-ago endBA (int): Winning move end bars-ago openValue (float): Regular-price open highValue (float): Regular-price high lowValue (float): Regular-price low closeValue (float): Regular-price close Returns: ok, xStart, xEnd, yStart, yEnd, startIsRes, endIsRes, anchorTopS, anchorBotS, anchorTopE, anchorBotE, isTopS, isTopE haFibLevelPrice(yStart, yEnd, fibLevel) Returns the price of one fib level between the backbone anchors Parameters: yStart (float): Backbone start anchor price yEnd (float): Backbone end anchor price fibLevel (float): Fib level such as 0.236, 0.382, 0.50, 0.618, 0.786 Returns: Fib level price haFibPctFromClose(closeValue, fibPrice) Returns percent distance from close to a fib level Parameters: closeValue (float): Current close fibPrice (float): Fib level price Returns: Percent from close to fib level ➖Fib Backbone Context Window Helpers➖ These helpers build the larger context window around the active Fib Backbone lookback. They let a script define the left/right range of that window, calculate its current high and low bounds, and find the midpoint of the same structure. In other words, this region helps frame the broader area that the active backbone move is being selected from, so the move can be viewed in context rather than in isolation. haFibContextWindow(lookback, includeCurrentBar, sourceMode, highValue, lowValue, closeValue) Returns the active Fib Backbone context window geometry Parameters: lookback (simple int): Context-window lookback length includeCurrentBar (simple bool): Whether the current bar participates in the active window sourceMode (simple string): Source selection. Expected values: "Wicks" or "Closes" highValue (float): Regular-price high lowValue (float): Regular-price low closeValue (float): Regular-price close Returns: ok, leftX, rightX, windowBars, windowHigh, windowLow, leftHigh, leftLow haFibContextMidpoint(ok, windowHigh, windowLow) Returns the midpoint of the active Fib Backbone context window Parameters: ok (bool): Whether the context window is valid windowHigh (float): Active context-window high windowLow (float): Active context-window low Returns: Context-window midpoint ➖Primary Trend Window Helpers➖ These helpers scan a lookback window to find the strongest completed HA streak and turn that winner into usable trend information. They identify the winning streak, assign it the correct tier color, and return the anchor coordinates needed to project that streak as a chart-side diagonal. In other words, this region helps a script reduce a larger HA trend window down to its most important completed streak structure. haPrimaryTrendWinner(lookback, haBull, haBear, bullCount, bearCount, haHigh, haLow) Returns the strongest completed HA streak inside the lookback window Parameters: lookback (simple int): Number of bars to scan haBull (bool): Bullish HA state series haBear (bool): Bearish HA state series bullCount (int): Bullish HA streak-count series bearCount (int): Bearish HA streak-count series haHigh (float): HA high series used for wick-based streak measurement haLow (float): HA low series used for wick-based streak measurement Returns: Winning streak length, winning direction, winning percent move, winning start bars-ago, winning end bars-ago, winning validity state haPrimaryTrendTierColor(dir, streakLen, streakTierBars, bullTier1, bullTier2, bullTier3, bullTier4, bearTier1, bearTier2, bearTier3, bearTier4, fallbackBg) Returns the winning Primary Trend tier color Parameters: dir (int): Winning streak direction: +1 bull, -1 bear, 0 none streakLen (int): Winning streak length streakTierBars (simple int): Number of bars required before advancing to the next tier bullTier1 (color): Bullish tier 1 color bullTier2 (color): Bullish tier 2 color bullTier3 (color): Bullish tier 3 color bullTier4 (color): Bullish tier 4 color bearTier1 (color): Bearish tier 1 color bearTier2 (color): Bearish tier 2 color bearTier3 (color): Bearish tier 3 color bearTier4 (color): Bearish tier 4 color fallbackBg (color): Fallback background when no valid winner exists Returns: Winning tier color haPrimaryTrendCoords(dir, startBA, endBA, highSeries, lowSeries) Returns diagonal coordinates from the winning streak anchors Parameters: dir (int): Winning streak direction: +1 bull, -1 bear, 0 none startBA (int): Winning start bars-ago endBA (int): Winning end bars-ago highSeries (float): High series used for line anchors lowSeries (float): Low series used for line anchors Returns: ok, x1, x2, y1, y2 NOTES This is a Heikin-Ashi-specific utility library. It is meant to provide the reusable HA math, state, and structure layer. Final rendering choices such as plot style, line objects, boxes, labels, tables, and overall UI layout are expected to remain script-level decisions. Thanks to SimpleCryptoLife for the open-source HA core functions heikinAshi() & haPredictClose() and thus the inspiration that they've given me to create HA-based indicators for the HA trader enthusiast.
Pine Script® library
by MYNAMEISBRANDON
2
NQ Matrix Core Model (BETA) VerA01 260415NQ Bearish Continuation Matrix From Day High This indicator maps a structured continuation model derived from the Daily High, plotting predefined downside liquidity levels to help visualize potential reaction zones during bearish expansion. The model is built around a fixed point-based framework that projects percentage-based levels from the session high, highlighting key areas of interest such as: Entry zones Take-profit areas High-probability reaction levels Each level is color-coded based on its classification within the model to distinguish between: Entry zones Target zones Structural reaction levels Designed for discretionary traders focusing on liquidity-based price delivery, session expansion, and continuation moves. This tool is intended for analysis and educational use only and does not constitute financial advice.
Pine Script® library
by daltonbristow5
AvwapLibLibrary "AvwapLib" Shared functions: AVWAP, stage classification, position sizing, swing detection, and risk helpers. Used by all strategy() scripts. NOTE: rs_vs_spy() cannot live here (request.security() banned in library exports) — each strategy implements it inline. avwap(src, anchor_bar, max_lookback)   Anchored VWAP from a specific bar to current bar. Uses loop approach with bounded max_lookback for robustness.   Parameters:      src (float) : Source price (typically hlc3)      anchor_bar (int) : Bar index of anchor point (from find_swing_high/low)      max_lookback (simple int) : Maximum bars to look back (cap for performance, default 500 ~2yr daily)   Returns: AVWAP value, or na if anchor invalid or out of range avwap_slope(avwap_val, lookback)   AVWAP slope — rate of change over lookback period.   Parameters:      avwap_val (float) : AVWAP series      lookback (simple int) : Number of bars for slope calculation   Returns: Slope (positive = rising, negative = falling), or na dcr()   Daily Closing Range — where price closed within the bar's range.   Returns: DCR as percentage (0 = closed at low, 100 = closed at high) rvol(period)   Relative Volume — current bar volume vs historical average. Uses volume offset to avoid including current bar in average.   Parameters:      period (simple int) : Lookback period for average calculation   Returns: RVOL ratio (>1 = above average) is_stage2()   Stage 2 check (simplified Weinstein model). Conditions: price > SMA50, SMA50 rising (vs 10 bars ago), price > SMA200.   Returns: true if all Stage 2 conditions met calc_shares(entry, stop, risk_pct, equity)   Position size: shares = floor(equity * risk% / risk_per_share).   Parameters:      entry (float) : Entry price      stop (float) : Stop-loss price      risk_pct (float) : Risk as decimal (0.01 = 1%)      equity (float) : Account equity   Returns: Number of shares (integer), 0 if invalid rr_valid(entry, stop, target, min_rr)   Validate risk/reward ratio meets minimum threshold.   Parameters:      entry (float) : Entry price      stop (float) : Stop-loss price      target (float) : Target price      min_rr (float) : Minimum required R:R (e.g., 2.0 for 1:2)   Returns: true if R:R >= min_rr confirmed()   Returns true only on confirmed (closed) bars. MUST gate every entry/exit signal to prevent repainting.   Returns: true if bar is confirmed find_swing_high(strength)   Bar index of the most recent confirmed swing high. Uses ta.pivothigh — confirmed 'strength' bars after the actual high. Result persists (via var) until a new swing high is detected.   Parameters:      strength (simple int) : Number of bars required on each side to confirm pivot   Returns: Bar index of last swing high, or na if none found yet find_swing_low(strength)   Bar index of the most recent confirmed swing low. Uses ta.pivotlow — confirmed 'strength' bars after the actual low. Result persists (via var) until a new swing low is detected.   Parameters:      strength (simple int) : Number of bars required on each side to confirm pivot   Returns: Bar index of last swing low, or na if none found yet
Pine Script® library
by moseslareach
ADEVisualOpsLibrary "ADEVisualOps" Visual object helpers extracted to reduce main-script compiled token pressure. lineStyleFromText(styleText)   Parameters:      styleText (string) shapeSizeFromPx(px)   Parameters:      px (int) textSizeFromText(sizeText)   Parameters:      sizeText (string) updateHLine(ln, isVisible, leftX, priceY, rightX, lnColor, styleText, lnWidth)   Parameters:      ln (line)      isVisible (bool)      leftX (int)      priceY (float)      rightX (int)      lnColor (color)      styleText (string)      lnWidth (int) updateZoneBox(bx, isVisible, leftX, topY, rightX, bottomY, bgColor, borderColor)   Parameters:      bx (box)      isVisible (bool)      leftX (int)      topY (float)      rightX (int)      bottomY (float)      bgColor (color)      borderColor (color) replaceLeftTag(lb, isVisible, x, y, txt, bgColor, textPx)   Parameters:      lb (label)      isVisible (bool)      x (int)      y (float)      txt (string)      bgColor (color)      textPx (int) replaceSignalLabel(lb, isVisible, x, y, txt, isBull, bgColor, textPx)   Parameters:      lb (label)      isVisible (bool)      x (int)      y (float)      txt (string)      isBull (bool)      bgColor (color)      textPx (int)
Pine Script® library
by PedroSilva45
SessionVolumeProfileLibrary "SessionVolumeProfile" calcProfile(highs, lows, volumes, rows)   Computes POC, VAL, VAH for 70% VA using 24 price rows.   Parameters:      highs (array) : Series of highs.      lows (array) : Series of lows.      volumes (array) : Series of volumes.      rows (simple int) : simple int Number of price bins (default 24).   Returns: VolumeProfile object. VolumeProfile   Volume profile levels from a session.   Fields:      poc (series float)      vah (series float)      val (series float)      totalVolume (series float)
Pine Script® library
by HRISHIKESH_ASHOK_UTKUR
ADEForecastMathLibrary "ADEForecastMath" Stable forecast, scenario, and threshold helpers extracted from the main Altcoin PRO script. pickMinAbove(ref, a, b, c, d, e, f, g, h, i, j, k, l)   Returns nearest level above ref.   Parameters:      ref (float)      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float)      h (float)      i (float)      j (float)      k (float)      l (float) pickMaxBelow(ref, a, b, c, d, e, f, g, h, i, j, k, l)   Returns nearest level below ref.   Parameters:      ref (float)      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float)      h (float)      i (float)      j (float)      k (float)      l (float) pickMinAboveMinDist(ref, minDist, a, b, c, d, e, f, g, h, i, j, k, l)   Returns nearest level above ref with minimum distance.   Parameters:      ref (float)      minDist (float)      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float)      h (float)      i (float)      j (float)      k (float)      l (float) pickMaxBelowMinDist(ref, minDist, a, b, c, d, e, f, g, h, i, j, k, l)   Returns nearest level below ref with minimum distance.   Parameters:      ref (float)      minDist (float)      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float)      h (float)      i (float)      j (float)      k (float)      l (float) softmax7(a, b, c, d, e, f, g, temperature)   Softmax over seven values, returned as percentages.   Parameters:      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float)      temperature (float) max7(a, b, c, d, e, f, g)   Max over seven values.   Parameters:      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float) second7(a, b, c, d, e, f, g)   Second max over seven values.   Parameters:      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float) mixTowardUniform(p, blend, uniformP)   Blends p towards a uniform probability.   Parameters:      p (float)      blend (float)      uniformP (float) softCap(p, cap)   Soft-caps probability p.   Parameters:      p (float)      cap (float) hardCapAndRedistribute7(a, b, c, d, e, f, g, cap)   Hard-caps seven values and redistributes excess.   Parameters:      a (float)      b (float)      c (float)      d (float)      e (float)      f (float)      g (float)      cap (float)
Pine Script® library
by PedroSilva45
ADECoreTextMathLibrary "ADECoreTextMath" Stable text, grading, formatting, and lightweight math helpers extracted from the main Altcoin PRO script. clamp(x, lo, hi)   Clamps a float between low and high.   Parameters:      x (float)      lo (float)      hi (float) nz0(x)   Returns 0.0 when the input is na.   Parameters:      x (float) safeDiv(a, b)   Safely divides a by b.   Parameters:      a (float)      b (float) safeText(txt, fallback)   Returns fallback when txt is empty.   Parameters:      txt (string)      fallback (string) boolText(x)   Converts a bool to Yes or No.   Parameters:      x (bool) grade(score)   Converts a score to a verbal grade.   Parameters:      score (float) qualityBadge(score)   Converts a score to a compact badge.   Parameters:      score (float) compactMillions(value)   Formats large numbers into B/M/K strings.   Parameters:      value (float) roomText(v)   Formats ATR room values.   Parameters:      v (float) floatText(value, fmt)   Formats a float with a pattern.   Parameters:      value (float)      fmt (string) percentText(value)   Formats a percentage value.   Parameters:      value (float) addReason(base, reason)   Adds a reason to a pipe-delimited string.   Parameters:      base (string)      reason (string) freshness(age, full, zero)   Converts bar age into freshness score.   Parameters:      age (float)      full (float)      zero (float) freshnessText(freshnessScore)   Formats freshness score.   Parameters:      freshnessScore (float) scenarioName(id)   Returns the human-readable scenario name.   Parameters:      id (int) confidenceTone(score)   Converts confidence score to text.   Parameters:      score (float) leadTone(lead)   Converts lead score to text.   Parameters:      lead (float) trendMomentumText(rsi, roc, adx, diPlus, diMinus, macdHist)   Returns trend/momentum descriptor.   Parameters:      rsi (float)      roc (float)      adx (float)      diPlus (float)      diMinus (float)      macdHist (float) volatilityState(atrPct, atrRatio, compressed, expanded)   Returns volatility descriptor.   Parameters:      atrPct (float)      atrRatio (float)      compressed (bool)      expanded (bool) rangeBiasText(bull, bear, neutralRange, deadCompression)   Returns range/bias descriptor.   Parameters:      bull (bool)      bear (bool)      neutralRange (bool)      deadCompression (bool) wickAcceptance(bullAccept, bearAccept, bullReject, bearReject)   Returns wick/acceptance descriptor.   Parameters:      bullAccept (bool)      bearAccept (bool)      bullReject (bool)      bearReject (bool) marketClimateText(climate)   Returns climate descriptor.   Parameters:      climate (int) positionBar(pct)   Creates the 52-week placement bar.   Parameters:      pct (float)
Pine Script® library
by PedroSilva45
KeyLevelsLibrary "KeyLevels" Library for common trading levels including VWAP, session levels (Asia, London, NYC, Comex IB), HTF OHLC, and Opening Ranges. --- IMPLEMENTATION INSTRUCTIONS --- 1. Save this script as a Library named "KeyLevels". 2. In your indicator/strategy, import it: `import /KeyLevels/1 as kl` 3. To get the data object, call: `levels = kl.getLevels()` 4. Access levels using dot notation: `levels.loH` (London High), `levels.nycH` (NYC High), `levels.cibH` (Comex IB High). 5. To get all levels in a single array for loops: `levelArray = kl.toArray(levels)` --- TIMEZONE NOTE --- The default timezone is "UTC-5" (New York). For accurate seasonal adjustments, use "America/New_York". getLevels(vwapAnchor, vwapMult, rollingLen, htfAnchor, tz)   getLevels Calculates and returns a KeyLevelsData object with comprehensive trading levels.   Parameters:      vwapAnchor (string) : Anchor condition for the main VWAP (e.g., "1D", "1W").      vwapMult (float) : Standard deviation multiplier for VWAP bands.      rollingLen (int) : Length for the rolling VWAP calculation.      htfAnchor (string) : Anchor for the HTF VWAP (e.g., "1W", "1M").      tz (string) : Timezone for session calculations (default: "UTC-5").   Returns: A `KeyLevelsData` object containing the levels. toArray(data)   toArray Converts a KeyLevelsData object into a flat array of floats.   Parameters:      data (KeyLevelsData) : The KeyLevelsData object to convert.   Returns: An array of floats containing all levels. KeyLevelsData   KeyLevelsData Master structure to hold all calculated key levels (Flattened).   Fields:      vwapCenter (series float)      vwapUpper (series float)      vwapLower (series float)      htfVwapCenter (series float)      htfVwapUpper (series float)      htfVwapLower (series float)      rollingVwap (series float)      dailyOpen (series float)      asO (series float)      asH (series float)      asL (series float)      asC (series float)      loO (series float)      loH (series float)      loL (series float)      loC (series float)      nycO (series float)      nycH (series float)      nycL (series float)      nycC (series float)      cibO (series float)      cibH (series float)      cibL (series float)      cibC (series float)      ibO (series float)      ibH (series float)      ibL (series float)      ibC (series float)      ibMid (series float)      o5O (series float)      o5H (series float)      o5L (series float)      o5C (series float)      o15O (series float)      o15H (series float)      o15L (series float)      o15C (series float)      o30O (series float)      o30H (series float)      o30L (series float)      o30C (series float)      pdO (series float)      pdH (series float)      pdL (series float)      pdC (series float)      pwO (series float)      pwH (series float)      pwL (series float)      pwC (series float)      cwO (series float)      cwH (series float)      cwL (series float)      cwC (series float)      cmO (series float)      cmH (series float)      cmL (series float)      cmC (series float)      settlement (series float)
Pine Script® library
by adekoyotemohn
RiskManagerLibrary "RiskManager" A library for risk management and position sizing calculations. calc_position_size(account_size, risk_pct, entry_price, stop_loss)   Calculates the optimal position size (number of shares/contracts) based on account risk.   Parameters:      account_size (simple float) : The total account balance in your account currency (simple float).      risk_pct (simple float) : The percentage of the account to risk per trade (simple float, e.g., 1.0 for 1%).      entry_price (float) : The planned entry price for the trade (series float).      stop_loss (float) : The planned stop-loss price for the trade (series float).   Returns: The calculated position size (series float). Returns 0 if stop loss equals entry price to avoid division by zero.
Pine Script® library
by Enriusubf
BandsLibLibrary "BandsLib" f_calc_survival_bands(basis, dev, shift_z, prob_pct, mr_shift)   Parameters:      basis (float) : Base price level (MA, median, etc.)      dev (float) : Standard deviation or volatility measure      shift_z (float) : Directional shift factor (e.g., vector pressure, momentum)      prob_pct (float) : Survival probability percentage (e.g., 10 = 10%)      mr_shift (float) : Mean reversion shift (optional, contrarian to shift_z)   Returns: Tuple of upper and lower survival bands f_detect_squeeze(band_up, band_dn, price, damping)   Parameters:      band_up (float) : Upper band level      band_dn (float) : Lower band level      price (float) : Current price      damping (float) : Correlation damping factor (0-1)   Returns: Tuple of bullish/bearish squeeze signals and bandwidth percentile f_detect_confluence(basis, fv, dev, tol_mult, min_lines)   Parameters:      basis (float) : Base price level (MA, median, etc.)      fv (float) : Fair value or equilibrium price      dev (float) : Standard deviation or volatility measure      tol_mult (float) : ATR multiplier for clustering tolerance      min_lines (int) : Minimum number of converging lines to trigger confluence
Pine Script® library
by cybermediaboy
FMatrixSCLibraryLibrary "FMatrixSCLibrary" defaultTheme() calcEnv(adx, rsi, atr_pr, er, mean_ext, btcRet, date, dir)   Parameters:      adx (float)      rsi (float)      atr_pr (float)      er (float)      mean_ext (float)      btcRet (float)      date (string)      dir (string) pushEnv(arr, snap, maxSize)   Parameters:      arr (array)      snap (EnvSnap)      maxSize (int) calcSys(history, tradeNum, date, dir, r, wl, earlyExit, equity, peakEq, dd, dow, quarter, cycleYear)   Parameters:      history (array)      tradeNum (int)      date (string)      dir (string)      r (float)      wl (int)      earlyExit (bool)      equity (float)      peakEq (float)      dd (float)      dow (string)      quarter (string)      cycleYear (int) pushSys(arr, snap, maxSize)   Parameters:      arr (array)      snap (SysSnap)      maxSize (int) renderEnvTable(t, snaps, maxRows, sysCode, theme)   Parameters:      t (table)      snaps (array)      maxRows (int)      sysCode (string)      theme (SCTheme) renderSysTable(t, snaps, maxRows, sysCode, theme)   Parameters:      t (table)      snaps (array)      maxRows (int)      sysCode (string)      theme (SCTheme) SCTheme   Fields:      bg (series color)      hdr (series color)      row (series color)      row2 (series color)      txt (series color)      dim (series color)      cyan (series color)      bull (series color)      bear (series color)      gold (series color)      grid (series color) EnvSnap   Fields:      date (series string)      dir (series string)      adx (series float)      rsi (series float)      atr_pr (series float)      er (series float)      mean_ext (series float)      btc_ret (series float) SysSnap   Fields:      num (series int)      date (series string)      dir (series string)      r (series float)      wl (series int)      early_exit (series bool)      equity (series float)      peak_eq (series float)      dd (series float)      state (series string)      streak (series int)      wr20 (series float)      dow (series string)      quarter (series string)      cycle_year (series int)
Pine Script® library
by Rafe-Promachos-LLP
Vantage_News_HistoricalVantage News is a Pine Script library that provides pre-market economic event filtering defaults intended for strategies that trade on YM futures. It determines a default for whether trading should be blocked, delayed, or allowed on any given day. This Historical file contains prior years. Core Concept News events are pre-compiled into Pine Script data libraries organized by half-year (LO1_News2025H1, LO1_News2025H2, etc.), updated weekly on Sundays. There are no API calls — events are baked into arrays of dates, times, type IDs, and severities. Severity System Can be configured to define or override three default severity tiers: - Sev 3 (CPI, NFP, FOMC) — defaults to blocks the entire day or delays, depending on policy - Sev 2 (ISM PMI, claims) — defaults to delay trading until the event time + a configurable post-delay window - Sev 1 (secondary indicators) — defaults to no delays Blocking vs Delaying - Block: No trading for the full session. WillTradeToday() returns false. - Delay: Trading allowed after eventTime + delayMinutes. IsDelayed(currentTimeMs) returns true until the release time passes. Provides a per-event-type policy mechanism so overrides can force any event to block, delay, or be ignored regardless of its base severity. Next Trading Window Calculation FindNextTradingWindow() scans forward up to 14 days, skipping weekends and blocked days based on the provided configuration. If the next tradeable day has a delay, it returns the delayed start time — so an info panel can show e.g. "Mon 7:35 AM" to indicate the next trading opening Exception Mappings Each half-year library can ship per-event-type overrides (different severity, custom delay minutes, tags). When the applyLibExceptionMappings configuration is enabled, these override the base severity — allowing the data to carry date-specific adjustments. Special Handling CME early close days are encoded as a special event type. CheckCmeEarlyClose() returns a halt timestamp so a strategy can truncate the session. Caching Evaluation is lazy and memoized by date string — EvaluateForDate() only recomputes when the date changes. The event cache is built once at initialization via a day index for fast date lookups.
Pine Script® library
by Vantage-Stack