The face detection api compares faces in two different pictures and tells the similarity between them. A typical use of this is matching identity documents with pictures of a person.
Example
Here we shall compare two pictures of obama
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;
namespace app
{
class App {
static HttpClient client = new HttpClient();
public static async Task makeRequest(){
var request = new MultipartFormDataContent();
var image_data1 = File.OpenRead("test-image6.jpeg");
var image_data2 = File.OpenRead("test-image7.jpg");
request.Add(new StreamContent(image_data1),"image1",Path.GetFileName("test-image6.jpeg"));
request.Add(new StreamContent(image_data2),"image2",Path.GetFileName("test-image7.jpg"));
var output = await client.PostAsync("http://localhost:80/v1/vision/face/match",request);
var jsonString = await output.Content.ReadAsStringAsync();
Console.WriteLine(jsonString);
}
static void Main(string[] args){
makeRequest().Wait();
}
}
}
Result
{'similarity': 0.73975885, 'success': True}
Here we shall compare a picture of Obama with that of Bradley Cooper
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;
namespace app
{
class App {
static HttpClient client = new HttpClient();
public static async Task makeRequest(){
var request = new MultipartFormDataContent();
var image_data1 = File.OpenRead("test-image6.jpeg");
var image_data2 = File.OpenRead("test-image8.jpg");
request.Add(new StreamContent(image_data1),"image1",Path.GetFileName("test-image6.jpeg"));
request.Add(new StreamContent(image_data2),"image2",Path.GetFileName("test-image8.jpg"));
var output = await client.PostAsync("http://localhost:80/v1/vision/face/match",request);
var jsonString = await output.Content.ReadAsStringAsync();
Console.WriteLine(jsonString);
}
static void Main(string[] args){
makeRequest().Wait();
}
}
}
Result
{{'similarity': 0.4456827, 'success': True}
As seen above, the match for two different pictures of Obama was very high while the match for Obama and Bradley Cooper was very low.
Performance
DeepStack offers three modes allowing you to tradeoff speed for peformance. During startup, you can specify performance mode to be , "High" , "Medium" and "Low"
The default mode is "Medium"
You can speciy a different mode as seen below
sudo docker run -e MODE=High -e VISION-FACE=True -v localstorage:/datastore \ -p 80:5000 deepquestai/deepstack
Note the -e MODE=High above