v1.4.0 (12/2024)
Features
- Update Antares Simulator to 9.2
- 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.
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
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.
1.12.0