{"id":2971,"date":"2026-06-01T17:55:49","date_gmt":"2026-06-01T09:55:49","guid":{"rendered":"http:\/\/www.transgeniclearning.com\/blog\/?p=2971"},"modified":"2026-06-01T17:55:49","modified_gmt":"2026-06-01T09:55:49","slug":"how-to-convert-a-numpy-array-to-an-image-with-pillow-464a-56d17b","status":"publish","type":"post","link":"http:\/\/www.transgeniclearning.com\/blog\/2026\/06\/01\/how-to-convert-a-numpy-array-to-an-image-with-pillow-464a-56d17b\/","title":{"rendered":"How to convert a numpy array to an image with Pillow?"},"content":{"rendered":"

Hey there! I’m a supplier of Pillow, the super – cool Python library for image processing. Today, I’m gonna walk you through how to convert a NumPy array to an image using Pillow. Pillow<\/a><\/p>\n

<\/p>\n

First off, let’s understand what we’re dealing with. NumPy is an awesome Python library for numerical operations. It’s great for handling multi – dimensional arrays and matrices. On the other hand, Pillow is a powerful library for working with images in Python. It can open, manipulate, and save many different image file formats.<\/p>\n

So, why would you want to convert a NumPy array to an image? Well, there are tons of reasons. Maybe you’ve been doing some data analysis or machine learning, and you’ve generated a NumPy array that represents an image. Or perhaps you’re working on a computer vision project, and you need to visualize the results in an image format.<\/p>\n

Prerequisites<\/h3>\n

Before we start, make sure you have both NumPy and Pillow installed. You can install them using pip<\/code>. Just open your terminal and run:<\/p>\n

pip install numpy pillow\n<\/code><\/pre>\n
The Basics of NumPy Arrays and Pillow Images<\/h3>\n
A NumPy array is a grid of values, all of the same type. For an image, this grid usually represents the pixels. Each element in the array corresponds to a pixel, and the value of that element represents the color of the pixel.<\/p>\n
Pillow, on the other hand, uses the Image<\/code> class to represent images. An Image<\/code> object has properties like width, height, and mode (e.g., ‘RGB’ for a color image).<\/p>\n
Converting a NumPy Array to a Pillow Image<\/h3>\n
Let’s start with a simple example. Suppose you have a NumPy array that represents a grayscale image. Here’s how you can convert it to a Pillow image:<\/p>\n
import numpy as np\nfrom PIL import Image\n\n# Create a simple NumPy array representing a grayscale image\n# Let's make a 100x100 array filled with random values between 0 and 255\nimage_array = np.random.randint(0, 256, (100, 100), dtype=np.uint8)\n\n# Convert the NumPy array to a Pillow image\nimage = Image.fromarray(image_array)\n\n# Save the image\nimage.save('random_grayscale_image.png')\n<\/code><\/pre>\n
In this code, we first import the necessary libraries: numpy<\/code> and PIL.Image<\/code>. Then we create a 100×100 NumPy array filled with random integers between 0 and 255. The dtype=np.uint8<\/code> is important because Pillow expects the pixel values to be in the range of 0 – 255, and uint8<\/code> (unsigned 8 – bit integer) is the appropriate data type for this.<\/p>\n
Next, we use the Image.fromarray()<\/code> method to convert the NumPy array to a Pillow Image<\/code> object. Finally, we save the image as a PNG file.<\/p>\n
Handling Color Images<\/h3>\n
If you’re working with color images, things are a bit more complicated. A color image in RGB format has three channels: red, green, and blue. So, your NumPy array should have three dimensions: height, width, and 3 (for the three color channels).<\/p>\n
Here’s an example:<\/p>\n
import numpy as np\nfrom PIL import Image\n\n# Create a 100x100 color image array\nimage_array = np.random.randint(0, 256, (100, 100, 3), dtype=np.uint8)\n\n# Convert the NumPy array to a Pillow image\nimage = Image.fromarray(image_array)\n\n# Save the image\nimage.save('random_color_image.png')\n<\/code><\/pre>\n
In this case, we create a 100x100x3 NumPy array, where the third dimension represents the RGB channels. Then we convert it to a Pillow image and save it.<\/p>\n
Dealing with Different Data Types<\/h3>\n
Sometimes, your NumPy array might have a different data type than uint8<\/code>. For example, you might have floating – point values. In that case, you need to convert the data type to uint8<\/code> before converting to a Pillow image.<\/p>\n
Here’s how you can do it:<\/p>\n
import numpy as np\nfrom PIL import Image\n\n# Create a NumPy array with floating - point values\nimage_array = np.random.rand(100, 100)\n\n# Scale the values to the range 0 - 255 and convert to uint8\nscaled_array = (image_array * 255).astype(np.uint8)\n\n# Convert the NumPy array to a Pillow image\nimage = Image.fromarray(scaled_array)\n\n# Save the image\nimage.save('scaled_image.png')\n<\/code><\/pre>\n
In this code, we first create a NumPy array with floating – point values between 0 and 1. Then we scale these values to the range 0 – 255 and convert the data type to uint8<\/code>. Finally, we convert the array to a Pillow image and save it.<\/p>\n
Advanced Techniques<\/h3>\n
If you want to do more complex operations, like resizing the image or changing its color mode, Pillow has a lot of built – in methods.<\/p>\n
For example, let’s say you want to resize the image after converting it from a NumPy array:<\/p>\n
import numpy as np\nfrom PIL import Image\n\n# Create a NumPy array\nimage_array = np.random.randint(0, 256, (100, 100), dtype=np.uint8)\n\n# Convert the NumPy array to a Pillow image\nimage = Image.fromarray(image_array)\n\n# Resize the image\nresized_image = image.resize((200, 200))\n\n# Save the resized image\nresized_image.save('resized_image.png')\n<\/code><\/pre>\n
In this code, we first convert the NumPy array to a Pillow image. Then we use the resize()<\/code> method to change the size of the image to 200×200 pixels. Finally, we save the resized image.<\/p>\n
Conclusion<\/h3>\n
<\/p>\n
Converting a NumPy array to an image with Pillow is a pretty straightforward process. Whether you’re working with grayscale or color images, Pillow provides a simple and efficient way to do it.<\/p>\n
Table Cloth<\/a> As a Pillow supplier, I can offer you high – quality support and resources for all your image – processing needs. If you’re looking to integrate Pillow into your projects, whether it’s for data visualization, computer vision, or any other application, I’d love to have a chat with you. Reach out to me to discuss your requirements and let’s work together to make your projects a success!<\/p>\n
References<\/h3>\n