[Term Entry] Python NumPy - Built in functions: .resize()

content/numpy/concepts/built-in-functions/terms/resize/resize.md

@@ -0,0 +1,93 @@
+---
+Title: '.resize()'
+Description: 'Resizes an array and returns a new array with the specified size.'
+Subjects:
+  - 'Computer Science'
+  - 'Data Science'
+Tags:
+  - 'Arrays'
+  - 'Functions'
+  - 'NumPy'
+CatalogContent:
+  - 'learn-python-3'
+  - 'paths/data-science'
+---
+
+The NumPy **`.resize()`** function returns a new array with the given shape and size. If the new size is larger than the original, the data is repeated cyclically; if smaller, the data is truncated. This function does not modify the original array.
+
+> **Note:** When only the shape needs to be changed without altering the size, [`.reshape()`](https://www.codecademy.com/resources/docs/numpy/built-in-functions/reshape) is recommended for better performance and clearer intent.
+
+## Syntax
+
+```pseudo
+numpy.resize(a, new_shape)
+```
+
+**Parameters:**
+
+- `a`: The array to resize.
+- `new_shape`: An integer or tuple of integers defining the desired shape. A single integer creates a 1D array of that length, while a tuple defines a multi-dimensional shape.
+
+**Return value:**
+
+- `resized_array`: A new array of the specified shape. If the new size is larger than the original, the data is repeated cyclically. If smaller, the data is truncated. The original array remains unchanged.
+
+## Example
+
+This example demonstrates how to resize a 1D array with 3 elements into a 2D array with 6 elements:
+
+```py
+import numpy as np
+
+# Create a 1D array with 3 elements
+arr = np.array([1, 2, 3])
+
+# Resize the 1D array to a 2D array with 2 rows and 3 columns
+resized_arr = np.resize(arr, (2, 3))
+
+# Print the results
+print("Original array:")
+print(arr)
+print("\nResized array:")
+print(resized_arr)
+```
+
+The output of this code is:
+
+```shell
+Original array:
+[1 2 3]
+
+Resized array:
+[[1 2 3]
+ [1 2 3]]
+```
+
+## Codebyte Example
+
+Run this code to see how `.resize()` works with different sizes and shapes:
+
+```codebyte/python
+import numpy as np
+
+# Create a 1D array with 5 elements
+arr = np.array([11, 22, 33, 44, 55])
+
+# Resize the 1D array to a smaller 1D array with 3 elements
+smaller_arr = np.resize(arr, 3)
+
+# Resize the original 1D array to a larger 2D array with 16 elements
+arr_2d = np.resize(arr, (4, 4))
+
+# Resize the original 1D array to a larger 3D array with 32 elements
+arr_3d = np.resize(arr, (4, 4, 2))
+
+print("Original array:")
+print(arr)
+print("\nSmaller array (truncated elements):")
+print(smaller_arr)
+print("\nLarger 2D array (repeated elements):")
+print(arr_2d)
+print("\nLarger 3D array (repeated elements):")
+print(arr_3d)
+```