DOCN

Peter Lynch's adjustment to PEG: adds the dividend yield to the growth rate in the denominator so that mature dividend payers don't get unfairly punished by a low growth rate alone. Sweet spot is 1.0 (P/E equals growth plus yield); below 0.5 often signals a broken growth assumption rather than genuine value; above 2 is over-paying.

The headline profitability metric. Net income divided by average book equity tells you how productive each dollar of shareholders' capital is. High sustained ROE compounds book value when the business can reinvest at a similar return. Two warnings: ROE rises mechanically with leverage (high D/E inflates ROE without making the business better), and aggressive buybacks can shrink the equity denominator faster than they shrink earnings, artificially boosting ROE even as fundamental returns are flat.

The single best operations-quality metric. Negative CCC means the firm is funded by suppliers — the customer pays before the supplier needs to be paid (Apple, Costco, Amazon at scale). Long CCC ties up working capital and forces operating-loan dependence. Combines three sub-metrics: days inventory outstanding, days sales outstanding, days payable outstanding.

DuPont productivity measure. Combined with margin, it tells the asset-light vs. asset-heavy story: low turnover with high margin is the luxury / branded model, high turnover with thin margin is the supermarket / discount model. Very high turnover in retail can also flag stockouts (lost sales) — the metric reads best industry-relative, not absolute.

Direct cash income from holding the share. Stable dividend yield over time often signals capital discipline and predictable cash generation; abnormally high yield is frequently a warning that the dividend isn't covered by free cash flow and may be cut. Always read alongside payout ratio and FCF coverage.

Sustainability check on the dividend yield. Below 30% means the dividend has substantial room to grow; 30–60% is the conventional sweet spot for a mature payer; above 85% is stretched and frequently precedes a cut. REITs and utilities run higher than the broad market by design — REIT payouts above 80% are normal because the structure requires distributing most income.

Captures the full cash return to shareholders — dividends plus share repurchases, expressed as a percentage of market cap. Buyback-heavy issuers (Apple, Alphabet) hide their real cash return behind a low headline dividend yield; total shareholder yield surfaces it. Increasingly the right lens for evaluating capital-return quality, especially for tech-era large-caps that prefer buybacks to dividends.

CCI measures how far the current typical price ((H+L+C)/3) sits from its rolling SMA, normalized by the mean absolute deviation. Originally built for commodity cycles by Donald Lambert; widely used as a generic momentum / overbought-oversold gauge on any asset. CCI is unbounded but ±100 is the conventional 'normal range' edge — readings beyond that are interpreted as strong directional thrusts or stretched extremes depending on context.

+1 while CCI is below -100 (oversold); -1 while CCI is above +100 (overbought); 0 inside the ±100 band.

+1 = oversold (stretched below the typical-price mean, mean-reversion buy bias), -1 = overbought (stretched above), 0 = inside the ±100 band.

Designed to buy oversold pullbacks within an established uptrend (price above the regime moving average). Uses a 2-period RSI rather than the standard 14 to make it hyper-responsive to short-term swings. The default exit_method is RSI-threshold based: hold while RSI(2) is below the configured exit threshold and exit when RSI(2) crosses above exit. The book-style SMA exit is also supported by setting exit_method=sma with exit_ma.

+1 when price is above regime_ma and RSI(2) drops below oversold; held while inside the trade; back to 0 when the configured exit_method fires.

+1 = pullback-buy state active, -1 = pullback-short state active (symmetric rule in a down regime), 0 = flat.

The Coppock Curve is a weighted moving average of the sum of two rate-of-change measures, originally designed as a long-horizon, buy-only bottom indicator for equity indices. This screener applies it to daily bars and adds a bearish state for symmetry: a cross up through zero is the classic long-term buy tell, a cross down through zero flags a bearish momentum cycle.

+1 while the Coppock Curve is above zero; -1 while it is below zero; 0 only at exactly zero.

+1 = bullish zero-line cross (classic long-term buy), -1 = bearish zero-line cross.

Compares price pivots against the MACD histogram (MACD line minus signal line) at those same bars. Bullish divergence: price makes a lower low, histogram makes a higher low — momentum is improving beneath the surface. Bearish divergence: price makes a higher high, histogram makes a lower high. Slower than the MACD signal cross but a richer confirmatory tell — the histogram captures momentum acceleration, not just direction.

+1 at the right-hand pivot of bullish divergence; -1 at right-hand pivot of bearish divergence; 0 otherwise.

+1 = bullish divergence, -1 = bearish divergence.

Fires on the bar where the MACD line (EMA12 minus EMA26) crosses through the signal line (EMA9 of MACD). Bullish when MACD crosses up through signal, bearish when it crosses down. Far more commonly used as a trade trigger than divergence — see macd_divergence for the slower confirmatory tell. Whipsaws in chop; cleanest when combined with a trend-regime filter.

+1 on bullish cross (MACD crosses up through signal); -1 on bearish cross (MACD crosses down through signal); 0 otherwise.

+1 = bullish MACD-signal cross, -1 = bearish MACD-signal cross.

MFI is essentially RSI computed on (typical price × volume) instead of close alone, so high-volume bars push the oscillator harder than low-volume bars. It's 0-100 bounded and uses the same 20/80 OB-OS convention as a slower RSI. Because it folds in volume, MFI can flag distribution / accumulation underneath a flat price tape that RSI would miss.

+1 while MFI is below 20 (oversold); -1 while MFI is above 80 (overbought); 0 in between.

+1 = oversold (bullish, volume-weighted), -1 = overbought (bearish), 0 = mid-range.

When price prints a lower low while RSI prints a higher low at those same pivot bars, momentum is improving even though price is still falling — a classic bullish divergence that often precedes a reversal up. The bearish mirror fires when price makes a higher high but RSI prints a lower high, telegraphing exhausted upside. Divergences are confirmation tells rather than precise timing signals — best used as a 'something is changing under the surface' alert, not a trade trigger on their own.

+1 at the right-hand pivot of a (lower-low price, higher-low RSI) pair; -1 at the right-hand pivot of a (higher-high price, lower-high RSI) pair; 0 otherwise.

+1 = bullish divergence, -1 = bearish divergence, 0 = no divergence at this bar.

The 14-period Relative Strength Index is the canonical Wilder momentum oscillator, bounded 0-100. Readings below 30 mark oversold conditions and above 70 mark overbought. This signal flags time spent at those extremes: bullish while RSI is at or below 30 (a mean-reversion bounce bias), bearish while it is at or above 70. The 30/70 thresholds are standard practice layered on top of the TA-Lib primitive.

+1 while RSI(14) is at or below the oversold threshold (default 30); -1 while it is at or above the overbought threshold (default 70); 0 in between.

+1 = oversold (bullish mean-reversion bias), -1 = overbought (bearish), 0 = RSI in its mid-range.