Files
Miha Kralj 060649192f docs: remove C# Implementation Considerations sections, clean up temp scripts, reorganize test files
- Remove 'C# Implementation Considerations' sections from 34 indicator .md files
- Delete 29 temp PowerShell scripts (_fix_mojibake.ps1, _hex_scan.ps1, etc.)
- Move test files into tests/ subdirectories for consistent project structure
- Add trader-focused bullet points to indicator documentation
2026-03-12 12:34:16 -07:00

618 lines
19 KiB
C#

// PIVOTEXT Tests - Extended Traditional Pivot Points
namespace QuanTAlib.Tests;
// -- A) Constructor Validation ------------------------------------------------
public sealed class PivotextConstructorTests
{
[Fact]
public void Constructor_Default_SetsProperties()
{
var p = new Pivotext();
Assert.Equal(2, p.WarmupPeriod);
Assert.Contains("Pivotext", p.Name, StringComparison.Ordinal);
Assert.False(p.IsHot);
}
[Fact]
public void Constructor_InitialState_AllNaN()
{
var p = new Pivotext();
Assert.True(double.IsNaN(p.PP));
Assert.True(double.IsNaN(p.R1));
Assert.True(double.IsNaN(p.R2));
Assert.True(double.IsNaN(p.R3));
Assert.True(double.IsNaN(p.R4));
Assert.True(double.IsNaN(p.R5));
Assert.True(double.IsNaN(p.S1));
Assert.True(double.IsNaN(p.S2));
Assert.True(double.IsNaN(p.S3));
Assert.True(double.IsNaN(p.S4));
Assert.True(double.IsNaN(p.S5));
}
}
// -- B) Basic Calculation -----------------------------------------------------
public sealed class PivotextBasicTests
{
[Fact]
public void Update_ReturnsTValue()
{
var p = new Pivotext();
var bar = new TBar(DateTime.UtcNow, 100, 110, 90, 100, 1000);
TValue result = p.Update(bar);
Assert.IsType<TValue>(result);
}
[Fact]
public void Update_Last_IsAccessible()
{
var p = new Pivotext();
var bar = new TBar(DateTime.UtcNow, 100, 110, 90, 100, 1000);
_ = p.Update(bar);
Assert.True(double.IsFinite(p.Last.Value) || double.IsNaN(p.Last.Value));
}
[Fact]
public void Update_KnownValues_CorrectPivotLevels()
{
// Given previous bar H=110, L=90, C=100, range=20
// PP = (110+90+100)/3 = 100
// ppMinusL = 100-90 = 10, hMinusPP = 110-100 = 10
// R1 = 2*100 - 90 = 110
// S1 = 2*100 - 110 = 90
// R2 = 100 + 20 = 120
// S2 = 100 - 20 = 80
// R3 = 110 + 2*10 = 130
// S3 = 90 - 2*10 = 70
// R4 = 110 + 3*10 = 140
// S4 = 90 - 3*10 = 60
// R5 = 110 + 4*10 = 150
// S5 = 90 - 4*10 = 50
var p = new Pivotext();
var dt = DateTime.UtcNow;
// First bar: stores HLC, no output yet
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
Assert.True(double.IsNaN(p.PP));
// Second bar: computes from first bar's HLC
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
Assert.Equal(100.0, p.PP, precision: 10);
Assert.Equal(110.0, p.R1, precision: 10);
Assert.Equal(90.0, p.S1, precision: 10);
Assert.Equal(120.0, p.R2, precision: 10);
Assert.Equal(80.0, p.S2, precision: 10);
Assert.Equal(130.0, p.R3, precision: 10);
Assert.Equal(70.0, p.S3, precision: 10);
Assert.Equal(140.0, p.R4, precision: 10);
Assert.Equal(60.0, p.S4, precision: 10);
Assert.Equal(150.0, p.R5, precision: 10);
Assert.Equal(50.0, p.S5, precision: 10);
}
[Fact]
public void Update_SecondKnownValues_CorrectPivotLevels()
{
// Given previous bar H=120, L=100, C=115, range=20
// PP = (120+100+115)/3 = 111.6667
// ppMinusL = 111.6667-100 = 11.6667, hMinusPP = 120-111.6667 = 8.3333
// R1 = 2*111.6667 - 100 = 123.3333
// S1 = 2*111.6667 - 120 = 103.3333
// R2 = 111.6667 + 20 = 131.6667
// S2 = 111.6667 - 20 = 91.6667
// R3 = 120 + 2*11.6667 = 143.3333
// S3 = 100 - 2*8.3333 = 83.3333
// R4 = 120 + 3*11.6667 = 155.0
// S4 = 100 - 3*8.3333 = 75.0
// R5 = 120 + 4*11.6667 = 166.6667
// S5 = 100 - 4*8.3333 = 66.6667
var p = new Pivotext();
var dt = DateTime.UtcNow;
_ = p.Update(new TBar(dt, 110, 120, 100, 115, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 115, 125, 105, 120, 1000), isNew: true);
double expectedPP = (120.0 + 100.0 + 115.0) / 3.0;
double ppMinusL = expectedPP - 100.0;
double hMinusPP = 120.0 - expectedPP;
Assert.Equal(expectedPP, p.PP, precision: 10);
Assert.Equal(2.0 * expectedPP - 100.0, p.R1, precision: 10);
Assert.Equal(2.0 * expectedPP - 120.0, p.S1, precision: 10);
Assert.Equal(expectedPP + 20.0, p.R2, precision: 10);
Assert.Equal(expectedPP - 20.0, p.S2, precision: 10);
Assert.Equal(120.0 + 2.0 * ppMinusL, p.R3, precision: 10);
Assert.Equal(100.0 - 2.0 * hMinusPP, p.S3, precision: 10);
Assert.Equal(120.0 + 3.0 * ppMinusL, p.R4, precision: 10);
Assert.Equal(100.0 - 3.0 * hMinusPP, p.S4, precision: 10);
Assert.Equal(120.0 + 4.0 * ppMinusL, p.R5, precision: 10);
Assert.Equal(100.0 - 4.0 * hMinusPP, p.S5, precision: 10);
}
[Fact]
public void Update_LevelsHaveCorrectOrdering()
{
// For any normal bar: S5 < S4 < S3 < S2 < S1 < PP < R1 < R2 < R3 < R4 < R5
var p = new Pivotext();
var dt = DateTime.UtcNow;
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
Assert.True(p.S5 < p.S4);
Assert.True(p.S4 < p.S3);
Assert.True(p.S3 < p.S2);
Assert.True(p.S2 < p.S1);
Assert.True(p.S1 < p.PP);
Assert.True(p.PP < p.R1);
Assert.True(p.R1 < p.R2);
Assert.True(p.R2 < p.R3);
Assert.True(p.R3 < p.R4);
Assert.True(p.R4 < p.R5);
}
[Fact]
public void Name_ContainsPivotext()
{
var p = new Pivotext();
Assert.Contains("Pivotext", p.Name, StringComparison.Ordinal);
}
}
// -- C) State + Bar Correction ------------------------------------------------
public sealed class PivotextStateCorrectionTests
{
[Fact]
public void IsNew_True_AdvancesState()
{
var p = new Pivotext();
_ = p.Update(new TBar(DateTime.UtcNow, 100, 110, 90, 100, 1000), isNew: true);
var first = p.Last;
_ = p.Update(new TBar(DateTime.UtcNow.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
var second = p.Last;
Assert.NotEqual(first.Time, second.Time);
}
[Fact]
public void IsNew_False_CorrectionRestoresState()
{
var p = new Pivotext();
var dt = DateTime.UtcNow;
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
double ppBefore = p.PP;
// Correct the second bar (isNew=false)
_ = p.Update(new TBar(dt.AddMinutes(1), 108, 118, 92, 108, 1000), isNew: false);
// PP should still be based on bar 0's HLC (H=110, L=90, C=100)
Assert.Equal(ppBefore, p.PP, precision: 10);
}
[Fact]
public void IterativeCorrections_ProduceSameResult()
{
var p = new Pivotext();
var dt = DateTime.UtcNow;
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
double[] ppResults = new double[3];
for (int i = 0; i < 3; i++)
{
_ = p.Update(new TBar(dt.AddMinutes(1), 108, 120, 88, 110, 1000), isNew: false);
ppResults[i] = p.PP;
}
Assert.Equal(ppResults[0], ppResults[1]);
Assert.Equal(ppResults[1], ppResults[2]);
}
[Fact]
public void IsNew_False_AllLevelsStable()
{
var p = new Pivotext();
var dt = DateTime.UtcNow;
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 108, 120, 88, 110, 1000), isNew: false);
double r1a = p.R1, s1a = p.S1, r2a = p.R2, s2a = p.S2;
double r3a = p.R3, s3a = p.S3, r4a = p.R4, s4a = p.S4;
double r5a = p.R5, s5a = p.S5;
_ = p.Update(new TBar(dt.AddMinutes(1), 108, 120, 88, 110, 1000), isNew: false);
Assert.Equal(r1a, p.R1);
Assert.Equal(s1a, p.S1);
Assert.Equal(r2a, p.R2);
Assert.Equal(s2a, p.S2);
Assert.Equal(r3a, p.R3);
Assert.Equal(s3a, p.S3);
Assert.Equal(r4a, p.R4);
Assert.Equal(s4a, p.S4);
Assert.Equal(r5a, p.R5);
Assert.Equal(s5a, p.S5);
}
[Fact]
public void Reset_ClearsAllState()
{
var p = new Pivotext();
var dt = DateTime.UtcNow;
for (int i = 0; i < 10; i++)
{
double price = 100.0 + i;
_ = p.Update(new TBar(dt.AddMinutes(i), price, price + 5, price - 5, price + 1, 1000));
}
Assert.True(p.IsHot);
p.Reset();
Assert.False(p.IsHot);
Assert.True(double.IsNaN(p.PP));
Assert.True(double.IsNaN(p.R1));
Assert.True(double.IsNaN(p.R2));
Assert.True(double.IsNaN(p.R3));
Assert.True(double.IsNaN(p.R4));
Assert.True(double.IsNaN(p.R5));
Assert.True(double.IsNaN(p.S1));
Assert.True(double.IsNaN(p.S2));
Assert.True(double.IsNaN(p.S3));
Assert.True(double.IsNaN(p.S4));
Assert.True(double.IsNaN(p.S5));
}
}
// -- D) Warmup / Convergence --------------------------------------------------
public sealed class PivotextWarmupTests
{
[Fact]
public void IsHot_FlipsAfterWarmup()
{
var p = new Pivotext();
// First bar - not hot
_ = p.Update(new TBar(DateTime.UtcNow, 100, 110, 90, 100, 1000));
Assert.False(p.IsHot, "Should not be hot after 1 bar");
// Second bar - should be hot
_ = p.Update(new TBar(DateTime.UtcNow.AddMinutes(1), 105, 115, 95, 105, 1000));
Assert.True(p.IsHot, "Should be hot after 2 bars");
}
[Fact]
public void WarmupPeriod_Equals2()
{
var p = new Pivotext();
Assert.Equal(2, p.WarmupPeriod);
}
}
// -- E) Robustness ------------------------------------------------------------
public sealed class PivotextRobustnessTests
{
[Fact]
public void NaN_Input_UsesLastValidValue()
{
var p = new Pivotext();
var dt = DateTime.UtcNow;
// Feed valid bars
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
Assert.True(p.IsHot);
// Feed NaN bar
_ = p.Update(new TBar(dt.AddMinutes(2), double.NaN, double.NaN, double.NaN, double.NaN, 0), isNew: true);
Assert.True(p.IsHot);
Assert.True(double.IsFinite(p.PP));
}
[Fact]
public void Infinity_Input_UsesLastValidValue()
{
var p = new Pivotext();
var dt = DateTime.UtcNow;
_ = p.Update(new TBar(dt, 100, 110, 90, 100, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(1), 105, 115, 95, 105, 1000), isNew: true);
_ = p.Update(new TBar(dt.AddMinutes(2),
double.PositiveInfinity, double.PositiveInfinity, double.NegativeInfinity, double.PositiveInfinity, 0),
isNew: true);
Assert.True(p.IsHot);
Assert.True(double.IsFinite(p.PP));
}
[Fact]
public void FirstBar_NaN_ReturnsNaN()
{
var p = new Pivotext();
_ = p.Update(new TBar(DateTime.UtcNow, double.NaN, double.NaN, double.NaN, double.NaN, 0));
Assert.True(double.IsNaN(p.Last.Value));
Assert.True(double.IsNaN(p.PP));
}
}
// -- F) Consistency -----------------------------------------------------------
public sealed class PivotextConsistencyTests
{
private static TBarSeries CreateGbmBars(int count = 500)
{
var gbm = new GBM(startPrice: 100.0, mu: 0.05, sigma: 0.20, seed: 42);
return gbm.Fetch(count, DateTime.UtcNow.Ticks, TimeSpan.FromMinutes(1));
}
[Fact]
public void Streaming_MatchesBatch()
{
var bars = CreateGbmBars();
// Streaming
var streaming = new Pivotext();
var streamPP = new double[bars.Count];
for (int i = 0; i < bars.Count; i++)
{
_ = streaming.Update(bars[i], isNew: true);
streamPP[i] = streaming.PP;
}
// Batch
var batchResults = Pivotext.Batch(bars);
for (int i = 1; i < bars.Count; i++)
{
if (double.IsNaN(streamPP[i]))
{
Assert.True(double.IsNaN(batchResults[i].Value), $"Mismatch at {i}");
}
else
{
Assert.Equal(streamPP[i], batchResults[i].Value, precision: 10);
}
}
}
[Fact]
public void Streaming_MatchesSpan()
{
var bars = CreateGbmBars();
// Streaming
var streaming = new Pivotext();
var streamPP = new double[bars.Count];
for (int i = 0; i < bars.Count; i++)
{
_ = streaming.Update(bars[i], isNew: true);
streamPP[i] = streaming.PP;
}
// Span
var spanPP = new double[bars.Count];
Pivotext.Batch(bars.HighValues, bars.LowValues, bars.CloseValues, spanPP);
for (int i = 1; i < bars.Count; i++)
{
if (double.IsNaN(streamPP[i]))
{
Assert.True(double.IsNaN(spanPP[i]), $"PP mismatch at {i}");
}
else
{
Assert.Equal(streamPP[i], spanPP[i], precision: 10);
}
}
}
[Fact]
public void Streaming_MatchesBatchAll_AllLevels()
{
var bars = CreateGbmBars(count: 200);
// Streaming
var streaming = new Pivotext();
var sPP = new double[bars.Count];
var sR1 = new double[bars.Count];
var sS1 = new double[bars.Count];
var sR2 = new double[bars.Count];
var sS2 = new double[bars.Count];
var sR3 = new double[bars.Count];
var sS3 = new double[bars.Count];
var sR4 = new double[bars.Count];
var sS4 = new double[bars.Count];
var sR5 = new double[bars.Count];
var sS5 = new double[bars.Count];
for (int i = 0; i < bars.Count; i++)
{
_ = streaming.Update(bars[i], isNew: true);
sPP[i] = streaming.PP;
sR1[i] = streaming.R1;
sS1[i] = streaming.S1;
sR2[i] = streaming.R2;
sS2[i] = streaming.S2;
sR3[i] = streaming.R3;
sS3[i] = streaming.S3;
sR4[i] = streaming.R4;
sS4[i] = streaming.S4;
sR5[i] = streaming.R5;
sS5[i] = streaming.S5;
}
// BatchAll
var bPP = new double[bars.Count];
var bR1 = new double[bars.Count];
var bS1 = new double[bars.Count];
var bR2 = new double[bars.Count];
var bS2 = new double[bars.Count];
var bR3 = new double[bars.Count];
var bS3 = new double[bars.Count];
var bR4 = new double[bars.Count];
var bS4 = new double[bars.Count];
var bR5 = new double[bars.Count];
var bS5 = new double[bars.Count];
Pivotext.BatchAll(bars.HighValues, bars.LowValues, bars.CloseValues,
bPP, bR1, bS1, bR2, bS2, bR3, bS3, bR4, bS4, bR5, bS5);
for (int i = 1; i < bars.Count; i++)
{
if (double.IsNaN(sPP[i])) { Assert.True(double.IsNaN(bPP[i])); continue; }
Assert.Equal(sPP[i], bPP[i], precision: 10);
Assert.Equal(sR1[i], bR1[i], precision: 10);
Assert.Equal(sS1[i], bS1[i], precision: 10);
Assert.Equal(sR2[i], bR2[i], precision: 10);
Assert.Equal(sS2[i], bS2[i], precision: 10);
Assert.Equal(sR3[i], bR3[i], precision: 10);
Assert.Equal(sS3[i], bS3[i], precision: 10);
Assert.Equal(sR4[i], bR4[i], precision: 10);
Assert.Equal(sS4[i], bS4[i], precision: 10);
Assert.Equal(sR5[i], bR5[i], precision: 10);
Assert.Equal(sS5[i], bS5[i], precision: 10);
}
}
[Fact]
public void TValue_Update_MatchesTBar_Update()
{
var p1 = new Pivotext();
var p2 = new Pivotext();
double[] prices = [100, 102, 98, 105, 99, 103, 107, 95, 110, 108];
for (int i = 0; i < prices.Length; i++)
{
double pr = prices[i];
_ = p1.Update(new TBar(DateTime.UtcNow.AddMinutes(i), pr, pr, pr, pr, 0), isNew: true);
_ = p2.Update(new TValue(DateTime.UtcNow.AddMinutes(i), pr), isNew: true);
}
Assert.Equal(p1.PP, p2.PP);
Assert.Equal(p1.R1, p2.R1);
Assert.Equal(p1.S1, p2.S1);
}
}
// -- G) Span API Tests --------------------------------------------------------
public sealed class PivotextSpanTests
{
[Fact]
public void Batch_Span_MismatchedLengths_Throws()
{
var ex = Assert.Throws<ArgumentException>(() =>
Pivotext.Batch(new double[10], new double[5], new double[10], new double[10]));
Assert.Equal("high", ex.ParamName);
}
[Fact]
public void Batch_Span_OutputTooShort_Throws()
{
var ex = Assert.Throws<ArgumentException>(() =>
Pivotext.Batch(new double[10], new double[10], new double[10], new double[5]));
Assert.Equal("ppOutput", ex.ParamName);
}
[Fact]
public void Batch_Span_Empty_NoException()
{
var ex = Record.Exception(() =>
Pivotext.Batch(ReadOnlySpan<double>.Empty, ReadOnlySpan<double>.Empty,
ReadOnlySpan<double>.Empty, Span<double>.Empty));
Assert.Null(ex);
}
[Fact]
public void BatchAll_OutputTooShort_Throws()
{
var ex = Assert.Throws<ArgumentException>(() =>
Pivotext.BatchAll(new double[10], new double[10], new double[10],
new double[10], new double[5], new double[10],
new double[10], new double[10], new double[10],
new double[10], new double[10], new double[10],
new double[10], new double[10]));
Assert.Equal("r1Out", ex.ParamName);
}
}
// -- H) Event / Chainability -------------------------------------------------
public sealed class PivotextEventTests
{
[Fact]
public void Pub_FiresOnUpdate()
{
var p = new Pivotext();
int fireCount = 0;
p.Pub += (object? _, in TValueEventArgs _e) => { fireCount++; };
_ = p.Update(new TBar(DateTime.UtcNow, 100, 110, 90, 100, 1000));
Assert.Equal(1, fireCount);
}
[Fact]
public void Pub_FiresOnEachUpdate()
{
var p = new Pivotext();
int fireCount = 0;
p.Pub += (object? _, in TValueEventArgs _e) => { fireCount++; };
for (int i = 0; i < 5; i++)
{
double price = 100.0 + i;
_ = p.Update(new TBar(DateTime.UtcNow.AddMinutes(i), price, price + 5, price - 5, price + 1, 1000));
}
Assert.Equal(5, fireCount);
}
}
// -- I) Prime Tests -----------------------------------------------------------
public sealed class PivotextPrimeTests
{
[Fact]
public void Prime_TBarSeries_SetsState()
{
var gbm = new GBM(startPrice: 100.0, mu: 0.05, sigma: 0.20, seed: 42);
var bars = gbm.Fetch(50, DateTime.UtcNow.Ticks, TimeSpan.FromMinutes(1));
var p = new Pivotext();
p.Prime(bars);
Assert.True(p.IsHot);
}
[Fact]
public void Prime_EmptySource_NoException()
{
var p = new Pivotext();
var bars = new TBarSeries();
var ex = Record.Exception(() => p.Prime(bars));
Assert.Null(ex);
Assert.False(p.IsHot);
}
}