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) { /// /// 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. /// [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); } }