grt: change 'overflow' to 'congestion'#10410
Merged
eder-matheus merged 4 commits intoMay 14, 2026
Merged
Conversation
Signed-off-by: Eder Monteiro <emrmonteiro@precisioninno.com>
Signed-off-by: Eder Monteiro <emrmonteiro@precisioninno.com>
Signed-off-by: Eder Monteiro <emrmonteiro@precisioninno.com>
Contributor
There was a problem hiding this comment.
Code Review
This pull request implements a consistent terminology update by renaming "overflow" to "congestion" across the Global Router (grt) module. The changes span documentation, source code logging, report formatting, and test expectations. I have no feedback to provide as there were no review comments to assess.
Contributor
|
clang-tidy review says "All clean, LGTM! 👍" |
…ROAD into grt_cugr_reports_rename Signed-off-by: Eder Monteiro <emrmonteiro@precisioninno.com>
Contributor
|
clang-tidy review says "All clean, LGTM! 👍" |
jfgava
approved these changes
May 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Renames every report
overflowlog/column/marker/comment tocongestionacross GRT so the vocabulary is consistent between FastRoute and CUGR. Internal C++ symbols (total_overflow_,getTotalOverflowPerLayer(), etc.) and the stable telemetry metric key (global_route__fastroute__overflow_iterations_s) are intentionally preserved.What changes:
FastRoute.cpp,maze.cpp,utility.cpp) —Running extra iterations to remove overflow.→... congestion; the iteration timer label, the GRT-0103 debug header, GRT-0107, the GRT-0230 warning, theRST Tree before overflow iterations/Tree 2D after overflow iterationsdebug prints, and allMax/Final/Total H/V overflowdebug lines. Thecongestion_report_fileCSV column header and theTotal overflow:line in that file are renamed.capacity:N usage:M overflow:K→capacity:N usage:M congestion:K.CUGR.cpp) —Nets with overflow:→Nets with congestion:,Total overflow:→Total congestion:, and the per-3D-edge marker comment'soverflow:K (...)→congestion:K (...).GlobalRouter.cpp) — GRT-0096 final-report column headerTotal Overflow→Total Congestion.src/grt/README.md,GlobalRouter.tcl) —-congestion_iterations/-tree2Ddescriptions updated to match..okfiles and 3.rptokfiles refreshed to reflect the renamed strings. Thecongestion_markers_cugr.tcltest's regex and comment also updated to expectcongestion:in the marker comment.Type of Change
Impact
Max H / Max V / Total Congestion.dbMarkercomments produced by both engines readcapacity:N usage:M congestion:K (...). The DRC viewer / web inspector pass marker comments through verbatim, and no in-tree tool parses them, so this is a string-level change with no functional impact in the codebase. Downstream scripts (outside this repo) that parse the renamed strings would need to be updated.congestion_report_file <file>.rptoutput CSV column changed fromoverflowtocongestion; the trailing total line changed fromTotal overflow:toTotal congestion:.global_route__fastroute__overflow_iterations_sis unchanged so ORFS / dashboard plumbing is not affected.Verification
./etc/Build.sh).