ボックスプロットライブラリ比較
4つのアプローチでデータの分布・中央値・外れ値を可視化し、実装方法とスタイルを比較
このページでは、Nivo・D3.js・Chart.js・ApexChartsを使ったボックスプロット(箱ひげ図)の実装パターンをインタラクティブなデモとコードで確認できます。
箱ひげ図は四分位数で要約するため、山が2つある分布も1つの箱に見えます。分布の形をそのまま見たい場合は、値を区間に分けて数えるヒストグラムが向いています。ヒストグラム(Histogram)の実装比較 →
1. Nivo(@nivo/boxplot)
@nivo/boxplotパッケージでボックスプロットをネイティブサポート。生データを渡すと四分位数・中央値・外れ値を自動計算して描画。ホバー時のツールチップや色のカスタマイズも充実しており、最も手軽に高品質なボックスプロットを実装できる。
'use client';
import { ResponsiveBoxPlot } from '@nivo/boxplot';
const data = [
{ group: '営業部', subGroup: '月次売上', n: 50, mean: 1100,
extrema: [820, 1450], quantiles: [0.1, 0.25, 0.5, 0.75, 0.9],
values: [820, 950, 1100, 1280, 1450] },
{ group: 'マーケ部', subGroup: '月次売上', n: 50, mean: 900,
extrema: [600, 1200], quantiles: [0.1, 0.25, 0.5, 0.75, 0.9],
values: [600, 780, 920, 1050, 1200] },
];
export function NivoBoxPlot() {
return (
<div style={{ height: 300 }}>
<ResponsiveBoxPlot
data={data as any}
groupBy="group"
subGroupBy="subGroup"
value="value"
quantiles={[0.1, 0.25, 0.5, 0.75, 0.9]}
margin={{ top: 20, right: 20, bottom: 60, left: 70 }}
padding={0.3}
colorBy="group"
colors={{ scheme: 'category10' }}
borderRadius={2}
borderWidth={1.5}
medianWidth={2}
whiskerEndSize={0.6}
/>
</div>
);
}AIプロンプトテンプレート
React + Tailwind CSSで、Nivo(@nivo/boxplot)を使ったボックスプロットを実装してください。 - 使用ライブラリ: @nivo/boxplot の ResponsiveBoxPlot コンポーネント - サンプルデータ: 部門別の月次売上分布(最小値・第1四分位・中央値・第3四分位・最大値・外れ値)を用意すること - インタラクティブ: ホバー時にツールチップで統計値を表示すること - 外れ値: 外れ値を個別の点として表示すること - レスポンシブ: 親要素の幅に応じてチャートサイズが変わるよう対応すること - スタイリング: colorBy="group" で各ボックスに識別しやすい色を設定すること
このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
2. D3.js(カスタム実装)
各部門12か月分の生データから、D3.jsのd3-arrayで四分位数・中央値を計算し、d3-scaleで座標に変換してSVG描画をReactで制御するカスタム実装。ウィスカーの長さ・外れ値の判定基準(このデモでは1.5×IQR)・スタイルまで完全にコントロール可能。実装コストは高いが、独自の統計表現や複雑なインタラクションが必要な場合に最適。
quantile()で四分位数を求め、1.5×IQRの外側を外れ値として描く(計算済みの値を渡すほかの節と同じ結果になる)。 SVGをJSXで描くため、アニメーションや独自インタラクションも自由に足せる。'use client';
import { extent, quantile } from 'd3-array';
import { scaleBand, scaleLinear } from 'd3-scale';
// 各部門12か月分の月次売上(生データ)。統計量はコードで計算する
const monthlySales: Record<string, number[]> = {
'営業部': [1080, 960, 1260, 820, 1120, 1450, 1010, 440, 1340, 1180, 920, 1800],
'マーケ部': [900, 720, 1110, 600, 980, 1480, 850, 800, 1200, 940, 360, 1030],
'CS部': [960, 1240, 800, 1100, 700, 1050, 880, 1300, 450, 1000, 1180, 920],
'パートナー部': [1180, 1020, 1440, 900, 1290, 1060, 1900, 1220, 960, 1550, 1120, 1360],
};
const colors = ['#3b82f6', '#10b981', '#f59e0b', '#8b5cf6'];
const WIDTH = 560;
const HEIGHT = 300;
const margin = { top: 20, right: 20, bottom: 80, left: 70 };
// 四分位数は d3-array の quantile で求め、1.5×IQR の内側をひげ、外側を外れ値にする
function summarize(values: number[]) {
const q1 = quantile(values, 0.25) ?? 0;
const median = quantile(values, 0.5) ?? 0;
const q3 = quantile(values, 0.75) ?? 0;
const iqr = q3 - q1;
const lowerFence = q1 - 1.5 * iqr;
const upperFence = q3 + 1.5 * iqr;
const [min, max] = extent(values.filter((v) => v >= lowerFence && v <= upperFence)) as [number, number];
const outliers = values.filter((v) => v < lowerFence || v > upperFence);
return { q1, median, q3, min, max, outliers };
}
// d3 は計算(統計量・スケール)だけを担当し、SVG は React の JSX で描く
export function D3BoxPlot() {
const groups = Object.keys(monthlySales);
const stats = groups.map((group) => ({ group, ...summarize(monthlySales[group]) }));
// 値 → 縦位置、部門 → 横の帯
const y = scaleLinear().domain([200, 2000]).range([HEIGHT - margin.bottom, margin.top]);
const x = scaleBand().domain(groups).range([margin.left, WIDTH - margin.right]);
const boxW = x.bandwidth() * 0.45;
return (
<svg viewBox="0 0 560 300" className="w-full">
{y.ticks(10).map((tick) => (
<g key={tick}>
<line x1={margin.left} x2={WIDTH - margin.right} y1={y(tick)} y2={y(tick)} stroke="#e5e7eb" />
<text x={margin.left - 8} y={y(tick)} textAnchor="end" dominantBaseline="middle" fontSize={10} fill="#9ca3af">
{tick}
</text>
</g>
))}
{stats.map((d, i) => {
const cx = (x(d.group) ?? 0) + x.bandwidth() / 2;
const color = colors[i];
return (
<g key={d.group}>
{/* ひげ(縦線)と両端のキャップ */}
<line x1={cx} x2={cx} y1={y(d.max)} y2={y(d.min)} stroke={color} strokeWidth={1.5} />
<line x1={cx - boxW / 4} x2={cx + boxW / 4} y1={y(d.max)} y2={y(d.max)} stroke={color} strokeWidth={1.5} />
<line x1={cx - boxW / 4} x2={cx + boxW / 4} y1={y(d.min)} y2={y(d.min)} stroke={color} strokeWidth={1.5} />
{/* 第1〜第3四分位の箱と中央値 */}
<rect
x={cx - boxW / 2}
y={y(d.q3)}
width={boxW}
height={y(d.q1) - y(d.q3)}
fill={color}
fillOpacity={0.25}
stroke={color}
strokeWidth={1.5}
rx={2}
/>
<line x1={cx - boxW / 2} x2={cx + boxW / 2} y1={y(d.median)} y2={y(d.median)} stroke={color} strokeWidth={2.5} />
{/* 外れ値 */}
{d.outliers.map((o) => (
<circle key={o} cx={cx} cy={y(o)} r={4} fill="none" stroke={color} strokeWidth={1.5} />
))}
<text x={cx} y={HEIGHT - margin.bottom + 16} textAnchor="middle" fontSize={10} fill="#6b7280">
{d.group}
</text>
</g>
);
})}
<line x1={margin.left} x2={margin.left} y1={margin.top} y2={HEIGHT - margin.bottom} stroke="#d1d5db" />
<line x1={margin.left} x2={WIDTH - margin.right} y1={HEIGHT - margin.bottom} y2={HEIGHT - margin.bottom} stroke="#d1d5db" />
</svg>
);
}AIプロンプトテンプレート
React + Tailwind CSSで、D3.js(カスタム実装)を使ったボックスプロットを実装してください。 - 使用ライブラリ: d3-array の quantile・extent で四分位数・中央値・ひげの端を計算し、d3-scale の scaleLinear・scaleBand で座標に変換すること。SVG は React の JSX で描くこと - サンプルデータ: 部門別の月次売上(各部門12か月分の生データ)を用意し、統計量はコードで計算すること - 外れ値: 1.5×IQR の外側にある値を外れ値として個別の丸点で描画し、ひげは内側の最小値・最大値まで伸ばすこと - インタラクティブ: なし(表示専用。ツールチップが必要なら useState でホバー中の部門を持って表示すること) - レスポンシブ: viewBox を使って親要素の幅に応じてチャートサイズが変わるよう対応すること - スタイリング: 各ボックスに識別しやすい色を設定し、IQRボックスは半透明で塗りつぶすこと
このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
3. Chart.js(カスタム実装)
chartjs-chart-boxplotプラグインを使用することでChart.jsでもボックスプロットを実現。事前に計算済みの統計値(min・q1・median・q3・max)を渡すだけで描画できる。Canvas描画のため大量のデータポイントや外れ値が多い場合でもパフォーマンスが安定。
'use client';
import { Chart } from 'react-chartjs-2';
import { Chart as ChartJS, CategoryScale, LinearScale, Tooltip, Legend } from 'chart.js';
import { BoxPlotController, BoxAndWiskers } from '@sgratzl/chartjs-chart-boxplot';
ChartJS.register(CategoryScale, LinearScale, Tooltip, Legend, BoxPlotController, BoxAndWiskers);
const data = {
labels: ['営業部', 'マーケ部', 'CS部', 'パートナー部'],
datasets: [{
label: '月次売上分布',
data: [
{ min: 820, q1: 950, median: 1100, q3: 1280, max: 1450, outliers: [440, 1800] },
{ min: 600, q1: 780, median: 920, q3: 1050, max: 1200, outliers: [360, 1480] },
{ min: 700, q1: 860, median: 980, q3: 1120, max: 1300, outliers: [450] },
{ min: 900, q1: 1050, median: 1200, q3: 1380, max: 1550, outliers: [1900] },
],
backgroundColor: ['rgba(59,130,246,0.3)', 'rgba(16,185,129,0.3)', 'rgba(245,158,11,0.3)', 'rgba(139,92,246,0.3)'],
borderColor: ['#3b82f6', '#10b981', '#f59e0b', '#8b5cf6'],
borderWidth: 1.5,
}],
};
export function ChartJSBoxPlot() {
return (
<Chart type={"boxplot" as any} data={data as any}
options={{ responsive: true, maintainAspectRatio: false }} />
);
}AIプロンプトテンプレート
React + Tailwind CSSで、Chart.js(カスタム実装)を使ったボックスプロットを実装してください。 - 使用ライブラリ: chart.js と @sgratzl/chartjs-chart-boxplot の BoxPlotController・BoxAndWiskers、react-chartjs-2 の Chart コンポーネント - サンプルデータ: 部門別の月次売上分布(min・q1・median・q3・max・outliers)を事前計算して渡すこと - インタラクティブ: Chart.js 標準のツールチップでホバー時に統計値を表示すること - 外れ値: outliers 配列を渡して外れ値を点として描画すること - レスポンシブ: responsive: true・maintainAspectRatio: false を設定すること - スタイリング: backgroundColor・borderColor に各グループの識別しやすい色を設定すること
このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
4. ApexCharts (react-apexcharts)
type="boxPlot"を指定し、y: [min, q1, median, q3, max] の配列を渡すだけで箱ひげ図を描画。ボックスの上下部分の色を個別に設定できる。
チャートを読み込み中...
y: [min, q1, median, q3, max] の5値配列を渡すだけで描画。外部パッケージ不要でボックスプロットをネイティブにサポートしている。 CSS変数(--apx-*)を読む仕組みはありますが、再読み込みの呼び出しが別途必要なため、サイトのダークモードには追従しません(ライト表示で固定しています)。'use client';
import dynamic from 'next/dynamic';
const Chart = dynamic(() => import('react-apexcharts'), { ssr: false });
export function ApexBoxPlot() {
const options = {
chart: { type: 'boxPlot' as const, toolbar: { show: false } },
colors: ['#3b82f6', '#10b981'],
plotOptions: {
boxPlot: {
colors: { upper: 'rgba(59,130,246,0.3)', lower: 'rgba(16,185,129,0.3)' },
},
},
xaxis: { type: 'category' as const },
tooltip: { shared: false },
dataLabels: { enabled: false },
};
const series = [{
type: 'boxPlot',
data: [
{ x: '営業部', y: [820, 950, 1100, 1280, 1450] },
{ x: 'マーケ部', y: [600, 780, 920, 1050, 1200] },
{ x: 'CS部', y: [700, 860, 980, 1120, 1300] },
{ x: 'パートナー部', y: [900, 1050, 1200, 1380, 1550] },
],
}];
return <Chart type="boxPlot" options={options} series={series} height={300} width="100%" />;
}AIプロンプトテンプレート
React + Tailwind CSSで、ApexCharts(react-apexcharts)を使ったボックスプロットを実装してください。
- 使用ライブラリ: react-apexcharts の Chart コンポーネント(dynamic importでSSR無効化)
- サンプルデータ: 4部門の月次売上分布(営業部・マーケ部・CS部・パートナー部)を用意すること
- データ形式: series[0].data に { x: '部門名', y: [min, q1, median, q3, max] } 配列を渡すこと
- グラフ設定: type="boxPlot"、chart.type: "boxPlot"、toolbar非表示
- スタイリング: plotOptions.boxPlot.colors.upper・lowerでボックスの上下部分の色を設定すること
- ツールチップ: tooltip.shared: falseで各ボックスの統計値を個別表示することこのプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
ライブラリ比較
| アプローチ | レンダリング | ボックスプロット対応 | 自動統計計算 | おすすめ用途 |
|---|---|---|---|---|
| Nivo | SVG | ◎ 専用パッケージ | ◎ | デザイン重視のダッシュボード |
| D3.js カスタム | SVG | ◎ 完全カスタム | ◎ | 複雑な統計可視化 |
| Chart.js カスタム | Canvas | ◯ プラグイン | △ 事前計算必要 | 大量データ・高パフォーマンス |
| ApexCharts | SVG | ◎ ネイティブ対応 | △ 事前計算必要 | シンプルなダッシュボード |
選択のポイント
- Nivo: @nivo/boxplotが最もバランスが良く、生データを渡すだけで統計計算から描画まで自動処理。本番環境への導入に最もおすすめ。
- D3.js: 独自の統計処理や高度なカスタマイズが必要な研究・分析ツールに最適。実装コストは最も高い。
- Chart.js: 既にChart.jsを使用しているプロジェクトへの追加が容易。統計値を事前に計算して渡す必要があるが、Canvas描画で大量データでも安定動作。
- ApexCharts: boxPlotをネイティブにサポートし、追加パッケージ不要。
y: [min, q1, median, q3, max]の5値配列を渡すだけで手軽に箱ひげ図を実装できる。
典型的な使用例
- 📊成績・スコア分布:テスト結果や評価スコアのばらつきと中央値をグループ間で比較
- 💰売上分布の比較:部門・地域・製品カテゴリー別の売上分布とばらつきを分析
- 🔬実験データの分析:複数条件下での測定値の分布と外れ値を統計的に可視化
- 👥パフォーマンス評価:チーム・個人のKPI分布を比較して改善ポイントを特定
⚠️使用時の注意点
- •ボックスプロットはデータの分布を示すため、最低でも各グループ10件以上のデータがあると意味のある可視化になる
- •外れ値の定義(一般的にはIQR×1.5を超える値)をドキュメントや凡例で明示する
- •中央値と平均値は異なる概念であることをユーザーに伝えるラベル設計にする
- •データ件数が少ない場合は散布図や個別のデータポイント表示の方が適している場合がある
ボックスプロット(箱ひげ図)は、データの分布・中央値・四分位数・外れ値を1つの図で表現する統計グラフ。データのばらつきを俯瞰するのに適している。
テスト点数の分布比較・製品品質のばらつき分析・A/Bテスト結果の可視化など、統計的な分析を行う場面で使われる。
- 基本型(箱ひげのみ)
- 外れ値プロット付き型
- バイオリン型との複合
- グループ比較型
- 水平型
📊 使用しているサンプルデータ(クリックで表示)
4つの部門の月次売上データの分布(最小値・第1四分位・中央値・第3四分位・最大値・外れ値)を使用しています。
関連する逆引きリファレンス
- → 色・スタイルのカスタマイズ(borderColor・fillOpacity など)
- → ツールチップのカスタマイズ(カスタムHTML・フォーマッタ)
- → 軸(Axis)の設定(ラベルフォーマット・対数スケール・複数軸)
- → レスポンシブ対応(コンテナ追従・アスペクト比・リサイズ)
- → アニメーション・トランジション(初期描画・データ更新・イージング)
- → 凡例(Legend)の配置・スタイル(位置・アイコン・系列トグル)
- → データラベルの表示(値・位置・フォーマッタ)
- → クリックイベント・インタラクション(クリック・ホバー・ブラシ選択)
- → グリッド線のカスタマイズ(表示制御・線スタイル・リファレンスライン)
同じカテゴリの他のページ
エリアチャート(Area Chart)の実装比較
Recharts・Nivo・Chart.js・ApexChartsによるエリアチャート実装比較。fillOpacity・グラデーション・tooltip・レスポンシブ対応などのデモ・コード付き。
ストリームグラフ(Streamgraph)の実装比較
ApexCharts・Mantine Charts・Nivo・D3.jsのストリームグラフ実装を比較。type="stream"・stackOffsetWiggle・inside-outと積み上げ面の切り替えのデモ・コード付き。
ワッフルチャート(Waffle Chart)の実装比較
Mantine Charts・Nivo・自前のSVGのワッフルチャート実装を比較。WaffleChart・@nivo/waffle・cellComponentの人型アイコン・「100人中◯人」と内訳の切り替えのデモ・コード付き。