# RangeAvg Функция скрипта и диаграммы

RangeAvg() возвращает среднее значение диапазона. Для ввода в функцию может использоваться диапазон значений или выражение.

Синтаксис:

RangeAvg(first\_expr[, Expression])

Возвращаемые типы данных: numeric

Аргументы:

Аргументы этой функции могут содержать межзаписные функции, которые в свою очередь возвращают список значений.

Аргументы

| Аргумент | Описание |
| --- | --- |
| first\_expr | Выражение или поле, содержащее данные для измерения. |
| Expression | Дополнительные выражения или поля, содержащие диапазон значений для измерения. |

Ограничения:

Если числовые значения не найдены, возвращается значение NULL.

Примеры и результаты:

Примеры написания скриптов

| Примеры | Результаты |
| --- | --- |
| `RangeAvg<br>(1,2,4)` | Возвращает 2.33333333 |
| `RangeAvg<br>(1,'xyz')` | Возвращает 1 |
| `RangeAvg<br>(null( ), 'abc')` | Возвращает NULL |

Пример:

Добавьте образец скрипта в свое приложение и запустите. Чтобы увидеть результат, добавьте поля, перечисленные в столбце результатов, на лист в вашем приложении.

`RangeTab3:` `LOAD recno() as RangeID, RangeAvg(Field1,Field2,Field3) as MyRangeAvg INLINE [` `Field1, Field2, Field3` `10,5,6` `2,3,7` `8,2,8` `18,11,9` `5,5,9` `9,4,2`

`];`

Результирующая таблица содержит результаты функции MyRangeAvg для каждой записи в таблице.

Результирующая таблица

| RangeID | MyRangeAvg |
| --- | --- |
| 1 | 7 |
| 2 | 4 |
| 3 | 6 |
| 4 | 12.666 |
| 5 | 6.333 |
| 6 | 5 |

Пример с выражением:

` RangeAvg  (Above(MyField),0,3))  `

Возвращает скользящее среднее в диапазоне из трех значений MyField, полученных получен по текущей строке и двумя строками над ней. При указании третьего аргумента как 3 функция Above() возвращает три значения, если выше достаточно строк. Эти значения являются входными для функцииRangeAvg().

Данные, используемые в примерах:

Примечание к подсказкеОтключите сортировку MyField, чтобы убедиться, что пример работает, как ожидается.

Данные образца

| MyField | RangeAvg (Above(MyField,0,3)) | Comments |
| --- | --- | --- |
| 10 | 10 | Поскольку данная строка является верхней, диапазон включает только одно значение. |
| 2 | 6 | Над этой строкой только одна строка, поэтому диапазон: 10,2. |
| 8 | 6.6666666667 | Соответствует RangeAvg(10,2,8) |
| 18 | 9.333333333 | - |
| 5 | 10. 333333333 | - |
| 9 | 10.6666666667 | - |

`RangeTab:``LOAD * INLINE [``MyField``10``2``8``18``5``9``] ;`

## Подробнее

* [Avg — функция диаграммы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/StatisticalAggregationFunctionsinCharts/avg.htm)
* [Count — функция диаграммы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/count.htm)