using System.Globalization; using Titano.Core.Analysis; using Titano.Core.Diagnostics.Synthetic; using Titano.Core.Imaging; using Titano.Testing; namespace Titano.Core.Tests.Analysis; public sealed class RegionTests(TestContext context) { private static SyntheticSequence Landscape(int frames, double tilt, double wave, int seed = 5) => SyntheticSequence.Create(new SyntheticSequenceOptions { Width = 128, Height = 80, FrameCount = frames, Seed = seed, StartEv = -1, EndEv = 0, HorizonFraction = 0.45, HorizonTilt = tilt, HorizonWave = wave, SkyFlickerEv = 0.15, LandFlickerEv = 0.15, }); private static List RenderAll(SyntheticSequence sequence) => Enumerable.Range(0, sequence.Count).Select(sequence.Render).ToList(); [Test] public void HorizonIsFoundPerColumnWithHighConfidence() { var sequence = Landscape(30, tilt: 0.08, wave: 3); var frames = RenderAll(sequence); try { var mask = RegionSegmenter.Segment(frames); Assert.Equal(RegionMethod.Horizon, mask.Method); Assert.Greater(mask.Confidence, 0.6); var horizon = Assert.NotNull(mask.Horizon); var worst = Enumerable.Range(0, mask.Width).Max(x => Math.Abs(horizon[x] - sequence.HorizonRow(x + 0.5))); var agreement = Agreement(mask, sequence); context.Log(string.Create(CultureInfo.InvariantCulture, $"confidence {mask.Confidence:F3}, worst column error {worst:F3} px, pixel agreement {agreement:P2}")); Assert.LessOrEqual(worst, 1.0); Assert.GreaterOrEqual(agreement, 0.98); } finally { frames.ForEach(f => f.Dispose()); } } [Test] public void HorizonSurvivesPolarityChangesAcrossFrames() { var day = Landscape(10, tilt: 0, wave: 0); var night = SyntheticSequence.Create(day.Options with { SkyLevel = 0.01, LandLevel = 0.2, Seed = 6 }); var frames = RenderAll(day).Concat(RenderAll(night)).ToList(); try { var mask = RegionSegmenter.Segment(frames); Assert.Equal(RegionMethod.Horizon, mask.Method); var horizon = Assert.NotNull(mask.Horizon); Assert.True(horizon.All(h => Math.Abs(h - 0.45 * 80) <= 1), "horizon row"); } finally { frames.ForEach(f => f.Dispose()); } } [Test] public void CliffFallsBackToLuminance() { // Sky above row 20 on the left half and above row 60 on the right: no single row step explains it. var frames = new List(); for (var f = 0; f < 6; f++) { var image = new ImageBuffer(96, 80, 3); for (var y = 0; y < 80; y++) { for (var x = 0; x < 96; x++) { var sky = y < (x < 48 ? 20 : 60); var v = sky ? 0.4f * (1 + 0.02f * f) : 0.03f * (1 + ((x * 7 + y * 13) % 5) * 0.1f); for (var c = 0; c < 3; c++) image[c, x, y] = v; } } frames.Add(image); } try { var mask = RegionSegmenter.Segment(frames); Assert.Equal(RegionMethod.Luminance, mask.Method); Assert.Greater(mask.Confidence, 0.5); var correct = 0; for (var y = 0; y < 80; y++) { for (var x = 0; x < 96; x++) { var sky = y < (x < 48 ? 20 : 60); if (mask.Sky[y * 96 + x] >= 0.5f == sky) correct++; } } Assert.GreaterOrEqual(correct / (96.0 * 80), 0.97); } finally { frames.ForEach(f => f.Dispose()); } } [Test] public void FeaturelessFramesHaveNoConfidence() { using var flat = new ImageBuffer(64, 48, 3); flat.Data.Fill(0.2f); var mask = RegionSegmenter.Segment([flat]); Assert.Less(mask.Confidence, 0.05); } /// BRIEF ยง20.4: with independent sky and land flicker, the land residual after region deflicker is at /// most 25 % of the residual left by one global curve. [Test] public void RegionDeflickerMeetsTheRegressionGate() { var sequence = Landscape(150, tilt: 0.05, wave: 2); var frames = RenderAll(sequence); RegionMask mask; double[] sky, land, global; try { mask = RegionSegmenter.Segment(frames); sky = new double[frames.Count]; land = new double[frames.Count]; global = new double[frames.Count]; for (var i = 0; i < frames.Count; i++) { (sky[i], land[i]) = RegionDeflicker.Measure(frames[i], mask); global[i] = FrameStatistics.MeasureLogLuminance(frames[i]); } } finally { frames.ForEach(f => f.Dispose()); } var options = new DeflickerOptions { Window = 31 }; var globalResult = DeflickerEngine.Compute(global, options); var regionResult = RegionDeflicker.Compute(sky, land, options); var trueLand = AnalysisFixtures.TrueLandMask(sequence); var landAfterGlobal = AnalysisFixtures.MeasureSeries(sequence, (i, image) => { ExposureProcessor.Apply(image, globalResult.CorrectionEv[i]); return image; }, trueLand); var landAfterRegion = AnalysisFixtures.MeasureSeries(sequence, (i, image) => { RegionDeflicker.Apply(image, mask, regionResult.Sky.CorrectionEv[i], regionResult.Land.CorrectionEv[i]); return image; }, trueLand); var globalResidual = AnalysisFixtures.FrameToFrameResidualRms(landAfterGlobal, sequence.SceneEv); var regionResidual = AnalysisFixtures.FrameToFrameResidualRms(landAfterRegion, sequence.SceneEv); var ratio = regionResidual / globalResidual; context.Log(string.Create(CultureInfo.InvariantCulture, $"mask {mask.Method} confidence {mask.Confidence:F3}; land residual global {globalResidual:F4} EV, region {regionResidual:F4} EV, ratio {ratio:P1}")); Assert.LessOrEqual(ratio, 0.25); } [Test] public void ResampledMaskKeepsTheHorizon() { var sequence = Landscape(6, tilt: 0, wave: 0); var frames = RenderAll(sequence); try { var mask = RegionSegmenter.Segment(frames); var big = mask.Resample(256, 160); Assert.Equal(256 * 160, big.Sky.Length); Assert.Approximately(2 * mask.Horizon![10], big.Horizon![20], 0.6); Assert.True(big.Sky[5 * 256 + 100] > 0.99f && big.Sky[150 * 256 + 100] < 0.01f); Assert.Same(mask, mask.Resample(mask.Width, mask.Height)); } finally { frames.ForEach(f => f.Dispose()); } } private static double Agreement(RegionMask mask, SyntheticSequence sequence) { var correct = 0; for (var y = 0; y < mask.Height; y++) { for (var x = 0; x < mask.Width; x++) { if (mask.Sky[y * mask.Width + x] >= 0.5f == sequence.IsSky(x, y)) correct++; } } return correct / (double)(mask.Width * mask.Height); } }