Skip to content

Verification Workflow (NSC-style)

This workflow mirrors NSC concepts (config -> args object -> pipeline -> outputs) for SPANET graph-generation and reconstruction verification.

Run

from spatial_graph_algorithms.verify import VerifyConfig, run_report

cfg = VerifyConfig(
    output_root='.planning/artifacts/verification_runs',
    reconstruct_methods=['mds', 'strnd'],
)

run_report(
    simulation_kwargs={
        'n': 1000,
        'dim': 2,
        'shape': 'circle',
        'mode': 'knn',
        'k': 8,
        'seed': 123,
        'false_edges_number': 100,
    },
    config=cfg,
)

Output Folder

Single run folder contains: - report.csv - degree_distribution.csv - run_parameters.csv - verify_network.png - verify_edge_length_histogram.png - verify_network_3d.png (for 3D runs) - reconstruction_quality.csv (if reconstruction enabled)

Key CSVs

  • run_parameters.csv: full parameter visibility (mode, k, epsilon, seed, etc.)
  • report.csv: graph summary + shortest-path stats + false-edge stats + artifact pointers
  • reconstruction_quality.csv: MDS/STRND quality metrics (cpd, knn_preservation, distortion)