inire/docs/performance.md

2.5 KiB

Performance Baseline

Generated on 2026-03-31 by scripts/record_performance_baseline.py.

The full machine-readable snapshot lives in docs/performance_baseline.json.

Scenario Duration (s) Total Valid Reached Iter Nets Routed Nodes Ray Casts Moves Gen Moves Added Dyn Tree Visibility Builds Congestion Checks Verify Calls
example_01_simple_route 0.0042 1 1 1 1 1 2 22 11 7 2 2 0 3
example_02_congestion_resolution 0.3335 3 3 3 1 3 366 1176 1413 668 8 4 0 35
example_03_locked_paths 0.1810 2 2 2 2 2 191 681 904 307 5 4 0 14
example_04_sbends_and_radii 2.0151 2 2 2 1 2 15 18218 123 65 4 3 0 6
example_05_orientation_stress 0.2438 3 3 3 2 6 286 1243 1624 681 12 3 412 12
example_06_bend_collision_models 4.1636 3 3 3 3 3 240 40530 1026 629 6 6 0 9
example_07_large_scale_routing 1.3759 10 10 10 1 10 78 11151 372 227 20 11 0 30
example_08_custom_bend_geometry 0.2437 2 2 2 2 2 18 2308 78 56 4 4 0 6
example_09_unroutable_best_effort 0.0052 1 0 0 1 1 3 13 16 10 1 0 0 1

Full Counter Set

Each scenario entry in docs/performance_baseline.json records the full RouteMetrics snapshot, including cache, index, congestion, and verification counters.

Tracked metric keys:

nodes_expanded, moves_generated, moves_added, pruned_closed_set, pruned_hard_collision, pruned_cost, route_iterations, nets_routed, nets_reached_target, warm_start_paths_built, warm_start_paths_used, refine_path_calls, timeout_events, move_cache_abs_hits, move_cache_abs_misses, move_cache_rel_hits, move_cache_rel_misses, static_safe_cache_hits, hard_collision_cache_hits, congestion_cache_hits, congestion_cache_misses, dynamic_path_objects_added, dynamic_path_objects_removed, dynamic_tree_rebuilds, dynamic_grid_rebuilds, static_tree_rebuilds, static_raw_tree_rebuilds, static_net_tree_rebuilds, visibility_builds, visibility_corner_pairs_checked, visibility_corner_queries, visibility_corner_hits, visibility_point_queries, visibility_point_cache_hits, visibility_point_cache_misses, ray_cast_calls, ray_cast_candidate_bounds, ray_cast_exact_geometry_checks, congestion_check_calls, congestion_exact_pair_checks, verify_path_report_calls, verify_static_buffer_ops, verify_dynamic_exact_pair_checks