---
title: "init(quantityType:quantitySamplePredicate:options:completionHandler:)"
framework: healthkit
role: symbol
role_heading: Initializer
path: "healthkit/hkstatisticsquery/init(quantitytype:quantitysamplepredicate:options:completionhandler:)"
---

# init(quantityType:quantitySamplePredicate:options:completionHandler:)

Initializes a statistics query instance that performs the specified calculations over the matching samples in the HeathKit store.

## Declaration

```swift
init(quantityType: HKQuantityType, quantitySamplePredicate: NSPredicate?, options: HKStatisticsOptions = [], completionHandler handler: @escaping @Sendable (HKStatisticsQuery, HKStatistics?, (any Error)?) -> Void)
```

## Parameters

- `quantityType`: The type of sample to search for. This type must be an instance of the doc://com.apple.healthkit/documentation/HealthKit/HKQuantityType class. You cannot perform statistics queries using other sample types.
- `quantitySamplePredicate`: A predicate that limits the results returned by the query. You can pass nil if you want to perform the statistical calculation over all the samples of the specified type.
- `options`: A list of options that define the type of statistical calculations performed and the way in which data from multiple sources are merged. For a list of valid options, see doc://com.apple.healthkit/documentation/HealthKit/HKStatisticsOptions.
- `handler`: A block that is called after the statistical calculations are complete. This block takes the following arguments:

## Mentioned in

Executing Statistical Queries

## Return Value

Return Value A newly initialized statistics query object.

## Discussion

Discussion After instantiating the query, call the HKHealthStore class’s executeQuery: method to run this query. Queries run on an anonymous background queue. As soon as the query is complete, the results handler is executed on the same background queue (but not necessarily on the same thread). You typically dispatch these results to the main queue to update the user interface. note: Statistical calculations can take a considerable amount of time, especially if there are a large number of samples involved.

## See Also

### Creating Statistics Queries

- [Executing Statistical Queries](healthkit/executing-statistical-queries.md)