This is an ns-3 3GPP NR module for the simulation of NR non-standalone cellular networks. Ns-3 is used as a base, on top of which we will add our module as plug-in (with limitations that will be discussed below).
We try to keep in sync with the latest advancements in ns-3-dev. However, in between our upstreamed patched are submitted and accepted, there will be a time in which it will be necessary to use patches "on top of" of ns-3-dev. Technically, these patches are maintained as a "branch" of the ns-3-dev development. The repository is ns-3-dev.
To download a working copy of the ns-3-dev repository with the latest changes to support the NR module, you can do the following:
$ git clone [email protected]:cttc-lena/ns-3-dev.git
$ cd ns-3-dev
$ git checkout nr
Provide your username and password when asked.
In case you are already using the git mirror of ns-3-dev, hosted at GitHub or GitLab, add the branch that make ns-3-dev supporting the NR module is easy as doing:
$ cd your-local-ns-3-dev-git
$ git remote add mirror-cttc-public [email protected]:cttc-lena/ns-3-dev.git
$ git fetch -p --all # fetch all the branches and update the refs
$ git checkout nr # checkout a local "nr" branch that points to mirror-cttc-public/nr
To test the installation, after following one of the previous point, you can do a simple configuration and compile test (more options for that later):
$ ./waf configure --enable-examples --enable-tests
$ ./waf
A success for both previous commands indicates an overall success.
As a precondition to the following steps, you must have a working local git repository. If that is the case, then, your local git repo is ready to include our nr module (only for authorized users):
$ cd src
$ git clone [email protected]:cttc-lena/nr.git
$ cd ..
Please note that the src/nr directory will be listed as "Untracked files" every
time you do a git status command. Ignore it, as the directory lives as an
independent module. As a result, we have now two parallel repository, but one
lives inside the other. We are working in getting nr working in the contrib/
directory, as per standard ns-3 rules.
Let's configure the project:
$ ./waf configure --enable-examples --enable-tests
If the NR module is recognized correctly, you should see "nr" in the list of built modules. If that is not the case, then most probably the previous point failed. Otherwise, you could compile it:
$ ./waf
If that command returns successfully, Welcome to the NR world !
To see the features, please go to the official webpage.
An updated list of published papers that are based on the outcome of this module is available here.
Simulation campaigns are stored in another repository, as they are not part of our release. If you have the permissions, please check https://gitlab.cttc.es/ns3-new-radio/sim-campaigns.
The Mobile Networks group in CTTC is a group of 10 highly skilled researchers, with expertise in the area of mobile and computer networks, ML/AI based network management, SDN/NFV, energy management, performance evaluation. Our work on performance evaluation started with the design and development of the LTE module of ns-3.
We are on the web.
In alphabetical order:
- Biljana Bojovic
- Lorenza Giupponi
- Sandra Lagen
- Natale Patriciello
Inspired by [mmWave module by NYU/UniPD] (https://github.com/nyuwireless-unipd/ns3-mmwave)
This software is licensed under the terms of the GNU GPLv2, as like as ns-3. See the LICENSE file for more details.