Learn D3.js: From First Principles to Visualization Master

Goal: Deeply understand the mechanics of D3.js—moving beyond “copy-pasting examples” to mastering the Data-Join, the coordinate geometry of SVG/Canvas, and the mathematics of scales. You will learn to treat the browser as a high-performance drawing canvas where data directly drives the document, enabling you to build any custom visualization imaginable.

Why D3.js Matters

In 2011, Mike Bostock, Vadim Ogievetsky, and Jeffrey Heer released D3.js (Data-Driven Documents) as a successor to Protovis. Unlike previous libraries that provided “black box” charts, D3 was radical: it provided the building blocks to bind arbitrary data to the Document Object Model (DOM) and apply data-driven transformations.

  • Total Control: D3 doesn’t give you a “BarChart” class. It gives you the power to create a rect for every data point.
  • The Standard: Almost every high-end interactive graphic in the New York Times, The Guardian, or Reuters is built with D3.
  • Web Standards Alignment: D3 doesn’t have its own drawing language; it uses HTML, SVG, and CSS. Learning D3 makes you a master of the modern web stack.
  • Performance: By providing direct access to SVG and Canvas, D3 allows for highly optimized visualizations that can handle thousands of elements with smooth transitions.

Core Concept Analysis

1. The Data Join (The “Secret Sauce”)

The most misunderstood part of D3 is the Data Join. It’s not just “drawing data”; it’s a declarative way to synchronize a collection of data with a collection of DOM elements.

Data Array: [A, B, C]          DOM Elements: [<rect>, <rect>]
      │                             │
      └───────────┬─────────────────┘
                  │
        ┌─────────┴─────────┐
        ▼                   ▼
    ENTER Set           EXIT Set           UPDATE Set
  (Data with no       (Elements with     (Data with matching
   matching element)   no matching data)  element)
      [C]                 None               [A, B]

2. Selections: The Foundation

D3 uses a CSS-like selector engine but adds the ability to store data inside the DOM nodes (using the __data__ property).

d3.selectAll("p")    // 1. Select nodes
  .data([4, 8, 15])  // 2. Bind data
  .style("font-size", d => d + "px"); // 3. Use data to drive attributes

3. Scales: Mapping Data Space to Screen Space

Scales are functions that map from a Domain (your data values) to a Range (pixel values on screen).

Data Domain: [0, 100] (degrees Celsius)
       │
   [Scale Function]
       │
Pixel Range: [0, 500] (pixels wide)

Input 50 -> Output 250px

4. SVG vs. Canvas: Two Paths to Pixels

Feature SVG (Scalable Vector Graphics) Canvas (HTML5 Canvas)
Structure DOM-based (Elements like <circle>) Pixel-based (Immediate mode)
Styling CSS and Attributes JavaScript API
Interactivity Event listeners on individual shapes One listener on the whole canvas (manual hit detection)
Performance Good up to ~1,000-5,000 elements Excellent for 10,000+ elements

Concept Summary Table

Concept Cluster What You Need to Internalize
Declarative Binding Data is not “pushed” to elements; elements are “bound” to data. The join determines what stays, goes, or updates.
Mathematical Mappings Visualization is just geometry. Scales translate your business logic (dollars, years) into pixel math.
Coordinate Geometry In SVG/Canvas, (0,0) is the top-left. You must master the math of inversions and offsets.
Interactive State Interactivity is just updating the data binding and letting D3 recalculate the visual properties.
The “Path” Power Complex shapes (maps, links, areas) are just one long string in a d attribute. D3 generators write these strings for you.

Deep Dive Reading by Concept

This section maps each concept from above to specific book chapters for deeper understanding. Read these before or alongside the projects to build strong mental models.

Foundations & Selections

Concept Book & Chapter
Selections & DOM D3.js in Action (3rd Ed) by Anne Meeks — Ch. 2: “Manipulating the DOM”
The Data Join Interactive Data Visualization for the Web (2nd Ed) by Scott Murray — Ch. 6: “Drawing with Data”
Data Loading Interactive Data Visualization for the Web (2nd Ed) by Scott Murray — Ch. 5: “Data”

Geometry & Layout

Concept Book & Chapter
Scales Interactive Data Visualization for the Web (2nd Ed) by Scott Murray — Ch. 7: “Scales”
Axes Interactive Data Visualization for the Web (2nd Ed) by Scott Murray — Ch. 8: “Axes”
Shapes (Lines/Arcs) D3.js in Action (3rd Ed) by Anne Meeks — Ch. 4: “Drawing lines, curves, and arcs”
SVG vs Canvas D3.js in Action (3rd Ed) by Anne Meeks — Ch. 14: “Rendering visualizations with Canvas”

Advanced Mechanics

Concept Book & Chapter
Hierarchies D3.js in Action (3rd Ed) by Anne Meeks — Ch. 11: “Hierarchical visualizations”
Networks/Force Interactive Data Visualization for the Web (2nd Ed) by Scott Murray — Ch. 13: “Layouts” (Force section)
Geo/Projections D3.js in Action (3rd Ed) by Anne Meeks — Ch. 13: “Geospatial information visualizations”

Essential Reading Order

For maximum comprehension, read in this order:

  1. The Mental Model (Week 1):
    • Murray Ch. 1-6 (Focus on the Enter/Update/Exit pattern)
  2. The Graphics Engine (Week 2):
    • Murray Ch. 7-9 (Scales, Axes, and basic Interactivity)
  3. Advanced Shapes (Week 3):
    • Meeks Ch. 4-5 (Mastering the path element and specialized layouts)

Project List

Projects are ordered from fundamental understanding to advanced implementations.

Project 1: SVG Coordinate Explorer

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 2: Practical but Forgettable
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 1: Beginner
  • Knowledge Area: SVG Geometry / Coordinate Systems
  • Software or Tool: D3.js (v7)
  • Main Book: “Interactive Data Visualization for the Web” by Scott Murray

What you’ll build: A tool where clicking anywhere on an SVG canvas draws a point, labels its coordinates, and draws a dashed line back to the (0,0) origin.

Why it teaches D3: It forces you to understand the SVG coordinate system (y-down) and how D3 selections work on a raw canvas before you even touch a dataset. You’ll learn to handle “raw” DOM events through the D3 lens.

Core challenges you’ll face:

  • The Y-Axis Inversion → maps to learning that positive Y goes down
  • Coordinate normalization → maps to handling clicks inside a container with padding/margins
  • Dynamic Text Labeling → maps to positioning SVG text elements relative to parent shapes

Key Concepts:

  • SVG Coordinate System: “SVG Essentials” Ch. 3 - J. David Eisenberg
  • D3 Pointer handling: d3.pointer(event) - D3 Documentation

Difficulty: Beginner Time estimate: Weekend Prerequisites: Basic HTML/JS

Real World Outcome

You’ll have a blank workspace that reacts to your mouse. Every click creates a permanent visual record of where it happened, helping you “feel” the pixel space.

Example Output:

  • User clicks at middle-right.
  • A red circle appears at x: 400, y: 300.
  • A text label says “(400, 300)”.
  • A gray dashed line connects (0,0) to (400, 300).

The Core Question You’re Answering

“Where is (0,0) and how do I accurately place a shape exactly where I want it?”

Before you write any code, sit with this question. Most CSS developers are used to document flow (elements pushing each other). In D3/SVG, everything is absolute positioning. If you don’t master the coordinate math, your charts will always be slightly “off”.

Concepts You Must Understand First

Stop and research these before coding:

  1. SVG ViewBox vs Width/Height
    • What happens if the width is 500 but the viewBox is “0 0 100 100”?
    • Book Reference: “SVG Essentials” Ch. 3 - J. David Eisenberg
  2. D3 Selections (append/attr)
    • How do you add an element to the DOM using D3?
    • How do you set attributes like cx and cy?
    • Book Reference: “Interactive Data Visualization for the Web” Ch. 6

Questions to Guide Your Design

Before implementing, think through these:

  1. Geometry Management
    • If I click at the very bottom-right, will my text label be cut off?
    • How do I clear the canvas if it gets too crowded?
  2. Event Handling
    • Should I listen for clicks on the svg element or a background rect? (Hint: clicks on empty space in SVG don’t always fire unless there’s a background).

Thinking Exercise

The Origin Trace

Trace the following logic in your head:

  1. SVG is 800x600.
  2. User clicks at the exact center.
  3. You draw a line from x1=0, y1=0 to x2=?, y2=?.
  4. You draw a circle at cx=?, cy=?.

Questions while tracing:

  • What happens if I resize the browser window?
  • Does d3.pointer(event) give me coordinates relative to the screen or the SVG?

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “How does the SVG coordinate system differ from the standard Cartesian plane?”
  2. “How do you handle mouse events in D3.js?”
  3. “What is the difference between an attribute and a style in SVG?”
  4. “How do you prevent SVG elements from overlapping?”
  5. “What is viewBox and why is it useful for responsive design?”

Hints in Layers

Hint 1: The Setup Start by creating a simple HTML file with an <svg> tag. Give it a border so you can see its boundaries.

Hint 2: The Listener Use d3.select("svg").on("click", function(event) { ... }). Inside the function, use d3.pointer(event) to get the [x, y] array.

Hint 3: Drawing Inside the click listener, use d3.select(this).append("circle") and chain .attr("cx", x).attr("cy", y). Repeat for the line and text.

Hint 4: Debugging If your clicks are offset, check if your SVG has CSS padding or margins. d3.pointer usually handles this, but it’s good to verify the container.

Books That Will Help

Topic Book Chapter
SVG Basics “SVG Essentials” by J. David Eisenberg Ch. 1-3
D3 Selections “Interactive Data Visualization for the Web” by Scott Murray Ch. 6

Project 2: The Manual Bar Chart (Zero to Hero)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 2: Practical but Forgettable
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 1: Beginner
  • Knowledge Area: Data Binding / Scales / Axes
  • Software or Tool: D3.js (v7)
  • Main Book: “Interactive Data Visualization for the Web” by Scott Murray

What you’ll build: A bar chart that visualizes a hardcoded array of numbers. You will manually create the scales, the axes, and the bars.

Why it teaches D3: This is the “Hello World” of D3. It teaches you the core pipeline: Data -> Scale -> Attribute. You’ll learn why we don’t just use height = d; we use height = yScale(d).

Core challenges you’ll face:

  • Linear Scales → maps to mapping data [0, max] to pixels [0, height]
  • Band Scales → maps to spacing bars evenly with padding
  • The “Upside Down” Bar → maps to math required to make bars grow up from the bottom

Key Concepts:

  • d3.scaleLinear: Mapping continuous data.
  • d3.scaleBand: Mapping discrete categories.
  • d3.axisBottom / d3.axisLeft: Automated axis generators.

Difficulty: Beginner Time estimate: Weekend Prerequisites: Project 1 completion

Real World Outcome

A clean, professional-looking bar chart. When you change the data array in your code and refresh, the bars should resize and the axes should update automatically.

Example Output:

Data: [10, 25, 40, 80]
Result:
|
|          [  ]
|      [  ] [  ]
|  [  ][  ] [  ]
+-----------------
  10   25   40   80

The Core Question You’re Answering

“How do I map abstract numbers (like $5,000) to physical pixels (like 250px)?”

Before you write any code, realize that visualization is just a translation service. Scales are the translators. Without scales, a data point of 1,000,000 would try to draw a bar a million pixels long, crashing your browser.

Concepts You Must Understand First

Stop and research these before coding:

  1. Domain vs Range
    • Which one is for data? Which one is for pixels?
    • Book Reference: “Interactive Data Visualization for the Web” Ch. 7
  2. The Margin Convention
    • Why do we define top, right, bottom, left margins?
    • Resource: Mike Bostock’s “Margin Convention” (Observable)

Questions to Guide Your Design

Before implementing, think through these:

  1. Dynamic Scaling
    • What happens if the maximum value in my data is 100, but I hardcoded my scale to 50? (Use d3.max()).
  2. Axis Placement
    • If my SVG height is 500, and my margin-bottom is 30, where exactly should the X-axis be placed?

Thinking Exercise

The Bar Math

If height = 500 and yScale(50) = 200:

  1. The bar represents the value 50.
  2. In SVG, y=0 is the top.
  3. Where should the y attribute of the <rect> start?
  4. What should the height attribute of the <rect> be?

Hint: SVG rects draw DOWN from their (x,y) origin.

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “What is the difference between d3.scaleLinear and d3.scaleOrdinal?”
  2. “Why do we use d3.axisBottom(scale) instead of drawing lines and text manually?”
  3. “Explain the ‘Margin Convention’ in D3.”
  4. “How do you make a bar chart responsive?”
  5. “What is the purpose of .domain() in a scale?”

Hints in Layers

Hint 1: Data Setup Start with const data = [10, 20, 30, 40];. Use d3.max(data) to find the upper bound for your scale.

Hint 2: The Scales Create an xScale using d3.scaleBand and a yScale using d3.scaleLinear. Remember: the yScale range should usually be [innerHeight, 0] to flip the axis.

Hint 3: The Bars Select your container, bind the data, and append rect. y should be yScale(d), and height should be innerHeight - yScale(d).

Hint 4: The Axes Append a g element for each axis. Call the axis generator: .call(d3.axisBottom(xScale)). Use transform: translate to move them into position.

Books That Will Help

Topic Book Chapter
Scales “Interactive Data Visualization for the Web” Ch. 7
Axes “Interactive Data Visualization for the Web” Ch. 8

Project 3: Interactive Scatter Plot (Enter/Update/Exit)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 3: Genuinely Clever
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 2: Intermediate
  • Knowledge Area: Transitions / Interactivity / General Update Pattern
  • Software or Tool: D3.js (v7)
  • Main Book: “Fullstack D3 and Data Visualization” by Amelia Wattenberger

What you’ll build: A scatter plot that visualizes 2D data (e.g., Height vs Weight). It will feature a “Randomize Data” button that smoothly transitions the circles to their new positions using D3’s General Update Pattern.

Why it teaches D3: This project moves from static charts to dynamic ones. You’ll master .join(), .transition(), and how D3 handles elements that are being added, moved, or removed.

Core challenges you’ll face:

  • Object Constancy → maps to using keys in .data(data, d => d.id) so D3 tracks the same circle
  • Transition Orchestration → maps to making sure the axes and the points move in sync
  • Basic Tooltips → maps to showing data details on mouseover

Key Concepts:

  • selection.join(): The modern way to handle enter/update/exit.
  • selection.transition(): Animating attribute changes.
  • d3.ease: Customizing animation curves.

Difficulty: Intermediate Time estimate: 1 week Prerequisites: Project 2 completion

Real World Outcome

A fluid visualization that feels alive. When you click “Randomize,” the points don’t just “jump”; they slide across the screen. Mousing over a point reveals its exact values in a small floating box.

Example Output:

[Button: New Data]
      . (70, 180)
  .
           . (tooltip: "Height: 6ft, Weight: 200lb")
 .
-------------------

The Core Question You’re Answering

“How do I maintain ‘Object Constancy’—ensuring the user’s eye follows the same data point as it changes?”

Before you write any code, think about how confusing a chart is if the bars or dots just disappear and reappear in new spots. Transitions aren’t just “eye candy”; they are cognitive aids that help the viewer understand change over time.

Concepts You Must Understand First

Stop and research these before coding:

  1. The General Update Pattern
    • What happens to elements that are no longer in the dataset?
    • Resource: D3 Selection Join (Observable)
  2. D3 Transitions
    • How do you set a duration and a delay?
    • Book Reference: “Fullstack D3” Ch. 4

Questions to Guide Your Design

Before implementing, think through these:

  1. Tooltip Strategy
    • Should my tooltip be an SVG element or a hidden HTML div? (HTML div is usually easier for complex styling).
  2. Performance
    • If I have 1,000 points, will the transitions be smooth? (Check the browser’s framerate).

Thinking Exercise

The Transition Pipeline

  1. Data changes from [{id:1, val:10}] to [{id:1, val:50}].
  2. D3 finds the circle with id:1.
  3. You call .transition().duration(1000).
  4. What happens at 500ms? What is the cy value?

Questions while tracing:

  • What if a second data update happens while the first transition is still running? (Hint: transitions on the same attribute interrupt each other).

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “Why is a ‘key function’ important in the .data() method?”
  2. “How does selection.join() simplify the enter/update/exit pattern?”
  3. “What happens to a transition if the underlying DOM node is removed?”
  4. “How do you implement a tooltip in D3 without using a library?”
  5. “Explain the difference between .attr() and .style() during a transition.”

Hints in Layers

Hint 1: The Join Use circles = svg.selectAll("circle").data(data, d => d.id). This binds by ID rather than index.

Hint 2: Handling Changes Use .join("circle") or the explicit .join(enter => ..., update => ..., exit => ...) if you want different animations for appearing vs moving elements.

Hint 3: The Tooltip Create a div with position: absolute; opacity: 0. On mouseover, set its opacity to 1, its left/top to event.pageX/Y, and its html to your data string.

Hint 4: Synchronization Don’t forget to transition your axes! svg.select(".y-axis").transition().call(yAxis).

Books That Will Help

Topic Book Chapter
Transitions “Interactive Data Visualization for the Web” Ch. 9
Update Pattern “Fullstack D3 and Data Visualization” Ch. 2-3

Project 4: The SVG Line & Area Chart (Path Generators)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 3: Genuinely Clever
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 2: Intermediate
  • Knowledge Area: Path Data / Generators / Interpolation
  • Software or Tool: D3.js (v7)
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A time-series visualization showing stock prices (or similar) as a line and a shaded area underneath. It will include a “brush” tool to zoom into specific time ranges.

Why it teaches D3: Unlike circles or rects, lines are complex path elements. You’ll learn to use d3.line() and d3.area() generators to convert an array of objects into the cryptic d attribute string (M10,20L30,40...).

Core challenges you’ll face:

  • Time Scales → maps to working with Date objects and d3.scaleTime
  • Path Interpolation → maps to choosing between jagged lines and smooth curves (d3.curveBasis)
  • Data Densification → maps to handling missing data points in a line

Key Concepts:

  • d3.line(): Generator for line paths.
  • d3.area(): Generator for shaded regions.
  • d3.brush(): Interactive selection tool for zooming/filtering.

Difficulty: Intermediate Time estimate: 1 week Prerequisites: Project 3 completion

Real World Outcome

A professional stock chart. You can drag a “brush” area at the bottom to zoom the main chart above. The line and area will smoothly update their shapes based on the new time domain.

Example Output:

Main Chart:
   / \  /
  /   \/
 [  Brush Selection  ]
----------------------

The Core Question You’re Answering

“How do I turn a list of 1,000 dates and prices into a single continuous shape?”

Before you write any code, look at a path element’s d attribute in the inspector. It’s a “mini-language” for drawing. D3’s generators are the compilers that turn your high-level data into that low-level drawing language.

Concepts You Must Understand First

Stop and research these before coding:

  1. d3.line() Accessors
    • How do you tell D3 which property is ‘x’ and which is ‘y’?
    • Book Reference: “D3.js in Action” Ch. 4
  2. SVG Path Commands (M, L, Z)
    • What does ‘M’ stand for? (Move to). What does ‘L’ stand for? (Line to).
    • Resource: MDN SVG Paths

Questions to Guide Your Design

Before implementing, think through these:

  1. Handling Gaps
    • If a day has no data, should the line drop to zero or bridge the gap? (Look at .defined()).
  2. Clipping
    • When zooming, how do you prevent the line from drawing outside the axes? (Research SVG clipPath).

Thinking Exercise

The Path String Generator

  1. Data: [{x:0, y:10}, {x:100, y:50}]
  2. You set up a line generator: line = d3.line().x(d => d.x).y(d => d.y)
  3. What string will line(data) return?

Questions while tracing:

  • Why is it better to use the generator than to manually loop and concatenate strings?
  • How does adding .curve(d3.curveStep) change that string?

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “What is a D3 path generator and why is it useful?”
  2. “How do you handle missing data in a time-series line chart?”
  3. “Explain how to implement zooming and panning in D3.”
  4. “What is the difference between d3.line() and d3.area()?”
  5. “How does d3.brush() work and how do you link it to a scale?”

Hints in Layers

Hint 1: Date Parsing Use d3.timeParse("%Y-%m-%d") to convert your data strings into real JavaScript Date objects.

Hint 2: The Generator Define your generator outside the data join: const lineGen = d3.line().x(d => xScale(d.date)).y(d => yScale(d.value)).

Hint 3: Drawing You only need ONE path element for the whole line. Append it once, then use .datum(data) (note: singular) to bind the entire array to that one path.

Hint 4: Brushing The brush returns a pixel range [x0, x1]. Use xScale.invert(x0) to find the actual date at that pixel. Update your main scale and re-draw.

Books That Will Help

Topic Book Chapter
Path Generators “D3.js in Action” Ch. 4
Interaction/Brushing “Interactive Data Visualization for the Web” Ch. 14

Project 5: Hierarchical Tree / Dendrogram (Layouts)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 4: Hardcore Tech Flex
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 3: Advanced
  • Knowledge Area: Hierarchical Data / Tree Layouts / Recursion
  • Software or Tool: D3.js (v7)
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A collapsible tree diagram showing a file system or an organizational chart. Clicking a node expands or collapses its children with smooth transitions.

Why it teaches D3: It introduces D3’s “Layout” engines. You don’t calculate the (x,y) positions of nodes manually; you pass your JSON data to d3.tree(), which calculates the optimal positions for you.

Core challenges you’ll face:

  • Data Transformation → maps to converting nested JSON into d3.hierarchy
  • Coordinate Mapping → maps to rotating the tree (e.g., left-to-right vs top-to-bottom)
  • Link Generators → maps to using d3.linkHorizontal to draw smooth curved connectors

Key Concepts:

  • d3.hierarchy(): Wrapper for nested data.
  • d3.tree(): Layout algorithm for node positioning.
  • d3.linkHorizontal() / d3.linkVertical(): Connectors for trees.

Difficulty: Advanced Time estimate: 1-2 weeks Prerequisites: Project 4 completion

Real World Outcome

An interactive organization chart. You start with just the CEO node. Clicking it “explodes” out the VPs, and clicking them shows their reports. The paths (links) grow and shrink from the parent node’s position.

Example Output:

[CEO] ───┐
         ├── [VP Product] ── [Dev]
         └── [VP Sales]

The Core Question You’re Answering

“How do I calculate the position of nodes in a hierarchy so they don’t overlap?”

Before you write any code, try to imagine the math for spacing out 100 nodes in 5 levels of depth. It’s incredibly hard. D3 layouts are “math engines” that do this heavy lifting, allowing you to focus on the visual representation.

Concepts You Must Understand First

Stop and research these before coding:

  1. d3.hierarchy and .descendants()
    • What properties does d3.hierarchy add to your objects? (e.g., depth, height, parent).
    • Book Reference: “D3.js in Action” Ch. 11
  2. The “Tidy Tree” Algorithm
    • Why do some trees look balanced while others look messy?
    • Resource: Reingold-Tilford Algorithm (The basis for d3.tree).

Questions to Guide Your Design

Before implementing, think through these:

  1. Collapsing Logic
    • How do I store “hidden” children so I can bring them back later? (A common convention is moving children to _children).
  2. Path Source/Target
    • A link connects a parent to a child. How does d3.link know where the parent is?

Thinking Exercise

The Hierarchy Wrap

  1. You have const data = { name: "Root", children: [{ name: "A" }] }.
  2. You call root = d3.hierarchy(data).
  3. What is root.children[0].parent.data.name?

Questions while tracing:

  • How do you find the total number of “leaves” (nodes with no children) in the tree?
  • Why does D3 need to know the width/height of your container before it can calculate tree positions?

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “What is d3.hierarchy and why is it necessary before using a tree layout?”
  2. “Explain the difference between d3.tree() and d3.cluster().”
  3. “How do you implement collapsible nodes in a D3 tree?”
  4. “What is the purpose of d3.linkHorizontal()?”
  5. “How would you handle a tree with 10,000 nodes?”

Hints in Layers

Hint 1: The Wrapper Wrap your JSON: const root = d3.hierarchy(data). Then run the layout: treeLayout(root). This attaches x and y to every node.

Hint 2: Drawing Nodes Use root.descendants() to get a flat array of all visible nodes. Bind this to a selection of g elements.

Hint 3: Drawing Links Use root.links() to get a flat array of objects containing {source, target} pairs. Bind this to path elements using a link generator.

Hint 4: The Animation When a node is clicked, toggle its children, re-run the treeLayout(root), and re-bind. Use a transition so the nodes slide from their old (x,y) to their new (x,y).

Books That Will Help

Topic Book Chapter
Hierarchy Layouts “D3.js in Action” Ch. 11
Data Transformation “Fullstack D3 and Data Visualization” Ch. 5

Project 6: Force-Directed Network (Physics Simulation)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 5: Pure Magic (Super Cool)
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 3: Advanced
  • Knowledge Area: Physics Engines / Force Simulations / Graph Theory
  • Software or Tool: D3.js (v7)
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A social network graph where nodes are people and links are friendships. The graph will “settle” into a layout using physics (repulsion, attraction, and gravity). Users can drag nodes to perturb the system.

Why it teaches D3: This project moves away from fixed coordinate systems to dynamic, simulated ones. You’ll learn how to use d3.forceSimulation, which is a continuous-loop engine that updates positions 60 times per second.

Core challenges you’ll face:

  • Simulated Cooling → maps to understanding ‘alpha’ and how the simulation eventually stops
  • Collision Detection → maps to preventing nodes from overlapping using d3.forceCollide
  • The Drag Behavior → maps to reheating the simulation when a user interacts

Key Concepts:

  • d3.forceSimulation(): The physics engine.
  • d3.forceLink() / d3.forceManyBody(): Defining forces between elements.
  • d3.drag(): Built-in interaction handler.

Difficulty: Advanced Time estimate: 1-2 weeks Prerequisites: Project 5 completion

Real World Outcome

A “living” graph. When it loads, the nodes fly apart and then slowly pull back together into clusters based on their connections. You can grab a node with your mouse and “swing” the whole network around.

Example Output:

   ( )---( )
    | \ / |
   ( )---( )  <-- Dragging this moves the others

The Core Question You’re Answering

“How do I visualize data that has no inherent ‘top’ or ‘bottom’?”

Before you write any code, realize that scatter plots and bar charts have axes. Network data doesn’t. You need an algorithm that finds the “least stressful” layout where nodes that are connected stay close, and nodes that aren’t connected push each other away.

Concepts You Must Understand First

Stop and research these before coding:

  1. Nodes and Links (Adjacency Lists)
    • How do you represent a network in JSON? (Usually an object with nodes: [] and links: []).
    • Book Reference: “D3.js in Action” Ch. 12
  2. The Simulation Tick
    • What happens inside the .on("tick", ...) callback?
    • Resource: D3-force Documentation

Questions to Guide Your Design

Before implementing, think through these:

  1. Center Gravity
    • Without a forceCenter, what would happen to your nodes? (They’d drift off-screen).
  2. Node Weight
    • Should a node with 50 connections be “heavier” or larger than a node with 1 connection?

Thinking Exercise

The Alpha Decay

  1. The simulation starts with alpha = 1.
  2. Every “tick”, alpha decreases slightly.
  3. When alpha < alphaMin, the simulation stops.
  4. Why is this called “cooling”?

Questions while tracing:

  • What happens if you add a new node while the simulation is “cold”?
  • How does d3.drag “reheat” the simulation? (Look for restart() and alphaTarget).

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “How does a force-directed layout differ from a tree layout?”
  2. “What is the ‘tick’ event in a D3 force simulation?”
  3. “How do you prevent nodes from overlapping in a force graph?”
  4. “What is the purpose of the ‘many-body’ force?”
  5. “How would you handle a graph with 5,000 nodes and 20,000 links?”

Hints in Layers

Hint 1: Data Prep Ensure your links use IDs or indices that match your nodes. D3-force will automatically replace these strings/numbers with actual object references during initialization.

Hint 2: The Forces Start with forceManyBody() (repulsion) and forceCenter(). Add forceLink() later once the nodes are appearing.

Hint 3: The Tick Inside .on("tick", () => { ... }), update the x and y attributes of your circles and the x1, y1, x2, y2 of your lines. These values are automatically calculated and added to your data objects by the simulation.

Hint 4: Interaction Use d3.drag() and hook into dragstarted, dragged, and dragended. You must set the node’s fx and fy (fixed x/y) during dragging so the simulation doesn’t fight you.

Books That Will Help

Topic Book Chapter
Network Visualizations “D3.js in Action” Ch. 12
Force Simulations “Interactive Data Visualization for the Web” Ch. 13

Project 7: Geospatial Choropleth (Maps & Projections)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 4: Hardcore Tech Flex
  • Business Potential: 3. The “Service & Support” Model
  • Difficulty: Level 3: Advanced
  • Knowledge Area: Geospatial Data / Projections / TopoJSON
  • Software or Tool: D3.js (v7), TopoJSON
  • Main Book: “Interactive Data Visualization for the Web” by Scott Murray

What you’ll build: A map of the world (or a specific country) where regions are colored based on a data value (e.g., population density or GDP). It will feature zooming, panning, and a tooltip that reveals regional data.

Why it teaches D3: It teaches you how to map 3D spherical data (Latitude/Longitude) to a 2D screen using Projections. You’ll work with complex path data representing geographic boundaries.

Core challenges you’ll face:

  • TopoJSON Parsing → maps to converting compressed topology data into GeoJSON features
  • Projection Math → maps to choosing between Mercator, Albers, or Orthographic
  • Coordinate Clipping → maps to handling shapes that wrap around the globe

Key Concepts:

  • d3.geoPath(): Path generator for geographic shapes.
  • d3.geoMercator() / d3.geoAlbers(): Mathematical projections.
  • TopoJSON: A format that encodes topology, making files much smaller.

Difficulty: Advanced Time estimate: 1-2 weeks Prerequisites: Project 4 completion

Real World Outcome

A professional-grade interactive map. You can hover over a country to see its name and value, and use your mouse wheel to zoom into specific regions. The color scale automatically maps values to a gradient (e.g., light blue to dark blue).

Example Output:

      _---_
    /       \  (Hover: "France: 67M")
   |  [Map]  |
    \_     _/
      -----

The Core Question You’re Answering

“How do I flatten a sphere onto a computer screen without distorting the data too much?”

Before you write any code, look up the “Orange Peel” problem in cartography. You cannot flatten a sphere without stretching or cutting it. D3 projections are the algorithms that decide how to stretch it.

Concepts You Must Understand First

Stop and research these before coding:

  1. GeoJSON vs TopoJSON
    • Why is GeoJSON so much larger? (It repeats shared boundaries).
    • Resource: “TopoJSON Specification” - Mike Bostock
  2. The d3-geo Pipeline
    • Data (Lat/Long) -> Projection -> GeoPath -> SVG Path String.
    • Book Reference: “Interactive Data Visualization for the Web” Ch. 14

Questions to Guide Your Design

Before implementing, think through these:

  1. Projection Choice
    • If I’m mapping the USA, why is geoAlbersUsa() better than geoMercator()? (Hint: It handles Alaska and Hawaii specially).
  2. Centering
    • How do I automatically center and scale the map so it fits perfectly in my SVG? (Look at .fitSize()).

Thinking Exercise

The Geographic Point

  1. You have a coordinate: [ -74.006, 40.7128 ] (New York City).
  2. You have a projection: proj = d3.geoMercator().
  3. What does proj([ -74.006, 40.7128 ]) return? (Pixels).
  4. What does geoPath(feature) do with that projection?

Questions while tracing:

  • Why do we use [Longitude, Latitude] instead of [Latitude, Longitude]? (Hint: It matches [x, y]).

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “What is the difference between GeoJSON and TopoJSON?”
  2. “How do you handle zooming and panning on a D3 map?”
  3. “Which D3 projection would you use for a world map vs. a local city map?”
  4. “How do you map a data value to a color using a quantitative scale?”
  5. “What is d3.geoPath() and how does it relate to the d attribute of an SVG path?”

Hints in Layers

Hint 1: Loading Data You need two files: your map topology (JSON) and your data (CSV/JSON). Use Promise.all([d3.json(mapUrl), d3.json(dataUrl)]).

Hint 2: Topology to Feature Use topojson.feature(topology, topology.objects.countries) to convert TopoJSON into a list of drawable GeoJSON features.

Hint 3: The Path Define a projection, then a path generator: const path = d3.geoPath().projection(myProjection). Bind your features to path elements and set d to path.

Hint 4: Color Mapping Create a d3.scaleThreshold or d3.scaleQuantize. When drawing each country, use its ID to look up the value in your data file and set the fill attribute.

Books That Will Help

Topic Book Chapter
Geographic Maps “Interactive Data Visualization for the Web” Ch. 14
Projections “D3.js in Action” Ch. 13

Project 8: The Circular Chord Diagram (Polar Coordinates)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 5: Pure Magic (Super Cool)
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 4: Expert
  • Knowledge Area: Polar Coordinates / Matrices / Flow Visualization
  • Software or Tool: D3.js (v7)
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A circular diagram showing the flow of data between entities (e.g., migration between countries or traffic between server nodes). Thick ribbons connect segments on a circle.

Why it teaches D3: It forces you to think in Polar Coordinates (Angles and Radii) instead of Cartesian (X and Y). You’ll learn how to use D3’s shape generators like d3.arc() and d3.ribbon().

Core challenges you’ll face:

  • Adjacency Matrices → maps to preparing data as a 2D square matrix
  • Angle Math → maps to working with Radians (0 to 2π)
  • Complex Interactivity → maps to fading out all ribbons except those connected to a hovered segment

Key Concepts:

  • d3.chord(): Layout for matrix-based relationships.
  • d3.ribbon(): Path generator for connecting arcs.
  • Polar-to-Cartesian conversion: Math for labels and offsets.

Difficulty: Expert Time estimate: 2 weeks Prerequisites: Project 6 completion

Real World Outcome

A stunning, complex visualization. Mousing over a specific segment highlights all the “inflow” and “outflow” of that category, while dimming everything else. It makes high-dimensional relationship data intuitive.

Example Output:

     _---_
   /  / \  \
  |  |---|  |  (Ribbons showing flow)
   \  \ /  /
     -----

The Core Question You’re Answering

“How do I visualize a ‘Many-to-Many’ relationship without creating a tangled mess of lines?”

Before you write any code, try to draw a network with 10 nodes where every node is connected to every other node. It’s a “hairball.” A chord diagram organizes this hairball by pinning the nodes to a circle and using the width of the ribbons to represent magnitude.

Concepts You Must Understand First

Stop and research these before coding:

  1. The Adjacency Matrix
    • How do you represent “A sends 10 to B”? (Row A, Column B = 10).
    • Book Reference: “D3.js in Action” Ch. 5
  2. Radians vs Degrees
    • Why does D3 use Math.PI * 2 for a full circle?
    • Resource: Khan Academy: Radians

Questions to Guide Your Design

Before implementing, think through these:

  1. Sorting
    • Should I sort the ribbons by size? (Hint: d3.chord().sortSubgroups(d3.descending) prevents smaller ribbons from hiding larger ones).
  2. Centering
    • In polar coordinates, where is the origin (0,0) usually placed in the SVG? (The center of the circle).

Thinking Exercise

The Chord Slice

  1. You have a circle with a radius of 200px.
  2. A segment starts at angle = 0 and ends at angle = Math.PI / 2.
  3. What shape is this? (A quarter-circle).
  4. If you use d3.ribbon(), what are the source and target?

Questions while tracing:

  • How do you calculate the exact (x,y) point for a text label at the edge of that segment?
  • What happens if the matrix isn’t symmetrical? (A sends to B, but B doesn’t send to A).

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “When is a chord diagram better than a force-directed graph?”
  2. “Explain how D3 handles angles in its arc and ribbon generators.”
  3. “What is an adjacency matrix?”
  4. “How do you calculate the centroid of an arc for label placement?”
  5. “What are the performance implications of drawing hundreds of ribbons in SVG?”

Hints in Layers

Hint 1: The Matrix Your data must be a Number[][]. data[i][j] is the value from entity i to entity j.

Hint 2: The Layout Pass your matrix to d3.chord(). This returns an array of “chords” (ribbons) and “groups” (the outer arcs).

Hint 3: Generators Use d3.arc() for the outer circle segments and d3.ribbon() for the inner flows. Both take the objects returned by the chord layout.

Hint 4: Positioning Move your main g element to the center of the SVG: translate(width/2, height/2). Now all your polar coordinates will be relative to that center.

Books That Will Help

Topic Book Chapter
Chord Diagrams “D3.js in Action” Ch. 5
Polar Math “Visualization Analysis and Design” by Tamara Munzner Ch. 5-7

Project 9: High-Performance Canvas Particles (Canvas Manipulation)

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 4: Hardcore Tech Flex
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 4: Expert
  • Knowledge Area: Immediate Mode Rendering / Canvas API / Performance Optimization
  • Software or Tool: D3.js (v7), HTML5 Canvas
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A visualization of 20,000+ data points (e.g., individual stars in a galaxy or particles in a wind map) that move smoothly at 60fps. You will use D3 to calculate positions but HTML5 Canvas to draw them.

Why it teaches D3: It breaks the “D3 = SVG” myth. You’ll learn to use D3’s scales and simulations without using D3’s DOM selections for drawing. This is the key to enterprise-scale data viz.

Core challenges you’ll face:

  • Immediate Mode Drawing → maps to clearing and re-drawing the whole screen every frame
  • No DOM Events → maps to manually calculating which particle was clicked based on mouse (x,y)
  • Memory Management → maps to avoiding object allocation inside the render loop

Key Concepts:

  • Canvas context (2d): The drawing API.
  • d3.timer(): A high-performance animation loop.
  • Quadtrees (d3.quadtree): Spatial indexing for fast hit detection.

Difficulty: Expert Time estimate: 2 weeks Prerequisites: Project 6 completion

Real World Outcome

A simulation that would crash an SVG-based chart. 20,000 dots swarming and reacting to your mouse with zero lag. It looks and feels like a video game but is driven by real data logic.

Example Output:

[Canvas Element]
  . . . . .
 . .  *  . .  <-- 20,000 dots
  . . . . .

The Core Question You’re Answering

“How do I visualize ‘Big Data’ when the DOM is too slow to handle it?”

Before you write any code, understand that adding 20,000 <circle> tags to the DOM will freeze almost any browser. Canvas bypasses the DOM entirely, treating the screen as a simple grid of pixels that you color manually.

Concepts You Must Understand First

Stop and research these before coding:

  1. Retained Mode (SVG) vs Immediate Mode (Canvas)
    • Why does Canvas forget what it drew immediately after drawing it?
    • Book Reference: “D3.js in Action” Ch. 14
  2. Spatial Indexing (Quadtrees)
    • If you have 20,000 points and the user clicks, do you check all 20,000? (No, you use a Quadtree to check only nearby ones).
    • Resource: “Quadtree” - Wikipedia

Questions to Guide Your Design

Before implementing, think through these:

  1. Resolution Scaling
    • How do I make the Canvas look sharp on a Retina/High-DPI display? (Hint: You must scale the canvas width by window.devicePixelRatio).
  2. The “Virtual” DOM
    • If there are no elements, how do I “select” a particle to change its color?

Thinking Exercise

The Canvas Loop

  1. You start a d3.timer(elapsed => { ... }).
  2. Inside, you call context.clearRect(0, 0, width, height).
  3. You loop through your data array.
  4. For each point, you call context.arc(...) and context.fill().

Questions while tracing:

  • What happens if you forget to call context.beginPath() inside the loop? (Hint: All your points will be connected by invisible lines, killing performance).
  • How much time do you have per frame to stay at 60fps? (16.6ms).

The Interview Questions They’ll Ask

Prepare to answer these:

  1. “When should you switch from SVG to Canvas for a D3 project?”
  2. “How do you implement tooltips or click events on a Canvas visualization?”
  3. “What is a Quadtree and why is it useful for large datasets?”
  4. “How do you handle high-DPI (Retina) screens with HTML5 Canvas?”
  5. “Explain how d3.timer differs from requestAnimationFrame.”

Hints in Layers

Hint 1: The Context Get the context: const context = canvas.node().getContext("2d"). Use D3 to select the canvas element just like any other tag.

Hint 2: The Loop Use d3.timer(). Inside the callback, update your data positions (perhaps using a d3.forceSimulation with .stop() and manual .tick() calls).

Hint 3: Drawing

data.forEach(d => {
  context.beginPath();
  context.arc(xScale(d.x), yScale(d.y), radius, 0, 2 * Math.PI);
  context.fill();
});

Hint 4: Interaction Create a d3.quadtree().x(d => d.x).y(d => d.y).addAll(data). On mousemove, use tree.find(mouseX, mouseY) to find the single closest point in logarithmic time.

Books That Will Help

Topic Book Chapter
Canvas Rendering “D3.js in Action” Ch. 14
Spatial Indexing “Algorithms, Fourth Edition” Ch. 3 (Searching)

Project 10: Custom Layout - The “Voronoi” Interactive

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 5: Pure Magic (Super Cool)
  • Business Potential: 1. The “Resume Gold”
  • Difficulty: Level 4: Expert
  • Knowledge Area: Computational Geometry / Delaunay Triangulation / Voronoi Diagrams
  • Software or Tool: D3.js (v7), d3-delaunay
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A scatter plot where every point is surrounded by a “cell” that represents the area of the screen closest to that point. As you move points, the cells warp and shift dynamically.

Why it teaches D3: It introduces advanced computational geometry. Voronoi diagrams are the “secret weapon” for making small points easy to click on a touch screen (by expanding the hit area of a point to its entire cell).

Core challenges you’ll face:

  • Delaunay Triangulation → maps to understanding the dual nature of Voronoi/Delaunay
  • Cell Clipping → maps to bounding the infinite Voronoi lines to the SVG container
  • Dynamic Re-calculation → maps to rebuilding the triangulation every time a point moves

Key Concepts:

  • d3.Delaunay: The core math for triangulation.
  • voronoi.render() / voronoi.cellPolygon(): Converting math to SVG paths.
  • Hit Detection: Using geometry to improve UX.

Project 11: Real-time Dashboard with WebSockets

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 3: Genuinely Clever
  • Business Potential: 2. The “Micro-SaaS / Pro Tool”
  • Difficulty: Level 2: Intermediate
  • Knowledge Area: Streaming Data / WebSockets / Buffer Management
  • Software or Tool: D3.js (v7), Socket.io
  • Main Book: “Fullstack D3 and Data Visualization” by Amelia Wattenberger

What you’ll build: A dashboard that monitors server health or stock prices in real-time. Data arrives via WebSocket, and the charts “slide” to the left as new data enters on the right.

Why it teaches D3: It teaches you to handle continuous data streams and “sliding window” visualizations. You’ll learn to manage a fixed-size data buffer (e.g., “always show the last 60 seconds”).

Project 12: Accessible & Responsive Visualizations

  • File: D3JS_VISUALIZATION_DEEP_DIVE.md
  • Main Programming Language: JavaScript
  • Alternative Programming Languages: TypeScript
  • Coolness Level: Level 1: Pure Corporate Snoozefest
  • Business Potential: 3. The “Service & Support” Model
  • Difficulty: Level 3: Advanced
  • Knowledge Area: Accessibility (a11y) / Responsive Design / SVG ARIA
  • Software or Tool: D3.js (v7), Screen Readers
  • Main Book: “D3.js in Action” by Elijah Meeks

What you’ll build: A set of charts that automatically resize to fit any screen (mobile/desktop) and are fully navigable by screen readers. You will implement ARIA labels, keyboard navigation, and high-contrast modes.

Why it teaches D3: This is “Production D3.” It teaches you that a visualization isn’t done until it can be used by everyone. You’ll learn to hide the complex SVG complexity from screen readers while providing a meaningful “data table” summary behind the scenes.

Project Comparison Table

Project Difficulty Time Depth of Understanding Fun Factor
1. Coordinate Explorer Level 1 Weekend Fundamental Geometry Medium
2. Manual Bar Chart Level 1 Weekend Scales & Data Binding Low
3. Interactive Scatter Level 2 1 week Transitions & Joins High
4. Line/Area Chart Level 2 1 week Path Generators Medium
5. Collapsible Tree Level 3 2 weeks Hierarchy Layouts High
6. Force Network Level 3 2 weeks Simulation & Physics Super High
7. Geo Choropleth Level 3 2 weeks Projections & Maps High
8. Chord Diagram Level 4 2 weeks Polar Math High
9. Canvas Particles Level 4 2 weeks Performance & Canvas High
10. Voronoi Cells Level 4 1 week Computational Geometry Super High
11. Real-time Dash Level 2 1 week Streaming & Buffers Medium
12. Accessible Charts Level 3 1 week Web Standards (A11y) Low

Recommendation

Start with Project 1 and 2 in a single weekend. Do not skip them. Most “experts” struggle because they never truly understood how the Y-axis inversion works or why a Scale is just a function.

If you want to get hired: Focus on Projects 3, 4, and 12. Companies need engineers who can build interactive, robust, and accessible tools.

If you want to do research/data science: Focus on Projects 6, 7, and 10. These teach you how to handle complex, non-linear data structures.

Final Overall Project: The Multi-Dimensional Data Explorer

What you’ll build

A “Grand Finale” dashboard that combines everything. Imagine a “World Development Explorer”:

  1. A Choropleth Map (Project 7) showing country metrics.
  2. Clicking a country updates a Force Graph (Project 6) of that country’s trade partners.
  3. Hovering over a trade link shows a Real-time Sparkline (Project 11) of trade volume.
  4. All of this is rendered on Canvas (Project 9) to handle thousands of entities.
  5. The entire app is Responsive and Accessible (Project 12).

Why this demonstrates mastery

You are no longer building “a chart.” You are building a coordinated visualization system. You must manage shared state across multiple complex components, handle different coordinate systems simultaneously, and maintain performance across a large data footprint.

Summary

This learning path covers D3.js through 12 hands-on projects. Here’s the complete list:

# Project Name Main Language Difficulty Time Estimate
1 Coordinate Explorer JavaScript Level 1 Weekend
2 Manual Bar Chart JavaScript Level 1 Weekend
3 Interactive Scatter JavaScript Level 2 1 Week
4 Line & Area Chart JavaScript Level 2 1 Week
5 Collapsible Tree JavaScript Level 3 2 Weeks
6 Force Network JavaScript Level 3 2 Weeks
7 Geo Choropleth JavaScript Level 3 2 Weeks
8 Chord Diagram JavaScript Level 4 2 Weeks
9 Canvas Particles JavaScript Level 4 2 Weeks
10 Voronoi Interactive JavaScript Level 4 1 Week
11 Real-time Dashboard JavaScript Level 2 1 Week
12 Accessible Production JavaScript Level 3 1 Week

For beginners: Start with projects #1, #2, #3, and #4. These build the core “D3 mental model.” For data enthusiasts: Jump to projects #5, #6, #7, and #8. These focus on complex data structures. For performance engineers: Focus on projects #9, #10, and #11.

Expected Outcomes

After completing these projects, you will:

  • Understand exactly how every byte in an SVG <path> is generated.
  • Be able to convert any mathematical coordinate system (Polar, Geographic, Simulated) into screen pixels.
  • Master the “Data Join”—knowing how to handle entering, updating, and exiting elements with grace.
  • Be able to build high-performance visualizations that handle 20k+ elements at 60fps.
  • Have a portfolio that demonstrates a “Dark Arts” level of control over the browser DOM.

You’ll have built 12 working projects that demonstrate deep understanding of D3.js from first principles.