Merge branch 'dev'

lib/trends_FIR/nlma/Nlma.md

@@ -14,9 +14,7 @@
 | **Signature**    | [nlma_signature](nlma_signature.md) |
 
 - NLMA uses a two-phase damped cosine kernel with $5P - 1$ taps (where $P$ is the user period).
-- Parameterized by `period` (default 14).
-- Output range: Tracks input.
-- Requires 1 bar of warmup before first valid output (IsHot = true).
+- **Similar:** [ALMA](../alma/alma.md), [GWMA](../gwma/gwma.md) | **Complementary:** ATR for volatility | **Trading note:** Non-Linear MA; adapts weight profile to price behavior.
 - Validated against TA-Lib, Skender, and Tulip reference implementations where available.
 
 NLMA uses a two-phase damped cosine kernel with $5P - 1$ taps (where $P$ is the user period). Phase 1 builds the initial sweep; Phase 2 extends it through multiple cosine cycles. The kernel's negative weights in the mid-section subtract lagged price components, reducing group delay well below what a positive-only SMA of the same length achieves. Normalization by the signed weight sum preserves DC gain of 1.0. The result is a trend-following filter with moderate overshoot but substantially less lag than conventional moving averages.
@@ -180,4 +178,4 @@ For period = 14, the 69-weight array (552 bytes) fits in L1 cache. AVX2 batch th
 
 - Igorad / TrendLaboratory. "NonLagMA" original MQL4 source code. The canonical reference for the two-phase kernel formula.
 - Finware Ltd. "FATL/SATL Digital Filters." Technical documentation for FinWare trading software. Inspiration for the negative-weight lag cancellation approach.
-- Ehlers, J.F. (2001). *Rocket Science for Traders*. Wiley. Chapter 4: FIR Filters with Negative Weights.
+- Ehlers, J.F. (2001). *Rocket Science for Traders*. Wiley. Chapter 4: FIR Filters with Negative Weights.