> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> La función `gini` calcula el coeficiente de Gini de una columna numérica finita y no negativa, una medida de la desigualdad en una distribución.

# gini

<div id="gini">
  ## gini
</div>

Introducido en: v26.8.0

Calcula el [coeficiente de Gini](https://en.wikipedia.org/wiki/Gini_coefficient) de una columna de valores numéricos finitos no negativos, una medida de la desigualdad en una distribución.

El resultado va de `0` (igualdad perfecta: todos los valores son iguales) a un máximo que se aproxima a `1` a medida que aumenta `n` (desigualdad perfecta: un valor concentra todo y los demás son cero). Para una muestra finita de `n` valores, el máximo es `(n - 1) / n`.

Todos los valores proporcionados se recopilan en su tipo de entrada y luego se ordenan antes de realizar un cálculo final numéricamente estable. El coeficiente se calcula a partir de diferencias normalizadas entre pares adyacentes y se devuelve como `Float64`, por lo que se redondea con la precisión de `Float64`. Por lo tanto, la función consume `O(n)` de memoria, donde `n` es el número de valores proporcionados. Los valores `NaN` se omiten, mientras que los valores infinitos y negativos se rechazan.

**Sintaxis**

```sql theme={null}
gini(expr)
```

**Argumentos**

* `expr` — Expresión que produce valores numéricos finitos y no negativos. [`(U)Int*`](/docs/es/reference/data-types/int-uint), [`Float*`](/docs/es/reference/data-types/float) o [`Decimal`](/docs/es/reference/data-types/decimal)

**Valor devuelto**

El coeficiente de Gini, o `NaN` si hay menos de 2 valores o si la suma de los valores es 0. [`Float64`](/docs/es/reference/data-types/float)

**Ejemplos**

**Valores iguales**

```sql title=Query theme={null}
SELECT gini(x) FROM (SELECT 100 AS x FROM numbers(10));
```

```response title=Response theme={null}
┌─gini(x)─┐
│       0 │
└─────────┘
```

**Distribución sesgada**

```sql title=Query theme={null}
SELECT gini(x) FROM (SELECT number AS x FROM numbers(10));
```

```response title=Response theme={null}
┌─────────────gini(x)─┐
│ 0.36666666666666664 │
└─────────────────────┘
```
