https://github.com/dataoneorg/annotator
DataONE Annotation service provides functions for linking OWL concepts to DataONE data.
https://github.com/dataoneorg/annotator
Last synced: over 1 year ago
JSON representation
DataONE Annotation service provides functions for linking OWL concepts to DataONE data.
- Host: GitHub
- URL: https://github.com/dataoneorg/annotator
- Owner: DataONEorg
- License: apache-2.0
- Created: 2014-12-17T02:43:09.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-03-30T21:50:12.000Z (about 9 years ago)
- Last Synced: 2025-01-30T21:17:24.326Z (over 1 year ago)
- Language: Java
- Size: 209 KB
- Stars: 1
- Watchers: 30
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
annotator
=========
Annotation services and utilities for the DataONE project.
Design documentation is in the [sem-prov-design](https://github.com/DataONEorg/sem-prov-design) repository.
AnnotatorJS REST
----------------
This project includes an implementation of the AnnotatorJS REST API for saving, searching, and retrieving annotations that are ultimately stored
in a DataONE Member Node. The project should be included in a separate Maven webapp project that initializes and defines the paths
to the AnnotatorRestServlet. The `annotator.nodeid` field in the annotator.properties file defines which MN will serve as the storage repository
for annotations. Note that the MN needs to be registered in the same environment as defined by `D1Client.CN_URL` property.
A sample web.xml entry for enabling the servlet:
annotatorStoreRestServlet
org.dataone.annotator.store.AnnotatorRestServlet
annotatorStoreRestServlet
/annotator/*
For details on the AnnotatorJS API, see [their documentation page](http://docs.annotatorjs.org/en/v1.2.x/storage.html)
Annotation Generation
---------------------
This project also includes a command-line utility for generating annotations based on recommendations from various "matcher" services.
These include: Bioportal, ESOR, and the newer ESOR Cosine service. There is also a "matcher" that relies only on manually provided annotations
from a spreadsheet (no external service is called to fid concepts since they are provided along with the PID/entity/attribute being annotated).
Only one `annotator.matcher.className` should be configured at any given time. Similarly, only one `annotator.store.className` should be defined.
For testing, a MockAnnotatorStore can be used and will only print the annotations to stdout for inspection.
After configuring the annotator.properties as desired, the utility can be called:
mvn exec:java -Dexec.mainClass="org.dataone.annotator.Annotator" -Dexec.args="-create -pidfile "
There are other flag options as well, described below.
For automated annotations:
* `create` (as above)
* `createAll` (does not use pidfile and simply generates annotations for EVERY metadata object in the configured repo)
* `remove` (removes annotations for pids in the file)
* `removeAll` (removes all annotations in the repo)
For other actions:
* `manual` (generates annotations from manual spreadsheet identified by file argument)
* `types` (generates ontology concepts provided in the file argument)
Development logs
----------------
For developers interested in getting an email for each push to the sem-prov repositories, you can subscribe to our mailing list:
* sem-prov-dev: [List Info](http://lists.dataone.org/mailman/listinfo/sem-prov-dev/)