Antares Xpansion
Investment simulations for Antares studies
Loading...
Searching...
No Matches
Antares-Xpansion changelog

v1.7.0 (11/2025)

Bug fixes

  • fix: Missing Xpress loading log in benders (#1116)
  • Properly handle large candidate names in structure file (#1111)

CI

  • Bump actions/checkout from 5 to 6 (#1118)
  • Bump actions/download-artifact from 5 to 6 (#1108)
  • Bump actions/upload-artifact from 4 to 5 (#1109)

In development features

  • Trajectory
    • Restore Ram between iteration of lpnamer (#1110)
    • feat: Export all structure files in trajectory (#1112)
    • Feat!: Improve trajectory CLI API [ANT-4102] (#1113)

v1.6.1 (11/2025)

Bug fixes

  • Disable presolve by default when using Xpress to avoid numerical issues in some case (#1104)
    • It is still possible to enable it via –presolve command line option
  • Disable study update at the end of the optimization.
    • Study update has been found to take a several hours on some studies
    • It is still possible to invoke it with step study_update

v1.6.0 (10/2025)

Features

  • Update of Antares Simulator to version 9.3.1 (#1094)
  • Added a problem format option
  • Added the "presolve" feature for the solver (ANT-3267) (#1049)
    • Note: This feature has limitations with problems other than those from Antares Simulator
  • Improved Xpress context management (better persistence)

Bug fixes

  • Fixed MPI cache management
  • Fixed solver object copy
  • Fixed multi-thread protection (use of atomic)

Refactoring & Maintenance

  • Code cleanup (constructors, aliases, solver object management)
  • Refactoring of master generation
  • Update of scripts and CI actions (version bumps, Python 3.10 compatibility, etc.)
  • Minor documentation improvements and fixes

v1.5.0 (07/2025)

Features

  • New parameter master_solution_tolerance in settings.ini to define the tolerance in master solution sent to the subproblems, more details here
  • New parameter cut_coefficient_tolerance in settings.ini to define the tolerance in cuts coefficients and rhs, more details here
  • Simulator step:
    • Update Antares Simulator to 9.3.0
    • use the configured solver for first AND second optim
    • use basis for second optimization
    • XPRESS: add presolve parameter (PRESOLVE 1) for first and second optimizations

Bug fixes

  • Fix numerical issues with cuts coefficients and rhs in the Benders algorithm #986
  • General_data.ini is now properly edited when using the step problem_generation in memory mode.
  • Fix an issue when using "Cache" mode with MPI.

v1.4.0 (07/2025)

Important

  • Remove support for Ubuntu 20.04
  • Support Ubuntu 22.04

Features

  • Update Antares Simulator to 9.2.1
  • Output file criterions.txt is renamed LOLD.txt as it gathers the loss of load for each area at each iteration of the algorithm
  • End to end coherence of solvers : if Xpress is selected, it is also used for Antares step (does not work yet with memory mode), if coin is selected, sirius is used in Antares
  • Support for in memory problems between Antares and problem generation
  • Remove local UI support #972
  • Properly handle Antares Simulator errors. Especially error -9 occurring when running out of memory where Xpansion tried to continue in an improper state.
  • When using xpress, problems generated by problem_generation are in a binary format to save space.
  • Various performance improvements

For developers

  • Various improvement on dependency management through vcpkg.
  • Update and improve documentation
  • Use devtoolset 11 for CentOS and OL8
  • Add some tests using cucumber
  • Improve maintainability #965
  • Fix performance regression with missing TBB dependency #970
  • Add script to convert markdown docs for support in xwiki #973
  • Add script based on docker to generate centOS7 assets
  • Update project organisation. Mainly move headers file in dedicated include directory.
  • Update and apply clang-format
  • Enforce clang-format in CI

New Contributors

Full Changelog: https://github.com/AntaresSimulatorTeam/antares-xpansion/compare/v1.3.2...v1.4.0-rc3

v1.3.2 (07/2024)

Bug Fixes

  • Fix an issue where the application would crash if a user specified a value for "playlist_reset" in general_data.ini
  • Fix an issue with "singleFiles" assets on Ubuntu not working due to mpi runtime library not being found

v1.3.1 (07/2024)

Features

  • outer_loop option is renamed adequacy_criterion
  • New output file criterions.txt is added under lp/ dir to store adequacy criterions for all valid patterns ( area+criterion)
  • New output file PositiveUnsuppliedEnergy.txt is added under lp/ dir to store the amount of unsupplied energy for all valid patterns (area+criterion)

Bug Fixes

  • Fix Mpi issues on single file assets

Doc

  • The doc has been updated with a description of the adequacy criterion feature

v1.3.0 (06/2024)

⚠️ Single-file versions in Ubuntu are known to have MPI-related issues. Please use the other ones.

Features

  • Embedding Mpi in Windows
  • Allow sensitivity study to run unzipped study
  • Allow to specify a security criterion in number of hours of loss of load in the study. This feature is referred as outer_loop (renamed to adequacy_criterion in 1.3.1)

Bug Fixes

  • Duplicate Xpress loading messages
  • Remove whitespace from Xpress path on Windows
  • Fix truncated xpress path on linux

v1.2.2 (02/2024)

  • Update Antares simulator to 8.8.3

v1.2 (10/2023)

Features

  • Support "named mps" from Antares simulator
  • Use Antares Simulator 8.8.0-rc2

Bug fixes

  • Fix issue on windows with concurrent access to log files

v1.1.1 (09/2023)

Fix

  • Update performance graph in the documentation

v1.1.0 (09/2023)

Features

  • Implementation of the Benders by batch algorithm : performance improvements over the classical Benders algorithm
  • New parameter batch_size in settings.ini to tune the Benders by batch algorithm, more details here
  • Logs improvements:
    • Print user and hostname in the standard output and in reportbenders.txt
    • Print both walltime and cumulative CPU time for subproblems resolution

For developers

  • MPI dependency is now mandatory as benderssequential and bendersmpi have been merged in a single benders executable

v1.0.3 (02/2023)

Features

  • Use Antares-Simulator 8.5.0

Bug

  • Fix sensitivity not working with AntaresWeb

v1.0.2 (01/2023)

Bug fix

  • Fix missing performance graph from release

v1.0.1 (01/2023)

Features

  • Use Antares-Simulator 8.4.2

v1.0.0 (12/2022)

Features

  • Use Antares-Simulator 8.4.1
  • Performance improvement in execution time
    • In-out stabilisation of the Benders algorithm : new parameters separation_parameter and relaxed_optimality_gap to tune the stabilization, more information here
    • Parallelization of the problem_generation step
  • Performance improvement in disk space consumption : in full run mode i.e with option --step full (default behavior), Antares-Xpansion outputs are zipped within Antares study archive
  • Change the default value of relative_gap from 1e-12 to 1e-6

Documentation

v0.8.0 (10/2022)

Features

  • Use Antares-Simulator 8.2.2
  • Allow the use of different chronicles of link profile for each Monte-Carlo year. More information here
  • New directories to store additional constraints files and weights files:
    • Additional constraints files must be stored in user/expansion/constraints
    • Weights files must be stored in user/expansion/weights

Bug fixes

  • Allow the capa folder to be missing if unused
  • The algorithm now properly stops after max_iteration instead of max_iteration + 1 iterations

v0.7.0 (06/2022)

Features

  • Add the possibility to perform sensitivity studies on optimal investment solutions
  • Antares-Xpansion outputs are written in the expansion directory instead of the lp directory
  • Add timelimit option as a stopping criterion for the Antares-Xpansion algorithm
  • Add log_level option to choose the verbosity level of the solver
  • Add resume step, to provide the possibility to resume an unfinished study
  • Bump antares version used by Xpansion to 8.1.1

Bug fixes

For developers

  • Remove documentation generation with doxygen
  • Use C++17

v0.6.0 (12/2021)

Features

  • Antares-Xpansion is now compatible with Antares v8.1 studies
  • Add relative_gap option as a stopping criterion for the Antares-Xpansion algorithm
  • Add --antares-n-cpu option to use Antares-Simulator parallelism
  • Add -v, --version option to show Antares-Xpansion version
  • Add --antares-version option to show Antares-Simulator version
  • Add mergeMPS option to use a frontal resolution of the investment problem instead of Benders decomposition
  • Add --installDir option to be able to launch Antares-Xpansion from another directory than its own
  • Set default value of --simulationName to last in order to use the last Antares simulation

Bug fixes

  • Path to binaries directory was not found in some situations with python launcher and in python exclusive package
  • Correct bug when there are too many zeros in a link-profile

For developers

  • cpp lpnamer library is split into smaller and consistent libraries
  • Each Antares-Xpansion step has its own driver (python class) instead of the all-in driver
  • Upgrade to a new version of antares-deps (bug fix)

v0.5.0 (10/2021)

Features

  • In benders optimization, master problem .mps is written after each resolution
  • Several investment candidates on the same link
  • Review of candidates.ini file content (remove has-link-profile and add enable feature)

Bug fixes

  • Option keepMps was still removing some files needed for lp step
  • Correction of lp step call if it was the only step asked by user
  • Correction of optimization if hurdles cost were used in Antares-Simulator
  • Correction of optimization with binary additionnal constraint between investment candidates

For developers

  • Fix mergemps optimization in debug mode
  • Fix vcpkg on Github Actions
  • Add build cache for Github Actions (Ubuntu only) to speed up the build
  • Add sonarcloud analysis
  • Use of docker image for build on centos7
  • Add read-the-docs documentation
  • Generation of pdf user guide from read-the-docs documentation
  • Update Cmake to support Xpress on centos7

v0.4.0 (07/2021)

Features

  • A new multi solver interface is introduced, we no longer use OR-tools
  • The user can choose different solvers
  • The optimality gap is no longer hard-coded and the user can define it in the inputs
  • In case of unfeasible problems, the program now prints a console and file outputs
  • Solver traces can be activated by specific option in benders/bendersmpi console applications
  • Benders console information are now also printed on a specific file

Bug fixes

  • Remove erroneus value from the "problem_status" entry of the output json file
  • Fix display of overall cost of the best solutions

v0.3.0 (05/2021)

Features

  • Add yearly-weights file support to define a weight for each antares study MC years
  • Clean of intermediate result file after each simulation step
  • Creation of a Antares-Xpansion version with only one executable

Bug fixes

  • Use study stored in mount network drive
  • Problem accepting capital letters in candidate areas
  • Small alignment fix in output

v0.2.0 (04/2021)

Features

  • Add update step to update antares study links with calculated investments

Bug fixes

  • Invalid best iteration display in logs
  • Rounding problem in writing MPS with OR-tools
  • Antares-Xpansion can't be launched twice at the same time
  • Windows: Add Microsoft Visual Studio needed redistribuable to installer
  • Linux: wrong antares-solver executable permission and install directory

v0.1.0 (03/2021)

We’re happy to announce the first open-source version v0.1.0 of Antares-Xpansion. Antares-Xpansion optimizes the installed capacities of an Antares study.

The investment decisions are optimized by running Antares' simulations iteratively. At each iteration, the installed capacity of the investments are updated, and the simulations are repeated until the total costs have converged to a minimum. The total cost evaluated in this problem are the sum of the expected operation cost during one year and * *the investment annuity**. The user defines investment candidates. Candidate capacities for investment are necessarily links from an Antares study. Investment candidates can be:

  • transmission capacity between two areas
  • thermal generation capacity (located in a virtual node)
  • renewable generation capacity (located in a virtual node)
  • or even flexibilities (located in virtual nodes)

Notes

This version is only compatible with Antares v8.0 Antares-Simulator. The Antares binaries needed by Antares-Xpansion are available in the installation package of Antares-Xpansion.

An annual cost, a potential, a link-profile or an already-installed-capacity can be defined for each candidate. Linear constraints between the invested capacities of investment candidates can also be imposed.

The optimization is launched from the command prompt, where the details of the iterations are displayed.

The optimization can be launched on large studies. Computing performance can be improved by using MPI.