Skip to content

Commit

Permalink
Merge pull request #2058 from numbbo/release
Browse files Browse the repository at this point in the history
Corrections in main README.md
  • Loading branch information
nikohansen authored Dec 8, 2021
2 parents e329892 + 80a9708 commit 11ce3cc
Showing 1 changed file with 4 additions and 12 deletions.
16 changes: 4 additions & 12 deletions code-postprocessing/README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,19 @@
# COmparing Continuous Optimisers (COCO) post-processing

The ([`cocopp`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.html)) package takes data generated with the [COCO framework](https://github.com/numbbo/coco) to compare continuous opitmizers and produces output figures and tables in <tt class="rst-docutils literal">html</tt> format and for including into LaTeX-documents.
The ([`cocopp`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.html)) package takes data generated with the [COCO framework](https://github.com/numbbo/coco) to compare continuous opitmizers and produces output figures and tables in <tt class="rst-docutils literal">html</tt> format and for including into LaTeX-documents.

## Installation

pip install cocopp

## Usage

The [`cocopp.Interface`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.Interface.html) class contains the most basic commands and data of the package, sufficient for most use cases.

<pre class="py-doctest"><span class="py-prompt">>>></span> <span class="py-keyword">import</span> cocopp
<span class="py-prompt">>>></span> <span class="py-builtin">sorted</span>(cocopp.Interface.dir())
<span class="py-output">['archives', 'config', 'genericsettings', 'load', 'main']</span>
<span class="py-output"></span><span class="py-prompt">>>></span> <span class="py-builtin">all</span>(<span class="py-builtin">hasattr</span>(cocopp, name) <span class="py-keyword">for</span> name <span class="py-keyword">in</span> cocopp.Interface.dir())
<span class="py-output">True</span></pre>

The main method of the [`cocopp`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.html) package is [`main`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.rungeneric.html#main) (currently aliased to [`cocopp.rungeneric.main`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.rungeneric.html#main)). The [`main`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.rungeneric.html#main) method also allows basic use of the post-processing through a shell command-line interface. The recommended use is however from an IPython/Jupyter shell or notebook:
The main method of the [`cocopp`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.html) package is [`main`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.rungeneric.html#main) (currently aliased to [`cocopp.rungeneric.main`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.rungeneric.html#main)). The [`main`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.rungeneric.html#main) method also allows basic use of the post-processing through a shell command-line interface. The recommended use is however from an IPython/Jupyter shell or notebook:

<pre class="py-doctest"><span class="py-prompt">>>></span> <span class="py-keyword">import</span> cocopp
<span class="py-prompt">>>></span> cocopp.main(<span class="py-string">'exdata/my_output another_folder yet_another_or_not'</span>) <span class="py-comment"></span></pre>

postprocesses data from one or several folders, for example data generated with the help from the [`cocoex`](https://coco.gforge.inria.fr/apidocs-cocoex) module. Each folder should contain data of a full experiment with a single algorithm. (Within the folder the data can be distributed over subfolders). Results can be explored from the <tt class="rst-docutils literal">ppdata/index.html</tt> file, unless a a different output folder is specified with the <tt class="rst-docutils literal"><span class="pre">-o</span></tt> option. **Comparative data** from over 200 full experiments are archived online and can be listed, filtered, and retrieved from [`cocopp.archives`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.archives.html) (of type [`OfficialArchives`](https://coco.gforge.inria.fr/apidocs-cocopp/cocopp.archiving.OfficialArchives.html)) and processed alone or together with local data. For example
postprocesses data from one or several folders, for example data generated with the help from the [`cocoex`](https://numbbo.github.io/gforge/apidocs-cocoex) module. Each folder should contain data of a full experiment with a single algorithm. (Within the folder the data can be distributed over subfolders). Results can be explored from the <tt class="rst-docutils literal">ppdata/index.html</tt> file, unless a a different output folder is specified with the <tt class="rst-docutils literal"><span class="pre">-o</span></tt> option. **Comparative data** from over 200 full experiments are archived online and can be listed, filtered, and retrieved from [`cocopp.archives`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.archives.html) (of type [`OfficialArchives`](https://numbbo.github.io/gforge/apidocs-cocopp/cocopp.archiving.OfficialArchives.html)) and processed alone or together with local data. For example

<pre class="py-doctest"><span class="py-prompt">>>></span> cocopp.archives.bbob(<span class="py-string">'bfgs'</span>) <span class="py-comment"></span>
<span class="py-output">['2009/BFGS_...</span></pre>
Expand All @@ -38,7 +30,7 @@ Only a trailing `*` is accepted and any string containing the substring is match

<pre class="py-doctest"><span class="py-prompt">>>></span> cocopp.main(<span class="py-string">'bbob/2009/*'</span>) <span class="py-comment"></span></pre>

can be browsed at [http://coco.gforge.inria.fr/ppdata-archive/bbob/2009-all](http://coco.gforge.inria.fr/ppdata-archive/bbob/2009-all). To display algorithms in the background, the <tt class="rst-docutils literal">genericsettings.background</tt> variable needs to be set:
can be browsed at [https://numbbo.github.io/ppdata-archive/bbob/2009-all](https://numbbo.github.io/ppdata-archive/bbob/2009-all). To display algorithms in the background, the <tt class="rst-docutils literal">genericsettings.background</tt> variable needs to be set:

<pre class="py-doctest"><span class="py-prompt">>>></span> cocopp.genericsettings.background = {<span class="py-builtin">None</span>: cocopp.archives.bbob.get_all(<span class="py-string">'bfgs'</span>)} <span class="py-comment"></span></pre>

Expand Down

0 comments on commit 11ce3cc

Please sign in to comment.