MIP heuristic frequency

Decides how often to apply the periodic heuristic.

Purpose

API	Parameter Name	Name prior to V12.6.0
C	CPXPARAM_MIP_Strategy_HeuristicFreq	CPX_PARAM_HEURFREQ
C++	IloCplex::Param::MIP::Strategy::HeuristicFreq	HeurFreq (long)
Java	IloCplex.Param.MIP.Strategy.HeuristicFreq	HeurFreq (long)
.NET	Cplex.Param.MIP.Strategy.HeuristicFreq	HeurFreq (long)
OPL	heurfreq	heurfreq
Python	parameters.mip.strategy.heuristicfreq	mip.strategy.heuristicfreq
Interactive	mip strategy heuristicfreq	mip strategy heuristicfreq
Identifier	2031	2031

Description

Decides how often to apply the periodic heuristic. Setting the value to -1 turns off the periodic heuristic. Setting the value to 0 (zero), the default, applies the periodic heuristic at an interval chosen automatically. Setting the value to a positive number applies the heuristic at the requested node interval. For example, setting this parameter to 20 dictates that the heuristic be called at node 0, 20, 40, 60, etc.

For an introduction to heuristics in CPLEX, see the topic Applying heuristicsamong the topics in Tuning performance features of the mixed integer optimizerin the CPLEX User’s Manual. For more about other heuristics, see the topics in Heuristics (also in the CPLEX User’s Manual). There, the topic Node heuristic refers specifically to this parameter.

Table 1. Values
Value	Meaning
-1	None
0	Automatic: let CPLEX choose; default
Any positive integer	Apply the periodic heuristic at this frequency

Note: The behavior of CPLEX is undefined if both heuristic effort and heuristic frequency are set to non-default values. These two parameters should not be used together.