Detailed Description

methods for presolvers

Author: Tobias Achterberg; Timo Berthold

Definition in file presol.c.

#include <assert.h>
#include <string.h>
#include "scip/def.h"
#include "blockmemshell/memory.h"
#include "scip/set.h"
#include "scip/clock.h"
#include "scip/paramset.h"
#include "scip/scip.h"
#include "scip/pub_misc.h"
#include "scip/presol.h"
#include "scip/struct_presol.h"

Go to the source code of this file.

Functions
	SCIP_DECL_SORTPTRCOMP (SCIPpresolComp)

	SCIP_DECL_SORTPTRCOMP (SCIPpresolCompName)

static	SCIP_DECL_PARAMCHGD (paramChgdPresolPriority)

SCIP_RETCODE	SCIPpresolCopyInclude (SCIP_PRESOL presol, SCIP_SET set)

SCIP_RETCODE	SCIPpresolCreate (SCIP_PRESOL *presol, SCIP_SET set, SCIP_MESSAGEHDLR messagehdlr, BMS_BLKMEM blkmem, const char name, const char desc, int priority, int maxrounds, SCIP_PRESOLTIMING timing, SCIP_DECL_PRESOLCOPY((presolcopy)), SCIP_DECL_PRESOLFREE((presolfree)), SCIP_DECL_PRESOLINIT((presolinit)), SCIP_DECL_PRESOLEXIT((presolexit)), SCIP_DECL_PRESOLINITPRE((presolinitpre)), SCIP_DECL_PRESOLEXITPRE((presolexitpre)), SCIP_DECL_PRESOLEXEC((presolexec)), SCIP_PRESOLDATA presoldata)

SCIP_RETCODE	SCIPpresolFree (SCIP_PRESOL *presol, SCIP_SET set)

SCIP_RETCODE	SCIPpresolInit (SCIP_PRESOL presol, SCIP_SET set)

SCIP_RETCODE	SCIPpresolExit (SCIP_PRESOL presol, SCIP_SET set)

SCIP_RETCODE	SCIPpresolInitpre (SCIP_PRESOL presol, SCIP_SET set)

SCIP_RETCODE	SCIPpresolExitpre (SCIP_PRESOL presol, SCIP_SET set)

SCIP_RETCODE	SCIPpresolExec (SCIP_PRESOL presol, SCIP_SET set, SCIP_PRESOLTIMING timing, int nrounds, int nfixedvars, int naggrvars, int nchgvartypes, int nchgbds, int naddholes, int ndelconss, int naddconss, int nupgdconss, int nchgcoefs, int nchgsides, SCIP_RESULT *result)

SCIP_PRESOLDATA *	SCIPpresolGetData (SCIP_PRESOL *presol)

void	SCIPpresolSetData (SCIP_PRESOL presol, SCIP_PRESOLDATA presoldata)

void	SCIPpresolSetCopy (SCIP_PRESOL presol, SCIP_DECL_PRESOLCOPY((presolcopy)))

void	SCIPpresolSetFree (SCIP_PRESOL presol, SCIP_DECL_PRESOLFREE((presolfree)))

void	SCIPpresolSetInit (SCIP_PRESOL presol, SCIP_DECL_PRESOLINIT((presolinit)))

void	SCIPpresolSetExit (SCIP_PRESOL presol, SCIP_DECL_PRESOLEXIT((presolexit)))

void	SCIPpresolSetInitpre (SCIP_PRESOL presol, SCIP_DECL_PRESOLINITPRE((presolinitpre)))

void	SCIPpresolSetExitpre (SCIP_PRESOL presol, SCIP_DECL_PRESOLEXITPRE((presolexitpre)))

const char *	SCIPpresolGetName (SCIP_PRESOL *presol)

const char *	SCIPpresolGetDesc (SCIP_PRESOL *presol)

int	SCIPpresolGetPriority (SCIP_PRESOL *presol)

int	SCIPpresolGetMaxrounds (SCIP_PRESOL *presol)

void	SCIPpresolSetPriority (SCIP_PRESOL presol, SCIP_SET set, int priority)

SCIP_PRESOLTIMING	SCIPpresolGetTiming (SCIP_PRESOL *presol)

void	SCIPpresolSetTiming (SCIP_PRESOL *presol, SCIP_PRESOLTIMING timing)

SCIP_Bool	SCIPpresolIsInitialized (SCIP_PRESOL *presol)

void	SCIPpresolEnableOrDisableClocks (SCIP_PRESOL *presol, SCIP_Bool enable)

SCIP_Real	SCIPpresolGetSetupTime (SCIP_PRESOL *presol)

SCIP_Real	SCIPpresolGetTime (SCIP_PRESOL *presol)

int	SCIPpresolGetNFixedVars (SCIP_PRESOL *presol)

int	SCIPpresolGetNAggrVars (SCIP_PRESOL *presol)

int	SCIPpresolGetNChgVarTypes (SCIP_PRESOL *presol)

int	SCIPpresolGetNChgBds (SCIP_PRESOL *presol)

int	SCIPpresolGetNAddHoles (SCIP_PRESOL *presol)

int	SCIPpresolGetNDelConss (SCIP_PRESOL *presol)

int	SCIPpresolGetNAddConss (SCIP_PRESOL *presol)

int	SCIPpresolGetNUpgdConss (SCIP_PRESOL *presol)

int	SCIPpresolGetNChgCoefs (SCIP_PRESOL *presol)

int	SCIPpresolGetNChgSides (SCIP_PRESOL *presol)

int	SCIPpresolGetNCalls (SCIP_PRESOL *presol)

Function Documentation

SCIP_DECL_SORTPTRCOMP ( SCIPpresolComp )

compares two presolvers w. r. to their priority

Definition at line 47 of file presol.c.

SCIP_DECL_SORTPTRCOMP ( SCIPpresolCompName )

comparison method for sorting presolvers w.r.t. to their name

Definition at line 53 of file presol.c.

References SCIPpresolGetName().

static SCIP_DECL_PARAMCHGD ( paramChgdPresolPriority )

static

method to call, when the priority of a presolver was changed

Definition at line 60 of file presol.c.

References NULL, SCIP_CALL, SCIP_OKAY, SCIPparamGetData(), SCIPparamGetInt(), and SCIPsetPresolPriority().

SCIP_RETCODE SCIPpresolCopyInclude	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set
	)

copies the given presolver to a new scip

Parameters

presol	presolver
set	SCIP_SET of SCIP to copy to

Definition at line 74 of file presol.c.

References NULL, SCIP_CALL, SCIP_OKAY, SCIPdebugMessage, and SCIPpresolGetName().

Referenced by SCIPsetCopyPlugins().

SCIP_RETCODE SCIPpresolCreate	(	SCIP_PRESOL **	presol,
		SCIP_SET *	set,
		SCIP_MESSAGEHDLR *	messagehdlr,
		BMS_BLKMEM *	blkmem,
		const char *	name,
		const char *	desc,
		int	priority,
		int	maxrounds,
		SCIP_PRESOLTIMING	timing,
		SCIP_DECL_PRESOLCOPY((*presolcopy))	,
		SCIP_DECL_PRESOLFREE((*presolfree))	,
		SCIP_DECL_PRESOLINIT((*presolinit))	,
		SCIP_DECL_PRESOLEXIT((*presolexit))	,
		SCIP_DECL_PRESOLINITPRE((*presolinitpre))	,
		SCIP_DECL_PRESOLEXITPRE((*presolexitpre))	,
		SCIP_DECL_PRESOLEXEC((*presolexec))	,
		SCIP_PRESOLDATA *	presoldata
	)

creates a presolver

Parameters

presol	pointer to store presolver
set	global SCIP settings
messagehdlr	message handler
blkmem	block memory for parameter settings
name	name of presolver
desc	description of presolver
priority	priority of the presolver (>= 0: before, < 0: after constraint handlers)
maxrounds	maximal number of presolving rounds the presolver participates in (-1: no limit)
timing	timing mask of the presolver
presoldata	presolver data

Definition at line 92 of file presol.c.

References BMSallocMemory, BMSduplicateMemoryArray, FALSE, NULL, paramname, SCIP_ALLOC, SCIP_CALL, SCIP_CLOCKTYPE_DEFAULT, SCIP_MAXSTRLEN, SCIP_OKAY, SCIP_PARAMETERWRONGVAL, SCIP_PRESOLTIMING_ALWAYS, SCIP_PRESOLTIMING_EXHAUSTIVE, SCIP_PRESOLTIMING_FAST, SCIP_PRESOLTIMING_MEDIUM, SCIPclockCreate(), SCIPmessagePrintError(), SCIPsetAddIntParam(), SCIPsnprintf(), and TRUE.

Referenced by SCIPincludePresol(), and SCIPincludePresolBasic().

SCIP_RETCODE SCIPpresolFree	(	SCIP_PRESOL **	presol,
		SCIP_SET *	set
	)

frees memory of presolver

Parameters

presol	pointer to presolver data structure
set	global SCIP settings

Definition at line 167 of file presol.c.

References BMSfreeMemory, BMSfreeMemoryArray, NULL, SCIP_CALL, SCIP_OKAY, and SCIPclockFree().

SCIP_RETCODE SCIPpresolInit	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set
	)

initializes presolver

Parameters

presol	presolver
set	global SCIP settings

Definition at line 193 of file presol.c.

Referenced by SCIPsetIncludeExternalCode().

SCIP_RETCODE SCIPpresolExit	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set
	)

deinitializes presolver

Parameters

presol	presolver
set	global SCIP settings

Definition at line 252 of file presol.c.

References FALSE, SCIP_Presol::initialized, SCIP_Presol::name, NULL, SCIP_CALL, SCIP_INVALIDCALL, SCIP_OKAY, SCIPclockStart(), SCIPclockStop(), SCIPerrorMessage, and SCIP_Presol::setuptime.

Referenced by SCIPsetInitPlugins().

SCIP_RETCODE SCIPpresolInitpre	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set
	)

informs presolver that the presolving process is being started

Parameters

presol	presolver
set	global SCIP settings

Definition at line 283 of file presol.c.

References SCIP_Presol::lastnaddconss, SCIP_Presol::lastnaddholes, SCIP_Presol::lastnaggrvars, SCIP_Presol::lastnchgbds, SCIP_Presol::lastnchgcoefs, SCIP_Presol::lastnchgsides, SCIP_Presol::lastnchgvartypes, SCIP_Presol::lastndelconss, SCIP_Presol::lastnfixedvars, SCIP_Presol::lastnupgdconss, NULL, SCIP_CALL, SCIP_OKAY, SCIPclockStart(), SCIPclockStop(), and SCIP_Presol::setuptime.

Referenced by SCIPsetExitPlugins().

SCIP_RETCODE SCIPpresolExitpre	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set
	)

informs presolver that the presolving process is finished

Parameters

presol	presolver
set	global SCIP settings

Definition at line 318 of file presol.c.

References NULL, SCIP_CALL, SCIP_OKAY, SCIPclockStart(), SCIPclockStop(), and SCIP_Presol::setuptime.

Referenced by SCIPsetExitPlugins().

SCIP_RETCODE SCIPpresolExec	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set,
		SCIP_PRESOLTIMING	timing,
		int	nrounds,
		int *	nfixedvars,
		int *	naggrvars,
		int *	nchgvartypes,
		int *	nchgbds,
		int *	naddholes,
		int *	ndelconss,
		int *	naddconss,
		int *	nupgdconss,
		int *	nchgcoefs,
		int *	nchgsides,
		SCIP_RESULT *	result
	)

executes presolver

Parameters

presol	presolver
set	global SCIP settings
timing	current presolving timing
nrounds	number of presolving rounds already done
nfixedvars	pointer to total number of variables fixed of all presolvers
naggrvars	pointer to total number of variables aggregated of all presolvers
nchgvartypes	pointer to total number of variable type changes of all presolvers
nchgbds	pointer to total number of variable bounds tightened of all presolvers
naddholes	pointer to total number of domain holes added of all presolvers
ndelconss	pointer to total number of deleted constraints of all presolvers
naddconss	pointer to total number of added constraints of all presolvers
nupgdconss	pointer to total number of upgraded constraints of all presolvers
nchgcoefs	pointer to total number of changed coefficients of all presolvers
nchgsides	pointer to total number of changed left/right hand sides of all presolvers
result	pointer to store the result of the callback method

Definition at line 342 of file presol.c.

Referenced by presolveRound().

SCIP_PRESOLDATA* SCIPpresolGetData ( SCIP_PRESOL * presol )

gets user data of presolver

Parameters

presol presolver

Definition at line 466 of file presol.c.

References NULL, and SCIP_Presol::presoldata.

Referenced by presolComponents(), SCIP_DECL_PRESOLCOPY(), SCIP_DECL_PRESOLEXEC(), SCIP_DECL_PRESOLEXIT(), SCIP_DECL_PRESOLEXITPRE(), SCIP_DECL_PRESOLFREE(), SCIP_DECL_PRESOLINIT(), SCIP_DECL_PRESOLINITPRE(), SCIPfindObjPresol(), and SCIPgetObjPresol().

void SCIPpresolSetData	(	SCIP_PRESOL *	presol,
		SCIP_PRESOLDATA *	presoldata
	)

sets user data of presolver; user has to free old data in advance!

Parameters

presol	presolver
presoldata	new presolver user data

Definition at line 476 of file presol.c.

References NULL, and SCIP_Presol::presoldata.

Referenced by SCIP_DECL_PRESOLFREE().

void SCIPpresolSetCopy	(	SCIP_PRESOL *	presol,
		SCIP_DECL_PRESOLCOPY((*presolcopy))
	)

sets copy method of presolver

Parameters

presol presolver

Definition at line 487 of file presol.c.

References NULL.

Referenced by SCIPsetPresolCopy().

void SCIPpresolSetFree	(	SCIP_PRESOL *	presol,
		SCIP_DECL_PRESOLFREE((*presolfree))
	)

sets destructor method of presolver

Parameters

presol presolver

Definition at line 498 of file presol.c.

References NULL.

Referenced by SCIPsetPresolFree().

void SCIPpresolSetInit	(	SCIP_PRESOL *	presol,
		SCIP_DECL_PRESOLINIT((*presolinit))
	)

sets initialization method of presolver

Parameters

presol presolver

Definition at line 509 of file presol.c.

References NULL.

Referenced by SCIPsetPresolInit().

void SCIPpresolSetExit	(	SCIP_PRESOL *	presol,
		SCIP_DECL_PRESOLEXIT((*presolexit))
	)

sets deinitialization method of presolver

Parameters

presol presolver

Definition at line 520 of file presol.c.

References NULL.

Referenced by SCIPsetPresolExit().

void SCIPpresolSetInitpre	(	SCIP_PRESOL *	presol,
		SCIP_DECL_PRESOLINITPRE((*presolinitpre))
	)

sets solving process initialization method of presolver

Parameters

presol presolver

Definition at line 531 of file presol.c.

References NULL.

Referenced by SCIPsetPresolInitpre().

void SCIPpresolSetExitpre	(	SCIP_PRESOL *	presol,
		SCIP_DECL_PRESOLEXITPRE((*presolexitpre))
	)

sets solving process deinitialization method of presolver

Parameters

presol presolver

Definition at line 542 of file presol.c.

References NULL.

Referenced by SCIPsetPresolExitpre().

const char* SCIPpresolGetName ( SCIP_PRESOL * presol )

gets name of presolver

Parameters

presol presolver

Definition at line 553 of file presol.c.

References SCIP_Presol::name, and NULL.

Referenced by paramsetSetPresolvingDefault(), paramsetSetPresolvingOff(), presolveRound(), printPresolverStatistics(), SCIP_DECL_DIALOGEXEC(), SCIP_DECL_PRESOLCOPY(), SCIP_DECL_PRESOLEXEC(), SCIP_DECL_SORTPTRCOMP(), SCIPincludeDialogDefaultFix(), SCIPincludeDialogDefaultSet(), SCIPpresolCopyInclude(), and SCIPsetSortConflicthdlrs().

const char* SCIPpresolGetDesc ( SCIP_PRESOL * presol )

gets description of presolver

Parameters

presol presolver

Definition at line 563 of file presol.c.

References SCIP_Presol::desc, and NULL.

Referenced by SCIP_DECL_DIALOGEXEC(), SCIPincludeDialogDefaultFix(), and SCIPincludeDialogDefaultSet().

int SCIPpresolGetPriority ( SCIP_PRESOL * presol )

gets priority of presolver

Parameters

presol presolver

Definition at line 573 of file presol.c.

References NULL, and SCIP_Presol::priority.

Referenced by presolveRound(), and SCIP_DECL_DIALOGEXEC().

int SCIPpresolGetMaxrounds ( SCIP_PRESOL * presol )

gets round limit of presolver

Parameters

presol presolver

Definition at line 583 of file presol.c.

References SCIP_Presol::maxrounds, and NULL.

Referenced by SCIP_DECL_DIALOGEXEC().

void SCIPpresolSetPriority	(	SCIP_PRESOL *	presol,
		SCIP_SET *	set,
		int	priority
	)

sets priority of presolver

Parameters

presol	presolver
set	global SCIP settings
priority	new priority of the presolver

Definition at line 593 of file presol.c.

References FALSE, NULL, and SCIP_Presol::priority.

Referenced by SCIPsetPresolPriority().

SCIP_PRESOLTIMING SCIPpresolGetTiming ( SCIP_PRESOL * presol )

gets the timing mask of the presolver

Parameters

presol presolver

Definition at line 607 of file presol.c.

References NULL, and SCIP_Presol::timing.

Referenced by SCIP_DECL_DIALOGEXEC().

void SCIPpresolSetTiming	(	SCIP_PRESOL *	presol,
		SCIP_PRESOLTIMING	timing
	)

sets the timing mask of the presolver

Parameters

presol	presolver
timing	timing mask of the presolver

Definition at line 617 of file presol.c.

References NULL, and SCIP_Presol::timing.

SCIP_Bool SCIPpresolIsInitialized ( SCIP_PRESOL * presol )

is presolver initialized?

Parameters

presol presolver

Definition at line 629 of file presol.c.

References SCIP_Presol::initialized, and NULL.

void SCIPpresolEnableOrDisableClocks	(	SCIP_PRESOL *	presol,
		SCIP_Bool	enable
	)

enables or disables all clocks of presol, depending on the value of the flag

Parameters

presol	the presolver for which all clocks should be enabled or disabled
enable	should the clocks of the presolver be enabled?

Definition at line 639 of file presol.c.

References NULL, SCIP_Presol::presolclock, SCIPclockEnableOrDisable(), and SCIP_Presol::setuptime.

Referenced by SCIPsetSetReoptimizationParams().

SCIP_Real SCIPpresolGetSetupTime ( SCIP_PRESOL * presol )

gets time in seconds used in this presolver for setting up for next stages

Parameters

presol presolver

Definition at line 651 of file presol.c.

References NULL, SCIPclockGetTime(), and SCIP_Presol::setuptime.

Referenced by printPresolverStatistics().

SCIP_Real SCIPpresolGetTime ( SCIP_PRESOL * presol )

gets time in seconds used in this presolver

Parameters

presol presolver

Definition at line 661 of file presol.c.

References NULL, SCIP_Presol::presolclock, and SCIPclockGetTime().

Referenced by printPresolverStatistics().

int SCIPpresolGetNFixedVars ( SCIP_PRESOL * presol )

gets number of variables fixed in presolver

Parameters

presol presolver

Definition at line 671 of file presol.c.

References SCIP_Presol::nfixedvars, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNAggrVars ( SCIP_PRESOL * presol )

gets number of variables aggregated in presolver

Parameters

presol presolver

Definition at line 681 of file presol.c.

References SCIP_Presol::naggrvars, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNChgVarTypes ( SCIP_PRESOL * presol )

gets number of variable types changed in presolver

Parameters

presol presolver

Definition at line 691 of file presol.c.

References SCIP_Presol::nchgvartypes, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNChgBds ( SCIP_PRESOL * presol )

gets number of bounds changed in presolver

Parameters

presol presolver

Definition at line 701 of file presol.c.

References SCIP_Presol::nchgbds, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNAddHoles ( SCIP_PRESOL * presol )

gets number of holes added to domains of variables in presolver

Parameters

presol presolver

Definition at line 711 of file presol.c.

References SCIP_Presol::naddholes, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNDelConss ( SCIP_PRESOL * presol )

gets number of constraints deleted in presolver

Parameters

presol presolver

Definition at line 721 of file presol.c.

References SCIP_Presol::ndelconss, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNAddConss ( SCIP_PRESOL * presol )

gets number of constraints added in presolver

Parameters

presol presolver

Definition at line 731 of file presol.c.

References SCIP_Presol::naddconss, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNUpgdConss ( SCIP_PRESOL * presol )

gets number of constraints upgraded in presolver

Parameters

presol presolver

Definition at line 741 of file presol.c.

References NULL, and SCIP_Presol::nupgdconss.

int SCIPpresolGetNChgCoefs ( SCIP_PRESOL * presol )

gets number of coefficients changed in presolver

Parameters

presol presolver

Definition at line 751 of file presol.c.

References SCIP_Presol::nchgcoefs, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNChgSides ( SCIP_PRESOL * presol )

gets number of constraint sides changed in presolver

Parameters

presol presolver

Definition at line 761 of file presol.c.

References SCIP_Presol::nchgsides, and NULL.

Referenced by printPresolverStatistics().

int SCIPpresolGetNCalls ( SCIP_PRESOL * presol )

gets number of times the presolver was called and tried to find reductions

Parameters

presol presolver

Definition at line 771 of file presol.c.

References SCIP_Presol::ncalls, and NULL.

Referenced by fillDigraph(), and printPresolverStatistics().

SCIP

Detailed Description

Functions

Function Documentation