# torchtree-scipy
[![Testing](https://github.com/4ment/torchtree-scipy/actions/workflows/python-package.yml/badge.svg)](https://github.com/4ment/torchtree-scipy/actions/workflows/python-package.yml)
## About torchtree-scypi
`torchtree-scipy` is a package that enhances the functionalities of [torchtree] by incorporating additional features from [SciPy].
## Dependencies
- [SciPy]
- [torchtree]
## Installation
### Installing from source
```bash
git clone https://github.com/4ment/torchtree-scipy
pip install torchtree-scipy/
```
### Installing latest stable version
You can install `torchtree-scipy` and its dependencies from PyPI with:
```
pip install torchtree-scipy
```
## Check install
If the installation was succesfull, this command should print the version of the `torchtree_scipy` library
```bash
python -c "import torchtree_scipy;print(torchtree_scipy.__version__)"
```
## Command line arguments
The `torchtree-scipy` plugin adds these arguments to the torchtree CLI:
```bash
torchtree-cli advi --help
...
--scipy_gamma_site use the GammaSiteModel implemented with scipy
```
## Features
### Discrete gamma site model
This model implements the discretized gamma distribution to model rate heterogeity accross sites. The gradient of this model with respect to the shape parameter is calculated numerically using finite differences.
The easiest way to use this model is to use the argument `--scipy_gamma_site`. This sets the type of the site model to `torchtree_scipy.GammaSiteModel` in the JSON configuration file. The default step size is `epsilon=1.0e-6` but it can be changed manually in the JSON file.
## License
Distributed under the GPLv3 License. See [LICENSE](LICENSE) for more information.
## Acknowledgements
torchtree-scipy makes use of the following libraries and tools, which are under their own respective licenses:
- [PyTorch]
- [SciPy]
- [torchtree]
[PyTorch]: https://pytorch.org
[scipy]: https://github.com/scipy/scipy
[torchtree]: https://github.com/4ment/torchtree
Raw data
{
"_id": null,
"home_page": "https://github.com/4ment/torchtree-scipy",
"name": "torchtree-scipy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "phylogenetics,scipy,pytorch,torchtree",
"author": "Mathieu Fourment",
"author_email": "mathieu.fourment@uts.edu.au",
"download_url": "https://files.pythonhosted.org/packages/87/64/128e0c4c15d21f2c1b5371f1b38609f1a89611f1d2cd860c5754ab196a3a/torchtree-scipy-1.0.0.tar.gz",
"platform": null,
"description": "# torchtree-scipy \n[![Testing](https://github.com/4ment/torchtree-scipy/actions/workflows/python-package.yml/badge.svg)](https://github.com/4ment/torchtree-scipy/actions/workflows/python-package.yml)\n\n\n## About torchtree-scypi\n`torchtree-scipy` is a package that enhances the functionalities of [torchtree] by incorporating additional features from [SciPy].\n\n## Dependencies\n - [SciPy]\n - [torchtree]\n\n## Installation\n\n### Installing from source\n```bash\ngit clone https://github.com/4ment/torchtree-scipy\npip install torchtree-scipy/\n```\n\n### Installing latest stable version\nYou can install `torchtree-scipy` and its dependencies from PyPI with:\n```\npip install torchtree-scipy\n```\n\n## Check install\nIf the installation was succesfull, this command should print the version of the `torchtree_scipy` library\n```bash\npython -c \"import torchtree_scipy;print(torchtree_scipy.__version__)\"\n```\n\n## Command line arguments\nThe `torchtree-scipy` plugin adds these arguments to the torchtree CLI:\n\n```bash\ntorchtree-cli advi --help\n ...\n --scipy_gamma_site use the GammaSiteModel implemented with scipy\n```\n\n## Features\n### Discrete gamma site model\nThis model implements the discretized gamma distribution to model rate heterogeity accross sites. The gradient of this model with respect to the shape parameter is calculated numerically using finite differences.\nThe easiest way to use this model is to use the argument `--scipy_gamma_site`. This sets the type of the site model to `torchtree_scipy.GammaSiteModel` in the JSON configuration file. The default step size is `epsilon=1.0e-6` but it can be changed manually in the JSON file.\n\n## License\n\nDistributed under the GPLv3 License. See [LICENSE](LICENSE) for more information.\n\n## Acknowledgements\n\ntorchtree-scipy makes use of the following libraries and tools, which are under their own respective licenses:\n\n - [PyTorch]\n - [SciPy]\n - [torchtree]\n\n[PyTorch]: https://pytorch.org\n[scipy]: https://github.com/scipy/scipy\n[torchtree]: https://github.com/4ment/torchtree\n",
"bugtrack_url": null,
"license": "GPL3",
"summary": "Plugin for using scipy in torchtree",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/4ment/torchtree-scipy"
},
"split_keywords": [
"phylogenetics",
"scipy",
"pytorch",
"torchtree"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4257584fc9c20b3a1fc9059166295087096d6960448e7dbf6e15711c640c1bab",
"md5": "a4c0f8d42e93413fb0c1830f3d77a92f",
"sha256": "c7f0bf1ebfe2d2672e43252cd202d0578754040054ec74eef684c01b0dc8580c"
},
"downloads": -1,
"filename": "torchtree_scipy-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a4c0f8d42e93413fb0c1830f3d77a92f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 16917,
"upload_time": "2023-11-14T04:57:53",
"upload_time_iso_8601": "2023-11-14T04:57:53.509895Z",
"url": "https://files.pythonhosted.org/packages/42/57/584fc9c20b3a1fc9059166295087096d6960448e7dbf6e15711c640c1bab/torchtree_scipy-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8764128e0c4c15d21f2c1b5371f1b38609f1a89611f1d2cd860c5754ab196a3a",
"md5": "03abf0ac7d3a8d5633e0e6ef29f3cf13",
"sha256": "76c8b66e9c2526d010644490e9f75234e2d3fa4d72c3b057fb643cfc354bd93f"
},
"downloads": -1,
"filename": "torchtree-scipy-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "03abf0ac7d3a8d5633e0e6ef29f3cf13",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 16594,
"upload_time": "2023-11-14T04:57:55",
"upload_time_iso_8601": "2023-11-14T04:57:55.457325Z",
"url": "https://files.pythonhosted.org/packages/87/64/128e0c4c15d21f2c1b5371f1b38609f1a89611f1d2cd860c5754ab196a3a/torchtree-scipy-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-14 04:57:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "4ment",
"github_project": "torchtree-scipy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "torchtree-scipy"
}