Initializing help system before first use

problem.chgvar

problem.chgvar

Purpose
Define a column as an SLP variable or change the characteristics and values of an existing SLP variable
Synopsis
problem.chgvar (colindex, detrow, initstepbound, stepbound, penalty, damp, initvalue, value, tolset, history, converged, vartype)
Arguments
colindex 
The index of the matrix column.
detrow 
Address of an integer holding the index of the determining row. Use -1 if there is no determining row. May be None if not required.
initstepbound 
Address of a double precision variable holding the initial step bound size. May be None if not required.
stepbound 
Address of a double precision variable holding the current step bound size. Use zero to disable the step bounds. May be None if not required.
penalty 
Address of a double precision variable holding the weighting of the penalty cost for exceeding the step bounds. May be None if not required.
damp 
Address of a double precision variable holding the damping factor for the variable. May be None if not required.
initvalue 
Address of a double precision variable holding the initial value for the variable. May be None if not required.
value 
Address of a double precision variable holding the current value for the variable. May be None if not required.
tolset 
Address of an integer holding the index of the tolerance set for this variable. Use zero if there is no specific tolerance set. May be None if not required.
history 
Address of an integer holding the history value for this variable. May be None if not required.
converged 
Address of an integer holding the convergence status for this variable. May be None if not required.
vartype 
Address of an integer holding a bitmap defining the existence of certain properties for this variable:
Bit 1: 
Variable has a delta vector
Bit 2: 
Variable has an initial value
Bit 14: 
Variable is the reserved "=" column
May be None if not required.
Example
The following example sets an initial value of 1.42 and tolerance set 2 for column 25 in the matrix. 
p.chgvar (25, None, None, None, None,
           None, 1.42, None, 2,
           None, None, 1<<1 | 1<<2)
Note that bits 1 and 2 of vartype are set, indicating that the variable has a delta vector and an initial value. For columns already defined as SLP variables, use problem.getvar to obtain the current value of vartype because other bits may already have been set by the system.
Further information

If any of the arguments is None then the corresponding information for the variable will be left unaltered. If the information is new (i.e. the column was not previously defined as an SLP variable) then the default values will be used.

Changing Value, History or Converged is only effective during SLP iterations.

Changing initvalue and initstepbound is only effective before problem.construct.

If a value of xpress.infinity is used in the value for stepbound or initstepbound, the delta will never have step bounds applied, and will almost always be regarded as converged.


Related topics
problem.addvars, problem.delvars, problem.getvar, problem.loadvars

Parent Topic Reference Manual

© 2001-2019 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.