torchvision-abi


Nametorchvision-abi JSON
Version 0.14.0a0 PyPI version JSON
download
home_pagehttps://github.com/pytorch/vision
Summaryimage and video datasets and models for torch deep learning
upload_time2024-05-18 05:36:00
maintainerNone
docs_urlNone
authorPyTorch Core Team
requires_python>=3.7
licenseBSD
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            torchvision
===========

.. image:: https://pepy.tech/badge/torchvision
    :target: https://pepy.tech/project/torchvision

.. image:: https://img.shields.io/badge/dynamic/json.svg?label=docs&url=https%3A%2F%2Fpypi.org%2Fpypi%2Ftorchvision%2Fjson&query=%24.info.version&colorB=brightgreen&prefix=v
    :target: https://pytorch.org/vision/stable/index.html


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 <https://pytorch.org/>`_
for the detail of PyTorch (``torch``) installation. The following is the corresponding ``torchvision`` versions and
supported Python versions.

+--------------------------+--------------------------+---------------------------------+
| ``torch``                | ``torchvision``          | ``python``                      |
+==========================+==========================+=================================+
| ``main`` / ``nightly``   | ``main`` / ``nightly``   | ``>=3.7``, ``<=3.10``           |
+--------------------------+--------------------------+---------------------------------+
| ``1.12.0``               | ``0.13.0``               | ``>=3.7``, ``<=3.10``           |
+--------------------------+--------------------------+---------------------------------+
| ``1.11.0``               | ``0.12.0``               | ``>=3.7``, ``<=3.10``           |
+--------------------------+--------------------------+---------------------------------+
| ``1.10.2``               | ``0.11.3``               | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.10.1``               | ``0.11.2``               | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.10.0``               | ``0.11.1``               | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.9.1``                | ``0.10.1``               | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.9.0``                | ``0.10.0``               | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.8.2``                | ``0.9.2``                | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.8.1``                | ``0.9.1``                | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.8.0``                | ``0.9.0``                | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.7.1``                | ``0.8.2``                | ``>=3.6``, ``<=3.9``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.7.0``                | ``0.8.1``                | ``>=3.6``, ``<=3.8``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.7.0``                | ``0.8.0``                | ``>=3.6``, ``<=3.8``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.6.0``                | ``0.7.0``                | ``>=3.6``, ``<=3.8``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.5.1``                | ``0.6.1``                | ``>=3.5``, ``<=3.8``            |
+--------------------------+--------------------------+---------------------------------+
| ``1.5.0``                | ``0.6.0``                | ``>=3.5``, ``<=3.8``            |
+--------------------------+--------------------------+---------------------------------+
| ``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:

.. code:: bash

    conda install torchvision -c pytorch

pip:

.. code:: bash

    pip install torchvision

From source:

.. code:: bash

    python setup.py install
    # or, for OSX
    # MACOSX_DEPLOYMENT_TARGET=10.9 CC=clang CXX=clang++ python setup.py install


We don't officially support building from source using ``pip``, but *if* you do,
you'll need to use the ``--no-build-isolation`` flag.
In case building TorchVision from source fails, install the nightly version of PyTorch following
the linked guide on the  `contributing page <https://github.com/pytorch/vision/blob/main/CONTRIBUTING.md#development-installation>`_ and retry the 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 :code:`torchvision.set_image_backend('accimage')`

* `libpng`_ - can be installed via conda :code:`conda install libpng` or any of the package managers for debian-based and RHEL-based Linux distributions.

* `libjpeg`_ - can be installed via conda :code:`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.

.. _libpng : http://www.libpng.org/pub/png/libpng.html
.. _Pillow : https://python-pillow.org/
.. _Pillow-SIMD : https://github.com/uploadcare/pillow-simd
.. _accimage: https://github.com/pytorch/accimage
.. _libjpeg: http://ijg.org/
.. _libjpeg-turbo: https://libjpeg-turbo.org/

Video Backend
=============
Torchvision currently supports the following video backends:

* `pyav`_ (default) - Pythonic binding for ffmpeg libraries.

.. _pyav : https://github.com/PyAV-Org/PyAV

* video_reader - This needs ffmpeg to be installed and torchvision to be built from source. There shouldn't be any conflicting version of ffmpeg installed. Currently, this is only supported on Linux.

.. code:: bash

     conda install -c conda-forge ffmpeg
     python setup.py install


Using the models on C++
=======================
TorchVision provides an example project for how to use the models on C++ using JIT Script.

Installation From source:

.. code:: bash

    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 :code:`TorchVision::TorchVision` target:

.. code:: rest

	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``.

Python linking is disabled by default when compiling TorchVision with CMake, this allows you to run models without any Python 
dependency. In some special cases where TorchVision's operators are used from Python code, you may need to link to Python. This 
can be done by passing ``-DUSE_PYTHON=on`` to CMake.

TorchVision Operators
---------------------
In order to get the torchvision operators registered with torch (eg. for the JIT), all you need to do is to ensure that you
:code:`#include <torchvision/vision.h>` in your project.

Documentation
=============
You can find the API documentation on the pytorch website: https://pytorch.org/vision/stable/index.html

Contributing
============

See the `CONTRIBUTING <CONTRIBUTING.md>`_ file for how to help out.

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!

Pre-trained Model License
=========================

The pre-trained models provided in this library may have their own licenses or terms and conditions derived from the dataset used for training. It is your responsibility to determine whether you have permission to use the models for your use case.

More specifically, SWAG models are released under the CC-BY-NC 4.0 license. See `SWAG LICENSE <https://github.com/facebookresearch/SWAG/blob/main/LICENSE>`_ for additional details.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pytorch/vision",
    "name": "torchvision-abi",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": "PyTorch Core Team",
    "author_email": "soumith@pytorch.org",
    "download_url": null,
    "platform": null,
    "description": "torchvision\n===========\n\n.. image:: https://pepy.tech/badge/torchvision\n    :target: https://pepy.tech/project/torchvision\n\n.. image:: https://img.shields.io/badge/dynamic/json.svg?label=docs&url=https%3A%2F%2Fpypi.org%2Fpypi%2Ftorchvision%2Fjson&query=%24.info.version&colorB=brightgreen&prefix=v\n    :target: https://pytorch.org/vision/stable/index.html\n\n\nThe torchvision package consists of popular datasets, model architectures, and common image transformations for computer vision.\n\n\nInstallation\n============\n\nWe recommend Anaconda as Python package management system. Please refer to `pytorch.org <https://pytorch.org/>`_\nfor the detail of PyTorch (``torch``) installation. The following is the corresponding ``torchvision`` versions and\nsupported Python versions.\n\n+--------------------------+--------------------------+---------------------------------+\n| ``torch``                | ``torchvision``          | ``python``                      |\n+==========================+==========================+=================================+\n| ``main`` / ``nightly``   | ``main`` / ``nightly``   | ``>=3.7``, ``<=3.10``           |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.12.0``               | ``0.13.0``               | ``>=3.7``, ``<=3.10``           |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.11.0``               | ``0.12.0``               | ``>=3.7``, ``<=3.10``           |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.10.2``               | ``0.11.3``               | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.10.1``               | ``0.11.2``               | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.10.0``               | ``0.11.1``               | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.9.1``                | ``0.10.1``               | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.9.0``                | ``0.10.0``               | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.8.2``                | ``0.9.2``                | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.8.1``                | ``0.9.1``                | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.8.0``                | ``0.9.0``                | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.7.1``                | ``0.8.2``                | ``>=3.6``, ``<=3.9``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.7.0``                | ``0.8.1``                | ``>=3.6``, ``<=3.8``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.7.0``                | ``0.8.0``                | ``>=3.6``, ``<=3.8``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.6.0``                | ``0.7.0``                | ``>=3.6``, ``<=3.8``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.5.1``                | ``0.6.1``                | ``>=3.5``, ``<=3.8``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.5.0``                | ``0.6.0``                | ``>=3.5``, ``<=3.8``            |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.4.0``                | ``0.5.0``                | ``==2.7``, ``>=3.5``, ``<=3.8`` |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.3.1``                | ``0.4.2``                | ``==2.7``, ``>=3.5``, ``<=3.7`` |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.3.0``                | ``0.4.1``                | ``==2.7``, ``>=3.5``, ``<=3.7`` |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.2.0``                | ``0.4.0``                | ``==2.7``, ``>=3.5``, ``<=3.7`` |\n+--------------------------+--------------------------+---------------------------------+\n| ``1.1.0``                | ``0.3.0``                | ``==2.7``, ``>=3.5``, ``<=3.7`` |\n+--------------------------+--------------------------+---------------------------------+\n| ``<=1.0.1``              | ``0.2.2``                | ``==2.7``, ``>=3.5``, ``<=3.7`` |\n+--------------------------+--------------------------+---------------------------------+\n\nAnaconda:\n\n.. code:: bash\n\n    conda install torchvision -c pytorch\n\npip:\n\n.. code:: bash\n\n    pip install torchvision\n\nFrom source:\n\n.. code:: bash\n\n    python setup.py install\n    # or, for OSX\n    # MACOSX_DEPLOYMENT_TARGET=10.9 CC=clang CXX=clang++ python setup.py install\n\n\nWe don't officially support building from source using ``pip``, but *if* you do,\nyou'll need to use the ``--no-build-isolation`` flag.\nIn case building TorchVision from source fails, install the nightly version of PyTorch following\nthe linked guide on the  `contributing page <https://github.com/pytorch/vision/blob/main/CONTRIBUTING.md#development-installation>`_ and retry the install.\n\nBy default, GPU support is built if CUDA is found and ``torch.cuda.is_available()`` is true.\nIt's possible to force building GPU support by setting ``FORCE_CUDA=1`` environment variable,\nwhich is useful when building a docker image.\n\nImage Backend\n=============\nTorchvision currently supports the following image backends:\n\n* `Pillow`_ (default)\n\n* `Pillow-SIMD`_ - a **much faster** drop-in replacement for Pillow with SIMD. If installed will be used as the default.\n\n* `accimage`_ - if installed can be activated by calling :code:`torchvision.set_image_backend('accimage')`\n\n* `libpng`_ - can be installed via conda :code:`conda install libpng` or any of the package managers for debian-based and RHEL-based Linux distributions.\n\n* `libjpeg`_ - can be installed via conda :code:`conda install jpeg` or any of the package managers for debian-based and RHEL-based Linux distributions. `libjpeg-turbo`_ can be used as well.\n\n**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,\notherwise, add the include and library paths in the environment variables ``TORCHVISION_INCLUDE`` and ``TORCHVISION_LIBRARY``, respectively.\n\n.. _libpng : http://www.libpng.org/pub/png/libpng.html\n.. _Pillow : https://python-pillow.org/\n.. _Pillow-SIMD : https://github.com/uploadcare/pillow-simd\n.. _accimage: https://github.com/pytorch/accimage\n.. _libjpeg: http://ijg.org/\n.. _libjpeg-turbo: https://libjpeg-turbo.org/\n\nVideo Backend\n=============\nTorchvision currently supports the following video backends:\n\n* `pyav`_ (default) - Pythonic binding for ffmpeg libraries.\n\n.. _pyav : https://github.com/PyAV-Org/PyAV\n\n* video_reader - This needs ffmpeg to be installed and torchvision to be built from source. There shouldn't be any conflicting version of ffmpeg installed. Currently, this is only supported on Linux.\n\n.. code:: bash\n\n     conda install -c conda-forge ffmpeg\n     python setup.py install\n\n\nUsing the models on C++\n=======================\nTorchVision provides an example project for how to use the models on C++ using JIT Script.\n\nInstallation From source:\n\n.. code:: bash\n\n    mkdir build\n    cd build\n    # Add -DWITH_CUDA=on support for the CUDA if needed\n    cmake ..\n    make\n    make install\n\nOnce installed, the library can be accessed in cmake (after properly configuring ``CMAKE_PREFIX_PATH``) via the :code:`TorchVision::TorchVision` target:\n\n.. code:: rest\n\n\tfind_package(TorchVision REQUIRED)\n\ttarget_link_libraries(my-target PUBLIC TorchVision::TorchVision)\n\nThe ``TorchVision`` package will also automatically look for the ``Torch`` package and add it as a dependency to ``my-target``,\nso make sure that it is also available to cmake via the ``CMAKE_PREFIX_PATH``.\n\nFor an example setup, take a look at ``examples/cpp/hello_world``.\n\nPython linking is disabled by default when compiling TorchVision with CMake, this allows you to run models without any Python \ndependency. In some special cases where TorchVision's operators are used from Python code, you may need to link to Python. This \ncan be done by passing ``-DUSE_PYTHON=on`` to CMake.\n\nTorchVision Operators\n---------------------\nIn order to get the torchvision operators registered with torch (eg. for the JIT), all you need to do is to ensure that you\n:code:`#include <torchvision/vision.h>` in your project.\n\nDocumentation\n=============\nYou can find the API documentation on the pytorch website: https://pytorch.org/vision/stable/index.html\n\nContributing\n============\n\nSee the `CONTRIBUTING <CONTRIBUTING.md>`_ file for how to help out.\n\nDisclaimer on Datasets\n======================\n\nThis 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.\n\nIf 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!\n\nPre-trained Model License\n=========================\n\nThe pre-trained models provided in this library may have their own licenses or terms and conditions derived from the dataset used for training. It is your responsibility to determine whether you have permission to use the models for your use case.\n\nMore specifically, SWAG models are released under the CC-BY-NC 4.0 license. See `SWAG LICENSE <https://github.com/facebookresearch/SWAG/blob/main/LICENSE>`_ for additional details.\n",
    "bugtrack_url": null,
    "license": "BSD",
    "summary": "image and video datasets and models for torch deep learning",
    "version": "0.14.0a0",
    "project_urls": {
        "Homepage": "https://github.com/pytorch/vision"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e95850afc64d13bbb2e6e37a9294ddf3e9a9c51392e0e7abc2d06ca3bce42bb9",
                "md5": "d31ff38bc776c479784d9f4888eb639e",
                "sha256": "fb2f643fec7c7b2232f1f0b8a73aa486f1ef9a0d1c38d73297c243422c7be384"
            },
            "downloads": -1,
            "filename": "torchvision_abi-0.14.0a0-cp311-cp311-manylinux_2_17_x86_64.whl",
            "has_sig": false,
            "md5_digest": "d31ff38bc776c479784d9f4888eb639e",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.7",
            "size": 16647412,
            "upload_time": "2024-05-18T05:36:00",
            "upload_time_iso_8601": "2024-05-18T05:36:00.165095Z",
            "url": "https://files.pythonhosted.org/packages/e9/58/50afc64d13bbb2e6e37a9294ddf3e9a9c51392e0e7abc2d06ca3bce42bb9/torchvision_abi-0.14.0a0-cp311-cp311-manylinux_2_17_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-18 05:36:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pytorch",
    "github_project": "vision",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "torchvision-abi"
}
        
Elapsed time: 0.23882s