d3.chart.bubble-matrix
Advanced tools
A bubble-matrix chart, working on any kind of bidimensional data.
With [npm]:
npm install d3.chart.bubble-matrix
You can then use browserify to use the library in your client-side javascript (recommended).
If you want to use the library with any other module system, you can generate a standalone package with browserify. In the project directory:
browserify src/chart.js --standalone
Additionally you should include the styles provided at the npm package root:
style.css — mandatory CSS;theme.css — theme CSS, can be replaced by a custom one.browserify example.js > example.bundle.js
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" type="text/css"
href="d3.chart.bubble-matrix.css">
<link rel="stylesheet" type="text/css"
href="d3.chart.bubble-matrix.default.css">
</head>
<body>
<div id='vis'>
<script src="example.bundle.js"></script>
</body>
</html>
/*! example.js */
var d3 = require('d3');
var chart = require('d3.chart.bubble-matrix');
var chart = d3.select('#vis').append('svg')
.chart('BubbleMatrix')
.width(400).height(200);
chart.draw(require('./data'));
/*! data.js */
module.exports = {
columns: ['the', 'cake', 'is', 'a', 'lie'],
rows: [
{name: 'foo', values: [[0.13, 0.69], [0.84, 0.49], [0.31, 0.97],
[0.75, 0.29], [0.64, 0.9]]},
{name: 'bar', values: [[0.98, 0.96], [0.13, 0.7], [0.27, 0.64],
[0.17, 0.24], [0.94, 0.3]]},
{name: 'baz', values: [[0.94, 0.1], [0.39, 0.63], [0.07, 0.27],
[0.98, 0.02], [0.25, 0.94]]},
{name: 'glo', values: [[0.3, 0.14], [0.39, 0.4], [0.54, 0.23],
[0.35, 0.47], [0.71, 0.71]]}
]
};
This will draw a simple bubble matrix, with the default color palette. You can find this example in the example/minimal folder.
When nothing is configured except width and height, the library makes a lot
of assumptions about how is organized your data. However, you can customize a
lot data organization with the provided interface.
To play with the example in live, clone the repo, grab the packages npm install, run npm run example and go to
localhost:3000. See also
CONTRIBUTING.
data Object Data to represent.Draw the chart.
Each configuration function returns the current value of the property when called with no argument, and sets the value otherwise.
fn(data) Function Called with the data, must return an Array of
rows.Required. Default: function(d) { return d.rows; }.
fm(datum) Function Called for each row, must return a String
to be displayed as the row header.Required. Default: function(d) { return d.name; }.
fn(datum) Function Called for each row, must return a String
that identifies uniquely the row.When rows are updated by subsequent calls to draw, rows will be removed,
added; or updated/moved when a key match an existing row. Optional.
fn(datum) Function Called for each row, must return an Object
containing bubble data for this row.Required.
fn(data) Function Called with the data, must return an Array
containing each column datum.Note you don't specifically have to store the column array into the data
provided to draw. You can build on-the-fly the column data in this function
if you wish. For instance, in example/example.js, we build column information
from a range stored in the data:
chart.columns(function (d) { return d3.range(d.dayHours[0],
d.dayHours[1]); })
.colKey(function(d) { return d; })
.colHeader(utils.hourName)
Required. Default: function(d) { return d.columns;}.
fn(datum) Function Called for each column, must return a
String to be displayed as the column header.Required. Default: function(d) { return d; }.
fn(datum) Function Called for each column, must return a
String that identifies uniquely the column.When columns and bubbles are updated by subsequent calls to draw, columns
will be removed, added; or updated/moved when a key match an existing column.
Optional.
fn(datum) Function Called for each bubble, must return a
Number driving the bubble sizes.Required. Default: function(d) { return d[0]; }.
fn(datum) Function Called for each bubble, must return a
Number driving the bubble color.Note, if you want, you can return a fixed value and only use the size feature of the bubbles; or, you can return a value correlated with the size.
Required. Default: function(d) { return d[1]; }.
value Array Domain of the values returned by size. Must contain the
min and max of acceptable values.The actual radius of the bubbles is the square root of the size obtained after normalization. This ensures that bubble areas represent accurately the size (and not the radius/width).
Required. Default: [0, 1].
fn(value) Function Color scale used to translate color values to actual
colors. Must return a color.You may want to create the scale with d3.js, eg.
var palette = ['#ff0000', '#00ff00', '#0000ff'];
chart.colorScale(d3.scale.quantize().domain([0,1])
.range(palette));
Required. A default color scale from red to blue is provided.
Listen to events with the method on of d3.chart.
value Number the margin width.this the chart itself.Sent when the left margin width changes. It is useful to align the SVG element on your paragraphs. Example:
var chart = d3.select('#vis').append('svg')
.chart('BubbleMatrix');
chart.on('margin', function (value) {
this.base.style('margin-left', '-' + value + 'px');
});
The value base in the chart is the root d3 selection, generally the SVG.
Please feel free to open pull requests to make any change. See CONTRIBUTING.
FAQs
A bubble-matrix chart for the Web
The npm package d3.chart.bubble-matrix receives a total of 4 weekly downloads. As such, d3.chart.bubble-matrix popularity was classified as not popular.
We found that d3.chart.bubble-matrix demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.
Security News
Research
Socket researchers found a malicious Maven package impersonating the legitimate ‘XZ for Java’ library, introducing a backdoor for remote code execution.