---
title: "system.math.geometricMean"
description: "Calculates the geometric mean."
---

# system.math.geometricMean

> Calculates the geometric mean.

This function is used in **Python Scripting**.

## Description
Calculates the geometric mean. Geometric mean is a type of average which indicates a value in a set of numbers by using the product of values in the set and then taking the nth root, where *n* is the number of values in the set. This is different than an arithmetic mean, which calculates an average based off the sum of the numbers, and divides it by n number of values. Geometric means can only be positive numbers.

Returns NaN (Not a Number) if passed an empty sequence.

## Client Permission Restrictions
This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.math.geometricMean(values)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
List[Float] | `values` | A sequence of numerical values. Accepts both integers and floats. The sequence may not contain None type values. However, passing a None type object instead of a sequence of numerical values will return NaN.

### Returns
**Float** - The geometric mean, or NaN if the input was empty or null. Because this uses logs to compute the geometric mean, will return NaN if any entries are negative.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Example #1 - Calculating Geometric Mean"
# Create a List of values.
values = [3.5, 5.6, 7.8, 7.4, 3.8]
 
# Prints the resulting value.
print system.math.geometricMean(values)
```