---
title: "update(subprogress:)"
framework: Media Intelligence
role: symbol
role_heading: Instance Method
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+]
path: "mediaintelligence/facegroupanalyzer/update(subprogress:)"
---

# update(subprogress:)

Clusters faces into entities and updates their assignments.

## Declaration

```swift
nonisolated(nonsending) final func update(subprogress: consuming Subprogress? = nil) async throws
```

## Parameters

- `subprogress`: An optional subprogress object for reporting progress to a parent Progress.

## Mentioned in

Detecting and grouping faces in images

## Discussion

Discussion Call this method after ingesting assets with insertOrUpdateAssets(_:) to run the face clustering algorithm. When this method completes, every face has a non-nil entityID and state returns FaceGroupAnalyzer.State.ready. If the analyzer is already up to date, this method returns immediately without performing any clustering.

## See Also

### Updating the gallery

- [state](mediaintelligence/facegroupanalyzer/state-swift.property.md)
- [FaceGroupAnalyzer.State](mediaintelligence/facegroupanalyzer/state-swift.enum.md)