{ "info": { "author": "Johannes Buchner", "author_email": "johannes.buchner.acad@gmx.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Natural Language :: English", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "=========\nUltraNest\n=========\n\nFit and compare complex models reliably and rapidly with advanced sampling techniques.\n\n.. image:: https://img.shields.io/pypi/v/ultranest.svg\n :target: https://pypi.python.org/pypi/ultranest\n\n.. image:: https://img.shields.io/travis/JohannesBuchner/ultranest.svg\n :target: https://travis-ci.org/JohannesBuchner/ultranest\n\n.. image:: https://readthedocs.org/projects/ultranest/badge/?version=latest\n :target: https://ultranest.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\nCorrectness. Speed. Ease of use. \ud83e\udd94\n\nAbout\n-----\n\nWhen scientific models are compared to data, two tasks are important:\n1) contraining the model parameters and 2) comparing the model to other models.\nDifferent techniques have been developed to explore model parameter spaces.\nThis package implements a Monte Carlo technique called nested sampling.\n\n**Nested sampling** allows Bayesian inference on arbitrary user-defined likelihoods.\nIn particular, posterior probability distributions on model parameters\nare constructed, and the marginal likelihood (\"evidence\") Z is computed.\nThe former can be used to describe the parameter constraints of the data,\nthe latter can be used for model comparison (via `Bayes factors`) \nas a measure of the prediction parsimony of a model.\n\nIn the last decade, multiple variants of nested sampling have been \ndeveloped. These differ in how nested sampling finds better and\nbetter fits while respecting the priors \n(constrained likelihood prior sampling techniques), and whether it is \nallowed to go back to worse fits and explore the parameter space more.\n\nThis package develops novel, advanced techniques for both (See How it works).\nThey are especially remarkable for being free of tuning parameters \nand theoretically justified. Beyond that, UltraNest has support for \nBig Data sets and high-performance computing applications.\n\nUltraNest is intended for fitting complex physical models with slow\nlikelihood evaluations, with one to hundreds of parameters.\nUltraNest intends to replace heuristic methods like multi-ellipsoid\nnested sampling and dynamic nested sampling with more rigorous methods.\nUltraNest also attempts to provide feature parity compared to other packages\n(such as MultiNest).\n\nHowever, UltraNest is still in beta. You can help by\ntesting it and reporting issues. Code contributions for fixes and \nnew features are also welcome. See :contributing:.\n\nFeatures\n---------\n\n* Pythonic\n\n * pip installable\n * Easy to program for: Sanity checks with meaningful errors\n * Can control the run programmatically and check status\n * Reasonable defaults, but customizable\n * Thoroughly tested with many unit and integration tests\n\n* Robust exploration easily handles:\n\n * Degenerate parameter spaces such as bananas or tight correlations\n * Multiple modes/solutions in the parameter space\n * Robust, parameter-free MLFriends algorithm \n (metric learning RadFriends, Buchner+14,+19), with new improvements\n (region follows new live points, clustering improves metric iteratively).\n * High-dimensional problems with slice sampling (or ellipsoidal sampling, FlatNUTS, etc.),\n inside region.\n * Wrapped/circular parameters, derived parameters\n * Fast-slow parameters\n\n* strategic nested sampling\n\n * can vary (increase) number of live points (akin to dynamic nested sampling, but with different targets)\n * can sample clusters optimally (e.g., at least 50 points per cluster/mode/solution)\n * can target minimizing parameter estimation uncertainties\n * can target a desired evidence uncertainty threshold\n * can target a desired number of effective samples\n * or any combination of the above\n * Robust ln(Z) uncertainties by bootstrapping live points.\n\n* Lightweight and fast\n\n * some functions implemented in Cython\n * vectorized likelihood function calls\n * Use multiple cores, fully parallelizable from laptops to clusters\n * MPI support\n\n* Advanced visualisation and crash recovery:\n\n * Checkpointing and resuming, even with different number of live points\n * Run-time visualisations and exploration information\n * Corner plots, run and parameter exploration diagnostic plots\n\n\nTODO\n^^^^\n\n* Documentation:\n\n * Example power law fit\n * Example spectral line fit, white and GP\n * Example low-d Bayesian GP emulator as pre-filter to model evaluation\n * Example verifying integration with VB+IS\n\nUsage\n^^^^^\n\nRead the full documentation at:\n\nhttps://johannesbuchner.github.io/UltraNest/\n\n\nLicence\n^^^^^^^\n\nGPLv3 (see LICENCE file). If you require another license, please contact me.\n\nIcon made by `Freepik `_.\n\n\n==============\nRelease Notes\n==============\n\n2.0.0 (2019-10-03)\n------------------\n\n* First release.\n\n1.0.0 (2014)\n------------------\n\n* A simpler version referenced in Buchner et al. (2014),\n combining RadFriends with an optional Metropolis-Hastings proposal.\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/JohannesBuchner/ultranest", "keywords": "ultranest", "license": "GNU General Public License v3", "maintainer": "", "maintainer_email": "", "name": "ultranest", "package_url": "https://pypi.org/project/ultranest/", "platform": "", "project_url": "https://pypi.org/project/ultranest/", "project_urls": { "Homepage": "https://github.com/JohannesBuchner/ultranest" }, "release_url": "https://pypi.org/project/ultranest/2.0.0/", "requires_dist": null, "requires_python": "", "summary": "Fit and compare complex models reliably and rapidly. Advanced Nested Sampling.", "version": "2.0.0" }, "last_serial": 5970650, "releases": { "2.0.0": [ { "comment_text": "", "digests": { "md5": "94dfed68d1b0be4f07c38bfdbb3599d6", "sha256": "ffa10ad7f066d1263ff6bdfaa170cc0370a2d6d61415c5ab35bd48555e77bff5" }, "downloads": -1, "filename": "ultranest-2.0.0-py3.6-linux-x86_64.egg", "has_sig": true, "md5_digest": "94dfed68d1b0be4f07c38bfdbb3599d6", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 681008, "upload_time": "2019-10-14T09:50:41", "url": "https://files.pythonhosted.org/packages/4b/e6/136d316c39d9fedac37231b9fc5e1f97ea30115a593b31e4f8ea62da57d6/ultranest-2.0.0-py3.6-linux-x86_64.egg" }, { "comment_text": "", "digests": { "md5": "ae80ad7b892c9776837ac151811295aa", "sha256": "aaad99491fe306bc30b946d6b0946ea39a27948ddc029356da6a81dd405ef034" }, "downloads": -1, "filename": "ultranest-2.0.0.tar.gz", "has_sig": true, "md5_digest": "ae80ad7b892c9776837ac151811295aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20769318, "upload_time": "2019-10-14T09:50:49", "url": "https://files.pythonhosted.org/packages/43/5f/ee5ab50d1daa9450927642e856ae0972be3b6d71d4b73d290d25646cd029/ultranest-2.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "94dfed68d1b0be4f07c38bfdbb3599d6", "sha256": "ffa10ad7f066d1263ff6bdfaa170cc0370a2d6d61415c5ab35bd48555e77bff5" }, "downloads": -1, "filename": "ultranest-2.0.0-py3.6-linux-x86_64.egg", "has_sig": true, "md5_digest": "94dfed68d1b0be4f07c38bfdbb3599d6", "packagetype": "bdist_egg", "python_version": "3.6", "requires_python": null, "size": 681008, "upload_time": "2019-10-14T09:50:41", "url": "https://files.pythonhosted.org/packages/4b/e6/136d316c39d9fedac37231b9fc5e1f97ea30115a593b31e4f8ea62da57d6/ultranest-2.0.0-py3.6-linux-x86_64.egg" }, { "comment_text": "", "digests": { "md5": "ae80ad7b892c9776837ac151811295aa", "sha256": "aaad99491fe306bc30b946d6b0946ea39a27948ddc029356da6a81dd405ef034" }, "downloads": -1, "filename": "ultranest-2.0.0.tar.gz", "has_sig": true, "md5_digest": "ae80ad7b892c9776837ac151811295aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20769318, "upload_time": "2019-10-14T09:50:49", "url": "https://files.pythonhosted.org/packages/43/5f/ee5ab50d1daa9450927642e856ae0972be3b6d71d4b73d290d25646cd029/ultranest-2.0.0.tar.gz" } ] }