Skip to content

Antares Simulator's GEMS interpreter

This section outlines the approach for configuring and utilizing the Antares Modeler, the interpreter for the GEMS language inside Antares Simulator.

Installation

The following link provides access to the most recent stable version of the Antares Simulator.

Download and Extract

  1. Go to the Antares Simulator releases page

  2. Download the appropriate archive for your platform:

    rte-antares-<simulator-version>-installer-64bits.zip

    rte-antares-<simulator-version>-Ubuntu-<ubuntu-version>.tar.gz

  3. Extract the archive to your desired location:

    Right-click the archive and select "Extract All"

    tar -xzf rte-antares-<simulator-version>-Ubuntu-<ubuntu-version>.tar.gz
    

Locate the Executables

After extraction, navigate to the bin folder inside the extracted directory. You will find:

  • Antares Modeler executable (antares-modeler or antares-modeler.exe)
  • Antares Solver executable (antares-solver or antares-solver.exe)

Antares Modeler is currently a command-line–only tool with no graphical interface yet. It is used for launching studies with full GEMS syntax. Antares Solver is designed for running Antares legacy study and hybrid studies comprising a mix of legacy and Gems models.

cmake\
pkgconfig\
antares-batchrun.exe
antares-config.exe
antares-modeler         # GEMS studies
antares-solver          # hybrid and legacy studies
antares-study-finder
cmake\
pkgconfig\
antares-batchrun.exe
antares-config.exe
antares-modeler         # GEMS studies
antares-solver          # hybrid and legacy studies
antares-study-finder

Launch the resolution of a GEMS study

Opening a terminal:

Press Win + R, type cmd or powershell, and press Enter

Press Ctrl + Alt + T or search for "Terminal" in your applications menu

Antares Modeler

First study simulation with Modeler:

Let’s check if Modeler is working correctly.

  • Download the example study:

    Download the first Quick Start Example (QSE_1_Adequacy) and save the "QSE_1_Adequacy" folder. Download the first Quick Start Example (QSE_1_Adequacy) and save the "QSE_1_Adequacy" folder.

  • Run simulation:

    .\bin\antares-modeler.exe .\<absolute path to QSE_1_Adequacy study folder>
    
    ./bin/antares-modeler ./<absolute path to QSE_1_Adequacy study folder>
    
  • Check for success:

    If you see logs like these, Modeler works correctly ! If you see logs like these, Modeler works correctly !

    Especially, [yyyy-mm-dd HH:MM:SS][modeler][infos] Simulation table is written in: QSE_1_Adequacy/output/simulation_table--yyyymmdd HHMMSS.csv Especially, [yyyy-mm-dd HH:MM:SS][modeler][infos] Simulation table is written in: QSE_1_Adequacy/output/simulation_table--yyyymmdd HHMMSS.csv

    [2025-12-16 14:35:48][modeler][infos] Study path: QSE_1_Adequacy/
    [2025-12-16 14:35:48][modeler][infos] Parameters loaded
    [2025-12-16 14:35:48][modeler][infos] Loading modeler files...
    [2025-12-16 14:35:48][modeler][infos] Library loaded: basic_models_library
    [2025-12-16 14:35:48][modeler][infos] Libraries loaded
    [2025-12-16 14:35:48][modeler][infos] Optim config file not found at QSE_1_Adequacy/input/optim-config.yml
    [2025-12-16 14:35:48][modeler][infos] System loaded
    [2025-12-16 14:35:48][modeler][infos] Data-series could not be loaded: Not a directory: QSE_1_Adequacy/input/data-series
    [2025-12-16 14:35:48][modeler][infos] Timeseries loaded
    [2025-12-16 14:35:48][modeler][infos] No scenario builder found, skipping scenario groups loading.
    [2025-12-16 14:35:48][modeler][infos] Scenario groups loaded
    [2025-12-16 14:35:48][modeler][infos] Modeler loaded in 0.003 s
    [2025-12-16 14:35:48][modeler][infos] linear problem of System loaded
    [2025-12-16 14:35:48][modeler][infos] Linear problem provided
    [2025-12-16 14:35:48][modeler][infos] Number of variables: 18
    [2025-12-16 14:35:48][modeler][infos] Number of constraints: 6
    [2025-12-16 14:35:48][modeler][infos]
    [2025-12-16 14:35:48][modeler][infos] Modeler build took 0.002 s
    [2025-12-16 14:35:48][modeler][infos] Output folder : QSE_1_Adequacy/output
    [2025-12-16 14:35:48][modeler][infos] Launching resolution...
    [2025-12-16 14:35:48][modeler][infos] Solved in 0.001 s
    [2025-12-16 14:35:48][modeler][infos] Simulation table is written in: QSE_1_Adequacy/output/simulation_table--20251216-1435.csv
    [2025-12-16 14:35:48][modeler][infos] Simulation Table is generated in 0 ms
    

Launch the resolution of an Hybrid study

Antares Solver

  • Use the Hybrid Study tutorial :

Refer to the tutorial inside the Interoperability - Antares Hybrid Mode section

  • Run the following commands:

    rte-antares-x.x.x-installer-64bits\bin\antares-solver.exe <path-to-study>
    
    ./rte-antares-x.x.x-installer-64bits/bin/antares-solver <path-to-study>
    

Replace <path-to-study> with the path to your Antares study directory.

Requirements

The complete installation, documentation is available on the official documentation website.

In addition, Antares Modeler requires inside, the study folder, a parameters.yml file to run a GEMS study, and the process for creating this file is detailed in this section. Unlike the GemsPy interpreter, Modeler depends on this configuration file.

Additional Resources

Resource Link
Antares Simulator GitHub Antares Simulator on GitHub
Online Documentation Antares Simulator Docs
Modeler Documentation GEMS Modeler Docs
Examples See the repository's examples/ directory
FAQ FAQ
GitHub Issues Antares Simulator Issues
Contact Support Contact support