Beginner’s guide to build data visualisations on the web with D3.js

23 min read


I am sure you have heard this many times

A picture is worth a thousand words.

I think with the proliferation of data, this statement can easily be modified to

A picture is worth thousand(s) of data points.

If you are not convinced, look at the example below.


Storytelling through Data Visualisation

Let’s look at the following statement:

“In 2013, Gun Deaths Claimed 11,419 lives in the U.S.”

What comes to your mind first?

  • In 2013, US saw a lot of gun violence
  • Gun violence is high in the US
  • Deaths due to Gun violence were 11,419 (in 2013)

Without visualisation the above are just a set of statistics. Though this stat is useful, it still falls short in conveying the bigger picture. You don’t get the complete context – What kind of people were involved? How much was the nation’s loss? etc.

Let’s see what happens when we visualise it:

Periscope’s US Gun Deaths Visualisation (takes some time to load) – Periscope has made this visualisation that shows the number of people died due to the gun violence in the U.S. in 2013. The orange line denotes the age at which they died and the white line denotes the number of years those people could have lived had they died of natural causes. This visualisation shows what 11,419 lost lives looks like and just how many years of life was stolen from the victims. It is a good example of how we can express the data in a more sublime and impactful manner by using basic animations and interactivity.

“When we present the data as a story, it gives a range of new perspectives and a much more holistic view of the situation which helps policy makers in making informed decisions.”


The Web as a platform for visualisation

The web is becoming more accessible day by day and with advancements in browser technology, it is now possible to render complex visualisations on the fly across a variety of devices. This combination of accessibility and complexity makes the web an apt platform to reach out to large audiences.

A lot of organisations are already using web / mobile applications showing dashboards to your mobile as well at your laptop and computer.


How D3.js fits in the picture?

Enter D3.js, a powerful library that enables you to build customized visualisations for any kind of storytelling you could imagine for the web.

Let’s look at another amazing visualisation :

Hans Rosling’s 200 Countries, 200 Years, 4 Minutes – Hans tries to explain the change in health and income in the last 200 years across 200 countries of the world in just 4 minutes by utilising the power of effective visualisation.

The properties of this graph are as follows:

  • The x axis is the income per person in $/year and the y axis is the life expectancy in years.
  • Each sphere represents a country, countries of the same continent are of the same colour.
  • The size of the sphere represents the population of the country.
  • As time passes and countries improve in terms of life expectancy and/or per capita income the spheres start moving towards top-right of the graph.

Notice how by using simple visual encodings like shape, size, colour, etc. such complex information(200 years of data) is conveyed across. We will talk about what is visual encoding and this visualisation in detail in the upcoming articles.

What if I tell you  the above visualisation is created using D3.js? That’s the potential of D3.js! Hopefully, we will learn to create magic of our own too 🙂


Setup your machine

We would be needing a few things before starting:

  1. Text Editor – Any text editor of choice, though I’d recommend Sublime Text . It’s a free, multi-platform text editor with useful features like syntax highlighting and code completion.
  2. Browser – Any modern browser. I’d recommend Google Chrome. This tutorial will assume you are using Chrome.
  3. Web Server – In its simplest form, a web server is a software that helps you deliver content over the internet. You can relate a web server to a real server in a restaurant, that “serves” the dishes you request.

Note: Since D3.js is designed to make visualisations on the web, it can fetch data over the internet from a web server to show visualisations. Hence we will also be working with a small server of our own.


Create a simple web server in Python

Step 1: Go to the directory you want to keep your D3.js project.

Step 2: Python 2.7.x users can start the server by typing the code in the command line:

python -m SimpleHTTPServer

Python 3.x users can do so by type the code in command line:

python -m http.server

You can check your python version by:

python --version

Note: For windows users, please install anaconda and then open anaconda prompt.

This should give an output similar to the following:

Step 3: Here “” is your server’s IP address and “8000” is the port number. Imagine you have ordered your favorite pizza and you need to give your house address to complete the order. You will first give the Street Name and then the House Number, here IP address is analogous to street name (i.e. It identifies your computer) and Port number is analogous to the house number that helps you reach a particular house (i.e. identifies the process on your computer) in a building.

Step 4: To check if your server is working, head to your browser and type the link :

You will get an output like this:

Congratulations, you are now on your way to build your first d3.js visualisation!


Technical Interlude – Brushing up basics of HTML, CSS, JavaScript and SVG

Before diving into D3, we need to know some web development basics. The web is built on three main pillars: HTML, CSS and JavaScript. Also, for a clearer understanding of D3.js, you should know the basics of SVG. We will have a crash course on these topics with some task based questions.

Note:  You can skip this section if you are familiar with HTML, CSS and JavaScript. In case you have some doubts or need help, each task is followed by a stepwise guide 🙂

We have a list of four tasks to complete before we can get started with D3. Tasks 1 to 3 are based on HTML,CSS and JavaScript. Task 4 is based on SVG and related topics.

Let’s start with our first task!

Task 1. Create a basic HTML page with the text “Hello World” :

For this task, you would need to :

  • Know the basic structure of an HTML page.
  • Know about some commonly used HTML tags especially <p></p> “paragraph” tags.
  • Create a new file in Sublime Text and save your HTML code with “.html” extension.
  • Start your python server and access the file in a browser.

Try doing this task on your own before checking the solution 🙂



HTML or Hypertext Markup Language describes the structure of your web pages. HTML uses “tags”, a kind of syntax to form the skeletal structure of a web page. Specific text enclosed between angular brackets form a tag.

Let’s create our first HTML !

  • Create a new file in your folder and save it with the name index.html
  • Copy the following code into it and save
<!DOCTYPE html>
        <title>D3 Tutorial</title>
        <p>Hello World</p>
  • Here <html>,<head>,<body> etc. are all tags.
  • Start your server
python -m SimpleHTTPServer 8000

Congratulations! You just made your first web page. Let’s get into some details:

  1. <!DOCTYPE html> : This line tells your browser that this document is of type “HTML”(specifically HTML5). So it should display it accordingly.
  2. The HTML document( web page) is contained between <html> and </html> tags.
  3. The visible part of the HTML document is between <body> and </body> tags.
  4. The <title></title> tag in the head sets the title of the page , you can see that on the top left. Here we have set the title “D3 Tutorial” .
  5. HTML paragraphs are defined with the <p></p> tags. Any text written between these tags will be formatted as a paragraph.
  6. HTML works by making a hierarchy of all the elements. In the above example, <html> tags sit at the highest hierarchy. Then comes the <body> and <head> tags. The relationship between various hierarchy is referred to in human terms.

For example :

  • The <p> tag is said to be the “child” of <body> tag.
  • The <body> and <head> tags can be said to be “siblings” of each other.


Task 2. Add formatting and styling to the text using CSS. Specifically, we want to increase size, bring the text to the center of the page, add colour and change its typeface:

For this task you would need to :

  • Include your CSS in your HTML.
  • Know about some commonly used CSS rules especially rules related to “font”.
  • Have an idea about CSS selectors(like id, class etc.) and how they help in setting rules for HTML elements.
  • Save your changes and refresh the browser page to see the effect.

Try doing this task on your own before checking the solution 🙂



CSS or Cascading Style Sheets is used to add styling and formatting to web pages. In other words, it helps to set a variety of rules(like: position, color, formatting etc.) that make the HTML look pretty. Let’s make our own web page pretty!

  • Let’s think what we can do to make our text look better?
  1. Align the text in the center
  2. Add colour
  3. Change font family(font style)
  4. Increase the size of font
  • The CSS code for above changes will be:
text-align: center; /*align our text in center*/
color: teal; /*write your favourite colour here */
font-family: Tahoma; /*change font family*/
font-size: 66px; /*set font size to 66 pixels*/

Note: The text between /**/ are comments and are ignored by the browser. They are for the programmer to keep notes of his / her code.

  • Now we have our CSS ready, how to tell our CSS where do these rules apply?
  • Let’s give an id (in simpler terms a nickname) to our paragraph so that our CSS can easily find it. Change the <p> tag in our code to:
<p id=”myText”>Hello World</p>
  • Now, whenever we use “myText” in our CSS it will know we mean the above <p> tag.
  • CSS rules are added in <style></style>  tags inside our HTML. Let’s add them to our file so that it becomes:
<!DOCTYPE html>
<title>D3 Tutorial</title>
<style type=”text/css”>
text-align: center; /*align our text in center*/
color: teal; /*set color to teal*/
font-family: Tahoma; /*change font family*/
font-size: 66px; /*set font size to 66 pixels*/
<p id=”myText”>Hello World</p>

Note: that we use the # symbol to call id in our CSS. This tells CSS to look for an element with the id =  “myText”.

  • Save your HTML file, Refresh the page and voila!

CSS Selectors –  Selectors are way our CSS is able to know which HTML elements does the rule applies to? We have already learned about the id selector.

Now imagine, that if we have multiple paragraphs and we want to do the same styling to each? Surely we can repeat the ids for all elements but an id is supposed to be unique. We can use a class selector to group the elements that belong to the same class of styling.

  • Replace the #myText to .text-beautify in the <style> tags:
text-align: center; /*align our text in center*/
color: teal; /*set color to teal*/
font-family: Tahoma; /*change font family */
font-size: 66px; /*set font size to 66 pixels*/

Note: We use “.” (dot) to tell our CSS we mean a class.

  • Let’s add another paragraph and remove ids from our <p> tags.
<p class="text-beautify">Hello World</p>
<p class="text-beautify"> My First Web Page!</p>

  • This is how you group elements with similar styling by adding a class to them.


Task 3. We want to add a behavior to our page. We want to show some text initially and change it when someone clicks on it. We also want to show an image on that click.

For this task you would need to:

  • Know a little bit about event based attributes like “onclick” and how you attach them to HTML elements.
  • Learn basic javascript syntax like how to create functions, variables.
  • How to update CSS property of an element using javascript.
  • Include your javascript code in your HTML.
  • How to add images to HTML.
  • The image gif can be downloaded from here

Try doing this task on your own before checking the solution 🙂


JavaScript is a programming language that adds immense functionality to a basic HTML web page. Almost all the “cool” things that you see in a website are because of the amazing power and flexibility JavaScript provides. It runs in the browser, unlike python and other programming languages you don’t need to install JavaScript, as long as you have a browser you can easily run it. Let’s add some special effects to impress our friend on his / her birthday!

We will first show a generic message to our friend and when he /she clicks on the text, surprise! Happy Birthday! Let’s code it up :

  • First, we will tweak our HTML’s <body> tag a bit, it should look something like this:
<p onclick="show()" id="myText">Hey Buddy! Click here!</p>
<img src="happybday.gif" id="image">
  • Notice that we have removed the second <p> tag and added an <img>(image tag).
  • <img> tags are used to add an image to your web page in HTML.
  • You must have noticed src=”happybday.gif” inside <img> tag. The src is short for “source” , it basically tells the browser that I want to insert an image whose source(name on the computer) is “happybday.gif”.
  • You can download the image we are going to use from here. Save it with the name “happybday.gif”
  • Also, notice we have given an id to the image this is because we might want to add some CSS rules to our image.
  • Things like id, src add more functionality to our HTML elements and are hence called attributes. Attributes follow a general syntax of attributename = attributevalue. We will be dealing with them a lot in D3.
  • Did you notice any change in the <p> tag? Yes, we have added another attribute onclick to our <p> element:
<p onclick=”show()” id=”myText”>Hello Buddy! Click here!</p>
  • The onclick attributes tell your browser to do something when a click happens. In this case, that something is showing the image. In JavaScript terms, we say that this is an Event Listener that listens for the “mouse click” and calls a function whenever the event happens.
  • Let us also update our CSS by adding rules for our <img> copy the following code in between <style></style> tags, just below our previous code:
visibility: hidden;/* hide the image */
width: 100%; /* set width of image to 100% of body */
height: 50%; /* set height of image to 50% of body */
  • To add JavaScript code to our HTML we use <script></script> tags. Add the following code to your HTML just below the <p> tag:
<script type="text/javascript">
var show = function(){
var txt = document.getElementById("myText"),
img = document.getElementById("image");
txt.innerHTML = "Happy Birthday! :D"; = "visible";
  • Save it and refresh your browser page. You’ll see something similar to this:

  • Try clicking on the text and voila!

Isn’t it amazing what 5 lines of JavaScript can achieve? Let us dive into the code and understand what each line does:

  • var show = function(){ – Here we create a function with the name show. The syntax for creating a function in JavaScript is :
var functionname = function(){ //code}


functionname(){ //code}
  • Notice that we call this function whenever a click happens on our previous message. This is because this function stores the logic that will tell the browser what to do on next.
  • var txt = document.getElementById(“myText”) – we are telling javascript to bring the element that has id(nickname) of “myText” and store it as a variable of name txt. Now if we make any changes in txt it will reflect in our HTML element.
  • We do the same for the <img> element:
img = document.getElementById("image");
  • In order to change the text of the <p> tag we update it’s innerHTML property. innerHTML, as the name suggests, is a string that denotes an element’s inner HTML. If we change it, this will update the element.
  • Next, we change image’s visibility property to visible. Recall in our CSS we had set visibility to hidden so that the image remains hidden unless someone clicks on the text.
  • This is the syntax to change an element’s CSS property using javascript: = propertyvalue

Congratulations! So far so good, you have successfully learnt the building blocks of web! We will be learning more about them as we go ahead with our D3 journey 🙂

If you want to dig deeper into Web Technologies, you can look at W3Schools . For D3.js only basic understanding is required.

In order to build with D3 we also need a basic knowledge of SVG. The following tasks are designed to give you a brief intro into the world of SVG:


Task 4. Draw a group of two blue circles of radius 50px each. Fill the circle with blue colour and red boundary of some thickness using an SVG.

For this task you would need to :

  • Create an SVG element using <svg></svg> tags.
  • Have a basic idea about coordinate spaces in SVG.
  • Learn about basic shapes like circles and line using SVGs.
  • Learn about some attributes like “fill”, “stroke”.
  • Use “groups” of SVG.

Try doing this task on your own before checking the solution 🙂



SVG or Scalable Vector Graphics is a format used to draw xml based graphics and animations. SVG graphics do NOT lose any quality if they are zoomed or resized.

SVG provides some basic shapes like lines, rectangles, circle, ellipse, polygon  to work with. You can also create custom shapes by combining or tweaking these shapes. For extremely customisable graphics(like country maps, etc.) we use paths. A lot of these will refresh your high school geometry 🙂 Let’s go through each one:



One of the simplest graphic. A line is formed when we join two points separated by a distance. There can be many such lines joining two points but we are interested in a straight line. For example, you and your friend are standing some distance apart, if you walk straight to him the path you’ll follow will make a straight line.

  • Create a new html file in your D3 project folder with the name “svg.html”
  • Let’s add basic HTML:
<!DOCTYPE html>
<title>D3 Tutorial</title>
<p>Hello World</p>
  • The SVG is created using <svg></svg> tags inside html.
  • Let’s create our svg element with a width of 500px and a height of 500px:
<svg width=”500” height=”500”></svg>
  • Let’s add a line between points (10,10) and (140,140) we will add the line code between <svg> tags so that our code now looks like:
<svg width=”500” height=”500”>
<line x1="10" y1="10" x2="140" y2="140" stroke="black"></line>
  • Save the file and go to the link in your browser and you should get something like:

  • Here we have created a simple line that joins two points, (x1,y1) and (x2,y2) which give location in pixels. Fun experiment: change stroke=”blue”->save your file and refresh browser What happens?
  • The Line changes to blue. “stroke” sets the color of the stroke that will make the line. stroke along with x1,x2,y1,y2 are all attributes that define and affect our graphics.


A Side Note – Coordinate space in SVG:

Those of you who know a little about coordinate system in geometry would be finding something strange with the line. The line should be like this :

This is because the origin(0,0) in SVG is at the “top-left” corner as opposed to conventional “bottom-left”.

As we move towards the right the x value increases and on moving down y value increases.

Enough of serious talk, let’s draw !


  • Let’s add a circle with center coordinates as (100,100) and radius 50px and color “blue”:
<circle r=”50” cx=”100” cy=”100” fill=”blue”>

  • Let’s give it a red boundary of 5px thickness:
<circle cx="100" cy="100" fill="blue" r="50" stroke="red" stroke-width="5"></circle>

  • Notice the use of stroke  and stroke-width for the boundary.
  • Let’s create another circle :
<circle cx="200" cy="200" r="50" ></circle>

  • Notice how the other circle is black because we haven’t added any attributes other than radius and center position. We want to apply same styling to this circle too, in such cases we use groups.


  • A group in svg is placed in <g></g> tags and is used when we want to apply same properties to many elements.
  • Let us move both of our circles into a group and apply stroke, fill and stroke-width attributes to the group as a whole. Our svg would look like:
<svg width="500" height="500">
<g fill="blue" stroke="red" stroke-width="5">
<circle cx="100" cy="100" r="50"></circle>
<circle cx="200" cy="200" r="50" ></circle>

  • Notice the advantage of creating a group, you just have to edit at one place to add/remove attributes or even if you are experimenting, this is a neat little trick. We would be using this alot in D3.

You can read more about svg here, for using D3, only basic understanding of svg is required.


D3.js – Unpacking the name

D3.js is a javascript library written by Mike Bostock. It takes advantage of already established web technologies like canvas, svg to make out of the world visualisations.

D3’s name comes from the fact that it is designed to act as a driver for web documents(web page) based on the available data (json, csv, tsv etc.). In other words,

“D3’s magic helps you to create beautiful, interactive visualisations from seemingly boring data(json,csv,etc.)”

We will get to know more about it as we go deeper into D3. You can also look at some of the awesome visualisations created using D3.js 🙂


Building with D3.js

Let’s get our hands dirty with D3!

We will create a new html file , with name “barchart.html” in our D3 folder. Let us also put some basic html in our file :

<!DOCTYPE html>
      <title>D3 Tutorial</title>


Including D3.js library

In order to use D3 we have to include it’s library, There are many ways to do so but we will stick to loading it from a url. D3 is completely written in javascript so we can include just like we include our javascript code with <script></script> tags like this:

<script src=""></script>

Note: This article uses version 3  of D3.js . You can find the documentation here.

This line tells your browser to load the d3 file from the given URL. We will place this tag inside our <head> tag just below the <title> tags. We will also create another <script> tag inside our body for us to write javascript code. Our final HTML code should look like this :

<!DOCTYPE html>
<title>D3 Tutorial</title>
<script src=""></script>
<script type="text/javascript">
//We will write our D3 code here


Adding an element

Our webpage looks empty, let’s add a paragraph here with D3. Write the below line between the <script> tags inside <body>:“body”).append(“p”).text(“Our First Paragraph using D3!”);

Save the page and head to your browser. This time you will have to use the url because your html file is named barchart.html. Let’s see what happened in our page:

Wasn’t that easy? Let’s try to understand our D3 code:“body”).append(“p”).text(“Our First Paragraph using D3!”);

When we include D3’s library, it gives us a global object d3  that we can use to call various D3 functions. Here we are asking d3 to select <body> of our DOM and append a paragraph there with the text content “Our First Paragraph using D3!”.

Let’s walk through what just happened. In sequence, we:

  • Invoked D3’s .select(..) method, which selects a single element from the DOM using CSS selector syntax. (We selected the body.)
  • Created a new <p> element and appended that to the end of our selection, meaning just before the closing </body> tag in this case.
  • Set the text content of that new, empty paragraph to “Our First Paragraph using D3!”

All of those crazy dots are just part of D3’s chain syntax. The chain syntax is possible because every time you call a D3 function on an object it performs some operations on it and returns a reference to the new object, which in turn gets picked up by the next function in the chain.This is called method chaining. Note that the above task could have also achieved by calling each function separately like we do conventionally.


Adding CSS styling

Our text looks boring let us add some css styling to it and see what happens:"body").append("p").text("Our First Paragraph using D3!").style({"font-size":"40px","font-family":"arial"});

Much better! We use .style(….) to add css styling in D3. Our chain has become too long to fit in a single line, let’s us arrange it :

var p =“body”).append(“p”).text(“Our First Paragraph using D3!”);{“font-size”:”40px”,”font-family”:”arial”});

Notice how we first created a <p> element with some text and stored in a variable p and then later used the same variable to add css styling to it. We can now use this variable whenever we want to make changes or edits to the paragraph.


Data binding

What is data binding and why should I do it?

  1. Data binding is when you associate your data to DOM elements so that the properties of DOM represent properties of data.
  2. Data visualisation is mapping of data values to visuals so instead of looking at columns , rows and numbers , we can look at graphics that are easier to comprehend and derive inferences with lesser effort.

Hence you need to bind your data to the DOM elements in order to represent it as a visualisation. D3.js provides powerful ways to bind data in different forms(csv,tsv, json etc.) to the DOM.

Let’s create a data array :

var data_values = [5,10,30,8,45,24,16,55,60];

Note: In javascript an array is an equivalent of collections of R or lists of Python.

Now that we have our data, let’s bind our data to the DOM. We want to create <p> elements per data value and display it. Our new code will be like:

var p = d3.selectAll("p") .data(data_values).enter().append("p").text("hello world");{"font-size":"20px","font-family":"arial"});

Let’s see what does our browser show:

Whoa that was a lot of method chaining. We have got our text nine times on the page each as a paragraph. Let us break down the code:

  •“body”) – Select body in the DOM.
  • d3.selectAll(“p”) – This method is a variation of the earlier used method. The difference is while the former returns the first element it matches, the latter will return all the elements it matches. For example,  if we have 10 <p> elements the“p”) will only return the first paragraph while d3.selectAll(“p”) will return all 10 paragraphs.

Since we don’t have any paragraphs it will return an empty selection. Think of this as the selection of paragraphs that will soon exist.

  • .data(data_values) – this function reads in our data, counts it and attaches it to the DOM element we selected earlier. Since we have nine values in our data, everything past this point is executed nine times once for each data value.
  • .enter() – This is the function where all the magic happens. This function adds a placeholder element to our DOM for our data values and returns a reference to the same.
  • .append(“p”) – As we have seen earlier, append is used to add elements to the DOM. Based on the references returned by the enter() we will append <p> elements.
  • .text(“hello world”) – We add text content to our paragraphs.

This is how the entire process looked like:

First select body →  from body select all the <p> elements that we are soon going to add → read the data values and count it, the following lines will be executed once for each value →  create placeholders for the elements going to be added and return references to them → append elements based on the references returned earlier → add text content to each element.

We follow the similar process all throughout our code in D3. Hence it is important that you understand it thoroughly.


Where is our data?

Did you notice that even though we got nine paragraphs, but we don’t see any data? Where did it go?

Remember the line where I said that every line following data(..) will be executed nine times, once for each value? D3 provides us a way to access each value while it iterates over them. Let’s check that value, edit the code to:

var p = d3.selectAll("p").data(data_values).enter().append("p").text(function(value){ return value; });{"font-size":"20px","font-family":"arial"});

This time instead of directly providing text content we create a function inside text(..). D3 executes this function every time it goes over our data. Each time this function is called, it is passed the value for which it is called. That means if we are on the first element of the array this function will be called with 5. We return the same value to our text(..) function so that it can add it to the text content of the paragraph. Here’s our data:

Drawing SVG with D3

Just like html elements, creating svg with D3 is quite easy(one line easy!). For example we want to create an svg with width 500px and height 500px :

var svg =“body”).append(“svg”).attr({“width”:450,”height”:400});

We append an <svg> like did for <p> element. The attr(..) function is used to set attributes of the svg. Here we want to set width and height of the svg.

Let us draw a circle in this svg. We want to create a circle of radius 30 and centre at (50,50):

svg.append(“circle”).attr({“r”:”30px”, “cx”:”50px”, “cy”:”50px”});

Notice how we used append(..) to add a circle to our svg.

Let us add fill to our circle and increase the radius:

svg.append(“circle”).attr({“r”:”50px”, ”fill”: “red” , “cx”:”50px”, “cy”:”50px”});

You can see that the same attributes we learnt in the svg work here. D3 provides an easy interface to create SVGs programmatically.


Simple Barchart

A bar chart is a graphic that presents grouped data with rectangular bars. Here lengths of bars are proportional to the values they represent.


Drawing bars

We will be taking advantage of SVG rectangle to make rectangles for the bar chart. A rectangle has four properties : Height, Width, x start position, y start position. Let’s create a rectangle using D3:

svg.append("rect").attr({“x”:”30px”, “y”:”30px”, "width":"30px", "height":"100px"});

Notice how the (x,y) control the starting point of the rectangle. Let us add colour to our bar but before we will store our rectangle in a variable so that we can reuse it again. Let’s do that:

var bars = svg.append(“rect”).attr({“x”:”30px”, “y”:”30px”, "width":"30px", "height":"150px"});
bars.attr(“fill”, ”blue”); //fill the rect with blue

Let us create bars based on our data values. We will use the same process that we used to bind data earlier. Our bars variable will change to:

var bars = svg.selectAll("rect").data(data_values).enter().append("rect").attr("width","25px").attr("height", function(d){ return d; });

We have chosen a fixed width of 25 pixels for each bar and we are setting height based our data_values array. Let us see how the graphic looks:

Weren’t we supposed to get nine rectangles? We have nine rectangles but since we have not given different x values they all lie on the same position. Let’s add different x values to our bars:

bars.attr(“x”, function(d,i){ return i*30; });

What is the “i”

We already know D3 passes the current data value while iterating through our data. Along with the current value it also passes the current value’s index. This index helps us keep track of the iteration count. What we are doing is we are giving i*30 as x value for our bars. This is because the i will denote the index of the current value and 30 is there because we know each bar’s width is 25 pixels so we give a padding of 5 pixels between each bar.

Let’s refresh our page and we got our 9 data bars !:

Isn’t our bars a little funky? Let’s scale our heights a little bit. Let’s multiply d by 5 in our height function:

.attr(“height”, function(d){ return d*5; });

Much better, but why are the bars upside down?

Remember that SVG Coordinate space is different as compared to conventional? Here Origin is at the top left corner so our y-axis starts from the top. Let’s adjust this so that we get a proper bar chart, we can change this by subtracting the height of each bar from the total height of the svg(400px).

bars.attr(“y”, function(d){ return 400-d*5; });

Let’s give a nice color to our bars:

bars.attr(“fill”, “steelblue”);

Let’s add some more values to our data_values array , it should now look like this:

var data_values = [5,10,30,8,45,24,16,55,60,45,32,18,11,3];

Do you think this visualisation is efficiently conveying the information? No, there are many things that can be improved so that we are able to convey inferences in as efficient manner as possible. One such improvement can be :

“Highlighting min and max bars so that as soon as we put our gaze on the visualisation we get an idea of the two extremes, we won’t have to go through each bars and hence this will save our time.”

Let’s do that!

We first need to find the two extremes in our dataset. Lucky for us, D3 provides d3.max(..) and d3.min(..)  functions that we can use:

var max = d3.max(data_values);
var min = d3.min(data_values);

We will have to now select those two bars two have max and min value respectively , for that we’ll use D3’s filter(..) method. What this will do is select only those bars that match the filter. In this case we will have filter for maximum value. We will add “green” colour fill to the bar:

bars.filter(function(d){ return d==max; }).attr(“fill”,”green”);

Similarly for the smallest bar, we will add “red” fill colour:

bars.filter(function(d){ return d==min; }).attr(“fill”,”red”);


There we have our simple barchart in less than 20 lines of code!


End Notes

Congratulations for coming this far, we have covered a lot of D3 basics these will help you pursue your own adventures someday! D3.js is a very powerful library and we have just scratched the surface. There is still a complex but immensely useful functionality it has to offer; that is making better charts, visualisations loaded with animations and interactivity.

I have included all the code of this article is available on github. Also check out these small visualisations that I created for fun to get a glimpse of some cool stuff we can do by knowing just the basics of D3 :

I urge you to try them out on your own. Good luck!

You can check out my next article on D3.js here

Learn, Engage, Compete & Get Hired

A computer science graduate, I have previously worked as a Research Assistant at the University of Southern California(USC-ICT) where I employed NLP and ML to make better virtual STEM mentors. My research interests include using AI and its allied fields of NLP and Computer Vision for tackling real-world problems.

Frequently Asked Questions

Lorem ipsum dolor sit amet, consectetur adipiscing elit,

Responses From Readers


Aditi Sinha
Aditi Sinha 20 Jul, 2017

Great article, Rizvi Machine learning is the great for modern time and giving the information in this article is great thanks for sharing and keep posting


Great work Sanad,

David JR
David JR 20 Jul, 2017

Very nicely written with lots of graphics for better understanding.

M J Yogesh
M J Yogesh 20 Jul, 2017

Congrats on this very extensive and crisp explanation of the concept. Keep up the good work. Hoping to read many such articles in future.

Ram 20 Jul, 2017

Hi After typing python -m http.server the page ( is not opening. It is showing "This site can’t be reached".Please guide on how to trouble shoot this problem. My default browser is Explorer. Is it because of that.

Pankaj Jha
Pankaj Jha 20 Jul, 2017

Very helpful article. Many Thanks!

Aishwarya 22 Jul, 2017

Great job! Very well written. Keep it up!

Daniel 31 Jul, 2017

Hi, Thanks for your great post! One quick question.. For this line of code below, .attr(“height”, function(d){ return d*5; }); The browser can't show the plot normally. Some of the bars have the same heights. I wonder if there is a fixed max range when displaying the plot. How can I fix it? Thank you !

Daniel 31 Jul, 2017

Hi Sanad, I am Daniel This is the continuation of the question. I've uploaded the screenshots of my problem. Please check the link.. Thank you.

Mohd Sanad Zaki Rizvi
Mohd Sanad Zaki Rizvi 02 Sep, 2017

Guys, Check out my new article on D3.js!! Sanad :D

Declan 30 Oct, 2017

My HTML page isn't reflecting the CSS block which i pasted from above. What could be the issue he Declan

Premnath D
Premnath D 25 Nov, 2017

Wow. Kudos to Mohd Sanad Zaki Rizvi. You are a awesome teacher man. Great respect. I am new to HTML, CSS and JS but your crash course made me feel simple to follow. You made it look like easy. The way you explain is the key here. For example, in CSS, first you explained what we are going to do/ what css is going to do. then said it needs a title and then it need to go inside and then explaining class. Respect.