README.md

Gridmap

This is an attempt to create dot grid maps with d3.js.

Dot grid maps could also be done with Kartograph and Gregor Aisch wrote a neat description of what a dot grid map is:

In 1967, the French cartographer Jaques Bertin suggested the use of graduated sizes in a regular pattern as alternative to chroropleth maps.

The most notable advantage is that one no longer need to choose between showing the quantity or density of a distribution, since the regular pattern shows both at the same time: You can compare the density by looking at individual circles while still getting an impression of the total quantity for each department.

For further details refer to Semiology of Graphics, by Jacques Bertin.

---

API

  chart = gridmap()
      .data(data)
      .width(width)
      .height(height)
      .key("id")
      .side(5)
      .isDensity(true)
      .projection(projection)
      .features(features)
      .fill("black");
      
  d3.select("#gridmap").call(chart);

---

Notes

• data is a d3.map() object linking feature names (key) to the associated data. It can be passed in the form of quantity distribution (q) or in the form of density distribution (d), setting isDensity to false or true respectively.
• key is the attribute that identifies the feature (usually an id).
• side is the maximum grid-dot diameter in pixel.
• projection is a d3.geo.projection. Use equal-area projections, dotgrid maps assume the projection preserves area measure.
• some map features may be not covered by any grid-dot, in that case the function adds the features data to the grid-dot nearest to the feature centroid. The density value associated to the grid-dot is calculated as:
  • sum(d * A)/sum(A) in the case data si passed as density distribution
  • sum(q)/sum(A) in the case data si passed as quantity distribution where A is the feature area and the summation runs over the list of features associated to the grid-dot.

---

Resources

• Code for point-in-polygon
• PNPOLY Point Inclusion in Polygon Test (W. Randolph Franklin)
• Point in Polygon Strategies

---

Written with StackEdit.