vesuvius-topogeo
Here, you’ll find a notebook analyzing the topology and geometry of the
fragments and scroll segments for the Vesuvius Challenge. The mesh analysis notebook can be
found under the notebooks directory. It’s best viewed using GitHub pages (see
notebook here) or nbviewer (see notebook on nbviewer here) in order for the interactive plotly
graphs to display properly.
Getting started
If you’d like to run the notebook, you’ll first have to download the dependencies and ensure the mesh data is in the expected place.
Installation
You can install requirements by running:
pip install -r requirements.txt
Data directory structure
The following structure is required in order to load the mesh data:
path/to/scroll/data
│
└───1
│ │
│ └───<segment id>
│ └───<segment id>.obj
│
└───2
│
└───<segment id>
└───<segment id>.obj
path/to/fragment/data
│
├───1
│ └───result.obj
├───2
│ └───result.obj
└───3
└───result.obj
The path/to/scroll/data and path/to/fragment/data default to data/fragments and data/scrolls respectively. The
data directory can be changed with the environment variable DATA_DIR.
Downloading data
If you don’t have the mesh data, you can download it after you have registered for the
Vesuvius Challenge (see data agreement here).
This will give you the username and password that you’ll need for the next step. You must set the environment variables
USER and PASS. You can create an .env file (see .env.example for an example) and fill it out. You’d then have to
set the environment variables, which can be done as such in a Linux shell:
export $(grep -v '^#' .env | tr -d '\r' | xargs)
Under the scripts directory, there is one script for downloading the scroll mesh data and another for downloading
the fragment mesh data. They rely on rclone, so please download it from
here.
To download all fragment (1, 2, and 3) mesh data (only .obj files) you can run the script:
./scripts/download-fragment-mesh-data.sh 1 2 3
To download all scroll mesh data (only .obj files from scrolls 1 and 2) you can run the script:
./scripts/download-scroll-mesh-data.sh 1 2
The default download directory will be data, but this can be changed by setting the DATA_DIR environment variable.
References
Parsons, S., Parker, C. S., Chapman, C., Hayashida, M., & Seales, W. B. (2023). EduceLab-Scrolls: Verifiable Recovery of Text from Herculaneum Papyri using X-ray CT. arXiv preprint arXiv:2304.02084.