One Laptop Per Child #D3makeover

.block

license: mit

README.md

WORK IN PROGRESS

Attempt for #d3makeover, presenting data on how many laptops from the One Laptop Per Child (OLPC) project are present in each country.

Code based on djjupa's block: World Map of trust, which I updated to D4 v 4, and includes d3.zoom, with zoom.translateExtent. Also includes d3-tip, based on Micah Stubbs' example.

forked from tomshanley's block: One Laptop Per Child #D3makeover

d3-tip.js

/**
 * d3.tip
 * Copyright (c) 2013 Justin Palmer
 *
 * Tooltips for d3.js SVG visualizations
 */
// eslint-disable-next-line no-extra-semi
;(function(root, factory) {
  if (typeof define === 'function' && define.amd) {
    // AMD. Register as an anonymous module with d3 as a dependency.
    define([
      'd3-collection',
      'd3-selection'
    ], factory)
  } else if (typeof module === 'object' && module.exports) {
    /* eslint-disable global-require */
    // CommonJS
    var d3Collection = require('d3-collection'),
        d3Selection = require('d3-selection')
    module.exports = factory(d3Collection, d3Selection)
    /* eslint-enable global-require */
  } else {
    // Browser global.
    var d3 = root.d3
    // eslint-disable-next-line no-param-reassign
    root.d3.tip = factory(d3, d3)
  }
}(this, function(d3Collection, d3Selection) {
  // Public - contructs a new tooltip
  //
  // Returns a tip
  return function() {
    var direction = d3TipDirection,
        offset    = d3TipOffset,
        html      = d3TipHTML,
        node      = initNode(),
        svg       = null,
        point     = null,
        target    = null

    function tip(vis) {
      svg = getSVGNode(vis)
      if (!svg) return
      point = svg.createSVGPoint()
      document.body.appendChild(node)
    }

    // Public - show the tooltip on the screen
    //
    // Returns a tip
    tip.show = function() {
      var args = Array.prototype.slice.call(arguments)
      if (args[args.length - 1] instanceof SVGElement) target = args.pop()

      var content = html.apply(this, args),
          poffset = offset.apply(this, args),
          dir     = direction.apply(this, args),
          nodel   = getNodeEl(),
          i       = directions.length,
          coords,
          scrollTop  = document.documentElement.scrollTop ||
            document.body.scrollTop,
          scrollLeft = document.documentElement.scrollLeft ||
            document.body.scrollLeft

      nodel.html(content)
        .style('opacity', 1).style('pointer-events', 'all')

      while (i--) nodel.classed(directions[i], false)
      coords = directionCallbacks.get(dir).apply(this)
      nodel.classed(dir, true)
        .style('top', (coords.top + poffset[0]) + scrollTop + 'px')
        .style('left', (coords.left + poffset[1]) + scrollLeft + 'px')

      return tip
    }

    // Public - hide the tooltip
    //
    // Returns a tip
    tip.hide = function() {
      var nodel = getNodeEl()
      nodel.style('opacity', 0).style('pointer-events', 'none')
      return tip
    }

    // Public: Proxy attr calls to the d3 tip container.
    // Sets or gets attribute value.
    //
    // n - name of the attribute
    // v - value of the attribute
    //
    // Returns tip or attribute value
    // eslint-disable-next-line no-unused-vars
    tip.attr = function(n, v) {
      if (arguments.length < 2 && typeof n === 'string') {
        return getNodeEl().attr(n)
      }

      var args =  Array.prototype.slice.call(arguments)
      d3Selection.selection.prototype.attr.apply(getNodeEl(), args)
      return tip
    }

    // Public: Proxy style calls to the d3 tip container.
    // Sets or gets a style value.
    //
    // n - name of the property
    // v - value of the property
    //
    // Returns tip or style property value
    // eslint-disable-next-line no-unused-vars
    tip.style = function(n, v) {
      if (arguments.length < 2 && typeof n === 'string') {
        return getNodeEl().style(n)
      }

      var args = Array.prototype.slice.call(arguments)
      d3Selection.selection.prototype.style.apply(getNodeEl(), args)
      return tip
    }

    // Public: Set or get the direction of the tooltip
    //
    // v - One of n(north), s(south), e(east), or w(west), nw(northwest),
    //     sw(southwest), ne(northeast) or se(southeast)
    //
    // Returns tip or direction
    tip.direction = function(v) {
      if (!arguments.length) return direction
      direction = v == null ? v : functor(v)

      return tip
    }

    // Public: Sets or gets the offset of the tip
    //
    // v - Array of [x, y] offset
    //
    // Returns offset or
    tip.offset = function(v) {
      if (!arguments.length) return offset
      offset = v == null ? v : functor(v)

      return tip
    }

    // Public: sets or gets the html value of the tooltip
    //
    // v - String value of the tip
    //
    // Returns html value or tip
    tip.html = function(v) {
      if (!arguments.length) return html
      html = v == null ? v : functor(v)

      return tip
    }

    // Public: destroys the tooltip and removes it from the DOM
    //
    // Returns a tip
    tip.destroy = function() {
      if (node) {
        getNodeEl().remove()
        node = null
      }
      return tip
    }

    function d3TipDirection() { return 'n' }
    function d3TipOffset() { return [0, 0] }
    function d3TipHTML() { return ' ' }

    var directionCallbacks = d3Collection.map({
          n:  directionNorth,
          s:  directionSouth,
          e:  directionEast,
          w:  directionWest,
          nw: directionNorthWest,
          ne: directionNorthEast,
          sw: directionSouthWest,
          se: directionSouthEast
        }),
        directions = directionCallbacks.keys()

    function directionNorth() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.n.y - node.offsetHeight,
        left: bbox.n.x - node.offsetWidth / 2
      }
    }

    function directionSouth() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.s.y,
        left: bbox.s.x - node.offsetWidth / 2
      }
    }

    function directionEast() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.e.y - node.offsetHeight / 2,
        left: bbox.e.x
      }
    }

    function directionWest() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.w.y - node.offsetHeight / 2,
        left: bbox.w.x - node.offsetWidth
      }
    }

    function directionNorthWest() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.nw.y - node.offsetHeight,
        left: bbox.nw.x - node.offsetWidth
      }
    }

    function directionNorthEast() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.ne.y - node.offsetHeight,
        left: bbox.ne.x
      }
    }

    function directionSouthWest() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.sw.y,
        left: bbox.sw.x - node.offsetWidth
      }
    }

    function directionSouthEast() {
      var bbox = getScreenBBox()
      return {
        top:  bbox.se.y,
        left: bbox.se.x
      }
    }

    function initNode() {
      var div = d3Selection.select(document.createElement('div'))
      div
        .style('position', 'absolute')
        .style('top', 0)
        .style('opacity', 0)
        .style('pointer-events', 'none')
        .style('box-sizing', 'border-box')

      return div.node()
    }

    function getSVGNode(element) {
      var svgNode = element.node()
      if (!svgNode) return null
      if (svgNode.tagName.toLowerCase() === 'svg') return svgNode
      return svgNode.ownerSVGElement
    }

    function getNodeEl() {
      if (node == null) {
        node = initNode()
        // re-add node to DOM
        document.body.appendChild(node)
      }
      return d3Selection.select(node)
    }

    // Private - gets the screen coordinates of a shape
    //
    // Given a shape on the screen, will return an SVGPoint for the directions
    // n(north), s(south), e(east), w(west), ne(northeast), se(southeast),
    // nw(northwest), sw(southwest).
    //
    //    +-+-+
    //    |   |
    //    +   +
    //    |   |
    //    +-+-+
    //
    // Returns an Object {n, s, e, w, nw, sw, ne, se}
    function getScreenBBox() {
      var targetel   = target || d3Selection.event.target

      while (targetel.getScreenCTM == null && targetel.parentNode == null) {
        targetel = targetel.parentNode
      }

      var bbox       = {},
          matrix     = targetel.getScreenCTM(),
          tbbox      = targetel.getBBox(),
          width      = tbbox.width,
          height     = tbbox.height,
          x          = tbbox.x,
          y          = tbbox.y

      point.x = x
      point.y = y
      bbox.nw = point.matrixTransform(matrix)
      point.x += width
      bbox.ne = point.matrixTransform(matrix)
      point.y += height
      bbox.se = point.matrixTransform(matrix)
      point.x -= width
      bbox.sw = point.matrixTransform(matrix)
      point.y -= height / 2
      bbox.w = point.matrixTransform(matrix)
      point.x += width
      bbox.e = point.matrixTransform(matrix)
      point.x -= width / 2
      point.y -= height / 2
      bbox.n = point.matrixTransform(matrix)
      point.y += height
      bbox.s = point.matrixTransform(matrix)

      return bbox
    }

    // Private - replace D3JS 3.X d3.functor() function
    function functor(v) {
      return typeof v === 'function' ? v : function() {
        return v
      }
    }

    return tip
  }
// eslint-disable-next-line semi
}));

index.html

<!DOCTYPE html>
<meta charset="utf-8">
<style>
  
  body {
    font-family: sans-serif;
  }
  
  h1, a {
    color: darkturquoise;
  }
  
  .legend {
    font-size: 12px;
  }
  
  .sea {
    fill: black;
  }

  .land {
    fill: #999999;
    opacity: .5;
  }

  .boundary {
    fill: none;
    stroke: lightgrey;
    stroke-linejoin: round;
    stroke-linecap: round;
  }
  
  circle {
    opacity: 0.5;
    fill: turquoise;
    stroke: darkturquoise;
  }
  
  circle:hover {
    opacity: 0.8;
  }
  
  /* Tooltip CSS */
  .d3-tip {
    line-height: 1.5;
    font-weight: 400;
    font-family: sans-serif;
    padding: 6px;
    background: rgba(0, 0, 0, 0.9);
    color: #FFA500;
    border-color: turquoise;
    border-width: turquoise;
    border-radius: 1px;
    pointer-events: none;
  }

  /* Creates a small triangle extender for the tooltip */
  .d3-tip:after {      
    box-sizing: border-box;
    display: inline;
    font-size: 8px;
    width: 100%;
    line-height: 1.5;
    color: rgba(0, 0, 0, 0.6);
    position: absolute;
    pointer-events: none;
    
  }

  /* Northward tooltips */
  .d3-tip.n:after {
    content: "\25BC";
    margin: -1px 0 0 0;
    top: 100%;
    left: 0;
    text-align: center;
  }

  /* Eastward tooltips */
  .d3-tip.e:after {
    content: "\25C0";
    margin: -4px 0 0 0;
    top: 50%;
    left: -8px;
  }

  /* Southward tooltips */
  .d3-tip.s:after {
    content: "\25B2";
    margin: 0 0 1px 0;
    top: -8px;
    left: 0;
    text-align: center;
  }

  /* Westward tooltips */
  .d3-tip.w:after {
    content: "\25B6";
    margin: -4px 0 0 -1px;
    top: 50%;
    left: 100%;
  }

</style>

<script src="https://d3js.org/d3.v4.min.js"></script>
<script src="http://d3js.org/topojson.v1.min.js"></script>
<script src="d3-tip.js"></script>
<body>
  <h1>One Laptop Per Child (#D3makeover)</h1>
  <p>The circles represent the number of laptops from the One Laptop Per Child (OLPC) project are present in each country, per capita.</p>
  <div id="map"></div>
  <p>Legend (laptops per capita):</p>
  <div id="legend"></div>
  <p>Source: <a href="http://one.laptop.org/map">One Laptop Per Child</a></p>
<script>
 
const format = d3.format(',');
  
const tip = d3.tip()
  .attr('class', 'd3-tip')
  .offset([0, -10])
  .html(function(d){
    return "<strong>Country: </strong><span class='details'>" + d.country
      + "<br></span><strong>Laptop per capita: </strong><span class='details'>" + roundNumber(d.percapita) + "</span>"
    + "<br></span><strong>Total laptops: </strong><span class='details'>" + format(d.count) + "</span>";
  });
  

var width = 900,
    height = 500;

var projection = d3.geoEquirectangular()
    .translate([width / 2, height / 2])
    .scale(width / 2 / Math.PI);

var zoom = d3.zoom()
  .scaleExtent([1, 8])
  .translateExtent([[0,0],[width,height]])
  .on("zoom", zoomed); 
 
var path = d3.geoPath()
  .projection(projection);

var svg = d3.select("#map").append("svg")
  .attr("width", width)
  .attr("height", height);
  
svg.call(tip);

var g = svg.append("g").attr("class","map").call(zoom);
  
g.append("rect")
  .attr("class", "sea")
  .attr("x",0)
  .attr("y",0)
  .attr("width",width)
  .attr("height",height);

d3.json("world-50m.json", function(error, world) {
  
  g.append("path")
    .datum(topojson.feature(world, world.objects.countries))
    .attr("class", "land")
    .attr("d", path);

  g.append("path")
    .datum(topojson.mesh(world, world.objects.countries, function(a, b) { return a !== b; }))
    .attr("class", "boundary")
    .attr("d", path);
      
  d3.csv("olpc.csv", convertTextToNumbers, function(error, data) {
    
    data.sort(function (a,b) {return d3.descending(a.percapita, b.percapita); });
    
    var radius = d3.scaleSqrt()
    .domain([0,d3.max(data, function(d){ return d.percapita; })])
    .range([5,30]);
    
    var circles = g.append("g").attr("class","circles");
        
    circles.selectAll("circle")
	  	.data(data)
	    .enter()
      .append("circle")
      .attr("cx", function(d){ 
      	return projection([d.longitude, d.latitude])[0]; 
    	})
      .attr("cy", function(d){ 
      	return projection([d.longitude, d.latitude])[1]; 
    	})
      .attr("r", function(d){ return radius(d.percapita); })
      .on('mouseover', function(d){
        tip.direction('w').show(d);
        d3.select(this).style('stroke-width', 3);
      })
      .on('mouseout', function(d){
        tip.hide(d);
        d3.select(this).style('stroke-width',0.3);
      });
		
    var legendWidth = 400;
    var legendHeight = 75;
    var legendData = [1,10,50,100,200];
    var legendDataLength = legendData.length;
    var legendOffset = 10;
    
   	var legend = d3.select("#legend").append("svg")
      .attr("width", legendWidth)
      .attr("height", legendHeight);
    
     var legendCircles = legend.selectAll("circle")
      .data(legendData)
      .enter()
    	.append("g")
    	.attr("transform", function(d,i) {
        let j = 0;
        var x = (legendOffset * (1 + i));
        for (j; j < i; j++ ){
          x = x + (2 * radius(legendData[j]));
        };
        return "translate(" + x + "," + (legendHeight/2) + ")"; 
      });
    
    legendCircles.append("circle")
      .attr("cx", 0)
      .attr("cy", 0)
      .attr("r", function(d){ return radius(d); });
    
    legendCircles.append("text")
    	.text(function(d){return d;})
    	.attr("class", "legend")
      .attr("x", 0)
      .attr("y", "0.35em")
    	.style("text-anchor", "middle")
      .style("fill", "#000")
  
  });
  
});

  function zoomed() {
    var transform = d3.zoomTransform(this);
    g.attr("transform", "translate(" + transform.x + "," + transform.y + ") scale(" + transform.k + ")");
  };
  
  
  function roundNumber(n){
    const precision = 1000;
    var roundedNumber = Math.round(n*precision);
    return roundedNumber/precision;
  };
  
  function convertTextToNumbers(d) {
    d.count = +d.count;
    d.pop = +d.pop;
    d.percapita = +d.percapita;
    return d;
  };

</script>

olpc.csv

world-50m.json