Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including fancy-axis with all npm packages installed. Try it out:

var fancyAxis = require("fancy-axis")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

fancy-axis v0.1.0

An implementation of some https://www.cl.cam.ac.uk/~sjm217/projects/graphics/ features in D3.js

FancyAxis

This is a package to draw fancier axes in D3 for your graphs, based on the visual style of Edward Tufte, and on this previous work done in R:

  • docs: https://www.cl.cam.ac.uk/~sjm217/projects/graphics/
  • code: https://www.cl.cam.ac.uk/~sjm217/projects/graphics/fancyaxis.R

Usage

Node

Install via npm:

npm install fancy-axis

and import:

import { rugPlot } from "fancy-axis";

Script

You can also load the script directly on the page, and it will be stored globally:

<script src="https://unpkg.com/fancy-axis@0.0.2"></script>
<script>
    const { rugPlot } = fancyAxis;
</script>

Features

Rug Plot

rug plot example

Usage

Use in place of d3.axisBottom and d3.axisLeft. The function signatures are the same, except that rugPlot takes in an optional options object to customize the look of your axes (see below).

All methods that are available on the result of d3.axisBottom and d3.axisLeft are available on the rug plot as well. So:

rugPlot.axisLeft(yScale).scale(); // returns yScale again

There are two methods available on the rugPlot axis specific to this library.

NametyperequiredNotes
x or yfuncfalsex is available on axisBottom only, and y on axisLeft only. It will be passed each data point and the index as arguments: (data: any, index: number) => any
datumiterablefalsethe data for your graph. If not passed, then the axis still render.

Here is a simple example of how you could use rugPlot to render your axis.

import { rugPlot } from "fancy-axis";

// dataset is like [{y: ... }, ...]
const leftAxis = rugPlot.axisLeft(yScale).datum(dataset).y(d => d.y);

svg.append("g")
    .attr("class", "y axis")
    .call(leftAxis);

You will need to do both axes for it to display correctly. If you do not want the rug plot on the other axis, you can omit the datum from it:

let bottomAxis = rugPlot.axisBottom(xScale);

And it will not render the data, but the padding will be correct.

Options

Passing these options can help customize the rug plot.

NametypeNotes
widthnumberwidth of the rug 'tassels'
colorstringcss color of the rug 'tassels'
strokeWidthnumberthickness of the rug 'tassels'

These options help create the graph seen earlier in this doc:

const bottomAxis = rugPlot
    .axisBottom(xScale, {
        width: 10,
        color: "rgba(0, 0, 0, 0.1)",
        strokeWidth: 2,
    })
    .datum(dataset)
    .x((d) => d[0]);
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free