PINE LIBRARY
ZigZag
Aktualisiert
█ OVERVIEW
This library is a Pine Script™ programmer’s tool containing custom user-defined types and functions to calculate Zig Zag indicators within their scripts. It is not a stand-alone indicator.
Pine Script™ libraries are publications that contain reusable code for importing into Pine Script™ indicators, strategies, and other libraries. For more information on libraries and incorporating them into your scripts, see the Libraries section of the Pine Script™ User Manual.
█ CONCEPTS
Zig Zag
Zig Zag is a popular indicator that filters out minor price fluctuations to denoise data and emphasize trends. Traders commonly use Zig Zag for trend confirmation, identifying potential support and resistance, and pattern detection. It is formed by identifying significant local high and low points in alternating order and connecting them with straight lines, omitting all other data points from their output. There are several ways to calculate the Zig Zag's data points and the conditions by which its direction changes. This script uses pivots as the data points, which are the highest or lowest values over a defined number of bars before and after them. The direction only reverses when a newly formed pivot deviates from the last Zig Zag point in the opposite direction by an amount greater than or equal to a specified percentage.
To learn more about Zig Zag and how to calculate it, see this entry from the Help Center.
█ FOR Pine Script™ CODERS
Notes
This script's architecture utilizes user-defined types (UDTs) to create custom objects which are the equivalent of variables containing multiple parts, each able to hold independent values of different types. UDTs are the newest addition to Pine Script™ and the most advanced feature the language has seen to date. The feature's introduction creates a new runway for experienced coders to push the boundaries of Pine. We recommend that newcomers to the language explore the basics first before diving into UDTs and objects.
Demonstration Code
Our example code shows a simple use case by displaying a Zig Zag with user-defined settings. A new ZigZag object is instantiated on the first bar using a Settings object to control its attributes. The fields for the Settings object are declared using variables assigned to input.* functions, allowing control of the field values from the script's settings. The `update()` function is invoked on each bar to update the ZigZag object's fields and create new lines and labels when required.
Look first. Then leap.
█ TYPES
This library contains the following types:
Settings
Provides calculation and display attributes to ZigZag objects.
Fields:
devThreshold: The minimum percentage deviation from a point before the ZigZag will change direction.
depth: The number of bars required for pivot detection.
lineColor: Line color.
extendLast: Condition allowing a line to connect the most recent pivot with the current close.
displayReversalPrice: Condition to display the pivot price in the pivot label.
displayCumulativeVolume: Condition to display the cumulative volume for the pivot segment in the pivot label.
displayReversalPriceChange: Condition to display the change in price or percent from the previous pivot in the pivot label.
differencePriceMode: Reversal change display mode. Options are "Absolute" or "Percent".
draw: Condition to display lines and labels.
Point
A coordinate containing time and price information.
Fields:
tm: A value in UNIX time.
price: A value on the Y axis (price).
Pivot
A level of significance used to determine directional movement or potential support and resistance.
Fields:
ln: A line object connecting the `start` and `end` Point objects.
lb: A label object to display pivot values.
isHigh: A condition to determine if the pivot is a pivot high.
vol: Volume for the pivot segment.
start: The coordinate of the previous Point.
end: The coordinate of the current Point.
ZigZag
An object to maintain Zig Zag settings, pivots, and volume.
Fields:
settings: Settings object to provide calculation and display attributes.
pivots: An array of Pivot objects.
sumVol: The volume sum for the pivot segment.
extend: Pivot object used to project a line from the last pivot to the last bar.
█ FUNCTIONS
This library contains the following functions:
lastPivot(this)
Returns the last Pivot of `this` ZigZag if there is at least one Pivot to return, and `na` otherwise.
Parameters:
this: (series ZigZag) A ZigZag object.
Returns: (Pivot) The last Pivot in the ZigZag.
update(this)
Updates `this` ZigZag object with new pivots, volume, lines, labels.
Parameters:
this: (series ZigZag) a ZigZag object.
Returns: (bool) true if a new Zig Zag line is found or the last Zig Zag line has changed.
newInstance(settings)
Instantiates a new ZigZag object with `settings`. If no settings are provided, a default ZigZag object is created.
Parameters:
settings: (series Settings) A Settings object.
Returns: (ZigZag) A new ZigZag instance.
This library is a Pine Script™ programmer’s tool containing custom user-defined types and functions to calculate Zig Zag indicators within their scripts. It is not a stand-alone indicator.
Pine Script™ libraries are publications that contain reusable code for importing into Pine Script™ indicators, strategies, and other libraries. For more information on libraries and incorporating them into your scripts, see the Libraries section of the Pine Script™ User Manual.
█ CONCEPTS
Zig Zag
Zig Zag is a popular indicator that filters out minor price fluctuations to denoise data and emphasize trends. Traders commonly use Zig Zag for trend confirmation, identifying potential support and resistance, and pattern detection. It is formed by identifying significant local high and low points in alternating order and connecting them with straight lines, omitting all other data points from their output. There are several ways to calculate the Zig Zag's data points and the conditions by which its direction changes. This script uses pivots as the data points, which are the highest or lowest values over a defined number of bars before and after them. The direction only reverses when a newly formed pivot deviates from the last Zig Zag point in the opposite direction by an amount greater than or equal to a specified percentage.
To learn more about Zig Zag and how to calculate it, see this entry from the Help Center.
█ FOR Pine Script™ CODERS
Notes
This script's architecture utilizes user-defined types (UDTs) to create custom objects which are the equivalent of variables containing multiple parts, each able to hold independent values of different types. UDTs are the newest addition to Pine Script™ and the most advanced feature the language has seen to date. The feature's introduction creates a new runway for experienced coders to push the boundaries of Pine. We recommend that newcomers to the language explore the basics first before diving into UDTs and objects.
Demonstration Code
Our example code shows a simple use case by displaying a Zig Zag with user-defined settings. A new ZigZag object is instantiated on the first bar using a Settings object to control its attributes. The fields for the Settings object are declared using variables assigned to input.* functions, allowing control of the field values from the script's settings. The `update()` function is invoked on each bar to update the ZigZag object's fields and create new lines and labels when required.
Look first. Then leap.
█ TYPES
This library contains the following types:
Settings
Provides calculation and display attributes to ZigZag objects.
Fields:
devThreshold: The minimum percentage deviation from a point before the ZigZag will change direction.
depth: The number of bars required for pivot detection.
lineColor: Line color.
extendLast: Condition allowing a line to connect the most recent pivot with the current close.
displayReversalPrice: Condition to display the pivot price in the pivot label.
displayCumulativeVolume: Condition to display the cumulative volume for the pivot segment in the pivot label.
displayReversalPriceChange: Condition to display the change in price or percent from the previous pivot in the pivot label.
differencePriceMode: Reversal change display mode. Options are "Absolute" or "Percent".
draw: Condition to display lines and labels.
Point
A coordinate containing time and price information.
Fields:
tm: A value in UNIX time.
price: A value on the Y axis (price).
Pivot
A level of significance used to determine directional movement or potential support and resistance.
Fields:
ln: A line object connecting the `start` and `end` Point objects.
lb: A label object to display pivot values.
isHigh: A condition to determine if the pivot is a pivot high.
vol: Volume for the pivot segment.
start: The coordinate of the previous Point.
end: The coordinate of the current Point.
ZigZag
An object to maintain Zig Zag settings, pivots, and volume.
Fields:
settings: Settings object to provide calculation and display attributes.
pivots: An array of Pivot objects.
sumVol: The volume sum for the pivot segment.
extend: Pivot object used to project a line from the last pivot to the last bar.
█ FUNCTIONS
This library contains the following functions:
lastPivot(this)
Returns the last Pivot of `this` ZigZag if there is at least one Pivot to return, and `na` otherwise.
Parameters:
this: (series ZigZag) A ZigZag object.
Returns: (Pivot) The last Pivot in the ZigZag.
update(this)
Updates `this` ZigZag object with new pivots, volume, lines, labels.
Parameters:
this: (series ZigZag) a ZigZag object.
Returns: (bool) true if a new Zig Zag line is found or the last Zig Zag line has changed.
newInstance(settings)
Instantiates a new ZigZag object with `settings`. If no settings are provided, a default ZigZag object is created.
Parameters:
settings: (series Settings) A Settings object.
Returns: (ZigZag) A new ZigZag instance.
Versionshinweise
v2Minor update to function comments.
Versionshinweise
v3A `barIndex` field was added to the `Point` type to allow tracking the bar_index where a pivot occurs:
Point
A coordinate containing bar, price, and time information.
Fields:
tm: A value in UNIX time.
price: A value on the Y axis (price).
barIndex: A `bar_index`.
Versionshinweise
v4This version release comes with the following changes:
• When the Zig Zag depth was less than 2, the Zig Zag calculation would fail. The new logic prevents setting a depth of less than 2.
• The script now has the option to detect pivot highs and pivot lows in a single bar. This option enhances the Zig Zag functionality, enabling it to capture double pivots.
• The library has been modified to utilize user-defined methods. Pine Script™ methods are special functions associated with instances of specific types that offer a simpler, more convenient syntax.
This update includes the following type and methods:
Settings
Provides calculation and display attributes to ZigZag objects.
Fields:
devThreshold: The minimum percentage deviation from a point before the ZigZag will change direction.
depth: The number of bars required for pivot detection.
lineColor: Line color.
extendLast: Condition allowing a line to connect the most recent pivot with the current close.
displayReversalPrice: Condition to display the pivot price in the pivot label.
displayCumulativeVolume: Condition to display the cumulative volume for the pivot segment in the pivot label.
displayReversalPriceChange: Condition to display the change in price or percent from the previous pivot in the pivot label.
differencePriceMode: Reversal change display mode. Options are "Absolute" or "Percent".
draw: Condition to display lines and labels.
allowZigZagOnOneBar: Condition to allow double pivots to occur ie. when a large bar makes both a pivot high and a pivot low.
lastPivot(this)
Returns the last Pivot of `this` ZigZag if there is at least one Pivot to return, and `na` otherwise.
Can be used as a method.
Parameters:
this: (series ZigZag) A ZigZag object.
Returns: (Pivot) The last Pivot in the ZigZag.
update(this)
Updates `this` ZigZag object with new pivots, volume, lines, labels. NOTE: The function must be called on every bar for accurate calculations.
Can be used as a method.
Parameters:
this: (series ZigZag) a ZigZag object.
Returns: (bool) true if a new Zig Zag line is found or the last Zig Zag line has changed.
Versionshinweise
v5Fixed a minor bug that would occasionally cause the Zig Zag to register incorrect pivot points.
Versionshinweise
v6Fixed a minor bug that would occasionally cause the Zig Zag to register incorrect pivot points on symbols with negative prices.
Versionshinweise
v7This version's release includes the following changes:
• We've eliminated the `Point` user-defined type from the library, as it's now unnecessary. The UDTs and functions in this library version utilize Pine's new chart.point built-in type. Additionally, all parts of the code that handle creation and modification of lines and labels now use chart.point objects to determine their coordinates. The transition to utilizing this type does not affect the functional output of the library in any way.
• We've refined the library's code comments, annotations, and variable names for clarity and readability.
Removed:
Point
A coordinate containing bar, price, and time information.
Pine Bibliothek
Ganz im Sinne von TradingView hat dieser Autor seinen/ihren Pine Code als Open-Source-Bibliothek veröffentlicht. Auf diese Weise können nun auch andere Pine-Programmierer aus unserer Community den Code verwenden. Vielen Dank an den Autor! Sie können diese Bibliothek privat oder in anderen Open-Source-Veröffentlichungen verwenden. Die Nutzung dieses Codes in einer Veröffentlichung wird in unseren Hausregeln reguliert.
Share TradingView with a friend:
tradingview.com/share-your-love/
Read more about the new tools and features we're building for you: tradingview.com/blog/en/
tradingview.com/share-your-love/
Read more about the new tools and features we're building for you: tradingview.com/blog/en/
Haftungsausschluss
Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.