torchdecomp


Nametorchdecomp JSON
Version 1.3.4 PyPI version JSON
download
home_pagehttps://github.com/chiba-ai-med/PyTorchDecomp
SummaryA set of matrix decomposition algorithms implemented as PyTorch classes
upload_time2024-06-20 06:11:26
maintainerKoki Tsuyuzaki
docs_urlNone
authorKoki Tsuyuzaki
requires_python<4.0,>=3.10
licenseMIT
keywords pytorch machine learning
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![DOI](https://zenodo.org/badge/739235639.svg)](https://zenodo.org/doi/10.5281/zenodo.10677187)
[![PyPI version](https://badge.fury.io/py/torchdecomp.svg)](https://badge.fury.io/py/torchdecomp)
![GitHub Actions](https://github.com/chiba-ai-med/PyTorchDecomp/actions/workflows/build_test_push.yml/badge.svg)


# PyTorchDecomp
A set of matrix decomposition algorithms implemented as PyTorch classes


## Installation

Because PyTorchDecomp is a PyPI package, please install it by `pip` command as follows:

```shell
python -m venv env
pip install torchdecomp
```

For the other OS-specific or package-manager-specific installation, please check the [README.md](https://github.com/pytorch/pytorch) of PyTorch.


## Usage

See the [tutorials](https://chiba-ai-med.github.io/PyTorchDecomp/tutorials.html).

## References

- **LU/QR/Cholesky/Eigenvalue Decomposition**
  - Gene H. Golub, Charles F. Van Loan Matrix Computations (Johns Hopkins Studies in the Mathematical Sciences)
- **Principal Component Analysis (PCA) / Partial Least Squares (PLS)**
  - R. Arora, A. Cotter, K. Livescu and N. Srebro, Stochastic optimization for PCA and PLS, 2012 50th Annual Allerton Conference on Communication, Control, and Computing, 2012, 861-868. 2012
- **Independent Component Analysis (ICA)**
  - Hybarinen, A. and Oja, E. Independent component analysis: algorithms and applications, Neural Networks, 13, 411-430. 2000
- **Deep Deterministic ICA (DDICA)**
  - H. Li, S. Yu and J. C. Príncipe, Deep Deterministic Independent Component Analysis for Hyperspectral Unmixing, 2022 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP), 3878-3882, 2022
- **Non-negative Matrix Factorization (NMF)**
  - Kimura, K. A Study on Efficient Algorithms for Nonnegative Matrix/Tensor Factorization, Ph.D. Thesis, 2017
  - **Exponent term depending on Beta parameter**
    - Nakano, M. et al., Convergence-guaranteed multiplicative algorithms for nonnegative matrix factorization with Beta-divergence. IEEE MLSP, 283-288, 2010
  - **Beta-divergence NMF and Backpropagation**
    - https://yoyololicon.github.io/posts/2021/02/torchnmf-algorithm/

## Contributing

If you have suggestions for how `PyTorchDecomp` could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

For more, check out the [Contributing Guide](https://github.com/chiba-ai-med/PyTorchDecomp/blob/main/CONTRIBUTING.md).


## License

PyTorchDecomp has a MIT license, as found in the [LICENSE](https://github.com/chiba-ai-med/PyTorchDecomp/blob/main/LICENSE) file.


## Authors
- Koki Tsuyuzaki

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/chiba-ai-med/PyTorchDecomp",
    "name": "torchdecomp",
    "maintainer": "Koki Tsuyuzaki",
    "docs_url": null,
    "requires_python": "<4.0,>=3.10",
    "maintainer_email": "k.t.the-answer@hotmail.co.jp",
    "keywords": "pytorch, machine learning",
    "author": "Koki Tsuyuzaki",
    "author_email": "k.t.the-answer@hotmail.co.jp",
    "download_url": "https://files.pythonhosted.org/packages/07/29/0f0f8f15b9b69fbd24c8b8195e7265b2d7c99aa874a7dfd924647a1e224a/torchdecomp-1.3.4.tar.gz",
    "platform": null,
    "description": "[![DOI](https://zenodo.org/badge/739235639.svg)](https://zenodo.org/doi/10.5281/zenodo.10677187)\n[![PyPI version](https://badge.fury.io/py/torchdecomp.svg)](https://badge.fury.io/py/torchdecomp)\n![GitHub Actions](https://github.com/chiba-ai-med/PyTorchDecomp/actions/workflows/build_test_push.yml/badge.svg)\n\n\n# PyTorchDecomp\nA set of matrix decomposition algorithms implemented as PyTorch classes\n\n\n## Installation\n\nBecause PyTorchDecomp is a PyPI package, please install it by `pip` command as follows:\n\n```shell\npython -m venv env\npip install torchdecomp\n```\n\nFor the other OS-specific or package-manager-specific installation, please check the [README.md](https://github.com/pytorch/pytorch) of PyTorch.\n\n\n## Usage\n\nSee the [tutorials](https://chiba-ai-med.github.io/PyTorchDecomp/tutorials.html).\n\n## References\n\n- **LU/QR/Cholesky/Eigenvalue Decomposition**\n  - Gene H. Golub, Charles F. Van Loan Matrix Computations (Johns Hopkins Studies in the Mathematical Sciences)\n- **Principal Component Analysis (PCA) / Partial Least Squares (PLS)**\n  - R. Arora, A. Cotter, K. Livescu and N. Srebro, Stochastic optimization for PCA and PLS, 2012 50th Annual Allerton Conference on Communication, Control, and Computing, 2012, 861-868. 2012\n- **Independent Component Analysis (ICA)**\n  - Hybarinen, A. and Oja, E. Independent component analysis: algorithms and applications, Neural Networks, 13, 411-430. 2000\n- **Deep Deterministic ICA (DDICA)**\n  - H. Li, S. Yu and J. C. Pr\u00edncipe, Deep Deterministic Independent Component Analysis for Hyperspectral Unmixing, 2022 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP), 3878-3882, 2022\n- **Non-negative Matrix Factorization (NMF)**\n  - Kimura, K. A Study on Efficient Algorithms for Nonnegative Matrix/Tensor Factorization, Ph.D. Thesis, 2017\n  - **Exponent term depending on Beta parameter**\n    - Nakano, M. et al., Convergence-guaranteed multiplicative algorithms for nonnegative matrix factorization with Beta-divergence. IEEE MLSP, 283-288, 2010\n  - **Beta-divergence NMF and Backpropagation**\n    - https://yoyololicon.github.io/posts/2021/02/torchnmf-algorithm/\n\n## Contributing\n\nIf you have suggestions for how `PyTorchDecomp` could be improved, or want to report a bug, open an issue! We'd love all and any contributions.\n\nFor more, check out the [Contributing Guide](https://github.com/chiba-ai-med/PyTorchDecomp/blob/main/CONTRIBUTING.md).\n\n\n## License\n\nPyTorchDecomp has a MIT license, as found in the [LICENSE](https://github.com/chiba-ai-med/PyTorchDecomp/blob/main/LICENSE) file.\n\n\n## Authors\n- Koki Tsuyuzaki\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A set of matrix decomposition algorithms implemented as PyTorch classes",
    "version": "1.3.4",
    "project_urls": {
        "Homepage": "https://github.com/chiba-ai-med/PyTorchDecomp",
        "Repository": "https://github.com/chiba-ai-med/PyTorchDecomp"
    },
    "split_keywords": [
        "pytorch",
        " machine learning"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f89664dc1076ca1cfd6de3330946044b0f448db4073ca16decbb0b73801b1c3e",
                "md5": "1892aff9c4d55a93220e0515816862ff",
                "sha256": "3fc0f984c903937d387a98a38a04b4301d23f7bfb6f4bc8764bb2d0293bdd27b"
            },
            "downloads": -1,
            "filename": "torchdecomp-1.3.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1892aff9c4d55a93220e0515816862ff",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 17022,
            "upload_time": "2024-06-20T06:11:24",
            "upload_time_iso_8601": "2024-06-20T06:11:24.011768Z",
            "url": "https://files.pythonhosted.org/packages/f8/96/64dc1076ca1cfd6de3330946044b0f448db4073ca16decbb0b73801b1c3e/torchdecomp-1.3.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "07290f0f8f15b9b69fbd24c8b8195e7265b2d7c99aa874a7dfd924647a1e224a",
                "md5": "4c932c6909fc706241e44764d377db86",
                "sha256": "6085353579f82f171b840b4902beeee149a83b51a53e31819809c1090124d400"
            },
            "downloads": -1,
            "filename": "torchdecomp-1.3.4.tar.gz",
            "has_sig": false,
            "md5_digest": "4c932c6909fc706241e44764d377db86",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 11712,
            "upload_time": "2024-06-20T06:11:26",
            "upload_time_iso_8601": "2024-06-20T06:11:26.185461Z",
            "url": "https://files.pythonhosted.org/packages/07/29/0f0f8f15b9b69fbd24c8b8195e7265b2d7c99aa874a7dfd924647a1e224a/torchdecomp-1.3.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-20 06:11:26",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "chiba-ai-med",
    "github_project": "PyTorchDecomp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "torchdecomp"
}
        
Elapsed time: 0.26292s