ucs_collect_sta_qor

递归收集 STA QoR，按 corner 与 setup/hold 汇总 Path Group WNS/TNS/NVP，并生成 Excel 工作簿

Release

UCS-1.0.0 · 2026-07-24

Input

一个或多个 run/report root

Discovery

递归查找文件名以 qor.rpt.gz 结尾的报告

Output

.xlsx 工作簿

License

启动时检查 UCS license；debug level 受 license 限制

1. Quick Start

# 一个 run root
./ucs_collect_sta_qor \
  --input_dir /proj/chip/sta/run_001 \
  --output_file run_001_sta_qor.xlsx

# 多个 root 用逗号分隔，合并到一个 workbook
./ucs_collect_sta_qor \
  --input_dir /proj/chip/sta/run_A,/proj/chip/sta/run_B \
  --slack_less_than -0.10 \
  --output_file compare_sta_qor.xlsx

2. Input 与报告发现

如果扫描范围内没有匹配报告，程序以错误退出而不是生成空 workbook。这样自动流程可以把“没有输入”与“QoR 全部 clean”区分开。

3. QoR 解析与 Slack Threshold

工具识别报告中的 Timing Path Group 'NAME' (max_delay/setup) 和 (min_delay/hold) block，并读取对应 WNS、TNS、NVP。group 名以报告原文为准，不依赖固定列宽，因此报告显示时被截断的其他字段不会造成 group 之间错误合并。

--slack_less_than N 使用严格小于：只有 wns < N 才进入 threshold 结果。默认 0，因此默认收集负 slack violation；WNS 等于 0 不计入。

# 默认：只看负 slack
--slack_less_than 0

# 只关注小于 -0.1 的严重项
--slack_less_than -0.1

# 包含一部分正 margin group
--slack_less_than 0.05

4. Excel Workbook

CLI collector 不接收交互 comment，因此 workbook 中 comment 字段保持空。需要添加 Overall/Group comment、生成 subgroup 或浏览 timing path 时使用 ucs_sta_viewer。

5. Command-Line Reference

Usage: ucs_collect_sta_qor [OPTIONS] --input_dir <DIRS>

      --input_dir <DIRS>          Comma-separated roots [required]
      --slack_less_than <NUMBER>  Strict WNS threshold [default: 0]
      --output_file <XLSX>        [default: ucs_collect_sta_qor.xlsx]
      --debug <0-4>               [default: 0]
  -h, --help
  -V, --version

兼容 -debug N。实际 debug level 不会超过 license 中允许的 max_debug_level。

6. 使用案例

6.1 Nightly STA 汇总

./ucs_collect_sta_qor \
  --input_dir "$STA_RUN_ROOT" \
  --output_file "sta_qor_$(date +%Y%m%d).xlsx"

6.2 两套 run 对比

./ucs_collect_sta_qor \
  --input_dir /proj/run_before/sta,/proj/run_after/sta \
  --slack_less_than 0 \
  --output_file before_after.xlsx

6.3 CI 中检查是否成功生成

if ./ucs_collect_sta_qor --input_dir "$RUN" --output_file qor.xlsx; then
  test -s qor.xlsx
else
  echo "STA QoR collection failed" >&2
  exit 1
fi

7. Troubleshooting