У чому різниця між require()і library()?

Окрім вже наданих гарних порад, я додам:

Мабуть, найкраще уникати використання, require() якщо ви фактично не будете використовувати значення, яке воно повертається, наприклад, в певному циклі перевірки помилок, такому, як дано Thierry.

У більшості інших випадків краще використовувати library(), оскільки це дасть повідомлення про помилку під час завантаження пакета, якщо пакет недоступний. require()просто вийде з ладу без помилки, якщо пакета немає. Це найкращий час, щоб дізнатися, чи потрібно встановити пакунок (чи, можливо, він навіть не існує, оскільки він написаний неправильно). Якщо отримати зворотний зв'язок з помилками рано та у відповідний час, ви уникнете можливих головних болів із відстеженням того, чому пізніше код не працює при спробі використання підпрограм бібліотеки

У повсякденній роботі не так багато.

Однак, згідно з документацією для обох функцій (доступ до яких ставиться ?перед назвою функції та натисканням клавіші Enter), requireвикористовується всередині функцій, оскільки він видає попередження і продовжується, якщо пакет не знайдеться, тоді як libraryвиникла помилка.

Ще однією перевагою require()є те, що він повертає логічне значення за замовчуванням. TRUEякщо пакунки завантажені, FALSEякщо їх немає.

> test <- library("abc")
Error in library("abc") : there is no package called 'abc'
> test
Error: object 'test' not found
> test <- require("abc")
Loading required package: abc
Warning message:
In library(package, lib.loc = lib.loc, character.only = TRUE, logical.return = TRUE,  :
  there is no package called 'abc'
> test
[1] FALSE

Таким чином, ви можете використовувати require()в таких конструкціях, як нижче. В основному зручно, якщо ви хочете розповсюдити свій код на нашій R-установці, якщо пакети можуть бути не встановлені.

if(require("lme4")){
    print("lme4 is loaded correctly")
} else {
    print("trying to install lme4")
    install.packages("lme4")
    if(require(lme4)){
        print("lme4 installed and loaded")
    } else {
        stop("could not install lme4")
    }
}

Ви можете використовувати, require()якщо ви хочете встановити пакети, якщо і лише за потреби, наприклад:

if (!require(package, character.only=T, quietly=T)) {
    install.packages(package)
    library(package, character.only=T)
}

Для декількох пакетів можна використовувати

for (package in c('<package1>', '<package2>')) {
    if (!require(package, character.only=T, quietly=T)) {
        install.packages(package)
        library(package, character.only=T)
    }
}

Про поради:

• Використовуючи всередині сценарію, ви можете уникнути діалогового екрана, вказавши reposпараметр install.packages(), наприклад,

  install.packages(package, repos="http://cran.us.r-project.org")

• Ви можете обернути require()і library()в suppressPackageStartupMessages(), ну, Придушити повідомлення про завантаженні пакетів програмного забезпечення , а також використовувати параметри , require(..., quietly=T, warn.conflicts=F)якщо це необхідно , щоб зберегти INSTALLs тиші.

Завжди використовуйте library. Ніколи ¹ використання require.

_{( ¹ Майже ніколи. Можливо .)}

У двох словах, це тому, що при використанні requireваш код може дати різні, помилкові результати, не сигналізуючи про помилку . Це рідко, але не гіпотетично! Розглянемо цей код, який дає різні результати залежно від того, чи можна завантажити {dplyr}:

require(dplyr)

x = data.frame(y = seq(100))
y = 1
filter(x, y == 1)

Це може призвести до невірних результатів. Використовуючи libraryзамість того, щоб requireкидати тут помилку, чітко сигналізуючи про те, що щось не так. Це добре .

Це також ускладнює налагодження всіх інших відмов: Якщо ви requireрозпочали пакунок на початку сценарію і використовуєте його експорт у рядку 500, ви отримаєте повідомлення про помилку «об’єкт foo 'не знайдено» у рядку 500, а не помилка "немає пакета з назвою" bla ".

Єдиний прийнятний випадок використання require, коли його повернене значення негайно перевіряється, як показують деякі інші відповіді. Це досить поширена модель, але навіть у цих випадках краще (і рекомендується, див. Нижче) замість цього розділити перевірку існування та завантаження пакета.

Більш технічно, requireнасправді дзвонить libraryвнутрішньо (якщо пакет ще не був приєднаний - requireтаким чином виконується зайва перевірка, оскільки library також перевіряється, чи пакет уже завантажений). Ось спрощена реалізація requireдля ілюстрації того, що він робить:

require = function (package) {
    already_attached = paste('package:', package) %in% search()
    if (already_attached) return(TRUE)
    maybe_error = try(library(package, character.only = TRUE)) 
    success = ! inherits(maybe_error, 'try-error')
    if (! success) cat("Failed")
    success
}

Досвідчені розробники R погоджуються:

Yihui Xie , автор {knitr}, {bookdown} та багатьох інших пакунків, говорить :

Пані, панове, я вже говорив це раніше: вимагати () це неправильний спосіб завантаження пакету R; використовуйте натомість бібліотеку ()

Ходлі Вікхем , автор більш популярних R-пакетів, ніж будь-хто інший

Використання library(x)в сценаріях аналізу даних. […] Ніколи не потрібно використовувати require()( requireNamespace()майже завжди краще)

?library

і ви побачите:

library(package)і require(package)обидва завантажте пакунок з назвою packageта помістіть його у список пошуку. requireпризначений для використання всередині інших функцій; він повертається FALSEта видає попередження (а не помилку, як library()за замовчуванням), якщо пакет не існує. Обидві функції перевіряють та оновлюють список завантажених поточних пакетів і не перезавантажують пакет, який уже завантажений. (Якщо ви хочете перезавантажити такий пакет, зателефонуйте detach(unload = TRUE)або unloadNamespaceспочатку.) Якщо ви хочете завантажити пакет, не вводячи його до списку пошуку, використовуйте requireNamespace.

Моя початкова теорія про різницю полягала в тому, що він libraryзавантажує пакунки, завантажені вони чи ні, тобто він може перезавантажити вже завантажений пакет, при цьому requireпросто перевіряє, чи він завантажений, або завантажує його, якщо його немає (таким чином, використання у функціях які покладаються на певний пакет). Документація, однак, спростовує це і чітко зазначає, що жодна функція не перезавантажить вже завантажений пакет.

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

Я б рекомендував видалити "вимагати" з початку функції, яка працює в 2 мільйони разів у будь-якому випадку, але якщо я чомусь мені потрібно було зберегти її. технічно вимагають швидшої перевірки.

microbenchmark(req = require(microbenchmark), lib = library(microbenchmark),times = 100000)
Unit: microseconds
 expr    min     lq      mean median     uq        max neval
  req  3.676  5.181  6.596968  5.655  6.177   9456.006 1e+05
  lib 17.192 19.887 27.302907 20.852 22.490 255665.881 1e+05