Make utils_cv pip-installable

MANIFEST.in

@@ -0,0 +1 @@
+graft utils_cv

README.md

@@ -116,3 +116,22 @@ To opt out of tracking, please go to the raw `.ipynb` files and remove the follo
     "![Impressions](https://PixelServer20190423114238.azurewebsites.net/api/impressions/ComputerVision/classification/notebooks/21_deployment_on_azure_container_instances.png)"
 ```
 
+
+## Install this repository via PIP
+A [setup.py](setup.py) file is provided in order to simplify the
+installation of this utilities in this repo from the main directory.
+
+```
+pip install -e .
+```
+
+It is also possible to install directly from GitHub.
+
+```
+pip install git+https://github.com/microsoft/ComputerVision#egg=utils_cv
+```
+
+**NOTE** - The pip installation installs necessary package
+dependencies to make it a self-contained utility.  However, it is
+expected that the conda will be used as shown above to setup the
+environment for the notebooks being used without any issues.

setup.py

@@ -0,0 +1,60 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from setuptools import setup, find_packages
+from os import path
+
+
+UTILS_CV = "utils_cv"  # Utility folder name
+# UTILS_CV_PATH = path.join(path.abspath(path.dirname(__file__)), UTILS_CV)
+# README = path.join(UTILS_CV_PATH, "README.md")
+README = path.join(UTILS_CV, "README.md")
+exec(open(path.join(UTILS_CV, "__init__.py")).read())
+
+with open(README, encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="utils_cv",
+    version=__version__,
+    description="Computer Vision Utilities",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/microsoft/ComputerVision",
+    project_urls={
+        "Bug Tracker": "https://github.com/microsoft/ComputerVision/issues",
+        "Source Code": "https://github.com/microsoft/ComputerVision",
+        "Documentation": "https://github.com/microsoft/ComputerVision",
+    },
+    author="CVDev Team at Microsoft",
+    classifiers=[
+        "Development Status :: 2-Pre-Alpha",
+        "Intended Audience :: Developers",
+        "Intended Audience :: Science/Research",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Topic :: Scientific/Engineering",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    include_package_data=True,
+    # Not fully test the dependency coverage, please make sure to sync
+    # with environment.yml
+    install_requires=[
+        "azureml-sdk[notebooks,contrib]>=1.0.30",  # requires ipykernel, papermill, jupyter-core, jupyter-client
+        "bqplot",
+        "fastai==1.0.48",  # requires pytorch, torchvision, nvidia-ml-py3
+        "scikit-learn>=0.19.1",
+    ],
+    keywords=", ".join([
+        "computer vision",
+        "deep learning",
+        "convolutional neural network",
+        "image classification",
+        "image similarity",
+        "data science",
+        "artificial intelligence",
+        "machine learning",
+        "gpu",
+    ]),
+    packages=[UTILS_CV, ],
+)

utils_cv/README.md

@@ -0,0 +1,24 @@
+# Recommender Utilities # 
+
+This package (`cv_utils`) contains functions to simplify common tasks
+used when developing and evaluating computer vision systems.  A short
+description of the sub-modules is provided below. For more details
+about what functions are available and how to use them, please review
+the doc-strings provided with the code.
+
+
+## Sub-Modules
+
+### [common](common)
+
+This sub-module contains high-level utilities for defining constants
+used in most algorithms as well as helper functions used by other
+modules.
+
+### [classification](classification)
+
+This sub-module contains helper functions for image classification.
+
+### [similarity](./similarity)
+
+This sub-module includes helper functions for image similarity.

utils_cv/__init__.py

@@ -0,0 +1,8 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+__title__ = "Microsoft Computer Vision"
+__version__ = "2019.08"
+__author__ = "CVDev Team at Microsoft"
+__license__ = "MIT"
+__copyright__ = "Copyright 2018-present Microsoft Corporation"