OMiLAB Laboratory Setting ​

The Laboratory Setting contains a setup, where the Recognition Component and the Bucket Service Component run on reachable sever. The *Image Provider runs on a dedicated device (e.g., a Raspberry Pi), constantly streaming the picture to the Bucket Service Component. The Scene2Model Modelling Tool is then connected to the recognition component and collects the information needed to create the model, whereby the recognition components collects the picture from the bucket. This setting has a stationary nature and can be used to efficiently use Scene2Model in a dedicated place, like a OMiLAB Node laboratory.

This page describes the setting itself, how it can be used in the modelling tool to import haptic models can be found at Import Haptic Design.

The figure below visualizes Laboratory Setting's components and their relations.

To use this setting, first the Physical Design Space must be set-up. An example, can be seen in the figure below. For the Laboratory Setting the USB camera is connected to a device and mounted to a camera arm, looking on the paper figures from above, so that the tags can be seen. The top-side of the camera must face in the same direction the paper figures are facing.

The Image Provider consists of two parts, a script that takes picture with a Logitech C920 camera and sends them to Bucket Service Component. From this other applications, like the Recognition Component, can access the picture. The script uses ffmpeg to take the picture and curl to send the picture. There exists scripts for Windows, Linux and Mac OS. Therefore, any device running one of these operating systems can be used to take a picture and send it to the bucket. The scripted are tailored to only use the Logitech C920, but with knowledge in ffmpeg they can be extended to allow the usage of other cameras.

The Bucket Service Component and Recognition Component can run on one or multiple servers. It is important that the Recognition Component can reach the Bucket Service Component over the network over internet. The Scene2Model Modelling Tool must be able to reach the Recognition Component to load the needed information from there.

Therefore, the following connections must be enabled in the set-up:

• The Image Provider must be able to make HTTP calls to the Bucket Service Component.
• The Recognition Component must be able to make HTTP calls to the Bucket Service Component.
• The Scene2Model Modelling Tool must be able to make HTTP calls to the Recognition Component.
  • The Recognition Component also offers a web interface, to help the users of the Scene2Model Modelling Tool. Therefore, a browser on the user device should also be able to open web pages of Recognition Component.

You can find the scripts for the picture stream of the Image Provider at our S2M Bucket Image Provider project. How you can install and use it is described in the readme.md file of the project.

Configuration: End Point of the Recognition Component ​

Before a haptic model can be imported into the Scene2Model Modelling Tool, it must be configured to the prepared components.

Hints:

• Provided URLs should not have a / at the end.
• The concrete endpoints must be adapted to the concrete installation of the setting.
• The lines in the configuration window, which start with # are comments and ignored by the tool:

Configuration Parameters: ​

The following parameters regarding the recognition endpoint must be set:

• OliveEndpoint: URL of the Olive endpoint, over which the information for creating models can be gathered. It is the URL of the controller user interface, plus adding a /rest at the end.
• OliveMicroservice: One Olive instance offers multiple services. In this parameter the identifier of the service created for this instance must be provided.
• BucketAndRecognitionServiceEndpoint: URL of the Recognition Component must be provided
• BucketEndpoint: URL of the Bucket Service Component
• DefaultBucket: name of the bucket that should be used within the Bucket Service Component
• Camera: Name of the camera that should be used (at the moment only a Logitech C920 is supported, which has the name HD Pro Webcam C920)
• Scene2Model_Library_Directory: Path to the currently loaded Domain-specific library directory. This parameter is set automatically if a new library is loaded.

Template for configuration: ​

Scene2Model_Library_Directory=<path-to-domain-specific-library-directory>

OliveEndpoint=<olive-endpoint>
OliveMicroservice=<olive-microservice-identifier>

BucketAndRecognitionServiceEndpoint=<bucket-and-recognition-endpoint>
BucketEndpoint=<bucket-endpoint>
DefaultBucket=<default-bucket-name>

Camera=<camera-name>

Scene2Model_Library_Directory=<path-to-domain-specific-library-directory>

OliveEndpoint=<olive-endpoint>
OliveMicroservice=<olive-microservice-identifier>

BucketAndRecognitionServiceEndpoint=<bucket-and-recognition-endpoint>
BucketEndpoint=<bucket-endpoint>
DefaultBucket=<default-bucket-name>

Camera=<camera-name>

Configuration of the Endpoints ​

1. Open configuration Window

   • Click System tools
   • Click Edit internal configuration file
   • Mark scene2model.properties
   • Click OK

2. Change the needed parameters

3. Confirm by clicking Apply