类IloCplex::IncumbentCallbackI

定义文件： ilcplex/ilocplexi.h

注

这是一个高级班。高级课程通常要求对 CPLEX 使用的算法有深刻的理解。因而它们会提高应用程序中错误行为的风险，而这种行为可能难以调试。因此，团队鼓励您仔细考虑是否可以用其他类来完成同样的任务。

在分支-切割搜索过程中，每当发现新的潜在任职者时，就会调用该回调。通过它，您可以分析提议的任职者，并选择拒绝。在这种情况下，CPLEX 将继续进行分支切割搜索。因此，该回调通常与分支回调相结合，后者指示 CPLEX 在找到潜在任职者并认为节点解整数可行后，如何在节点上进行分支。

使用该回调拒绝任职者时，还必须将控制主要和双重还原类型的参数 "IloCplex::Reduce设置为 1（1），以限制预化为主要还原，或设置为 0（0），以禁用所有预化为还原。如果现任回调用于其他目的，则无需设置缩减参数。

注

在 MIP 启动处理过程中，可能会调用在位回调。在这种情况下，"getSolutionSource将返回 "MIPStartSolution。在这种情况下，需要考虑以下特殊因素：

MIP 启动处理在解法过程中很早发生。此时，尚未设置搜索树，而且尚不存在搜索树节点。因此，在此情况下，需要节点上下文的大量回调函数将失败。

另请参阅：

IloCplex, IloCplex::Callback, IloCplex::CallbackI, IloCplex::MIPCallbackI, IloCplex::OptimizationCallbackI, ILOINCUMBENTCALLBACK0

方法概要
`public NodeData *`	`getNodeData() const`
`public NodeId`	`getNodeId() const`
`public IloNum`	`getObjValue() const`
`public IloNum`	`getSlack(const IloRange rng) const`
`public void`	`getSlacks(IloNumArray val, const IloRangeArray con) const`
`public IncumbentCallbackI::SolutionSource`	`getSolutionSource() const`
`protected Callback::Type`	`getType() const`
`public IloNum`	`getValue(const IloIntVar var) const`
`public IloNum`	`getValue(const IloNumVar var) const`
`public IloNum`	`getValue(const IloExprArg expr) const`
`public void`	`getValues(IloNumArray val, const IloIntVarArray vars) const`
`public void`	`getValues(IloNumArray val, const IloNumVarArray vars) const`
`public void`	`reject()`
`public NodeData *`	`setNodeData(NodeData * data)`

从 "`MIPCallbackI`继承的方法
`getCurrentNodeDepth, getObjCoef, getObjCoef, getObjCoefs, getObjCoefs, getType, getUserThreads, MIPCallbackI`

从 "`MIPInfoCallbackI`继承的方法
`getBestObjValue, getCutoff, getDirection, getDirection, getIncumbentObjValue, getIncumbentSlack, getIncumbentSlacks, getIncumbentValue, getIncumbentValue, getIncumbentValue, getIncumbentValues, getIncumbentValues, getMIPRelativeGap, getMyThreadNum, getNcuts, getNiterations, getNiterations64, getNnodes, getNnodes64, getNremainingNodes, getNremainingNodes64, getPriority, getPriority, getQuality, getType, hasIncumbent, MIPInfoCallbackI`

从 "MIPInfoCallbackI继承的方法

getBestObjValue, getCutoff, getDirection, getDirection, getIncumbentObjValue, getIncumbentSlack, getIncumbentSlacks, getIncumbentValue, getIncumbentValue, getIncumbentValue, getIncumbentValues, getIncumbentValues, getMIPRelativeGap, getMyThreadNum, getNcuts, getNiterations, getNiterations64, getNnodes, getNnodes64, getNremainingNodes, getNremainingNodes64, getPriority, getPriority, getQuality, getType, hasIncumbent, MIPInfoCallbackI

从 "`OptimizationCallbackI`继承的方法
`getModel, getNcols, getNQCs, getNrows`

从 "`CallbackI`继承的方法
`abort, duplicateCallback, getCplexTime, getDetTime, getEndDetTime, getEndTime, getEnv, getStartDetTime, getStartTime, getType, main`

内部枚举
IncumbentCallbackI::SolutionSource

方法详细信息

getNodeData

公共NodeData*getNodeData() 常量

This method retrieves the NodeData object that may have previously been assigned to the current node by the user with the method IloCplex::BranchCallbackI::makeBranch. 如果当前节点未分配任何数据对象，则将返回 0（零）。

getNodeId

publicNodeId getNodeId() const

该方法返回当前节点的 "NodeId。

请参阅 MIPCallbackI::NodeId。

getObjValue

publicIloNum getObjValue() const

该方法返回潜在任职者的查询目标值。

如果您需要代表目标本身的对象，请考虑使用 "IloCplex::getObjective方法。

有关适用于该方法的整数、截断和舍入的特殊考虑因素，请参阅CPLEX 优化器中的整数值、整数公差和舍入概念。

内部枚举详细信息

枚举SolutionSource

定义文件： ilcplex/ilocplexi.h

该枚举列出的值说明了现任回调或懒约束回调是针对哪种类型的解决方案调用的。

NodeSolution积分解法是作为搜索树中一个节点的 LP 伸缩解法找到的。
HeuristicSolution积分解法由 CPLEX 内部启发式找到。
UserSolution积分解法是由用户的启发式回调函数找到的。该值只在现任回调中返回，不在懒惰约束回调中返回。
MIPStartSolution在 MIP 开始处理过程中找到积分解。请注意，在这种情况下调用的回调不能使用完整的 API。例如，不能在节点上设置/获取用户数据，也不能做其他任何需要搜索树节点上下文的操作。

字段

`NodeSolution = CPX_CALLBACK_MIP_INCUMBENT_NODESOLN`
`HeuristicSolution = CPX_CALLBACK_MIP_INCUMBENT_HEURSOLN`
`UserSolution = CPX_CALLBACK_MIP_INCUMBENT_USERSOLN`
`MIPStartSolution = CPX_CALLBACK_MIP_INCUMBENT_MIPSTART`