mirror of
https://github.com/wassname/IndicoIo-python.git
synced 2026-06-27 16:10:34 +08:00
Chris Lee
65 lines
2.8 KiB
Python
65 lines
2.8 KiB
Python
import requests
|
|
|
|
from indicoio.utils.image import image_preprocess
|
|
from indicoio.utils.api import api_handler
|
|
|
|
def facial_features(image, cloud=None, batch=False, api_key=None, version=None, **kwargs):
|
|
"""
|
|
Given an grayscale input image of a face, returns a 48 dimensional feature vector explaining that face.
|
|
Useful as a form of feature engineering for face oriented tasks.
|
|
Input should be in a list of list format, resizing will be attempted internally but for best
|
|
performance, images should be already sized at 48x48 pixels.
|
|
|
|
Example usage:
|
|
|
|
.. code-block:: python
|
|
|
|
>>> from indicoio import facial_features
|
|
>>> import numpy as np
|
|
>>> face = np.zeros((48,48))
|
|
>>> features = facial_features(face)
|
|
>>> len(features)
|
|
48
|
|
|
|
:param image: The image to be analyzed.
|
|
:type image: list of lists
|
|
:rtype: List containing feature responses
|
|
"""
|
|
image = image_preprocess(image, batch=batch, size=(48,48))
|
|
url_params = {"batch": batch, "api_key": api_key, "version": version}
|
|
return api_handler(image, cloud=cloud, api="facialfeatures", url_params=url_params, **kwargs)
|
|
|
|
def image_features(image, cloud=None, batch=False, api_key=None, version=None, **kwargs):
|
|
"""
|
|
Given an input image, returns a 2048 dimensional sparse feature vector explaining that image.
|
|
Useful as a form of feature engineering for image oriented tasks.
|
|
|
|
* Input can be either grayscale or rgb color and should either be a numpy array or nested list format.
|
|
* Input data should be either uint8 0-255 range values or floating point between 0 and 1.
|
|
* Large images (i.e. 1024x768+) are much bigger than needed, resizing will be done internally to 64x64 if needed.
|
|
* For ideal performance, images should be square aspect ratio but non-square aspect ratios are supported as well.
|
|
|
|
Example usage:
|
|
|
|
.. code-block:: python
|
|
|
|
>>> from indicoio import image_features
|
|
>>> import numpy as np
|
|
>>> image = np.zeros((64,64,3))
|
|
>>> features = image_features(image)
|
|
>>> len(features),np.min(features),np.max(features),np.sum(np.asarray(f)!=0)
|
|
(2048, 0.0, 6.97088623046875, 571)
|
|
|
|
Since the image features returned are a semantic description of the contents of an image they can be used
|
|
to implement many other common image related tasks such as object recognition or image similarity and retrieval.
|
|
|
|
For image similarity, simple distance metrics applied to collections of image feature vectors can work very well.
|
|
|
|
:param image: The image to be analyzed.
|
|
:type image: numpy.ndarray
|
|
:rtype: List containing features
|
|
"""
|
|
image = image_preprocess(image, batch=batch, size=(64,64))
|
|
url_params = {"batch": batch, "api_key": api_key, "version": version}
|
|
return api_handler(image, cloud=cloud, api="imagefeatures", url_params=url_params, **kwargs)
|