boot_dd: Bootstrapping Empirical Degree Distribution

Description Usage Arguments Value References See Also Examples

Description

This function delivers bootstrap estimates of network degree distribution based on an LSMI sample. The bootstrap scheme is non-weighted for seeds (resampling with replacement) and weighted for non-seeds (resampling with replacement, with weights proportional to inverse of the degrees), as described in Section 3.3 by \insertCitethompson_etal_2016;textualsnowboot and in Algorithm 1 by \insertCitegel_etal_2017;textualsnowboot.

Usage

1
boot_dd(x, B = 100, cl = 1)

Arguments

x

a list that is the output of lsmi_dd, i.e., an estimate of the degree distribution together with all degrees of seeds and non-seeds from an LSMI.

B

a positive integer, the number of bootstrap replications to perform. Default is 100.

cl

parameter to specify computer cluster for bootstrapping, passed to the package parallel (default is 1, meaning no cluster is used). Possible values are:

  • cluster object (list) produced by makeCluster. In this case, new cluster is not started nor stopped;

  • NULL. In this case, the function will attempt to detect available cores (see detectCores) and, if there are multiple cores (>1), a cluster will be started with makeCluster. If started, the cluster will be stopped after computations are finished;

  • positive integer defining the number of cores to start a cluster. If cl = 1, no attempt to create a cluster will be made. If cl > 1, cluster will be started (using makeCluster) and stopped afterwards (using stopCluster).

Value

A list object of class "snowboot" consisting of:

fkb

A matrix of dimensions length(x$fk)\timesB with B bootstrap estimates of the degree distribution. The bootstrap estimates are computed according to Equation 1 by \insertCitegel_etal_2017;textualsnowboot, also see \insertCitechen_etal_2018_snowboot;textualsnowboot.

mub

A vector of length B with bootstrapped estimates of the network mean degree. The bootstrap estimates are computed according to Equation 2 by \insertCitegel_etal_2017;textualsnowboot.

fk

A vector with an estimate of the degree distribution, copied from the input x$fk.

mu

An estimate of the mean degree, copied from the input x$mu.

B

The number of bootstrap replications performed.

References

\insertAllCited

See Also

lsmi, lsmi_dd, boot_ci

Examples

1
2
3
net <- artificial_networks[[1]]
lsmiEstimate <- lsmi_dd(net = net, n.seed = 5, n.wave = 3)
bootEstimates <- boot_dd(lsmiEstimate, B = 10)

Nezafati/snowboot documentation built on May 14, 2019, 8:58 a.m.