"""Preparation-only entry point for validated tetra cache + corresponding distance. No sample decoding, domain stripping, seeds, partitions, LP, or training. """ import argparse import hashlib import json from pathlib import Path import time import numpy as np if __package__: from .review_partition_scale import region_stats, merge_small_regions from .route_feasibility import graph_from_edges, node_tensor, spectral_features else: from review_partition_scale import region_stats, merge_small_regions from route_feasibility import graph_from_edges, node_tensor, spectral_features def clean_table(points, edges, mass, kind): points=np.asarray(points);edges=np.asarray(edges);mass=np.asarray(mass);kind=np.asarray(kind) if points.shape!=(len(mass),3) or kind.shape!=(len(mass),) or not np.isfinite(points).all() or not np.isfinite(mass).all() or np.any(mass<=0): raise ValueError('Invalid cached nodes or masses') if edges.ndim!=2 or edges.shape[1]!=2 or len(edges)==0 or edges.min()<0 or edges.max()>=len(points): raise ValueError('Invalid cached edges') length=np.linalg.norm(points[edges[:,0]]-points[edges[:,1]],axis=1) if np.any(length<=0) or not np.isfinite(length).all(): raise ValueError('Nonpositive edge length') if not np.isin(kind,[0,1,2,3]).all(): raise ValueError('Unknown proxy type') cleaned,history=merge_small_regions(kind,edges,length,mass,float(mass.sum()/512)) return dict(raw_regions=region_stats(kind,edges,mass),cleaned_regions=region_stats(cleaned,edges,mass),cleanup=history),cleaned def main(): p=argparse.ArgumentParser();p.add_argument('sample',type=Path);p.add_argument('distance',type=Path);p.add_argument('output',type=Path);p.add_argument('--sample-sha256',required=True);p.add_argument('--distance-sha256',required=True);a=p.parse_args() if a.output.exists(): raise FileExistsError('Preserve prior region preparation') for path,expected in [(a.sample,a.sample_sha256),(a.distance,a.distance_sha256)]: if hashlib.sha256(path.read_bytes()).hexdigest()!=expected: raise ValueError('Cache does not match supplied approved source-pair manifest') start=time.monotonic();data=np.load(a.sample,allow_pickle=False);distance=np.load(a.distance,allow_pickle=False) x=data['points_raw'];edges=data['edges'];mass=data['node_volume_raw'];tet=data['tetra'] if distance.shape!=(len(x),) or not np.isfinite(distance).all() or np.any(distance<0): raise ValueError('Invalid matching distance cache') if tet.ndim!=2 or tet.shape[1]!=4 or tet.min()<0 or tet.max()>=len(x): raise ValueError('Invalid tetra cache') if len(np.unique(tet))!=len(x): raise ValueError('Unused nodes; explicit domain mapping required') volume=np.abs(np.linalg.det(x[tet[:,1:]]-x[tet[:,:1]]))/6 if np.any(volume<=0): raise ValueError('Degenerate tetra cache') expected=np.bincount(tet.ravel(),weights=np.repeat(volume/4,4),minlength=len(x)) if not np.allclose(expected,mass,rtol=1e-10,atol=0): raise ValueError('Cached mass differs from geometry') raw,_,meta=node_tensor(x,tet,mass,distance,graph_from_edges(len(x),edges),steps=3) result,cleaned=clean_table(x,edges,mass,spectral_features(raw)['kind']) result.update(case=a.sample.stem,nodes=len(x),descriptor=meta,wall_seconds=time.monotonic()-start,LP_solves=0,training=False, input_sha256={str(q):hashlib.sha256(q.read_bytes()).hexdigest() for q in [a.sample,a.distance]}, contract=dict(minimum_fraction=1/512,K_floor=8,type_source='Unchanged original 3-hop spectral proxy; not O2-A kernel estimator',seeds='NOT_GENERATED')) with a.output.open('x') as f: json.dump(result,f,indent=2,allow_nan=False) if __name__=='__main__':main()