utils_pick: Utilities for picking up points in an image

In pliman: Tools for Plant Image Analysis

Utilities for picking up points in an image

Description

• pick_count() opens an interactive section where the user will be able to click in the image to count objects (points) manually. In each mouse click, a point is drawn and an upward counter is shown in the console. After n counts or after the user press Esc, the interactive process is terminated and the number of counts is returned.

• pick_coord() Picks coordinates from the image

• pick_palette() creates an image palette by picking up color point(s) from the image.

• pick_rgb() Picks up the RGB values from selected point(s) in the image.

Usage

pick_count(
  img,
  n = Inf,
  col = "red",
  viewer = get_pliman_viewer(),
  size = 0.8,
  plot = TRUE,
  verbose = TRUE
)

pick_coords(
  img,
  n = Inf,
  col = "red",
  viewer = get_pliman_viewer(),
  size = 0.8,
  verbose = TRUE
)

pick_rgb(
  img,
  n = Inf,
  col = "red",
  viewer = get_pliman_viewer(),
  size = 0.8,
  plot = TRUE,
  verbose = TRUE
)

pick_palette(
  img,
  n = Inf,
  r = 1,
  shape = "box",
  viewer = get_pliman_viewer(),
  show = "rgb",
  title = "Pick colors in the image",
  index = "B",
  random = TRUE,
  width = 100,
  height = 100,
  col = "red",
  size = 0.8,
  plot = TRUE,
  palette = TRUE,
  verbose = TRUE
)

Arguments

img	An Image object.
n	The number of points of the ⁠pick_*⁠ function. Defaults to Inf. This means that picking will run until the user press Esc.
col, size	The color and size for the marker point.
viewer	The viewer option. If not provided, the value is retrieved using get_pliman_viewer(). This option controls the type of viewer to use for interactive plotting. The available options are "base" and "mapview". If set to "base", the base R graphics system is used for interactive plotting. If set to "mapview", the mapview package is used. To set this argument globally for all functions in the package, you can use the set_pliman_viewer() function. For example, you can run set_pliman_viewer("mapview") to set the viewer option to "mapview" for all functions.
plot	Call a new plot(img) before processing? Defaults to TRUE.
verbose	If TRUE (default) shows a counter in the console.
r	The radius of neighborhood pixels. Defaults to 1.
shape	A character vector indicating the shape of the brush around the selected pixel. It can be "box", "disc", "diamond", "Gaussian" or "line". Defaults to "box". In this case, if 'r = 1', all the 8 surrounding pixels are sampled. Setting to "disc" and increasing the radius (r) will select surrounding pixels towards the format of a sphere around the selected pixel.
show	How to plot in mapview viewer, either ⁠'rgb⁠ or 'index'.
title	The title of the map view when vieweris used.
index	The index to use for the index view. Defaults to 'B'.
random	Randomize the selected pixels? Defaults to TRUE.
width, height	The width and height of the generated palette. Defaults to 100 for both, i.e., a square image of 100 x 100.
palette	Plot the generated palette? Defaults to TRUE.

Value

• pick_count() returns data.frame with the x and y coordinates of the selected point(x).

• pick_rgb() returns a data.frame with the R, G, and B values of the selected point(s).

• pick_palette() returns an object of class Image.

Author(s)

Tiago Olivoto [e-mail]

Examples

if(interactive()){
library(pliman)
img <- image_pliman("soybean_touch.jpg")

# start a counting process
pick_count(img)

# get rgb from point(s)
pick_rgb(img)

# create a palette from point(s)
pick_palette(img)
}

pliman documentation built on Oct. 15, 2023, 1:06 a.m.