Two ways to compress your images!
This Python package specializes in reducing the size of images. It contains three main functions :crop(), compress() and image_size(). The crop() function reduces the size of an image by reducing the height and width of the image to the size specified by the user. The compress() function reduces the file size of an image by reducing the number of bits used in each colour channel of the image. The image_size function simply calculates and returns the size in bytes of the image passed into it. The size returned is then used to check whether the compress() function did its job correctly or not. The package could be used by people to reduce the size of images (dimensions or file size), which could then be uploaded to social media platforms or other websites and applications.
crop(img_path, H, W)- Description: This function will reduce the image to the specified size removing rows and columns of pixels from the borders.
- Input:
- img_path (string, file path to a
pngimage) - H (integer, desired height of the cropped image)
- W (integer, desired width of the cropped image)
- img_path (string, file path to a
- Output:
- string, file path to cropped image (
pngimage with sizeH x W)
- string, file path to cropped image (
compress(image, b)- Description: This function compresses the image by reducing the number of bits for each channel based on user input.
- Input:
- img_path (string, file path to a
pngimage) - b (integer, range [1, 8] (number of bits used for each channel in the compressed image))
- img_path (string, file path to a
- Output:
- string, file path to compressed image (compressed
pngimage )
- string, file path to compressed image (compressed
image_size(image)- Description: Calculates and returns the size of an image in bytes.
- Input:
- img_path (string, file path to a
pngimage)
- img_path (string, file path to a
- Output:
- size (integer, size of the image in bytes)
To install this package, use the following command:
pip install git+https://github.com/UBC-MDS/image-compression-toolkit-python.git
| Task | In a Script (after, import imageCompress) |
|---|---|
Crop image.png to size 10 X 15 |
imageCompress.crop("..//image.png", H = 10, W = 15) |
Compress an image.png to 5 bits per channel |
imageCompress.compress("..//image.png", b = 5) |
Get the size of image.png |
imageCompress.image_size("..//image.png") |
There already are packages for image processing in R and Python:
The existing packages are very comprehensive and provide many functions such as transformations, filters, file conversions and other advanced functions. Our package focuses specifically on image compression and reducing image size using K-means Clustering. This package is not a wrapper or an improvement of an existing package. It simply uses an unsupervised learning algorithm (K-means clustering) to reduce the number of bits used to represent an image.