ボックスプロットライブラリ比較

4つのアプローチでデータの分布・中央値・外れ値を可視化し、実装方法とスタイルを比較

このページでは、Nivo・D3.js・Chart.js・ApexChartsを使ったボックスプロット(箱ひげ図)の実装パターンをインタラクティブなデモとコードで確認できます。

箱ひげ図は四分位数で要約するため、山が2つある分布も1つの箱に見えます。分布の形をそのまま見たい場合は、値を区間に分けて数えるヒストグラムが向いています。ヒストグラム(Histogram)の実装比較 →

1. Nivo(@nivo/boxplot)

@nivo/boxplotパッケージでボックスプロットをネイティブサポート。生データを渡すと四分位数・中央値・外れ値を自動計算して描画。ホバー時のツールチップや色のカスタマイズも充実しており、最も手軽に高品質なボックスプロットを実装できる。

✓ 専用パッケージ✓ 美しいデザイン✓ 外れ値対応✓ ダーク自動追従
特徴: D3.jsベースの高品質な実装。アニメーションやツールチップが標準装備で、デザイン性の高いダッシュボードに最適。
tsx
'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)・スタイルまで完全にコントロール可能。実装コストは高いが、独自の統計表現や複雑なインタラクションが必要な場合に最適。

✓ 完全カスタマイズ✓ 統計計算内蔵✓ 高い表現力✓ ダーク自動追従
200400600800100012001400160018002000営業部マーケ部CS部パートナー部
特徴: 生データを渡すと、d3-arrayのquantile()で四分位数を求め、1.5×IQRの外側を外れ値として描く(計算済みの値を渡すほかの節と同じ結果になる)。 SVGをJSXで描くため、アニメーションや独自インタラクションも自由に足せる。
tsx
'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描画のため大量のデータポイントや外れ値が多い場合でもパフォーマンスが安定。

✓ Canvas描画✓ プラグイン対応✓ 高パフォーマンス
特徴: Canvas APIによる高パフォーマンス描画。既存のChart.jsプロジェクトへの追加が容易で、事前計算済みの統計値をそのまま渡せる。 色は文字列で指定する仕様でCSSを参照できないため、サイトのダークモードには追従しません(ライト表示で固定しています)。
tsx
'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-*)を読む仕組みはありますが、再読み込みの呼び出しが別途必要なため、サイトのダークモードには追従しません(ライト表示で固定しています)。
tsx
'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の回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。

ライブラリ比較

アプローチレンダリングボックスプロット対応自動統計計算おすすめ用途
NivoSVG◎ 専用パッケージ◎デザイン重視のダッシュボード
D3.js カスタムSVG◎ 完全カスタム◎複雑な統計可視化
Chart.js カスタムCanvas◯ プラグイン△ 事前計算必要大量データ・高パフォーマンス
ApexChartsSVG◎ ネイティブ対応△ 事前計算必要シンプルなダッシュボード

選択のポイント

  • 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四分位・最大値・外れ値)を使用しています。

関連する逆引きリファレンス