ANL-CEEESA
/
MIPLearn.jl
mirror of https://github.com/ANL-CEEESA/MIPLearn.jl.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '8c8ea8f932'
${ noResults }
MIPLearn.jl/README.md

3.1 KiB
Raw Blame History

MIPLearn.jl

MIPLearn is an extensible open-source framework for solving discrete optimization problems using a combination of Mixed-Integer Linear Programming (MIP) and Machine Learning (ML). See the main repository for more information. This repository holds an experimental Julia interface for the package.

1. Usage

1.1 Installation

To use MIPLearn.jl, the first step is to install the Julia programming language on your machine. After Julia is installed, launch the Julia console, type ] to switch to package manager mode, then run:

(@v1.6) pkg> add MIPLearn@0.2

This command should also automatically install all the required Python dependencies. To test that the package has been correctly installed, run (in package manager mode):

(@v1.6) pkg> test MIPLearn

If you find any issues installing the package, please do not hesitate to open an issue.

1.2 Describing instances

1.3 Solving instances and training

1.4 Saving and loading solver state

1.5 Solving training instances in parallel

2. Customization

2.1 Selecting solver components

2.2 Adjusting component aggresiveness

2.3 Evaluating component performance

2.4 Using customized ML classifiers and regressors

3. Acknowledgments

  • Based upon work supported by Laboratory Directed Research and Development (LDRD) funding from Argonne National Laboratory, provided by the Director, Office of Science, of the U.S. Department of Energy under Contract No. DE-AC02-06CH11357.
  • Based upon work supported by the U.S. Department of Energy Advanced Grid Modeling Program under Grant DE-OE0000875.

4. Citing MIPLearn

If you use MIPLearn in your research (either the solver or the included problem generators), we kindly request that you cite the package as follows:

  • Alinson S. Xavier, Feng Qiu. MIPLearn: An Extensible Framework for Learning-Enhanced Optimization. Zenodo (2020). DOI: 10.5281/zenodo.4287567

If you use MIPLearn in the field of power systems optimization, we kindly request that you cite the reference below, in which the main techniques implemented in MIPLearn were first developed:

  • Alinson S. Xavier, Feng Qiu, Shabbir Ahmed. Learning to Solve Large-Scale Unit Commitment Problems. INFORMS Journal on Computing (2020). DOI: 10.1287/ijoc.2020.0976

5. License

Released under the modified BSD license. See LICENSE for more details.