Skip to content

Commit 21c5ebd

Browse files
committed
edit pass: cognitive-services-face-articles-batch1
1 parent 8c940ea commit 21c5ebd

File tree

2 files changed

+4
-4
lines changed

2 files changed

+4
-4
lines changed

articles/cognitive-services/Face/Face-API-How-to-Topics/HowtoIdentifyFacesinImage.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ In this step, a PersonGroup named "MyFriends" contains Anna, Bill, and Clare. Ea
5252

5353
![MyFriends](../Images/group.image.1.jpg)
5454

55-
### 2.1 Define people for the PersonGroup
55+
### Step 2.1: Define people for the PersonGroup
5656
A person is a basic unit of identify. A person can have one or more known faces registered. A PersonGroup is a collection of people. Each person is defined within a particular PersonGroup. Identification is done against a PersonGroup. The task is to create a PersonGroup, and then create the people in it, such as Anna, Bill, and Clare.
5757

5858
First, create a new PersonGroup by using the [PersonGroup - Create](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395244) API. The corresponding client library API is the CreatePersonGroupAsync method for the FaceServiceClient class. The group ID that's specified to create the group is unique for each subscription. You also can get, update, or delete PersonGroups by using other PersonGroup APIs.
@@ -74,7 +74,7 @@ CreatePersonResult friend1 = await faceServiceClient.CreatePersonAsync(
7474

7575
// Define Bill and Clare in the same way
7676
```
77-
### <a name="step2-2"></a> 2.2 Detect faces and register them to the correct person
77+
### <a name="step2-2"></a> Step 2.2: Detect faces and register them to the correct person
7878
Detection is done by sending a "POST" web request to the [Face - Detect](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236) API with the image file in the HTTP request body. When you use the client library, face detection is done through the DetectAsync method for the FaceServiceClient class.
7979

8080
For each face that's detected, call [PersonGroup Person – Add Face](https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523b) to add it to the correct person.

articles/cognitive-services/Face/Face-API-How-to-Topics/how-to-use-large-scale.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,7 @@ As is shown in `TrainLargeFaceList()`, there's a time interval in milliseconds t
207207

208208
The same strategy also applies to LargePersonGroup. For example, when you train a LargePersonGroup with 1 million persons, `timeIntervalInMilliseconds` might be 60,000, which is a 1-minute interval.
209209

210-
## Step 3.2 Small-scale buffer
210+
## Step 3.2: Small-scale buffer
211211

212212
Persons or faces in a LargePersonGroup or a LargeFaceList are searchable only after being trained. In a dynamic scenario, new persons or faces are constantly added and must be immediately searchable, yet training might take longer than desired.
213213

@@ -222,7 +222,7 @@ An example workflow:
222222
1. When the buffer collection size increases to a threshold or at a system idle time, create a new buffer collection. Trigger the Train operation on the master collection.
223223
1. Delete the old buffer collection after the Train operation finishes on the master collection.
224224

225-
## Step 3.3 Standalone training
225+
## Step 3.3: Standalone training
226226

227227
If a relatively long latency is acceptable, it isn't necessary to trigger the Train operation right after you add new data. Instead, the Train operation can be split from the main logic and triggered regularly. This strategy is suitable for dynamic scenarios with acceptable latency. It can be applied to static scenarios to further reduce the Train frequency.
228228

0 commit comments

Comments
 (0)