Geometer
Geometer is a generic C++ geometry library with an executable, Python package, and browser WASM interfaces. It provides STEP conversion, hidden-line projection (HLR), planar geometry, and mesh illustration. Board/domain policy and application rendering decisions belong to callers, not the geometry kernel.
Capabilities And Maturity
| Capability | Use and maturity |
|---|---|
| STEP bounds, GLB conversion, HLR, planar STEP synthesis | Supported geometry APIs. Model bounds has promoted generated contracts; HLR's generated contracts remain pilots. |
| Clipper2 Boolean/offset, planar batch solve and triangulation | Supported polygonized planar workflows; packed interfaces remain handwritten. |
| Fast vector HLR, colored STEP tessellation and mesh illustration | Browser APIs plus direct C++, native IPC, Rust and Python illustration since 2026.9.6; see the STEP-to-SVG guide. Demo applications are evaluation tools, not production renderers. |
| Analytic line/arc planar Boolean | Experimental, not production-ready. May fail closed on valid inputs. Not the dependable whole-board/layer copper-union path; prefer Clipper2 when polygonized output is suitable. |
| Persistent STEP-topology sessions | Experimental native-only subset. Structural declarations do not imply runtime availability. |
Contract promotion and solver production readiness are separate. See contract authority and the analytic decision.
Choose An Interface
| Need | Entry point |
|---|---|
| Keep one executable running; send bytes and receive structured results | Persistent executable IPC: Python, Node/TypeScript and Rust clients |
| Convenient Python file/model operations | Python package |
| File conversion or scripting | CLI commands |
| Geometry in a browser or Worker | WASM and TypeScript clients |
| Embed in native C++ | STEP and planar APIs |
| Manage byte buffers across a foreign-function boundary | C ABI and generic operations |
Not every operation is exposed through IPC. Check the executable's negotiated catalog and the generated operation reference.
Install And Try
Install the Python distribution (import name: geometer):
python -m pip install wn-geometer
geometer --version
Convert a STEP file with the executable-backed Python API:
from pathlib import Path
import geometer
Path("part.glb").write_bytes(geometer.model_to_glb(Path("part.step")))
Wheels bundle the native executable and install a geometer console command.
For persistent processes, use the IPC quick start.
Pin the package version in your application's dependency lock for repeatability.
Source checkouts provide native artifacts under dist/native/<platform>/,
browser WASM under dist/wasm/browser/, and the generated ESM package under
dist/wasm/npm/geometer/. The ESM artifact is not a claim of npm publication.
Documentation And Examples
Browse the generated HTML documentation or use the authored Markdown sources below.
- Interface specifications
- TypeSpec, contract authority and generated reference
- Examples and demo status
- Research and historical evidence
- Requirements and decisions
- Developer setup, builds, tests and releases
- Release notes
Start with the headless Python example or HLR Lab. Analytic and topology demos remain experimental; retention does not imply production support. See the demo audit for verification limits.
Contributing And License
See the developer guide for native/WASM builds and required release checks.
OCCT is generated dependency state under .deps/; documentation work does
not require rebuilding it. Releases follow
date-based versioning.
MIT. See LICENSE.
1 maintainer
Release files for wn-geometer 2026.9.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| wn_geometer-2026.9.11-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| wn_geometer-2026.9.11-py3-none-manylinux_2_35_x86_64.whl | Python 3 | none | Linux glibc 2.35+ x86-64 | Details |
| wn_geometer-2026.9.11-py3-none-manylinux_2_35_aarch64.whl | Python 3 | none | Linux glibc 2.35+ ARM64 | Details |
| wn_geometer-2026.9.11-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 52.7 MB
Release files / wn_geometer-2026.9.11-py3-none-win_amd64.whl
| Download URL | wn_geometer-2026.9.11-py3-none-win_amd64.whl |
|---|---|
| Size | 8.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
37682b6f40ce725093fbc5c666f4974acfe4423a12d4abb43d965d599fc8f200
|
|
BLAKE2b-256 checksum How to use checksums |
9570608a1c623114016a55c54dd028008299858143e74d541a8f022dbc9061cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency logRelease files / wn_geometer-2026.9.11-py3-none-manylinux_2_35_x86_64.whl
| Download URL | wn_geometer-2026.9.11-py3-none-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 16.3 MB |
| Tags | Linux glibc 2.35+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
4ceccaeb300a1590a86db7653322efc5adc3e5bf7e2095077578a3bf19e4ef98
|
|
BLAKE2b-256 checksum How to use checksums |
f5580b3610335d53ef0dd836232be71d36fd85bd206627ae14b756ce97fb7a59
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency logRelease files / wn_geometer-2026.9.11-py3-none-manylinux_2_35_aarch64.whl
| Download URL | wn_geometer-2026.9.11-py3-none-manylinux_2_35_aarch64.whl |
|---|---|
| Size | 15.5 MB |
| Tags | Linux glibc 2.35+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
9e69c5b445c67ff13167ea7363b37bcf6068411c080106ec3a4d956008826a8b
|
|
BLAKE2b-256 checksum How to use checksums |
c33a219f86728b0347b9a5d4a44582f5bce7db3c8e2da98e0f403d13060373f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency logRelease files / wn_geometer-2026.9.11-py3-none-macosx_11_0_arm64.whl
| Download URL | wn_geometer-2026.9.11-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.2 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f0c7ecd80c52537bb0a8f8abdc69ba012f3a3eddd588081b6b88e6d7235547e4
|
|
BLAKE2b-256 checksum How to use checksums |
41645e55b577d76bf4533905810279d021677e5e8d67953c6617cea91e3b8817
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency log
