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.

git clone https://github.com/LINNAE-project/SFB-Annotator.git

2. Install Docker Compose.

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)

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).

# 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
BASE_DIR=/usr/local/tomcat/webapps/semanticAnnotator/data/
IMG_SRC=remote  # default: local
docker exec -it sea bash -c "cp $BASE_DIR/data-$IMG_SRC.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)

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