ergm.ego (version 0.6.1)

degreedist.egodata: Plotting the degree distribution of an egocentric dataset

Description

A degreedist() method for egodata objects: plot a histogram of the degree distribution of actors in the egocentric dataset, optionally broken down by group and/or compared with a Bernoulli graph.

Usage

# S3 method for egodata
degreedist(
  object,
  freq = FALSE,
  prob = !freq,
  by = NULL,
  brgmod = FALSE,
  main = NULL,
  plot = TRUE,
  weight = TRUE,
  ...
)

Arguments

object

A egodata object.

freq, prob

Whether to plot the raw frequencies or the conditional proportions of the degree values. Defaults to the latter.

by

A character vector giving the name of a vertex attribute; if given, plots the frequences broken down by that attribute.

brgmod

Plot the range of predicted frequencies/probabilities according to a Bernoulli graph having the same expected density as the observed.

main

Main title of the plot.

plot

Whether to plot the histogram; if FALSE, graphical parameters and bgrmod have no effect.

weight

Whether sampling weights should be incorporated into the calculation (TRUE, the default) or ignored (FALSE).

...

Additional arguments to simulate.ergm.ego().

Value

Returns either a vector of degree frequencies/proportions if by=NULL or a matrix with a row for each category if not. If plot==TRUE returns invisibly.

See Also

degreedist, summary

Examples

# NOT RUN {
data(faux.mesa.high)
fmh.ego <- as.egodata(faux.mesa.high)

degreedist(fmh.ego,by="Grade",brgmod=TRUE)
# Compare:
degreedist(faux.mesa.high)

# }