mirror of
https://github.com/ANL-CEEESA/MIPLearn.git
synced 2025-12-06 09:28:51 -06:00
Docs: minor fixes
This commit is contained in:
@@ -140,7 +140,7 @@
|
||||
<li class="first-level active"><a href="#about">About</a></li>
|
||||
<li class="second-level"><a href="#authors">Authors</a></li>
|
||||
|
||||
<li class="second-level"><a href="#acknowledgements">Acknowledgements</a></li>
|
||||
<li class="second-level"><a href="#acknowledgments">Acknowledgments</a></li>
|
||||
|
||||
<li class="second-level"><a href="#references">References</a></li>
|
||||
|
||||
@@ -156,7 +156,7 @@
|
||||
<li><strong>Alinson S. Xavier,</strong> Argonne National Laboratory <<a href="mailto:axavier@anl.gov">axavier@anl.gov</a>></li>
|
||||
<li><strong>Feng Qiu,</strong> Argonne National Laboratory <<a href="mailto:fqiu@anl.gov">fqiu@anl.gov</a>></li>
|
||||
</ul>
|
||||
<h3 id="acknowledgements">Acknowledgements</h3>
|
||||
<h3 id="acknowledgments">Acknowledgments</h3>
|
||||
<ul>
|
||||
<li>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.</li>
|
||||
</ul>
|
||||
|
||||
@@ -142,7 +142,7 @@
|
||||
|
||||
<li class="second-level"><a href="#selecting-solver-components">Selecting solver components</a></li>
|
||||
|
||||
<li class="second-level"><a href="#adjusting-component-aggresiveness">Adjusting component aggresiveness</a></li>
|
||||
<li class="second-level"><a href="#adjusting-component-aggressiveness">Adjusting component aggressiveness</a></li>
|
||||
|
||||
<li class="second-level"><a href="#evaluating-component-performance">Evaluating component performance</a></li>
|
||||
|
||||
@@ -189,11 +189,11 @@ solver = LearningSolver()
|
||||
solver.add(LazyConstraintComponent(...))
|
||||
</code></pre>
|
||||
|
||||
<h2 id="adjusting-component-aggresiveness">Adjusting component aggresiveness</h2>
|
||||
<h2 id="adjusting-component-aggressiveness">Adjusting component aggressiveness</h2>
|
||||
<p>The aggressiveness of classification components (such as <code>PrimalSolutionComponent</code> and <code>LazyConstraintComponent</code>) can
|
||||
be adjusted through the <code>threshold</code> constructor argument. Internally, these components ask the ML models how confident
|
||||
they are on each prediction (through the <code>predict_proba</code> method in the sklearn API), and only take into account
|
||||
predictions which have probabilities above the threshold. Lowering a component's threshold increases its aggresiveness,
|
||||
predictions which have probabilities above the threshold. Lowering a component's threshold increases its aggressiveness,
|
||||
while raising a component's threshold makes it more conservative. </p>
|
||||
<p>MIPLearn also includes <code>MinPrecisionThreshold</code>, a dynamic threshold which adjusts itself automatically during training
|
||||
to achieve a minimum desired true positive rate (also known as precision). The example below shows how to initialize
|
||||
|
||||
@@ -142,7 +142,7 @@
|
||||
|
||||
<li class="second-level"><a href="#documentation">Documentation</a></li>
|
||||
|
||||
<li class="second-level"><a href="#souce-code">Souce Code</a></li>
|
||||
<li class="second-level"><a href="#source-code">Source Code</a></li>
|
||||
|
||||
</ul>
|
||||
</div></div>
|
||||
@@ -172,9 +172,9 @@
|
||||
<li><a href="benchmark/">Benchmark utilities</a></li>
|
||||
<li><a href="problems/">Benchmark problems, challenges and results</a></li>
|
||||
<li><a href="customization/">Customizing the solver</a></li>
|
||||
<li><a href="about/">License, authors, references and acknowledgements</a></li>
|
||||
<li><a href="about/">License, authors, references and acknowledgments</a></li>
|
||||
</ul>
|
||||
<h3 id="souce-code">Souce Code</h3>
|
||||
<h3 id="source-code">Source Code</h3>
|
||||
<ul>
|
||||
<li><a href="https://github.com/ANL-CEEESA/MIPLearn">https://github.com/ANL-CEEESA/MIPLearn</a></li>
|
||||
</ul></div>
|
||||
@@ -273,5 +273,5 @@
|
||||
|
||||
<!--
|
||||
MkDocs version : 1.1
|
||||
Build Date UTC : 2020-05-05 18:38:02
|
||||
Build Date UTC : 2020-05-05 18:41:02
|
||||
-->
|
||||
|
||||
File diff suppressed because one or more lines are too long
Binary file not shown.
@@ -176,7 +176,7 @@ as follows:</p>
|
||||
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>To install MIPLearn in another Python environment, switch to that enviroment before running <code>make install</code>. To install the package in development mode, run <code>make develop</code> instead.</p>
|
||||
<p>To install MIPLearn in another Python environment, switch to that environment before running <code>make install</code>. To install the package in development mode, run <code>make develop</code> instead.</p>
|
||||
</div>
|
||||
<h3 id="using-learningsolver">Using <code>LearningSolver</code></h3>
|
||||
<p>The main class provided by this package is <code>LearningSolver</code>, a learning-enhanced MIP solver which uses information from previously solved instances to accelerate the solution of new instances. The following example shows its basic usage:</p>
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
* **Alinson S. Xavier,** Argonne National Laboratory <<axavier@anl.gov>>
|
||||
* **Feng Qiu,** Argonne National Laboratory <<fqiu@anl.gov>>
|
||||
|
||||
### Acknowledgements
|
||||
### 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.
|
||||
|
||||
|
||||
@@ -45,12 +45,12 @@ solver = LearningSolver()
|
||||
solver.add(LazyConstraintComponent(...))
|
||||
```
|
||||
|
||||
## Adjusting component aggresiveness
|
||||
## Adjusting component aggressiveness
|
||||
|
||||
The aggressiveness of classification components (such as `PrimalSolutionComponent` and `LazyConstraintComponent`) can
|
||||
be adjusted through the `threshold` constructor argument. Internally, these components ask the ML models how confident
|
||||
they are on each prediction (through the `predict_proba` method in the sklearn API), and only take into account
|
||||
predictions which have probabilities above the threshold. Lowering a component's threshold increases its aggresiveness,
|
||||
predictions which have probabilities above the threshold. Lowering a component's threshold increases its aggressiveness,
|
||||
while raising a component's threshold makes it more conservative.
|
||||
|
||||
MIPLearn also includes `MinPrecisionThreshold`, a dynamic threshold which adjusts itself automatically during training
|
||||
|
||||
@@ -20,9 +20,9 @@ The package uses Machine Learning (ML) to automatically identify patterns in pre
|
||||
* [Benchmark utilities](benchmark.md)
|
||||
* [Benchmark problems, challenges and results](problems.md)
|
||||
* [Customizing the solver](customization.md)
|
||||
* [License, authors, references and acknowledgements](about.md)
|
||||
* [License, authors, references and acknowledgments](about.md)
|
||||
|
||||
### Souce Code
|
||||
### Source Code
|
||||
|
||||
* [https://github.com/ANL-CEEESA/MIPLearn](https://github.com/ANL-CEEESA/MIPLearn)
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ import miplearn
|
||||
```
|
||||
|
||||
!!! note
|
||||
To install MIPLearn in another Python environment, switch to that enviroment before running `make install`. To install the package in development mode, run `make develop` instead.
|
||||
To install MIPLearn in another Python environment, switch to that environment before running `make install`. To install the package in development mode, run `make develop` instead.
|
||||
|
||||
### Using `LearningSolver`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user