Tutorials References Menu

Pandas DataFrame sample() Method

❮ DataFrame Reference


Example

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')

print(df.sample())
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.


Syntax

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

Parameters

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
False
Optional. default False. Specify whether to allow returning the same row more than once, or not
weights String,
List
Optional, default 'None'. Specifies the importance of certain rows or columns
random_state Number,
List
Optional, specifies the seed of the random generator used
axis 0
1
'index'
'columns'
Optional, default 0. The axis to sample

Return Value

A DataFrame with a sample of the original DataFrame.


❮ DataFrame Reference