getSearchRuns: Get search run data

Description Usage Arguments Details Value


Extract the data corresponding to the subsequent runs of a specific search being applied to a specific problem. This is a generic S3 method.





data object containing the analysis results


name of the analyzed problem. Can be omitted if the data contains results for a single problem only.


name of the applied search. Can be omitted if the data contains results for a single search only (for the considered problem).


If the data contains results for a single problem only, the argument problem can be omitted. Likewise, if for the considered problem results are available for a single search only, the argument search can be omitted.


A list containing one element for each search run.

Each run has at least two elements time and values, which are both numeric vectors. The time vector indicates when the best solution was updated during search and the new best solution's value is found at the respective index in values. Times are expressed in milliseconds since starting the search. A time of -1 indicates that the search was not yet running, which e.g. occurs when a local search adopts a random current solution during initialization. Times are always positive (or -1) and increasing. Values are either increasing (in case of maximization) or decreasing (in case of minimization).

If contained in the given data, a run also has an element best.solution representing the final best solution found during that search run. The last element of values then indicates the value of this best solution. When writing results obtained from the analysis tools in the 'JAMES' extensions module to a JSON file, one should provide a JSON converter for the solution type of the analyzed problems if it is desired that the actual best found solutions are contained in the output file.

james.analysis documentation built on May 1, 2019, 9:13 p.m.