Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/blasf1/MintEDGE

MintEDGE is a flexible edge computing simulation framework that allows the configuration of various aspects of the infrastructure and enables researchers to test novel energy optimization strategies
https://github.com/blasf1/MintEDGE

Last synced: 2 months ago
JSON representation

MintEDGE is a flexible edge computing simulation framework that allows the configuration of various aspects of the infrastructure and enables researchers to test novel energy optimization strategies

Host: GitHub
URL: https://github.com/blasf1/MintEDGE
Owner: blasf1
License: mit
Created: 2023-07-17T09:20:52.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-11-29T09:23:54.000Z (11 months ago)
Last Synced: 2023-11-29T10:34:50.518Z (11 months ago)
Language: Python
Homepage:
Size: 840 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-edge-computing - MintEDGE

README

# MintEDGE

![Python](https://img.shields.io/badge/Python-3670A0?style=flat&logo=python&logoColor=ffdd54)
![Linux](https://img.shields.io/badge/Linux-E95420?style=flat&logo=linux&logoColor=FFFFFF)
![GitHub](https://img.shields.io/github/license/blasf1/MintEDGE)
![GitHub repo size](https://img.shields.io/github/repo-size/blasf1/MintEDGE)

## What is MintEDGE?

- SUMO [2] integration for realistic mobility scenarios.
- Agnostic w.r.t. Radio Access Network
- Define your own resource allocation strategy, focused on energy, QoS or both.
- Use real maps for more realistic scenarios.
- Ability to import real infrastructures. We provide data for the Netherlands [4] and Luxembourg [5].
- Import realistic mobility traces such as TAPASCologne [6] or VehiLux [7], or generate yours with SUMO or any other user mobility simulator.
- You can use MintEDGE to evaluate workload predictors as part of your resource allocation strategy. By default, we provide an ideal predictor.
- We use the realistic and lightweight energy model from [LEAF](https://github.com/dos-group/leaf/)'s [3].

## Orchestrator Operation and System Model

The operation of the orchestrator is based on the control of 2 matrixes and a vector:

- Status vector: The status vector indicates whether a Base Station (BS) hosts an edge server or not and whether the server is active.
- Assignation matrix: The assignation matrix represents where the requests received at each BS are attended, i.e., to which server are assigned. For instance, if a BS *i* receives 4 requests for service *k*, and then 2 of them are processed at server *j* and other 2 are processed at server *m*, then the value of the components *i,k,j* and *i,k,m* of the assignation matrix will be 0.5 each (half of the requests are processed in each destination server).
- Allocation matrix: Represents the share of CPU operations assigned to each service.

Tuning these three parameters, the orchestrator controls the operation of the edge infrastructure. MintEDGE makes it easy to find new energy efficient strategies that also take QoS into account.

## Installation

MintEDGE has been tested using Python 3.11. We recommend this version.

1. Clone the repository

```bash
git clone https://github.com/blasf1/MintEDGE.git
```

2. Go to the downloaded directory and install the requirements

```bash
cd MintEDGE
pip install -r requirements.txt
```

3. Install SUMO and its dependencies:

```bash
sudo apt-get install sumo sumo-tools sumo-doc
```

You can install it in your conda environment with the following command:

```bash
conda install -c blasf1 sumo
```

## Usage

You can run the simulator with the following command:

``` bash
python MintEDGE.py --simulation-time 3600 --seed 1 --output results.csv
```

You can adjust the simulation time, the seed and the output file in the command line. This facilitates launching multiple simulations simultaneously in distributed environments, e.g. a cluster with SLURM scheduler. Other settings can be adjusted in the settings.py file

Test your own efficient resource allocation or energy efficiency strategy by replacing the allocation_strategy.py file in the mintedge directory with your own.

## References

[1] Blas Gómez, Suzan Bayhan, Estefanía Coronado, José Villalón, Antonio Garrido, "MintEDGE: Multi-tier sImulator for eNergy-aware sTrategies in Edge Computing", In Proc. of ACM MobiCom '23, October, 2023. Madrid, Spain. DOI: 10.1145/3570361.3615727. (to appear)

[2] SUMO - Simulation of Urban MObility, [https://www.eclipse.org/sumo/](https://www.eclipse.org/sumo/). Accessed: 24/07/2023.

[3] Philipp Wiesner and Lauritz Thamsen. "[LEAF: Simulating Large Energy-Aware Fog Computing Environments](https://ieeexplore.ieee.org/document/9458907)" In the Proceedings of the 2021 5th IEEE International Conference on Fog and Edge Computing (ICFEC). 2021 [[arXiv preprint]](https://arxiv.org/pdf/2103.01170.pdf) [[video]](https://youtu.be/G70hudAhd5M)

[4] Antennekaart, [https://antennekaart.nl](https://antennekaart.nl). Accessed: 15/04/2023.

[5] Etablissements classés - Cadastre GSM. (2023). [Data set]. Administration de l’environnement. [http://data.europa.eu/88u/dataset/etablissements-classes-cadastre-gsm](http://data.europa.eu/88u/dataset/etablissements-classes-cadastre-gsm )

[6] [TAPASCologne project](http://kolntrace.project.citi-lab.fr/). Accessed: 24/07/2023.

[7] Yoann Pigné, Grégoire Danoy, Pascal Bouvry. A Vehicular Mobility Model based on Real Traffic Counting Data. In Thomas Strang et al., editors, Nets4Cars/Nets4Trains 2011, Volume 6596, Series Lecture Notes in Computer Science, Pages 131-142. ISBN: 978-3-642-19785-7. Springer, 2011. [VehiLux](https://vehilux.gforge.uni.lu/)