paris4-ink-map / README.md
SharpMeow's picture
Paris 4 Ink Map 1.2: 3D scroll, neighboring turns, VC3D project, saved views
d3405a2 verified
|
Raw History Blame Contribute Delete
2.46 kB
metadata
title: Paris 4 Ink Map
emoji: 🌀
colorFrom: yellow
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
license: apache-2.0
short_description: Whole-scroll Paris 4 ink map with zoom, stream, API and MCP
tags:
  - vesuvius-challenge
  - herculaneum
  - ink-detection
  - mcp-server
  - ome-zarr

Paris 4 Ink Map

The Vesuvius Challenge organizers' ink map of the whole of PHerc. Paris 4 (segment 20260926044226-spiral-output-generation-19, ink model student-v12A-25000), streamed as deep-zoom tiles: a whole-scroll strip, a winding overlay, a scroll map that draws the spiral at any height over the live CT, a readout of winding, distance and scan voxel under the pointer, measuring, bookmarks, and downloads of any view, or the whole map at full resolution, as PNG or raw TIFF. Tools can stream it as OME-Zarr (/zarr/, zarr v2, 9 levels) or Deep Zoom tiles, call the HTTP API (/api, docs at /docs) or connect an agent to the MCP server (/mcp). Every endpoint is open to other origins and needs no account. A 3D view shows the fit as it sits in the scan and unrolls it into the flat sheet; a Neighboring Turns panel sets a place beside the papyrus just outside and inside it, with how alike their ink is against the same two turns elsewhere; and /api/vc3d.zip is a ready project for villa's VC3D (the CT streamed from the open data, the fit as a segment). Views save as PNG with a scale bar, and bookmarks export, import and travel in a link. The fit covers scan heights 38.4 to 170.4 mm only, so papyrus above or below that, including the top line of the columns, is not in this map. An ink map is model output, not a reading.

app.py downloads the public files from the open data once at start (about 1.1 GB, SHA-256 recorded), builds the tile pyramid in memory and serves the page and the API (see CONNECT.md); p4_mcp.py is the MCP server at /mcp. The CT is read live, one 16 KB plane of a chunk at a time, from the open-data bucket. The Space holds no keys and copies no data into its repository.

  • Data: Vesuvius Challenge open data, CC BY-NC 4.0. The ink map, the spiral fit (run in VC3D's spiral workspace, notes in the segment's FIT_NOTES.md) and the CT are the organizers'; this page links them and never rehosts them.
  • Viewer: OpenSeadragon 4.1.0 (BSD-3-Clause) and three.js r128 (MIT), loaded from cdnjs.
  • Page code: Apache-2.0.