using AstroFrame.Engine; using System.Security.Cryptography; using System.Text.Json; static class OverlayRegression { public static void Run(Action check) { var residual=new double[SkyModel.Count];var scatter=Enumerable.Repeat(2.0,SkyModel.Count).ToArray(); for(int i=0;i<100;i++)residual[i]=500; residual[100]=100;residual[101]=-500;residual[102]=9;residual[103]=double.NaN;residual[104]=50; var strengths=SkyOverlay.ExcessMask(residual,scatter); check(strengths[0]==255&&strengths[100]>=128&&strengths[101]==0&&strengths[102]==0&&strengths[103]==0&&strengths[104]==0,"fainter cloud structure stays visible while weak, dark and invalid residuals are unshaded"); RealFrames(check); string directory=Path.Combine(Path.GetTempPath(),"AstroFrame-overlay-"+Guid.NewGuid()); try { float[] Map(bool cloud)=>Enumerable.Range(0,SkyModel.Count).Select(i=> { double x=(i%SkyModel.Columns+.5)/SkyModel.Columns,y=(i/SkyModel.Columns+.5)/SkyModel.Rows; double nebula=80*Math.Exp(-((x-.45)*(x-.45)+(y-.55)*(y-.55))*35); double glow=cloud?450*Math.Exp(-Math.Pow(y/.18,2))+400*Math.Exp(-Math.Pow((x-.25)/.23,2)-Math.Pow((y-.42)/.16,2)):0; return (float)(1000+75*x+30*y+nebula+glow); }).ToArray(); Frame Make(int n,bool cloud=false)=>new() { Id=n.ToString(),Length=100,Modified=200,Width=240,Height=400,Session="same night",Measured=true, SkyMap=Map(cloud),SkyNoise=Enumerable.Repeat(20f,SkyModel.Count).ToArray(),Noise=20,Alignment=[1,0,0,0], Stars=[new(.4,.5,1000,3,.1)],AdditionalMeasurements=new(){{"Clear reference member",cloud?0:1}} }; var frames=Enumerable.Range(0,30).Select(n=>Make(n)).ToList();var selected=Make(30,true); selected.CloudMask=Enumerable.Repeat((byte)1,SkyModel.Count).ToArray();selected.CloudCoverage=.9;selected.Automatic=Verdict.Reject;selected.Override=Verdict.Keep;selected.Note="Human decision"; frames.Add(selected); // Other sessions must not contribute to the reference, even without a readable catalog. frames.Add(new(){Id="other",Session="other night",Measured=true,Alignment=[1,0,0,0],AdditionalMeasurements=new(){{"Clear reference member",1}}}); var project=new Project{Frames=frames,Complete=true};ProjectStore.Save(project,directory); var files=Directory.GetFiles(directory,"*",SearchOption.AllDirectories); string Hash(string path)=>Convert.ToHexString(SHA256.HashData(File.ReadAllBytes(path))); var before=files.ToDictionary(path=>path,Hash); var restored=ProjectStore.Load(directory);selected=restored.Frames.Single(f=>f.Id=="30"); var mask=SkyOverlay.LoadMask(directory,selected,restored.Frames,CancellationToken.None); var clear=Enumerable.Range(0,SkyModel.Count).Where(i=>(i%SkyModel.Columns+.5)/SkyModel.Columns>.7&&(i/SkyModel.Columns+.5)/SkyModel.Rows>.35&&(i/SkyModel.Columns+.5)/SkyModel.Rows<.6).ToArray(); var core=Enumerable.Range(0,SkyModel.Count).Where(i=>(i%SkyModel.Columns+.5)/SkyModel.Columns>.15&&(i%SkyModel.Columns+.5)/SkyModel.Columns<.35&&(i/SkyModel.Columns+.5)/SkyModel.Rows>.35&&(i/SkyModel.Columns+.5)/SkyModel.Rows<.45).ToArray(); check(mask.Length==SkyModel.Count&&clear.All(i=>mask[i]==0)&&core.All(i=>mask[i]>0),"legacy overlay follows localized cloud glow instead of the compensating dark sky"); check(selected.CloudMask.All(v=>v==1)&&selected.CloudCoverage==.9&&selected.Automatic==Verdict.Reject&&selected.Override==Verdict.Keep&&selected.Note=="Human decision","overlay reconstruction preserves classification evidence and human decisions"); check(files.All(path=>before[path]==Hash(path)),"legacy overlay reconstruction leaves the saved project and catalogs byte-identical"); selected.ExcessSkyMask=mask; check(SkyOverlay.LoadMask("missing directory",selected,[],CancellationToken.None).SequenceEqual(mask),"newly measured overlays display without reopening reference catalogs"); selected.ExcessSkyMask=[]; File.Delete(Path.Combine(directory,"catalogs","0-v2.bin")); check(SkyOverlay.LoadMask(directory,selected,restored.Frames,CancellationToken.None).Length==0,"incomplete legacy references never fall back to the misleading two-sided mask"); } finally{if(Directory.Exists(directory))Directory.Delete(directory,true);} } sealed record Sample(string Name,int Width,int Height,double[] Alignment,float[] SkyMap,double[][] CloudRegions,double[][] ClearRegions); sealed record Fixture(double?[] ReferenceBackground,double[] ReferenceScatter,double Noise,Sample[] Samples); static void RealFrames(Action check) { var fixture=JsonSerializer.Deserialize(File.ReadAllText(Path.Combine(AppContext.BaseDirectory,"Fixtures","overlay-backgrounds.json")))!; var reference=new SkyOverlay.Reference(fixture.ReferenceBackground.Select(v=>v??double.NaN).ToArray(),fixture.ReferenceScatter,fixture.Noise); foreach(var sample in fixture.Samples) { var frame=new Frame{Width=sample.Width,Height=sample.Height,Alignment=sample.Alignment,SkyMap=sample.SkyMap}; var mask=reference.Measure(frame);var a=sample.Alignment;double aspect=(double)sample.Height/sample.Width; int[] Cells(double[] region)=>Enumerable.Range(0,SkyModel.Count).Where(i=> { double x=(i%SkyModel.Columns+.5)/SkyModel.Columns,y=(i/SkyModel.Columns+.5)/SkyModel.Rows; double u=a[0]*x-a[1]*y*aspect+a[2],v=(a[1]*x+a[0]*y*aspect+a[3])/aspect; return u>region[0]&&uregion[2]&&vcells.Length>0&&cells.Count(i=>mask[i]>=128)>=cells.Length*.85&&cells.Average(i=>(double)mask[i])>180),$"{sample.Name}: each reported cloud core has clearly visible overlay strength"); check(clear.All(cells=>cells.Length>0&&cells.Count(i=>mask[i]>0)<=cells.Length*.1),$"{sample.Name}: dark comparison regions avoid the false corner overlay"); } } }