using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
namespace QuanTAlib;
///
/// MADH: Ehlers Moving Average Difference with Hann
///
///
/// A zero-crossing trend oscillator that computes the percentage difference
/// between a short and long Hann-windowed FIR moving average.
///
/// Calculation:
/// LongLength = IntPortion(ShortLength + DominantCycle / 2)
/// Filt1 = HannFIR(Close, ShortLength)
/// Filt2 = HannFIR(Close, LongLength)
/// MADH = 100 × (Filt1 / Filt2 - 1)
///
/// Hann coefficients: w(k) = 1 - cos(2π·k / (N + 1))
///
/// Detailed documentation
/// Reference Pine Script implementation
[SkipLocalsInit]
public sealed class Madh : AbstractBase
{
[StructLayout(LayoutKind.Auto)]
private record struct State(int Count, double LastValid)
{
public static State New() => new() { Count = 0, LastValid = 0 };
}
private readonly int _shortLength;
private readonly int _longLength;
private readonly double[] _shortCoeffs;
private readonly double[] _longCoeffs;
private State _s = State.New();
private State _ps = State.New();
// RingBuffer stores close prices — needs longLength+1 slots
private readonly RingBuffer _closeBuf;
private const double Epsilon = 1e-10;
///
/// Creates MADH with specified parameters.
///
/// Short Hann FIR window length (must be ≥ 1)
/// Dominant cycle period (must be ≥ 2)
public Madh(int shortLength = 8, int dominantCycle = 27)
{
if (shortLength < 1)
{
throw new ArgumentOutOfRangeException(nameof(shortLength), shortLength, "ShortLength must be at least 1.");
}
if (dominantCycle < 2)
{
throw new ArgumentOutOfRangeException(nameof(dominantCycle), dominantCycle, "DominantCycle must be at least 2.");
}
_shortLength = shortLength;
_longLength = shortLength + dominantCycle / 2;
// Precompute short Hann coefficients: w(k) = 1 - cos(2π·k / (N+1))
_shortCoeffs = new double[_shortLength];
double shortAngleStep = 2.0 * Math.PI / (_shortLength + 1);
for (int k = 1; k <= _shortLength; k++)
{
_shortCoeffs[k - 1] = 1.0 - Math.Cos(shortAngleStep * k);
}
// Precompute long Hann coefficients
_longCoeffs = new double[_longLength];
double longAngleStep = 2.0 * Math.PI / (_longLength + 1);
for (int k = 1; k <= _longLength; k++)
{
_longCoeffs[k - 1] = 1.0 - Math.Cos(longAngleStep * k);
}
_closeBuf = new RingBuffer(_longLength);
Name = $"Madh({shortLength},{dominantCycle})";
WarmupPeriod = _longLength;
}
///
/// Creates MADH with specified source and parameters.
/// Subscribes to source.Pub event.
///
public Madh(ITValuePublisher source, int shortLength = 8, int dominantCycle = 27) : this(shortLength, dominantCycle)
{
source.Pub += Handle;
}
///
/// Creates MADH with a TSeries source, primes from history, then subscribes.
///
public Madh(TSeries source, int shortLength = 8, int dominantCycle = 27) : this(shortLength, dominantCycle)
{
Prime(source.Values);
if (source.Count > 0)
{
Last = new TValue(source.LastTime, Last.Value);
}
source.Pub += Handle;
}
public override bool IsHot => _s.Count >= _longLength;
public override void Prime(ReadOnlySpan source, TimeSpan? step = null)
{
if (source.Length == 0)
{
return;
}
_s = State.New();
_ps = State.New();
_closeBuf.Clear();
int len = source.Length;
for (int i = 0; i < len; i++)
{
double val = source[i];
if (double.IsFinite(val))
{
_s.LastValid = val;
}
else
{
val = _s.LastValid;
}
Step(val);
}
Last = new TValue(DateTime.MinValue, ComputeResult());
_ps = _s;
_closeBuf.Snapshot();
}
[MethodImpl(MethodImplOptions.AggressiveInlining)]
private void Handle(object? sender, in TValueEventArgs e) => Update(e.Value, e.IsNew);
[MethodImpl(MethodImplOptions.AggressiveInlining)]
private static double GetValidValue(double input, ref State s)
{
if (double.IsFinite(input))
{
s.LastValid = input;
return input;
}
return s.LastValid;
}
[MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
public override TValue Update(TValue input, bool isNew = true)
{
if (isNew)
{
_ps = _s;
_closeBuf.Snapshot();
}
else
{
_s = _ps;
_closeBuf.Restore();
}
double val = GetValidValue(input.Value, ref _s);
Step(val);
double result = ComputeResult();
Last = new TValue(input.Time, result);
PubEvent(Last, isNew);
return Last;
}
[MethodImpl(MethodImplOptions.AggressiveOptimization)]
public override TSeries Update(TSeries source)
{
if (source.Count == 0)
{
return [];
}
int len = source.Count;
var t = new List(len);
var v = new List(len);
CollectionsMarshal.SetCount(t, len);
CollectionsMarshal.SetCount(v, len);
var tSpan = CollectionsMarshal.AsSpan(t);
var vSpan = CollectionsMarshal.AsSpan(v);
source.Times.CopyTo(tSpan);
Reset();
for (int i = 0; i < len; i++)
{
double val = source.Values[i];
if (double.IsFinite(val))
{
_s.LastValid = val;
}
else
{
val = _s.LastValid;
}
Step(val);
vSpan[i] = ComputeResult();
}
_ps = _s;
_closeBuf.Snapshot();
Last = new TValue(tSpan[len - 1], vSpan[len - 1]);
return new TSeries(t, v);
}
///
/// Core streaming step: add close price to ring buffer.
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
private void Step(double input)
{
_s.Count++;
_closeBuf.Add(input);
}
///
/// Computes MADH from the close buffer using dual Hann-weighted FIR averages.
///
[MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
private double ComputeResult()
{
int available = Math.Min(_s.Count, _longLength);
if (available < 1)
{
return 0.0;
}
// Short Hann FIR
double filt1 = 0.0;
double coef1 = 0.0;
int shortAvail = Math.Min(available, _shortLength);
for (int k = 1; k <= shortAvail; k++)
{
double w = _shortCoeffs[k - 1];
filt1 = Math.FusedMultiplyAdd(w, _closeBuf[available - k], filt1);
coef1 += w;
}
if (coef1 > Epsilon)
{
filt1 /= coef1;
}
// Long Hann FIR
double filt2 = 0.0;
double coef2 = 0.0;
for (int k = 1; k <= available; k++)
{
double w = _longCoeffs[k - 1];
filt2 = Math.FusedMultiplyAdd(w, _closeBuf[available - k], filt2);
coef2 += w;
}
if (coef2 > Epsilon)
{
filt2 /= coef2;
}
// MADH = 100 * (Filt1 / Filt2 - 1)
return Math.Abs(filt2) > Epsilon ? 100.0 * (filt1 / filt2 - 1.0) : 0.0;
}
///
/// Batch calculation returning a TSeries.
///
public static TSeries Batch(TSeries source, int shortLength = 8, int dominantCycle = 27)
{
var indicator = new Madh(shortLength, dominantCycle);
return indicator.Update(source);
}
///
/// Batch calculation writing to a pre-allocated output span. Zero-allocation hot path.
///
public static void Batch(ReadOnlySpan source, Span output, int shortLength = 8, int dominantCycle = 27)
{
if (source.Length != output.Length)
{
throw new ArgumentException("Source and output must have the same length", nameof(output));
}
if (shortLength < 1)
{
throw new ArgumentOutOfRangeException(nameof(shortLength), shortLength, "ShortLength must be at least 1.");
}
if (dominantCycle < 2)
{
throw new ArgumentOutOfRangeException(nameof(dominantCycle), dominantCycle, "DominantCycle must be at least 2.");
}
if (source.Length == 0)
{
return;
}
var indicator = new Madh(shortLength, dominantCycle);
for (int i = 0; i < source.Length; i++)
{
double val = source[i];
if (double.IsFinite(val))
{
indicator._s.LastValid = val;
}
else
{
val = indicator._s.LastValid;
}
indicator.Step(val);
output[i] = indicator.ComputeResult();
}
}
///
/// Creates a hot indicator from historical data, ready for streaming.
///
public static (TSeries Results, Madh Indicator) Calculate(TSeries source, int shortLength = 8, int dominantCycle = 27)
{
var indicator = new Madh(shortLength, dominantCycle);
TSeries results = indicator.Update(source);
return (results, indicator);
}
public override void Reset()
{
_s = State.New();
_ps = _s;
_closeBuf.Clear();
Last = default;
}
}