BOBS

Divides the trailing P/E by the year-over-year EPS growth rate (in percentage points). Below 1.0 is conventionally read as 'cheap relative to growth'; above 2 implies the multiple is well ahead of recent growth. Sensitive to which growth window you choose and unstable when earnings cross zero — flips sign or explodes when prior EPS is negative.

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.

Bottom-line growth on a per-share basis — captures both operating progress and any net buyback effect. The denominator uses the absolute value of prior EPS so a turnaround from negative to positive earnings reads with the conventional sign rather than producing arithmetic nonsense. Pair with revenue growth to separate real franchise expansion from buyback-driven per-share lift.

Top-line growth — the cleanest way to see whether the franchise is expanding. Best read alongside margin trend: revenue rising while margin compresses is often discount-driven volume rather than real growth, and can mask underlying weakness. Compare to industry peers — what looks weak in absolute terms can be best-in-sector if the industry is contracting.

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.

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.

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.

ROC is the simplest momentum oscillator: (close − close_N_ago) / close_N_ago × 100. It's unbounded, sign-bearing, and reads as 'how much price has moved in absolute % terms over the lookback'. A configurable threshold (default 5%) separates ordinary fluctuation from strong directional thrusts. Useful as a coarse momentum cross when you want a less smoothed signal than RSI or MACD.

+1 while ROC is above +threshold (strong bullish thrust); -1 while ROC is below −threshold (strong bearish thrust); 0 inside the ±threshold band.

+1 = ROC above +threshold (bullish thrust), -1 = ROC below −threshold (bearish thrust), 0 = ROC within ±threshold.

TRIX is the one-bar rate of change of a triple-exponentially-smoothed closing price. The triple smoothing strips out short-term noise, so TRIX oscillates slowly around zero. A cross up through zero marks momentum turning positive (bullish); a cross down through zero marks it turning negative (bearish). Smoother and lower-frequency than most momentum oscillators, which trades responsiveness for fewer whipsaws.

+1 while TRIX is above zero; -1 while TRIX is below zero; 0 only at exactly zero.

+1 = TRIX turned positive (bullish momentum), -1 = TRIX turned negative (bearish momentum).

Larry Williams' Ultimate Oscillator blends buying-pressure ratios over three lookbacks (7/14/28) into a single 0-100 reading, designed to reduce the false extremes that plague single-period oscillators. Below 30 is oversold and above 70 overbought. The signal flags time spent in those zones: oversold reads bullish (mean-reversion bounce bias), overbought reads bearish.

+1 while the Ultimate Oscillator 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), -1 = overbought (bearish), 0 = oscillator mid-range.

Reports whether the close sits within the configured proximity (default 1%) of the rolling 252-bar high or low. New-highs and new-lows are universally watched screening filters — momentum and breakout strategies start from here, and the broad market's new-high / new-low spread is a foundational breadth indicator.

+1 while close is within proximity of the 252-bar high; -1 while close is within proximity of the 252-bar low; 0 mid-range.

+1 = near 52-week high, -1 = near 52-week low, 0 = mid-range.

Composite trend system: bullish when the tenkan crosses above the kijun, price is above the cloud (Kumo), and the close is above its level from 26 bars ago (Chikou-style momentum confirmation).

+1 on bullish trigger conditions, -1 on bearish, 0 otherwise.

+1 = full Ichimoku bullish setup, -1 = full bearish setup.

Computes the period-bar log-return spread (ticker minus SPY) and ranks the spread against its trailing 252-bar quantile. SPY = SPDR S&P 500 ETF Trust ('SPDR' = Standard & Poor's Depositary Receipts), the standard proxy for the US large-cap market. Ranking against the trailing window means the same threshold works in both gentle bull markets and high-volatility regimes — the metric is calibrated against the ticker's own history, not a fixed cutoff.

+1 while the ticker-vs-SPY spread ranks at or above the high_pct percentile (default 0.8 — the top 20%) of its trailing window; -1 while at or below low_pct (default 0.2 — the bottom 20%); 0 otherwise.

+1 = clear outperformance regime, -1 = clear underperformance regime.

Aroon measures how recently the highest-high and lowest-low occurred inside the lookback (default 25 bars) and reports the difference as a single -100 to +100 oscillator. Positive values mean the most recent high is fresher than the most recent low (uptrend); negative values mean the opposite. Crosses through ±50 are commonly used as trend-onset / trend-loss alerts. Less reactive to whipsaws than price-only momentum oscillators.

+1 while the oscillator is above high_threshold (default +50), -1 while it is below low_threshold (default -50), 0 in between.