Skip to content

README.md

Latest commit

 

History

History
174 lines (122 loc) · 3.53 KB

README.md

File metadata and controls

174 lines (122 loc) · 3.53 KB

WORK/scripts

Small utility scripts used in the alchip/WORK repo.

Requirements

  • Python 3.9+ (both scripts are python3)

Scripts

1) pt_summary_from_rpt.py

Generate a wo_io.rpt.summary-style summary from a PrimeTime timing report.

Input

  • Plain text PT report
  • Or gzipped report (.gz)

It is tailored to reports similar to PrimeTime report_timing -nosplit ... output, where each path block contains:

  • Startpoint:
  • Endpoint:
  • Path Group:
  • Point table
  • data arrival time
  • slack ... <value>

Basic usage

./pt_summary_from_rpt.py /path/to/wo_io.rpt.gz -o /path/to/out.summary

Block mapping (optional)

By default, the script uses the first hierarchy token as the “block” name. You can override this with longest-prefix mapping.

Mapping file format (one per line):

# prefix -> block_name
m_misc/m_max_buf/ -> m_max_buf
m_misc/m_abuf/    -> m_abuf

Run with mapping file(s):

./pt_summary_from_rpt.py /path/to/wo_io.rpt.gz \
  --block-map-file /path/to/block_map.txt \
  -o /path/to/out.summary

Other options:

  • --block-map prefix=name (repeatable)
  • --range-groups reg2reg,reg2cgate (comma-separated)

2) tcl_to_cfg.py

Convert simple Tcl list-style variable definitions into .cfg format.

Supported input pattern

set liblist(LEF_STD) [list \
    /path/a \
    /path/b] ;

Output pattern

[liblist]
# Author: sunnyy@alchip.com
# Created: YYYY-MM-DD

LEF_STD       = /path/a
                /path/b

Usage

# Print to stdout
./tcl_to_cfg.py input.tcl

# Write to file
./tcl_to_cfg.py input.tcl -o output.cfg

Common options:

  • --section liblist (section header name)
  • --author sunnyy@alchip.com
  • --created 2026-02-12
  • --name-width 12
  • --indent-width 16

Quick wrapper

run_examples.sh

A tiny convenience wrapper to run common flows without remembering full commands.

# PT summary
./run_examples.sh pt /path/to/wo_io.rpt.gz
./run_examples.sh pt /path/to/wo_io.rpt.gz /tmp/out.summary

# Tcl -> cfg
./run_examples.sh tcl /path/to/input.tcl
./run_examples.sh tcl /path/to/input.tcl /tmp/output.cfg

3) innovus_tarpt_to_sum.py

Generate .sum from Innovus timing report (.tarpt.gz / text).

Current output sections

  • timing slack
  • stage count
  • path group
  • ends block
  • clock group
  • detail timing path

Scenario

  • scenario: is taken from report line Analysis View: ...

Default block naming

  • start_point_block: if pin has no hierarchy (/) -> INPUT
  • end_point_block: if pin has no hierarchy (/) -> OUTPUT

Block mapping (optional, longest-prefix match)

python3 ./innovus_tarpt_to_sum.py /path/to/place_reg2reg.tarpt.gz \
  --block-map-file ./block_map.example.txt \
  -o /path/to/place_reg2reg.sum

Supported mapping options:

  • --block-map prefix=name (repeatable)
  • --block-map-file <file> (repeatable, line format: prefix -> name)

4) gen_summaries.csh (tcsh)

Batch-generate summary for all *.tarpt.gz under a directory.

./gen_summaries.csh -path /Users/sunny/WORK/tmp

This generates same-name outputs:

  • xxx.tarpt.gz -> xxx.sum

Optional:

# custom suffix
./gen_summaries.csh -path /Users/sunny/WORK/tmp -suffix .clock.new.sum

# with block map file
./gen_summaries.csh -path /Users/sunny/WORK/tmp \
  -block_map_file ./block_map.example.txt

Notes

  • If you want to run without chmod +x, use python3 script.py ....
  • Keep repo-specific / proprietary examples out of the README; use paths/placeholders.