Usage
d3ForceNetwork(Links, Nodes, Source, Target, Value = NULL, NodeID, Group, height = 600, width = 900, fontsize = 7, linkDistance = 50, linkWidth = "function(d) { return Math.sqrt(d.value); }", charge = -120, linkColour = "#666", opacity = 0.6, zoom = FALSE, parentElement = "body", standAlone = TRUE, file = NULL, iframe = FALSE, d3Script = "http://d3js.org/d3.v3.min.js")
Arguments
Links
a data frame object with the links between the nodes. It should
include the Source
and Target
for each link. These should be
numbered starting from 0. An optional Value
variable can be included
to specify how close the nodes are to one another.
Nodes
a data frame containing the node id and properties of the nodes.
If no ID is specified then the nodes must be in the same order as the Source
variable column in the Links
data frame. Currently only a grouping
variable is allowed.
Source
character string naming the network source variable in the
Links
data frame.
Target
character string naming the network target variable in the
Links
data frame.
Value
character string naming the variable in the Links
data
frame for how wide the links are.
NodeID
character string specifying the node IDs in the Nodes
data frame.
Group
character string specifying the group of each node in the
Nodes
data frame.
height
numeric height for the network graph's frame area in pixels.
width
numeric width for the network graph's frame area in pixels.
fontsize
numeric font size in pixels for the node text labels.
linkDistance
numeric or character string. Either numberic fixed
distance between the links in pixels (actually arbitrary relative to the
diagram's size). Or a JavaScript function, possibly to weight by
Value
. For example:
linkDistance = "function(d){return d.value * 10}"
.
linkWidth
numeric or character string. Can be a numeric fixed width in
pixels (arbitrary relative to the diagram's size). Or a JavaScript function,
possibly to weight by Value
. The default is
linkWidth = "function(d) { return Math.sqrt(d.value); }"
.
charge
numeric value indicating either the strength of the node
repulsion (negative value) or attraction (positive value).
linkColour
character string specifying the colour you want the link
lines to be. Multiple formats supported (e.g. hexadecimal).
opacity
numeric value of the proportion opaque you would like the
graph elements to be.
zoom
logical, whether or not to enable the ability to use the mouse
scroll-wheel to zoom in and out of the graph.
parentElement
character string specifying the parent element for the
resulting svg network graph. This effectively allows the user to specify
where on the html page the graph will be placed. By default the parent
element is body
.
standAlone
logical, whether or not to return a complete HTML document
(with head and foot) or just the script.
file
a character string of the file name to save the resulting graph.
If a file name is given a standalone webpage is created, i.e. with a header
and footer. If file = NULL
then result is returned to the console.
iframe
logical. If iframe = TRUE
then the graph is saved to an
external file in the working directory and an HTML iframe
linking to
the file is printed to the console. This is useful if you are using Slidify
and many other HTML slideshow framworks and want to include the graph in the
resulting page. If you set the knitr code chunk results='asis'
then
the graph will be rendered in the output. Usually, you can use
iframe = FALSE
if you are creating simple knitr Markdown or HTML pages.
Note: you do not need to specify the file name if iframe = TRUE
,
however if you do, do not include the file path.
d3Script
a character string that allows you to specify the location of
the d3.js script you would like to use. The default is
http://d3js.org/d3.v3.min.js.