.gitignore

node_modules

README.md

Designed by Stephen Few, a bullet chart “provides a rich display of data in a small space.” A variation on a bar chart, bullet charts compare a given quantitative measure (such as profit or revenue) against qualitative ranges (e.g., poor, satisfactory, good) and related markers (e.g., the same measure a year ago). Layout inspired by Stephen Few. Implementation based on work by Clint Ivy, Jamie Love of N-Squared Software and Jason Davies. The "update" button randomizes the values slightly to demonstrate transitions.

app.js

var express = require('express');

var app = express();
app.use('/', express.static(__dirname));

app.listen(3000);

bullet.js

(function() {

// Chart design based on the recommendations of Stephen Few. Implementation
// based on the work of Clint Ivy, Jamie Love, and Jason Davies.
// http://projects.instantcognition.com/protovis/bulletchart/
d3.bullet = function() {
  var orient = "left", // TODO top & bottom
      reverse = false,
      duration = 0,
      ranges = bulletRanges,
      markers = bulletMarkers,
      measures = bulletMeasures,
      showTicks = bulletTicks,
      width = 380,
      height = 30,
      tickFormat = null;

  // For each small multiple…
  function bullet(g) {
    g.each(function(d, i) {
      var rangez = ranges.call(this, d, i).slice().sort(d3.descending),
          markerz = markers.call(this, d, i).slice().sort(d3.descending),
          measurez = measures.call(this, d, i).slice().sort(d3.descending),
          tickz = showTicks.call(this, d, i),
          g = d3.select(this);

      // Compute the new x-scale.
      var x1 = d3.scale.linear()
          .domain([0, Math.max(rangez[0], markerz[0], measurez[0])])
          .range(reverse ? [width, 0] : [0, width]);

      // Retrieve the old x-scale, if this is an update.
      var x0 = this.__chart__ || d3.scale.linear()
          .domain([0, Infinity])
          .range(x1.range());

      // Stash the new scale.
      this.__chart__ = x1;

      // Derive width-scales from the x-scales.
      var w0 = bulletWidth(x0),
          w1 = bulletWidth(x1);

      // Update the range rects.
      var range = g.selectAll("rect.range")
          .data(rangez);

      range.enter().append("rect")
          .attr("class", function(d, i) { return "range s" + i; })
          .attr("width", w0)
          .attr("height", height)
          .attr("x", reverse ? x0 : 0)
        .transition()
          .duration(duration)
          .attr("width", w1)
          .attr("x", reverse ? x1 : 0);

      range.transition()
          .duration(duration)
          .attr("x", reverse ? x1 : 0)
          .attr("width", w1)
          .attr("height", height);

      // Update the measure rects.
      var measure = g.selectAll("rect.measure")
          .data(measurez);

      measure.enter().append("rect")
          .attr("class", function(d, i) { return "measure s" + i; })
          .attr("width", w0)
          .attr("height", height / 2)
          .attr("x", reverse ? x0 : 0)
          .attr("y", height / 4)
        .transition()
          .duration(duration)
          .attr("width", w1)
          .attr("x", reverse ? x1 : 0);

      measure.transition()
          .duration(duration)
          .attr("width", w1)
          .attr("height", height / 2)
          .attr("x", reverse ? x1 : 0)
          .attr("y", height / 4);

      // Update the marker lines.
      var marker = g.selectAll("line.marker")
          .data(markerz);

      marker.enter().append("line")
          .attr("class", "marker")
          .attr("x1", x0)
          .attr("x2", x0)
          .attr("y1", height / 6)
          .attr("y2", height * 5 / 6)
        .transition()
          .duration(duration)
          .attr("x1", x1)
          .attr("x2", x1);

      marker.transition()
          .duration(duration)
          .attr("x1", x1)
          .attr("x2", x1)
          .attr("y1", height / 6)
          .attr("y2", height * 5 / 6);

      if (tickz) {
        // Compute the tick format.
        var format = tickFormat || x1.tickFormat(4);

        // Update the tick groups.
        var tick = g.selectAll("g.tick")
            .data(x1.ticks(4), function(d) {
              return this.textContent || format(d);
            });

        // Initialize the ticks with the old scale, x0.
        var tickEnter = tick.enter().append("g")
            .attr("class", "tick")
            .attr("transform", bulletTranslate(x0))
            .style("opacity", 1e-6);

        tickEnter.append("line")
            .attr("y1", height)
            .attr("y2", height * 7 / 6);

        tickEnter.append("text")
            .attr("text-anchor", "middle")
            .attr("dy", "1em")
            .attr("y", height * 7 / 6)
            .text(format);

        // Transition the entering ticks to the new scale, x1.
        tickEnter.transition()
            .duration(duration)
            .attr("transform", bulletTranslate(x1))
            .style("opacity", 1);

        // Transition the updating ticks to the new scale, x1.
        var tickUpdate = tick.transition()
            .duration(duration)
            .attr("transform", bulletTranslate(x1))
            .style("opacity", 1);

        tickUpdate.select("line")
            .attr("y1", height)
            .attr("y2", height * 7 / 6);

        tickUpdate.select("text")
            .attr("y", height * 7 / 6);

        // Transition the exiting ticks to the new scale, x1.
        tick.exit().transition()
            .duration(duration)
            .attr("transform", bulletTranslate(x1))
            .style("opacity", 1e-6)
            .remove();
      }
    });
    d3.timer.flush();
  }

  // left, right, top, bottom
  bullet.orient = function(x) {
    if (!arguments.length) return orient;
    orient = x;
    reverse = orient == "right" || orient == "bottom";
    return bullet;
  };

  // ranges (bad, satisfactory, good)
  bullet.ranges = function(x) {
    if (!arguments.length) return ranges;
    ranges = x;
    return bullet;
  };

  // markers (previous, goal)
  bullet.markers = function(x) {
    if (!arguments.length) return markers;
    markers = x;
    return bullet;
  };

  // measures (actual, forecast)
  bullet.measures = function(x) {
    if (!arguments.length) return measures;
    measures = x;
    return bullet;
  };

  bullet.width = function(x) {
    if (!arguments.length) return width;
    width = x;
    return bullet;
  };

  bullet.height = function(x) {
    if (!arguments.length) return height;
    height = x;
    return bullet;
  };

  bullet.tickFormat = function(x) {
    if (!arguments.length) return tickFormat;
    tickFormat = x;
    return bullet;
  };

  bullet.duration = function(x) {
    if (!arguments.length) return duration;
    duration = x;
    return bullet;
  };

  return bullet;
};

function bulletRanges(d) {
  return d.ranges;
}

function bulletMarkers(d) {
  return d.markers;
}

function bulletMeasures(d) {
  return d.measures;
}

function bulletTicks(d) {
  return d.ticks;
}

function bulletTranslate(x) {
  return function(d) {
    return "translate(" + x(d) + ",0)";
  };
}

function bulletWidth(x) {
  var x0 = x(0);
  return function(d) {
    return Math.abs(x(d) - x0);
  };
}

})();

bullets.json

[
  {
    "month": "May",
    "signups": 900,
    "indicator": "http://blah.com/",
    "bullets": [
      {"title":"Activation Rate","ranges":[20,60,100],"measures":[83,83],"markers":[89]},
      {"title":"30-day Retention Rate","ranges":[10,40,100],"measures":[56,56],"markers":[52],"ticks":true},
      {"title":"Paid","ranges":[5,10,30],"measures":[11,11],"markers":[8],"ticks":true}
    ]
  },
  {
    "month": "June",
    "signups": 1000,
    "indicator": "http://blah.com/",
    "bullets": [
      {"title":"Activation Rate","ranges":[20,60,100],"measures":[90,90],"markers":[83]},
      {"title":"30-day Retention Rate","ranges":[10,40,100],"measures":[50,50],"markers":[56],"ticks":true},
      {"title":"Paid","ranges":[5,10,30],"measures":[10,10],"markers":[11],"ticks":true}
    ]
  }
]

index.html

<!DOCTYPE html>
<meta charset="utf-8">
<style>

body {
  font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
  margin: auto;
  position: relative;
}

div.month { margin-top: 40px; display: inline-block; }
p.name { padding-left: 160px; font-size: 60% }
p.signups { padding-left: 160px; margin: 0; font-weight: bold; color: #454545 }

.bullet { font: 10px sans-serif; display: block; }
.bullet .marker { stroke: #000; stroke-width: 1px; }
.bullet .tick line { stroke: #666; stroke-width: .5px; }
.bullet .range.s0 { fill: #eee; }
.bullet .range.s1 { fill: #ddd; }
.bullet .range.s2 { fill: #ccc; }
.bullet .measure.s0 { fill: lightsteelblue; }
.bullet .measure.s1 { fill: steelblue; }
.bullet .title { font-size: 14px; font-weight: bold; }
.bullet .subtitle { fill: #666; font-size: 85%; }
.bullet:last { margin-bottom: 20; }

</style>
<script src="http://d3js.org/d3.v3.min.js"></script>
<script src="./bullet.js"></script>
<script>

var margin = {top: 5, right: 40, bottom: 5, left: 160},
    width = 320 - margin.left - margin.right,
    height = 34 - margin.top - margin.bottom;

var chart = d3.bullet()
    .width(width)
    .height(height);

d3.json("bullets.json", function(error, data) {
  var month = d3.select("body").selectAll("div.month")
      .data(data)
    .enter().append("div")
      .attr("class", "month");

  var name = month.append("p")
      .attr("class", "name")
      .text(function(d) { return d.month.toUpperCase(); });

  var signups = month.append("p")
      .attr("class", "signups")
      .text(function(d) { return d.signups + " signups"; });

  var svg = month.selectAll("svg")
      .data(function(d) { return d.bullets; })
    .enter().append("svg")
      .attr("class", "bullet")
      .attr("width", width + margin.left + margin.right)
      .attr("height", function(d) { return height + margin.top + margin.bottom + (d.ticks ? 15 : 0); })
    .append("g")
      .attr("transform", "translate(" + margin.left + "," + margin.top + ")")
      .call(chart);

  var title = svg.append("g")
      .style("text-anchor", "end")
      .attr("transform", "translate(-6," + height * 0.71 + ")");

  title.append("text")
      .attr("class", "title")
      .text(function(d) { return d.measures[0] + "%"; });

  title.append("text")
      .attr("class", "subtitle")
      .attr("dx", "-4em")
      .attr("dy", "-0.1em")
      .text(function(d) { return d.title.toUpperCase(); });
});


</script>

thumbnail.png