Metadata steps are verified against the detrended measured jump; only received steps are removed, the step-free series deflickered and the steps restored as smoothstep transitions that lengthen until no frame step exceeds 0.3 EV. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
89 lines
4.3 KiB
C#
89 lines
4.3 KiB
C#
using System.Globalization;
|
|
using Titano.Core.Analysis;
|
|
using Titano.Core.Diagnostics.Synthetic;
|
|
using Titano.Testing;
|
|
|
|
namespace Titano.Core.Tests.Analysis;
|
|
|
|
public sealed class HolyGrailEngineTests(TestContext context)
|
|
{
|
|
/// <summary>
|
|
/// Sunset: the scene darkens 8 EV while the camera opens up 2/3 EV every 20 frames, plus one metadata change
|
|
/// the pixels never received. BRIEF §20.4: no target step above 0.3 EV; the total change is preserved.
|
|
/// </summary>
|
|
[Test]
|
|
public void SunsetStepsAreRedistributedWithinTheGate()
|
|
{
|
|
var steps = Enumerable.Range(1, 11).Select(k => new SyntheticExposureStep(k * 20, -2.0 / 3, k % 3 == 0 ? ExposureChange.Iso : ExposureChange.Shutter)).ToList();
|
|
steps.Add(new SyntheticExposureStep(130, -1.0 / 3, ExposureChange.Aperture, Received: false));
|
|
var sequence = SyntheticSequence.Create(new SyntheticSequenceOptions
|
|
{
|
|
FrameCount = 240,
|
|
Seed = 9,
|
|
StartEv = 2,
|
|
EndEv = -6,
|
|
FlickerEv = 0.03,
|
|
ExposureSteps = steps,
|
|
});
|
|
var measured = AnalysisFixtures.MeasureSeries(sequence);
|
|
var ev = sequence.Frames.Select(f => f.ExposureValue).ToArray();
|
|
var result = HolyGrailEngine.Compute(measured, ev);
|
|
|
|
var rawMaxStep = Enumerable.Range(1, measured.Length - 1).Max(i => Math.Abs(measured[i] - measured[i - 1]));
|
|
var maxStep = Enumerable.Range(1, measured.Length - 1).Max(i => Math.Abs(result.Target[i] - result.Target[i - 1]));
|
|
var truth = sequence.SceneEv.Select((s, i) => s + sequence.ExposureOffsetEv[i]).ToArray();
|
|
var totalTruth = truth[^1] - truth[0];
|
|
var totalTarget = result.Target[^1] - result.Target[0];
|
|
context.Log(string.Create(CultureInfo.InvariantCulture,
|
|
$"raw max step {rawMaxStep:F3} EV, target max step {maxStep:F3} EV, total change target {totalTarget:F3} vs truth {totalTruth:F3} EV, transition {result.Transitions[0].Length} frames"));
|
|
|
|
Assert.Equal(12, result.Transitions.Count);
|
|
var ignored = Assert.NotNull(result.Transitions.SingleOrDefault(t => !t.Received));
|
|
Assert.Equal(130, ignored.Index);
|
|
Assert.True(result.Transitions.Where(t => t.Index != 130).All(t => t.Received));
|
|
Assert.Greater(rawMaxStep, 0.5);
|
|
Assert.LessOrEqual(maxStep, 0.3);
|
|
Assert.Approximately(maxStep, result.MaxFrameStepEv, 1e-12);
|
|
Assert.Approximately(totalTruth, totalTarget, 0.05);
|
|
// Default transition: half the 20-frame step spacing.
|
|
Assert.Equal(10.0, result.Transitions[0].Length);
|
|
}
|
|
|
|
[Test]
|
|
public void LargeStepGetsALongerTransition()
|
|
{
|
|
var n = 100;
|
|
var measured = Enumerable.Range(0, n).Select(i => i >= 50 ? 1.5 : 0.0).ToArray();
|
|
var ev = Enumerable.Range(0, n).Select(i => (double?)(i >= 50 ? 10.5 : 12.0)).ToArray();
|
|
var result = HolyGrailEngine.Compute(measured, ev, new HolyGrailOptions { TransitionFrames = 4 });
|
|
Assert.LessOrEqual(result.MaxFrameStepEv, 0.3);
|
|
Assert.GreaterOrEqual(result.Transitions[0].Length, 7.5);
|
|
Assert.Approximately(1.5, result.Target[^1] - result.Target[0], 1e-9);
|
|
Assert.Approximately(1.5, result.Transitions[0].MeasuredEv, 1e-9);
|
|
}
|
|
|
|
[Test]
|
|
public void StepsNearTheEndsStayInsideTheSequence()
|
|
{
|
|
var n = 30;
|
|
var measured = Enumerable.Range(0, n).Select(i => i >= 2 ? 1.0 : 0.0).ToArray();
|
|
var ev = Enumerable.Range(0, n).Select(i => (double?)(i >= 2 ? 11.0 : 12.0)).ToArray();
|
|
var result = HolyGrailEngine.Compute(measured, ev, new HolyGrailOptions { TransitionFrames = 8 });
|
|
Assert.Equal(0.0, result.Transitions[0].Start);
|
|
Assert.Approximately(0, result.SmoothedOffsets[0], 1e-12);
|
|
Assert.Approximately(1, result.SmoothedOffsets[^1], 1e-12);
|
|
Assert.LessOrEqual(result.MaxFrameStepEv, 0.3);
|
|
}
|
|
|
|
[Test]
|
|
public void NoMetadataStepsMeansPlainDeflicker()
|
|
{
|
|
var measured = Enumerable.Range(0, 60).Select(i => 0.01 * i + (i % 2 == 0 ? 0.05 : -0.05)).ToArray();
|
|
var ev = new double?[60];
|
|
var result = HolyGrailEngine.Compute(measured, ev);
|
|
var plain = DeflickerEngine.Compute(measured);
|
|
Assert.Empty(result.Transitions);
|
|
Assert.SequenceEqual(plain.Target, result.Target);
|
|
}
|
|
}
|