---
title: "system.math.standardDeviation"
description: "Given a sequence of numerical values, calculates the simple standard deviation."
---

# system.math.standardDeviation

> Given a sequence of numerical values, calculates the simple standard deviation.

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

## Description
Given a sequence of numerical values, calculates the simple standard deviation. Standard deviation is a calculated number for how close, or how far the values of that dataset are in relation to the mean. 

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.standardDeviation(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 standard deviation of the values parameter, or NaN if the values was empty or null.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Example #1 - Calculating Standard Deviation"
# Create a list of values.
values = [3.5, 5.6, 7.8, 7.4, 3.8]
  
# Print the resulting value.
print system.math.standardDeviation(values)
```