Mobile RF Scenario Design for Massive-Scale Wireless Channel Emulators

If you use the content of this repository, please reference the following paper:

R. Rusca, F. Raviglione, C. Casetti, P. Giaccone, F. Restuccia, "Mobile RF Scenario Design for Massive-Scale Wireless Channel Emulators," pre-print version. URL BibTeX

Files Overview

• raytrace_mobile.m → contains the main code with the dataset import, channel matrix initialization and computation of others variables needed. For the Ray-tracing and Clustering step for vehicle and for each timestamp is called the raytrace_fcn inside the raytrace_fcn.m file.
• raytrace_fcn.m → contains the code for the ray-tracing and clustering.

Expected input format

The code inside raytrace_mobile.m expects a specific input format for the dataset. You can either read a dataset with a different format and convert it inside MATLAB, or directly provide the dataset with the required format. This format is a CSV file with one line for each vehicle and each timestamp, and at least the following fields:

• agent_id → ID of the vehicle the row refers to
• timeStamp_posix → Timestamp with respect to a well-defined reference, in seconds, and with decimal digits to reprents milliseconds
• latitude_deg → Latitude in degrees for vehicle agent_id at time timeStamp_posix
• longitude_deg → Longitude in degrees for vehicle agent_id at time timeStamp_posix

Tested MATLAB version

The code has been developed and tested under MATLAB R2022a, but it should be compatible with newer versions too. If you encounter any compatibility issues with MATLAB versions greater than R2022a, please let us know.

Input required in the generic code

If you want to use the generic code inside raytrace_mobile.m (i.e., not the one for the already configured scenario with the SAMARCANDA dataset), before you can launch the code and generate your own scenario, you need to properly customize the code, inserting at least the required parameters/code in the line followed by a comment with {INPUT}.

SAMARCANDA Mobility Scenario

Inside SAMARCANDA_Scenario folder, you can find all the files needed to create a Mobile RF Scenario starting from the SAMARCANDA dataset available here. The SAMARCANDA dataset has been presented in this Elsevier paper.

More in detail:

• SAMARCANDA_area.png → contains a picture showing the SAMARCANDA traces of 19 vehicles on a map with 1 km^2 area highlighted in blue.
• SAMARCANDA_selected_area.png → contains a zoomed picture showing the selected area for the creation of the RF Scenario with the position (static) of the antenna and some vehicles.
• cars_distribution.fig → is a MATLAB figure that contains the distribution of cars inside the 1km^2 area selected for the scenario. For each timestamp on the y-axis there is the number of vehicles inside the selected area.
• raytrace_fcn.m and raytrace_mobile.m → contain the code for the creation of the channel matrix tailor-made for the Colosseum emulator and specific for the SAMARCANDA dataset.

Contacts

• Riccardo Rusca [[email protected]]
• Francesco Raviglione [[email protected]] [[email protected]]
• Claudio Casetti [[email protected]]
• Paolo Giaccone [[email protected]]
• Francesco Restuccia [[email protected]]