Package: irace 4.4.3

irace: Iterated Racing for Automatic Algorithm Configuration

Iterated race is an extension of the Iterated F-race method for the automatic configuration of optimization algorithms, that is, (offline) tuning their parameters by finding the most appropriate settings given a set of instances of an optimization problem. M. López-Ibáñez, J. Dubois-Lacoste, L. Pérez Cáceres, T. Stützle, and M. Birattari (2016) <doi:10.1016/j.orp.2016.09.002>.

Authors:Manuel López-Ibáñez [aut, cre], Jérémie Dubois-Lacoste [aut], Leslie Pérez Cáceres [aut], Thomas Stützle [aut], Mauro Birattari [aut], Eric Yuan [ctb], Prasanna Balaprakash [ctb], Nguyen Dang [ctb]

irace_4.4.3.tar.gz
irace_4.4.3.zip(r-4.7)irace_4.4.3.zip(r-4.6)irace_4.4.3.zip(r-4.5)
irace_4.4.3.tgz(r-4.6-x86_64)irace_4.4.3.tgz(r-4.6-arm64)irace_4.4.3.tgz(r-4.5-x86_64)irace_4.4.3.tgz(r-4.5-arm64)
irace_4.4.3.tar.gz(r-4.7-arm64)irace_4.4.3.tar.gz(r-4.7-x86_64)irace_4.4.3.tar.gz(r-4.6-arm64)irace_4.4.3.tar.gz(r-4.6-x86_64)
irace_4.4.3.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
irace/json (API)

# Install 'irace' in R:

install.packages('irace', repos = c('https://mlopez-ibanez.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/mlopez-ibanez/irace/issues

Pkgdown/docs site:https://mlopez-ibanez.github.io

On CRAN:

algorithm-configuration hyperparameter-tuning irace optimization-algorithms

11.07 score 76 stars 1 packages 347 scripts 4.6k downloads 4 mentions 49 exports 8 dependencies

Last updated from:e9157888a1. Checks:13 OK. Indexed: yes.

Target	Result	Time
linux-devel-arm64	OK	211
linux-devel-x86_64	OK	164
source / vignettes	OK	248
linux-release-arm64	OK	216
linux-release-x86_64	OK	175
macos-release-arm64	OK	106
macos-release-x86_64	OK	370
macos-oldrel-arm64	OK	93
macos-oldrel-x86_64	OK	247
windows-devel	OK	107
windows-release	OK	113
windows-oldrel	OK	161
wasm-release	OK	143

Exports:ablation ablation_cmdline buildCommandLine check_output_target_runner checkIraceScenario checkParameters checkScenario configurations_print configurations_print_command defaultScenario get_instanceID_seed_pairs get_random_seed getConfigurationById getConfigurationByIteration getFinalElites has_testing_data irace irace_cmdline irace_license irace_main irace_summarise irace_version irace.cmdline multi_irace param_cat param_int param_ord param_real parametersNew path_rel2abs plotAblation printParameters printScenario psRace read_ablogfile read_logfile read_pcs_file readConfigurationsFile readParameters readScenario removeConfigurationsMetaData restore_random_seed scenario_update_paths set_random_seed target_evaluator_default target_runner_default testConfigurations testing_fromfile testing_fromlog

Dependencies:codetools data.table fs matrixStats R6 Rcpp spacefillr withr

irace package: User Guide

Rendered fromirace-package.Rnwusingknitr::knitr

Last update: 2026-02-01
Started: 2016-06-01

Help page	Topics
The irace package: Iterated Racing for Automatic Algorithm Configuration	irace-package
Performs ablation between two configurations (from source to target).	ablation
Launch ablation with command-line options.	ablation_cmdline
Generate a command-line representation of a configuration	buildCommandLine
Check the output of the target runner and repair it if possible. If the output is incorrect, this function will throw an error.	check_output_target_runner
Test that the given irace scenario can be run.	checkIraceScenario
checkParameters	checkParameters
Check and correct the given scenario	checkScenario
Print configurations as a data frame	configurations_print
Print configurations as command-line strings.	configurations_print_command
Default scenario settings	defaultScenario
Returns the pairs of instance IDs and seeds used as instances in the race (and optionally the actual instances).	get_instanceID_seed_pairs
Returns the configurations selected by ID.	getConfigurationById
Returns the configurations by the iteration in which they were executed.	getConfigurationByIteration
Return the elite configurations of the final iteration.	getFinalElites
Check if the results object generated by irace has data about the testing phase.	has_testing_data
Execute one run of the Iterated Racing algorithm.	irace
Launch 'irace' with command-line options.	irace.cmdline irace_cmdline
irace_license	irace_license
Higher-level interface to launch irace.	irace_main
Summarise the results of a run of irace	irace_summarise
A character string containing the version of 'irace' including git SHA.	irace_version
Execute 'irace()' multiple times with the same or different scenarios and parameter space definitions.	multi_irace
Create a parameter space to be tuned.	parameters parametersNew param_cat param_int param_ord param_real
Converts a relative path to an absolute path.	path_rel2abs
Create plot from an ablation log	plotAblation
Print parameter space in the textual format accepted by irace.	printParameters
Prints the given scenario	printScenario
Post-selection race	psRace
Get, set and restore the state of the random number generator state.	get_random_seed random_seed restore_random_seed set_random_seed
Read the log file ('log-ablation.Rdata') produced by 'ablation()'.	read_ablogfile
Read the log file produced by irace ('irace.Rdata').	read_logfile
Read parameters in PCS (AClib) format and write them in irace format.	read_pcs_file
Read parameter configurations from a file	readConfigurationsFile
Reads the parameters to be tuned by 'irace' from a file or from a character string.	readParameters
Reads from a file the scenario settings to be used by 'irace'.	readScenario
removeConfigurationsMetaData	removeConfigurationsMetaData
Save the log generated by 'irace' to a file (by default 'irace.Rdata').	save_irace_logfile
Update filesystem paths of a scenario consistently.	scenario_update_paths
target_evaluator_default	target_evaluator_default
Default 'targetRunner' function.	target_runner_default
Execute the given configurations on the testing instances specified in the scenario	testConfigurations
Test configurations given an explicit table of configurations and a scenario file	testing_fromfile
Test configurations given in the logfile (typically 'irace.Rdata') produced by 'irace'.	testing_fromlog

Package: irace 4.4.3

irace: Iterated Racing for Automatic Algorithm Configuration

Citation

Development and contributors

Readme and manuals

Help Manual

Usage by other packages (reverse dependencies)