API · Pandas
Método `Series.nunique()` de pandas
El método Pandas Series.nunique cuenta los valores únicos Series Pandas de Python.
En esta página
Series.nunique() devuelve como entero la cantidad de valores distintos de una Series de pandas. Responde a la pregunta «¿cuántos valores diferentes hay?»; no devuelve esos valores. Úsalo para contar categorías, identificadores o mediciones distintos cuando necesites un resumen breve de una columna.
Cómo Series.nunique() cuenta los valores únicos
Cada valor distinto que no sea ausente suma uno al recuento, sin importar cuántas veces aparezca. Con la configuración predeterminada, los valores ausentes, como NaN, no cuentan. Por tanto, cada valor repetido se cuenta una sola vez y se excluyen todas las entradas repetidas de NaN. Esta diferencia importa al comparar recuentos de categorías: con el comportamiento predeterminado, una entrada ausente no se considera una categoría.
Sintaxis y parámetro dropna
La firma del método es Series.nunique(dropna=True). El argumento dropna es una opción booleana cuyo valor predeterminado es True. Déjalo así si quieres saber cuántos valores conocidos distintos contiene la Series. Pasa dropna=False cuando quieras contar los valores ausentes como un valor distinto adicional. Varias entradas ausentes siguen sumando solo una al total; no añaden un recuento por cada entrada.
El método devuelve un entero, incluso cuando la Series no contiene valores que contar. Si no hay valores ausentes, cambiar dropna no modifica el resultado. El recuento de valores distintos de una Series vacía es 0; si solo contiene valores ausentes, el recuento predeterminado es 0 y con dropna=False es 1. Estos casos ayudan a distinguir entre «no hay categorías observadas» y «los valores ausentes se tratan como una categoría».
Contar valores únicos en una Series
Ejecuta este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
import numpy as np
import pandas as pd
values = pd.Series([1, 2, 3, np.nan, 3, 4, np.nan], name="No.")
print(values.nunique())
4
La Series contiene cuatro valores distintos no ausentes: 1, 2, 3 y 4. El 3 repetido cuenta una sola vez y el valor predeterminado dropna=True excluye ambas entradas de NaN; por eso el recuento es 4. En una aplicación, guarda este entero o inclúyelo en un informe cuando necesites el total de valores distintos, en lugar de una lista de esos valores.
Incluir los valores ausentes con dropna=False
Usa los mismos datos y establece dropna=False para contar los valores ausentes como un único valor distinto:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
import numpy as np
import pandas as pd
values = pd.Series([1, 2, 3, np.nan, 3, 4, np.nan], name="No.")
print(values.nunique(dropna=False))
5
El recuento es 5: los cuatro valores no ausentes más un valor ausente distinto. Aunque esta Series tiene dos entradas de NaN, ambas representan la misma categoría de valor ausente en este recuento. Elige la opción según lo que quieras averiguar: usa el valor predeterminado para contar los valores conocidos, o dropna=False cuando la presencia de datos ausentes deba sumar uno al recuento de valores distintos. Esta opción solo cambia si se incluyen los valores ausentes; los valores ordinarios repetidos siguen contando una sola vez en ambos casos.