# GPflux
<!-- TODO: -->
<!-- [](https://badge.fury.io/py/gpflux) -->
<!-- [](https://codecov.io/gh/secondmind-labs/GPflux) -->
[](https://github.com/secondmind-labs/GPflux/actions/workflows/quality-check.yaml)
[](https://github.com/secondmind-labs/GPflux/actions/workflows/deploy.yaml)
[Documentation](https://secondmind-labs.github.io/GPflux/) |
[Tutorials](https://secondmind-labs.github.io/GPflux/tutorials.html) |
[API reference](https://secondmind-labs.github.io/GPflux/autoapi/gpflux/index.html) |
[Slack](https://join.slack.com/t/secondmind-labs/shared_invite/zt-ph07nuie-gMlkle__tjvXBay4FNSLkw)
## What does GPflux do?
GPflux is a toolbox dedicated to Deep Gaussian processes (DGP), the hierarchical extension of Gaussian processes (GP).
GPflux uses the mathematical building blocks from [GPflow](http://www.gpflow.org/) and marries these with the powerful layered deep learning API provided by [Keras](https://www.tensorflow.org/api_docs/python/tf/keras).
This combination leads to a framework that can be used for:
- researching new (deep) Gaussian process models, and
- building, training, evaluating and deploying (deep) Gaussian processes in a modern way — making use of the tools developed by the deep learning community.
## Getting started
In the [Documentation](https://secondmind-labs.github.io/GPflux/), we have multiple [Tutorials](https://secondmind-labs.github.io/GPflux/tutorials.html) showing the basic functionality of the toolbox, a [benchmark implementation](https://secondmind-labs.github.io/GPflux/notebooks/benchmarks.html) and a comprehensive [API reference](https://secondmind-labs.github.io/GPflux/autoapi/gpflux/index.html).
## Install GPflux
This project is assuming you are using `python3`.
#### For users
To install the latest (stable) release of the toolbox from [PyPI](https://pypi.org/), use `pip`:
```bash
$ pip install gpflux
```
#### For contributors
To install this project in editable mode, run the commands below from the root directory of the `GPflux` repository.
```bash
make install
```
Check that the installation was successful by running the tests:
```bash
make test
```
You can have a peek at the [Makefile](Makefile) for the commands.
## The Secondmind Labs Community
### Getting help
**Bugs, feature requests, pain points, annoying design quirks, etc:**
Please use [GitHub issues](https://github.com/secondmind-labs/GPflux/issues/) to flag up bugs/issues/pain points, suggest new features, and discuss anything else related to the use of GPflux that in some sense involves changing the GPflux code itself. We positively welcome comments or concerns about usability, and suggestions for changes at any level of design. We aim to respond to issues promptly, but if you believe we may have forgotten about an issue, please feel free to add another comment to remind us.
### Slack workspace
We have a public [Secondmind Labs slack workspace](https://secondmind-labs.slack.com/). Please use this [invite link](https://join.slack.com/t/secondmind-labs/shared_invite/zt-ph07nuie-gMlkle__tjvXBay4FNSLkw) and join the #gpflux channel, whether you'd just like to ask short informal questions or want to be involved in the discussion and future development of GPflux.
### Contributing
All constructive input is very much welcome. For detailed information, see the [guidelines for contributors](CONTRIBUTING.md).
### Maintainers
GPflux was originally created at [Secondmind Labs](https://www.secondmind.ai/labs/) and is now actively maintained by (in alphabetical order)
[Vincent Dutordoir](https://vdutor.github.io/) and
[ST John](https://github.com/st--/).
**We are grateful to [all contributors](CONTRIBUTORS.md) who have helped shape GPflux.**
GPflux is an open source project. If you have relevant skills and are interested in contributing then please do contact us (see ["The Secondmind Labs Community" section](#the-secondmind-labs-community) above).
We are very grateful to our Secondmind Labs colleagues, maintainers of [GPflow](https://github.com/GPflow/GPflow), [Trieste](https://github.com/secondmind-labs/trieste) and [Bellman](https://github.com/Bellman-devs/bellman), for their help with creating contributing guidelines, instructions for users and open-sourcing in general.
## Citing GPflux
To cite GPflux, please reference our [arXiv paper](https://arxiv.org/abs/2104.05674) where we review the framework and describe the design. Sample Bibtex is given below:
```
@article{dutordoir2021gpflux,
author = {Dutordoir, Vincent and Salimbeni, Hugh and Hambro, Eric and McLeod, John and
Leibfried, Felix and Artemev, Artem and van der Wilk, Mark and Deisenroth, Marc P.
and Hensman, James and John, ST},
title = {GPflux: A library for Deep Gaussian Processes},
year = {2021},
journal = {arXiv:2104.05674},
url = {https://arxiv.org/abs/2104.05674}
}
```
## License
[Apache License 2.0](LICENSE)
Raw data
{
"_id": null,
"home_page": "",
"name": "gpflux",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Deep-Gaussian-processes",
"author": "Secondmind Labs",
"author_email": "gpflux@secondmind.ai",
"download_url": "https://files.pythonhosted.org/packages/0e/a9/83d03659403e477c2ab26a1a00d8cd2afaced0eb9fd132abe741db727a34/gpflux-0.4.3.tar.gz",
"platform": null,
"description": "# GPflux\n\n<!-- TODO: -->\n<!-- [](https://badge.fury.io/py/gpflux) -->\n<!-- [](https://codecov.io/gh/secondmind-labs/GPflux) -->\n[](https://github.com/secondmind-labs/GPflux/actions/workflows/quality-check.yaml)\n[](https://github.com/secondmind-labs/GPflux/actions/workflows/deploy.yaml)\n\n[Documentation](https://secondmind-labs.github.io/GPflux/) |\n[Tutorials](https://secondmind-labs.github.io/GPflux/tutorials.html) |\n[API reference](https://secondmind-labs.github.io/GPflux/autoapi/gpflux/index.html) |\n[Slack](https://join.slack.com/t/secondmind-labs/shared_invite/zt-ph07nuie-gMlkle__tjvXBay4FNSLkw)\n\n## What does GPflux do?\n\nGPflux is a toolbox dedicated to Deep Gaussian processes (DGP), the hierarchical extension of Gaussian processes (GP).\n\nGPflux uses the mathematical building blocks from [GPflow](http://www.gpflow.org/) and marries these with the powerful layered deep learning API provided by [Keras](https://www.tensorflow.org/api_docs/python/tf/keras).\nThis combination leads to a framework that can be used for:\n\n- researching new (deep) Gaussian process models, and\n- building, training, evaluating and deploying (deep) Gaussian processes in a modern way \u2014 making use of the tools developed by the deep learning community.\n\n\n## Getting started\n\nIn the [Documentation](https://secondmind-labs.github.io/GPflux/), we have multiple [Tutorials](https://secondmind-labs.github.io/GPflux/tutorials.html) showing the basic functionality of the toolbox, a [benchmark implementation](https://secondmind-labs.github.io/GPflux/notebooks/benchmarks.html) and a comprehensive [API reference](https://secondmind-labs.github.io/GPflux/autoapi/gpflux/index.html).\n\n\n## Install GPflux\n\nThis project is assuming you are using `python3`.\n\n#### For users\n\nTo install the latest (stable) release of the toolbox from [PyPI](https://pypi.org/), use `pip`:\n```bash\n$ pip install gpflux\n```\n#### For contributors\n\nTo install this project in editable mode, run the commands below from the root directory of the `GPflux` repository.\n```bash\nmake install\n```\nCheck that the installation was successful by running the tests:\n```bash\nmake test\n```\nYou can have a peek at the [Makefile](Makefile) for the commands.\n\n\n## The Secondmind Labs Community\n\n### Getting help\n\n**Bugs, feature requests, pain points, annoying design quirks, etc:**\nPlease use [GitHub issues](https://github.com/secondmind-labs/GPflux/issues/) to flag up bugs/issues/pain points, suggest new features, and discuss anything else related to the use of GPflux that in some sense involves changing the GPflux code itself. We positively welcome comments or concerns about usability, and suggestions for changes at any level of design. We aim to respond to issues promptly, but if you believe we may have forgotten about an issue, please feel free to add another comment to remind us.\n\n### Slack workspace\n\nWe have a public [Secondmind Labs slack workspace](https://secondmind-labs.slack.com/). Please use this [invite link](https://join.slack.com/t/secondmind-labs/shared_invite/zt-ph07nuie-gMlkle__tjvXBay4FNSLkw) and join the #gpflux channel, whether you'd just like to ask short informal questions or want to be involved in the discussion and future development of GPflux.\n\n\n### Contributing\n\nAll constructive input is very much welcome. For detailed information, see the [guidelines for contributors](CONTRIBUTING.md).\n\n\n### Maintainers\n\nGPflux was originally created at [Secondmind Labs](https://www.secondmind.ai/labs/) and is now actively maintained by (in alphabetical order)\n[Vincent Dutordoir](https://vdutor.github.io/) and\n[ST John](https://github.com/st--/).\n**We are grateful to [all contributors](CONTRIBUTORS.md) who have helped shape GPflux.**\n\nGPflux is an open source project. If you have relevant skills and are interested in contributing then please do contact us (see [\"The Secondmind Labs Community\" section](#the-secondmind-labs-community) above).\n\nWe are very grateful to our Secondmind Labs colleagues, maintainers of [GPflow](https://github.com/GPflow/GPflow), [Trieste](https://github.com/secondmind-labs/trieste) and [Bellman](https://github.com/Bellman-devs/bellman), for their help with creating contributing guidelines, instructions for users and open-sourcing in general.\n\n\n## Citing GPflux\n\nTo cite GPflux, please reference our [arXiv paper](https://arxiv.org/abs/2104.05674) where we review the framework and describe the design. Sample Bibtex is given below:\n\n```\n@article{dutordoir2021gpflux,\n author = {Dutordoir, Vincent and Salimbeni, Hugh and Hambro, Eric and McLeod, John and\n Leibfried, Felix and Artemev, Artem and van der Wilk, Mark and Deisenroth, Marc P.\n and Hensman, James and John, ST},\n title = {GPflux: A library for Deep Gaussian Processes},\n year = {2021},\n journal = {arXiv:2104.05674},\n url = {https://arxiv.org/abs/2104.05674}\n}\n```\n\n\n## License\n\n[Apache License 2.0](LICENSE)\n\n\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "GPflux: Deep GP library",
"version": "0.4.3",
"project_urls": {
"Documentation": "https://secondmind-labs.github.io/GPflux/",
"Source on GitHub": "https://github.com/secondmind-labs/GPflux"
},
"split_keywords": [
"deep-gaussian-processes"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5ee7ea48f36aa3f98aaffb437f38985438ce607032a9b708778ecef47884ff3b",
"md5": "22c4382a9c776565892f33f0f4205eb6",
"sha256": "efa470294a3a0dc13b08ce280626822b2f48ea0564522b49a8d591dc2977ad89"
},
"downloads": -1,
"filename": "gpflux-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "22c4382a9c776565892f33f0f4205eb6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 74843,
"upload_time": "2024-01-08T14:44:28",
"upload_time_iso_8601": "2024-01-08T14:44:28.764095Z",
"url": "https://files.pythonhosted.org/packages/5e/e7/ea48f36aa3f98aaffb437f38985438ce607032a9b708778ecef47884ff3b/gpflux-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0ea983d03659403e477c2ab26a1a00d8cd2afaced0eb9fd132abe741db727a34",
"md5": "cdd29e0e962daa77521513893184aa29",
"sha256": "b455d28eda0d6803dbfc2b1545724f44334b352afc7d6986bae6e3312b738edf"
},
"downloads": -1,
"filename": "gpflux-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "cdd29e0e962daa77521513893184aa29",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 49489,
"upload_time": "2024-01-08T14:44:30",
"upload_time_iso_8601": "2024-01-08T14:44:30.603284Z",
"url": "https://files.pythonhosted.org/packages/0e/a9/83d03659403e477c2ab26a1a00d8cd2afaced0eb9fd132abe741db727a34/gpflux-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-08 14:44:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "secondmind-labs",
"github_project": "GPflux",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "gpflux"
}
JSON
