Custom Calculations

Custom Calculations

HeartLab allows organisations to create custom calculations using existing study measurements and manually entered values. Custom calculations can help standardise reporting workflows, automate derived measurements, and reduce the need for manual calculations.

This guide explains how to configure, validate, and use custom calculations within HeartLab.

Applies to

• Users with the Measurement: Calculations permission (typically Administrators)

Configure a Custom Calculation

Step 1: Open Calculation Settings

1. Navigate to Settings > Measurements > Calculations.
2. Select Create Calculation.

Step 2: Configure the Calculation

1. Enter a calculation name.
2. Enter the calculation formula.
3. Click the + icon to add one or more input variables.
4. For each input variable, configure:
   • Measurement name
   • Measurement unit
   • Whether the value should be entered manually or pulled from study data
5. If the variable is manually entered, define both a label and a unit.
6. If the variable uses study measurements, define the measurement label used for matching.
7. Define the output label and output unit.

Step 3: Validate the Calculation

1. Use Try it out to test the calculation with sample values.
2. Confirm that the returned result matches the expected output.

Use a Custom Calculation

Step 1: Open the Calculation Tool

1. Navigate to the target study.
2. Select the Calculator icon.

Step 2: Apply the Calculation

1. Select the required custom calculation.
2. Select the measurements to be used in the calculation, or enter manual values where required.
3. Capture any missing measurements using the Ruler tool.
4. Ensure the correct clip and frame are selected when capturing missing measurements.
5. Review the calculated result.
6. Click Save.

The calculated value is saved alongside the other study measurements.

Related

• Use Calculations
• Using the Measurement Pane