NetSim {spacejamr} | R Documentation |
Simulate a network from a point process or sequence
Description
Simulates a spatial Bernoulli network from a NetSim object using one of six probability law distributions.
Usage
NetSim(point_sim, sif, base_prob, scale, threshold, power)
Arguments
point_sim |
a PointSim object |
sif |
the spatial interaction function to use. Use attenuated to use an attenuated power law; arctan to use an arctangent probability law; decay to use an exponential decay law; or logistic to use a logistic probability law. Default is a standard power law function. |
base_prob |
the theoretical probability that two nodes (points) with distance 0 share a tie. Default is 0.9. |
scale |
a coefficient to multiply the distance by. Default is 1. |
threshold |
if two node exceed this probability, they will be coded as having a tie. Default is 0.5. |
power |
the exponent at which tie probability decays. Default is -2.8. |
Details
The algorithm proceeds in three steps. First, it calculates the distance between simulated points from a PointSim object. Then it calculates the distance between all pairs of points. Finally, it uses a spatial interaction function to calculate that any two point share a tie. If the threshold is exceeded, a tie is created.
Value
A network object of class 'NetSim' and 'igraph' that can be manipulated using the igraph' package.
Author(s)
Darren Colby
Email: dscolby17@gmail.com
References
Butts, Carter T. Spatial models of large-scale interpersonal networks. Dissertation. (2002).
Examples
# Load spacejamr object
data("RI")
ri_points <- PointSim(points = 10, window = RI, seed = 42)
power_law <- NetSim(ri_points, base_prob = 0.92, scale = 1, threshold = 0.5,
power = -2.4)