Merge pull request #6 from jetbrains-academy/sofia/boolean_indexing

Added Boolean Array Indexing task to section Array Indexing and Slici…

Author: sofiiako

Numpy/Array Indexing and Slicing/Boolean Indexing/__init__.py

@@ -0,0 +1,17 @@
+type: edu
+files:
+- name: task.py
+  visible: true
+  placeholders:
+  - offset: 24
+    length: 30
+    placeholder_text: '# TODO'
+  - offset: 62
+    length: 40
+    placeholder_text: '# TODO'
+- name: tests/test_task.py
+  visible: false
+- name: __init__.py
+  visible: false
+- name: tests/__init__.py
+  visible: false

Numpy/Array Indexing and Slicing/Boolean Indexing/task-info.yaml

@@ -0,0 +1,55 @@
+## Boolean Indexing
+
+Boolean arrays used as indices are treated differently from index 
+arrays. Boolean arrays must be of the same shape as the initial dimensions of the array being indexed.
+Such boolean arrays are often referred to as **masks** and the process of indexing other arrays using them
+is called masking, or masked filtering.
+
+```python
+y = np.arange(20).reshape(5, 4)
+b = y % 2 != 0
+print(b)
+print(y[b])
+```
+Output:
+```text
+[[False  True False  True]
+ [False  True False  True]
+ [False  True False  True]
+ [False  True False  True]
+ [False  True False  True]]
+[ 1  3  5  7  9 11 13 15 17 19]
+```
+Unlike in the case of integer index arrays, in the boolean case, the result is a 1-D array 
+containing all the elements in the indexed array corresponding to all the true elements in the boolean array.
+As with index arrays, what is returned is a copy of the data, not a view as one gets with slices.
+
+
+The result will be multidimensional if `y` has more dimensions than `b`. For example, if we use a
+1-D boolean array where the second dimension agrees with that of `b` (just selecting one row from `b`),
+then the columns from `y` corresponding to the `True` values in the 1-D array will be selected:
+```python
+print(b[1, :])
+print(y[:, b[1, :]])
+```
+Output:
+```text
+[False  True False  True]
+[[ 1  3]
+ [ 5  7]
+ [ 9 11]
+ [13 15]
+ [17 19]]
+```
+The 2nd and 4th rows are selected from the indexed array and combined to make a 2-D array.
+
+In general, when the boolean array has fewer dimensions than the indexed array,
+the shape of the result is one dimension containing the number of `True` elements 
+of the boolean array, followed by the remaining dimensions of the indexed array.
+
+For further details, consult the NumPy reference documentation on [array indexing](https://numpy.org/doc/stable/reference/arrays.indexing.html#indexing).
+
+### Task 
+1. Create a 3-D array `a` with integers from 0 to 19 and shape `(2, 2, 5)`.
+2. Filter it using a 2-D boolean array `b` so that the resulting 2-D array `c` has the
+shape `(2, 5)` and contains elements `[ 0  1  2  3  4]` and `[15 16 17 18 19]`.

Numpy/Array Indexing and Slicing/Boolean Indexing/task.md

@@ -0,0 +1,10 @@
+import numpy as np
+
+a = np.arange(20).reshape(2, 2, 5)
+mask = np.array([[True, False], [False, True]])
+c = a[mask]
+
+if __name__ == '__main__':
+    print('Array a:\n', a, '\n')
+    print('Indexed array c:\n', c)
+    print(c.shape)

Numpy/Array Indexing and Slicing/Boolean Indexing/task.py

@@ -0,0 +1,15 @@
+import unittest
+import numpy as np
+
+from task import a, mask, c
+
+
+class TestCase(unittest.TestCase):
+    def test_add(self):
+        test_a = np.arange(20).reshape(2, 2, 5)
+        test_b = np.array([[True, False], [False, True]])
+        np.testing.assert_array_equal(a, test_a, err_msg='Array `a` seems off!')
+        np.testing.assert_array_equal(c, test_a[test_b], err_msg='Array `c` seems off!')
+        np.testing.assert_array_equal(mask, test_b, err_msg='Something wrong with the mask array!')
+
+

Numpy/Array Indexing and Slicing/Boolean Indexing/tests/__init__.py

@@ -1,3 +1,4 @@
 content:
 - Indexing Basics
-- Integer Array Indexing
+- Integer Array Indexing
+- Boolean Indexing