diff --git a/docs/eml-semantic-annotations-primer.md b/docs/eml-semantic-annotations-primer.md index 8cd8d51d..dd2045fd 100644 --- a/docs/eml-semantic-annotations-primer.md +++ b/docs/eml-semantic-annotations-primer.md @@ -52,7 +52,7 @@ specific related topics, with links from the main text where appropriate. - **EML 2.2.0 has five places or methods to add annotations.** - **The best place for advice and feedback on EML annotations is your data management community** - + ## Semantic Annotations in EML 2.2.0 In **EML 2.2.0** there are 5 places where annotation elements can appear in an EML document: @@ -287,9 +287,10 @@ Taken together, the semantic statement could be read as "'adam.shepherd' (the cr ``` - + ## Appendix -### Semantic triples + +### Semantic triples Semantic annotations enable the creation of what are called *triples*, that are 3-part statements conforming to the W3C recommended *RDF data model* (learn more: ). @@ -305,8 +306,8 @@ There are (perhaps unfortunately) several other ways that the components of an R Semantic annotations added to an EML document can be extracted and processed into a semantic web format, such as RDF/XML. These"semantic" statements, i.e. RDF triples, are interpretable by any machines that can process the W3C standard of RDF. Those RDF statements contribute to the Semantic Web. - -### URIs + +### URIs Ideally, the components of the semantic triple should be globally unique and persistent (unchanging), and consist of resolvable/dereferenceable HTTP uniform resource identifiers (URIs; or more formally, IRI's). The *subjects* of most EML semantic annotations will likely be HTTP URI's that identify the dataset resource itself, or specific attributes or other features within a dataset. The *objects* of EML semantic annotations, as well as the *predicates* that relate the subject to the object, will most typically be HTTP URI references to terms in controlled vocabularies (also called "knowledge graphs", or "ontologies") accessible through the Web, so that users (or computers) can dereference the URI's and look up precise definitions and relationships of these resources to other terms [^footnote1]. An example of a URI is "http://purl.obolibrary.org/obo/ENVO_00000097", when entered into the address bar of a web browser, resolves to the term with a label of "desert area" in the Environment Ontology (EnvO). Users can learn what this URI indicates and explore how the term is related to other terms in the ontology simply by dereferencing its URI in a web browser. All those other aspects you see on the Web page describing "http://purl.obolibrary.org/obo/ENVO_00000097" are from other RDF statements (triples) related to "ENVO_00000097", and that have been rendered into HTML. From here, you might decide, e.g. that "http://purl.obolibrary.org/obo/ENV0_00000172" ("sandy desert") is a better annotation for your object. @@ -332,8 +333,8 @@ The software needed to extract semantic annotations out of EML, and convert thes The sections below describe the exact syntax for embedding annotations in EML 2.2.0 documents. - -### RDF Graphs + +### RDF Graphs A graph consists of resources linked to other resources. Thus the simplest graph structure is when you specify how one resource (node) is linked to another resource (node). @@ -431,7 +432,8 @@ the categories, properties, and relationships among those terms. **uniform resource identifier (URI)**: A string of characters that unambiguously identifies a particular resource. For semantic annotations, the components of semantic triples are ideally HTTP URIs that resolve and describe precise definitions and relationships to other terms, using Web technology. -**Pointer** definition here + +**Pointer** definition here ### External resources