1. Linked Vocabulary API for the Earth Sciences Community AGU Fall Meeting 2014 Stephan Zednik Peter Fox Linyun Fu Patrick West Xiaogang Ma http://bit.ly/1Gim0KB

2. Overview CMSP & OCM Portals Vocabulary Problem Objectives Testbed Vocabulary SKOS Linked Data Linked Vocabulary API Outcomes IN32A-07 AGU Fall Meeting 2014

3. Background Ontology and Vocabulary development in the context of data portals for environmental inter-agency collaboration –Coastal and Marine Spatial Planning (CMSP) –Ocean and Coastal Mapping (OCM) Data tagged using a multitude of data vocabularies –Numerous agencies –Numerous communities –Overlapping scopes IN32A-07 AGU Fall Meeting 2014

4. The Vocabulary Problem Data from numerous agencies using numerous vocabularies –Semantic Equivalence? –Scope? Varying state of vocabulary –Representation –Publication –Usage Mapping? IN32A-07 AGU Fall Meeting 2014

5. Objectives Provide proof- of-concept to agencies on publishing and consuming formal data vocabularies on the web Representation Use existing model Be Semantic Access Open License Non-proprietary Format Resolvable Identifiers Service Text-based search Aggregations Filtering Reasoning Mapping Formally Defined Machine-readable IN32A-07 AGU Fall Meeting 2014

6. Linked Data Use URIs to denote things Use HTTP URIs so people can look up those names When someone looks up a URI provide useful information, using the standards (RDF*, SPARQL) Include links to other URIs so that they can discover more things IN32A-07 AGU Fall Meeting 2014

7. Testbed Vocabulary National Information Management Systems (NIMS) Data Categories Data categories for marine spatial planning Revised copy to be formally released under different name Source - Excel document 8 top-level categories 94 terms IN32A-07 AGU Fall Meeting 2014

8. Simple Knowledge Organization System (SKOS) Model for expressing concept schemes in RDF Low-cost solution for porting existing knowledge organization systems to the Semantic Web Supports mapping between concept schemes W3C Recommendation (2009) SKOS Primer - http://bit.ly/1Bi6Br3http://bit.ly/1Bi6Br3 IN32A-07 AGU Fall Meeting 2014

9. SKOS Model IN32A-07 AGU Fall Meeting 2014

10. SKOS Concept Scheme Mapping IN32A-07 AGU Fall Meeting 2014

11. NIMS Data Categories SKOS rdf:type owl:NamedIndividual, skos:Concept ; skos:prefLabel "Threatened and Endangered Species"@en ; skos:inScheme ; skos:narrower,. rdf:type owl:NamedIndividual, skos:Concept ; skos:prefLabel "State Listed Threatened and Endangered Species"@en ; skos:inScheme. IN32A-07 AGU Fall Meeting 2014

12. Vocabulary Service Linked Data API Easy-to-use web interface for publishing linked data User-defined (read-only) RESTful API Declarative Design Query Parameters to control resource construction Out-of-the-box support for RDF, XML, JSON, HTML IN32A-07 AGU Fall Meeting 2014

13. Linked Vocabulary API URI Syntax –/vocab/{vocab_id} –/vocab/{vocab_id}/term/{term_id} Collections –/vocabs –/vocab/{vocab_id}/terms –/vocab/{vocab_id}/term/{term_id}/related Text-based Search –/vocab/{vocab_id}/terms?anyLabelContains={text} Mapping –/vocab/{vocab_id}/term/{term_id}/closeMatch?inScheme.prefLabel={name} Query Parameters –/vocab/{vocab_id}/terms?_properties=prefLabel,altLabel –/vocab/{vocab_id}/terms?_page=2&_pageSize=25 For full API see http://bit.ly/12ztZnShttp://bit.ly/12ztZnS IN32A-07 AGU Fall Meeting 2014

14. Outcomes Proof-of-concept –Publishing vocabularies as Linked Open Data using SKOS Development of vocabulary service –SKOS-based RESTful API –http://bit.ly/1IG8vGXhttp://bit.ly/1IG8vGX Service hosting preliminary NIMS Data Categories Vocabulary –http://bit.ly/1zVd7Tohttp://bit.ly/1zVd7To IN32A-07 AGU Fall Meeting 2014

15. Next Steps Publish more vocabularies Publish vocabulary mappings Feedback from user community Iterate on API (especially vocab mapping) Possible Research Data Alliance (RDA) interest group on vocabulary services IN32A-07 AGU Fall Meeting 2014

16. Thanks CMSP/OCM Workshop Epimorphics Ltd. W3C SKOS Working Group IN32A-07 AGU Fall Meeting 2014

17. QUESTIONS/COMMENTS? Project URL: http://tw.rpi.edu/web/project/CMSPVhttp://tw.rpi.edu/web/project/CMSPV Email: zednis2@rpi.eduzednis2@rpi.edu Twitter: @szednik IN32A-07 AGU Fall Meeting 2014

18. Links This Presentation –http://bit.ly/1Gim0KBhttp://bit.ly/1Gim0KB CMSPV Project Page –http://tw.rpi.edu/web/project/CMSPVhttp://tw.rpi.edu/web/project/CMSPV CMSPV NIMS Linked Vocabulary API –http://cmspv.tw.rpi.edu/elda/cmspv/vocab/nimshttp://cmspv.tw.rpi.edu/elda/cmspv/vocab/nims Linked Vocabulary API on Github –https://github.com/tetherless-world/linked-vocabulary-apihttps://github.com/tetherless-world/linked-vocabulary-api W3C SKOS Primer –http://www.w3.org/TR/skos-primer/http://www.w3.org/TR/skos-primer/ Linked Data – Design Issues –http://www.w3.org/DesignIssues/LinkedData.htmlhttp://www.w3.org/DesignIssues/LinkedData.html Linked Data API Specification –https://code.google.com/p/linked-data-api/wiki/Specificationhttps://code.google.com/p/linked-data-api/wiki/Specification ELDA on Github –https://github.com/epimorphics/eldahttps://github.com/epimorphics/elda IN32A-07 AGU Fall Meeting 2014

19. BACKUP SLIDES IN32A-07 AGU Fall Meeting 2014

20. CMSPV HTML View IN32A-07 AGU Fall Meeting 2014

21. CMSPV JSON { "format" : "linked-data-api", "version" : "0.2", "result" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/cmspv/vocab/nims/term/0006.json", "definition" : "http://cmspv.tw.rpi.edu/rdf/cmspv/meta/vocab/_vocabulary/term/_term.json", "extendedMetadataVersion" : "http://cmspv.tw.rpi.edu/rdf/cmspv/vocab/nims/term/0006.json?_metadata=all", "primaryTopic" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0006", "inScheme" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims", "prefLabel" : "NIMS Data Categories"}, "label" : ["Cultural and Historic"], "narrower" : [{"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0026", "prefLabel" : "Locations of Artifacts Reflecting US Maritime History"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0027", "prefLabel" : "Areas + Resources of Cultural Significance to Native Peoples"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0028", "prefLabel" : "Important View-sheds"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0029", "prefLabel" : "Historically Significant Properties"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0030", "prefLabel" : "Protected Areas"} ], "narrowerTransitive" : [{"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0026", "prefLabel" : "Locations of Artifacts Reflecting US Maritime History"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0027", "prefLabel" : "Areas + Resources of Cultural Significance to Native Peoples"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0028", "prefLabel" : "Important View-sheds"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0029", "prefLabel" : "Historically Significant Properties"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0030", "prefLabel" : "Protected Areas"} ], "prefLabel" : "Cultural and Historic", "semanticRelation" : [{"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0026", "prefLabel" : "Locations of Artifacts Reflecting US Maritime History"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0027", "prefLabel" : "Areas + Resources of Cultural Significance to Native Peoples"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0028", "prefLabel" : "Important View-sheds"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0029", "prefLabel" : "Historically Significant Properties"}, {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims/term/0030", "prefLabel" : "Protected Areas"} ], "topConceptOf" : {"_about" : "http://cmspv.tw.rpi.edu/rdf/vocab/nims", "prefLabel" : "NIMS Data Categories"}, "type" : ["http://www.w3.org/2002/07/owl#NamedIndividual", "http://www.w3.org/2004/02/skos/core#Concept"]}, "type" : ["http://purl.org/linked-data/api/vocab#Page"]} } IN32A-07 AGU Fall Meeting 2014

22. SKOS (cont.) IN32A-07 AGU Fall Meeting 2014

23. 5-Star Linked Open Data ★ Make your stuff available on the web (whatever format) under an open license ★★ Make it available as structured data (e.g. Excel instead of image scan of a table) ★★★ Use non-proprietary formats (e.g. CSV instead of Excel) ★★★★ Use URIs to denote things, so that people can point at your stuff ★★★★★ Link your data to other data to provide context http://www.w3.org/DesignIssues/LinkedData.html IN32A-07 AGU Fall Meeting 2014

24. ELDA (cont.) http://www.epimorphics.com/web/tools/linked-data-api.html IN32A-07 AGU Fall Meeting 2014

25. LDA Specification lva:vocabularyTermsEndpoint a api:ListEndpoint ; rdfs:comment “…" ; api:uriTemplate "/vocab/{vocabulary}/terms" ; api:exampleRequestPath "/vocab/nims/terms" ; api:variable [ api:name "scheme" ; api:value "{base}/vocab/{vocabulary}" ; api:type rdfs:Resource ; ] ; api:selector [ api:where "?item skos:inScheme ?scheme. ?item skos:prefLabel ?label." ; api:orderBy "?label" ; ] ;. IN32A-07 AGU Fall Meeting 2014