Scippy

SCIP

Solving Constraint Integer Programs

Functions
Event Handler
Public API of SCIP » Core API » Methods for managing plugins

Detailed Description

methods for event handlers

Functions

SCIP_EXPORT const char * SCIPeventhdlrGetName (SCIP_EVENTHDLR *eventhdlr)
 
SCIP_EXPORT SCIP_EVENTHDLRDATA * SCIPeventhdlrGetData (SCIP_EVENTHDLR *eventhdlr)
 
SCIP_EXPORT void SCIPeventhdlrSetData (SCIP_EVENTHDLR *eventhdlr, SCIP_EVENTHDLRDATA *eventhdlrdata)
 
SCIP_EXPORT SCIP_Bool SCIPeventhdlrIsInitialized (SCIP_EVENTHDLR *eventhdlr)
 
SCIP_EXPORT SCIP_Real SCIPeventhdlrGetSetupTime (SCIP_EVENTHDLR *eventhdlr)
 
SCIP_EXPORT SCIP_Real SCIPeventhdlrGetTime (SCIP_EVENTHDLR *eventhdlr)
 
SCIP_EXPORT SCIP_RETCODE SCIPincludeEventhdlr (SCIP *scip, const char *name, const char *desc, SCIP_DECL_EVENTCOPY((*eventcopy)), SCIP_DECL_EVENTFREE((*eventfree)), SCIP_DECL_EVENTINIT((*eventinit)), SCIP_DECL_EVENTEXIT((*eventexit)), SCIP_DECL_EVENTINITSOL((*eventinitsol)), SCIP_DECL_EVENTEXITSOL((*eventexitsol)), SCIP_DECL_EVENTDELETE((*eventdelete)), SCIP_DECL_EVENTEXEC((*eventexec)), SCIP_EVENTHDLRDATA *eventhdlrdata)
 
SCIP_EXPORT SCIP_RETCODE SCIPincludeEventhdlrBasic (SCIP *scip, SCIP_EVENTHDLR **eventhdlrptr, const char *name, const char *desc, SCIP_DECL_EVENTEXEC((*eventexec)), SCIP_EVENTHDLRDATA *eventhdlrdata)
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrCopy (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTCOPY((*eventcopy)))
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrFree (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTFREE((*eventfree)))
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrInit (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTINIT((*eventinit)))
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrExit (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTEXIT((*eventexit)))
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrInitsol (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTINITSOL((*eventinitsol)))
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrExitsol (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTEXITSOL((*eventexitsol)))
 
SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrDelete (SCIP *scip, SCIP_EVENTHDLR *eventhdlr, SCIP_DECL_EVENTDELETE((*eventdelete)))
 
SCIP_EXPORT SCIP_EVENTHDLR * SCIPfindEventhdlr (SCIP *scip, const char *name)
 
SCIP_EXPORT SCIP_EVENTHDLR ** SCIPgetEventhdlrs (SCIP *scip)
 
SCIP_EXPORT int SCIPgetNEventhdlrs (SCIP *scip)
 

Function Documentation

◆ SCIPeventhdlrGetName()

SCIP_EXPORT const char* SCIPeventhdlrGetName ( SCIP_EVENTHDLR *  eventhdlr)

gets name of event handler

Parameters
eventhdlrevent handler

Definition at line 314 of file event.c.

References SCIP_Eventhdlr::name, and NULL.

Referenced by SCIP_DECL_CONSGETNVARS(), SCIP_DECL_EVENTCOPY(), SCIP_DECL_EVENTEXEC(), SCIP_DECL_EVENTEXIT(), SCIP_DECL_EVENTEXITSOL(), SCIP_DECL_EVENTFREE(), SCIP_DECL_EVENTINIT(), SCIP_DECL_EVENTINITSOL(), SCIPeventGlobalbndClearBoundChanges(), SCIPeventGlobalbndDisableBoundStorage(), SCIPeventGlobalbndEnableBoundStorage(), SCIPeventGlobalbndGetBoundChanges(), SCIPeventhdlrCopyInclude(), SCIPsetFindCompr(), and testCriteria().

◆ SCIPeventhdlrGetData()

SCIP_EXPORT SCIP_EVENTHDLRDATA* SCIPeventhdlrGetData ( SCIP_EVENTHDLR *  eventhdlr)

gets user data of event handler

Parameters
eventhdlrevent handler

Definition at line 324 of file event.c.

References SCIP_Eventhdlr::eventhdlrdata, and NULL.

Referenced by exitEventhandler(), exitsolEventhandler(), freeEventhandler(), getNNodesBelowIncumbent(), getNRank1Nodes(), initsolEventhandler(), SCIP_DECL_EVENTCOPY(), SCIP_DECL_EVENTDELETE(), SCIP_DECL_EVENTEXEC(), SCIP_DECL_EVENTEXIT(), SCIP_DECL_EVENTEXITSOL(), SCIP_DECL_EVENTFREE(), SCIP_DECL_EVENTINIT(), SCIP_DECL_EVENTINITSOL(), SCIP_DECL_HEUREXEC(), SCIP_DECL_HEURFREE(), SCIPbendersComputeSubproblemLowerbound(), SCIPbendersSolveSubproblemCIP(), SCIPeventGlobalbndClearBoundChanges(), SCIPeventGlobalbndDisableBoundStorage(), SCIPeventGlobalbndEnableBoundStorage(), SCIPeventGlobalbndGetBoundChanges(), SCIPfindObjEventhdlr(), SCIPgetObjEventhdlr(), and updateEventhdlrUpperbound().

◆ SCIPeventhdlrSetData()

SCIP_EXPORT void SCIPeventhdlrSetData ( SCIP_EVENTHDLR *  eventhdlr,
SCIP_EVENTHDLRDATA *  eventhdlrdata 
)

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

Parameters
eventhdlrevent handler
eventhdlrdatanew event handler user data

Definition at line 334 of file event.c.

References SCIP_Eventhdlr::eventhdlrdata, and NULL.

Referenced by freeEventhandler(), and SCIP_DECL_EVENTFREE().

◆ SCIPeventhdlrIsInitialized()

SCIP_EXPORT SCIP_Bool SCIPeventhdlrIsInitialized ( SCIP_EVENTHDLR *  eventhdlr)

is event handler initialized?

Parameters
eventhdlrevent handler

Definition at line 422 of file event.c.

References SCIP_Eventhdlr::initialized, and NULL.

Referenced by SCIPsetIncludeCompr().

◆ SCIPeventhdlrGetSetupTime()

SCIP_EXPORT SCIP_Real SCIPeventhdlrGetSetupTime ( SCIP_EVENTHDLR *  eventhdlr)

gets time in seconds used in this event handler for setting up for next stages

Parameters
eventhdlrevent handler

Definition at line 444 of file event.c.

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

◆ SCIPeventhdlrGetTime()

SCIP_EXPORT SCIP_Real SCIPeventhdlrGetTime ( SCIP_EVENTHDLR *  eventhdlr)

gets time in seconds used in this event handler

gets time in seconds used in this event handler, this measurement is currently disabled so this method will return 0, define TIMEEVENTEXEC in the beginning of this file to enable

Parameters
eventhdlrevent handler

Definition at line 456 of file event.c.

References SCIP_Eventhdlr::eventtime, NULL, and SCIPclockGetTime().

◆ SCIPincludeEventhdlr()

SCIP_EXPORT SCIP_RETCODE SCIPincludeEventhdlr ( SCIP *  scip,
const char *  name,
const char *  desc,
SCIP_DECL_EVENTCOPY((*eventcopy))  ,
SCIP_DECL_EVENTFREE((*eventfree))  ,
SCIP_DECL_EVENTINIT((*eventinit))  ,
SCIP_DECL_EVENTEXIT((*eventexit))  ,
SCIP_DECL_EVENTINITSOL((*eventinitsol))  ,
SCIP_DECL_EVENTEXITSOL((*eventexitsol))  ,
SCIP_DECL_EVENTDELETE((*eventdelete))  ,
SCIP_DECL_EVENTEXEC((*eventexec))  ,
SCIP_EVENTHDLRDATA *  eventhdlrdata 
)

creates an event handler and includes it in SCIP

Note
method has all event handler callbacks as arguments and is thus changed every time a new callback is added in future releases; consider using SCIPincludeEventhdlrBasic() and setter functions if you seek for a method which is less likely to change in future releases
Parameters
scipSCIP data structure
namename of event handler
descdescription of event handler
eventhdlrdataevent handler data

Definition at line 53 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_INVALIDDATA, SCIP_OKAY, SCIPcheckStage(), SCIPerrorMessage, SCIPeventhdlrCreate(), SCIPfindEventhdlr(), SCIPsetIncludeEventhdlr(), Scip::set, and TRUE.

Referenced by SCIPincludeObjEventhdlr().

◆ SCIPincludeEventhdlrBasic()

SCIP_EXPORT SCIP_RETCODE SCIPincludeEventhdlrBasic ( SCIP *  scip,
SCIP_EVENTHDLR **  eventhdlrptr,
const char *  name,
const char *  desc,
SCIP_DECL_EVENTEXEC((*eventexec))  ,
SCIP_EVENTHDLRDATA *  eventhdlrdata 
)

creates an event handler and includes it in SCIP with all its non-fundamental callbacks set to NULL; if needed, non-fundamental callbacks can be set afterwards via setter functions SCIPsetEventhdlrCopy(), SCIPsetEventhdlrFree(), SCIPsetEventhdlrInit(), SCIPsetEventhdlrExit(), SCIPsetEventhdlrInitsol(), SCIPsetEventhdlrExitsol(), and SCIPsetEventhdlrDelete()

Note
if you want to set all callbacks with a single method call, consider using SCIPincludeEventhdlr() instead
Parameters
scipSCIP data structure
eventhdlrptrreference to an event handler, or NULL
namename of event handler
descdescription of event handler
eventhdlrdataevent handler data

Definition at line 94 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_INVALIDDATA, SCIP_OKAY, SCIPcheckStage(), SCIPerrorMessage, SCIPeventhdlrCreate(), SCIPfindEventhdlr(), SCIPsetIncludeEventhdlr(), Scip::set, and TRUE.

Referenced by createSubproblems(), includeEventHdlrDispsol(), includeEventHdlrSync(), initialiseLPSubproblem(), SCIP_DECL_HEUREXEC(), SCIP_DECL_NONLINCONSUPGD(), SCIPapplyProximity(), SCIPbendersActivate(), SCIPcreateProbColoring(), SCIPincludeBranchruleDistribution(), SCIPincludeConshdlrAbspower(), SCIPincludeConshdlrAnd(), SCIPincludeConshdlrBivariate(), SCIPincludeConshdlrBounddisjunction(), SCIPincludeConshdlrCardinality(), SCIPincludeConshdlrCumulative(), SCIPincludeConshdlrIndicator(), SCIPincludeConshdlrLinking(), SCIPincludeConshdlrLogicor(), SCIPincludeConshdlrNonlinear(), SCIPincludeConshdlrOptcumulative(), SCIPincludeConshdlrOr(), SCIPincludeConshdlrQuadratic(), SCIPincludeConshdlrRpa(), SCIPincludeConshdlrSOC(), SCIPincludeConshdlrSOS2(), SCIPincludeConshdlrVarbound(), SCIPincludeConshdlrXor(), SCIPincludeEventHdlrBestsol(), SCIPincludeEventHdlrBoundwriting(), SCIPincludeEventHdlrGlobalbnd(), SCIPincludeEventHdlrLPsol(), SCIPincludeEventHdlrNewsol(), SCIPincludeEventHdlrSofttimelimit(), SCIPincludeEventHdlrSolvingphase(), SCIPincludeHeurShiftandpropagate(), SCIPincludeHeurSubNlp(), SCIPincludePropVbounds(), SCIPincludeSepaIntobj(), SCIPprobdataCreate(), setupAndSolve(), setupAndSolveSubscip(), setupAndSolveSubscipCrossover(), setupAndSolveSubscipLocalbranching(), solveSubscipLpface(), wrapperDins(), and wrapperRins().

◆ SCIPsetEventhdlrCopy()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrCopy ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTCOPY((*eventcopy))   
)

sets copy callback of the event handler

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 126 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetCopy(), and TRUE.

Referenced by SCIPincludeEventHdlrBestsol(), SCIPincludeEventHdlrBoundwriting(), SCIPincludeEventHdlrNewsol(), SCIPincludeEventHdlrSofttimelimit(), and SCIPincludeEventHdlrSolvingphase().

◆ SCIPsetEventhdlrFree()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrFree ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTFREE((*eventfree))   
)

sets deinitialization callback of the event handler

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 140 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetFree(), and TRUE.

Referenced by createSubproblems(), includeEventHdlrSync(), initialiseLPSubproblem(), SCIPincludeBranchruleDistribution(), SCIPincludeEventHdlrBoundwriting(), SCIPincludeEventHdlrGlobalbnd(), SCIPincludeEventHdlrSofttimelimit(), and SCIPincludeEventHdlrSolvingphase().

◆ SCIPsetEventhdlrInit()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrInit ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTINIT((*eventinit))   
)

sets initialization callback of the event handler

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 154 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetInit(), and TRUE.

Referenced by includeEventHdlrDispsol(), includeEventHdlrSync(), SCIPincludeEventHdlrBestsol(), SCIPincludeEventHdlrBoundwriting(), SCIPincludeEventHdlrGlobalbnd(), SCIPincludeEventHdlrLPsol(), SCIPincludeEventHdlrNewsol(), SCIPincludeEventHdlrSofttimelimit(), SCIPincludeEventHdlrSolvingphase(), and SCIPincludeSepaIntobj().

◆ SCIPsetEventhdlrExit()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrExit ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTEXIT((*eventexit))   
)

sets deinitialization callback of the event handler

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 168 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetExit(), and TRUE.

Referenced by createSubproblems(), includeEventHdlrDispsol(), includeEventHdlrSync(), initialiseLPSubproblem(), SCIPincludeEventHdlrBestsol(), SCIPincludeEventHdlrBoundwriting(), SCIPincludeEventHdlrGlobalbnd(), SCIPincludeEventHdlrLPsol(), SCIPincludeEventHdlrNewsol(), SCIPincludeEventHdlrSofttimelimit(), SCIPincludeEventHdlrSolvingphase(), and SCIPincludeSepaIntobj().

◆ SCIPsetEventhdlrInitsol()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrInitsol ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTINITSOL((*eventinitsol))   
)

sets solving process initialization callback of the event handler

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 182 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetInitsol(), and TRUE.

Referenced by createSubproblems(), initialiseLPSubproblem(), SCIPbendersActivate(), and SCIPincludeEventHdlrSolvingphase().

◆ SCIPsetEventhdlrExitsol()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrExitsol ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTEXITSOL((*eventexitsol))   
)

sets solving process deinitialization callback of the event handler

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 196 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetExitsol(), and TRUE.

Referenced by createSubproblems(), initialiseLPSubproblem(), and SCIPincludeEventHdlrSolvingphase().

◆ SCIPsetEventhdlrDelete()

SCIP_EXPORT SCIP_RETCODE SCIPsetEventhdlrDelete ( SCIP *  scip,
SCIP_EVENTHDLR *  eventhdlr,
SCIP_DECL_EVENTDELETE((*eventdelete))   
)

sets callback of the event handler to free specific event data

Parameters
scipscip instance
eventhdlrevent handler

Definition at line 210 of file scip_event.c.

References FALSE, NULL, SCIP_CALL, SCIP_OKAY, SCIPcheckStage(), SCIPeventhdlrSetDelete(), and TRUE.

◆ SCIPfindEventhdlr()

SCIP_EXPORT SCIP_EVENTHDLR* SCIPfindEventhdlr ( SCIP *  scip,
const char *  name 
)

returns the event handler of the given name, or NULL if not existing

Parameters
scipSCIP data structure
namename of event handler

Definition at line 224 of file scip_event.c.

References NULL, SCIPsetFindEventhdlr(), and Scip::set.

Referenced by COLORprobAddVarForStableSet(), getNNodesBelowIncumbent(), getNRank1Nodes(), SCIP_DECL_CONSEXITSOL(), SCIP_DECL_CONSINITSOL(), SCIP_DECL_PROBEXITSOL(), SCIP_DECL_PROBINITSOL(), SCIPapplyProximity(), SCIPbendersComputeSubproblemLowerbound(), SCIPbendersSolveSubproblemCIP(), SCIPcreateConcurrent(), SCIPfindObjEventhdlr(), SCIPincludeEventhdlr(), SCIPincludeEventhdlrBasic(), SCIPprobdataCreate(), and updateEventhdlrUpperbound().

◆ SCIPgetEventhdlrs()

SCIP_EXPORT SCIP_EVENTHDLR** SCIPgetEventhdlrs ( SCIP *  scip)

returns the array of currently available event handlers

Parameters
scipSCIP data structure

Definition at line 237 of file scip_event.c.

References SCIP_Set::eventhdlrs, NULL, and Scip::set.

◆ SCIPgetNEventhdlrs()

SCIP_EXPORT int SCIPgetNEventhdlrs ( SCIP *  scip)

returns the number of currently available event handlers

Parameters
scipSCIP data structure

Definition at line 248 of file scip_event.c.

References SCIP_Set::neventhdlrs, NULL, and Scip::set.