Parse Liberty once. Use every corner.

发布版本

Python 与 Rust 的源程序和编译版本都会保留；默认交付和网页示例以 Rust 为准。

两种实现使用相同 CLI 和 JSON schema。Rust 版已按 Python 行为进行单 corner、merged、parallel、gzip 和 enrichment 差分验证。

Quick start

选择与系统匹配的 Rust 文件，把有效许可证放在程序旁边或上级目录，然后解析一个 corner。

chmod +x ucs_lib_parser
./ucs_lib_parser \
  --corner ss_0p72v_125c \
  --libs "/proj/lib/ss/*.lib.gz" \
  --output ss_0p72v_125c.json

多个 --libs pattern 可以在同一次运行中给出；匹配到的文件按名称排序后解析。

Multi-corner config

Config mode 支持 sequential、local parallel 和 LSF backend。

{
  "output_dir": "./cell_data",
  "technology": "tsmc_n3c",
  "cell_attr_file": "./cell_attributes.json",
  "corners": [
    {
      "name": "ss_0p72v_125c",
      "libs": ["/proj/lib/ss/*.lib", "/proj/lib/ss/*.lib.gz"]
    },
    {
      "name": "ff_0p88v_m40c",
      "libs": "/proj/lib/ff/*.lib.gz"
    }
  ]
}

# 每个 corner 一个 JSON
./ucs_lib_parser --config gen_config.json --parallel 8

# 所有 corner 合并为一个 JSON
./ucs_lib_parser --config gen_config.json --merged \
  --output all_corners.json

# LSF；--parallel 限制同时运行的 job 数
./ucs_lib_parser --config gen_config.json \
  --lsf "bsub -q normal" --parallel 20

Cell attributes

Delay 由 Liberty 直接解析；cell metadata 可以来自 PrimeTime dump，也可以从 cell name 推导。

ucs_lib_parser 不替代 PrimeTime attribute dump：前者解析 Liberty timing，后者取得 PrimeTime 已加载库中的 cell 属性；两者共同准备 Smart Fix 输入。Samsung P57 命名族应在 PrimeTime 中使用 ucs_dump_lib_cells -tech samsung_p57 生成 Mode A JSON。

Command line

Output

Per-corner

{
  "meta": {
    "corner": "ss_0p72v_125c",
    "generated": "2026-07-25 17:00:00",
    "total_cells": 120000,
    "total_arcs": 840000
  },
  "cells": {
    "BUFFD4": {
      "area": 1.2,
      "arcs": []
    }
  }
}

Merged

{
  "corners": {
    "ss_0p72v_125c": { "cells": {} },
    "ff_0p88v_m40c": { "cells": {} }
  }
}

Parsing behavior

• 解析前移除 Liberty block comment 和 line comment。
• 跳过 dont_use : true 或 is_macro_cell : true 的 cell。
• 保留 combinational timing arc；缺失 timing_type 时按 combinational 处理。
• Pin direction 不区分大小写，并接受 input/in 与 output/out。
• 忽略空 related_pin、sequential arc，以及没有可用 rise/fall table 的 cell。
• 相同 output/input pin pair 出现多个 conditional arc 时，以第一项 rise-table value 选择 worst arc。
• 多个 Liberty 文件定义同名 cell 时，后解析的文件覆盖前一项。
• Drive resistance 使用最小 input slew 对应 transition row，在完整 output capacitance 范围上计算 slope。

License & runtime