Most basic arc diagram in d3.js

This post describes how to build a very basic arc diagram with d3.js. It represent a very basic network composed of 6 nodes. You can see many other examples in the arc diagram section of the gallery. Learn more about the theory of arc diagrams in

Arc diagram section


  • Data input format is Json. This document explains how to get this format from a classic table.

  • Plotting the nodes is pretty straightforward: a scalePoint() is set to distribute them uniformaly along the X axis. They are then added using a classing append("circle") approach.

  • Drawing links is a bit tricky. Code is highly commented and should allow to understand the basic process.
<!DOCTYPE html>
<meta charset="utf-8">

<!-- Load d3.js -->
<script src=""></script>

<!-- Create a div where the graph will take place -->
<div id="my_dataviz"></div>


// set the dimensions and margins of the graph
var margin = {top: 20, right: 30, bottom: 20, left: 30},
  width = 450 - margin.left - margin.right,
  height = 300 - - margin.bottom;

// append the svg object to the body of the page
var svg ="#my_dataviz")
    .attr("width", width + margin.left + margin.right)
    .attr("height", height + + margin.bottom)
          "translate(" + margin.left + "," + + ")");

// Read dummy data
d3.json("", function( data) {

  // List of node names
  var allNodes ={return})

  // A linear scale to position the nodes on the X axis
  var x = d3.scalePoint()
    .range([0, width])

  // Add the circle for the nodes
      .attr("cx", function(d){ return(x(})
      .attr("cy", height-30)
      .attr("r", 8)
      .style("fill", "#69b3a2")

  // And give them a label
      .attr("x", function(d){ return(x(})
      .attr("y", height-10)
      .text(function(d){ return(})
      .style("text-anchor", "middle")

  // Add links between nodes. Here is the tricky part.
  // In my input data, links are provided between nodes -id-, NOT between node names.
  // So I have to do a link between this id and the name
  var idToNode = {};
  data.nodes.forEach(function (n) {
    idToNode[] = n;
  // Cool, now if I do idToNode["2"].name I've got the name of the node with id 2

  // Add the links
    .attr('d', function (d) {
      start = x(idToNode[d.source].name)    // X position of start node on the X axis
      end = x(idToNode[].name)      // X position of end node
      return ['M', start, height-30,    // the arc starts at the coordinate x=start, y=height-30 (where the starting node is)
        'A',                            // This means we're gonna build an elliptical arc
        (start - end)/2, ',',    // Next 2 lines are the coordinates of the inflexion point. Height of this point is proportional with start - end distance
        (start - end)/2, 0, 0, ',',
        start < end ? 1 : 0, end, ',', height-30] // We always want the arc on top. So if end is before start, putting 0 here turn the arc upside down.
        .join(' ');
    .style("fill", "none")
    .attr("stroke", "black")



Related blocks →