rimager

The rimager package contains functions that aid in image manipulation and processing.

This package was developed as a project for DSCI-524.

Creators

Name GitHub
Keanna Knebel Keanna-K
Mohammed Salama dataubc
Zhengyang (Zoe) Pan zoepan00
Haoyu (Clara) Su clsu22

To contribute to this project, you must adhere to the terms outlined in our Code of Conduct.

Overview:

Want to edit an image in the shell instead of GUI applications? rimager is a R package that provides a quick and easy way to do some simple image processing and graphic editing. Based on the main needs of graphic editing, the package integrates four functionalities. The functionalities include: reducing the size of an image, cropping an image into a circle, reducing the number of colours in an image, and applying cool filter effects. By inputting the path of the image, users can run any of these functions with one line of code to get the desired image.

Our package in R ecosystem:

There are existing packages to process images. For example magickhere, imagerhere are popular packages that can be used to resize, cut images and apply filters. The goal of this package is either to utilize the existing packages to improve the pre-existing functions or to re-implement code manually. Also it automates the image editing process, producing the altered image by one line of code.

Installation

You can install the development version from GitHub with:

Functions

  • circropper: This function crops the input image into a circle. This can be useful when you want to make icons from images.
  • redusize: This function reduces the dimension of a given image by removing vertical and horizontal seams.
  • imgfilter: This function applies a filter to a given image, altering the visual aesthetic. This includes options to blur and sharpen the image with varying degrees of strength. This filter effect is achieved through the application of a matrix convolution with the filter kernel and original image.
  • reducolor: This function reduces the image colors to get the cartoonized color effect. This can be either white and black images or eight colors images.

Dependencies:

  • R 3.6.1 or greater
    • magick
    • plotrix
    • jpeg
    • OpenImageR

Note: Because some operating systems (Ubuntu-16.04 ‘3.2’, ‘3.3’ ‘3.4’ and macOs-devel) need older version of packages (magick and plotrix) we used in development, we exclude the these OS in R-CMD-check. We got permission on slack.

see: chat on slack for permission

Example

see rimager-Vignette

Package in python

We have a package with the same functionalities in python: pyimager. See here