# Bayesian AB Test Report Builder
![Build Status](https://github.com/bakermoran/BayesABTest/workflows/Build%20Status/badge.svg?branch=main)
[![PyPI version](https://badge.fury.io/py/BayesABTest.svg)](https://badge.fury.io/py/BayesABTest)
> **Baker Moran**
This allows AB testers to create a standard report for test results with python. Handles multiple variant tests, with a variety of prior function types. This is meant to be an abstraction from the nitty gritty of the details of Bayesian statistics. That said, some knowledge about which prior function to use etc. will be helpful for the user.
### Example Output for a conversion rate test
![alt text](docs/package_documentation/img/one_var_continuous.png "Conversion Rate Example")
## Installation
- Install via pip (or specify pip3)
```bash
pip install BayesABTest
```
OR
- Download files from [PyPi](https://pypi.org/project/BayesABTest/#files) and install
## Package Functions and Classes
### [ab_test_model](docs/package_documentation/ab_test_model.md)
Class implementing out of the box AB testing functionality. Simple, easy to use AB testing with many different prior function types, all in one clean interface.
### [ab_test_dist_explorer](docs/package_documentation/ab_test_dist_explorer.md)
Functions allowing a user to explore different distributions with simple to user interface. Allows a user to visually learn about bayesian statistics, and inform proper prior function choice when doing Bayesian AB testing.
## Appendix
### Learning
For a documentation explaining and motivating the use of Bayesian statistics to evaluate A/B tests, see [documentation](docs/besyian_ab_testing/Bayesian_AB_Testing_explainer.md)
### Acknowledgements
There is a lot of documentation out there about a Bayesian framework of A/B testing. Some of the specific articles are listed below. Most of the work I came across was written in R, and I set out to create a Python implementation. The visuals were inspired by a standard template we use at Root, first written by <https://github.com/zachurchill-root>.
Articles Reference:
- <https://www.countbayesie.com/blog/2015/4/25/bayesian-ab-testing>
- <https://medium.com/convoy-tech/the-power-of-bayesian-a-b-testing-f859d2219d5>
- <https://cdn2.hubspot.net/hubfs/310840/VWO_SmartStats_technical_whitepaper.pdf>
### Version History
- `0.1.0-prealpha` - _12/02/2019_
- `1.0.0-alpha` - _12/27/2019_
- `1.0.1-alpha` - _01/02/2020_
- `1.0.2-alpha` - _06/17/2020_
- `1.0.3-alpha` - _06/17/2020_
- `1.0.4-alpha` - _06/22/2020_
- `1.0.5-alpha` - _06/22/2020_
- `1.0.6-alpha` - _06/22/2020_
- `1.0.7-alpha` - _07/09/2021_
- `1.0.8-alpha` - _03/29/2022_
- `1.0.9-alpha` - _03/29/2022_
Raw data
{
"_id": null,
"home_page": "https://github.com/bakermoran/BayesABTest",
"name": "BayesABTest",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "AB Test, Bayes, Bayesian Statistics",
"author": "Baker Moran",
"author_email": "bamoran99@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/99/dc/b2226b17a48d086a7ea531dfac70f5c3219d90a7809175a1512366257b32/BayesABTest-1.0.9.tar.gz",
"platform": null,
"description": "# Bayesian AB Test Report Builder\n\n![Build Status](https://github.com/bakermoran/BayesABTest/workflows/Build%20Status/badge.svg?branch=main)\n[![PyPI version](https://badge.fury.io/py/BayesABTest.svg)](https://badge.fury.io/py/BayesABTest)\n\n> **Baker Moran**\n\nThis allows AB testers to create a standard report for test results with python. Handles multiple variant tests, with a variety of prior function types. This is meant to be an abstraction from the nitty gritty of the details of Bayesian statistics. That said, some knowledge about which prior function to use etc. will be helpful for the user.\n\n### Example Output for a conversion rate test\n\n![alt text](docs/package_documentation/img/one_var_continuous.png \"Conversion Rate Example\")\n\n## Installation\n\n- Install via pip (or specify pip3)\n\n ```bash\n pip install BayesABTest\n ```\n\n OR\n\n- Download files from [PyPi](https://pypi.org/project/BayesABTest/#files) and install\n\n## Package Functions and Classes\n\n### [ab_test_model](docs/package_documentation/ab_test_model.md)\n\nClass implementing out of the box AB testing functionality. Simple, easy to use AB testing with many different prior function types, all in one clean interface.\n\n### [ab_test_dist_explorer](docs/package_documentation/ab_test_dist_explorer.md)\n\nFunctions allowing a user to explore different distributions with simple to user interface. Allows a user to visually learn about bayesian statistics, and inform proper prior function choice when doing Bayesian AB testing.\n\n## Appendix\n\n### Learning\n\nFor a documentation explaining and motivating the use of Bayesian statistics to evaluate A/B tests, see [documentation](docs/besyian_ab_testing/Bayesian_AB_Testing_explainer.md)\n\n### Acknowledgements\n\nThere is a lot of documentation out there about a Bayesian framework of A/B testing. Some of the specific articles are listed below. Most of the work I came across was written in R, and I set out to create a Python implementation. The visuals were inspired by a standard template we use at Root, first written by <https://github.com/zachurchill-root>.\n\nArticles Reference:\n\n- <https://www.countbayesie.com/blog/2015/4/25/bayesian-ab-testing>\n- <https://medium.com/convoy-tech/the-power-of-bayesian-a-b-testing-f859d2219d5>\n- <https://cdn2.hubspot.net/hubfs/310840/VWO_SmartStats_technical_whitepaper.pdf>\n\n### Version History\n\n- `0.1.0-prealpha` - _12/02/2019_\n- `1.0.0-alpha` - _12/27/2019_\n- `1.0.1-alpha` - _01/02/2020_\n- `1.0.2-alpha` - _06/17/2020_\n- `1.0.3-alpha` - _06/17/2020_\n- `1.0.4-alpha` - _06/22/2020_\n- `1.0.5-alpha` - _06/22/2020_\n- `1.0.6-alpha` - _06/22/2020_\n- `1.0.7-alpha` - _07/09/2021_\n- `1.0.8-alpha` - _03/29/2022_\n- `1.0.9-alpha` - _03/29/2022_\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A package for running AB tests in a Bayesian framework.",
"version": "1.0.9",
"project_urls": {
"Download": "https://github.com/bakermoran/BayesABTest/archive/v1.0.9-alpha.tar.gz",
"Homepage": "https://github.com/bakermoran/BayesABTest"
},
"split_keywords": [
"ab test",
" bayes",
" bayesian statistics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1e3e45587b6fdcec6880140e8d02a945ef7553297543bdfa590b65bfeb8b7d30",
"md5": "58683435026a8a999804e80da9b30437",
"sha256": "83946b123f343e30503cb8b3475932a6b1cee7cb10bd7ca934117a8053c4b55b"
},
"downloads": -1,
"filename": "BayesABTest-1.0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "58683435026a8a999804e80da9b30437",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18557,
"upload_time": "2024-04-06T00:41:10",
"upload_time_iso_8601": "2024-04-06T00:41:10.266078Z",
"url": "https://files.pythonhosted.org/packages/1e/3e/45587b6fdcec6880140e8d02a945ef7553297543bdfa590b65bfeb8b7d30/BayesABTest-1.0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "99dcb2226b17a48d086a7ea531dfac70f5c3219d90a7809175a1512366257b32",
"md5": "8403413d94924c79c8d224fd61a16bd8",
"sha256": "66402a7cf70ac9877eea78fb8afdb3f3548ddaf3d7adb9b0ee8e11c686c1d136"
},
"downloads": -1,
"filename": "BayesABTest-1.0.9.tar.gz",
"has_sig": false,
"md5_digest": "8403413d94924c79c8d224fd61a16bd8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 15742,
"upload_time": "2024-04-06T00:41:11",
"upload_time_iso_8601": "2024-04-06T00:41:11.345090Z",
"url": "https://files.pythonhosted.org/packages/99/dc/b2226b17a48d086a7ea531dfac70f5c3219d90a7809175a1512366257b32/BayesABTest-1.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-06 00:41:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bakermoran",
"github_project": "BayesABTest",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "bayesabtest"
}