IOHanalyzer

The performance analyzer for Iterative Optimization Heuristics (IOHs).

Documentation: https://arxiv.org/abs/1810.05281
Wiki page: https://iohprofiler.github.io/IOHanalyzer/
Bug reports: https://github.com/IOHprofiler/IOHAnalyzer/issues
Online service: http://iohprofiler.liacs.nl
General Contact: mailto:iohprofiler@liacs.leidenuniv.nl
Mailing List: https://lists.leidenuniv.nl/mailman/listinfo/iohprofiler

It provides:

a web-based interface to analyze and visualize the empirical performance of IOHs,
interactive plot,
statistical evaluation,
report generation, and
R programming interfaces in the backend.

It is built on:

R packages Shiny, Plotly and Rcpp.

It is available through:

a free online service that you can use right away, or
the local installation of the package.

Online Service

A free server http://iohprofiler.liacs.nl running the stable version of IOHanalyzer is hosted in Leiden Institute of Advanced Computer Science. You're welcome to check it out!

Installation

Software dependency

[mandatory] R As IOHanalyzer is written as a R package, the R environment has to be installed first. The binary file and installation manual for R can be found here https://cran.r-project.org/.
[optional] orca required to download plotly figures. Please see https://github.com/plotly/orca for the installation instruction.

Stable version

Please start up a R console and install the stable version as:

install.packages('IOHanalyzer')

which is maintained on CRAN (Comprehensive R Archive Network).

Lastest version

The lastest development is always hosted on Github. In case you'd like to try out this version, the R package devtool is needed:

install.packages('devtools')
devtools::install_github('IOHprofiler/IOHanalyzer')

Runinng the Web Interface locally

The IOHanalyzer package can be installed and loaded using the following commands:

library('IOHanalyzer')
runServer()

Have fun! For the complete reference on usage, please check out our Wiki page.

Host it online?

We provide docker file for deploying IOHanalyzer on the server. Please see https://github.com/IOHprofiler/IOHanalyzer-docker for details.

Supported Data Format

Specific formats are required to load your benchmark data to IOHanalyzer. If your data sets are generated in the format of

COCO/BBOB data format as regulated in https://hal.inria.fr/inria-00362649,
Nevergrad data format (explained in https://github.com/facebookresearch/nevergrad), or
IOHprofiler data format, which is motivated and modified from COCO data format,

then you just need to compress the data folder obtained from the experiment into a zip file and uploaded it. However, you are encouraged to convert your own benchmark data to the format regulated here!. The supported data format is specified in this page. Please follow the instruction there to convert your data sets.

Our Team

Hao Wang, Leiden Institute of Advanced Computer Science.
Diederick Vermetten, Leiden Institute of Advanced Computer Science.
Furong Ye, Leiden Institute of Advanced Computer Science.
Ofer M. Shir, Tel-Hai College, Israel.
Carola Doerr, CNRS and Sorbonne University.
Thomas Bäck, Leiden Institute of Advanced Computer Science.

When using IOHprofiler and parts thereof, please kindly cite this work as

Carola Doerr, Hao Wang, Furong Ye, Sander van Rijn, Thomas Bäck: IOHprofiler: A Benchmarking and Profiling Tool for Iterative Optimization Heuristics, arXiv e-prints:1810.05281, 2018.

@ARTICLE{IOHprofiler,
  author = {Carola Doerr and Hao Wang and Furong Ye and Sander van Rijn and Thomas B{\"a}ck},
  title = {{IOHprofiler: A Benchmarking and Profiling Tool for Iterative Optimization Heuristics}},
  journal = {arXiv e-prints:1810.05281},
  archivePrefix = "arXiv",
  eprint = {1810.05281},
  year = 2018,
  month = oct,
  keywords = {Computer Science - Neural and Evolutionary Computing},
  url = {https://arxiv.org/abs/1810.05281}
}

License

This application is governed by the BSD 3-Clause license.

BSD 3-Clause License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

nojhan/IOHanalyzer