Package: irace 4.4.0

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.0.tar.gz
irace_4.4.0.zip(r-4.6)irace_4.4.0.zip(r-4.5)irace_4.4.0.zip(r-4.4)
irace_4.4.0.tgz(r-4.6-x86_64)irace_4.4.0.tgz(r-4.6-arm64)irace_4.4.0.tgz(r-4.5-x86_64)irace_4.4.0.tgz(r-4.5-arm64)
irace_4.4.0.tar.gz(r-4.6-arm64)irace_4.4.0.tar.gz(r-4.6-x86_64)irace_4.4.0.tar.gz(r-4.5-arm64)irace_4.4.0.tar.gz(r-4.5-x86_64)
irace_4.4.0.tgz(r-4.5-emscripten)
irace.pdf |irace.html✨
irace/json (API)
NEWS

# 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:

Conda:

algorithm-configurationhyperparameter-tuningiraceoptimization-algorithms

10.61 score 70 stars 1 packages 143 scripts 4.7k downloads 4 mentions 49 exports 8 dependencies

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

TargetResultTotal timeArtifact
linux-devel-arm64OK151
linux-devel-x86_64OK152
source / vignettesOK230
linux-release-arm64OK157
linux-release-x86_64OK150
macos-devel-arm64OK135
macos-devel-x86_64OK229
macos-release-arm64OK159
macos-release-x86_64OK325
windows-develOK120
windows-releaseOK113
windows-oldrelOK115
wasm-releaseOK118

Exports:ablationablation_cmdlinebuildCommandLinecheck_output_target_runnercheckIraceScenariocheckParameterscheckScenarioconfigurations_printconfigurations_print_commanddefaultScenarioget_instanceID_seed_pairsget_random_seedgetConfigurationByIdgetConfigurationByIterationgetFinalEliteshas_testing_datairaceirace_cmdlineirace_licenseirace_mainirace_summariseirace_versionirace.cmdlinemulti_iraceparam_catparam_intparam_ordparam_realparametersNewpath_rel2absplotAblationprintParametersprintScenariopsRaceread_ablogfileread_logfileread_pcs_filereadConfigurationsFilereadParametersreadScenarioremoveConfigurationsMetaDatarestore_random_seedscenario_update_pathsset_random_seedtarget_evaluator_defaulttarget_runner_defaulttestConfigurationstesting_fromfiletesting_fromlog

Dependencies:codetoolsdata.tablefsmatrixStatsR6Rcppspacefillrwithr

irace package: User Guide

Rendered fromirace-package.Rnwusingknitr::knitron Feb 04 2026.

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

Readme and manuals

Help Manual

Help pageTopics
The irace package: Iterated Racing for Automatic Algorithm Configurationirace-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 configurationbuildCommandLine
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
checkParameterscheckParameters
Check and correct the given scenariocheckScenario
Print configurations as a data frameconfigurations_print
Print configurations as command-line strings.configurations_print_command
Default scenario settingsdefaultScenario
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_licenseirace_license
Higher-level interface to launch irace.irace_main
Summarise the results of a run of iraceirace_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 logplotAblation
Print parameter space in the textual format accepted by irace.printParameters
Prints the given scenarioprintScenario
Post-selection racepsRace
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 filereadConfigurationsFile
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
removeConfigurationsMetaDataremoveConfigurationsMetaData
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_defaulttarget_evaluator_default
Default 'targetRunner' function.target_runner_default
Execute the given configurations on the testing instances specified in the scenariotestConfigurations
Test configurations given an explicit table of configurations and a scenario filetesting_fromfile
Test configurations given in the logfile (typically 'irace.Rdata') produced by 'irace'.testing_fromlog
Image

  • Image