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 (Munich) | Results from simulation |
More information can be found in our paper: Ns3Sionna paper
We recommend using Linux (e.g. Ubuntu 22 or higher) and a multi-core/GPU compute node.
- 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
- Download ns3-sionna
git clone https://github.com/tkn-tub/ns3sionna.git
cd ns3sionna/
./install_packages.sh
./bootstrap.sh
- Build everything in ns3
cd ../ns-3.40/
./ns3 configure -d debug --enable-examples
./ns3 build
- 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
- Start sionna server
cd ./ns3sionna/sionna_server/
source sionna-venv/bin/activate
python3 sionna_server.py
- Start a ns-3 example script
cd ns-3.40/
./ns3 run scratch/ns3-sionna/example-sionna.cc
All examples can be found here.
- SISO only
- Anatolij Zubow, TU-Berlin, zubow@tkn
- Sascha Roesler, TU-Berlin, zubow@tkn
- tkn = tkn.tu-berlin.de
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},
}