Skip to content

grt: add CUGR global_route_debug -st visualization support#10121

Open
hansb21 wants to merge 1 commit intoThe-OpenROAD-Project:masterfrom
hansb21:hans-debug-cugr
Open

grt: add CUGR global_route_debug -st visualization support#10121
hansb21 wants to merge 1 commit intoThe-OpenROAD-Project:masterfrom
hansb21:hans-debug-cugr

Conversation

@hansb21
Copy link
Copy Markdown

@hansb21 hansb21 commented Apr 12, 2026

Summary

This PR adds global_route_debug -st visualization support for
CUGR, aligned with the existing FastRoute debug flow in GUI.

Main updates:

  • Enabled global_route_debug -st when running with global_route -use_cugr.
  • Implemented CUGR debug infrastructure
  • Added the debug visualization trigger during CUGR Stage 1
    (pattern routing).

Type of Change

  • New feature

Impact

Users can now visualize the Stage-1 Steiner tree for CUGR in GUI
using:

  1. global_route_debug -net <net_name> -st
  2. global_route -use_cugr

FastRoute debug behavior remains available.

Verification

  • I have verified that the local build succeeds
    (./etc/Build.sh).
  • I have run the relevant tests and they pass.
  • My code follows the repository's formatting guidelines.
  • I have signed my commits (DCO).

Visual Evidence

Visual Evidence

FastRoute (global_route_debug -net "net1707" -st + global_route)

debug-fr

CUGR (global_route_debug -net "net1707" -st + global_route -use_cugr)

debug-cugr

Related Issues

N/A

Copy link
Copy Markdown
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Welcome to OpenROAD! Thanks for opening your first PR.
Before we review:

Please ensure:

  • CI passes
  • Code is properly formatted
  • Tests are included where applicable
    A maintainer will review shortly!

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces comprehensive debugging and visualization support for the CUGR global router, bringing it to parity with the FastRoute debug interface. Changes include new debug initialization and retrieval methods in the GlobalRouter class, updates to the SWIG interface files, and the implementation of Steiner tree visualization routines within the CUGR engine. The review feedback identifies several critical improvements: addressing potential dangling pointers by clearing the renderer after use, replacing hardcoded magic numbers with design-specific values for net properties, and refactoring duplicated FrNet initialization logic into a shared helper function.

Signed-off-by: Hans Buss <hans.buss@mailfence.com>
@eder-matheus eder-matheus self-requested a review April 13, 2026 01:38
@eder-matheus eder-matheus added the grt Global Routing label Apr 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

grt Global Routing size/XL

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants