# NumPy - extract() function

The NumPy extract() function returns the elements of an array that satisfy some condition. If condition is boolean the function is equivalent to arr[condition].

### Syntax

```numpy.extract(condition, arr)
```

### Parameters

 `condition` `Required. `Specify an array whose nonzero or True entries indicate the elements of arr to extract. `arr` `Required. `Specify the array (array_like) of the same size as condition.

### Return Value

Returns Rank 1 array of values from arr where condition is True.

### Example:

In the example below, extract() function is used to extract elements from an array based on given condition.

```import numpy as np

Arr = np.arange(12).reshape((3, 4))

#displaying the array
print("The original array:")
print(Arr)

#defining condition
condition = np.mod(Arr, 3) == 0
print("\nCondition is:")
print(condition)

#applying condition on array
print("\nExtracting elements based on condition:")
print(np.extract(condition, Arr))
```

The output of the above code will be:

```The original array:
[[ 0  1  2  3]
[ 4  5  6  7]
[ 8  9 10 11]]

Condition is:
[[ True False False  True]
[False False  True False]
[False  True False False]]

Extracting elements based on condition:
[0 3 6 9]
```

❮ NumPy - Functions

5