readme added

LICENSE

@@ -0,0 +1,30 @@
+D3.js:
+
+Copyright (c) 2010-2014, Michael Bostock
+All rights reserved.
+
+Copyright (c) 2012-2014, Jim Vallandingham
+All rights reserved.
+
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

README.md

@@ -0,0 +1,61 @@
+# Animated Bubble Chart
+
+Creating Animated Bubble Charts using D3.
+
+## Description
+
+This repository contains code to create your own animated bubble chart.
+
+It goes along with the tutorial here:
+
+http://vallandingham.me/bubble_charts_in_d3.html
+
+A live version of this code is here:
+
+http://vallandingham.me/gates_bubbles/
+
+## Running
+
+D3 needs to be run from a webserver due to how it imports data files. 
+
+See more here: https://github.com/mbostock/d3/wiki#using
+
+So, to run this visualization locally, from the Terminal, navigate to the directory you checked it out to
+
+     cd ~/code/path/to/gates_bubbles
+
+Then start a webserver locally. If you are on a Linux or Mac, you should be able to use python's built in webserver:
+
+     python -m SimpleHTTPServer 3000
+
+I always use Ruby's thin gem to get things started
+
+     gem install thin # <- just do once
+     thin start
+
+Once the server has started, open up your web browser to:
+
+http://0.0.0.0:3000/
+
+And you should see your bubbles!
+
+## Things to consider
+
+Here are a few things that may be issues for you, or may not be
+
+* Written in Coffeescript
+
+Coffeescript compiles down to JavasScript, and is a really fun language to learn. Try it out!
+
+http://coffeescript.org/
+
+But if you want, you should be able to compile this tutorial back down to JavaScript - and start from there. People in the comments of the tutorial have already done this.
+
+* Bubbles might not be the answer to your problems
+
+While the bubbles are flashy and are fun to watch move around, they may not be the best visual form to display your information in. In most cases, when bubbles are used to encode a single variable, the two dimensional bubble inflates and obscures the one dimensional value it is attempting to display. 
+
+Kaiser Fung hates bubble charts. You can see lots of reasons why here: http://junkcharts.typepad.com/junk_charts/bubble_chart/
+
+Just keep in mind when you are working with your data.
+