Luleå University of Technology · ns-3 3.47 · C++
This repository holds the five lab exercises for the course. Each lab is a folder containing starter C++ code, its instructions, and its deliverables list.
- Prepare your environment — docs/environment.md.
- Lab 00 is optional and is provided to help you verify your setup before starting Labs 01, 02, 03, and 04.
- In each lab, read the lab's
README.md, then follow its instructions document.
| Lab | Topic | Instructions (tasks) | Deliverables |
|---|---|---|---|
| Lab 00 | Optional introduction to ns-3 and NetAnim | Lab-00-Instructions.md | Optional setup-check outputs |
| Lab 01 | Propagation models: Friis, Two-Ray, COST231-Hata, Nakagami | Lab-01-Instructions.md | deliverables.md |
| Lab 02 | Infrastructure Wi-Fi: rate, payload, hidden terminal, roaming | Lab-02-Instructions.md | deliverables.md |
| Lab 03 | Ad-hoc multi-hop: hops, payload, TCP vs UDP, OLSR vs AODV | Lab-03-Instructions.md | deliverables.md |
| Lab 04 | LTE/EPC downlink: antennas, data rate, distance, mobile UE | Lab-04-Instructions.md | deliverables.md |
For Labs 01–04, the instructions document defines the required work and
deliverables.md defines the required results. Activities and outputs marked
optional are provided for additional practice and are not part of the
required lab work. Lab 00 is one such optional setup activity. Nothing else in
this repository overrides these rules.
| Document | Use it for |
|---|---|
| docs/environment.md | Installing and running ns-3.47 natively on macOS or Ubuntu/WSL2; NetAnim |
| docs/troubleshooting.md | Errors, empty results, missing output files |
| docs/references.md | ns-3 API, tutorials, standards and reading links |
| docs/simulation-background.md | Optional: how discrete-event simulation and RNG seeds work |
Canvas accepts each lab submission as one PDF. The PDF is a clear, curated
compilation of the required results listed in the lab's deliverables.md: add
the relevant calculations, tables, plots, screenshots, and brief explanations
in a logical order. It does not need to be a separate, extensive report.
Working data, animation, trace, or packet-capture files can be represented by a
readable table, excerpt, plot, or screenshot where relevant.
The filenames in deliverables.md are suggested for organizing the working
files used to prepare the PDF; those files are not uploaded separately to
Canvas. CSV files should have a header row, and plots should have labelled axes
and a legend. Bring the required results for the lab you are presenting to the
lab session. Optional activities, including Lab 00, are available for practice
but are not part of the required deliverables or presentation.
Canvas is the course channel for deadlines, submission format and any corrections to these instructions. If Canvas and this repository disagree, Canvas applies.
Check the lab's instructions, then docs/troubleshooting.md. If that is not enough, ask a supervisor and include the lab, the exact command you ran, and the full error output.