# pandas.Series.nsmallest¶

Return the smallest n elements.

- param n
- int, default 5
Return this many ascending sorted values.

- param keep
- {‘first’, ‘last’, ‘all’}, default ‘first’
When there are duplicate values that cannot all fit in a Series of n elements:

`first`

return the first n occurrences in orderof appearance.

`last`

return the last n occurrences in reverseorder of appearance.

`all`

keep all occurrences. This can result in a Series ofsize larger than n.

- return
Series The n smallest values in the Series, sorted in increasing order.

## Limitations¶

Parameter

`keep`

is supported only with default value`'first'`

.- This function may reveal slower performance than Pandas* on user system. Users should exercise a tradeoff
between staying in JIT-region with that function or going back to interpreter mode.

## Examples¶

```
import numpy as np
import pandas as pd
from numba import njit
@njit
def series_nsmallest():
series = pd.Series(np.arange(10))
return series.nsmallest(4) # Expect series of 0, 1, 2, 3
print(series_nsmallest())
```

```
$ python ./series/series_nsmallest.py
0 0
1 1
2 2
3 3
dtype: int64
```

See also

- Series.nlargest
Get the n largest elements.

- Series.sort_values
Sort Series by values.

- Series.head
Return the first n rows.