ImageList Processing¶

This tutorial explains how multiple images can be handled and transformed with the ImageList class.

Note

All operations on an ImageList return a new ImageList. The original ImageList will not be changed.

Load data into an ImageList:¶

1. Load images via files in an ImageList:

In [1]:

from safeds.data.image.containers import ImageList

planes = ImageList.from_files(["data/plane.png", "data/small_plane.png"])
planes

from safeds.data.image.containers import ImageList planes = ImageList.from_files(["data/plane.png", "data/small_plane.png"]) planes

Out[1]:

2. Create an ImageList from multiple Image objects:

In [2]:

from safeds.data.image.containers import Image

plane = Image.from_file("data/plane.png")
small_plane = Image.from_file("data/small_plane.png")

ImageList.from_images([plane, small_plane])

from safeds.data.image.containers import Image plane = Image.from_file("data/plane.png") small_plane = Image.from_file("data/small_plane.png") ImageList.from_images([plane, small_plane])

Out[2]:

Process the image¶

1. Resize the images in the ImageList to have the width 200 and height 200:

In [3]:

planes.resize(200, 200)

planes.resize(200, 200)

Out[3]:

2. Convert the images in the ImageList to grayscale:

In [4]:

planes.convert_to_grayscale()

planes.convert_to_grayscale()

Out[4]:

3. Crop the images in the ImageList to be 200x200 with the top-left corner being at (115, 30):

In [5]:

planes.crop(x=115, y=30, width=200, height=200)

planes.crop(x=115, y=30, width=200, height=200)

Out[5]:

4. Flip the images in the ImageList horizontally (or vertically):

In [6]:

planes.flip_left_and_right()

planes.flip_left_and_right()

Out[6]:

5. Adjust the brightness of the images in the ImageList.

Giving a factor below 1 will result in darker images, a factor above 1 will return brighter images.

In [7]:

planes.adjust_brightness(1.5)

planes.adjust_brightness(1.5)

Out[7]:

6. Adjust the contrast of the images in the ImageList.

Giving a factor below 1 will decrease the contrast of the images, a factor above 1 will increase the contrast of the images.

In [8]:

planes.adjust_contrast(1.5)

planes.adjust_contrast(1.5)

Out[8]:

7. Adjust the color balance of the images in the ImageList.

A factor of 0 will return black and white images, a factor of 1 will return a copy of the original ImageList.

In [9]:

planes.adjust_color_balance(0.5)

planes.adjust_color_balance(0.5)

Out[9]:

8. Blur the images in the ImageList:

The higher the radius, the blurrier the images get. The radius defines the amount of pixels combined in each direction.

In [10]:

planes.blur(5)

planes.blur(5)

Out[10]:

9. Sharpen the images in the ImageList:

The factor defines the sharpness of the returned images.

In [11]:

planes.sharpen(5)

planes.sharpen(5)

Out[11]:

10. Invert the colors of the images in the ImageList:

In [12]:

planes.invert_colors()

planes.invert_colors()

Out[12]:

11. Rotate the images in the ImageList to the right (or the left):

In [13]:

planes.rotate_right()

planes.rotate_right()

Out[13]:

12. Convert the images in the ImageList to grayscale and highlight the edges:

In [14]:

planes.find_edges()

planes.find_edges()

Out[14]:

13. Add noise to the images in the ImageList. A higher standard_deviation will result in noisier images:

In [15]:

planes.add_noise(standard_deviation=0.1)

planes.add_noise(standard_deviation=0.1)

Out[15]: