irace: irace2pyimp – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

irace2pyimp

Convert an irace.Rdata file into the format supported by PyImp

Description

This function converts an irace.Rdata file generated by irace into the input format supported by the parameter importance analysis tool PyImp (https://github.com/automl/ParameterImportance).

Usage

irace2pyimp(file = "./irace.Rdata", normalise = "none",
  outdir = "./pyimp-input/", instanceFeatureFile = NA,
  filterConditions = NA, defaultConfigurationID = 1,
  ignoreUnsupported = 0)

Arguments

`file`	(`character(1)`) Filename of the `.Rdata` file generated by irace after a tuning run is finished.
`normalise`	(`none` \| `instance` \| `feature`) Normalise the cost metric values into `[0, 1]` range before converting to PyImp format. Possible values are: * `none` (default): no normalisation. * `instance` : normalisation is done per instance. * `feature` : normalisation is based on features, i.e., instances with the same feature-vector values are grouped together and the normalised cost is calculated per group.
`outdir`	(`character(1)`) Directory where all generated files are stored.
`instanceFeatureFile`	(`character(1)`) A `.csv` file containing instance features (one line per instance, sorted in the same order as the list of instances input to irace). The first line contains feature names.
`filterConditions`	Only extract data that satisfies the given conditions. The conditions are in R expression format.
`defaultConfigurationID`	Index of default configuration (starting from 1), used by ablation analysis.
`ignoreUnsupported`	Forbidden configurations and repairConfiguration are not supported by the script. Set ignoreUnsupported=1 to ignore them and proceed with your own risk. This may cause some unwanted behaviours, e.g., forbidden configurations may appear in ablation analysis's path.

Details

The generated files include:

params.pcs : a text file containing the parameter space definition.
runhistory.json : a JSON file containing the list of algorithm configurations evaluated during the tuning and the performance data obtained.
traj_aclib2.json : a JSON file containing the best configurations after each iteration of irace. The last configuration will be used as the target configuration in ablation analysis.
scenario.txt : a text file containing the definition of the tuning scenario.
instances.txt : a text file containing the list of instances.
features.csv : a text file containing instance features. If no instance features are provided, the index of each instance will be used as a feature.

Author(s)

Nguyen Dang and Manuel López-Ibáñez

Examples

## Not run: 
irace2pyimp(file='irace.Rdata', outdir='pyimp-run')
irace2pyimp(file='irace.Rdata', normalise='feature',
            instanceFeatureFile='feature.csv', filterConditions="algorithm!='mas'")

## End(Not run)
cat("See more examples in '",
    file.path(system.file(package="irace"), "examples/irace2pyimp/acotsp/run.sh"),
    "' and in '",
    file.path(system.file(package="irace"), "examples/irace2pyimp/002-TemplateDesign/run.sh"),
    "'\n")

irace

Iterated Racing for Automatic Algorithm Configuration

v3.4.1

GPL (>= 2)

Authors

Manuel López-Ibáñez [aut, cre] (<https://orcid.org/0000-0001-9974-1295>), 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]

Initial release