Skip to main content

Streamlined machine learning experiment management.

Project description


Build Status PyPI version

randopt is a Python package for machine learning experiment management, hyper-parameter optimization, and results visualization. Some of its features include:

  • result logging and management,
  • human-readable format,
  • support for parallelism / distributed / asynchronous experiments,
  • command-line and programmatic API,
  • shareable, flexible Web visualization,
  • automatic hyper-parameter search, and
  • pure Python - no dependencies !

Installation

pip install randopt

Usage

import randopt as ro

def loss(x):
    return x**2

e = ro.Experiment('myexp', {
        'alpha': ro.Gaussian(mean=0.0, std=1.0, dtype='float'),
    })

# Sampling parameters
for i in xrange(100):
    e.sample('alpha')
    res = loss(e.alpha)
    print('Result: ', res)
    e.add_result(res)

# Manually setting parameters
e.alpha = 0.00001
res = loss(e.alpha)
e.add_result(res)

# Search over all experiments results, including ones from previous runs
opt = e.minimum()
print('Best result: ', opt.result, ' with params: ', opt.params)

Results Visualization

Once you obtained some results, run roviz.py path/to/experiment/folder to visualize them in your web browser.

For more info on visualization and roviz.py, refer to the Visualizing Results tutorial.

Hyper-Parameter Optimization

To generate results and search for good hyper-parameters you can either user ropt.py or write your own optimizaiton script using the Evolutionary and GridSearch classes.

For more info on hyper-parameter optimization, refer to the Optimizing Hyperparams tutorial.

Documentation

For more examples, tutorials, and documentation refer to the wiki.

Contributing

To contribute to Randopt, it is recommended to follow the contribution guidelines.

Acknowledgements

Randopt is maintained by Séb Arnold, with numerous contributions from the following persons.

  • Noel Trivedi
  • Cyrus Jia
  • Daler Asrorov

License

Randopt is released under the Apache 2 License. For more information, refer to the LICENSE file.

I would love to hear how your use Randopt. Feel free to drop me a line !

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

randopt-0.2.7.tar.gz (22.0 kB view details)

Uploaded Source

File details

Details for the file randopt-0.2.7.tar.gz.

File metadata

  • Download URL: randopt-0.2.7.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.23.0 setuptools/40.2.0 requests-toolbelt/0.9.1 tqdm/4.26.0 CPython/3.7.1

File hashes

Hashes for randopt-0.2.7.tar.gz
Algorithm Hash digest
SHA256 42d8180d1218b9e44d5e54a3716c0588706d95cd7ea3e6e8e35b7c7c1a8dbf5a
MD5 bc14438da793bebf1803aecc8590f465
BLAKE2b-256 ad0bf8596137125133e8d9c401312dce3e7e4689f6532f9da520b446777a45ef

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page