Initializing help system before first use

TUNE

Purpose
This command can start a tuner session for the current problem. In this case, the tuner will solve the problem multiple times while evaluating a list of control settings and promising combinations of them. When finished, the tuner will select and set the best control setting on the problem. Note that the direction of optimization is given by OBJSENSE. This command can also handle the input and output of tuner method files.
Topic area
Tuner
Synopsis
TUNE [-flags] [subcommand [filename]] [objsense]
Arguments
flags 
Flags to pass to TUNE, which specify whether to tune the current problem as an LP or a MIP problem, and the algorithm for solving the LP problem or the initial LP relaxation of the MIP. The flags are optional. If the argument includes:
l 
will tune the problem as an LP (mutually exclusive with flag g);
g 
will tune the problem as a MIP (mutually exclusive with flag l);
x 
will tune the problem as a Global Optimization problem with Xpress Global;
d 
will use the dual simplex method;
p 
will use the primal simplex method;
b 
will use the barrier method;
n 
will use the network simplex method.
subcommand 
Subcommand to pass to TUNE for handling tuner method files. It can be one of:
pm / printmethod 
Print the tuner method on the console.
wm / writemethod 
Write the tuner method to a file.
rm / readmethod 
Read the tuner method from a file.
probset 
Tune a set of problems.
mipset 
Tune a set of MIP problems.
lpset 
Tune a set of LP problems.
filename 
Tuner method file or problem set file. This is an optional argument of the subcommand.
objsense 
Objective sense to use when solving the problem. This is optional and is only permitted for subcommands which perform tuning.
Related controls
Integer
TUNERHISTORY 
Whether to reuse and append to previous tuner result.
TUNERMAXTIME 
Maximum total time allowed for the tuner.
TUNERMETHOD 
Selects a factory tuner method.
TUNERMODE 
Enable or disable the tuner.
TUNEROUTPUT 
Whether to write tuner result and logs to file system.
TUNERPERMUTE 
Number of permutations to solve with each control setting.
TUNERTARGET 
Defines the criterion by which individual runs are compared.
TUNERTHREADS 
Number of threads to be used by the tuner.

String
TUNERMETHODFILE 
A file which contains a user-defined tuner method.
TUNEROUTPUTPATH 
The root path for all tuner result output.
TUNERSESSIONNAME 
When defined, will override the problem name within the tuner.

Example 1 (Console) 
TUNE -l
This tunes the current problem as an LP problem.
Example 2 (Console) 
TUNE pm
TUNE printmethod
Both commands print the tuner method to the console.
Example 3 (Console) 
TUNE rm method
TUNE readmethod  method
Both commands read the tuner method from the method.xtm file.
Example 4 (Console) 
TUNE wm method
TUNE writemethod method
Both commands write the tuner method to the method.xtm file.
Example 5 (Console) 
TUNE probset problem.set
Tune a set of problems defined by the problem.set file.
Example 6 (Console) 
TUNE lpset problem.set
Tune a set of LP problems defined by the problem.set file.
Further information
1. When both flags and subcommand are provided with the TUNE command, the subcommand will be ignored.
2. Please refer to Section Using the Tuner for a detailed guide of how to use the tuner.
3. Please refer to Section Tuning a Set of Problems for more information about tuning a set of problems.

Parent Topic Console and Library Functions

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.