Files
QuanTAlib/lib/cycles/sine/Sine.Quantower.Tests.cs
T
Miha Kralj 95838a6435 Add SSF-DSP implementation with validation tests and documentation
- Implemented the SSF-DSP (Super Smooth Filter Detrended Synthetic Price) indicator using dual Super Smooth Filters.
- Added validation tests to ensure correctness against PineScript implementation and mathematical properties.
- Created comprehensive documentation outlining the architecture, mathematical foundation, performance profile, and common pitfalls.
- Included batch processing capabilities for efficient calculations on time series data.
2026-02-04 20:58:05 -08:00

385 lines
13 KiB
C#

using TradingPlatform.BusinessLayer;
namespace QuanTAlib.Quantower.Tests;
public class SineIndicatorTests
{
[Fact]
public void SineIndicator_Constructor_SetsDefaults()
{
var indicator = new SineIndicator();
Assert.Equal(40, indicator.HpPeriod);
Assert.Equal(10, indicator.SsfPeriod);
Assert.Equal(SourceType.Close, indicator.Source);
Assert.True(indicator.ShowColdValues);
Assert.Equal("SINE - Ehlers Sine Wave", indicator.Name);
Assert.True(indicator.SeparateWindow);
Assert.True(indicator.OnBackGround);
}
[Fact]
public void SineIndicator_MinHistoryDepths_EqualsZero()
{
var indicator = new SineIndicator();
Assert.Equal(0, SineIndicator.MinHistoryDepths);
Assert.Equal(0, ((IWatchlistIndicator)indicator).MinHistoryDepths);
}
[Fact]
public void SineIndicator_ShortName_IncludesParameters()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
Assert.True(indicator.ShortName.Contains("SINE", StringComparison.Ordinal));
Assert.True(indicator.ShortName.Contains("20", StringComparison.Ordinal));
Assert.True(indicator.ShortName.Contains("5", StringComparison.Ordinal));
}
[Fact]
public void SineIndicator_Initialize_CreatesInternalSine()
{
var indicator = new SineIndicator { HpPeriod = 40, SsfPeriod = 10 };
// Initialize should not throw
indicator.Initialize();
// After init, line series should exist (SINE + Zero + Upper + Lower lines)
Assert.Equal(4, indicator.LinesSeries.Count);
}
[Fact]
public void SineIndicator_ProcessUpdate_HistoricalBar_ComputesValue()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
// Add historical data
var now = DateTime.UtcNow;
indicator.HistoricalData.AddBar(now, 100, 105, 95, 102);
// Process update
var args = new UpdateArgs(UpdateReason.HistoricalBar);
indicator.ProcessUpdate(args);
// Line series should have a value
Assert.Equal(1, indicator.LinesSeries[0].Count);
Assert.True(double.IsFinite(indicator.LinesSeries[0].GetValue(0)));
}
[Fact]
public void SineIndicator_ProcessUpdate_NewBar_ComputesValue()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
var now = DateTime.UtcNow;
indicator.HistoricalData.AddBar(now, 100, 105, 95, 102);
indicator.HistoricalData.AddBar(now.AddMinutes(1), 102, 108, 100, 106);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.NewBar));
Assert.Equal(2, indicator.LinesSeries[0].Count);
}
[Fact]
public void SineIndicator_ProcessUpdate_NewTick_ProcessesWithoutError()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
// Should not throw an exception
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.NewTick));
// Assert that the indicator still exists (method completed without exception)
Assert.NotNull(indicator);
}
[Fact]
public void SineIndicator_MultipleUpdates_ProducesCorrectSequence()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
var now = DateTime.UtcNow;
double[] closes = { 100, 102, 105, 103, 107, 110, 108, 112, 115, 113 };
foreach (var close in closes)
{
indicator.HistoricalData.AddBar(now, close, close + 2, close - 2, close);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
now = now.AddMinutes(1);
}
// All values should be finite
for (int i = 0; i < closes.Length; i++)
{
Assert.True(double.IsFinite(indicator.LinesSeries[0].GetValue(closes.Length - 1 - i)));
}
}
[Fact]
public void SineIndicator_DifferentSourceTypes_Work()
{
var sources = new[] { SourceType.Open, SourceType.High, SourceType.Low, SourceType.Close, SourceType.HL2, SourceType.HLC3 };
foreach (var source in sources)
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5, Source = source };
indicator.Initialize();
var now = DateTime.UtcNow;
indicator.HistoricalData.AddBar(now, 100, 110, 90, 105);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
Assert.True(double.IsFinite(indicator.LinesSeries[0].GetValue(0)),
$"Source {source} should produce finite value");
}
}
[Fact]
public void SineIndicator_HpPeriod_CanBeChanged()
{
var indicator = new SineIndicator { HpPeriod = 40 };
Assert.Equal(40, indicator.HpPeriod);
indicator.HpPeriod = 20;
Assert.Equal(20, indicator.HpPeriod);
}
[Fact]
public void SineIndicator_SsfPeriod_CanBeChanged()
{
var indicator = new SineIndicator { SsfPeriod = 10 };
Assert.Equal(10, indicator.SsfPeriod);
indicator.SsfPeriod = 5;
Assert.Equal(5, indicator.SsfPeriod);
}
[Fact]
public void SineIndicator_Source_CanBeChanged()
{
var indicator = new SineIndicator { Source = SourceType.Close };
Assert.Equal(SourceType.Close, indicator.Source);
indicator.Source = SourceType.Open;
Assert.Equal(SourceType.Open, indicator.Source);
}
[Fact]
public void SineIndicator_ShowColdValues_CanBeChanged()
{
var indicator = new SineIndicator { ShowColdValues = true };
Assert.True(indicator.ShowColdValues);
indicator.ShowColdValues = false;
Assert.False(indicator.ShowColdValues);
}
[Fact]
public void SineIndicator_ShortName_UpdatesWhenParametersChange()
{
var indicator = new SineIndicator { HpPeriod = 40, SsfPeriod = 10 };
string initialName = indicator.ShortName;
Assert.True(initialName.Contains("40", StringComparison.Ordinal));
Assert.True(initialName.Contains("10", StringComparison.Ordinal));
indicator.HpPeriod = 20;
indicator.SsfPeriod = 5;
string updatedName = indicator.ShortName;
Assert.True(updatedName.Contains("20", StringComparison.Ordinal));
Assert.True(updatedName.Contains("5", StringComparison.Ordinal));
}
[Fact]
public void SineIndicator_ProcessUpdate_IgnoresNonBarUpdates()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
var now = DateTime.UtcNow;
indicator.HistoricalData.AddBar(now, 100, 105, 95, 102);
// Process historical bar first
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
// Process other update reasons - should not throw
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.NewTick));
// Assert that the indicator still exists (method completed without exception)
Assert.NotNull(indicator);
}
[Fact]
public void SineIndicator_LineSeries_HasCorrectProperties()
{
var indicator = new SineIndicator { HpPeriod = 40, SsfPeriod = 10 };
indicator.Initialize();
var lineSeries = indicator.LinesSeries[0];
Assert.Equal("SINE", lineSeries.Name);
Assert.Equal(2, lineSeries.Width);
Assert.Equal(LineStyle.Solid, lineSeries.Style);
}
[Fact]
public void SineIndicator_ZeroLine_HasCorrectProperties()
{
var indicator = new SineIndicator { HpPeriod = 40, SsfPeriod = 10 };
indicator.Initialize();
var zeroLine = indicator.LinesSeries[1];
Assert.Equal("Zero", zeroLine.Name);
Assert.Equal(1, zeroLine.Width);
Assert.Equal(LineStyle.Dash, zeroLine.Style);
}
[Fact]
public void SineIndicator_BoundaryLines_HasCorrectProperties()
{
var indicator = new SineIndicator { HpPeriod = 40, SsfPeriod = 10 };
indicator.Initialize();
var upperLine = indicator.LinesSeries[2];
var lowerLine = indicator.LinesSeries[3];
Assert.Equal("+1", upperLine.Name);
Assert.Equal("-1", lowerLine.Name);
Assert.Equal(LineStyle.Dot, upperLine.Style);
Assert.Equal(LineStyle.Dot, lowerLine.Style);
}
[Fact]
public void SineIndicator_DifferentParameters_Work()
{
var paramSets = new[] { (10, 3), (20, 5), (40, 10), (80, 20) };
foreach (var (hpPeriod, ssfPeriod) in paramSets)
{
var indicator = new SineIndicator { HpPeriod = hpPeriod, SsfPeriod = ssfPeriod };
indicator.Initialize();
var now = DateTime.UtcNow;
// Add enough bars to fill the buffer
for (int i = 0; i < hpPeriod + 10; i++)
{
double close = 100 + (i % 10);
indicator.HistoricalData.AddBar(now.AddMinutes(i), close, close + 2, close - 2, close);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
}
// Last value should be finite
double sineValue = indicator.LinesSeries[0].GetValue(0);
Assert.True(double.IsFinite(sineValue), $"HP {hpPeriod}, SSF {ssfPeriod} should produce finite value");
}
}
[Fact]
public void SineIndicator_ConstantPrice_ProducesBoundedOutput()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
var now = DateTime.UtcNow;
// Add constant price bars
for (int i = 0; i < 500; i++)
{
indicator.HistoricalData.AddBar(now.AddMinutes(i), 100, 100, 100, 100);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
}
// Output is normalized to [-1, +1]
double sineValue = indicator.LinesSeries[0].GetValue(0);
Assert.True(sineValue >= -1.0 && sineValue <= 1.0,
$"SINE value {sineValue} should be in [-1, +1]");
}
[Fact]
public void SineIndicator_OutputBounded_BetweenNegativeOneAndOne()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
var now = DateTime.UtcNow;
// Add varying price bars
for (int i = 0; i < 100; i++)
{
double price = 100 + 20 * Math.Sin(i * 0.2);
indicator.HistoricalData.AddBar(now.AddMinutes(i), price, price + 2, price - 2, price);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
double sineValue = indicator.LinesSeries[0].GetValue(0);
Assert.True(sineValue >= -1.0 && sineValue <= 1.0,
$"SINE value {sineValue} should be in [-1, +1]");
}
}
[Fact]
public void SineIndicator_OscillatesAroundZero_ForSineWave()
{
var indicator = new SineIndicator { HpPeriod = 40, SsfPeriod = 10 };
indicator.Initialize();
var now = DateTime.UtcNow;
var values = new List<double>();
// Generate sine wave price pattern
for (int i = 0; i < 200; i++)
{
double price = 100.0 + 10.0 * Math.Sin(i * 0.1);
indicator.HistoricalData.AddBar(now.AddMinutes(i), price, price + 1, price - 1, price);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
values.Add(indicator.LinesSeries[0].GetValue(0));
}
// Should have both positive and negative values
int positiveCount = values.Count(v => v > 0);
int negativeCount = values.Count(v => v < 0);
Assert.True(positiveCount > 0, "Should have positive SINE values");
Assert.True(negativeCount > 0, "Should have negative SINE values");
}
[Fact]
public void SineIndicator_ZeroCrossings_IndicateCyclePhase()
{
var indicator = new SineIndicator { HpPeriod = 20, SsfPeriod = 5 };
indicator.Initialize();
var now = DateTime.UtcNow;
var values = new List<double>();
// Generate sine wave price pattern
for (int i = 0; i < 200; i++)
{
double price = 100.0 + 10.0 * Math.Sin(i * 0.15);
indicator.HistoricalData.AddBar(now.AddMinutes(i), price, price + 1, price - 1, price);
indicator.ProcessUpdate(new UpdateArgs(UpdateReason.HistoricalBar));
values.Add(indicator.LinesSeries[0].GetValue(0));
}
// Count zero crossings
int crossings = 0;
for (int i = 1; i < values.Count; i++)
{
if (values[i - 1] * values[i] < 0)
{
crossings++;
}
}
// Should have multiple zero crossings for oscillating price
Assert.True(crossings >= 3, $"Should have multiple zero crossings, got {crossings}");
}
}