SenseVid Homepage

SenseVid is a a new video transmission and evaluation tool that follows the same principle of EvalVid while being specific to WSN. SenseVid can help network researchers to assess network protocols targeted to video applications in WSN.

Reference paper :

Moufida Maimour. "SenseVid : A traffic trace based tool for QoE Video transmission assessment dedicated to Wireless Video Sensor Networks". Simulation Modelling Practice and Theory, Volume 87, September 2018, Pages 120-137.

SenseVid Download

Please fill this form to get an email with the download link

*: required field

SenseVid Installation

Dependencies :
- opencv 2 : apt-get install libopencv-dev libcv-dev
- avconv : apt-get install libav-tools
- cmake : apt-get install cmake
After SenseVid download, proceed as follows:
- $ tar xvfz sensevid.tgz
- $ cd /path/to/senseVid
- $ cmake .
- $ make

SenseVid Quick Start

SenseVid executable sensevid is located at the senseVid root directory. One mandatory argument is the avi video file. Other arguments are optional (detailed below) : ./sensevid video_file [options]
Example 1 (encoding) : ./sensevid videos/hall_qcif.avi creates and puts in directory hall_qcif-sim the following ( detailed content):
- inputParameters, recalls the used parameters in a text file
- st-frame, the frame trace file
- st-packet, the sender traffic trace file
- capturedFrames, the captured frames according to parameters of the preprocessing phase
- referenceFrames, the encoded frames intended to be transmitted.
Example 2 (decoding) : ./sensevid videos/hall_qcif.avi -r hall_qcif-sim/st-packet decodes the received frame when all packets are received. It produces in directory hall_qcif-sim the following :
- rt-frame, the received frames trace file ( detailed content)
- decodedFrames, the decoded frames according to the potential experienced losses.

SenseVid Options List

Parameter	Option	Possible values	Default value	Explanation / example
Simulation Id	-s --sim	Valid linux name	sim	/sensevid videos/hall_qcif.avi -s sim1 creates and puts outputs in hall_qcif-sim1 folder located at the current directory
Output directory	-o --dir	Valid linux name	./	/sensevid videos/hall_qcif.avi -o ~/SIM2 creates and puts outputs in ~/SIM2/hall_qcif-sim folder
Encoder	-c --codec	SMPEG	SMPEG	Compression technique
GOP coefficient (γ)	-g --gopCoef	[0,255]	0	γ determines if a frame should be M or S-encoded. Zero value produces only M-frames
Quality coefficient	-q --qualityCoef	1..100	10	QF, integer, allows trade-off between quality level and compression rate
Number of levels for M frames	-l --levelsNb	1..13	1	Integer range
DCT	-d --dct	CLA, sLLM, sBIN, tLLM, tBIN	tBIN	sBIN and tBIN for respectively square and triangular BIN DCT
Zone size (ρ)	-z --zoneSize	(1..8)	8	ρ determines the side length of the triangular or square DCT.
Entropy coder	-e --entropy	EG, RLE_EG, HUFFMAN	EG	EG - all values are encoded using exponential-Golomb. RLE_EG - DC : VLI (size, DCValue) = (symb1,symb2), AC : RLE_EG. HUFFMAN - DC : VLI (size, DCValue) = (symb1,symb2), AC : symb1, symb2 symb1=(RL_zeros,size_amplitude), symb2=amplitude Huffman is applied on symb1 (both AC and DC)
Max. S-frame priority level (σ)	-m --maxLevelS	0..4	0	There are 5 priority levels for S-frames. σ determines the maximum priority level to consider.
threshold (θ)	-t --thresh	0..255	1	Thresholding step parameter for S-frames
Resolution	-w --width -h --height	Multiple of 8	Original video resolution	Mainly used to downsample video frames. Optional preprocessing phase.
FPS	-f --fps		Original video FPS	Mainly to reduce the frame frequency capture. Optional preprocessing phase.
Packet payload size	-p --pps		96	Size is given in bytes.
Receiver trace file	-r --rt	Valid linux name		Path to the receiver trace file. Decoding phase.

SenseVid packet and frame traces

st-frame

frame number
frame type : M or S
frame size in bytes
the reference PSNR (dB)
the reference SSIM
the achieved compression ratio in bits per pixel (bpp)
the size (bits) of the different priority levels of the frame if M-encoded (up to 13 levels)
the estimated energy (mJ) required to capture this frame
the estimated energy (mJ) to encode this frame.

st-packet

the transmission time;
the sequence number;
the payload size;
the number of the frame to which belong the data of this packet;
the frame type (M or S) concatenated to the number of the previous M-frame if S;
the priority level of this packet;
the list of the frame blocks carried by this packet.

rt-frame
- frame number
- frame type : M or S
- achieved PSNR (dB)
- achieved SSIM.

Examples of Use

Cooja :

Download Contiki application to be used with cooja simulator : tgz
The resulting directory can be put in the examples folder of contiki 3
The README file gives instructions on how to set and perform a simulation using the collect application to send a video sequence.

IoT-LAB :

Download Contiki application to be used on IoT-LAB : tgz
The README file gives instructions on how to set and perform a simulation using a 2-node application to send a video sequence with m3 mote nodes of the IoT-LAB testbed.

Castalia :

Download the Castalia application : tgz to be copied in the src/node/application. Rebuild Castalia binary
The README file gives instructions on how to perform a simulation using setting in omnetpp.ini

ns2 :

Link to a page that provides how to use EvalVid with ns2. Can be adapted to SenseVid to be used with ns2.

Installation Problems and Bug Fixes

error: 'cerr' was not declared in this scope - Add #include <iostream> in sensevid.h
error: 'VideoCapture' was not declared in this scope - Replace #include <cv.h> (line 7) in sensevid.h by #include <opencv2/opencv.hpp>

Back to Moufida Maimour home page