Metadata-Version: 2.4
Name: vipy
Version: 1.16.2
Summary: Python Tools for Visual Dataset Transformation
Home-page: https://github.com/visym/vipy
Download-URL: https://github.com/visym/vipy/archive/1.16.2.tar.gz
Author: Visym Labs
Author-email: info@visym.com
Keywords: computer vision machine learning ML CV privacy video image
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: matplotlib
Requires-Dist: pillow
Requires-Dist: ffmpeg-python
Provides-Extra: fast
Requires-Dist: ujson; extra == "fast"
Requires-Dist: numba; extra == "fast"
Provides-Extra: all
Requires-Dist: scikit-build; extra == "all"
Requires-Dist: scipy; extra == "all"
Requires-Dist: opencv-python; extra == "all"
Requires-Dist: torch; extra == "all"
Requires-Dist: ipython; extra == "all"
Requires-Dist: scikit-learn; extra == "all"
Requires-Dist: boto3; extra == "all"
Requires-Dist: yt-dlp; extra == "all"
Requires-Dist: dask; extra == "all"
Requires-Dist: distributed; extra == "all"
Requires-Dist: h5py; extra == "all"
Requires-Dist: nltk; extra == "all"
Requires-Dist: bs4; extra == "all"
Requires-Dist: pyyaml; extra == "all"
Requires-Dist: pytest; extra == "all"
Requires-Dist: paramiko; extra == "all"
Requires-Dist: scp; extra == "all"
Requires-Dist: ujson; extra == "all"
Requires-Dist: pdoc3; extra == "all"
Requires-Dist: dill; extra == "all"
Requires-Dist: pillow; extra == "all"
Requires-Dist: numpy; extra == "all"
Requires-Dist: matplotlib; extra == "all"
Requires-Dist: ffmpeg-python; extra == "all"
Requires-Dist: heyvi; extra == "all"
Requires-Dist: datasets; extra == "all"
Requires-Dist: plenoptic; extra == "all"
Requires-Dist: dill; extra == "all"
Provides-Extra: complete
Requires-Dist: scikit-build; extra == "complete"
Requires-Dist: scipy; extra == "complete"
Requires-Dist: opencv-python; extra == "complete"
Requires-Dist: torch; extra == "complete"
Requires-Dist: ipython; extra == "complete"
Requires-Dist: scikit-learn; extra == "complete"
Requires-Dist: boto3; extra == "complete"
Requires-Dist: yt-dlp; extra == "complete"
Requires-Dist: dask; extra == "complete"
Requires-Dist: distributed; extra == "complete"
Requires-Dist: h5py; extra == "complete"
Requires-Dist: nltk; extra == "complete"
Requires-Dist: bs4; extra == "complete"
Requires-Dist: pyyaml; extra == "complete"
Requires-Dist: pytest; extra == "complete"
Requires-Dist: paramiko; extra == "complete"
Requires-Dist: scp; extra == "complete"
Requires-Dist: ujson; extra == "complete"
Requires-Dist: numba; extra == "complete"
Requires-Dist: pdoc3; extra == "complete"
Requires-Dist: dill; extra == "complete"
Requires-Dist: pillow; extra == "complete"
Requires-Dist: numpy; extra == "complete"
Requires-Dist: matplotlib; extra == "complete"
Requires-Dist: ffmpeg-python; extra == "complete"
Requires-Dist: heyvi; extra == "complete"
Requires-Dist: datasets; extra == "complete"
Requires-Dist: plenoptic; extra == "complete"
Requires-Dist: dill; extra == "complete"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

[![PyPI version](https://badge.fury.io/py/vipy.svg)](https://badge.fury.io/py/vipy)  [![CI](https://github.com/visym/vipy/workflows/vipy%20unit%20tests/badge.svg)](https://github.com/visym/vipy/actions?query=workflow%3A%22vipy+unit+tests%22) [![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

VIPY
------------------- 
VIPY: Python Tools for Visual Dataset Transformation    
Documentation: https://visym.github.io/vipy

VIPY is a python package for representation, transformation and visualization of annotated videos and images.  Annotations are the ground truth provided by labelers for training and testing computer vision systems.  VIPY provides tools to easily edit videos and images so that the annotations are transformed along with the pixels.  This enables a clean interface for transforming complex datasets for input to your computer vision pipeline.

VIPY provides:  

* Representation of videos with labeled activities that can be resized, clipped, rotated, scaled, padded, cropped and resampled
* Representation of images with object bounding boxes that can be manipulated as easily as editing an image
* Clean visualization of annotated images and video
* Fluent interface for chaining operations on videos and images
* Lazy loading of images and videos suitable for distributed processing (e.g. dask, spark)
* Straightforward integration into machine learning toolchains (e.g. torch, numpy)
* Visual dataset download, unpack and import (e.g. Imagenet21k, Coco 2014, Visual Genome, Open Images V7, Kinetics700, YoutubeBB, ActivityNet, ... )
* Minimum dependencies for easy installation (e.g. AWS Lambda, Flask)


Requirements
-------------------
python 3.7+  
[ffmpeg](https://ffmpeg.org/download.html) (required for videos)  
numpy, matplotlib, pillow, ffmpeg-python   


Installation
-------------------

```python
pip install vipy
```

Optional dependencies are installable as a complete package:

```python
pip install pip --upgrade
pip install 'vipy[all]'
```

You will receive a friendly warning if attempting to use an optional dependency before installation.


Quickstart
-------------------
```python
import vipy
vipy.image.owl().minsquare().show()
```
<img src="https://raw.githubusercontent.com/visym/vipy/master/docs/vipy_image_owl.jpg" width="980">

```python
import vipy
vipy.dataset.registry('coco_2014').takeone().show()
```
<img src="https://raw.githubusercontent.com/visym/vipy/master/docs/vipy_coco2014_000000290678.jpg" width="980">

```python
v = vipy.dataset.registry('youtubeBB').takeone()
vipy.visualize.montage([im.centersquare().mindim(256).annotate() for t in v.trackclip() for im in t.framerate(1)]).show()
```
<img src="https://raw.githubusercontent.com/visym/vipy/master/test/youtubeBB_bear_framerate_29p97.jpg" width="980">


The [tutorials](https://visym.github.io/vipy/#tutorials) provide useful examples to help you get started.
