# D3 Build ## Lesson Objectives 1. Add link to d3 library 1. Add an `` tag and size it with D3 1. Create some fake data for our app 1. Add SVG circles and style them 1. Create a linear scale ## Add link to d3 library First thing we want to do is create basic `index.html` file: ```html ``` Now add a link to D3 at the bottom of your `` tag in `index.html`: ```html ``` Now create `app.js`, which will store all of our code: ```javascript console.log('this works'); ``` and link to it in `index.html` at the bottom of the `` tag: ```html ``` ## Add an `` tag and size it with D3 At the top of the `` tag in `index.html`, add an `` tag: ```html ``` In `app.js` create variables to hold the width and height of the `` tag: ```javascript var WIDTH = 800; var HEIGHT = 600; ``` Next, we can use `d3.select()` to select a single element, in this case, the `` element: ```javascript var WIDTH = 800; var HEIGHT = 600; d3.select('svg'); ``` The return value of this is a d3 version of the element (just like jQuery), so we "chain" commands onto this. Let's add some styling to adjust the height/width of the element: ```javascript d3.select('svg') .style('width', WIDTH) .style('height', HEIGHT); ``` ## Create some fake data for our app In `app.js` let's create an array of "run" objects (**NOTE I'm storing the date as a string on purpose**): ```javascript var WIDTH = 800; var HEIGHT = 600; var runs = [ { id: 1, date: 'October 1, 2017 at 4:00PM', distance: 5.2 }, { id: 2, date: 'October 2, 2017 at 5:00PM', distance: 7.0725 }, { id: 3, date: 'October 3, 2017 at 6:00PM', distance: 8.7 } ]; ``` ## Add SVG circles and style them Add three circles to your `` element (each one will represent a run): ```html ``` Create `app.css` with some styling for the circles and our `svg` element: ```css circle { r:5; fill: black; } svg { border: 1px solid black; } ``` and link to it in `index.html` ```html ``` ## Create a linear scale - One of the most important things that D3 does is provide the ability to map points in the "domain" of data to points in the visual "range" using what's called a `scale`. - There are lots of different kinds of scales, but for now we're just going to use a `linear` scale which will map numeric data values to numeric visual values. In `app.js`: ```javascript d3.select('svg') .style('width', WIDTH) .style('height', HEIGHT); var yScale = d3.scaleLinear(); //create the scale yScale.range([HEIGHT, 0]); //set the visual range (e.g. 600 to 0) yScale.domain([0, 10]); //set the data domain (e.g. 0 to 10) console.log(yScale(5)); //get a visual point from a data value console.log(yScale.invert(450)); //get a data values from a visual point ``` - Here we're saying that a data point of 0 to map to a visual height value of 600 - This is because the lower the distance run (data value), the more we want to move the visual point down the Y axis - remember that the Y axis starts at 0 at the top and increases in value