1. Linking great software and the people that use it; functionality, documentation and user interfaces Fabrizio Giabardo Undergraduate Student at Monash University 26 February, 2015

2. CSIRO. Tech Talk, 26 February 2015 What will be covered? Linked data LDR (Linked data registry) on the web What is it? Documentation Uses SISSVoc What is it? Uses User interface Tools Future Thank you

3. Data vs Linked Data Visually CSIRO. Tech Talk, 26 February 2015 A bunch of data A bunch of LINKED data Car Color Blue Car Hatchback Model Type

4. Brief insight in to Linked Data Linked Data describes a method of publishing structured data so that it can be interlinked and become more useful through semantic queries. For example Humans can deal with ambiguity The surf is pumping, clean, hollow barrels but crowded The chances are you’ll have a good idea of what I mean. Without the benefit of context, machines can't infer that “hollow barrels” are describing the wave type, that I’m talking about “crowded” as more then 8 surfers in the line up. To be interoperable, machines need all these details spelled out explicitly in the data they exchange. CSIRO. Tech Talk, 26 February 2015 Plunging/hollowWave Breaking Wave type

5. CSIRO. Tech Talk, 26 February 2015

6. LDR Managing and creating content (at a SPARQL endpoint) on the web

7. CSIRO. Tech Talk, 26 February 2015 Brief intro to LDR It provides a service to create and manage controlled, authoritative lists of identifiers as URIs on the web. The software is based on linked data principles & RDF and provides both a web application and RESTful API.

8. How are we using it? AGIFT AGU ANZSRC NGIS AWID BA glossary CSIRO. Tech Talk, 26 February 2015 Deploying & Managing vocabularies

9. Who am I? 4 th year RMIT student Environmental Science/Social Science Citizen Science Future directions / Career in Environmental Science 9 | Summer of Vocabs| Megan Williams

10. Vocabularies A lists of terms, preferably with definitions Governed by a recognized authority, and adopted by a relevant community Accessible Megan worked to formalize these vocabularies 10 | Summer of Vocabs| Megan Williams

11. CSIRO. Tech Talk, 26 February 2015 My interactions with LDR

12. Working with LDR Add Features Display more info Highlight and bold important info Keep the format clear Learn VTL Increase functionality Fix/report bugs NGINX rewrites Errors with forms CSIRO. Tech Talk, 26 February 2015 Phone or TV??

13. Working with LDR Documentation Streamline the deployment process Set out clear instructions for deployment from scratch Goal is to allow anyone to be able to deploy LDR Introduce people to VM’s and linux Write up detailed specific info for LDR in relations to VM’s Document the procedure CSIRO. Tech Talk, 26 February 2015

14. LDR We now have a means to create and manage content on the web LDR creates the SPARQL endpoint This content comes in the form of vocabularies What is next?? CSIRO. Tech Talk, 26 February 2015

15. Simon Cox, Jonathan Yu, Terry Rankine

16. CSIRO. Tech Talk, 26 February 2015 Brief intro to SISSVoc What is SISSVoc? A linked data API for publishing vocabularies. It provides a user- friendly web interface to a vocabulary already available from a SPARQL endpoint. Aim creating, for the standard vocabulary user, an appropriate interface which is based on the structure of vocabulary data, not generic RDF queries. Includes Search capabilities

17. A visual representation of SISSVoc CSIRO. Tech Talk, 26 February 2015 SPARQL EndpointSISSVoc API User Interface Triple Store services that accept SPARQL queries and return results

18. CSIRO. Tech Talk, 26 February 2015 Some more on SISSVoc Interface? SISSVoc provides a RESTful interface via a set of URI patterns that are aligned with SKOS RESTful? SISSVoc does not require the client to know anything about the structure of the API Machine and Humans It can be consumed via web clients as human-readable resources (such as HTML) and by client applications through machine- readable resources (such as RDF, JSON, and XML)

19. CSIRO Projects with SISSVoc eREEFS Aust. Gov. Environmental Data Vocabularies International Stratigraphic Chart ANZSoilML Soil Vocabularies OGC Definitions Water and energy consumption vocabularies etc……. CSIRO. Tech Talk, 26 February 2015

20. My interactions with SISSVoc

21. Step 1) Clean up documentation & deployment First started here ~ 2 days to deploy encountering lots of errors Cleaned up bugs in deployment Increased detail in deployment for Windows and Linux Post new documentation ~ 30-40 minutes once pulled from Git Wrote instructions for deploying SISSVoc over a vocabulary in the format of a.ttl file (docker fuseki & SISSVoc) Now ~ 5-10 Minutes Dockerized the process Ben & Jonathan CSIRO. Tech Talk, 26 February 2015

22. Step 2) Improve SISSVoc’s UI Smaller Steps Migrate SISSVoc to Velocity templates from xslt Start with a HTML Skeleton file Merge HTML skeleton in to a.vm file Add functionality with.vm files, methods and Macros Mask Javascript from the VTL Parser Correctly encapsulate all methods, JS, CSS and VTL Create a git repo for the SISSVoc UI Post UI outcome Now Scalable Easier to add new functions and extensions Much simpler to customize the UI for specific purposes. Responsive for Phone and tablet use CSIRO. Tech Talk, 26 February 2015

23. Why velocity? Not static but dynamic Much easy to work with Easy to include functionality Xslt IS HORRIBLE!!!!!! The tech stack of the underlying technology was built on XML but now there is more programmatic languages CSIRO. Tech Talk, 26 February 2015

24. SISSVoc Velocity Template Dependency Chart CSIRO. Tech Talk, 26 February 2015

25. Old CSIRO. Tech Talk, 26 February 2015

26. New (In development) CSIRO. Tech Talk, 26 February 2015

27. Recap the 2 components LDR – Managing and creating content on the web SISSVoc – Displaying content (vocabularies) on the web CSIRO. Tech Talk, 26 February 2015 LDR

28. SISSVoc over LDR? YES! Just feed it the endpoint This means that we can manage, create and display content on the web CSIRO. Tech Talk, 26 February 2015

29. Aim EASILY CONSUMEDGOOD SOFTWAREUSED SOFTWARE

30. CSIRO. Tech Talk, 26 February 2015 The importance of team interaction Impressed by the CSIRO wide capability CSS Docker (Ben Leighton) PwC & in-house technology

31. CSIRO. Tech Talk, 26 February 2015 Tools

32. CSIRO. Tech Talk, 26 February 2015 Reflection

33. CSIRO. Tech Talk, 26 February 2015 Establish Contacts at Monash University How do I see these applications being integrated Spread the word Create a link with university students An investment for the future

34. CSIRO. Tech Talk, 26 February 2015 How have I been helped Linux Only had small amount of exposure previously Docker An amazing piece of software with a great community The opportunity to work with CSIRO before finishing uni Insight into the research career Velocity Template Language Very handy tool HTML and CSS Github Extremely transferable skill set Introduced to new ideas of thinking and other teams

35. Contact Us Phone: 1300 363 400 or +61 3 9545 2176 Email: enquiries@csiro.au Web: www.csiro.au Thank you Dr. Jonathan Yu Research software engineer Dr. David Lemon EII team leader Ben Leighton Research software engineer The Land and Water Flagship Environmental information infrastructures team The Highett Staff The Culture at Highett Dr. Simon Cox Research Scientist