Tutorials References Exercises Sign Up Menu
Create Website Get Certified Pro

Pandas DataFrame sample() Method

❮ DataFrame Reference


Return one random sample row of the DataFrame.

In this example we use a .csv file called data.csv

import pandas as pd

df = pd.read_csv('data.csv')

Try it Yourself »

Definition and Usage

The sample() method returns a specified number of random rows.

The sample() method returns 1 row if a number is not specified.


Note: The column names will also be returned, in addition to the sample rows.


dataframe.sample(n, frac, replace, weights, random_state, axis)


The frac, replace, weights, random_state, axis parameters are keyword arguments.

Parameter Value Description
n   Optional. The number of rows to return. Default value is 1.
frac Float Number Optional. A fraction of rows to return, like 0.5 for 50% of the rows
replace True
Optional. default False. Specify whether to allow returning the same row more than once, or not
weights String,
Optional, default 'None'. Specifies the importance of certain rows or columns
random_state Number,
Optional, specifies the seed of the random generator used
axis 0
Optional, default 0. The axis to sample

Return Value

A DataFrame with a sample of the original DataFrame.

❮ DataFrame Reference