Installation & Setup

Setup Steps

Setting up the AETOS model is straightforward. Follow the four steps below to get started:

Warning

Make sure you have Python and Miniconda installed beforehand.

Step 1 – Clone the Github Repository

Clone the GitHub repository, which contains everything from data editing to running and visualisation:

git clone https://github.com/ekousoulos/AETOS_model.git
cd AETOS_model

Step 2 – Create a Python Environment

Use Miniconda (or Anaconda) to create a clean Python environment for running the provided scripts:

conda create -n aetos python=3.11
conda activate aetos

Step 3 – Install a Solver

You need GLPK to generate the LP file, and a high-performance solver (CPLEX or Gurobi) to solve it efficiently:

  • GLPK (open-source, mandatory for LP file creation)

  • CPLEX (fast & robust, academic license available)

  • Gurobi (powerful commercial solver, free academic license)

  • CBC (open-source, decent performance for medium models)

  • HiGHS (very fast open-source solver, promising alternative for LP/MIP)

Example installation for GLPK (Linux/Mac):

conda install -c conda-forge glpk

Example installation for CPLEX (Linux/Mac/Windows):

conda install -c ibmdecisionoptimization cplex

Step 4 – Install Otoole

Otoole is the main utility for handling OSeMOSYS input/output.

pip install otoole

Additional Packages for Visualisation

For plotting and analysis, you will also need pandas, numpy and matplotlib withing your aetos Pyhon environment:

pip install pandas numpy matplotlib

✅ You’re all set! After these steps, you can run the AETOS workflows, edit data, solve scenarios, and visualise results.