d3-force-pod
Component that runs a D3 force simulation and automatically draws circles/lines to an SVG canvas according to a configurable set of nodes, links and forces.
Nodes are prevented from escaping by hard-limiting the coordinates to the boundaries of the canvas.
Quick start
import d3ForcePod from 'd3-force-pod';
or using a script tag
<script src="//unpkg.com/d3-force-pod/dist/d3-force-pod.min.js"></script>
then
d3ForcePod()
.genNodes()
.addForce(d3.forceManyBody())
(<myDOMElement>);
API reference
Method | Description | Default |
---|---|---|
width([number]) | Getter/setter for the canvas width. | window.innerWidth |
height([number]) | Getter/setter for the canvas height. | window.innerHeight |
nodes([array]) | Getter/setter for the list of nodes. Each node should be an object with the following optional properties: { x, y, vx, vy, r } . |
[] |
links([array]) | Getter/setter for the list of lines to draw between node pairs. Each link should follow the syntax: {source: <node index or node obj>, target: <node index or node obj>} . |
[] |
genNodes([object]) | Convenience method for randomly generating nodes. See below for input options and defaults. | |
addForce(fn) | Method to register a D3 force in the system. | |
simulation() | Getter for the underlying simulation object. Can be used as an escape hatch to modify simulation parameters such as alphaDecay. | d3.forceSimulation().alphaDecay(0).velocityDecay(0) |
nodeColor([string or fn]) | Getter/setter for the color accessor of the node circles | #900C3F |
linkColor([string or fn]) | Getter/setter for the color accessor of the link lines | #00008B |
genNodes(options) defaults:
{
density: 0.00025, // nodes/px
xRange: [0, width], // px
yRange: [0, height], // px
radiusRange: [1, 18], // px
velocityRange: [0, 4], // px/tick
velocityAngleRange: [0, 360] // 0=right, 90=down
}