KIT – University of the State of Baden-Wuerttemberg and National Research Center of the Helmholtz Association www.kit.edu

Technology for Pervasive Computing

Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

Andrei Miclaus Till Riedel Jack Unseld Michael Beigl

Contextual Documentation

Users

THINGS

Developers

Web of Things Workshop

2 17/10/14 Technology for Pervasive Computing

Why Appropriate Help is Important

[Beckmann et.al. 2004] Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

3 17/10/14 Technology for Pervasive Computing

Our Approach – Generated documentation

!   Fusion of context and system models !   Optimized documentation

System Models

Context

User Information

Context adapted, up-to-date Information

Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

4 17/10/14 Technology for Pervasive Computing

Motivating Factors

!   Increasing complexity in the industrial processes !   Supporting a user is an important factor

!   The need to use existing data sources without migrating to other formats !   Especially industry relevant

!   Web of things becoming a reality

!   Ever increasing number of smart IoT devices !   More and more devices offer high level APIs

Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

5 17/10/14 Technology for Pervasive Computing

Unified Querying

THINGS

Gear%

Rims%

Frame%

Bike%Context'Model' Text'

Descrip2ons'

System models

Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

6 17/10/14 Technology for Pervasive Computing

How do you stitch all that data together?

7 17/10/14 Technology for Pervasive Computing

User

Data Resource Mashup

Configuration

Feedback

THINGS

Developer

Smart'Template'

Gear%

Rims%

Frame%

Bike%Context'Model' Text'

Descrip2ons'

Context'adapted,'up8to8date'Informa2on'

Documents

Instant'Help'

Semantic Web Membrane (Adapter) Change Notifications

8 17/10/14 Technology for Pervasive Computing

Smart Template

Product Layer

Adapter Layer

Live Document Layer

Configuration Layer

Context'Model'

Query'Module'

Engine'

Reasoner'

Document'Template'

Listener'

Queries

Configura2on'Wizard'

Base'Template' Document Engineer

THINGS

Notifications

Meta8Data'

9 17/10/14 Technology for Pervasive Computing

Template Example

var entities = getAll(“http://kit.edu/entity/item”) var greeting = get(“CustomerGreeting”) p greeting.Text for item in entities h2 item.name.Text item.get(“description”).Text

10 17/10/14 Technology for Pervasive Computing

Example Documentation

Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

11 17/10/14 Technology for Pervasive Computing

Document Generation

Model Augmentation

Instant Help Contextual Documentation

Home Automation App Store

Device Bindings

Text'Store'

Text'Store'

Template

Code%Model%

User

Developer

Manufacturer

User

Template

12 17/10/14 Technology for Pervasive Computing

Implementation

Xtext project

.ecore

Spreadsheets:.xls.csv

DSL-file:.items

Source files

Model

Xlwrap java library

emf4sw java library

Rdf Converters

Using .trigmapping

Semantic WebDescription Image Links Model Metamodel

SPARQL endpoints/imageLinks/description

rdflib, rdflib-jsonld

/model /metamodel

Query parser

Live Template

In json-ld

File monitor

notifies

watches

13 17/10/14 Technology for Pervasive Computing

Conclusion

!   Product specific documentation generation approach

!   Semantic web for data integration !   Leveraging the IoT and WoT trends

!   We enable contextual documentation generation

!   For aiding users in the installation, usage and maintenance of systems

Future Work !   Industrial application and user studies !   Gather experience on the authoring process and system adoption

chance

Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

14 17/10/14 Technology for Pervasive Computing

Thank You for Your Attention!

In cooperation with

Contact: miclaus@teco.edu

Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation

15 17/10/14 Technology for Pervasive Computing

References

!   Beckmann, C., Consolvo, S., & LaMarca, A. (2004). Some Assembly Required: Supporting End-User Sensor Installation in Domestic Ubiquitous Computing Environments. In UbiComp 2004: Ubiquitous Computing SE - 7 (Vol. 3205, pp. 107–124). Springer Berlin Heidelberg. doi:10.1007/978-3-540-30119-6_7

!   Harrison, N. (2005). The Darwin Information Typing Architecture (DITA): Applications for globalization. Professional Communication Conference, 2005

! Guinard, D., Trifa, V. M., & Wilde, E. (2009). Architecting a mashable open world wide web of things. ETH, Department of Computer Science.

! Miclaus, A., Riedel, T., & Beigl, M. (2014). End-User Installation of Heterogeneous Home Automation Systems Using Pen and Paper Interfaces and Dynamically Generated Documentation. The 4th International Conference on the Internet of Things (IoT 2014).

Please see more in the paper Andrei Miclaus – Semantic Web Based Context-Adaptable Generation of Product Specific Documentation