Files
Chronos/tests/Titano.Core.Tests/Motion/TemporalStackerTests.cs
T
Claude 02afd4673b feat(motion): add temporal median/mean stacking and star-trail accumulation
TemporalStacker keeps a sliding window of pooled frame copies and renders
an exact per-pixel median (vectorised odd-even transposition network up
to 32 frames, Hoare selection beyond) or mean. StarTrailStacker keeps a
progressive maximum with exponential decay; trail length in frames maps
to the decay that fades a trail to 1 %.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-02 09:44:11 +00:00

195 lines
7.0 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using Titano.Core.Imaging;
using Titano.Core.Motion;
using Titano.Testing;
namespace Titano.Core.Tests.Motion;
public sealed class TemporalStackerTests
{
private const int Size = 96;
private readonly TestContext _context;
public TemporalStackerTests(TestContext context) => _context = context;
[Test]
public void StarTrailLuminanceNeverDecreasesWithUnitDecay()
{
var random = new Random(5);
using var stacker = new StarTrailStacker(1.0);
using var frame = new ImageBuffer(Size, Size);
var previous = new float[Size * Size];
var current = new float[Size * Size];
long steps = 0, nonDecreasing = 0;
for (var k = 0; k < 40; k++)
{
NightFrame(frame, random, k);
stacker.Add(frame);
ColorSpace.Luminance(stacker.Result!, current);
if (k > 0)
{
for (var i = 0; i < current.Length; i++)
{
steps++;
if (current[i] >= previous[i]) nonDecreasing++;
}
}
(previous, current) = (current, previous);
}
var fraction = nonDecreasing / (double)steps;
_context.Log($"non-decreasing on {fraction:P3} of {steps} pixel steps");
Assert.GreaterOrEqual(fraction, 0.99);
Assert.Equal(40, stacker.Count);
// The trail of the first star position is still lit after 40 frames.
Assert.Greater(stacker.Result![1, StarX(0), StarY(0)], 0.5f);
}
[Test]
public void FiniteTrailsFadeToOnePercentOverTheirLength()
{
Assert.Equal(1.0, StarTrailStacker.DecayForTrailLength(double.PositiveInfinity));
Assert.Equal(1.0, StarTrailStacker.DecayForTrailLength(0));
var decay = StarTrailStacker.DecayForTrailLength(20);
Assert.Approximately(0.01, double.Pow(decay, 20), 1e-12);
using var stacker = new StarTrailStacker(decay);
using var lit = new ImageBuffer(8, 8, 1);
using var dark = new ImageBuffer(8, 8, 1);
lit[0, 3, 3] = 1f;
stacker.Add(lit);
for (var k = 0; k < 20; k++) stacker.Add(dark);
Assert.Approximately(0.01, stacker.Result![0, 3, 3], 1e-5);
}
[Test]
public void MedianRemovesATransientOutlierFrame()
{
var plane = SyntheticImages.Crop(SyntheticImages.Natural(128, seed: 12), 128, 0, 0, Size, Size);
var random = new Random(8);
using var stacker = new TemporalStacker(7, StackMode.Median);
for (var k = 0; k < 7; k++)
{
using var frame = SyntheticImages.ToRgb(plane, Size, Size);
var data = frame.Data;
for (var i = 0; i < data.Length; i++) data[i] += 0.01f * (float)(random.NextDouble() - 0.5);
if (k == 3)
{
// An aircraft light streak crossing one frame.
for (var c = 0; c < 3; c++)
for (var x = 10; x < 80; x++)
frame[c, x, 40 + x / 8] = 5f;
}
stacker.Push(frame);
}
Assert.True(stacker.IsFull);
using var output = new ImageBuffer(Size, Size);
stacker.Render(output);
using var reference = SyntheticImages.ToRgb(plane, Size, Size);
double maxError = 0;
for (var i = 0; i < output.Data.Length; i++) maxError = double.Max(maxError, double.Abs(output.Data[i] - reference.Data[i]));
_context.Log($"max deviation from the clean frame {maxError:F4}");
Assert.Less(maxError, 0.01);
}
[Theory]
[Case(1)]
[Case(5)]
[Case(6)]
[Case(32)]
[Case(33)]
public void MedianIsExact(int count)
{
var random = new Random(count);
var frames = new List<ImageBuffer>();
try
{
for (var k = 0; k < count; k++)
{
var frame = new ImageBuffer(37, 5, 3);
var data = frame.Data;
for (var i = 0; i < data.Length; i++) data[i] = (float)random.NextDouble();
frames.Add(frame);
}
using var output = new ImageBuffer(37, 5, 3);
TemporalStacker.Median(frames, output);
for (var i = 0; i < output.Data.Length; i++)
{
var sorted = frames.Select(f => f.Data[i]).Order().ToArray();
var expected = count % 2 == 1 ? sorted[count / 2] : 0.5f * (sorted[count / 2 - 1] + sorted[count / 2]);
Assert.Equal(expected, output.Data[i]);
}
}
finally
{
foreach (var f in frames) f.Dispose();
}
}
[Test]
public void MeanReducesNoiseBySquareRootOfN()
{
const int n = 16;
const double sigma = 0.05;
var random = new Random(3);
using var stacker = new TemporalStacker(n, StackMode.Mean);
using var frame = new ImageBuffer(Size, Size, 1);
for (var k = 0; k < n; k++)
{
var data = frame.Data;
for (var i = 0; i < data.Length; i++) data[i] = 0.4f + (float)(sigma * Gaussian(random));
stacker.Push(frame);
}
using var output = new ImageBuffer(Size, Size, 1);
stacker.Render(output);
var values = output.Data.ToArray();
var mean = values.Average(v => (double)v);
var std = double.Sqrt(values.Average(v => (v - mean) * (v - mean)));
_context.Log($"residual σ {std:F5} (expected {sigma / double.Sqrt(n):F5})");
Assert.Approximately(0.4, mean, 0.002);
Assert.Approximately(sigma / double.Sqrt(n), std, 0.15 * sigma / double.Sqrt(n));
}
[Test]
public void WindowSlidesOverTheNewestFrames()
{
using var stacker = new TemporalStacker(3, StackMode.Median);
using var frame = new ImageBuffer(4, 4, 1);
for (var k = 0; k < 10; k++)
{
frame.Data.Fill(k);
stacker.Push(frame);
}
Assert.Equal(3, stacker.Count);
using var output = new ImageBuffer(4, 4, 1);
stacker.Render(output);
Assert.True(output.Data.ToArray().All(v => v == 8f));
using var other = new ImageBuffer(5, 4, 1);
Assert.Throws<ArgumentException>(() => stacker.Push(other));
stacker.Clear();
Assert.Throws<InvalidOperationException>(() => stacker.Render(output));
}
private static int StarX(int k) => 20 + k;
private static int StarY(int k) => 30 + k / 3;
/// <summary>Dark noisy sky with one star drifting one pixel per frame and a few twinkling faint ones.</summary>
private static void NightFrame(ImageBuffer frame, Random random, int k)
{
var data = frame.Data;
for (var i = 0; i < data.Length; i++) data[i] = 0.002f + 0.001f * (float)random.NextDouble();
for (var c = 0; c < 3; c++)
{
frame[c, StarX(k), StarY(k)] = 0.9f;
frame[c, 60, 70] = 0.1f + 0.05f * (k % 3);
}
}
private static double Gaussian(Random random)
{
var u1 = 1.0 - random.NextDouble();
var u2 = random.NextDouble();
return double.Sqrt(-2 * double.Log(u1)) * double.Cos(2 * double.Pi * u2);
}
}