Contents

HKCorrelation

A sample that groups multiple related samples into a single entry.

Declaration

class HKCorrelation

Mentioned in

Overview

HealthKit uses correlations to represent both blood pressure and food.

  • Blood pressure correlations always include two quantity samples, representing the systolic and diastolic values.

  • Food correlations can contain a wide range of dietary information about the food, including information about the fat, protein, carbohydrates, energy, and vitamins consumed.

In general, a food correlation should include at least a dietaryEnergyConsumed sample. You can also add nutritional quantity samples for any other items you want to track. Use the HKMetadataKeyFoodType key to indicate the food’s name.

The HKCorrelation class is a concrete subclass of the HKSample class. Correlations are immutable: You set the correlation’s properties when the object is first created, and they cannot change.

Extend Correlation Samples

Like many HealthKit classes, the HKCorrelation class should not be subclassed. You can extend the correlation class by adding metadata with custom keys as appropriate for your app.

For more information, see the init(type:start:end:objects:metadata:) method.

Topics

Creating Correlations

Getting Correlation Data

Specifying Predicate Key Paths

Initializers

See Also

Basic samples