random.sample(population, k, *, counts = None)
La función random.sample devuelve una lista de k elementos extraídos sin repetición de la secuencia population. Es decir, devuelve una muestra de dicha secuencia. Si population contiene elementos repetidos, cada uno de ellos es susceptible de ser escogido por separado como parte de la muestra.
Los elementos repetidos pueden ser especificados uno por uno, o mediante el parámetro counts. Éste, de existir, deberá contener la frecuencia absoluta de cada uno de los elementos de population, lo que supone que el número de elementos de population y de counts deberá coincidir. Así, por ejemplo, el siguiente código:
...es equivalente a:
Para obtener una muestra de un rango de números se recomienda usar la función range como argumento (véase ejemplo más adelante).
- population: Secuencia de la que extraer la muestra sin repetición.
- k: Número de elementos a extraer.
- counts: (Opcional) Frecuencias absolutas de los elementos de population.
La función random.sample devuelve una lista.
Podemos extraer una muestra compuesta por dos días distintos de la semana con el siguiente código:
Si nuestra población es la siguiente:
...podríamos extraer una muestra de dos elementos sin repetición con el siguiente código:
...o indicando como población los valores únicos y su frecuencia absoluta:
Si deseamos extraer una muestra de, por ejemplo, tres números entre el 1 y el 20, ambos incluidos, podríamos obtenerla pasando como argumento la función range:
Desde la versión 3.9, los conjuntos deberán ser convertidos a listas si queremos extraer una muestra de ellos:
