You probably remember spirographs as kid's toys from your youth. I had a simple set that was just a collection of plastic sprockets with holes for pencils.

Endless amounts of fun when I was two or three years old. I think ... I don't really remember much from that time, but I remember having those thingies and loving playing with them. One of my earliest memories even!

Last night I was making an animation example for the d3.js book I'm writing and ended up with the idea of progressively drawing out cool looking parametric equations. Little did I know, those are actually spirographs! Learned something while I was learning something.

< tweet gone missing>

My failure in common knowledge aside, it's possible to animate the drawing of parametric equations with just a few lines of d3.js code. What I'm about to show you has a pretty big problem, but produces cool looking results "in the lab". Try to guess what the problem is.

We'll make an animation timer and for each tick we'll draw a new step of the spirograph. After the spirograph is finished, we'll stop the timer. To make the animation more interesting to watch, we'll also fake a brush flying around (just a black dot).

We start with some basic html:

< title > </ title > < link href = " ../bootstrap/css/bootstrap.min.css " rel = " stylesheet " /> < div id = " graph " > </ div > < script src = " http://d3js.org/d3.v3.min.js " > </ script > < script src = " timers.js " > </ script >

Then we hop into the javascript to flesh out the actual code.

var width = 600 , height = 600 , svg = d3 . select ( "#graph" ) . append ( "svg" ) . attr ( { width : width , height : height } ) ;

I found the parametric function in the wikipedia's article on parametric equations. We'll be giving it a simple parameter calculated from the animation timer and it will return a two dimensional position.

var position = function ( t ) { var a = 80 , b = 1 , c = 1 , d = 80 ; return { x : Math . cos ( a * t ) - Math . pow ( Math . cos ( b * t ) , 3 ) , y : Math . sin ( c * t ) - Math . pow ( Math . sin ( d * t ) , 3 ) , } ; } ;

Tweaking the a, b, c, and d parameters will change the final shape.

Next we're going to define some scales to help us translate between maths space and our drawing space.

var t_scale = d3 . scale . linear ( ) . domain ( [ 500 , 30000 ] ) . range ( [ 0 , 2 * Math . PI ] ) , x = d3 . scale . linear ( ) . domain ( [ - 2 , 2 ] ) . range ( [ 100 , width - 100 ] ) , y = d3 . scale . linear ( ) . domain ( [ - 2 , 2 ] ) . range ( [ height - 100 , 100 ] ) ; var brush = svg . append ( "circle" ) . attr ( { r : 4 } ) , previous = position ( 0 ) ;

The t_scale is going to translate time into a parameter, x and y calculate proper positions on the final image using the coordinates returned by the position function.

We also put a simple circle on the image - this will represent the brush - and we need to take note of the previous position so we can draw lines between our current and previous state.

var step = function ( time ) { if ( time > t_scale . domain ( ) [ 1 ] ) { return true ; } var t = t_scale ( time ) , pos = position ( t ) ; brush . attr ( { cx : x ( pos . x ) , cy : y ( pos . y ) } ) ; svg . append ( "line" ) . attr ( { x1 : x ( previous . x ) , y1 : y ( previous . y ) , x2 : x ( pos . x ) , y2 : y ( pos . y ) , stroke : "steelblue" , "stroke-width" : 1.3 , } ) ; previous = pos ; } ;

This is our step function. It draws every consecutive step of the animation by moving the brush and putting a line between the current and previous position. The animation will stop when this function returns true so we make sure the time parameter doesn't go beyond t_scales's domain.

Finally, we simply start the timer.

var timer = d3 . timer ( step , 500 ) ;

The timer will start running after 500 milliseconds and repeatedly call the step _ function until it returns _ true.

You can check the animation out via the magic of github pages. The final spirograph looks like this:

Figured out the problem yet?

The problem with this approach is that I'm using the animation timer itself as a parameter to the function, which means point density depends on how long you're willing to let the animation run. It will always draw the complete function because of how d3 scales work, but it might look very approximate. Think squares for circles approximate.

Another problem is that using a slower computer, or doing anything that lags the CPU even a little bit while the animation is running will ruin the final picture.

For instance, this is what happens when I switch desktops around while the browser is drawing.

Did you enjoy this article? 👎 👍

Published on March 7th, 2013 in Animation, d3.js, JavaScript, Spirograph, Uncategorized

Learned something new?

Want to become a high value JavaScript expert? Here's how it works 👇 Leave your email and I'll send you an Interactive Modern JavaScript Cheatsheet 📖right away. After that you'll get thoughtfully written emails every week about React, JavaScript, and your career. Lessons learned over my 20 years in the industry working with companies ranging from tiny startups to Fortune5 behemoths. Start with an interactive cheatsheet 📖 Then get thoughtful letters 💌 on mindsets, tactics, and technical skills for your career. "Man, love your simple writing! Yours is the only email I open from marketers and only blog that I give a fuck to read & scroll till the end. And wow always take away lessons with me. Inspiring! And very relatable. 👌" ~ Ashish Kumar Your Name Your Email Your Address Subscribe & Become an expert 💌 Join over 10,000 engineers just like you already improving their JS careers with my letters, workshops, courses, and talks. ✌️

Have a burning question that you think I can answer? I don't have all of the answers, but I have some! Hit me up on twitter or book a 30min ama for in-depth help.

Ready to Stop copy pasting D3 examples and create data visualizations of your own? Learn how to build scalable dataviz components your whole team can understand with React for Data Visualization

Curious about Serverless and the modern backend? Check out Serverless Handbook, modern backend for the frontend engineer.

Ready to learn how it all fits together and build a modern webapp from scratch? Learn how to launch a webapp and make your first 💰 on the side with ServerlessReact.Dev

Want to brush up on your modern JavaScript syntax? Check out my interactive cheatsheet: es6cheatsheet.com

By the way, just in case no one has told you it yet today: I love and appreciate you for who you are ❤️