electrograph {ElectroGraph} | R Documentation |
Given a sociomatrix or an edge list, produce an electrograph object for display and analysis.
electrograph(input, symmetric=TRUE, solve.for.shortest.paths=TRUE, ohmic.properties=TRUE, fidelities=NULL, verbose=FALSE, substitute.names=NULL, ...)
input |
A sociomatrix (n-by-n) or edge list (k-by-(2,3,4). |
symmetric |
Whether the input edge list should be taken as symmetric. |
solve.for.shortest.paths |
If TRUE, calculates the geodesic distances between nodes. |
ohmic.properties |
If TRUE, calculates the Ohmic properties of the network nodes and ties through electrograph.exam. This will be lengthy if the system has a large number of nodes. |
fidelities |
If set, allows for ties that are perceived to be less than ``friends''. (Use with caution – results have not been peer reviewed! |
verbose |
Additional stage-by-stage feedback is given if TRUE. |
substitute.names |
A k-by-2 matrix with one row containing original node designations and the other containing replacement names |
... |
Additional options to be passed to electrograph.exam. |
The input object can have one of four forms: -A square sociomatrix. -An n-by-2 matrix containing social arcs; the individuals in column 1 consider those in column 2 to be friends with social strength 1. By default, this is symmetric. -An n-by-3 matrix containing social arcs; the individuals in column 1 consider those in column 2 to be friends with social strength as described in column 3. By default, this is symmetric. -An n-by-4 matrix containing dyadic arcs. The connection (col1,col2) is described in column 3; the reciprocal connection (col2,col1) is described in column 4. This by nature overrides the option ``symmetric'' to be false unless the input is truly symmetric.
A list, of class ``electrograph'' containing the following items:
grand.sociomatrix |
The full sociomatrix of the system. |
grand.sociomatrices |
A list of sociomatrices of the components of the system. |
component.vector |
The component in which each node is located. |
geodesic |
The full geodesic path length matrix of the system. |
diameters |
The geodesic diameters of each component. |
global.pseudo.diameter |
A sum of all diameters in the set plus the psuedo-diameter bridges required to putatively connect all components. |
symmetric |
Is the resulting sociomatrix symmetric? |
Andrew C. Thomas <act@acthomas.ca>
Andrew C. Thomas (2010). ``Ohmic Circuit Interpretations of Network Distance and Centrality''. Unpublished: available at http://www.acthomas.ca/.
sources <- c(1,2,3,4) sinks <- c(2,3,1,5) socio <- electrograph(cbind(sources,sinks))