R语言【base】——sample()：随机取样和排列

Package base version 4.2.0

---

Description

sample() 使用替换或不替换从参数【x】的元素中获取指定大小的样本。

---

Usage

sample(x, size, replace = FALSE, prob = NULL)

sample.int(n, size = n, replace = FALSE, prob = NULL,
           useHash = (n > 1e+07 && !replace && is.null(prob) && size <= n/2))

---

Arguments

参数【x】：由一个或多个可供选择的元素组成的向量，或正整数。

参数【n】：一个正数，可供选择的项目的数量。

参数【size】：一个非负整数，给出可供选择的项目的数量。

参数【replace】：抽样是否需要更换？

参数【prob】：一种概率权重向量，用于获得被采样向量的元素。

参数【useHash】：逻辑指示是否应该使用算法的哈希版本。只能用于参数【replace】 = FALSE，参数【prob】 = NULL 和 参数【size】 <= n/2，并且实际上应该用于较大的参数【n】，因为参数【useHash】= FALSE 将使用与n成比例的内存。

---

Details

如果参数【x】的长度为 1，是数值型（在 is.numeric 的意义上）并且参数【x】 >= 1，则通过sample 从 1:x 进行抽样。请注意，当调用（例如 sample(x)）中参数【x】的长度变化时，此便利特性可能会导致不期望的行为。

此外，参数【x】可以是任何长度和整数子集有意义的 R 对象：这些操作的 S3 或 S4 方法将酌情分配。

对于 sample, 参数【size】的默认值是从第一个参数推断出的项数，因此 sample(x) 生成x元素的随机排列(或1:x)。

允许要求 n = 0 或长度为 0 参数【x】的 size = 0 样本，但否则需要 n > 0 或正长度(x)。

参数【n】或参数【x】的非整数正数值将被截断为下一个最小的整数，该整数不得大于 .machine $integer.max。

可选的参数【prob】可用于给出一个权重向量，用于获取被采样向量的元素。它们的和不需要等于 1，但它们不应该是负的，也不应该都是零。

如果参数【replace】为假，则依次应用这些概率，即选择下一个项目的概率与剩余项目中的权重成正比。在这种情况下，非零权重的数量必须至少为参数【size】。

sample.int 是一个裸接口，其中参数【n】和参数【size】都必须以整数形式提供。

参数【n】可以大于 integer 类型的最大整数，不超过 double 类型中可表示的最大整数。只支持均匀采样。使用两个随机数来保证大整数的均匀抽样。

---

Value

对于一个长度为参数【size】的向量，其元素取自参数【x】或整数 1:x。

对于sample.int，长度为参数【size】的整数向量，元素从 1:n 开始，或者当参数【n】大于等于2的31次方时，是双精度向量。