Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jrudolph/vesuvius-browser

Unofficial Vesuvius Challenge data segment browser
https://github.com/jrudolph/vesuvius-browser

Last synced: 25 days ago
JSON representation

Unofficial Vesuvius Challenge data segment browser

Awesome Lists containing this project

README

        

# Vesuvius Challenge Segment Browser

An unofficial web app to browse segments of the Vesuvius Challenge in a convenient way.

The segment viewer is powered by [openseadragon](https://openseadragon.github.io/). The backend component powered by [Apache Pekko HTTP](https://pekko.apache.org/).

## Features

- Browse segments of the Vesuvius Challenge
- View segment overview with area covered and masks
- Link to the current view of a segment
- Keyboard navigation

## Usage

A public version of the app is hosted at [https://vesuvius.virtual-void.net/](https://vesuvius.virtual-void.net/). To
access it you will need to fill out the official registration form and use the same credentials as for the Vesuvius
Challenge data server.

![demo](docs/demo1.gif)

### Run with docker

Build the docker container:

```
docker build .
```

Run with

```
docker run -p 8089:8089 -v :/data -e APP_HOST=0.0.0.0 -e APP_DATA_USERNAME= -e APP_DATA_PASSWORD=
```

### Run with sbt

Install [sbt](https://scala-sbt.org) or use the included script `sbt` to run the app.

Run

```
reStart --- -Dapp.data-username= -Dapp.data-password=
```

to start the server in the background.

Visit http://localhost:8089/ to access the app.

## Data License

Accessing the data on https://vesuvius.virtual-void.net/ or through this app requires you to fill out the official
form and agree to the terms of the data license. See https://scrollprize.org/data.

## License

Code released under the MPL 2.0. See [LICENSE](LICENSE) for the full license text.