Simplify and speed up GDSII diffs
Summarize added and removed cells, group references, and keep replacement pairs together at text display limits. Trim hierarchy labels and summarize long unmatched paths. Stream JSON object evidence and reduce parsing and comparison allocations. Parse large revisions concurrently and adaptively reuse matching cell bodies when most of the layout is shared.
This commit is contained in:
parent
15e8a3b7b5
commit
8efeb04aab
1 changed files with 1137 additions and 261 deletions
35
docs/cli.md
35
docs/cli.md
|
|
@ -46,13 +46,18 @@ pheon diff before.gds after.gds --hierarchy ascii --max-changes 20
|
|||
pheon diff before.gds after.gds --format json > report.json
|
||||
```
|
||||
|
||||
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.
|
||||
Text reports start with the result and counts of modified, added, and removed
|
||||
cells. Added and removed cells show their object counts and group references by
|
||||
target. Modified cells show counts of rectangles, polygons, and boxes changed,
|
||||
moved, added, or removed on each layer. Repeated reference additions or removals
|
||||
to the same target also appear as a count. Object details use `-` for removals,
|
||||
`+` for additions, and `~` for likely replacements. Unmatched paths with five
|
||||
or more vertices show their width, vertex count, and vertex bounds in one line.
|
||||
Use `--format json` for details of individual objects and `--hierarchy` to see
|
||||
which parent cells are affected.
|
||||
|
||||
For large unscoped diffs with substantial byte overlap, Pheon reuses parsed
|
||||
contents of matching cells. Cell timestamps and file offsets can differ.
|
||||
|
||||
| Exit code | Meaning |
|
||||
| --- | --- |
|
||||
|
|
@ -95,14 +100,16 @@ 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.
|
||||
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.
|
||||
Text shows a replacement only when both objects fit within the limit.
|
||||
A single omission line lists changes hidden by filters or the limit. 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
|
||||
revisions so removed branches remain visible. Counts represent direct placements;
|
||||
arrays remain symbolic. `--depth` limits text diagrams. For a complete graph in
|
||||
The diff hierarchy shows directly changed cells, affected ancestors, and targets
|
||||
of modified references. It includes references from both revisions so removed
|
||||
branches remain visible. Counts represent direct placements;
|
||||
arrays remain symbolic. ASCII omits the section when there are no cell changes
|
||||
and marks reference changes whose placement count stays the same.
|
||||
`--depth` limits text diagrams. For a complete graph in
|
||||
JSON, use `--format json --hierarchy graph`; text depth and display filters do
|
||||
not trim that graph.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue