WALLpy 0.1.0
This is the first public release of WALLpy, a preliminary desktop research application for masonry-image segmentation and archaeological drawing support.
Included
- K-Means segmentation using colour, edge, and local-texture features.
- Optional SAM 2 integration through separately installed backends and weights.
- Morphological and colour-based refinement, manual erasing, and contour review.
- Binary PNG-mask and scaled DXF export.
- Installable Python metadata and the
wallpyconsole command. - Apache-2.0 license, citation metadata, third-party notices, tests, and CI.
Validation
- Tested on Windows with Python 3.11.
- Clean-environment installation and wheel installation verified.
- Seven deterministic unit and smoke tests passed.
- The desktop interface was launched successfully without loading archaeological data.
Important limitations
- Results require expert archaeological review and are not autonomous interpretations.
- The legacy supervised model, datasets, SAM checkpoints, and other model weights are not distributed.
- The optional Ultralytics backend is separately licensed under AGPL-3.0.
- Operating systems other than Windows and Python versions other than 3.11 have not yet been verified.
See the repository README for installation, usage, and troubleshooting instructions.