VantagePoint 1.

0 QuickStart tutorial
This document is created to give advanced users quick instructions on how to start using the new
VantagePoint 1.0 version. It goes through the installing and deployment of the VantagePoint tool,
but do not give any detailed information on how each phase is carried out. To get more in-depth
instructions, please see the document VantagePoint Users Guide 1.0.

1. Installing

To use VantagePoint you need a version of the Java Runtime Environment (Version 1.6.X)
and an Oscar platform.

Download the VantagePoint_1.0.zipfrom

http://www.vtt.fi/proj/vantagepoint/index.jsp?lang=en and a pre-configured Oscar platform
from http://amigo.gforge.inria.fr/obr/tools/index.html.

Launch Oscar and download the necessary bundles from OBR

(http://amigo.gforge.inria.fr/obr/tools/oscar-repository.xml,
http://amigo.gforge.inria.fr/obr/v2/repository.xml). Install the rest of the bundles from the
bundlesfolder found in the VantagePoint_1.0.zip. See Figure 1 for details.

Figure 1: The bundle configuration

When installing the Context Source manager bundle DO NOT press start all, but instead
use the deploybutton.
See document SD-SDCAE_User_Guide.doc from https://gforge.inria.fr/frs/?group_id=160
to get more detailed information about how to install and deploy the semantic service
repository.
Before launching the VantagePoint or the adapter bundles, modify the 'ont-policy.rdf' file
found in the configurationfolder by changing the file paths as demonstrated in Figure 2.
 Figure 2: File path configuration

Start the manually installed bundles one by one.

2. Creating and editing scenarios

VantagePoint provides a possibility to create scenarios which simulate real-world or abstract

environments and different context changes occurring in them.

Creating a new model

o Select the Context sourcestab, press the New Context Sourcebutton and name
your context source.
o Select your context source from the list of available context sources and double click
it.
Adding of areas
o Select the Areas tab, choose texture from the list, select the area drawing button and
draw the area with your mouse. Finally, name the area.
o See Figure 3 for better insight.

Figure 3: The adding of areas

Adding of items
o Select the Items tab, select an item library, select an item from the list, drag the icon
representing the item into the visualization and name the item.
 o Items can only be added in the edit view.
o See Figure 4 for better insight.

Figure 4: The adding of items

Editing operations
o The editing operations menu can be accessed by selecting an instance from the
visualization and pressing the right mouse button.
o VantagePoint offers the following editing operations:
Move
Delete
Rotate
Send to back

3. Queries

VantagePoint offers two ways to make queries: a textual query and a graphical query. Both
query types can be managed in the query tab.

Textual query: write a query statement to the query area, press the Executebutton and the
results will appear to the information area (see Figure 5).
 Figure 4: Query execution in VantagePoint

Graphical query: Press the Settingsbutton and the Graphical queryingdialog will be
opened. Select a query set and press the OKbutton (see Figure 5). Make sure that the
graphical querying is marked as enabled (the check box) and click some instance in the
visualization. Results will appear in the information area (see Figure 4).

Figure 5: Graphical query dialog

4. Adding services

Services can be added to Amigo Semantic Service Repository with VantagePoint by

dragging items to the environment. This requires that the dragged item have the property
VantagePoint:providesService.

The state of the service repository can be discovered in the services tab, as shown in Figure
6.
 Figure 6: Service registering

Services can also be manually registered by entering the locations of the semantic
description and the grounding of the service to the text fields shown in Figure 6.

VantagePoint provides a possibility to test the service requests by defining a task description
or a service type. The service description and the service type class can be defined to the text
fields shown in Figure 7. The test results are printed in the console.

Figure 7: Test service requests

5. Adding Context Sources

Context sources can be managed in the Context Source tab, which has two lists for storing
context sources.

The upper list is a view to the actual Context Broker and the lower one is the list of available
context sources that VantagePoint has at the moment (see Figure 8).

Context sources can be registered and un-registered with the operations shown in Figure 8.
 Figure 8: Registering and un-registering services

5.1 RDF capabilities

Context sources can describe themselves by using short rdf descriptions (aka capabilities).

VantagePoint provides support to manage and control these rdf descriptions with the
following operations (see Figure 9):
o Print capabilities
o Set capabilities for a context source
o Simulate the context source discovery

Figure 9: The operations to manage rdf capabilities

To simulate the context source discovery register a context source to the context broker,
select a capability description from the file system (an xml file) and press the
discoverContextSourcebutton. The matching context sources are printed in the console.

5.2 User locator service

VantagePoint provides also a special user locator service to monitor the movements of
persons in an environment.
 Create the service in the context sources tab by selecting a static context source from the list
of available context sources, and press the Create User Locatorbutton. A new context
source will be created. Register the created source to the context broker. Now client
applications are able to subscribe themselves to the user location context source and receive
updated context data models every time a person is moved to another location.