Skip to content

Add SCIP Persistent Support #3200

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 47 commits into
base: main
Choose a base branch
from
Open

Add SCIP Persistent Support #3200

wants to merge 47 commits into from

Conversation

Opt-Mucca
Copy link

Fixes # .

None.

Summary/Motivation:

Adds support for SCIP persistent solving. Persistent solving uses the python interface to SCIP directly as opposed to the current standard that involves read and writing a temporary model file.

The new dependency that it introduces is PySCIPOpt

Changes proposed in this PR:

  • SCIPPersistent
  • SCIPDirect
  • Some new tests for the introduced features

Legal Acknowledgement

By contributing to this software project, I have read the contribution guide and agree to the following terms and conditions for my contribution:

  1. I agree my contributions are submitted under the BSD license.
  2. I represent I am authorized to make the contributions and grant the license. If my employer has rights to intellectual property that includes these contributions, I represent that I have received permission to make contributions and grant the required license on behalf of that employer.

@Opt-Mucca
Copy link
Author

Two open questions left for this pull request:

  • Is the current standard usage of persistent solving through the APPSI? If so then I should consider adding that.
  • I avoided tinkering with the GitHub action workflow scripts. I'm not sure if it is appropriate to add a PySCIPOpt dependency there.

For info of how I tested the code:

  • pip install pyscipopt
  • python pyomo/solvers/tests/checks/test_SCIP{Persistent/Direct}.py

@mrmundt
Copy link
Contributor

mrmundt commented Mar 18, 2024

@Opt-Mucca - answering your questions:

  1. The current standard is APPSI, yes; however, the future standard is going to be using the persistent interface within pyomo.contrib.solver (the preview of the reworked solver interface system)
  2. If PySCIPOpt is needed in order to run tests, then yes, absolutely, it's appropriate. Happy to help with that if you'd like.

@Opt-Mucca
Copy link
Author

@mrmundt Thanks for the fast reply!

  1. After having a glance at pyomo.contrib.solver, it seems to overlap pretty heavily with the direct interfaces in pyomo.solvers.plugins. So that should save on work. I will probably avoid writing the APPSI functionality if there's soon to be a newer interface, but can do if there's demand.
  2. Help would be appreciated! I assumed the only changes needed were those that are present in the other PRs Added MAiNGO appsi-interface #3165 and [WIP] Add COPT support for Pyomo #2880 (replacing coptpy / maingopy with pyscipopt). If that's right then I can add those lines.

@mrmundt
Copy link
Contributor

mrmundt commented Mar 18, 2024

@Opt-Mucca - No problem!

  1. Sounds good! There will be inevitable changes for the new interface (e.g., configuration options, results object, solution statuses, etc.), but we hope that they aren't too miserable for porting.
  2. That's about it, yup! Make sure to consider both the pip and conda situations, though, because we test environments built by both types of package managers.

@Opt-Mucca
Copy link
Author

I have now added:

  • Some automatic documentation for SCIPPersistent similar to other solver interfaces
  • The pip instructions to the .github/workflows. (I avoided conda because I'm not familiar with it. I also only added PySCIPOpt via pip when using CPython)

Copy link
Contributor

@mrmundt mrmundt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for submitting this PR! Some comments from a quick pass.

Comment on lines +32 to +37
try:
import pyscipopt

scip_available = True
except ImportError:
scip_available = False
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I theorize that @jsiirola may want this logic instead put in the import attempt code: https://github.com/Pyomo/pyomo/blob/main/pyomo/common/dependencies.py#L1037

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will ping @jsiirola again about this thought.

Comment on lines +33 to +38
try:
import pyscipopt

scip_available = True
except ImportError:
scip_available = False
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I theorize that @jsiirola may want this logic instead put in the import attempt code: https://github.com/Pyomo/pyomo/blob/main/pyomo/common/dependencies.py#L1037

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general, yes - but as this is in a testing file, it is not a big deal.

@mrmundt
Copy link
Contributor

mrmundt commented Mar 19, 2024

@Opt-Mucca - Please make sure you're on the most recent version of black and run (in the root): black . -S -C --exclude examples/pyomobook/python-ch/BadIndent.py

@Opt-Mucca
Copy link
Author

@mrmundt Black should be run and all the issues responded to.

@mrmundt
Copy link
Contributor

mrmundt commented Mar 19, 2024

@Opt-Mucca - Spelling is the new failure. (You are suffering the same issue as all the core devs... The auto-linter and spell checker.)

@Opt-Mucca
Copy link
Author

@mrmundt TIL there are auto-linters that double as spell checkers. (I'll fix the spelling errors that come up each time the test fails. If it's just the two errors then I'm properly amazed.)

@mrmundt
Copy link
Contributor

mrmundt commented Mar 19, 2024

@Opt-Mucca - If you could have heard the griping in our weekly dev call when I introduced the spell checker...

@Opt-Mucca
Copy link
Author

@mrmundt I can imagine (would probably be guilty of griping even if makes sense)

For the currently failing runs: I've added a fix that should work, but I will ask some colleagues tomorrow. (I'm not the greatest the warm start code). The fixes raise some warning where a loaded solution has variables of incorrect values (this may stem from non specified variables having a default value of 0)

The current reason of the pipeline failure: SCIP was trying to load an invalid solution before checking for feasibility (I think this is a longstanding python error with the interface and one of the functions)

The added solution: I simply added a check on the feasibility of the solution before adding it to the solution storage.

I will check with colleagues, but I'm not sure on how SCIP handles partial solutions. I am not familiar or don't know if we have any functionality like Gurobi that tries to complete the solution. This also holds for trying to repair a given infeasible solution.

@Opt-Mucca
Copy link
Author

Support for partial solution loading is now added. The failed tests are now passing locally too.

@mrmundt
Copy link
Contributor

mrmundt commented Apr 9, 2024

@Opt-Mucca - If you need help with your tests, please let us know. We tend to ignore PRs until the tests are passing.

@mrmundt
Copy link
Contributor

mrmundt commented Feb 19, 2025

FYI, the doc build/doc test failures are NOT RELATED. I have #3479 open to resolve it.

@Opt-Mucca
Copy link
Author

I added a minor change: I no longer check what type the LHS of a constraint is. I added it originally because pyomo supports numpy floats and ints being passed, and I observed some crashes in SCIP's model creation. I looked into this a month or two ago, and concluded that it only happens from np.version() < 2 and for LHS values. So I've just removed the check for the RHS. This should save many users getting spammed with warnings. Associated issues if anyone wants to help: scipopt/PySCIPOpt#937

@mrmundt
Copy link
Contributor

mrmundt commented Mar 20, 2025

@Opt-Mucca - can you do me one last favor please? I updated all of the existing files recently to reflect that our copyright is 2008 - 2025 now (see PR #3515 ) - could you please update your new files here to reflect that as well?

Copy link
Member

@jsiirola jsiirola left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Apologies for how long it took to get to this. Overall, this is not in too bad of shape, but there are a couple things that would be very good to rework:

  • avoid the use of StandardRepn, and instead use / write a walker based on StreamBasedExpressionVisitor.
  • rework this so we only need to walk each expression once (this is a performance issue, and is particularly important for persistent interfaces where performance is one of the big motivators).

f"PySCIPOpt through Pyomo does not yet support expression type {type(pyomo_expr)}"
)

new_expr += get_nl_expr_recursively(repn.nonlinear_expr)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

get_nl_expr_recursively should be reimplemented by building on StreamBasedExpressionVisitor - among other things, that routine has a graceful fallback to a nonrecursive implementation for very deep / unbalanced expressions (which we can get in Pyomo).

Comment on lines +222 to +224
repn = generate_standard_repn(expr, quadratic=True)
else:
repn = generate_standard_repn(expr, quadratic=False)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be better to build off the pyomo.repn.quadratic/QuadraticRepnVisitor and not use generate_standard_repn - generate_standard_repn has several bugs and is going to be deprecated as soon as we can get everything ported off it.

Comment on lines +231 to +233
if var.is_fixed():
val = var.value
return val, val
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should verify that the var is not fixed outside it's bounds (i.e., catch trivially infeasible models)

Comment on lines +274 to +279
e = sys.exc_info()[1]
msg = (
"Unable to create SCIP model. "
f"Have you installed PySCIPOpt correctly?\n\n\t Error message: {e}"
)
raise Exception(msg)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be better to log this message to the logger as an error and then re-raise the original exception.

Comment on lines +138 to +145
degree = repn.polynomial_degree()
if (max_degree is not None) and (degree > max_degree):
raise DegreeError(
"While SCIP supports general non-linear constraints, the objective must be linear. "
"Please reformulate the objective by introducing a new variable. "
"For min problems: min z s.t z >= f(x). For max problems: max z s.t z <= f(x). "
"f(x) is the original non-linear objective."
)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would avoid calling polynomial_degree and instead do this check after building the QuadraticRepn: polynomial_degree is almost as slow as just building the repn, and you can get the degree from the repn by seeing if there are any quadratic terms and if the nonlinear expression is None.

Comment on lines +149 to +164
if len(repn.linear_vars) > 0:
referenced_vars.update(repn.linear_vars)
new_expr += sum(
repn.linear_coefs[i] * self._pyomo_var_to_solver_var_expr_map[var]
for i, var in enumerate(repn.linear_vars)
)

for i, v in enumerate(repn.quadratic_vars):
x, y = v
new_expr += (
repn.quadratic_coefs[i]
* self._pyomo_var_to_solver_var_expr_map[x]
* self._pyomo_var_to_solver_var_expr_map[y]
)
referenced_vars.add(x)
referenced_vars.add(y)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fundamental question: why are you using a representation compiler at all if you are just going to create a new expression tree? You could just use a single expression walker to generate the new expression directly without going through the compiled intermediary.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @jsiirola thanks for the review! It's now my turn to apologise for taking so long though...... Have started a new job and simply been waiting on a burst of motivation some evening to look at this.

I used the representation compiler because it was the first thing that I found and seemed to fit what I wanted. I do not have an overview whatsoever of the various Pyomo data structures, so that's on me for not doing enough research. I will try and look into StreamBasedExpressionVisitor and make the relevant changes (No complaints from me if someone else on the team wants to do the changes themself). Is there some particular date for when it would be good if this PR was finished?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Opt-Mucca: No worries! The internals of Pyomo are still rather poorly documented (not enough nights and weekends), so there is no reason to expect you to have stumbled across the "right" set of utilities. If you are looking for a potentially useful inspiration, you might look at the Pyomo2SympyVisitor walker for converting Pyomo expressions to sympy expressions (in pyomo/core/expr/sympy_tools.py)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh - and you asked about timeline... We are currently planning for the next release on 6 August, so ideally, we would aim for all PRs to be in final review about a week before that.

if (max_degree is not None) and (degree > max_degree):
raise DegreeError(
"While SCIP supports general non-linear constraints, the objective must be linear. "
"Please reformulate the objective by introducing a new variable. "
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a reason not to just do that reformulation for the user here?

Copy link
Author

@Opt-Mucca Opt-Mucca Jul 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am of the opinion that the modelling language should not be doing something that the user didn't specifically ask for. For example, creating some "shadow" variable that is likely never revealed to the user and would cause a mismatch in number of variables in the model and the number of variables in the users list / dict of "standard" variables. We have had many debates about this in PySCIPOpt.
Completely fair to have the stronger opinion of "Make it as easy as possible for the user"

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general, I completely agree. However, we have historically made exceptions for trivial changes that

  • can only be implemented in a single way
  • enable a solver to be run on a model that a rational user would expect the solver to run on (that is, we want users to be able to easily switch between solvers without having to recode their model)

Examples of changes that we do make are:

  • Adding a trivial (fixed) variable to LP files so that we can add constant terms to objectives (several solvers do not accept a constant as part of the objective expression in LP format)
  • Converting the optimization sense (max to min) for solvers that only accept one sense.

In my opinion, this would fall into the same category... But I also think that this is on the edge, and tossing a warning for the user would be completely warranted. (I can also be convinced that this reformulation is a "bridge too far" and the error is the right path forward).

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You've now rather convinced me..... I still don't like the choice, but I do believe that if there's already some exceptions then this would be an additional sensible one,

Comment on lines +33 to +38
try:
import pyscipopt

scip_available = True
except ImportError:
scip_available = False
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general, yes - but as this is in a testing file, it is not a big deal.

@michaelbynum
Copy link
Contributor

@Opt-Mucca, we are refactoring the solver interfaces in pyomo/contrib/solver (https://pyomo.readthedocs.io/en/stable/explanation/experimental/solvers.html). We would really like this functionality there instead of in pyomo/solvers/plugins/solvers (which will eventually become deprecated). I plan to build off your branch by moving the files into pyomo/contrib/solver and reworking them to match the new interfaces. Please let us know if you have any objections/concerns.

@Opt-Mucca
Copy link
Author

Opt-Mucca commented Jul 23, 2025

@michaelbynum No complaints at all. Sorry in advance if the code is a bit sloppy (mainly the SCIP naming and constant checks for numpy.float as a LHS). Feel free to ping me if you have questions about it.
Does that mean that there's no pressure to complete this PR before mid August? Edit: Or complete this PR at all?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants