Struct Mama 

pub struct Mama { /* private fields */ }

Ehlers’ MESA Adaptive Moving Average (MAMA).

MAMA adapts its smoothing constant from the rate-of-change of price phase, derived via a truncated Hilbert transform — full math in “Cycle Analytics for Traders” (Ehlers 2013, ch. 8) and the original 2001 MESA paper.

The two-parameter (fast_limit, slow_limit) is the range over which the adaptive alpha can vary; defaults (0.5, 0.05) match the canonical EasyLanguage implementation. The companion FAMA is `mama * 0.5 * fast_limit

• fama_prev * (1 - 0.5 * fast_limit)`, lagging MAMA so crossovers signal trend reversals.

The indicator emits both lines as a MamaOutput. Use the crate::Fama wrapper in this module to expose just the slow line if needed (e.g. for chaining).

Example

use wickra_core::{Indicator, Mama};

let mut mama = Mama::new(0.5, 0.05).unwrap();
let mut last = None;
for i in 0..100 {
    last = mama.update(100.0 + (f64::from(i) * 0.2).sin() * 5.0);
}
assert!(last.is_some());

Implementations

impl Mama

pub fn new(fast_limit: f64, slow_limit: f64) -> Result<Self>

Construct with custom (fast_limit, slow_limit) adaptive alpha bounds.

Errors

Returns Error::InvalidPeriod if either limit is outside (0, 1] or if slow_limit > fast_limit.

pub fn classic() -> Self

Default (0.5, 0.05) parameters from Ehlers’ original publication.

pub const fn limits(&self) -> (f64, f64)

Configured (fast_limit, slow_limit).

pub const fn value(&self) -> Option<MamaOutput>

Current (mama, fama) pair if available.

Trait Implementations

impl Clone for Mama

fn clone(&self) -> Mama

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Mama

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Indicator for Mama

type Input = f64

Type of one input data point (typically f64 for a price, or Candle / Tick).

type Output = MamaOutput

Type of one output value.

fn update(&mut self, input: f64) -> Option<MamaOutput>

Feed one new data point into the indicator and return the freshly computed output, or None if the indicator is still warming up.

fn reset(&mut self)

Reset all internal state, leaving the indicator equivalent to a freshly constructed instance with the same parameters.

fn warmup_period(&self) -> usize

Number of inputs required before the first non-None output can be produced.

fn is_ready(&self) -> bool

Whether the indicator has emitted at least one value since the last reset.

fn name(&self) -> &'static str

Stable, human-readable indicator name. Used by chaining and diagnostics.