electrograph {ElectroGraph}R Documentation

electrograph

Description

Given a sociomatrix or an edge list, produce an electrograph object for display and analysis.

Usage

electrograph(input, symmetric=TRUE, solve.for.shortest.paths=TRUE,
                                        ohmic.properties=TRUE, fidelities=NULL, 
                                        verbose=FALSE, substitute.names=NULL, ...)

Arguments

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.

Details

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.

Value

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?

Author(s)

Andrew C. Thomas <act@acthomas.ca>

Source

Andrew C. Thomas (2010). ``Ohmic Circuit Interpretations of Network Distance and Centrality''. Unpublished: available at http://www.acthomas.ca/.

Examples


sources <- c(1,2,3,4)
sinks <- c(2,3,1,5)
socio <- electrograph(cbind(sources,sinks))


[Package ElectroGraph version 0.2.0 Index]