https://github.com/benchopt/template_benchmark
https://github.com/benchopt/template_benchmark
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/benchopt/template_benchmark
- Owner: benchopt
- Created: 2021-01-28T13:03:35.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-07-16T16:42:22.000Z (almost 2 years ago)
- Last Synced: 2024-07-17T19:51:32.685Z (almost 2 years ago)
- Language: Python
- Size: 48.8 KB
- Stars: 24
- Watchers: 6
- Forks: 19
- Open Issues: 4
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
README
Template for Benchopt Benchmark repositories
=============================================
|Build Template|
This repo should be used with the following steps:
1. Hit the `Use this template` button on the top of `this page `_,
2. Use the form to create a new github repository with your benchmark name,
3. Clone the newly created repository on your computer,
4. Run ``python clean_template.py`` script that will remove instruction relative to
the template in ``README.rst`` and update it with your repo and org name.
5. Edit the problem description in the ``README.rst``.
6. Update ``objective.py`` and the files in ``datasets`` and ``solvers`` to create the benchmark.
My Benchopt Benchmark
=====================
|Build Status| |Python 3.6+|
Benchopt is a package to simplify and make more transparent and
reproducible comparisons of optimization methods.
This benchmark is dedicated to solvers of **describe your problem**:
$$\\min_{\\beta} f(X, \\beta),$$
where $X$ is the matrix of data and $\\beta$ is the optimization variable.
Install
--------
This benchmark can be run using the following commands:
.. code-block::
$ pip install -U benchopt
$ git clone https://github.com/#ORG/#BENCHMARK_NAME
$ benchopt run #BENCHMARK_NAME
Apart from the problem, options can be passed to ``benchopt run``, to restrict the benchmarks to some solvers or datasets, e.g.:
.. code-block::
$ benchopt run #BENCHMARK_NAME -s solver1 -d dataset2 --max-runs 10 --n-repetitions 10
Use ``benchopt run -h`` for more details about these options, or visit https://benchopt.github.io/api.html.
.. |Build Template| image:: https://github.com/benchopt/template_benchmark/actions/workflows/main.yml/badge.svg
:target: https://github.com/benchopt/template_benchmark/actions
.. |Build Status| image:: https://github.com/#ORG/#BENCHMARK_NAME/actoiworkflows/main.yml/badge.svg
:target: https://github.com/#ORG/#BENCHMARK_NAME/actions
.. |Python 3.6+| image:: https://img.shields.io/badge/python-3.6%2B-blue
:target: https://www.python.org/downloads/release/python-360/