{ "info": { "author": "Robert T. McGibbon", "author_email": "rmcgibbo@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: Apache Software License", "Operating System :: MacOS", "Operating System :: Microsoft :: Windows", "Operating System :: Unix", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Scientific/Engineering", "Topic :: Scientific/Engineering :: Information Analysis" ], "description": "Osprey\n======\n\n|Build Status| |Coverage Status| |PyPi version| [|License|]\n(http://www.apache.org/licenses/LICENSE-2.0) |DOI| [|Documentation|]\n(http://msmbuilder.org/osprey)\n\n.. figure:: http://msmbuilder.org/osprey/development/_static/osprey.svg\n :alt: Logo\n\n Logo\n\nOsprey is an easy-to-use tool for hyperparameter optimization for\nmachine learning algorithms in python using scikit-learn (or using\nscikit-learn compatible APIs).\n\nEach Osprey experiment combines an dataset, an estimator, a search space\n(and engine), cross validation and asynchronous serialization for\ndistributed parallel optimization of model hyperparameters.\n\nDocumentation\n-------------\n\nFor full documentation, please visit the `Osprey\nhomepage `__.\n\nInstallation\n------------\n\nIf you have an Anaconda Python distribution, installation is as easy as:\n\n::\n\n $ conda install -c omnia osprey\n\nYou can also install Osprey with ``pip``:\n\n::\n\n $ pip install osprey\n\nAlternatively, you can install directly from this GitHub repo:\n\n::\n\n $ git clone https://github.com/msmbuilder/osprey.git\n $ cd osprey && git checkout 1.1.0\n $ python setup.py install\n\nExample using `MSMBuilder `__\n-----------------------------------------------------------------------\n\nBelow is an example of an osprey ``config`` file to cross validate\nMarkov state models based on varying the number of clusters and dihedral\nangles used in a model:\n\n.. code:: yaml\n\n estimator:\n eval_scope: msmbuilder\n eval: |\n Pipeline([\n ('featurizer', DihedralFeaturizer(types=['phi', 'psi'])),\n ('cluster', MiniBatchKMeans()),\n ('msm', MarkovStateModel(n_timescales=5, verbose=False)),\n ])\n\n search_space:\n cluster__n_clusters:\n min: 10\n max: 100\n type: int\n featurizer__types:\n choices:\n - ['phi', 'psi']\n - ['phi', 'psi', 'chi1']\n type: enum\n\n cv: 5\n\n dataset_loader:\n name: mdtraj\n params:\n trajectories: ~/local/msmbuilder/Tutorial/XTC/*/*.xtc\n topology: ~/local/msmbuilder/Tutorial/native.pdb\n stride: 1\n\n trials:\n uri: sqlite:///osprey-trials.db\n\nThen run ``osprey worker``. You can run multiple parallel instances of\n``osprey worker`` simultaneously on a cluster too.\n\n::\n\n $ osprey worker config.yaml\n\n ...\n\n ----------------------------------------------------------------------\n Beginning iteration 1 / 1\n ----------------------------------------------------------------------\n History contains: 0 trials\n Choosing next hyperparameters with random...\n {'cluster__n_clusters': 20, 'featurizer__types': ['phi', 'psi']}\n\n Fitting 5 folds for each of 1 candidates, totalling 5 fits\n [Parallel(n_jobs=1)]: Done 1 jobs | elapsed: 0.3s\n [Parallel(n_jobs=1)]: Done 5 out of 5 | elapsed: 1.8s finished\n ---------------------------------\n Success! Model score = 4.080646\n (best score so far = 4.080646)\n ---------------------------------\n\n 1/1 models fit successfully.\n time: October 27, 2014 10:44 PM\n elapsed: 4 seconds.\n osprey worker exiting.\n\nYou can dump the database to JSON or CSV with ``osprey dump``.\n\nDependencies\n------------\n\n- ``python>=2.7.11``\n- ``six>=1.10.0``\n- ``pyyaml>=3.11``\n- ``numpy>=1.10.4``\n- ``scipy>=0.17.0``\n- ``scikit-learn>=0.17.0``\n- ``sqlalchemy>=1.0.10``\n- ``bokeh>=0.12.0``\n- ``matplotlib>=1.5.0``\n- ``pandas>=0.18.0``\n- ``GPy`` (optional, required for ``gp`` strategy)\n- ``hyperopt`` (optional, required for ``hyperopt_tpe`` strategy)\n- ``nose`` (optional, for testing)\n\nContributing\n------------\n\nIn case you encounter any issues with this package, please consider\nsubmitting a ticket to the `GitHub Issue\nTracker `__. We also\nwelcome any feature requests and highly encourage users to `submit pull\nrequests `__\nfor bug fixes and improvements.\n\nFor more detailed information, please refer to our\n`documentation `__.\n\nCiting\n------\n\nIf you use Osprey in your research, please cite:\n\n.. code:: bibtex\n\n @misc{osprey,\n author = {Robert T. McGibbon and\n Carlos X. Hern\u00e1ndez and\n Matthew P. Harrigan and\n Steven Kearnes and\n Mohammad M. Sultan and\n Stanislaw Jastrzebski and\n Brooke E. Husic and\n Vijay S. Pande},\n title = {Osprey 1.0.0},\n month = jun,\n year = 2016,\n doi = {10.5281/zenodo.56251},\n url = {http://dx.doi.org/10.5281/zenodo.56251}\n }\n\n.. |Build Status| image:: https://travis-ci.org/msmbuilder/osprey.svg?branch=master\n :target: https://travis-ci.org/msmbuilder/osprey\n.. |Coverage Status| image:: https://coveralls.io/repos/github/msmbuilder/osprey/badge.svg?branch=master\n :target: https://coveralls.io/github/msmbuilder/osprey?branch=master\n.. |PyPi version| image:: https://badge.fury.io/py/osprey.svg\n :target: https://pypi.python.org/pypi/osprey/\n.. |License| image:: https://img.shields.io/badge/license-ASLv2.0-red.svg?style=flat\n.. |DOI| image:: https://zenodo.org/badge/9890/msmbuilder/osprey.svg\n :target: https://zenodo.org/badge/latestdoi/9890/msmbuilder/osprey\n.. |Documentation| image:: https://img.shields.io/badge/docs-latest-blue.svg?style=flat", "description_content_type": null, "docs_url": null, "download_url": "https://pypi.python.org/pypi/osprey/", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/msmbuilder/osprey", "keywords": null, "license": "Apache Software License", "maintainer": null, "maintainer_email": null, "name": "osprey", "package_url": "https://pypi.org/project/osprey/", "platform": "Windows,Linux,Mac OS-X,Unix", "project_url": "https://pypi.org/project/osprey/", "project_urls": { "Download": "https://pypi.python.org/pypi/osprey/", "Homepage": "https://github.com/msmbuilder/osprey" }, "release_url": "https://pypi.org/project/osprey/1.1.0/", "requires_dist": null, "requires_python": null, "summary": "|Build Status| |Coverage Status| |PyPi version| [|License|]\n(http://www.apache.org/licenses/LICENSE-2.0) |DOI| [|Documentation|]\n(http://msmbuilder.org/osprey)", "version": "1.1.0" }, "last_serial": 2330469, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "ea74d266078cef8959ee19d774d0b266", "sha256": "bfc0f48579bf2963acf043e87c5683d4d23c764aa5c59ab6ec9828b404014f2d" }, "downloads": -1, "filename": "osprey-0.1.tar.gz", "has_sig": false, "md5_digest": "ea74d266078cef8959ee19d774d0b266", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 27542, "upload_time": "2014-10-26T21:51:34", "url": "https://files.pythonhosted.org/packages/15/ef/17938064e3d33be40fb6e503f005b956b25ecec35606d9c1dc3d2f07b3e0/osprey-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "a64f8faed5f88c645615b7629b1314aa", "sha256": "79c828585089046a25674c02d3455d36f51e49a039dd5d31bfb1ec18f9bbd3b9" }, "downloads": -1, "filename": "osprey-0.2.tar.gz", "has_sig": false, "md5_digest": "a64f8faed5f88c645615b7629b1314aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29563, "upload_time": "2014-10-27T04:04:45", "url": "https://files.pythonhosted.org/packages/47/af/2343d1256ffcff393b420c09d2876f02cfe1fa8186d5c62fc3d699cd696b/osprey-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "67d39467eec1fcb533825f3d644cc79a", "sha256": "9c45efcf9c5b81bf70a3ad8e3227ef18c239f1953228dc8e57ccec5d64527bbb" }, "downloads": -1, "filename": "osprey-0.3.tar.gz", "has_sig": false, "md5_digest": "67d39467eec1fcb533825f3d644cc79a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34288, "upload_time": "2014-10-30T22:24:39", "url": "https://files.pythonhosted.org/packages/91/2c/f70d143e60c6a8d19c8ea9662bd7d6dd031c22c64b185e76f2e57d70c3ae/osprey-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "76c9f4467490f80d2d5d0536c47de296", "sha256": "b4e8e3b806dc8004e45668790db7f18ab59ea29d4960973740d584e6dbcd19c9" }, "downloads": -1, "filename": "osprey-0.4.tar.gz", "has_sig": false, "md5_digest": "76c9f4467490f80d2d5d0536c47de296", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42273, "upload_time": "2014-11-14T23:46:25", "url": "https://files.pythonhosted.org/packages/b3/19/82815cf91dad186ed8eddf3d33b01f61caf731beb05bbf588fba98eeacc2/osprey-0.4.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "c32e2329809fbedde8d423f9c2a2cf41", "sha256": "308dff91c856d1cb359c95639417792d7a8a5e2064162cda4870876ffb765bfe" }, "downloads": -1, "filename": "osprey-1.0.0-py2-none-any.whl", "has_sig": false, "md5_digest": "c32e2329809fbedde8d423f9c2a2cf41", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 50865, "upload_time": "2016-07-30T17:55:49", "url": "https://files.pythonhosted.org/packages/fb/50/9346f9711c6dfbe30c37b51a8618ec6fac18657682e6d9b8cc30c1e8bbea/osprey-1.0.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a2b4dd457f139264c9dc26aa87def216", "sha256": "e81f5aa5f83a952458b01d7c8c5e46f1120b1296ea7297820635281fe69d9573" }, "downloads": -1, "filename": "osprey-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "a2b4dd457f139264c9dc26aa87def216", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 50864, "upload_time": "2016-07-30T17:55:29", "url": "https://files.pythonhosted.org/packages/d6/b2/5ce18965b9b4d0b7cef569fd9ad31d403c7ee7472f08c2fab627d493a6a7/osprey-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "20206becf1b23e25929df2e04593a786", "sha256": "5086d471702a79163ae0dc514c2c544c3810895eca73a42872b7f9314d4ce847" }, "downloads": -1, "filename": "osprey-1.0.0.tar.gz", "has_sig": false, "md5_digest": "20206becf1b23e25929df2e04593a786", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 37004, "upload_time": "2016-07-30T17:56:17", "url": "https://files.pythonhosted.org/packages/15/34/32f5cfc79b563b35603382b4bb2d5d6926fbd28b1183d6a27b87c1b6044c/osprey-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "04792f14dc8987df7a9de4b9001373f7", "sha256": "8fb0cd788550332a32bc929f8f70afbe4ac84872cc5542d75e8858ef4447a6ba" }, "downloads": -1, "filename": "osprey-1.1.0.tar.gz", "has_sig": false, "md5_digest": "04792f14dc8987df7a9de4b9001373f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39752, "upload_time": "2016-09-08T01:18:30", "url": "https://files.pythonhosted.org/packages/63/ac/f472540e6eae60a6086829e5b17ea255227def0ccd17e015be39b49d307d/osprey-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "04792f14dc8987df7a9de4b9001373f7", "sha256": "8fb0cd788550332a32bc929f8f70afbe4ac84872cc5542d75e8858ef4447a6ba" }, "downloads": -1, "filename": "osprey-1.1.0.tar.gz", "has_sig": false, "md5_digest": "04792f14dc8987df7a9de4b9001373f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39752, "upload_time": "2016-09-08T01:18:30", "url": "https://files.pythonhosted.org/packages/63/ac/f472540e6eae60a6086829e5b17ea255227def0ccd17e015be39b49d307d/osprey-1.1.0.tar.gz" } ] }