Image Enhancement (R) Project
- 3 mins UBC MDS Project
picfixR
Project Overview
Image enhancement is typically done with a full-scale editing software such as Adobe Photoshop or GIMP, but what if we just want to quickly touch up an image during prototyping in a programming environment?
picfixR allows users to quickly enhance images in an integrated development environment (IDE) (e.g. Jupyter notebook, RStudio) without powering up an image editing software. Users can quickly adjust the sharpness, contrast, and vibrance of .png images, by simply calling the corresponding functions. This package currently offers three essential image enhancement functions, and we hope to implement additional features in the near future.
To install
-
Please ensure you have the devtools package already installed. If not, you can install devtools by running install.packages(“devtools”) at your R console.
-
Check that you have all the required dependencies for this package installed.
-
Install this package by running the following command at your R console.
devtools:: install_github("UBC-MDS/picfixR")To use
library(picfixR)sharpen(): enhance the sharpness of your image
sharpen("cat.png", 8, F, "sharpen/cat_sharpen.png")Arguments:
- input_img: path to an input image
- intensity: level of sharpness adjustment, between 0 and 10, defaults to 5.
- display: print image to console if TRUE, defaults to FALSE.
- output_img: path to save the output image
 |  |
Fig 1: Sharpen picture - before and after
vibrance(): enhance the colour vibrance of your image
vibrance("sharpen/cat_sharpen.png", 10, F, "vibrance/cat_vibrance.png")Arguments:
- input_img: path to an input image
- intensity: level of vibrance adjustment, between -10 and 10, defaults to 5.
- display: print image to console if TRUE, defaults to FALSE.
- output_img: path to save the output image
|  |
Fig 1: Vibrance picture - before and after
contrast(): enhance the contrast of your image
contrast("vibrance/cat_vibrance.png", 1.5, F, "contrast/cat_contrast.png")Arguments:
- input_img: path to an input image
- intensity: level of contrast enhancement, between 0 and 10, defaults to 5.
- display: print image to console if
TRUE, defaults toFALSE. - output_img: path to save the output image
|  |
Fig 1: Contrast picture - before and after
Overall results
|  |
Fig 1: Contrast picture - before and after
Supported image types
- .png
Dependencies
- png
- testit
- plotwidgets
- mmand
Tests and test coverage
Fitting into the R ecosystem
magick provides R with a comprehensive package with an overwhelming amount of functionality for complex image processing. However, even for basic image enhancements, users typically still have to dig into a substantial amount of documentation and implementation details. This project offers a simple alternative, allowing users to have the ability to enhance images quickly during prototyping without the overhead of heavy library resources.
Team Members
Full Project Repository
Related Posts
Mani Kohli
Data Scientist