Explain Face Rec

https://facerec.gjung.com/
Admin
An interactive tutorial that teaches face recognition technology from scratch, covering detection,...
Tokens:4,293
Snippets:68
Trust Score:5
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install FaceAiSharp Dependencies

Source: https://facerec.gjung.com/FaceDetection

Commands to add the necessary NuGet packages for face detection.

```bash
dotnet add package Microsoft.ML.OnnxRuntime
dotnet add package FaceAiSharp.Bundle
```

--------------------------------

### Face Detection and Alignment Example (C#)

Source: https://facerec.gjung.com/FaceAlignment

This C# code snippet demonstrates how to load an image, detect faces, and align a detected face using the FaceAiSharp library. Ensure you have installed the required packages.

```csharp
using FaceAiSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

using var hc = new HttpClient();
var groupPhoto = await hc.GetByteArrayAsync(
    "https://raw.githubusercontent.com/georg-jung/FaceAiSharp/master/examples/obama_family.jpg");
var img = Image.Load<Rgb24>(groupPhoto);

var det = FaceAiSharpBundleFactory.CreateFaceDetectorWithLandmarks();
var rec = FaceAiSharpBundleFactory.CreateFaceEmbeddingsGenerator();

var face = det.DetectFaces(img).First();
rec.AlignFaceUsingLandmarks(img, face.Landmarks!);
img.Save("aligned.jpg");
```

--------------------------------

### Example Embedding Output

Source: https://facerec.gjung.com/FaceRecognition

Sample console output showing the generated vector values.

```text
Generated an embedding for one face:
-0,029764613    0,13904491      -0,017976629    0,010621089     0,015310788     -0,077746354
0,026660273     -0,03839961     -0,06403088     0,023788495     -0,1461524      -0,010910285
-0,001902924    -0,07354331     -0,06590692    0,09289711       0,0023482481    0,035271123
<... more numbers between -1 and 1 ...>
```

--------------------------------

### Example Output of Face Recognition

Source: https://facerec.gjung.com/ComparingFaces

This is an example of the output you can expect after running the face recognition C# code. The output includes the calculated dot product and an assessment of whether the faces belong to the same person.

```text
Dot product: 0,21705234
Assessment: These are two different people.
```

--------------------------------

### Face Detection Output Example

Source: https://facerec.gjung.com/FaceDetection

Expected console output showing detected face confidence and bounding box coordinates.

```text
Found a face with confidence 0.89665085: RectangleF [ X=176.05847, Y=79.44571, Width=62.074905, Height=84.46396 ]
Found a face with confidence 0.88412976: RectangleF [ X=454.50806, Y=88.49284, Width=65.97302, Height=78.17378 ]
Found a face with confidence 0.8757608: RectangleF [ X=383.41547, Y=82.51477, Width=63.718292, Height=95.04758 ]
Found a face with confidence 0.87154955: RectangleF [ X=249.2981, Y=103.57684, Width=57.793823, Height=83.17267 ]
```

--------------------------------

### Implement Face Detection in C#

Source: https://facerec.gjung.com/FaceDetection

Example code to load an image and detect faces using FaceAiSharp.

```csharp
using FaceAiSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

using var hc = new HttpClient();
var groupPhoto = await hc.GetByteArrayAsync(
    "https://raw.githubusercontent.com/georg-jung/FaceAiSharp/master/examples/obama_family.jpg");
var img = Image.Load<Rgb24>(groupPhoto);

var det = FaceAiSharpBundleFactory.CreateFaceDetector();
var faces = det.DetectFaces(img);
foreach (var face in faces)
{
    Console.WriteLine($"Found a face with confidence {face.Confidence}: {face.Box}");
}
```

--------------------------------

### Perform Face Detection and Recognition in C#

Source: https://facerec.gjung.com/ComparingFaces

This C# code snippet uses FaceAiSharp to detect faces in an image, generate embeddings, and compare them to determine if they belong to the same person. Ensure you have the required packages installed and .NET SDK set up.

```csharp
using FaceAiSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

using var hc = new HttpClient();
var groupPhoto = await hc.GetByteArrayAsync(
    "https://raw.githubusercontent.com/georg-jung/FaceAiSharp/master/examples/obama_family.jpg");
var img = Image.Load<Rgb24>(groupPhoto);

var det = FaceAiSharpBundleFactory.CreateFaceDetectorWithLandmarks();
var rec = FaceAiSharpBundleFactory.CreateFaceEmbeddingsGenerator();

var faces = det.DetectFaces(img);
var first = faces.First();
var second = faces.Skip(1).First();

// AlignFaceUsingLandmarks is an in-place operation so we need to create a clone of img first
var secondImg = img.Clone();
rec.AlignFaceUsingLandmarks(img, first.Landmarks!);
rec.AlignFaceUsingLandmarks(secondImg, second.Landmarks!);

var embedding1 = rec.GenerateEmbedding(img);
var embedding2 = rec.GenerateEmbedding(secondImg);

var dot = FaceAiSharp.Extensions.GeometryExtensions.Dot(embedding1, embedding2);

Console.WriteLine($"Dot product: {dot}");
if (dot >= 0.42)
{
    Console.WriteLine("Assessment: Both pictures show the same person.");
}
else if (dot > 0.28 && dot < 0.42)
{
    Console.WriteLine("Assessment: Hard to tell if the pictures show the same person.");
}
else if (dot <= 0.28)
{
    Console.WriteLine("Assessment: These are two different people.");
}
```

--------------------------------

### Run Face Recognition Tutorial with Docker

Source: https://facerec.gjung.com/

Use this command to pull and run the tutorial container locally. Access the application at localhost:8080 after execution.

```bash
docker run -p 8080:8080 ghcr.io/georg-jung/explain-face-rec:latest
```

--------------------------------

### Initialize .NET Console Project

Source: https://facerec.gjung.com/FaceDetection

Command to create a new console application project.

```bash
dotnet new console
```

--------------------------------

### Run .NET Application

Source: https://facerec.gjung.com/FaceDetection

Command to execute the console application.

```bash
dotnet run
```

--------------------------------

### Generate Face Embeddings in C#

Source: https://facerec.gjung.com/FaceRecognition

Implementation for detecting faces and generating embeddings using FaceAiSharp.

```csharp
using FaceAiSharp;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

using var hc = new HttpClient();
var groupPhoto = await hc.GetByteArrayAsync(
    "https://raw.githubusercontent.com/georg-jung/FaceAiSharp/master/examples/obama_family.jpg");
var img = Image.Load<Rgb24>(groupPhoto);

var det = FaceAiSharpBundleFactory.CreateFaceDetectorWithLandmarks();
var rec = FaceAiSharpBundleFactory.CreateFaceEmbeddingsGenerator();

var face = det.DetectFaces(img).First();
rec.AlignFaceUsingLandmarks(img, face.Landmarks!);
var embedding = rec.GenerateEmbedding(img);
Console.WriteLine($"Generated an embedding for one face:\nn{string.Join("\t", embedding)}");
```
Tokens:
Raw