mirror of
https://github.com/mihakralj/QuanTAlib.git
synced 2026-08-24 21:48:03 +00:00
86fe32a682
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: aider (openrouter/anthropic/claude-sonnet-4) <aider@aider.chat> Co-authored-by: Warp <agent@warp.dev>
102 lines
4.7 KiB
Markdown
102 lines
4.7 KiB
Markdown
# PCHANNEL: Price Channel
|
||
|
||
## Overview and Purpose
|
||
|
||
The Price Channel is a simple volatility-based indicator that plots the highest high and the lowest low over a user-defined lookback period. It is very similar in concept and application to Donchian Channels. The channel visually represents the trading range of an asset over the specified period.
|
||
|
||
A middle line, typically the average of the upper and lower channel lines, can also be plotted to serve as a mean reference.
|
||
|
||
## Core Concepts
|
||
|
||
* **Highest High:** The upper band represents the highest price reached during the lookback period.
|
||
* **Lowest Low:** The lower band represents the lowest price reached during thelookback period.
|
||
* **Trading Range:** The channel effectively shows the price extremes for the chosen period.
|
||
* **Breakout Indication:** Prices moving above the upper channel or below the lower channel can signal potential breakouts and the start of new trends.
|
||
|
||
## Common Settings and Parameters
|
||
|
||
| Parameter | Default | Function | When to Adjust |
|
||
| :-------- | :------ | :------- | :------------- |
|
||
| Length | 20 | Lookback period for determining the highest high and lowest low. | Shorter lengths make the channel more reactive to recent price action; longer lengths create a wider, smoother channel representing longer-term ranges. |
|
||
|
||
## Calculation and Mathematical Foundation
|
||
|
||
**Simplified explanation:**
|
||
1. For each bar, look back over the specified `Length`.
|
||
2. Identify the absolute highest `high` price during that period. This forms the Upper Channel line.
|
||
3. Identify the absolute lowest `low` price during that period. This forms the Lower Channel line.
|
||
4. (Optional) The Middle Channel line is the average of the Upper and Lower Channel lines: `(Upper Channel + Lower Channel) / 2`.
|
||
|
||
**Technical formula:**
|
||
1. **Upper Channel:**
|
||
`UpperChannel = Highest(High, Length)`
|
||
|
||
2. **Lower Channel:**
|
||
`LowerChannel = Lowest(Low, Length)`
|
||
|
||
3. **Middle Channel (optional):**
|
||
`MiddleChannel = (UpperChannel + LowerChannel) / 2`
|
||
|
||
## Performance Profile
|
||
|
||
### Operation Count (Streaming Mode, Scalar)
|
||
|
||
Per-bar cost using monotonic deque optimization:
|
||
|
||
| Operation | Count | Cost (cycles) | Subtotal |
|
||
| :--- | :---: | :---: | :---: |
|
||
| CMP | 4 | 1 | 4 |
|
||
| ADD | 1 | 1 | 1 |
|
||
| MUL | 1 | 3 | 3 |
|
||
| **Total** | **6** | | **~8 cycles** |
|
||
|
||
**Complexity**: O(1) amortized per bar monotonic deque maintains max/min efficiently.
|
||
|
||
### Batch Mode (SIMD/FMA Analysis)
|
||
|
||
Finding max/min over sliding windows has limited SIMD benefit:
|
||
|
||
| Operation | Scalar Ops | SIMD Benefit | Notes |
|
||
| :--- | :---: | :---: | :--- |
|
||
| Max/Min update | 4 | 1× | Deque-based, sequential |
|
||
| Middle band | 2 | 2× | ADD + MUL parallelizable |
|
||
|
||
**Batch efficiency (512 bars):**
|
||
|
||
| Mode | Cycles/bar | Total (512 bars) | Improvement |
|
||
| :--- | :---: | :---: | :---: |
|
||
| Scalar streaming | 8 | 4,096 | |
|
||
| Partial SIMD | ~7 | ~3,584 | **~12%** |
|
||
|
||
### Quality Metrics
|
||
|
||
| Metric | Score | Notes |
|
||
| :--- | :---: | :--- |
|
||
| **Accuracy** | 10/10 | Exact max/min calculation |
|
||
| **Timeliness** | 6/10 | Tracks past extremes, inherently lagging |
|
||
| **Overshoot** | 10/10 | No overshootbands are actual price levels |
|
||
| **Smoothness** | 5/10 | Bands move in discrete steps |
|
||
|
||
## Interpretation Details
|
||
|
||
* **Support and Resistance:** The upper band can act as resistance, and the lower band as support.
|
||
* **Breakouts:**
|
||
* A close above the Upper Channel suggests bullish strength and a potential upside breakout.
|
||
* A close below the Lower Channel suggests bearish pressure and a potential downside breakout.
|
||
* **Trend Identification:**
|
||
* In an uptrend, prices may consistently touch or "ride" the Upper Channel.
|
||
* In a downtrend, prices may consistently touch or "ride" the Lower Channel.
|
||
* **Volatility:** The width of the channel can give an indication of volatility. Wider channels suggest higher volatility over the lookback period.
|
||
* **"Turtle Trading" Strategy:** Price Channels (like Donchian Channels) were famously used in the "Turtle Trading" system, where breakouts from the channel were used as entry signals.
|
||
|
||
## Limitations and Considerations
|
||
|
||
* **Lag:** Like all indicators based on lookback periods, there's an inherent lag. The channel reflects past price action.
|
||
* **Whipsaws:** In choppy, non-trending markets, breakouts can be false, leading to whipsaws.
|
||
* **Parameter Choice:** The `Length` parameter is crucial. A length too short may generate many false signals, while one too long may miss timely entries.
|
||
* **Not a Standalone System:** Best used in conjunction with other indicators (e.g., volume, trend indicators) or price action analysis for confirmation.
|
||
|
||
## References
|
||
|
||
* Donchian, R. D. (Various). (Conceptual basis for channel breakouts).
|
||
* Faith, C. (2007). *Way of the Turtle*. McGraw-Hill. (Describes trading systems using similar channels). |