OSeMOSYS CODE

The OSeMOSYS code was originally written in GNU MathProg language. 
Recently, it has been translated into GAMS and Python programming languages, to reach a wider range of users from different backgrounds and levels of expertise.
Download the latest versions of OSeMOSYS, its add-ins and the related documentation on our
GitHub repository.

USER MANUAL

Access here the updated User Manual, including:
  1. An introduction to OSeMOSYS, its ethos and its structure;
  2. A guide for creating new models;
  3. An introduction to the training case study 'Atlantis';
  4. The instructions on how to run OSeMOSYS using a macOS operating system. 

DOWNLOAD MoManI

The Model Management Infrastructure (​MoManI), is an open source interface available for OSeMOSYS. 
All users are welcome to download and use the stand-alone version of MaManI, following the video tutorial on the right. 

​For windows 10:

​
For windows 7 and 8:


​Other supporting material:
  1. Installation instructions
  2. GLPK solver installation instructions. 
  3. MoManI user manual. 
  4. Atlantis data file.  ​
  5. Model transfer instructions 
NOTE for v1.9 and v2.9: 
This version has the updated OSeMOSYS code 2017-11-08 (both long and short versions). If you already have any of the previous versions of MoManI installed in your computer and you want to upgrade to v1.9 or v2.9, in order to be able to deploy the new equations, please pay attention to steps 6 and 7 of the installation instructions:
    6. "Do you want to import OSeMOSYS data to your database? Existing data may be overwritten. Press y/n", press YES.
    7. "Do you want to remove all current MoManI data? Press y/n", press YES. This will overwrite all the existing data and           import the new set of equations and the built-in models of MoManI.
 
If you have important models in your standalone MoManI that you do not want to lose, you should:
  1. Export your database;
  2. Install the new deployment of MoManI v.9;
  3. Import your database.

Instructions on exporting and importing the data base are given in supporting material 5 (above). 

Create an OSeMOSYS model

Video tutorial showing how to create a super simple energy system model in OSeMOSYS, using the MoManI interface.

OSeMOSYS in GNU MathProg 

VERSION HISTORY

At the links on the right you can find a version history and a Change Log for all the versions of OSeMOSYS since its first release.

Download older versions of the code

Below you find all the versions of OSeMOSYS published since its first release in 2011, along with their compact version (named 'short') and the training case studies Atlantis and UTOPIA compatible with them.

​The GNU Linear Programming Kit: 



​Background documentation on the basics of
the GNU MathProg programming language and
​the linear optimization logic applied in OSeMOSYS

Using OSeMOSYS with the solver CPLEX:

CPLEX is a commercial solver, more performing than the freely available GLPK solver for large problems. It is freely available for use by universities and in non-commercial projects.
To run OSeMOSYS using CPLEX, you need to have CPLEX and Python installed on your PC. In addition, you need to use the Python sorting script to sort and reorder the solution file generated in CPLEX, following the instructions available on the OSeMOSYS manual.