WELCOME! There are different types of community members, and different options to engage for each. So where to start?
  1. If you want to rapidly develop a country model there are instructions for how to
    1. Download INTERFACES and
    2. TUTORIALS to get started
    3. And, an INTRODUCTION TO THE ENERGY SYSTEM
  2. If you'd like to get to the source OSeMOSYS CODE bases, you can get strait to the GitHub repository. 
  3. Then there is the USER MANUAL and finally, if there are the communities including:
  4. An active USER GROUP (with many starting out) and project CONTRIBUTERS via GitHub.  

1.1 Rapidly build a model - INTERFACES

There are lots of interfaces for OSeMOSYS. They include:
For beginners, focusing on OSeMOSYS:
  1. The fully open and stand alone Model Management Infrastructure MoManI.
  2. The 'Simple and Nearly Done' clicSAND interface, that uses MS Office.
For advanced users, comfortable with the command line
  1. Otoole is a command line interface for OSeMOSYS complete with manual and GitHub repo. 
​Others:
  1. LEAP (for optimizing the electricity systems), OSINDA (in MS Access, and an old code version)
  2. And, the good ol' text file, we are little partial to Notepad++
Go to the 'Interfaces' page here for more ...

1.2 Rapidly build a model - TUTORIALS

Click on the links in-text for Tutorials on how to:
  1. (advanced) install and use OSeMOSYS with otoole
  2. (intermediate) install and develop a simple OSeMOSYS model with MoManI
  3. (beginner) install and develop a simple OSeMOSYS model with clicSAND (as part of an Open University course)
Tutorials for simple Linear Programming coding and the GNUMathprog language:
  1.  By IBM and R Ceron see part 1, part 2 and part 3  

1.3 Rapidly build a model - an INTRO to the ENERGY SYSTEM

Please navigate to this page, and to our YouTube channel for more. Under the CCG project a 'wiki-like' teaching kit is being developed to help teachers and government analysts develop custom course and knowledge management products. An initial instance of this available on an open-source Open University course, so please feel free to reference and use any of this material, if helpful in your activities!

2. OSeMOSYS CODE

The OSeMOSYS code is available in the GNU MathProg, GAMS and Python programming languages. They reach a range of users from different backgrounds and levels of expertise.
For advanced users: Download the latest versions of OSeMOSYS, its add-ins and the related documentation on our
GitHub repository to learn what GitHub is and how to use it, see this tutorial.

There are also interesting projects such as OSeMOSYS-PuLP for easier stochastic programming. 

3. USER MANUAL

The User Manual can be downloaded here, 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. 

3. USER GROUP and CONTRIBUTING COMMUNITY

OSeMOSYS is very much about community, the Ubuntu, or 'U' in U4RIA.  So please join in!
1. All of this seem baffling, and you want to 'call a friend'? Or need help crunching through the tutorials? Or want to bounce some ideas around? Or you want to help analysts or students find their feet? With hundreds of members and open discussions to browse, join the online discussion forum!
2. Do you want to contribute code, report bugs or request features? Then please joint the GitHub repro! There are lots of active elements for which insights and input would be very well received!

Useful files: 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). 

Useful Files - 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 2008, along with their compact version (named 'short') and the training case studies Atlantis and UTOPIA compatible with them.

Useful files - 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.