2026-11-16 16:51:41 -08:00
|
|
|
# Layer names
|
|
|
|
|
|
|
|
|
|
Attach readable names to numeric GDSII layer/type pairs so Pheon can show a
|
|
|
|
|
legend in comparison reports. Names are annotations; geometry keeps its numeric
|
|
|
|
|
layer assignments.
|
|
|
|
|
|
|
|
|
|
## Add or update names
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
pheon name-layers chip.gds named.gds --cell CHIP --carrier 900/7 \
|
|
|
|
|
--name 1:0:WG --name 2:0:METAL
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Choose an existing cell and an otherwise unused `(layer, texttype)` pair in that
|
|
|
|
|
cell as the carrier. The carrier must contain no ordinary design objects.
|
|
|
|
|
The output path must be new; Pheon refuses to overwrite any existing file,
|
|
|
|
|
including the input.
|
|
|
|
|
|
2026-11-17 16:14:53 -08:00
|
|
|
The output is uncompressed GDSII, including when the input is gzip-compressed.
|
|
|
|
|
|
2026-11-16 16:51:41 -08:00
|
|
|
The command consolidates the legend into that cell. Existing mappings remain
|
|
|
|
|
unless you override them with `--name`. It creates no cells or references, and
|
|
|
|
|
copies other records, timestamps, unknown records, and trailing padding byte for
|
|
|
|
|
byte. Input and annotation validation finish before the output is created.
|
|
|
|
|
|
|
|
|
|
## Annotation format
|
|
|
|
|
|
Make Pheon structural review results self-contained
Capture revision metadata, cell presence and attributes, and structured
diagnostics in owned comparison results. Derive outcomes and render text,
JSON, and hierarchy reports without retaining source documents. Keep derived
descriptions and graph analysis in their renderers.
Use pheon-structural-v1 and PHEON_LAYER_NAMES_V1 consistently, expose helpers
through their defining modules, and remove obsolete re-exports. Update user
guides and report fixtures without changing schema version 1.
Cover dropped inputs, diagnostic ordering, absent and empty cells, offset
independence, and CLI failures. All 92 Rust tests pass in debug and release;
report and hierarchy goldens retain their behavior.
2026-11-16 20:45:06 -08:00
|
|
|
A text label whose exact string is `PHEON_LAYER_NAMES_V1` identifies a carrier
|
2026-11-16 16:51:41 -08:00
|
|
|
pair in its cell. Every other text label on that pair in the same cell is a
|
|
|
|
|
mapping of the form:
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
layer:datatype:name
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
For example, `1:0:WG` names pair `(1, 0)` as WG. Numbers are unsigned 16-bit
|
|
|
|
|
decimals. The name must be nonempty UTF-8 and may contain colons; only the first
|
Make Pheon structural review results self-contained
Capture revision metadata, cell presence and attributes, and structured
diagnostics in owned comparison results. Derive outcomes and render text,
JSON, and hierarchy reports without retaining source documents. Keep derived
descriptions and graph analysis in their renderers.
Use pheon-structural-v1 and PHEON_LAYER_NAMES_V1 consistently, expose helpers
through their defining modules, and remove obsolete re-exports. Update user
guides and report fixtures without changing schema version 1.
Cover dropped inputs, diagnostic ordering, absent and empty cells, offset
independence, and CLI failures. All 92 Rust tests pass in debug and release;
report and hierarchy goldens retain their behavior.
2026-11-16 20:45:06 -08:00
|
|
|
two colons separate fields.
|
2026-11-16 16:51:41 -08:00
|
|
|
|
|
|
|
|
Mappings are collected across the library. Identical duplicates are accepted;
|
|
|
|
|
conflicting names for the same pair are errors. Recognized annotation labels
|
|
|
|
|
are excluded from ordinary object comparison. The name mapping compares
|
|
|
|
|
separately, while unchanged names remain available in the report legend.
|
|
|
|
|
|
|
|
|
|
Pheon does not currently read LayoutEditor LayerNames metadata, extract layers,
|
|
|
|
|
or remap geometry. See the [CLI guide](cli.md) for layer selection during review.
|