Home

Awesome

<img src="https://github.com/XiongPengNUS/rsome/blob/master/rsologo.png?raw=true" width=200>

Robust Stochastic Optimization Made Easy

PyPI PyPI - downloads Commit activity Last commit tests Docs Project Status: Active - The project has reached a stable, usable state and is being actively developed. GitHub closed issues GitHub issues

RSOME (Robust Stochastic Optimization Made Easy) is an open-source Python package for generic modeling of optimization problems (subject to uncertainty). Models in RSOME are constructed by variables, constraints, and expressions that are formatted as N-dimensional arrays. These arrays are consistent with the NumPy library in terms of syntax and operations, including broadcasting, indexing, slicing, element-wise operations, and matrix calculation rules, among others. In short, RSOME provides a convenient platform to facilitate developments of robust optimization models and their applications.

Content

Installation <a id="section2"></a>

The RSOME package can be installed by using the <code>pip</code> command:


pip install rsome


Solver interfaces <a id="section3"></a>

The RSOME package transforms robust or distributionally robust optimization models into deterministic linear or conic programming problems, and solved by external solvers. Details of compatible solvers and their interfaces are presented in the following table.

SolverLicense typeRequired versionRSOME interfaceSecond-order cone constraintsExponential cone constraintsSemidefiniteness constraints
scipy.optimizeOpen-source>= 1.9.0lpg_solverNoNoNo
CyLPOpen-source>= 0.9.0clp_solverNoNoNo
OR-ToolsOpen-source>= 7.5.7466ort_solverNoNoNo
ECOSOpen-source>= 2.0.10eco_solverYesYesNo
GurobiCommercial>= 9.1.0grb_solverYesNoNo
MosekCommercial>= 10.0.44msk_solverYesYesYes
CPLEXCommercial>= 12.9.0.0cpx_solverYesNoNo
COPTCommercial>= 7.2.2cpt_solverYesYesYes

Getting started <a id="section4"></a>

Documents of RSOME are provided as follows:

Team <a id="section5"></a>

RSOME is a software project supported by Singapore Ministry of Education Tier 3 Grant Science of Prescriptive Analytics. It is primarly developed and maintained by Zhi Chen, Melvyn Sim, and Peng Xiong. Many other researchers, including Erick Delage, Zhaowei Hao, Long He, Zhenyu Hu, Jun Jiang, Brad Sturt, Qinshen Tang, as well as anonymous users and paper reviewers, have helped greatly in the way of developing RSOME.

Citation <a id="section6">

If you use RSOME in your research, please cite our papers:

Bibtex entry:

@article{chen2021rsome,
  title={{RSOME} in {Python}: An open-source package for robust stochastic optimization made easy},
  author={Chen, Zhi and Xiong, Peng},
  journal={INFORMS Journal of Computing},
  volume={35},
  number={4},
  pages={717--724},
  year = {2023},
  publisher={INFORMS}
}
@article{chen2020robust,
  title={Robust stochastic optimization made easy with RSOME},
  author={Chen, Zhi and Sim, Melvyn and Xiong, Peng},
  journal={Management Science},
  volume={66},
  number={8},
  pages={3329--3339},
  year={2020},
  publisher={INFORMS}
}