PyLTEs

PyLTEs is a framework that allows to evaluate models of protocols/mechanisms/approach for LTE networks. Because of the wide flexibility it is hard to determine what is possible in them. It is easier to define, that this framework gives an opportunity to develop your own models. Currently there are few use-cases, for which PyLTEs was used.

WNOT logo

Opportunities

  • analyse the average signal level (SINR) in a network,
  • evaluate throughput of users in a network,
  • find the optimal Tx power of eNodeBs,
  • evaluate different Frequency Reuse.

Repository can be found here: PyLTEs

This software is a sub-output of PhD thesis. It is still under development, so you use it on your own responsibility. Do not give it to children and do not insert it into an microwave oven. Remember: software is not a state - it is a process.

Requirements:

  • Python (tested for Python3.5)
  • matplotlib
  • numpy
  • PyGMO v2 - if you plan to use optimization module (you can omit it if you don’t know yet)

Examples

How to run:

Download PyLTEs repository. You can make it via git or manually. In directory "PyLTEs" create a file "firstNetwork.py" and copy below code: 

from pyltes.network import CellularNetwork

network = CellularNetwork()
network.Generator.create1BSnetwork(1666)

network.Generator.insertUErandomly(20)
network.connectUsersToTheBestBS()

network.Printer.drawHistogramOfUEThroughput("thrHistogram")
network.Printer.drawNetwork(fillMethod="SINR", filename="sinrMap")

In terminal run python3.5 firstNetwork.py

After few seconds you should see an output on the terminal, and two new image files in the directory:

SINR map
Throughput histogram

That is all, have fun! Note: if you have other Python version you should run this script with your Python.

Example network files:

Download these files, copy to the directory with PyLTEs (as code from the above) and run in Python:

  • python3.5 firstNetwork.py (download script)
  • python3.5 smallNetworkSINR.py (download script)
  • python3.5 smallNetworkSectors.py (download script)

Research

Research papers that used PyLTEs:

  • P. Masek, J. Hosek, Y. Zakaria, D. Uhlir, V. Novotny, M. Slabicki, K. Grochla, "Experimental Evaluation of RAN Modelling in Indoor LTE Deployment", in Ultra Modern Telecommunications and Control Systems and Workshops (ICUMT), 2015 7th International Congress on, Brno 2015 Link
  • Slabicki, Mariusz, and Krzysztof Grochla, "Local Approach to Power Management in LTE Networks", 38th International Conference on Telecommunications and Signal Processing (TSP), 2015 Link
  • Grochla, Krzysztof, and Konrad Połys, "Subcarrier Allocation for LTE Soft Frequency Reuse Based on Graph Colouring", Information Sciences and Systems 2015: 30th International Symposium on Computer and Information Sciences (ISCIS 2015). Vol. 363. Springer, 2015 Link
  • Slabicki, Mariusz, and Krzysztof Grochla, "The Automatic Configuration of Transmit Power in LTE Networks Based on Throughput Estimation", IEEE 33rd International Performance Computing and Communications Conference (IPCCC), 2014 Link
Please let me know if you used this tool, I will be more than happy to add your paper here.

Todo / Work in Progress

Future plans

  • documentation,
  • functions to generate network (in file generator.py),
  • code cleaning (there is a lot to do),
  • improve this page.

Contribution

People

  • Mariusz Slabicki - main creator (www)
  • Konrad Polys - sereval small, but important improvements

Call for participation

If you see any opportunity to contribute to this project, do not hestitate!