/// <summary>
/// Builds an instance of the <see cref="AlgorithmTuner{TTargetAlorithm,TInstance,TResult}" /> class for tuning Gurobi.
/// </summary>
/// <param name="configuration">The <see cref="AlgorithmTunerConfiguration" /> to use.</param>
/// <param name="pathToTrainingInstanceFolder">The path to the folder containing training instances.</param>
/// <param name="pathToTestInstanceFolder">The path to test instance folder.</param>
/// <param name="gurobiConfigBuilder">The gurobi configuration builder.</param>
/// <returns>
/// The built instance.
/// </returns>
public static AlgorithmTuner <GurobiRunner, InstanceSeedFile, GurobiResult> BuildGurobiRunner(
AlgorithmTunerConfiguration configuration,
string pathToTrainingInstanceFolder,
string pathToTestInstanceFolder,
GurobiRunnerConfiguration.GurobiRunnerConfigBuilder gurobiConfigBuilder)
{
var gurobiConfig = gurobiConfigBuilder.Build(configuration.CpuTimeout);
var tuner = new AlgorithmTuner <GurobiRunner, InstanceSeedFile, GurobiResult>(
targetAlgorithmFactory: new GurobiRunnerFactory(gurobiConfig),
runEvaluator: new GurobiRunEvaluator(),
trainingInstances: GurobiUtils.CreateInstances(pathToTrainingInstanceFolder, gurobiConfig.NumberOfSeeds, gurobiConfig.RngSeed),
parameterTree: GurobiUtils.CreateParameterTree(),
configuration: configuration);
try
{
if (!string.IsNullOrWhiteSpace(pathToTestInstanceFolder))
{
var testInstances = GurobiUtils.CreateInstances(pathToTestInstanceFolder, gurobiConfig.NumberOfSeeds, gurobiConfig.RngSeed);
tuner.SetTestInstances(testInstances);
}
}
catch
{
}
return(tuner);
}
/// <summary>
/// Builds the <see cref="GurobiRunnerConfiguration"/> and checks the thread count.
/// </summary>
/// <param name="gurobiConfigBuilder">The <see cref="GurobiRunnerConfiguration.GurobiRunnerConfigBuilder"/>.</param>
/// <param name="tunerConfig">The <see cref="AlgorithmTunerConfiguration"/>.</param>
/// <returns>The <see cref="GurobiRunnerConfiguration"/>.</returns>
private static GurobiRunnerConfiguration BuildGurobiConfigAndCheckThreadCount(
GurobiRunnerConfiguration.GurobiRunnerConfigBuilder gurobiConfigBuilder,
AlgorithmTunerConfiguration tunerConfig)
{
var gurobiConfig = gurobiConfigBuilder.Build(tunerConfig.CpuTimeout);
if (gurobiConfig.ThreadCount * tunerConfig.MaximumNumberParallelEvaluations > Environment.ProcessorCount)
{
LoggingHelper.WriteLine(
VerbosityLevel.Warn,
$"Warning: You specified {tunerConfig.MaximumNumberParallelEvaluations} parallel evaluations with {gurobiConfig.ThreadCount} threads each, but only have {Environment.ProcessorCount} processors. Processes may fight for resources.");
}
return(gurobiConfig);
}
/// <summary>
/// Builds an instance of the <see cref="AlgorithmTuner{TTargetAlorithm,TInstance,TResult}" /> class for tuning Gurobi.
/// </summary>
/// <param name="tunerConfig">The <see cref="AlgorithmTunerConfiguration" /> to use.</param>
/// <param name="pathToTrainingInstanceFolder">The path to the folder containing training instances.</param>
/// <param name="pathToTestInstanceFolder">The path to test instance folder.</param>
/// <param name="gurobiConfigBuilder">The gurobi configuration builder.</param>
/// <returns>
/// The built instance.
/// </returns>
public static AlgorithmTuner <GurobiRunner, InstanceSeedFile, GurobiResult> BuildGurobiRunner(
AlgorithmTunerConfiguration tunerConfig,
string pathToTrainingInstanceFolder,
string pathToTestInstanceFolder,
GurobiRunnerConfiguration.GurobiRunnerConfigBuilder gurobiConfigBuilder)
{
var gurobiConfig = Program.BuildGurobiConfigAndCheckThreadCount(gurobiConfigBuilder, tunerConfig);
var tuner = new AlgorithmTuner <GurobiRunner, InstanceSeedFile, GurobiResult>(
targetAlgorithmFactory: new GurobiRunnerFactory(gurobiConfig, tunerConfig),
runEvaluator: new GurobiRunEvaluator(tunerConfig.CpuTimeout),
trainingInstances: InstanceSeedFile.CreateInstanceSeedFilesFromDirectory(
pathToTrainingInstanceFolder,
GurobiUtils.ListOfValidFileExtensions,
gurobiConfig.NumberOfSeeds,
gurobiConfig.RngSeed),
parameterTree: GurobiUtils.CreateParameterTree(),
configuration: tunerConfig,
customGrayBoxMethods: new GurobiGrayBoxMethods());
try
{
if (!string.IsNullOrWhiteSpace(pathToTestInstanceFolder))
{
var testInstances = InstanceSeedFile.CreateInstanceSeedFilesFromDirectory(
pathToTestInstanceFolder,
GurobiUtils.ListOfValidFileExtensions,
gurobiConfig.NumberOfSeeds,
gurobiConfig.RngSeed);
tuner.SetTestInstances(testInstances);
}
}
catch
{
}
return(tuner);
}
