OverviewGroupIndexConcepts
NO FRAMES

CPXtuneparamprobset

public int CPXtuneparamprobset(CPXENVptr env, int filecnt, char ** filename, char ** filetype, int intcnt, const int * intind, const int * intval, int dblcnt, const int * dblind, const double * dblval, int strcnt, const int * strind, char ** strval, int * tunestat_p)
Definition file: cplex.h

The routine CPXtuneparamprobset tunes the parameters of the environment for improved optimizer performance for a set of problems. Tuning is carried out by making a number of trial runs with a variety parameter settings. Parameters and associated values which should not be changed by the tuning process (known as the fixed parameters) can be specified as arguments.

After CPXtuneparamprobset has finished, the environment will contain the combined fixed and tuned parameter settings, which the user can query or write to a file.

All callbacks, except the tuning callback, will be ignored. Tuning will monitor the value set by CPXsetterminate and terminate when this value is set.

A few of the parameter settings in the environment control the tuning process. They are specified in the table below; other parameter settings in the environment are ignored.

ParameterUse
CPX_PARAM_TILIMLimits the total time spent tuning
CPX_PARAM_TUNINGTILIMLimits the time of each trial run
CPX_PARAM_TUNINGMEASUREControls the tuning evaluation measure
CPX_PARAM_TUNINGDISPLAYControls the level of the tuning display
CPX_PARAM_SCRINDControls screen output

The value tunestat is 0 (zero) when tuning has completed and nonzero when it has not. The two nonzero statuses are CPX_TUNE_ABORT, which will be set when the terminate value passed to CPXsetterminate is set, and CPX_TUNE_TILIM, which will be set when the time limit specified by CPX_PARAM_TILIM is reached. Tuning will set any parameters which have been chosen even when tuning is not completed.

Parameters:

env

A pointer to the CPLEX environment, as returned by CPXopenCPLEX.

filecnt

An integer that specifies the number of problem files.

filename

An array of length filecnt containing problem file names.

filetype

An array of length filecnt containing problem file types, as documented in CPXreadcopyprob. May be NULL; then CPLEX discerns file types from the file extensions of the file names.

intcnt

An integer that specifies the number of integer parameters to be fixed during tuning. This argument specifies the length of the arrays intnum and intval.

intval

An array containing the values for the parameters listed in intnum. May be NULL if intcnt is 0 (zero).

dblcnt

An integer that specifies the number of double parameters to be fixed during tuning. This specifies the length of the arrays dblnum and dblval.

dblval

An array containing the values for the parameters listed in dblnum. May be NULL if dblcnt is 0 (zero).

strcnt

An integer that specifies the number of string parameters to be fixed during tuning. This specifies the length of the arrays strnum and strval.

strval

An array containing the values for the parameters listed in strnum. May be NULL if strcnt is 0 (zero).

tunestat_p

A pointer to an integer to receive the tuning status.

Returns:

The routine returns zero if successful and nonzero if an error occurs.