Skip to content

ns3sionna is a software module that brings realistic channel simulation using ray tracing from Sionna to the ns-3 network simulator

Notifications You must be signed in to change notification settings

tkn-tub/ns3sionna

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ns3sionna

Logo

ns3sionna is a software module that brings realistic channel simulation using ray tracing from Sionna (https://nvlabs.github.io/sionna/) to the widely used ns-3 network simulator (https://github.com/nsnam).

Outdoor scenario: area around Frauenkirche in Munich Results for outdoor scenario: trajectory of STA, CSI, Prx over time, distance vs. Prx.
Outdoor scenario (Munich) Results from simulation

More information can be found in our paper: Ns3Sionna paper

Installation

We recommend using Linux (e.g. Ubuntu 22 or higher) and a multi-core/GPU compute node.

  1. Download ns3
wget https://www.nsnam.org/releases/ns-allinone-3.40.tar.bz2
tar xf ns-allinone-3.40.tar.bz2
cd ns-allinone-3.40
  1. Download ns3-sionna
git clone https://github.com/tkn-tub/ns3sionna.git
cd ns3sionna/
./install_packages.sh
./bootstrap.sh
  1. Build everything in ns3
cd ../ns-3.40/
./ns3 configure -d debug --enable-examples
./ns3 build
  1. Build sionna server
cd ../ns3sionna/sionna_server/
python3 -m venv sionna-venv
source sionna-venv/bin/activate
python3 -m pip install -r requirements.txt # or requirements_gpu.txt if you want to use GPUs
python3 test_imports.py # all packages should be correctly installed
  1. Start sionna server
cd ./ns3sionna/sionna_server/
source sionna-venv/bin/activate
python3 sionna_server.py
  1. Start a ns-3 example script
cd ns-3.40/
./ns3 run scratch/ns3-sionna/example-sionna.cc

Examples

All examples can be found here.

Current limitations

  • SISO only

Contact

  • Anatolij Zubow, TU-Berlin, zubow@tkn
  • Sascha Roesler, TU-Berlin, zubow@tkn
  • tkn = tkn.tu-berlin.de

How to reference ns3sionna?

Please use the following bibtex:

@techreport{zubow2024ns3-preprint,
    author = {Zubow, Anatolij and Pilz, Yannik and R{\"{o}}sler, Sascha and Dressler, Falko},
    doi = {10.48550/arXiv.2412.20524},
    title = {{Ns3 meets Sionna: Using Realistic Channels in Network Simulation}},
    institution = {arXiv},
    month = {12},
    number = {2412.20524},
    type = {cs.NI},
    year = {2024},
   }

About

ns3sionna is a software module that brings realistic channel simulation using ray tracing from Sionna to the ns-3 network simulator

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published