- Rust 92.8%
- Python 6.8%
- C 0.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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. |
||
| .github/workflows | ||
| contrib/git | ||
| docs | ||
| pheon | ||
| src | ||
| tests | ||
| tools | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE.md | ||
| MANIFEST.in | ||
| pyproject.toml | ||
| README.md | ||
| rust-toolchain.toml | ||
| setup.py | ||
| test.py | ||
Pheon
Pheon reads GDSII layouts into Apache Arrow and provides command-line tools for inspecting and comparing layout revisions. It is written in Rust, with Python bindings and a C API.
- Inspect cells, records, and reference hierarchies.
- Compare layout objects, with text or JSON reports and Git integration.
- Read geometry into Arrow, or scan the hierarchy before loading selected cells.
Comparisons ignore timestamps and element order while preserving duplicates and other object details. They compare object fields and coordinates exactly; see the comparison rules for supported normalization and limits.
Try the command-line tools
From a source checkout, install the CLI with Rust 1.88 or newer:
cargo install --path . --locked --bin pheon
pheon dump chip.gds
pheon diff before.gds after.gds
pheon hierarchy chip.gds --format mermaid
diff returns 0 for equality, 1 for differences, and 2 for invalid or incomplete
comparisons. Start with the CLI guide, then set up
Git integration if you review layouts in a repository.
Read layouts in Python
Python 3.11 or newer is required. From a source checkout:
python -m pip install '.[arrow]'
Run Python outside the source checkout to use the installed package:
from pheon import arrow
layout = arrow.read_path("chip.gds")
print(layout.field("cell_names")[0].as_py())
Source installation needs Rust; prebuilt Python wheels bundle the native library. The Python guide covers installation, selected reads, and integer packing. The Arrow reference describes the returned data.
Learn more
Browse the documentation for layer names, native integration, JSON reports, development, and releases. For writing, Pheon provides low-level GDSII record helpers in Rust.
Licensed under GPL-3.0-only.