Spaces:
Running
Running
| title: Segment Lens | |
| emoji: 🧭 | |
| colorFrom: gray | |
| colorTo: blue | |
| sdk: gradio | |
| sdk_version: 6.28.0 | |
| python_version: "3.12" | |
| app_file: app.py | |
| pinned: false | |
| license: apache-2.0 | |
| short_description: Every published Herculaneum segment, measured, in 3D | |
| tags: | |
| - vesuvius-challenge | |
| - herculaneum | |
| - tifxyz | |
| - segmentation | |
| - three.js | |
| datasets: | |
| - SharpMeow/vesuvius-segment-atlas | |
| # Segment Lens | |
| The Vesuvius Challenge open data publishes hundreds of traced segments: pieces of the rolled papyrus surface, | |
| each a grid of 3D points (a tifxyz mesh). Segment Lens shows them as surfaces you can turn, with the grid's | |
| problems painted on: **holes** inside the sheet (blue rims), **folds** where the surface turns back on itself | |
| (red) and **over-stretched** grid edges (orange). Beside each one are the numbers from the | |
| [Segment Atlas](https://huggingface.co/datasets/SharpMeow/vesuvius-segment-atlas): area in cm2, filled share, | |
| how close the grid is to isometric, and the area of each problem in mm2. | |
| - **3D** is for scans on none of the prize lists (the public media rule of | |
| [ChaseHendrick/Scrolls](https://github.com/ChaseHendrick/Scrolls/blob/main/docs/media/README.md)). | |
| Scrolls on a prize list appear in the table with their numbers only. | |
| - **Table** lists every mesh in the atlas, sortable, with a link to its folder on the open-data bucket and the | |
| `kit tifxyz check` command that reproduces its numbers on your own machine. | |
| What it shows is geometry only: no CT, no ink, and nothing here judges whether a segment stays on one sheet of | |
| papyrus. The previews keep every k-th grid node (at most 256 per side), so a small flag can look larger than it is; | |
| the numbers come from the full grid. | |
| ## For agents and scripts | |
| The same atlas is an API and an MCP server at [/agents/](https://sharpmeow-segment-lens.hf.space/agents/): | |
| `list_scrolls`, `list_segments`, `get_segment` and `segment_picture` (a picture of one mesh with its flags painted | |
| on). MCP: add `https://sharpmeow-segment-lens.hf.space/agents/gradio_api/mcp/`. Python: | |
| ```python | |
| from gradio_client import Client | |
| c = Client("https://sharpmeow-segment-lens.hf.space/agents/") | |
| top = c.predict("PHerc0139", "area_cm2", 5, True, api_name="/list_segments") | |
| seg = c.predict(top["segments"][0]["id"], api_name="/get_segment") | |
| picture, info = c.predict(seg["id"], "3d", 30, 20, api_name="/segment_picture") | |
| ``` | |
| Data: Vesuvius Challenge open data, CC BY-NC 4.0, via the Segment Atlas (same license). Code: Apache 2.0, | |
| by Chase Hendrick. three.js is MIT. | |