CSPS topology

Overview

Streams and modules are the central concept of CSPS library. The CSPS topology translate the way streams are used to link modules and their related devices in order to produce the desired results. From this point of view, the topology is the front-end of the library. This pages gives a presentation of topology edition standards as expected by the library parser.

Topology edition

Topology are given to CSPS library in a simple formated text file. First of all, devices engaged in the topology have to be given before editing links between modules. Considering a camera device, the definition line waited by the parser is as follow :

device cam 
    model EYESIS4PI 
    tag   eyesis4pi
end

The device keyword indicates device definition. The device type is then given, here with cam parameter for camera devices. The model keyword precede camera model that has to correspond to an implemented device. To deal with ambiguities, devices are referenced with a tag in the CSPS processing flow using the tag keyword.

For module links edition, initial streams are created through extraction modules. Those modules are device specific and are called in the following form :

module cam-mod-DSIDE 
    device eyesis4pi
    block  1024
end

The module keyword indicates a module call. The called module name has to be given as next parameter. Then, the device tag of the considered device has to be given using device keyword. Then, module-specific parameters are set using their specific keyword, here block for buffer size parameter. Because this example shows extraction module call, input stream are implicitly known.

The stream modules have to consider input streams in addition to input devices. A typical call is illustrated here :

module imu-mod-SGSFR
    device          adis16375
    module          mod-DSIDE
    freq-in         2460
    freq-out        60
end

As extraction module call, the module name is given just after module keyword. Then a list of device tag is given according to module expectations using the device keyword and in the order expected by the module. Only after device specification, input modules are specified using the module keyword in the order expected by the module. Then specific keywords are used to specify module expected parameters. Here input and output frequency of signals are provided as parameters.

Topology example

An example of a simple CSPS topology is provided here. It considers three devices that are a camera, a GPS reciever and an IMU sensor. The topology example file content is given by :

device cam
    model EYESIS4PI
    tag   eyesis4pi
end

device gps
    model LS20031
    tag   ls20031
end

device imu
    model ADIS16375
    tag   adis16375
end

module cam-mod-DSIDE
    device          eyesis4pi
    block           1024
end

module gps-mod-DSIDE
    device          ls20031
    block           1024
end

module imu-mod-DSIDE
    device          adis16375
    block           1024
end

module gps-mod-SGNQF 
    device          ls20031
    module          mod-DSIDE
end

module imu-mod-SGSFR
    device          adis16375
    module          mod-DSIDE
    freq-in         2460
    freq-out        60
end

module imu-mod-SGNDN 
    device          adis16375 
    module          mod-SGSFR
end

module imu-mod-ISRAD 
    device          adis16375 
    module          mod-SGSFR
    maximum         256
    minimum         32
    trigger-gyro    0.05
    trigger-accel   0.50
end

module imu-mod-IOBMA
    device          adis16375 
    device          ls20031 
    module          mod-SGNQF
end

module imu-mod-IFICR
    device          adis16375 
    module          mod-IOBMA
    x-angle         +0.0
    y-angle         +0.0
    z-angle         -1.57079632679489655800
end

module imu-mod-IFETI
    device          adis16375 
    module          mod-SGNDN 
    module          mod-IFICR
end

module imu-mod-AACEX
    device          adis16375
    module          mod-SGNDN
    module          mod-IFETI 
end

The devices are initially declared with their specific options. Then the extraction modules are called for the camera, GPS reciever and IMU sensor. The stream modules are then called in order to generate the desired results.

Topology results

The following image gives a three dimensional illustration of the results provided by the example topology. The earth-attached positions of camera capture are given in yellow when orientations are provided by the red-green-blue frame attached to each camera record :

On the previous image, an Eyesis4Pi camera device was mounted on a car. Two whole turns around a building located at Geneva where performed during this record in 4 minutes and 57 seconds.