LENA_logo_3_588x470_whitebkg_margins LenaNetworkTopology



LENA is an open source product-oriented LTE/EPC Network Simulator that allows LTE small/macro cell vendors to design and test Self Organized Network (SON) algorithms and solutions. Target applications for LENA include the design and performance evaluation of DL & UL Schedulers, Radio Resource Management Algorithms, Inter-cell Interference Coordination solutions, Load Balancing and Mobility Management, Heterogeneous Network (HetNets) solutions, End-to-end QoE provisioning, Multi-RAT network solutions and Cognitive LTE systems. LENA is based on the popular ns-3 network simulator for internet systems. The development of LENA is open to the community in order to foster early adoption and contributions by industrial and academic partners.

Video Gallery


Source Code Repositories

Stable version

The most recent stable version of the LENA code gets periodically merged with the official version of ns-3, and is therefore available from the ns-3 website.

Development version

The development version of the LENA code is available at http://lena.cttc.es/hg/lena/

You can download the latest development code using this command:

 hg clone http://lena.cttc.es/hg/lena/

Note: the development version does not support python bindings. Please configure it with this command:

 ./waf configure --disable-python --enable-examples --enable-tests

Model Documentation

The LTE-EPC model developed within the LENA project comes with the following documentation:

  • design documentation
  • user documentation
  • testing documentation
  • profiling documentation

This documentation is available both in html format and in pdf format.

Following the ns-3 guidelines, the source of the documentation is maintained in .rst format and is stored in the mercurial repository alongside with the source code.

Recently, a new module on LTE and Wi-Fi coexistence has been developed, but it is still not merged to ns-3-dev main tree. More information can be found here.

API Documentation

The API documentation of the code implementing the LTE-EPC model is generated using doxygen from the source code, as per the ns-3 guidelines; note that it includes not only the LTE-EPC API but also the complete ns-3 API. The API documentation for the latest stable version is available in html format from the ns-3 website. Similar documentation can be generated for the LENA development version using doxygen.

Questions about how to use LENA

The LENA developers team participates actively in the ns-3 community, and encourages LENA users to do the same. If you have a question about how to use the LENA code, you are recommended to post an email to the ns-3-users mailing list. Some tips before posting a question:

  • check the LTE module documentation, most questions already have an answer there
  • search previous posts on ns-3-users, chances are that somebody asked the same question before

How to contribute to the development

The development of the ns-3 LTE module is still ongoing and open to contributions by the community.

If you are interested in contributing, e.g. developing new functionality or fixing a bug, feel free to drop an email to: info-lena at cttc dot es. Main people involved in CTTC in LENA will receive the email and write you back.


In addition to the above mentioned documentation, the following papers describe some specific aspects of LENA: