README.md

---
license: apache-2.0
---

# SAM 2 – Photogrammetry Segmentation (Scroll & Ruler)

Fine-tuned checkpoints of [SAM 2.1](https://github.com/facebookresearch/sam2) (hiera-tiny),
for segmenting the papyrus scroll (and, where present, a calibration ruler) in photogrammetry
photos of the Herculaneum papyri. Produced by fine-tuning the prompt encoder and mask decoder
of SAM 2.1 on a dataset of scroll/mask image pairs.

Code: https://github.com/ScrollPrize/villa/tree/main/foundation/sam2-photogrammetry

## Checkpoints

| File | Description |
|---|---|
| `photo2_ruler_t_1000.torch` | For photogrammetry captures that include a calibration ruler in frame — segments both scroll and ruler. 1000 training iterations. |
| `photo2_t_5000.torch` | For photogrammetry captures with no ruler in frame — segments scroll only. 5000 training iterations. |

## Usage

See the [sam2-photogrammetry README](https://github.com/ScrollPrize/villa/tree/main/foundation/sam2-photogrammetry)
for full setup instructions. To fetch a checkpoint directly:

```bash
wget https://huggingface.co/scrollprize/sam2-photogrammetry/resolve/main/photo2_ruler_t_1000.torch -P checkpoints/
```

## License

Apache 2.0, matching the parent [SAM 2](https://github.com/facebookresearch/sam2) repository.