soniaLayoutSettings {rSoNIA} | R Documentation |
SoNIA Layout Settings
Description
Parameter settings object that specifies how the dynamic network data should
be binned up to create animations, and what algorithm should be used.
Usage
data(soniaLayoutSettings)
Format
Parameter names with "key" and "value":
- settings.class
- "SettingsClass" "sonia.settings.LayoutSettings"
- slice.aggregation
- "SLICE_AGGREGATION" "Number of i->j ties"
- slice.start
- "SLICE_START" "0"
- slice.duration
- "SLICE_DURATION" "1"
- slice.delta
- "SLICE_DELTA" "1"
- animate.type
- "ANIMATE_TYPE" "cosine animation"
- slice.end
- "SLICE_END" "5"
- layout.type
- "LAYOUT_TYPE" "MultiComp KK Layout"
- attr(*, "class")= chr "sonia.settings"
Details
SoNIA reads its control paramters as sets of grouped key=value pairs that are
included in a batch file or passed in from the command line. Objects of class
sonia.settings
are used to store the values in R so they can be configured if
needed. Do not modify the key (first value) or SoNIA will not recognize the
parameter. The value will either be a numeric string or one of a set of options
givin here or in the SoNIA documentation.
settings.class
- gives the name of this parameter group. DO NOT CHANGE
slice.aggregation
- specifies how ties should be weighted when there are
multiple events within a slice. "Number of i->j ties" = count them and ignore weights,
"Avg of i->j ties" averages the weights, "Sum of i->j ties" adds them together
slice.start
- starting time for animation binning, in data's natural time units
slide.end
- ending time for animation binning
slice.duration
- duration of each slice (a.k.a with of time bin),
in data's natural time units
slice.delta
- offset between start of successive slices. If <
slice.duration
slices will overlap, can be used to make 'rolling bins'
animate.type
- controls how positions are interpolated, for now, just
leave it on "cosine animation"
layout.type
- name of layout algorithm to be used:
"coordinates from original file"
- don't apply layout, useful if nodes
have known coords or coords calculated elsewhere. Uses values passed
in with
vertex.x
and vertex.y
options of link{launchSonia}
"circular layout"
- yup, that is what it does, nodes in arbitrary order.
Usefull only if you want to show dynamics against fixed positions
"FR layout"
- modified implementation of the Fruchterman-Reingold algorithm,
not very useful for dynamic networks, too bouncy.
"random FR layout"
- experimental, probably will crash, pretend it isn't here
"Rubber-Band FR Layout"
- an attempt to limit bouncing by weighting previous
position, pretent it isn't here either.
"MultiComp KK Layout"
- USE ME! I work the best! Kamada-Kawai
spring-embedder layout with modifications for multiple components and weights.
"Moody PI layout"
- node positions based on iterative peer influce, maybe not
so useful here.
"MetricMDS (SVD)?"
- should be metric MDS, but rarely used,
For additional information about these layout algorithms and their parameters,
see javadocs at http://www.stanford.edu/group/sonia/documentation/doc/index.html
Source
see javadoc for SoNIA at http://sonia.stanford.edu/
References
Bender-deMoll, S and McFarland, D.A. (2006) 'The Art and Science of Dynamic Network Visualization' Journal of Social Structure. Volume 7, Number 2. http://www.cmu.edu/joss/content/articles/volume7/deMollMcFarland
Examples
data(soniaLayoutSettings)
## maybe str(soniaLayoutSettings) ; plot(soniaLayoutSettings) ...
[Package
rSoNIA version 0.0-4
Index]