delta.score: The change on objective function for greedy search...

View source: R/keyplayer.R

delta.scoreR Documentation

The change on objective function for greedy search implimentation

Description

delta.score calculates the change in group centrality score.

Usage

delta.score(
  adj.matrix,
  candidate,
  residual,
  i,
  j,
  type,
  M = Inf,
  T = ncol(adj.matrix),
  method,
  binary = FALSE,
  cmode,
  large = TRUE,
  geodist.precomp = NULL
)

Arguments

adj.matrix

The adjacency matrix of the network.

candidate

An initial set of players selected.

residual

The remaining players in the network without members in the initial set.

i

The specific member in the candidate set to be replaced

j

The specific member in the residual set to replace i in the candidate set

type

Choose type="betweenness" for betweenness centrality, type="closeness" for closeness centrality, type="degree" for degree centraslity, type="diffusion" for diffusion centrality. type="evcent" for eigenvector centrality, type="fragment" for fragmentation centrality, type="mreach.degree" for mreach.degree centrality, and type="mreach.closeness" for mreach.closeness centrality.

M

Positive number indicating the maximum distance between two nodes, above witch the two nodes are considered disconnected. The default is Inf. The option is applicable to mreach.degree, mreach.closeness, fragmentation, and diffusion centralities.

T

Integer indicating the maximum number of iterations of communication process. For diffusion centrality only. In the first iteration, the adjacency matrix is as the input. In the nth iteration, the adjacency matrix becomes the input adjacency matrix to the power of n. By default, T is the network size.

method

Indication of which grouping criterion should be used. method="min" indicates the "minimum" criterion (edge values as distances). method="max" indicates the "maximum" criterion (edge values as non-cummulative strengths). method="add" indicates the "addition" criterion (edge values as cummulative strengths). method="union" indicates the "union" criterion (edge values as probability). By default, the minimun criterion is used for betweenness, closeness, fragmentation, mreach.degree, and mreach.closeness centralities. The maximun criterion is used for degree and eigenvector centralities. The union criterion is used for diffusion centrality.

binary

If TRUE, the adjacency matrix is binarized. If FALSE, the edge values are considered. By default, binary=FALSE

cmode

String indicating the type of centrality being evaluated. The option is applicable to degree, mreach.degree, and mreach.closeness centralities. The default is to report the total degree. cmode="outdegree" and cmode="indegree" refer to indegree and outdegree respectively. If cmode="all", all the three types are reported. The option can also applicable to closeness centrality. See closeness Details section. The default is to use the Gil-Schmidt power index.

large

Logical scalar, whether the computation method for large network is implemented. If TRUE (the default), the method implmented in igraph is used; otherwise the method implemented in sna is used.

geodist.precomp

Geodistance precomputed for the graph to be analyzed (optional).

Value

The change in group centrality score


keyplayer documentation built on Nov. 8, 2023, 9:06 a.m.