From Nsnam
Revision as of 11:57, 6 March 2010 by Tommaso (Talk | contribs) (Satellite network stack)

Jump to: navigation, search

Main Page - Current Development - Developer FAQ - Tools - Related Projects - Project Ideas - Summer Projects

Installation - Troubleshooting - User FAQ - HOWTOs - Samples - Models - Education - Contributed Code - Papers

ns-3 is applying to GSoC 2010. Check back to this page for updates. If you want more information about possibly participating in the ns-3 GSoC program, read the below information.

Note: ns-3 hasn't yet been accepted to GSoC 2010, so of course, participation is conditional on our acceptance into the program. Also, feel free to work on these projects outside of the GSoC program; we would be happy to mentor them as time permits.

GSoC 2010 Ideas

This webpage highlights project ideas for ns-3's Google Summer of Code 2010 effort.

About ns-3 Project

ns-3 is a discrete-event network simulator, with a particular emphasis on network research and education. Users of ns-3 can construct simulations of computer networks using models of traffic generators, protocols such as TCP/IP, and devices and channels such as WiFi, and analyze or visualize the results. Simulation plays a vital role in the research and education process, because of the ability for simulations to obtain reproducible results (particularly for wireless protocol design), scale to large networks, and study systems that have not yet been implemented. A particular emphasis in ns-3 is the high degree of realism in the models (including frameworks for real application and kernel code) and integration of the tool with virtual machine environments and testbeds; we view that researchers need to move more effortlessly between simulation, testbeds, and live experiments, and ns-3 is designed to facilitate that.

ns-3 has been in development since 2005 and has been making quarterly releases since June 2008 (our last release was ns-3.7 in January 2010). ns-3 is replacing the popular ns-2 tool which was developed in the 1997-2000 timeframe but became dated and unmaintained. The tool is coming into wide use; our web server logged over 10,000 successful downloads of our released software in January 2010, and we have a users mailing list of about 500 members now averaging 200-300 posts per month.

Project Ideas

The following are project ideas which the ns-3 team has identified as important and is most interested in working on as part of the 2010 Google Summer of Code. GSoC applicants are however free to propose their own ideas. In addition, please note that these ideas are not limited to Google Summer of Code, anyone is welcome to work on them. Please email the ns-developers list if one interests you. GSoC applicants are encourage to look over this list, pick one that especially interests them, think about it, and discuss potential approaches on the ns-developers list. That will help you develop the idea and present a concrete, meaningful application.

Each project idea has been tagged with the following properties:

  • Required Experience: Languages, concepts, or packages with which applicants must be familiar.
  • Bonus Experience: Other experience or familiarity which would be greatly helpful to applicants for this project.
  • Interests: Areas of particular relevance to this project, and an indicator of where successful students might apply their experiences coming out of this project.

Note that all of the projects require some experience and comfort with C++. Project ideas for which C++ is noted as a required experience will require more and deeper familiarity with the language. A similar notion applies to computer networking, BSD sockets, etc: Familiarity is strongly preferred, but is not required except where explicitly noted due to the topic being more advanced in that regard.

Priority Project Ideas

The following are work areas the ns-3 project has identified as the highest priorities, has several mentors available, and would be especially interested in having students work on.


  • TCP Validation. TCP is one of the most widely used and widely studied protocols in the Internet. ns-3 has two TCP implementations. Recently, RFC 5681 was published, documenting recommended TCP behavior. This project would consist of reviewing the ns-3 TCP implementations and testing them for conformance to RFC 5681 (and fixing any issues that were found to arise). One outcome of this project would be a test suite that will ensure that ns-3's TCP implementation is accurate and does not regress over time.
    • Required Experience: C++
    • Bonus Experience: Transport protocols or TCP
    • Interests: TCP and transport protocol performance
  • TCP Congestion Avoidance. Linux TCP implements a lot of TCP congestion control variants, including variants such as Veno, Westwood, Vegas, etc. This project would attempt to provide a library of congestion avoidance types, including test suites that exercised each one.
    • Required Experience: C++
    • Bonus Experience: Transport protocols or TCP
    • Interests: TCP and transport protocol performance

MAC and PHY Models

Mentors: Ruben Merz, Mathieu Lacage, Juliana Freitag Borin

  • Antenna radiation pattern. This project would implement support for antenna radiation patterns in the physical layer of ns-3. In addition to enhancing the realism of the ns-3 physical layer, this would also enable to implement directional antennas in ns-3.
    • Required Experience:
    • Bonus Experience: physical layer modeling and simulation, wireless networking
    • Interests: wireless networking, physical layer modeling and simulation


Mentors: Nicola Baldo, Manuel Requena, Adrian Sai-wah Tam, Ruben Merz

  • Click Modular Router Integration. This project would port and enable ns-3 simulations to use the Click modular router, widely used in research. This has been previously done for ns-2, and accomplishing this integration for ns-3 would enable faster protocol development and utilization of many existing protocol implementations.
    • Required Experience: C++
    • Bonus Experience: Click, routing architectures, routing protocols
    • Interests: Protocol development, routing architecture
  • Generalized Router Models/Structure. Many simulators, including ns-3, do not provide high fidelity models of Internet routers. For instance, intra-device latencies and input queuing behavior are not modeled. This project would adapt recent results on empirical router testing to develop a new, more detailed Router node type for ns-3.
    • Required Experience:
    • Bonus Experience: Routing architectures, routing protocols, queueing theory, statistics
    • Interests: High fidelity simulation, queueing theory, statistics, data driven model development

Network Stack

Mentors: Florian Westphal

  • Network Simulation Cradle for IPv4. Last year's ns-3 Google Summer of Code very successfully ported the Network Simulation Cradle, providing the ability to run Linux TCP code over ns-3's IPv4 stack. This project would extend that effort to completely port the Linux TCP/IPv4 stack. This wolud start by adding IPv4 support to NSC, then support for multiple interfaces, routing tables, and assigning addresses, then making those features available in ns-3.
    • Required Experience: C
    • Bonus Experience: Linux kernel, TCP/IP
    • Interests: Linux, operating systems, virtualization, software-in-the-loop

Emulation and Simulation In The Loop

Mentors: Craig Dowell

  • EMULAB Support and Integration. This project would attempt to emulate ns-3 and Emulab, a leading testbed for Internet research. Emulab experiments are described in tcl-like ns-2 scripts and are driven by ns-2 emulation. Two main goals of this effort would be: 1) Test and document how ns-3 emulation mode could be used in Emulab instead of ns-2, and compare its features and performance. 2) Investigate whether Emulab scripting could be moved to Python/ns-3 or whether ns-3 simulations need to generate Tcl for Emulab and attempt to do this integration.
    • Required Experience:
    • Bonus Experience: Emulab, ns-2, Tcl
    • Interests: Simulation, emulation, simulation-in-the-loop

Peer to Peer and Content Based Routing

Mentors: Marcello Caleffi

  • Mobile P2P. ns-3 currently does not include any implementation of Mobile Peer-to-Peer (P2P) systems. This project would implement some additional networking protocols based on a cross-layer approach between routing and Distributed Hash Tables (DHTs), such as ATR and MADPastry. Both the ns-2 implementations of the cited protocols are currently available and could be used as design guides.
    • Required Experience: C/C++
    • Bonus Experience: P2P, mobile ad hoc networks (MANETs), ns-2
    • Interests: P2P, DHT, MANETs, routing.

Additional Project Ideas

The following are additional project ideas that the ns-3 team has highlighted as important projects to support.

MAC and PHY Models

  • SNS for ns-3 Wifi. Staged Network Simulations (SNS) is a patch for the ns-2 wireless models which provides for function approximation and caching. That mechanism greatly speeds up the many calculations required in mobile wireless simulations. This project would incorporate those techniques into the ns-3 WiFi model.
    • Required Experience:
    • Bonus Experience: Software profiling, software tuning
    • Interests: Approximation, caching, software profiling, high performance computing, scientific computing
  • WPAN Device Models.
  • 802.11 WDS Support for nqsta.

  • CSMA/CD and Aloha
    • Description: Implement a CSMA/CD MAC protocol. Optionally, implement slotted aloha. A good reference describing the CSMA/CD and aloha protocols as well as basic theoretical results about these protocols is "Computer Networking: A Top-Down Approach.".
    • Required Experience: basic C++, know what aloha and CSMA/CD are.
    • Bonus Experience: ns-3 programming, contributions to open source projects.
    • Interests: networking, C++ programming
    • difficulty: easy

Network Stack

Applications and Systems

  • Large Scale Topology Generation and Management. ns-2 incorporates support for various topology generators, which would be useful to also support in ns-3. This project would investigate porting topology generators or mapping their output to ns-3 simulations. It would also touch on the problem of coherent IP addressing in generated topologies. In particular, recent work by the Emulab project may be useful in this regard.
    • Required Experience:
    • Bonus Experience: Graph theory, network management, Internet topology
    • Interests: Internet topology, Internet autonomous systems, graph theory
  • Agent-J Implementation. Agent-J is a Java library built on top of Protolib that enables Java networking application code to be run on real systems as well as network simulators such as ns-2 and OPNET. This project would port Agent-J to ns-3, thereby enabling users to develop applications in Java, as well as work with existing implementations. This project would require completing the above Protolib Integration effort first.
    • Required Experience: Java, C
    • Bonus Experience: JNI
    • Interests: Java, Java native code, simulation, P2P

Propose Your Own Idea

This section is intended to gather projects ideas and mentors for ns-3's Google Summer of Code 2010 application submission.
Any idea proposal is welcome as long as it is relevant to the ns-3 project. All proposed ideas are expected to have a mentor who will be responsible of following the project's evolution and evaluate the student during Google Summer of Code.

When adding a new idea proposal please make sure you use the following format:

Category of Idea

Mentor: mentor-name.

  • title of the idea. Concise description of the idea. Please make sure the description is clear enough for the students to understand.
    • Required Experience: Languages, concepts, or packages with which applicants must be familiar.
    • Bonus Experience: Other experience or familiarity which would be greatly helpful to applicants for this project.
    • Interests: Areas of particular relevance to this project, and an indicator of where successful students might apply their experiences coming out of this project.
    • difficulty: easy, medium or difficult
    • recommended reading: pointers to documentation, papers, specific bugs, etc.

Satellite network stack

Mentors: Tommaso Pecorella

Cognitive Radio Networks

Mentors: Marcello Caleffi

  • Cognitive Networks ns-3 currently does not include any implementation of routing protocols for cognitive networks. This project would implement some additional networking protocols for this scenario. Such protocols should be able to deliver packets across multiple channels avoiding to interfere with primary users. A cross-layer approach with the physical layer is required for spectrum sensing.
    • Required Experience: C/C++
    • Bonus Experience: mobile ad hoc networks (MANETs), ns-2
    • Interests: MANETs, routing, cognitive networks.

MAC and PHY models

Mentors: Nicola Baldo, Marco Miozzo

  • 3GPP Long Term Evolution (LTE) is an upcoming wireless technology already widely endorsed among mobile operators and manufacturers. Unfortunately, ns-3 still does not feature any model for LTE. The LTE standard is very complex, so it is not reasonable to develop a NetDevice modeling all aspects of LTE within the limited time span of the GSOC. Rather, we propose students to focus on the implementation of a subset of the functionality of LTE. This can include (but is not necessary limited to) the following aspects:
    1. Frequency Division Duplex PHY layer based on OFDMA/SC-FDMA (the ns-3 spectrum framework) could be used for this purpose)
    2. Medium Access Control (scheduling, timing, HARQ)
    3. Radio Link Control (RLC) (transparent mode (TM), unacknowledged mode (UM), acknowledged mode (AM))
    • Required Experience: C++, generic understanding of PHY and MAC layers
    • Bonus Experience: OFDM/OFDMA, HARQ
    • Interests: 4G mobile communications
    • Difficulty: medium to difficult (depending on what functionality the student proposes to implement)
    • Recommended reading:

<bibtex>@book{sesia2009lte, title={LTE, The UMTS Long Term Evolution: From Theory to Practice}, author={S. Sesia and I. Toufik and M. Baker}, year={2009}, publisher={Wiley Publishing} }</bibtex> <bibtex>@article{baldo-spectrum, title={Spectrum-aware Channel and PHY layer modeling for ns3}, author={N. Baldo and M. Miozzo}, howpublished = {ACM NSTools}, address = {Pisa, Italy}, month = {October}, year = {2009}, url = {} }</bibtex>