.. image:: https://badge.fury.io/py/tensorly-torch.svg
:target: https://badge.fury.io/py/tensorly-torch
==============
TensorLy-Torch
==============
TensorLy-Torch is a Python library for deep tensor networks that
builds on top of `TensorLy <https://github.com/tensorly/tensorly/>`_
and `PyTorch <https://pytorch.org/>`_.
It allows to easily leverage tensor methods in a deep learning setting and comes with all batteries included.
- **Website:** http://tensorly.org/torch/
- **Source-code:** https://github.com/tensorly/torch
With TensorLy-Torch, you can easily:
- **Tensor Factorizations**: decomposing, manipulating and initializing tensor decompositions can be tricky. We take care of it all, in a convenient, unified API.
- **Leverage structure in your data**: with tensor layers, you can easily leverage the structure in your data, through Tensor Regression Layers, Factorized Convolutions, etc
- **Built-in tensor layers**: all you have to do is import tensorly torch and include the layers we provide directly within your PyTorch models!
- **Tensor hooks**: you can easily augment your architectures with our built-in Tensor Hooks. Robustify your network with Tensor Dropout and automatically select the rank end-to-end with L1 Regularization!
- **All the methods available**: we are always adding more methods to make it easy to compare between the performance of various deep tensor based methods!
Deep Tensorized Learning
========================
Tensor methods generalize matrix algebraic operations to higher-orders. Deep neural networks typically map between higher-order tensors.
In fact, it is the ability of deep convolutional neural networks to preserve and leverage local structure that, along with large datasets and efficient hardware, made the current levels of performance possible.
Tensor methods allow to further leverage and preserve that structure, for individual layers or whole networks.
.. image:: ./doc/_static/tensorly-torch-pyramid.png
TensorLy is a Python library that aims at making tensor learning simple and accessible.
It provides a high-level API for tensor methods, including core tensor operations, tensor decomposition and regression.
It has a flexible backend that allows running operations seamlessly using NumPy, PyTorch, TensorFlow, JAX, MXNet and CuPy.
**TensorLy-Torch** is a PyTorch only library that builds on top of TensorLy and provides out-of-the-box tensor layers.
Improve your neural networks with tensor methods
------------------------------------------------
Tensor methods generalize matrix algebraic operations to higher-orders. Deep neural networks typically map between higher-order tensors.
In fact, it is the ability of deep convolutional neural networks to preserve and leverage local structure that, along with large datasets and efficient hardware, made the current levels of performance possible.
Tensor methods allow to further leverage and preserve that structure, for individual layers or whole networks.
In TensorLy-Torch, we provide convenient layers that do all the heavy lifting for you
and provide the benefits tensor based layers wrapped in a nice, well documented and tested API.
For instance, convolution layers of any order (2D, 3D or more), can be efficiently parametrized
using tensor decomposition. Using a CP decomposition results in a separable convolution
and you can replace your original convolution with a series of small efficient ones:
.. image:: ./doc/_static/cp-conv.png
These can be easily perform with FactorizedConv in TensorLy-Torch.
We also have Tucker convolutions and new tensor-train convolutions!
We also implement various other methods such as tensor regression and contraction layers,
tensorized linear layers, tensor dropout and more!
Installing TensorLy-Torch
=========================
Through pip
-----------
.. code::
pip install tensorly-torch
From source
-----------
.. code::
git clone https://github.com/tensorly/torch
cd torch
pip install -e .
Raw data
{
"_id": null,
"home_page": "https://github.com/tensorly/tensorly-torch",
"name": "tensorly-torch",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Jean Kossaifi",
"author_email": "jean.kossaifi@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d6/24/afea0adc5c29ae40d28bc359eaf888a1605699fbba690e76ec67c51b055a/tensorly-torch-0.5.0.tar.gz",
"platform": null,
"description": ".. image:: https://badge.fury.io/py/tensorly-torch.svg\n :target: https://badge.fury.io/py/tensorly-torch\n\n\n==============\nTensorLy-Torch\n==============\n\nTensorLy-Torch is a Python library for deep tensor networks that\nbuilds on top of `TensorLy <https://github.com/tensorly/tensorly/>`_\nand `PyTorch <https://pytorch.org/>`_.\nIt allows to easily leverage tensor methods in a deep learning setting and comes with all batteries included.\n\n- **Website:** http://tensorly.org/torch/\n- **Source-code:** https://github.com/tensorly/torch\n\n\nWith TensorLy-Torch, you can easily: \n\n- **Tensor Factorizations**: decomposing, manipulating and initializing tensor decompositions can be tricky. We take care of it all, in a convenient, unified API.\n- **Leverage structure in your data**: with tensor layers, you can easily leverage the structure in your data, through Tensor Regression Layers, Factorized Convolutions, etc\n- **Built-in tensor layers**: all you have to do is import tensorly torch and include the layers we provide directly within your PyTorch models!\n- **Tensor hooks**: you can easily augment your architectures with our built-in Tensor Hooks. Robustify your network with Tensor Dropout and automatically select the rank end-to-end with L1 Regularization!\n- **All the methods available**: we are always adding more methods to make it easy to compare between the performance of various deep tensor based methods!\n\nDeep Tensorized Learning\n========================\n\nTensor methods generalize matrix algebraic operations to higher-orders. Deep neural networks typically map between higher-order tensors. \nIn fact, it is the ability of deep convolutional neural networks to preserve and leverage local structure that, along with large datasets and efficient hardware, made the current levels of performance possible.\nTensor methods allow to further leverage and preserve that structure, for individual layers or whole networks. \n\n.. image:: ./doc/_static/tensorly-torch-pyramid.png\n\nTensorLy is a Python library that aims at making tensor learning simple and accessible.\nIt provides a high-level API for tensor methods, including core tensor operations, tensor decomposition and regression. \nIt has a flexible backend that allows running operations seamlessly using NumPy, PyTorch, TensorFlow, JAX, MXNet and CuPy.\n \n**TensorLy-Torch** is a PyTorch only library that builds on top of TensorLy and provides out-of-the-box tensor layers.\n\nImprove your neural networks with tensor methods\n------------------------------------------------\n\nTensor methods generalize matrix algebraic operations to higher-orders. Deep neural networks typically map between higher-order tensors. \nIn fact, it is the ability of deep convolutional neural networks to preserve and leverage local structure that, along with large datasets and efficient hardware, made the current levels of performance possible.\nTensor methods allow to further leverage and preserve that structure, for individual layers or whole networks. \n\nIn TensorLy-Torch, we provide convenient layers that do all the heavy lifting for you \nand provide the benefits tensor based layers wrapped in a nice, well documented and tested API.\n\nFor instance, convolution layers of any order (2D, 3D or more), can be efficiently parametrized\nusing tensor decomposition. Using a CP decomposition results in a separable convolution\nand you can replace your original convolution with a series of small efficient ones: \n\n.. image:: ./doc/_static/cp-conv.png \n\nThese can be easily perform with FactorizedConv in TensorLy-Torch.\nWe also have Tucker convolutions and new tensor-train convolutions!\nWe also implement various other methods such as tensor regression and contraction layers, \ntensorized linear layers, tensor dropout and more!\n\n\nInstalling TensorLy-Torch\n=========================\n\nThrough pip\n-----------\n\n.. code:: \n\n pip install tensorly-torch\n \n \nFrom source\n-----------\n\n.. code::\n\n git clone https://github.com/tensorly/torch\n cd torch\n pip install -e .\n \n\n\n\n\n\n\n",
"bugtrack_url": null,
"license": "Modified BSD",
"summary": "Deep Learning with Tensors in Python, using PyTorch and TensorLy.",
"version": "0.5.0",
"project_urls": {
"Download": "https://github.com/tensorly/tensorly-torch/tarball/0.5.0",
"Homepage": "https://github.com/tensorly/tensorly-torch"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fb352da451f342ee532bf66507c89ff3cdefc0dfbacff83a2f088811deb2df17",
"md5": "e0811854811848ae5c6d0243b3ebf13d",
"sha256": "6a14cab43bb82892e58940fb75e5c55ec1a550d9063fb722469f93cba449940b"
},
"downloads": -1,
"filename": "tensorly_torch-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e0811854811848ae5c6d0243b3ebf13d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 59264,
"upload_time": "2024-06-09T17:36:16",
"upload_time_iso_8601": "2024-06-09T17:36:16.964517Z",
"url": "https://files.pythonhosted.org/packages/fb/35/2da451f342ee532bf66507c89ff3cdefc0dfbacff83a2f088811deb2df17/tensorly_torch-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d624afea0adc5c29ae40d28bc359eaf888a1605699fbba690e76ec67c51b055a",
"md5": "e29901aeb7ac0f7a859db75091b1590a",
"sha256": "4c2f19f361113ca78f09b504a786075b0f51425468ae997a5f8018d4be6a4db5"
},
"downloads": -1,
"filename": "tensorly-torch-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "e29901aeb7ac0f7a859db75091b1590a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 43306,
"upload_time": "2024-06-09T17:36:18",
"upload_time_iso_8601": "2024-06-09T17:36:18.674633Z",
"url": "https://files.pythonhosted.org/packages/d6/24/afea0adc5c29ae40d28bc359eaf888a1605699fbba690e76ec67c51b055a/tensorly-torch-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-09 17:36:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tensorly",
"github_project": "tensorly-torch",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "tensorly-torch"
}
JSON
