PINE LIBRARY
ZigZag
█ 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.
版本注释
v2Minor update to function comments.
版本注释
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`.
版本注释
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.
版本注释
v5Fixed a minor bug that would occasionally cause the Zig Zag to register incorrect pivot points.
版本注释
v6Fixed a minor bug that would occasionally cause the Zig Zag to register incorrect pivot points on symbols with negative prices.
版本注释
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脚本库
本着真正的TradingView精神，作者将此Pine代码发布为开源脚本库，以便我们社区的其他Pine程序员可以重复使用它。向作者致敬！您可以私下或在其它开源出版物中使用此脚本库，但在出版物中重复使用此代码受网站规则约束。
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/
免责声明
这些信息和出版物并不意味着也不构成TradingView提供或认可的金融、投资、交易或其它类型的建议或背书。请在使用条款阅读更多信息。