santoku - a visual introduction

Santoku

A Japanese kitchen knife.

{santoku}

An R package for cutting data.

Some data

head(pts)

##      x   y
## 1  763 359
## 2 1037 253
## 3  989 197
## 4 1048 235
## 5  840 276
## 6  732 123

x <- pts$x

Some data

plot_the_fish()

chop()

chop() is a replacement for base R’s cut() function.

chop()

chop(x, c(300, 600, 900))

extend = FALSE

chop(x, c(300, 600, 900), extend = FALSE)

Chopping by a single value

chop(x, c(300, 500, 500, 800))

chop_width()

Chops fixed-width intervals

chop_width(x, width = 200)

chop_evenly()

Chops intervals equal-width intervals

chop_evenly(x, intervals = 5)

chop_proportions()

Chops intervals by proportions of the data range

chop_proportions(x, proportions = c(0.2, 0.8))

chop_equally()

Chops intervals with an equal number of elements

chop_equally(x, groups = 5)

chop_n()

Chops intervals with a fixed number of elements

chop_n(x, 50)

chop_quantiles()

chop_quantiles(x, c(0.2, 0.8))

Summary

chop_mean_sd()

chop_mean_sd(x)

Changing labels

You need one more labels than breaks:

chop(x, c(300, 600, 900), labels = LETTERS[1:4])

Changing labels

Not sure how many intervals you will have?

Use a lbl_* function.

chop_width(x, 200, labels = lbl_seq())

Changing labels

Not sure how many intervals you will have?

Use a lbl_* function.

chop_width(x, 200, labels = lbl_seq("(i)"))

Changing labels

Not sure how many intervals you will have?

Use a lbl_* function.

chop_width(x, 200, labels = lbl_dash())

Left-closed and right-closed

Breaks are closed on the left by default.

chop(x, c(200, 500, 800))

Left-closed and right-closed

For right-closed breaks use left = FALSE:

chop(x, c(200, 500, 800), left = FALSE)

Errors

Errors

chop_quantiles(c(-Inf, Inf), c(0.25, 0.75))

## [1] [-∞, ∞] [-∞, ∞]
## Levels: [-∞, ∞]

chop_quantiles(1:5, c(0.25, NA))

## Error:
## ! probs contains 1 missing values

Happy chopping!

https://hughjonesd.github.io/santoku

devtools::install_github("hughjonesd/santoku")