Semantic Field Book Annotator

The Semantic Field Book Annotator is a web application developed for domain experts to harvest structured annotations from field books, drawings and specimen labels of natural history collections. Users can draw bounding boxes over (zoomable) image scans of historical field notes, to which annotations can be attached. All metadata regarding an annotation event, annotation provenance, transcription and semantic interpretation of the text are stored in a knowledge base, which is accessible via a SPARQL endpoint and Web API.

Prerequisites

• Docker CE
• Docker Compose

Software used

• Eclipse RDF4J Server and Workbench
• grlc Web API
• Cantaloupe IIIF image server
• Mirador IIIF image viewer
• Annotorius
• OpenSeadragon

Vocabularies, ontologies & specs used

• Web Annotation Vocabulary
• International Image Interoperability Framework (IIIF)
• Darwin Core (DwC)
• Darwin Semantic Web (Darwin-SW)
• Dublin Core (DC)

Install & deploy

1. Clone this repository.

bash git clone https://github.com/LINNAE-project/SFB-Annotator.git 2. Install Docker Compose.

bash pip install docker-compose

3. Start Docker service(s).

| Service | Port | Docker Image | Description | | ------- | ---- | -------------| ----------- | | sea | 8080 | linnae/sfb-annotator | Semantic Field Book Annotator | | melon | 8182 | linnae/cantaloupe | Cantaloupe image server | | mirador | 8000 | linnae/mirador | Mirador image viewer | | grlc | 8088 | clariah/grlc | Web API (optional)|

```bash cd SFB-Annotator

list available services

docker-compose config --services

start all services or one-by-one

docker-compose up -d # or append [SERVICE] ```

4. Configure service(s).

```bash

populate an empty RDF store (repository)

docker-compose exec sea ./init.sh

configure sea to use a remote image archive (optional)

default: data-local.json

BASEDIR=/usr/local/tomcat/webapps/semanticAnnotator/data/ IMGSRC=remote # default: local docker exec -it sea bash -c "cp $BASEDIR/data-$IMGSRC.json $BASE_DIR/data.json"

configure grlc to use local path (optional)

git clone https://github.com/LINNAE-project/queries docker cp ./queries grlc:/home/grlc/ ```

5. Build Docker image and deploy container locally (development)

```bash docker build -t linnae/sfb-annotator:local . docker run --name sea -d -p 8080:8080 linnae/sfb-annotator:local docker exec sea ./init.sh

generate RDF triples for example inputs (annotation events)

for json in $(ls data/json/$IMG_SRC/*.json | sort) do prefix="$(basename "$json" .json)" suffix=ttl # or jsonld rdf="$prefix.$suffix" ./run.sh "$json" "$rdf" done ```

Web apps & API endpoints

• http://localhost:8080/semanticAnnotator/
  • requires user/password: tomcat/tomcat
  • Register->Save->Collections
• http://localhost:8080/rdf4j-workbench/
  • includes an empty repository: mem-rdf
• http://localhost:8080/rdf4j-server/
• http://localhost:8088/ followed by
  • remote path /api-git/LINNAE-project/queries/ or
  • requires GRLC_GITHUB_ACCESS_TOKEN to be set in docker-compose.yml
  • local path /api-local/
• http://localhost:8182/iiif/2
  • sample image info.json
  • get a JPG version of this TIF image in the archive
• http://localhost:8000 includes an example manifest.json
  • Add Item->Sample Field Book->Change view type to Book View