{ "info": { "author": "Antony Lewis", "author_email": "", "bugtrack_url": null, "classifiers": [ "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": "===================\nGetDist\n===================\n:GetDist: MCMC sample analysis, plotting and GUI\n:Author: Antony Lewis\n:Homepage: https://github.com/cmbant/getdist\n\n.. image:: https://secure.travis-ci.org/cmbant/getdist.png?branch=master\n :target: https://secure.travis-ci.org/cmbant/getdist\n.. image:: https://img.shields.io/pypi/v/GetDist.svg?style=flat\n :target: https://pypi.python.org/pypi/GetDist/\n.. image:: https://readthedocs.org/projects/getdist/badge/?version=latest\n :target: https://getdist.readthedocs.org/en/latest\n.. image:: https://mybinder.org/badge.svg\n :target: https://mybinder.org/v2/gh/cmbant/getdist/master?filepath=docs%2Fplot_gallery.ipynb\n\nDescription\n============\n\nGetDist is a Python package for analysing Monte Carlo samples, including correlated samples\nfrom Markov Chain Monte Carlo (MCMC).\n\n* **Point and click GUI** - select chain files, view plots, marginalized constraints, LaTeX tables and more\n* **Plotting library** - make custom publication-ready 1D, 2D, 3D-scatter, triangle and other plots\n* **Named parameters** - simple handling of many parameters using parameter names, including LaTeX labels and prior bounds\n* **Optimized Kernel Density Estimation** - automated optimal bandwidth choice for 1D and 2D densities (Botev et al. Improved Sheather-Jones method), with boundary and bias correction\n* **Convergence diagnostics** - including correlation length and diagonalized Gelman-Rubin statistics\n* **LaTeX tables** for marginalized 1D constraints\n\nSee the `Plot Gallery and tutorial `_\n(`run online `_)\nand `GetDist Documentation `_.\n\n\nGetting Started\n================\n\nInstall getdist using pip::\n\n $ sudo pip install getdist\n\nor from source files using::\n\n $ sudo python setup.py install\n\nYou can test if things are working using the unit test by running::\n\n $ python setup.py test\n\nCheck the dependencies listed in the next section are installed. You can then use the getdist module from your scripts, or\nuse the GUI program GetDistGUI.py.\n\n\nDependencies\n=============\n* Python 2.7+ or 3.4+\n* matplotlib\n* scipy\n* PySide (optional, only needed for GUI)\n* Working LaTeX installation (for some plotting/table functions)\n\nPython distributions like Anaconda have most of what you need (except for LaTeX). To install binary backages on Linux-like systems\ninstall pacakages *py-matplotlib, py-scipy, py-pyside, texlive-latex-extra, texlive-fonts-recommended, dvipng*.\nFor example on a Mac using Python 2.7 from `MacPorts `_::\n\n sudo port install python27\n sudo port select --set python python27\n sudo port install py-matplotlib\n sudo port install py-scipy\n sudo port install py-pyside\n sudo port install texlive-latex-extra\n sudo port install texlive-fonts-recommended\n sudo port install dvipng\n\nIf you don't want to install dependencies locally, you can also use a pre-configured `virtual environment `_.\n\nAlgorithm details\n==================\n\nDetails of kernel density estimation (KDE) algorithms and references are give in the\n`GetDist Notes `_.\n\nSamples file format\n===================\n\nThe GetDist GUI (and getdist.loadMCSamples function) read parameter sample/chain files in plain text format.\nIn general there are a set of plain text files of the form::\n\n xxx_1.txt\n xxx_2.txt\n ...\n xxx.paramnames\n xxx.ranges\n\nwhere \"xxx\" is some root file name.\n\nThe .txt files are separate chain files (there can also be just one xxx.txt file). Each row of each sample .txt file is in the format\n\n *weight like param1 param2 param3* ...\n\nThe *weight* gives the number of samples (or importance weight) with these parameters. *like* gives -log(likelihood), and *param1, param2...* are the values of the parameters at the sample point. The first two columns can be 1 and 0 if they are not known or used.\n\nThe .paramnames file lists the names of the parameters, one per line, optionally followed by a LaTeX label. Names cannot include spaces, and if they end in \"*\" they are interpreted as derived (rather than MCMC) parameters, e.g.::\n\n x1 x_1\n y1 y_1\n x2 x_2\n xy* x_1+y_1\n\nThe .ranges file gives hard bounds for the parameters, e.g.::\n\n x1 -5 5\n x2 0 N\n\nNote that not all parameters need to be specified, and \"N\" can be used to denote that a particular upper or lower limit is unbounded. The ranges are used to determine densities and plot bounds if there are samples near the boundary; if there are no samples anywhere near the boundary the ranges have no affect on plot bounds, which are chosen appropriately for the range of the samples.\n\nThere can also optionally be a .properties.ini file, which can specify *burn_removed=T* to ensure no burn in is removed, or *ignore_rows=x\" to ignore the first\nfraction *x* of the file rows (or if *x > 1*, the specified number of rows).\n\nLoading samples\n===================\n\nTo load an MCSamples object from text files do::\n\n\t from getdist import loadMCSamples\n\t samples = loadMCSamples('/path/to/xxx', settings={'ignore_rows':0.3})\n\nHere *settings* gives optional parameter settings for the analysis. *ignore_rows* is useful for MCMC chains where you want to\ndiscard some fraction from the start of each chain as burn in (use a number >1 to discard a fixed number of sample lines rather than a fraction).\nThe MCSamples object can be passed to plot functions, or used to get many results. For example, to plot marginalized parameter densities\nfor parameter names *x1* and *x2*::\n\n from getdist import plots\n g = plots.getSinglePlotter()\n g.plot_2d(samples, ['x1', 'x2'])\n\nWhen you have many different chain files in the same directory,\nplotting can work directly with the root file names. For example to compare *x* and *y* constraints\nfrom two chains with root names *xxx* and *yyy*::\n\n\tfrom getdist import plots\n\tg = plots.getSinglePlotter(chain_dir='/path/to/', analysis_settings={'ignore_rows':0.3})\n\tg.plot_2d(['xxx','yyy], ['x', 'y'])\n\n\nMCSamples objects can also be constructed directly from numpy arrays in memory, see the example in the `Plot Gallery `_.\n\nGetDist script\n===================\n\nIf you have chain files on on disk, you can also quickly calculate convergence and marginalized statistics using the GetDist.py script:\n\n\tusage: GetDist.py [-h] [--ignore_rows IGNORE_ROWS] [-V] [ini_file] [chain_root]\n\n\tGetDist sample analyser\n\n\tpositional arguments:\n\t *ini_file* .ini file with analysis settings (optional, if omitted uses defaults\n\n\t *chain_root* Root name of chain to analyse (e.g. chains/test), required unless file_root specified in ini_file\n\n\toptional arguments:\n\t -h, --help show this help message and exit\n\t --ignore_rows IGNORE_ROWS\n\t set initial fraction of chains to cut as burn in\n\t (fraction of total rows, or >1 number of rows);\n\t overrides any value in ini_file if set\n\t --make_param_file MAKE_PARAM_FILE\n Produce a sample distparams.ini file that you can edit\n and use when running GetDist\n\t -V, --version show program's version number and exit\n\nwhere *ini_file* is optionally a .ini file listing *key=value* parameter option values, and chain_root is the root file name of the chains.\nFor example::\n\n GetDist.py distparams.ini chains/test_chain\n\nThis produces a set of files containing parameter means and limits (.margestats), N-D likelihood contour boundaries and best-fit sample (.likestats),\nconvergence diagnostics (.converge), parameter covariance and correlation (.covmat and .corr), and optionally various simple plotting scripts.\nIf no *ini_file* is given, default settings are used. The *ignore_rows* option allows some of the start of each chain file to be removed as burn in.\n\nTo customize settings you can run::\n\n GetDist.py --make_param_file distparams.ini\n\nto produce the setting file distparams.ini, edit it, then run with your custom settings.\n\nGetDist GUI\n===================\n\nRun the GetDistGUI.py script to run the graphical user interface. This requires PySide, but will run on Windows, Linux and Mac.\nIt allows you to open a folder of chain files, then easily select, open, plot and compare, as well as viewing standard GetDist outputs and tables.\nSee the `GUI Readme `_.\n\n\nUsing with CosmoMC and Cobaya\n=============================\n\nThis GetDist package is general, but is mainly developed for analysing chains from the `CosmoMC `_\nand `Cobaya `_ sampling programs.\nNo need to install this package separately if you have a full CosmoMC installation; the Cobaya installation will also install GetDist as a dependency.\nDetailed help is available for plotting Planck chains\nand using CosmoMC parameter grids in the `Readme `_.", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/cmbant/getdist", "keywords": "MCMC,KDE,sample,density estimation,plot", "license": "", "maintainer": "", "maintainer_email": "", "name": "GetDist", "package_url": "https://pypi.org/project/GetDist/", "platform": "", "project_url": "https://pypi.org/project/GetDist/", "project_urls": { "Homepage": "https://github.com/cmbant/getdist" }, "release_url": "https://pypi.org/project/GetDist/0.3.3/", "requires_dist": null, "requires_python": "", "summary": "GetDist Monte Carlo sample analysis, plotting and GUI", "version": "0.3.3" }, "last_serial": 5535644, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "4022cc5511c69dd25ead61fde2c204f0", "sha256": "fff03b29860a4ede215d09091371a197555112d2c435800547ab02f8b87bd9f1" }, "downloads": -1, "filename": "GetDist-0.2.0.zip", "has_sig": false, "md5_digest": "4022cc5511c69dd25ead61fde2c204f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 129020, "upload_time": "2015-05-22T16:44:18", "url": "https://files.pythonhosted.org/packages/eb/f6/1bde1d53f1c61c4e312718b6f7a273673e8f04d204294690876fb8d477ac/GetDist-0.2.0.zip" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "ec16d873f2d558595ed48e9641b314c6", "sha256": "3926472c86895346f337faf6c94c575a99601254e32da02c97da6a87033ccdcb" }, "downloads": -1, "filename": "GetDist-0.2.1.zip", "has_sig": false, "md5_digest": "ec16d873f2d558595ed48e9641b314c6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 132446, "upload_time": "2015-06-01T15:25:52", "url": "https://files.pythonhosted.org/packages/38/ca/7d957f3c559abe261b3863674f0494fdb8639d01a0b027a90ab3583070f6/GetDist-0.2.1.zip" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "c3c0071a2d82e4f314e391804a2b8d45", "sha256": "2a84c045d452da7c8bf32401f349c4bb885a9d0a8c98363f3d58f2d4bc425080" }, "downloads": -1, "filename": "GetDist-0.2.2.zip", "has_sig": false, "md5_digest": "c3c0071a2d82e4f314e391804a2b8d45", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 133240, "upload_time": "2015-06-04T09:51:57", "url": "https://files.pythonhosted.org/packages/a9/66/3ebb0f6564783fc82e7d6f47e31d3a0dd57ac77c13b4b4a27ddb23fa3412/GetDist-0.2.2.zip" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "fab175a36e57a6bb0ba9ca086d88a2fe", "sha256": "0fd71d63c7248c93b3ec9c5d5ac166bc00a418d36e1d3ca28128dbe182d61ec8" }, "downloads": -1, "filename": "GetDist-0.2.3.zip", "has_sig": false, "md5_digest": "fab175a36e57a6bb0ba9ca086d88a2fe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 134281, "upload_time": "2015-06-09T14:28:48", "url": "https://files.pythonhosted.org/packages/c7/31/219e0c251547053dc5fbd87ed2265e8a4dffc04fdf6572e554e62cf6c79c/GetDist-0.2.3.zip" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "49a52af1d32b2959a067fc9f33e357a4", "sha256": "63cc4fa3513899ac09a9d73407853c07efd5f9d2be62bde7e550447bf110e58c" }, "downloads": -1, "filename": "GetDist-0.2.4.zip", "has_sig": false, "md5_digest": "49a52af1d32b2959a067fc9f33e357a4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 158839, "upload_time": "2015-07-06T09:46:09", "url": "https://files.pythonhosted.org/packages/74/ba/6f73b7452f348fdcc43e7ff0889f5d6d8419e0aec5c7398f9af9b048f3bb/GetDist-0.2.4.zip" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "b4f534fce7ed06bdde49adad9c1b02d4", "sha256": "b05517193f9d9ba9cb655509f29e9468f920d825920a816da17860bf45099c72" }, "downloads": -1, "filename": "GetDist-0.2.5.zip", "has_sig": false, "md5_digest": "b4f534fce7ed06bdde49adad9c1b02d4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 158922, "upload_time": "2015-07-27T15:05:09", "url": "https://files.pythonhosted.org/packages/37/ea/e170a851e13ac0874cfa44ff619e53cfd52e1e8743cae785030bbf50934c/GetDist-0.2.5.zip" } ], "0.2.6": [ { "comment_text": "", "digests": { "md5": "6d5ec8aa2536a1bc8322a2a3f74f2a3b", "sha256": "5772b009fffab0a1e30dad25fa3c7da804f64ce26f659358390b2b5a85c4364f" }, "downloads": -1, "filename": "GetDist-0.2.6.zip", "has_sig": false, "md5_digest": "6d5ec8aa2536a1bc8322a2a3f74f2a3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 161781, "upload_time": "2016-11-08T09:47:58", "url": "https://files.pythonhosted.org/packages/f9/27/9a56ac3b5b6120015667aaeee042bb420e39eeecccf5570f3c6eb1efec03/GetDist-0.2.6.zip" } ], "0.2.7": [ { "comment_text": "", "digests": { "md5": "41f9cb7f9f117772b066f7b58208db68", "sha256": "9912513e306ba9fd28f1b65902174243e4a96fdcf6fac930b8de4d3515d518bb" }, "downloads": -1, "filename": "GetDist-0.2.7.zip", "has_sig": false, "md5_digest": "41f9cb7f9f117772b066f7b58208db68", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 161872, "upload_time": "2017-03-02T10:26:32", "url": "https://files.pythonhosted.org/packages/7e/38/b23a6427795d86f3f3c2a9a3e8eaa730bfd0c8e70563550e650c7638aed0/GetDist-0.2.7.zip" } ], "0.2.8": [ { "comment_text": "", "digests": { "md5": "26ac6d3dc16f90844a87a7b204365c89", "sha256": "a44e305ca43440cb6413a32cd7bab3b5e344541a2c4147eb79b9195fa717d83c" }, "downloads": -1, "filename": "GetDist-0.2.8.tar.gz", "has_sig": false, "md5_digest": "26ac6d3dc16f90844a87a7b204365c89", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 154882, "upload_time": "2017-09-27T13:54:17", "url": "https://files.pythonhosted.org/packages/e9/4d/1cf56765350a847c707776191cf2dbad05207cc8441b0227344ec1412c66/GetDist-0.2.8.tar.gz" } ], "0.2.8.1": [ { "comment_text": "", "digests": { "md5": "f8704558ac05d12a1583caaad9e5a007", "sha256": "e122527b1da2ead3e9a9c6d10b25fe8db932bfe9f48a92068f10538354805448" }, "downloads": -1, "filename": "GetDist-0.2.8.1.tar.gz", "has_sig": false, "md5_digest": "f8704558ac05d12a1583caaad9e5a007", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 159197, "upload_time": "2017-09-27T14:01:09", "url": "https://files.pythonhosted.org/packages/12/49/5d775ce226744aea30a1ae25f4d48864a5ec5de05c9392fa188128b7c3e7/GetDist-0.2.8.1.tar.gz" } ], "0.2.8.2": [ { "comment_text": "", "digests": { "md5": "782c3d234a352b163cf0f1588b633969", "sha256": "a88b5a4252fd8abca4bae2927b6299255d409ef7b48ed669db82264ac9c009a2" }, "downloads": -1, "filename": "GetDist-0.2.8.2.tar.gz", "has_sig": false, "md5_digest": "782c3d234a352b163cf0f1588b633969", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 159211, "upload_time": "2017-11-20T10:20:48", "url": "https://files.pythonhosted.org/packages/f2/e0/972f12bd9261dafb632815b71aaa53718a04ee7934ac9a65240aabab0e68/GetDist-0.2.8.2.tar.gz" } ], "0.2.8.3": [ { "comment_text": "", "digests": { "md5": "b5ed8e0005a5630d47d7a1d715117d9d", "sha256": "73da9dae4538c336dfbd2ce47c40cccbeaf6f0872d340fff850a5f9baac31e99" }, "downloads": -1, "filename": "GetDist-0.2.8.3.tar.gz", "has_sig": false, "md5_digest": "b5ed8e0005a5630d47d7a1d715117d9d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 160432, "upload_time": "2017-12-05T10:49:03", "url": "https://files.pythonhosted.org/packages/7b/4d/2fa5b555341c3d63e89298476aa04194c76b7d24c9096081972563a1f89c/GetDist-0.2.8.3.tar.gz" } ], "0.2.8.4": [ { "comment_text": "", "digests": { "md5": "f0e5e4c17c050cdbfa116f4cd34de223", "sha256": "518b6f428966febe3b8106890af8d26172ff5c83408aa642a2e1365a5baf24d8" }, "downloads": -1, "filename": "GetDist-0.2.8.4.tar.gz", "has_sig": false, "md5_digest": "f0e5e4c17c050cdbfa116f4cd34de223", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 163808, "upload_time": "2017-12-20T08:59:35", "url": "https://files.pythonhosted.org/packages/bf/61/68bde7958a853fe40fc3e49c8d62ac69c4c381871d6ad4230c602a7d4d75/GetDist-0.2.8.4.tar.gz" } ], "0.2.8.4.1": [ { "comment_text": "", "digests": { "md5": "f2eb662266d091f2845ce5c9b0391115", "sha256": "60506c432a5d67e318c99b95e4ee90ef64edca035e67dcd501d54b235e1ef879" }, "downloads": -1, "filename": "GetDist-0.2.8.4.1.tar.gz", "has_sig": false, "md5_digest": "f2eb662266d091f2845ce5c9b0391115", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 163882, "upload_time": "2017-12-20T09:15:56", "url": "https://files.pythonhosted.org/packages/81/f3/c30fc8c627e2aab21dedb03f7797fee45bc4b35aef9b196738a256a9c60a/GetDist-0.2.8.4.1.tar.gz" } ], "0.2.8.4.2": [ { "comment_text": "", "digests": { "md5": "f8509c974bd856dd54e8b9161068b0d5", "sha256": "ae06028f0f496607db165a57c2aac254d0343f51e8fb2c78240b40bcd1bc3af3" }, "downloads": -1, "filename": "GetDist-0.2.8.4.2.tar.gz", "has_sig": false, "md5_digest": "f8509c974bd856dd54e8b9161068b0d5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 163721, "upload_time": "2017-12-20T09:58:22", "url": "https://files.pythonhosted.org/packages/54/dd/a547224b4886e71eb086d0901fb59db92bf0afe5d09c55008040241d96d6/GetDist-0.2.8.4.2.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "9b97e4221a4bf94b510cedc256320ec8", "sha256": "b7d7a7829f6c6347d13673b1e55d06725058cca407eac85d234802e1480f9ef4" }, "downloads": -1, "filename": "GetDist-0.3.0.tar.gz", "has_sig": false, "md5_digest": "9b97e4221a4bf94b510cedc256320ec8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 170341, "upload_time": "2018-09-13T10:57:30", "url": "https://files.pythonhosted.org/packages/08/84/08480c81cd4d4baf64ef04d32cd8be90eab044bc45e183f8232f854b0d6b/GetDist-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "bd8408d283339238efc9f823839e5dae", "sha256": "6c0654e4fe5c157e833087cda59e1e202d8c6e74f152b06909038537e65d223c" }, "downloads": -1, "filename": "GetDist-0.3.1.tar.gz", "has_sig": false, "md5_digest": "bd8408d283339238efc9f823839e5dae", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233810, "upload_time": "2019-01-21T17:37:29", "url": "https://files.pythonhosted.org/packages/e1/29/006697a61a548d1ef73edccb4562740549ac004e8321cc26c4d3b9e11375/GetDist-0.3.1.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "46c433c4c0469c2a7ab48353541ce9fc", "sha256": "bb4d49ed4080f0f00833156b829c0d8a4840bfbd4978dcd13f30c1665df11847" }, "downloads": -1, "filename": "GetDist-0.3.2.tar.gz", "has_sig": false, "md5_digest": "46c433c4c0469c2a7ab48353541ce9fc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 231785, "upload_time": "2019-02-08T14:30:57", "url": "https://files.pythonhosted.org/packages/c8/92/06742f83358c3d26b3ba7a5ba9df72f7dbccaa07beb51c9539f484a53cde/GetDist-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "67100eb043313723ddcc132917049539", "sha256": "45f621cbe6f5ef12cfe3f977d5c8e7899260cd46d2e3bd4ea6a44babfba54dff" }, "downloads": -1, "filename": "GetDist-0.3.3.tar.gz", "has_sig": false, "md5_digest": "67100eb043313723ddcc132917049539", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233243, "upload_time": "2019-07-15T15:49:01", "url": "https://files.pythonhosted.org/packages/48/d4/31181dc2bd5cac570134db67cd53b19f6a7c033277391954848d6f90e079/GetDist-0.3.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "67100eb043313723ddcc132917049539", "sha256": "45f621cbe6f5ef12cfe3f977d5c8e7899260cd46d2e3bd4ea6a44babfba54dff" }, "downloads": -1, "filename": "GetDist-0.3.3.tar.gz", "has_sig": false, "md5_digest": "67100eb043313723ddcc132917049539", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 233243, "upload_time": "2019-07-15T15:49:01", "url": "https://files.pythonhosted.org/packages/48/d4/31181dc2bd5cac570134db67cd53b19f6a7c033277391954848d6f90e079/GetDist-0.3.3.tar.gz" } ] }