I couldn't see a mention of this in the documentation. Does force-graph support multiple edges / self-loops? If not, are there any plans to add support? This would be really useful!

(See top figure on https://en.wikipedia.org/wiki/Multigraph for an example of this kind of visualization)

Hi @vasturiano,

I love your project, especially the nice concise and useful API.

What's the difference between this project and using the other 3-D force graph project with numDimensions = 2? I see this one uses a canvas renderer, and the other uses ThreeJS which in turn uses WebGL, but I though ThreeJS also uses a canvas renderer backup?

The feature-set of the 3D version looks almost the same as the 2D version.

Edit: To be more specific, could I simply use the 3d-force w/ numDimensions = 2 to achieve a nice WebGL-based 2d force rendering?

Hi! And thanks for this amazing lib!

I'm starting my graph with .dagMode('lr') and then trying to disable it with .dagMode(null) without success. That is the null value in the example:
https://github.com/vasturiano/force-graph/blob/master/example/tree/index.html#L20

After sometime I've found out it do disable with .dagMode('null') or any other non-valid dag mode string (like .dagMode('aaaaa').

I guess the example is working because the way it is because the gui select convert null to 'null' automatically. But if the right is 'null', maybe it would be better to fix the example.

Describe the bug
A clear and concise description of what the bug is.
I want to change node drawing after some level of zoom. For this I want to set some threshold level for zoom.
is there any way to set zoom threshold level

on solution I thought that, if some how I can get the zoom level then I can check that zoom level with my threshold value but problem is how do I get current zoom level.

Also please let me know how can I get onwheel event on graph view.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

Describe the bug
A clear and concise description of what the bug is.
I am facing below exception when I try to use sample example.

Uncaught TypeError: selection.interrupt is not a function
at Function.zoom.transform (vendor.js:136361)
at Function.zoom.translateBy (vendor.js:136390)
at adjustCanvasSize (vendor.js:137694)
at Function.init (vendor.js:138036)
at initStatic (vendor.js:150687)
at comp (vendor.js:150681)
at Class.drawNetworkView (vendor.js:605158)
at Class.didInsertElement (vendor.js:605135)
at Class.trigger (vendor.js:67828)
at Class.superWrapper [as trigger] (vendor.js:65474)

To Reproduce
Steps to reproduce the behavior:
I just copy the sample code and try to launch graph view but not able to see any thing due to exception.

I am able to see view when I try to hit yours link
https://vasturiano.github.io/force-graph/example/basic/

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

my sample code attached here.
in my templlate.hbs file I've declared div
and
in my js file I've write below method.
drawNetworkView () {

const N = 80;
const gData = {
  nodes: [...Array(N).keys()].map(i => ({ id: i })),
  links: [...Array(N).keys()]
    .filter(id => id)
    .map(id => ({
      source: id,
      target: Math.round(Math.random() * (id-1))
    }))
};
const NODE_R = 8;
let highlightNodes = [];
let highlightLink = null;
const elem = document.getElementById('graph');
window.ForceGraph()(elem)
  .graphData(gData)
  .nodeRelSize(NODE_R)
  .onNodeHover(node => {
    highlightNodes = node ? [node] : [];
    elem.style.cursor = node ? '-webkit-grab' : null;
  })
  .onLinkHover(link => {
    highlightLink = link;
    highlightNodes = link ? [link.source, link.target] : [];
  })
  .linkWidth(link => link === highlightLink ? 5 : 1)
  .linkDirectionalParticles(4)
  .linkDirectionalParticleWidth(link => link === highlightLink ? 4 : 0)
  .nodeCanvasObjectMode(node => highlightNodes.indexOf(node) !== -1 ? 'before' : undefined)
  .nodeCanvasObject((node, ctx) => {
    // add ring just for highlighted nodes
    ctx.beginPath();
    ctx.arc(node.x, node.y, NODE_R * 1.4, 0, 2 * Math.PI, false);
    ctx.fillStyle = 'red';
    ctx.fill();
  });

}

the control you have over the camera in the move-viewport example is pretty cool.

that said, this particular example made me feel a bit seasick after a couple rotations (a few seconds of watching) https://github.com/vasturiano/force-graph/blob/master/example/move-viewport/index.html

perhaps we could add a README.md to the examples directory https://github.com/vasturiano/force-graph/tree/master/example

that warned new people about the motion in the move-viewport example

Is your feature request related to a problem? Please describe.
I want to show data flowing into a network using the particles system but show something like impulses.

I have a node stream that represent a link in the graph (a connection) and I want to show a particle everytime I send/receive data from it.

Describe the solution you'd like
Could be nice to have something like: pushDirectionalParticle(from, to)

Awesome work btw! thanks!

@vasturiano, how to handle key event in force-graph.

it would be friendly to handle datasets that have and edges key instead of a links key

some code like this has done this for me before

    // be flexible, accept datasets that have
    // edges instead of links
    if (
      typeof data.links === 'undefined' &&
      typeof data.edges !== 'undefined'
    ) {
      data.links = data.edges
      delete data.edges
    }

I want to implement this effect that when click a node it shows more tool like in neo4j browser.

here is my implement:

next, I want to capture the mouse position to know whether it is hover the three tools, and which one. but mouse position in the canvas "mousePos.x" and "mousePos.Y" is not same as the node position.

I want to know how to connect the relationship between mousePos and node's position. so when click a node, it show three tools, and then i can know which tool mouse hovering

Hi,

First off i would like to say that i really like this libary :) The visualisation look amazing. That said i was wondering if it's possible to display the data caption, partial in the node? Like this image:

I'm using this code:

session
.run('MATCH (n)-->(m) RETURN { id: id(n), label:head(labels(n)), caption:n.title } as source, { id: id(m), label:head(labels(m)), caption:m.title } as target LIMIT $limit', {limit: 1000})
.then(function (result) {
const nodes = {}
const links = result.records.map(r => {
var source = r.get('source');source.id = source.id.toNumber();
nodes[source.id] = source;
var target = r.get('target');target.id = target.id.toNumber();
nodes[target.id] = target;
return {source:source.id,target:target.id};
});
session.close();
console.log(links.length+" links loaded in "+(new Date()-start)+" ms.")
const gData = {nodes: Object.values(nodes), links: links}
const Graph = ForceGraph()(elem)
.graphData(gData)
.backgroundColor('#ffffff')
.nodeLabel(node => ${node.label}: ${node.caption})
.onNodeHover(node => elem.style.cursor = node ? 'pointer' : null)
.nodeAutoColorBy('label')
.nodeCanvasObjectMode(() => 'after')
.nodeCanvasObject((node, ctx) => 'label')
.nodeCanvasObject((node, ctx, globalScale) => {
const label = node.caption;
const fontSize = 12/globalScale;
ctx.font = ${fontSize}px Sans-Serif;
const textWidth = ctx.measureText(label).width;
const bckgDimensions = [textWidth, fontSize].map(n => n + fontSize * 0.2); // some padding
ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
ctx.fillRect(node.x - bckgDimensions[0] / 2, node.y - bckgDimensions[1] / 2, ...bckgDimensions);
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.fillStyle = node.color;
ctx.fillText(label, node.x, node.y);
});
});

On the console I keep getting:

[Error] Unhandled Promise Rejection: TypeError: The provided value is non-finite
getImageData (force-graph.min.js:2:96999)
e (force-graph.min.js:2:96999)
init (force-graph.min.js:2:97459)
n (force-graph.min.js:2:44363)
i (force-graph.min.js:2:44325)
(anonymous function) (directional-links:13)
promiseReactionJob

Which relates to:
var t = o.colorTracker.lookup(u.getImageData(s.x, s.y, 1, 1).data);

Looking at the code, it seems to check if pointer interaction is enabled, but even if I disable it, I still get the exception.

I have been using jquery to .hide(), .empty(), and .detach() the div containing the force graph, and when I try to redraw the graph, no mouse pointer events work (on hover tooltip doesn't display, even though it's div and position show in the div) and the style=cursor:point tag isn't fired on the parent div.

Hello! Great library with great performance. I was wondering if there is a way in which I can access to the neighbors of a node when hovering over a node. I a seeking to highlight all the neighbors and links, and achieve this effect: http://plnkr.co/edit/3fv3IR3S3Kp86rAummnz?p=preview

hey @vasturiano
I need to add some operation on node double click?

It would be good, if there is an parameter for visibility. When setting width to a really small value, the link just doesnt appear, but if i have linkLabel on hover, all the links are still there.

hey @vasturiano, If i am adding more then 260 nodes on canvas it shows "Invalid attempt to destructure non-iterable instance" error and "Cannot create property 'vx' on string '#223:21' "('#223:21 is internal id of node')

I'm trying to have my force graph only be zoom-able if a user actively clicks the graph. Right now if i hover over the graph for a period of time, it seems to automatically capture this and forces a user to click outside the graph to be able to scroll the rest of the window. Is there a method I am missing to enable such a feature?

Hi,

I'm working with a fairly large graph (22K nodes and 70K edges) and I'm trying to find the best way of rendering it in the browser. So far I've tried both D3 and Sigma.js, with sigma performing the best, but still with a lot of lag when interacting with the graph.

I tested my data with this component, and it looks promising, but because it's computing the layout it takes too long for my use case. But since my data already includes x and y coordinates for the nodes, I was wondering if it's possible to use the component to render the graph without a iterative layout? Maybe I missed this in some of the examples, but they all seemed to use a computed layout.

Thanks for a great component!

it would be nice to ignore some generated dirs, so that contributors don't accidentally commit them.

	dist/
	node_modules/

I'm trying to use the "text as nodes" example listed in the documentation. However, when I replace .nodeAutoColorBy('group') with .nodeColor(), the text is white and unreadable regardless of what color I attempt to input.

Mouse wheel is used to zoom.

1. One scroll of mouse wheel is zooming in too much. I want to fine tune it so it zooms in less per mouse wheel scroll.

2. Make zooming in smooth. Currently it jumps to final zoom position. I want smooth transition.

Does not work. Only zooms once.

Current code:
https://github.com/Hyssopi/Pokemon-Graph-4
Working sample:
https://hyssopi.github.io/Pokemon-Graph-4/

I am able to create graph view successfully. Now I want to add some external drawing with the graph view.
For this I want canvas context object. How can get this.

for example: In the attached image I have display two rect which is not a part of graph view but I want to display this with graph. How can I archive this.

It will be helpful for me if somehow I can get context object as a global object.

@vasturiano Thanks for all the good work.

I am working on this graph with higher number of nodes. But when i have built it the nodes size is reduced a lot, i have custom sized it in nodeCanvasObject(). There are multiple groups and distance between this groups is increased a lot, which the groups come closer, can you please suggest how to get groups closer?

And the links length is also more, wish to control this, any suggestions ?
And i have fixed div, width and height and want my force graph not to cross those limits. I have checked collision detection example but that is not serving my purpose. Can you please suggest?

Note: have given all group names as "Sample Group" but all of them have different ids

Hi,

The dependency seems to be no longer available via:
<script src="//unpkg.com/force-graph"></script>

I am able to draw sine wave as link with linkCanvasObject. but the particles still move in a straight line. Is any way to draw custom link and let particles move along the link?

while using these together:
.nodeCanvasObject()
.onNodeClick(),
only small center of the canvas can trigger click event, not entire object.

Hi. First of all, amazing library. I enjoy it a lot.

I'm working on a personal project and found a situation in which I want to customize how the links are rendered (by adding a label), but also want to relay on the default rendering mechanism.

I thought it could be interesting to be able to specify that my linkCanvasObject function is not meant to substitute the link rendering, just to be executed and then proceed with the default rendering. Possibly by returning a boolean, for instance. Or maybe specifying a different prop for that, I haven't thought much about it.

If you think that is something worth doing, I could try and make a PR for it.

Hi Vasturiano!

Thanks for your amazing library, super useful!

In some use cases I want to reheat the force simulation after it has started or change some settings on the fly. Often this requires access to the main simulation object, e.g. by saying simulation.alpha(1).restart(), as per d3.

I guess in general it's very useful to be able to access the main simulation object in case you need it. Is this possible or is there a way this can be done or to expose it?

Any help is much appreciated :-)

Hello,

I am wondering if it is possible to show node labels next to nodes just like it is the case in sigma.js?

Thank you in advance!

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
Is it possible if I to use div as a Node. By default node are canvas but I want to use div as a node.
Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

hey @vasturiano can you tell me how can i use different marker icon instead of arrow.

Am using force-graph in my project and i am using 'linkCurvature ' for curve link and ' .linkCanvasObjectMode' and '.linkCanvasObject' for link label but problem is that am not able to get link label on curved links, how can i do so.

Here i share my code.

`

    fetch('../assets/json/miserables.json').then(res => res.json()).then(data => {
      this.Graph = ForceGraph()
      (document.getElementById('graph'))
        .graphData(data)
        .nodeId('id')
        .nodeLabel('name')
        .linkCurvature('curvature')
        .nodeAutoColorBy('group')
        .linkDirectionalArrowLength(1) // 0 off 1 on for arrow
        .linkDirectionalArrowRelPos(function (d) {
          return d.markerPosition; // 0 start, 0.5 middle, 1 end
        })
        .linkDirectionalArrowLength(5)
        .linkDirectionalArrowLength(5)
        .linkCanvasObjectMode(() => 'after')

    .linkCanvasObject((link, ctx) => {
      const MAX_FONT_SIZE = 4;
      const LABEL_NODE_MARGIN = this.Graph.nodeRelSize() * 1.5;
      const start = link.source;
      const end = link.target;
      // ignore unbound links
      if (typeof start !== 'object' || typeof end !== 'object') return;
      // calculate label positioning
      const textPos = Object.assign({},...['x', 'y'].map(c => ({
        [c]: start[c] + (end[c] - start[c]) / 2 // calc middle point
      })));
      const relLink = { x: end.x - start.x, y: end.y - start.y };
      const maxTextLength = Math.sqrt(Math.pow(relLink.x, 2) + Math.pow(relLink.y, 2)) - LABEL_NODE_MARGIN * 2;
      let textAngle = Math.atan2(relLink.y, relLink.x);
      // maintain label vertical orientation for legibility
      if (textAngle > Math.PI / 2) textAngle = -(Math.PI - textAngle);
      if (textAngle < -Math.PI / 2) textAngle = -(-Math.PI - textAngle);
      const label = link.linkType;
      // estimate fontSize to fit in link length
      ctx.font = '1px Sans-Serif';
      const fontSize = Math.min(MAX_FONT_SIZE, maxTextLength / ctx.measureText(label).width);
      ctx.font = `${fontSize}px Sans-Serif`;
      const textWidth = ctx.measureText(label).width;
      const bckgDimensions = [textWidth, fontSize].map(n => n + fontSize * 0.2); // some padding
      // draw text label (with background rect)
      ctx.save();
      ctx.translate(textPos.x, textPos.y);
      ctx.rotate(textAngle);
      ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
      ctx.fillRect(- bckgDimensions[0] / 2, - bckgDimensions[1] / 2, ...bckgDimensions);
      ctx.textAlign = 'center';
      ctx.textBaseline = 'middle';
      ctx.fillStyle = 'darkgrey';
      ctx.setLineDash([5, 5]);
      ctx.fillText(label, 0, 0);
      ctx.restore();
    })

    .nodeCanvasObjectMode(() => 'after')
    .nodeCanvasObject((node, ctx, globalScale) => {
      const label = node.Name;
      const fontSize = 18 / globalScale;
      ctx.font = `${fontSize}px Arial`;
      const textWidth = ctx.measureText(label).width;
      const bckgDimensions = [textWidth, fontSize].map(n => n + fontSize * 0.2); // some padding
      ctx.fillStyle = 'rgba(255, 255, 255, 0.8)';
      ctx.fillRect(node.x - bckgDimensions[0] / 2, node.y - bckgDimensions[1] / 2, ...bckgDimensions);
      ctx.textAlign = 'center';
      ctx.textBaseline = 'middle';
      ctx.fillStyle = node.color;
      // ctx.fillStyle = '#7D8080';
      ctx.fillText(label, node.x, node.y);
    })

   
    .d3Force('collide', d3.forceCollide(30))
    
    .linkColor(function(d){
      return d.color;
    })
    
    .zoom(2)
    .nodeRelSize(10)
    .linkDirectionalParticles(1)
    .linkDirectionalParticleColor(function(){
      return "#6ECF9C";
    })
    .linkDirectionalArrowColor(function(){
      return "#757977";
    })
    .onNodeClick(node => {
      // Center/zoom on node
      this.Graph.centerAt(node.x, node.y, 1000);
      this.Graph.zoom(8, 1500);
    });
});`

I would like to set link forces through d3Force option. The edges have types and I would like to set different link forces to different link types as the README describes: d3Force(str, [fn])

So my code looks like this:

(document.getElementById('canvas'))
  ...
  .d3Force('link', link => isHighPriorityEdge(link.type) ? 25 : 2)

When I load the page, I get JavaScript error, that id.x is not a function.
Have I missed something or how can I set different forces to different links?

Currently, autoColorObjects does not store the colors auto-assigned to categories in state. When incrementally adding nodes to the graph, new categories will therefore be assigned a color already in use by a different type.

Hi, really nice work! This makes dealing with d3 significantly easier! I was wondering what the best way to implement a simple search that highlights desired nodes by name would be? E.g, how could I modify the lower level parts of your code to include search functions like this one - https://bl.ocks.org/jrladd/raw/c76799aa63efd7176bd9006f403e854d/

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
By default in the graph view, nodes would take its own positions. I want to place each node at particular place.

for example by default my graph view look link as shown in attachment "view 1" but I want my default view would be as show in attachment "view 2"

How can I achieve this?

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Describe the bug
Node is not clickable or response to any mouse event if corresponding node object has 'val' property. Using such graph data, if by default, the node will not be drawn. if use nodecanvasobject function, customized things will be drawn but not clickable.

To Reproduce
Steps to reproduce the behavior:
Go to any example, add val property to any node in the graph data

see jsfiddle: https://jsfiddle.net/0b16jmkq/4/

Additional context
the type definition lib: @types/force-graph has a GraphNode type which takes node associated data as 'val', this could be really buggy for the graph and make ppl (like me) debugging why the click is not working for 6 hours.

Thank you very much for the excellent features!
In the docs, there are many event listeners for what concerns nodes and links interactions. However, I see no similar container events for what concerns the graph area on which the components are rendered.
Is there any way to trigger events tied to the graph container, such as creating a node on mouse click with specific coordinates (for example accessing the underlying graph canvas)?

Thanks for the great library! I've found it very useful.

I wanted to point out a possible vulnerability present when visualizin user-submitted data with the library. This is tested with the 2d graph utilities and I'm not sure if it applies to 3d and VR too.

Node and link labels enable embedding HTML content in addition to plain text. In a scenario where the node or label label is user-inputed (for example a username or data scraped online), it is possible to inject javascript that gets executed. A simple example is a node label that contains <img src="aaa" onError="alert('danger')">. The onError callback gets executed and can contain any arbitrary JS. If the graph data is stored on backend this becomes a stored XSS.

The behavior of rendering HTML in labels is not necessarily obvious to a user of this library even when it is documented. I would suggest including a note to the documentation that any user/3rd pary input to labels should be properly sanitized to prevent the issue. As an even more efficient precaution rendering HTML could be behind a flag with the default being just text content though this would require a breaking API change.

More info on XSS vulnerabilities: https://www.owasp.org/index.php/Cross-site_Scripting_(XSS)

Sorry if this is the wrong place for this, but I was wondering if there is an example data structure to use when the graph is set to a DAG layout, specifically 'td'. Not sure if the Force-Graph just detected and laid out the hierarchy based on link connections, or if the data set could be restructured to specify children.

Describe the bug

The final layout of the graph is nearly broken when I try the basic example with my data.

To Reproduce
Steps to reproduce the behavior:

1. Use my HTML code.
2. Load a graph with 5000 nodes and 5000 edges.
3. Use Chrome to browser the HTML.

Expected behavior

A beautiful graph

Screenshots

The final layout looks like this:

Desktop (please complete the following information):

• OS: Win10
• Browser: Chrome 77
• UA: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.90 Safari/537.36

Additional context

My script:

<head>
    <style> body { margin: 0; } </style>

    <script src="//unpkg.com/force-graph"></script>
    <!--<script src="../../dist/force-graph.js"></script>-->
</head>

<body>
<div id="graph"></div>

<script type="text/javascript" src="../data/data.js"></script>
<script>
  let i, s, N = data["nodes"].length, E = data["links"].length;
  let g = {
    nodes: [],
    edges: []
  };
  let h = {}; // Hash table, IP/domain->id

  for (let i = 0; i < N; i++)
  {
    let node = data['nodes'][i]
    h[node['id']] = i.toString();
    g.nodes.push({
      id: i.toString(),
      label: node["id"],
      x: Math.random(),
      y: Math.random(),
      size: 1,
      color: (node["group"] == '0' ? '#ff0000' : '#0099ee')
    })
  }


  for (let i = 0; i < E; i++)
  {
    let edge = data['links'][i]
    g.edges.push({
      id: i.toString(),
      source: h[edge["source"]],
      target: h[edge["target"]],
      color: '#666'
    })
  }

  // Random tree
  const gData = {
    nodes: g.nodes,
    links: g.edges
  };

  const Graph = ForceGraph()
  (document.getElementById('graph'))
    .linkDirectionalParticles(2)
    .graphData(gData);
</script>
</body>

`data.js`` defines a JSON graph with ~5000 nodes and ~5000 edges. As it contains confidential information, I cannot share it in current form.

Hello am using force-graph in my project and need to use context menu on node click, how how do i get that or any alternative ways to do so. thanks .

https://vasturiano.github.io/force-graph/example/dag-yarn/

SyntaxError: Invalid value type 1:37 in lockfile

Hello again!
I was wondering if there is a parameter I can access to in order to configure the sensitivity area of a node when hovering. I want to do this because currently, I am drawing the nodes dynamically, and their size depends on a given feature of a node. I also add labels to the nodes, which are centered. When trying to drag or click the node, I can only do this if I place the cursor over the label, this is, at the center of the node.