VDSF-VN (ppp_qos) Files

********************************************************************
 __      __  _____     _____   ______           __      __  _   _ 
 \ \    / / |  __ \   / ____| |  ____|          \ \    / / | \ | |
  \ \  / /  | |  | | | (___   | |__     ______   \ \  / /  |  \| |
   \ \/ /   | |  | |  \___ \  |  __|   |______|   \ \/ /   | . ` |
    \  /    | |__| |  ____) | | |                  \  /    | |\  |
     \/     |_____/  |_____/  |_|                   \/     |_| \_|           
                                                          
********************************************************************

Framework for simulation of video streaming over VANETs

Video Delivery Simulation Framework over Vehicular Networks (VDSF-VN) is a set of tools that allow the study of video streaming over Vehicular Networks (VANETs), including all the necessary tasks, namely: video encoding with HEVC, creating the network scenarios for SUMO & OMNeT++, launching the simulations in parallel, generating graphs with the results, and analyzing the received video quality (PSNR, SSIM, ...).

The framework is composed of several components:
(1) OMNeT++ project "ppp_qos" [https://sourceforge.net/projects/vdsf-vn-ppp-qos/]
(2) GatcomSUMO   [https://sourceforge.net/projects/gatcomsumo/]
(3) GatcomVideo  [https://sourceforge.net/projects/gatcomvideo/]

The graphical applications GatcomSUMO and GatcomVideo are developed in Java, so, they are platform independent, as well as the VDSF-VN framework. The executables (.jar files) of both applications are included with this project "ppp_qos". The source code are downloadable from different SourceForge projects.

Files
-----
ppp_qos project: ppp_qos_xxx.tgz


How to start with VDSF-VN
-------------------------
(0) Requirements:
    Java (JRE), SUMO v1.8.0, OMNeT++ v5.6.2, Veins v5.1.
(1) Launch the OMNeT++ simulator (omnetpp from the command line).
(2) Import the ppp_qos project to the OMNeT++ Workspace (e.g., "models").
    Menu File > Import ...
    Existing Projects into Workspace [Next >]
    [X] Select archive file: (ppp_qos_xxx.tgz) [Finish]

    If the Workspace is "models", the following tree will be created.

    |                                         |
    +- models                                 +- models      
       |                                         |
       +- ppp_qos                                +- ppp_qos
       |  |                                      |  |
       |  +- simulations                         |  +- simulations
       |  |  |                                   |  |  |
       |  |  +- lasvegas_computers2023           |  |  +- lasvegas_computers2023
       |  |  +- videos (MOVE TO ..\..)           |  |
       |  |                                      |  +- src ...
       |  +- src ...                             |
       |                                         +- veins ...
       +- veins ...                              |
                                                 +- videos (bin, bitstream, yuv)

    The subdirectory "videos" should be moved just under the workspace.
    Under the "videos" directory, "bin" should contains HM encoder software,
    "bitstream" contains the video sequences (encoded bitstreams and trace files),
    and "yuv" contains the original vide sequence in YUV format.
    In the distributed package, only the necessary trace files are included.

    The OMNeT++ simulator can be closed, it is not necessary to be open
    in order to run the simulations.
                                       
(3) Open a system terminal
    Go to the desired scenario subdirectory, just under "simulations",
    e.g., "lasvegas_computers2023".

(4) Now, if you need to create an scenario, you can execute the graphical
    application GatcomSUMO (you can skip this step):
    java -jar GatcomSUMO-xxx.jar

(5) You can execute GatcomVideo for running the simulations:
    java -jar GatcomVideo-xxx.jar

NOTE:
The graphical applications have been developed in Java programming language.
VDSF-VN includes the .jar file of both applications.
If you need the source code, it can be downloaded from: 
- GatcomSUMO  [https://sourceforge.net/projects/gatcomsumo/]
- GatcomVideo [https://sourceforge.net/projects/gatcomvideo/] (in brief)

A user manual is included in the scenario subdirectory for both applications
(in spanish only). There are some published papers in english language that
explain the framework, as the one shown below.

NOTE: This framework requires the following simulators:
(1) SUMO    v1.8.0 (previously v0.25.0)
(2) OMNeT++ v5.6.2 (previously v4.6)
(3) Veins   v5.1   (previously v4.4)

NOTE: VDSF-VN was developed initially for older versions of the simulators, but it has been upgraded and tested to the new versions. The most of the changes in the source code can be identified where the "VEINS_VERSION_MAJOR" compiler directive is used, or comments such as "Veins 4" or "Veins 5" have been added. However, the OMNeT++ project is not 100% backward compatible, as many changes was needed and some work would be necessary to downgrade it in order to work with older versions (NED files, etc.).  


Version history
---------------

Version  Date        Description
----------------------------------------------------------
v3.00    18/10/2023  First version uploaded to SourceForge
                     (SUMO v1.8.0, OMNeT++ v5.6.2, Veins v5.1)

If you have any suggestion or you need some special functionality,
please feel free to write to us:
Pablo Piñol, P. Pablo Garrido (pgarrido (at) umh (dot) es).

Citation
--------
We will appreciate if you cite the use of VDSF-VN in your publications in the following form.

Text:

Garrido Abenza, P.P.; P. Malumbres, M.; Piñol, P.; López Granado, O. A Simulation Tool for Evaluating Video Streaming Architectures in Vehicular Network Scenarios. Electronics 2020, 9, 1970. https://doi.org/10.3390/electronics9111970

BibTeX:

@Article{electronics9111970,
AUTHOR = {Garrido Abenza, Pedro Pablo and P. Malumbres, Manuel and Piñol, Pablo and López Granado, Otoniel},
TITLE = {A Simulation Tool for Evaluating Video Streaming Architectures in Vehicular Network Scenarios},
JOURNAL = {Electronics},
VOLUME = {9},
YEAR = {2020},
NUMBER = {11},
ARTICLE-NUMBER = {1970},
URL = {https://www.mdpi.com/2079-9292/9/11/1970},
ISSN = {2079-9292},
DOI = {10.3390/electronics9111970}
}

Thanks!