Initializing help system before first use

problem.presolveRow

Purpose
Presolves a row formulated in terms of the original variables such that it can be added to a presolved matrix.
Topic areas
Misc, Presolve, Optimizer
Synopsis
colind, rowcoef, rhs, status = problem.presolveRow(rowtype, origcolind, origrowcoef, origrhs)
Arguments
rowtype 
The type of the row:
L 
indicates a ≤ row;
G 
indicates a ≥ row.
E 
indicates a ≥ row.
origcolind 
Integer array containing the column indices of the row to presolve.
origrowcoef 
Double array containing the non-zero coefficients of the row to presolve.
origrhs 
The right-hand side constant of the row to presolve.
Related controls
Integer
PRESOLVE 
Turns presolve on or off.
PRESOLVEOPS 
Selects the presolve operations.

Return value
colind 
Integer array containing the column indices of the presolved row. Allocate this to COLS elements and pass COLS as maxcoef> to make sure it is large enough to hold the presolved row.
rowcoef 
Double array containing the coefficients of the presolved row. Allocate this to COLS elements and pass COLS as maxcoef> to make sure it is large enough to hold the presolved row.
rhs 
The presolved right-hand side.
status 
Status of the presolved row:
-5 
Failed to presolve the row due to presolve operations making the row nonlinear;
-4 
Failed to presolve the equality row due to presolve operations requiring relaxation of the row;
-3 
Failed to presolve the row due to presolve dual reductions;
-2 
Failed to presolve the row due to presolve duplicate column reductions;
-1 
Failed to presolve the row due to an error. Check the Optimizer error code for the cause;
0 
The row was successfully presolved;
1 
The row was presolved, but may be relaxed.
Further information
1. There are certain presolve operations that can prevent a row from being presolved exactly. If the row contains a coefficient for a column that was eliminated due to duplicate column reductions or singleton column reductions, the row might have to be relaxed to remain valid for the presolved problem. The relaxation will be done automatically by the problem.presolveRow function, but a return status of +1 will be returned. If it is not possible to relax the row, a status of -2 will be returned instead. Likewise, it is possible that certain dual reductions prevents the row from being presolved. In such a case a status of -3 will be returned instead. Also transforming a convex quadratic objective transfer row to a convex quadratic objective and nonlinear eliminations will lead to a row not being presolved and return a status of -5 instead.
2. If problem.presolveRow will be used for presolving hard constraints, such as e.g. branching bounds or delayed constraints, then dual reductions should be disabled, by setting MIPDUALREDUCTIONS to 0.
3. If the user knows in advance which columns will have non-zero coefficients in rows that will be presolved, it is possible to protect these individual columns through the problem.loadSecureVecs function. This way the Optimizer is left free to apply all possible reductions to the remaining columns.
4. Argument origcolind may contain xpress.var objects instead of indices.
Related topics
problem.addCuts, problem.loadSecureVecs, problem.storeCuts.

Parent Topic Methods of the class problem

© 2001-2026 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation ("FICO"). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.