Share GDSII reader logic and simplify review output
Share record framing, name decoding, payload validation, array reference decoding, and Arrow cell-header parsing. Accept trailing NUL padding in names and retain located diagnostics for malformed records. Summarize text diffs by cell, layer, and reference target. Show comparison and omission counts before detail. Compact canonical dumps while preserving exact fields and duplicate counts for Git textconv. Simplify hierarchy output and retain per-object evidence in JSON.
This commit is contained in:
parent
d95c378690
commit
15e8a3b7b5
1 changed files with 1717 additions and 828 deletions
30
docs/cli.md
30
docs/cli.md
|
|
@ -28,10 +28,15 @@ pheon hierarchy chip.gds --format ascii --depth 4
|
|||
pheon hierarchy chip.gds --format mermaid --top CHIP
|
||||
```
|
||||
|
||||
`dump` shows a normalized layout description. Add `--records` to inspect raw
|
||||
records, including timestamps. `hierarchy` shows cell references without
|
||||
expanding array placements. Shared cells are marked rather than repeated
|
||||
indefinitely. Mermaid output is diagram source for a Mermaid renderer.
|
||||
`dump` lists objects by cell. A prefix such as `3x` counts copies of the same
|
||||
normalized object within a cell. Coordinates are in database units. Rectangles
|
||||
show two corners, and longer vertex lists wrap across lines. References show
|
||||
the target and any array dimensions before the coordinates. Add `--records`
|
||||
to inspect the original record sequence, including timestamps.
|
||||
|
||||
`hierarchy` shows direct placement counts on references. Shared cells are
|
||||
marked where their contents appear earlier in the tree. Mermaid output is
|
||||
diagram source for a Mermaid renderer.
|
||||
|
||||
## Compare revisions
|
||||
|
||||
|
|
@ -41,10 +46,13 @@ pheon diff before.gds after.gds --hierarchy ascii --max-changes 20
|
|||
pheon diff before.gds after.gds --format json > report.json
|
||||
```
|
||||
|
||||
Text reports group changes by cell. A `-` line shows an object from the old file
|
||||
and a `+` line shows one from the new file. A `~` line explains a likely
|
||||
replacement when Pheon can pair the two uniquely. Request a hierarchy view to
|
||||
see which parent cells are affected.
|
||||
Text reports start with the result and group changes by cell. Added and removed
|
||||
cell headings give the object count within the comparison scope. Each layer
|
||||
lists counts of rectangles, polygons, and boxes changed, moved, added, or removed.
|
||||
Added or removed cells also count references by target.
|
||||
Other objects use `-` for removals, `+` for additions, and `~` for likely
|
||||
replacements. Use `--format json` for details of individual objects and
|
||||
`--hierarchy` to see which parent cells are affected.
|
||||
|
||||
| Exit code | Meaning |
|
||||
| --- | --- |
|
||||
|
|
@ -86,8 +94,10 @@ pheon diff before.gds after.gds --hierarchy mermaid --depth 4
|
|||
|
||||
`--show-cell` and `--show-layer` filter displayed changes without changing the
|
||||
comparison, totals, or exit status. A layer display filter hides references
|
||||
without a numeric layer. `--max-changes N` limits displayed object occurrences;
|
||||
JSON includes all changed objects unless this limit is explicit.
|
||||
without a numeric layer. `--max-changes N` limits displayed object occurrences.
|
||||
A paired replacement uses two occurrences. The text report counts omissions
|
||||
from filters and limits before listing cell changes. JSON includes all changed
|
||||
objects unless the limit is explicit.
|
||||
|
||||
The diff hierarchy marks directly changed cells, affected ancestors, and
|
||||
unchanged targets of modified references. It includes references from both
|
||||
|
|
|
|||
Loading…
Reference in a new issue