Параметри за замовчуванням

Вступ до написання функцій в R

Richie Cotton

Data Evangelist at DataCamp

Проблеми з toss_coin()

toss_coin <- function(n_flips, p_head) {
  coin_sides <- c("head", "tail")
  weights <- c(p_head, 1 - p_head)
  sample(coin_sides, n_flips, replace = TRUE, prob = weights)
}

Задайте значення за замовчуванням у сигнатурі

toss_coin <- function(n_flips, p_head = 0.5) {
  coin_sides <- c("head", "tail")
  weights <- c(p_head, 1 - p_head)
  sample(coin_sides, n_flips, replace = TRUE, prob = weights)
}

Шаблон із замовчуваннями

my_fun <- function(data_arg1, data_arg2, detail_arg1 = default1) {
  # Do something
}

Інші типи значень за замовчуванням

args(median)

function (x, na.rm = FALSE, ...)

library(jsonlite)
args(fromJSON)

function (txt, simplifyVector = TRUE, simplifyDataFrame = simplifyVector, 
    simplifyMatrix = simplifyVector, flatten = FALSE, ...)

Значення NULL за замовчуванням

За домовленістю це означає:

Функція виконає особливу обробку цього аргументу. Будь ласка, прочитайте документацію.

args(set.seed)

function (seed, kind = NULL, normal.kind = NULL)

Категоріальні значення за замовчуванням

Передайте символьний вектор у сигнатурі.
Викличте match.arg() у тілі.

args(prop.test)

function (x, n, p = NULL, alternative = c("two.sided", "less", "greater"), 
  conf.level = 0.95, correct = TRUE)

У тілі функції

alternative <- match.arg(alternative)

Розбиття вектора за квантилями

cut_by_quantile <- function(x, n, na.rm, labels, interval_type) {
  probs <- seq(0, 1, length.out = n + 1)
  quantiles <- quantile(x, probs, na.rm = na.rm, names = FALSE)
  right <- switch(interval_type, "(lo, hi]" = TRUE, "[lo, hi)" = FALSE)
  cut(x, quantiles, labels = labels, right = right, include.lowest = TRUE)
}

x: Числовий вектор для розбиття
n: Кількість категорій, на які розбити x
na.rm: Чи видаляти пропущені значення?
labels: Підписи категорій (символьні)
interval_type: Відкривати інтервали зліва чи справа?

Маси сердець котів

Стрічкова діаграма мас сердець котів. Діапазон від 3 до 20 грамів.

quantile(cats$Hwt)

    0%    25%    50%    75%   100% 
 6.300  8.950 10.100 12.125 20.500

¹ data(cats, package = "MASS")

Розбиття за квантилями

Стрічкова діаграма з попереднього слайда зафарбована: ліворуч червоні точки, далі зелені, бірюзові та праворуч фіолетові.

cut(x, quantile(x))

Давайте потренуємось!

Вступ до написання функцій в R