image and video datasets and models for torch deep learning
Project description
torchvision
The torchvision package consists of popular datasets, model architectures, and common image transformations for computer vision.
Installation
We recommend Anaconda as Python package management system. Please refer to pytorch.org for the detail of PyTorch (torch) installation. The following is the corresponding torchvision versions and supported Python versions.
torch |
torchvision |
python |
---|---|---|
master / nightly |
master / nightly |
>=3.6 |
1.6.0 |
0.7.0 |
>=3.6 |
1.5.1 |
0.6.1 |
>=3.5 |
1.5.0 |
0.6.0 |
>=3.5 |
1.4.0 |
0.5.0 |
==2.7, >=3.5, <=3.8 |
1.3.1 |
0.4.2 |
==2.7, >=3.5, <=3.7 |
1.3.0 |
0.4.1 |
==2.7, >=3.5, <=3.7 |
1.2.0 |
0.4.0 |
==2.7, >=3.5, <=3.7 |
1.1.0 |
0.3.0 |
==2.7, >=3.5, <=3.7 |
<=1.0.1 |
0.2.2 |
==2.7, >=3.5, <=3.7 |
Anaconda:
conda install torchvision -c pytorch
pip:
pip install torchvision
From source:
python setup.py install
# or, for OSX
# MACOSX_DEPLOYMENT_TARGET=10.9 CC=clang CXX=clang++ python setup.py install
By default, GPU support is built if CUDA is found and torch.cuda.is_available() is true. It’s possible to force building GPU support by setting FORCE_CUDA=1 environment variable, which is useful when building a docker image.
Image Backend
Torchvision currently supports the following image backends:
Pillow (default)
Pillow-SIMD - a much faster drop-in replacement for Pillow with SIMD. If installed will be used as the default.
accimage - if installed can be activated by calling
torchvision.set_image_backend('accimage')
libpng - can be installed via conda
conda install libpng
or any of the package managers for debian-based and RHEL-based Linux distributions.libjpeg - can be installed via conda
conda install jpeg
or any of the package managers for debian-based and RHEL-based Linux distributions. libjpeg-turbo can be used as well.
Notes: libpng and libjpeg must be available at compilation time in order to be available. Make sure that it is available on the standard library locations, otherwise, add the include and library paths in the environment variables TORCHVISION_INCLUDE and TORCHVISION_LIBRARY, respectively.
C++ API
TorchVision also offers a C++ API that contains C++ equivalent of python models.
Installation From source:
mkdir build
cd build
# Add -DWITH_CUDA=on support for the CUDA if needed
cmake ..
make
make install
Once installed, the library can be accessed in cmake (after properly configuring CMAKE_PREFIX_PATH) via the TorchVision::TorchVision
target:
find_package(TorchVision REQUIRED)
target_link_libraries(my-target PUBLIC TorchVision::TorchVision)
The TorchVision package will also automatically look for the Torch package and add it as a dependency to my-target, so make sure that it is also available to cmake via the CMAKE_PREFIX_PATH.
For an example setup, take a look at examples/cpp/hello_world.
Documentation
You can find the API documentation on the pytorch website: https://pytorch.org/docs/stable/torchvision/index.html
Contributing
We appreciate all contributions. If you are planning to contribute back bug-fixes, please do so without any further discussion. If you plan to contribute new features, utility functions or extensions, please first open an issue and discuss the feature with us.
Disclaimer on Datasets
This is a utility library that downloads and prepares public datasets. We do not host or distribute these datasets, vouch for their quality or fairness, or claim that you have license to use the dataset. It is your responsibility to determine whether you have permission to use the dataset under the dataset’s license.
If you’re a dataset owner and wish to update any part of it (description, citation, etc.), or do not want your dataset to be included in this library, please get in touch through a GitHub issue. Thanks for your contribution to the ML community!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for torchvision-0.8.1-cp38-cp38-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 337820e680e5193872903369d8177d5ea681e7156d370d89d487b0e0f1e56238 |
|
MD5 | 9567290010ee5e1bd59f286577bf6709 |
|
BLAKE2b-256 | 05b5d088df4f7ae6c095a51d85bfe1e7d13ac8650e282f0d903a720fa439b83a |
Hashes for torchvision-0.8.1-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 469e0b831bfe17c46159966b5dc7ba09c87eaeecbed6f9a4d6ec4e691b0c8827 |
|
MD5 | f9fb15b3c9e0721ca15955010ebda7f4 |
|
BLAKE2b-256 | 197eb0d2218bf2f3b101793cb9cb2f40d92c834630dd4ee19a6474d219e83b0c |
Hashes for torchvision-0.8.1-cp37-cp37m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 95b0ce59e631e2c97e6069dff126a43232cca859b18a1b505e5b02dd1a65dd0f |
|
MD5 | 9944e43cc47ecfebe1b42998e677daff |
|
BLAKE2b-256 | a339a9caac0deb027feec2cdd7cc40b2a598256d3f50050c80f349c030f915f2 |
Hashes for torchvision-0.8.1-cp37-cp37m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b58262a2bd2d419d94d7bf8aaa3a532b9283f4995e766723cc4cc3a52d8883c8 |
|
MD5 | 54438c6088cd5f8c8a69d3e84c85c7a9 |
|
BLAKE2b-256 | 0c6f7e3e9e51c770e83046699e4a4842712471a96c7aefe83054b7c9087c20b1 |
Hashes for torchvision-0.8.1-cp36-cp36m-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 307daa1daa4cc1a2380dd26f81d3a9670535fff8927f1049dc76d4e47253fb8e |
|
MD5 | 2089e5c2d205c591b10dc98c0e14ae19 |
|
BLAKE2b-256 | e743aaa740c406b1832adc6ff9d5e71c23fd2af2ebd436c42d76d85809ec8be9 |
Hashes for torchvision-0.8.1-cp36-cp36m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 80b1c6d0a97e86454c15cf9f1afcf0751761273b7687c3d0910336ea87cca8d4 |
|
MD5 | e5a9c062bfdb6b3232725156a776e38e |
|
BLAKE2b-256 | c4359b48a8bae532cb634ec718b722bf83c31efecd82abc078c60a71c942fdf7 |