バイオリンプロットライブラリ比較
3つのライブラリで同じデータを表示し、実装方法とスタイルを比較
このページでは、Plotly.js・D3.js・ApexChartsを使ったバイオリンプロット(Violin Plot)の実装パターンをインタラクティブなデモとコードで確認できます。
バイオリンプロットは分布を滑らかな密度の曲線で推定して描きます。区間ごとの実際の件数を見たい場合は、ヒストグラムが向いています。ヒストグラム(Histogram)の実装比較 →
1. Plotly.js (react-plotly.js)
type: 'violin' でネイティブサポート。ボックスプロットや平均線を重ねて表示でき、ホバー時に詳細な統計情報を確認できる。
チャートを読み込み中...
type: 'violin' を指定するだけでKDE計算から描画まで自動処理される。box.visible: true でボックスプロットを重ね表示でき、ほとんどのユースケースで最初の選択肢になる。 暗色テンプレートがJS版に同梱されていないため、サイトのダークモードには追従しません(ライト表示で固定しています)。'use client';
import dynamic from 'next/dynamic';
const Plot = dynamic(() => import('react-plotly.js'), { ssr: false });
const dataMap: Record<string, number[]> = {
'グループA': [52,58,61,63,65,67,68,69,70,71,72,73,74,75,76,77,78,80,83,88],
'グループB': [40,45,50,55,58,60,62,65,68,70,72,75,78,80,83,85,88,90,93,98],
'グループC': [60,62,64,65,66,67,68,69,70,71,71,72,72,73,74,75,76,77,78,80],
};
const colors = ['#4f86c6', '#f59e0b', '#10b981'];
export function PlotlyViolin() {
const traces = Object.entries(dataMap).map(([name, y], i) => ({
type: 'violin' as const,
name,
y,
box: { visible: true },
meanline: { visible: true },
points: 'none' as const,
fillcolor: colors[i],
line: { color: colors[i] },
opacity: 0.7,
}));
return (
<Plot
data={traces}
layout={{
yaxis: { title: { text: '値' } },
violingap: 0.3,
violinmode: 'group',
margin: { t: 20, b: 40, l: 50, r: 20 },
height: 400,
showlegend: true,
paper_bgcolor: 'transparent',
plot_bgcolor: 'transparent',
}}
config={{ displayModeBar: false }}
style={{ width: '100%' }}
/>
);
}AIプロンプトテンプレート
React + Tailwind CSSで、Plotly.jsを使ったバイオリンプロットを実装してください。 - 使用ライブラリ: react-plotly.js(next/dynamicでSSR無効化) - type: 'violin' を使用 - 3グループのデータを並べて表示(violinmode: 'group') - box.visible: true でボックスプロットを重ねて表示 - meanline.visible: true で平均線を表示 - ホバー時に統計情報(中央値・四分位など)を表示 - サンプルデータ: グループA・B・C 各20サンプル
このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
2. D3.js カスタム実装(KDE)
d3-arrayでKDE(エパネチニコフカーネルによるカーネル密度推定)を計算し、d3-scaleで座標に変換、d3-shapeのarea()でバイオリン形状のパスを作る。SVGはReactのJSXで描くので、形状・色・アニメーションを完全にコントロールできる。
area() の x0・x1 で左右対称のパスにする。 d3は計算だけを担当し、描画はJSXなので、Reactの状態やスタイルと組み合わせやすい。学習コストは高いが、形状・色・アニメーションを完全にコントロールできる。デザインにこだわりたい場合や独自の可視化が必要な場合に有効。'use client';
import { extent, max, mean, range } from 'd3-array';
import { scaleBand, scaleLinear } from 'd3-scale';
import { area, curveCatmullRom } from 'd3-shape';
const dataMap: Record<string, number[]> = {
'グループA': [52,58,61,63,65,67,68,69,70,71,72,73,74,75,76,77,78,80,83,88],
'グループB': [40,45,50,55,58,60,62,65,68,70,72,75,78,80,83,85,88,90,93,98],
'グループC': [60,62,64,65,66,67,68,69,70,71,71,72,72,73,74,75,76,77,78,80],
};
const colors = ['#4f86c6', '#f59e0b', '#10b981'];
const WIDTH = 580;
const HEIGHT = 380;
const margin = { top: 20, right: 20, bottom: 40, left: 55 };
const BANDWIDTH = 5; // KDE の帯域幅(値の単位)。大きいほど形がなめらかになる
// エパネチニコフカーネル
function kernelEpanechnikov(bandwidth: number) {
return (x: number) => {
const u = x / bandwidth;
return Math.abs(u) <= 1 ? (0.75 * (1 - u * u)) / bandwidth : 0;
};
}
// d3 は計算(KDE・スケール・パス)だけを担当し、SVG は React の JSX で描く
export function D3Violin() {
const groups = Object.keys(dataMap);
const [minValue, maxValue] = extent(Object.values(dataMap).flat()) as [number, number];
// 値 → 縦位置、グループ → 横の帯
const y = scaleLinear()
.domain([minValue - 5, maxValue + 5])
.range([HEIGHT - margin.bottom, margin.top]);
const x = scaleBand().domain(groups).range([margin.left, WIDTH - margin.right]);
const halfWidth = (x.bandwidth() / 2) * 0.85;
const kernel = kernelEpanechnikov(BANDWIDTH);
const violins = groups.map((group, i) => {
const values = dataMap[group];
const [lo, hi] = extent(values) as [number, number];
// 密度は「最小値−帯域幅」〜「最大値+帯域幅」で計算する(その外側は0)
const density: [number, number][] = range(lo - BANDWIDTH, hi + BANDWIDTH + 1).map((t) => [
t,
mean(values, (v) => kernel(t - v)) ?? 0,
]);
const cx = (x(group) ?? 0) + x.bandwidth() / 2;
// 密度 → 中心からの幅(いちばん太いところを halfWidth にそろえる)
const width = scaleLinear().domain([0, max(density, (d) => d[1]) ?? 1]).range([0, halfWidth]);
const path = area<[number, number]>()
.x0((d) => cx - width(d[1]))
.x1((d) => cx + width(d[1]))
.y((d) => y(d[0]))
.curve(curveCatmullRom)(density);
return { group, cx, path: path ?? '', color: colors[i] };
});
return (
<svg viewBox="0 0 580 380" className="w-full">
{y.ticks(7).map((tick) => (
<g key={tick}>
<line x1={margin.left} x2={WIDTH - margin.right} y1={y(tick)} y2={y(tick)} stroke="#e5e7eb" strokeWidth={0.5} />
<line x1={margin.left - 4} x2={margin.left} y1={y(tick)} y2={y(tick)} stroke="#9ca3af" />
<text x={margin.left - 8} y={y(tick) + 4} textAnchor="end" fontSize={10} fill="#9ca3af">
{tick}
</text>
</g>
))}
{violins.map((v) => (
<path key={v.group} d={v.path} fill={v.color} fillOpacity={0.7} stroke={v.color} strokeWidth={1} />
))}
<line x1={margin.left} x2={margin.left} y1={margin.top} y2={HEIGHT - margin.bottom} stroke="#9ca3af" />
<line x1={margin.left} x2={WIDTH - margin.right} y1={HEIGHT - margin.bottom} y2={HEIGHT - margin.bottom} stroke="#9ca3af" />
{violins.map((v) => (
<text key={v.group} x={v.cx} y={HEIGHT - margin.bottom + 18} textAnchor="middle" fontSize={12} fill="#374151">
{v.group}
</text>
))}
</svg>
);
}AIプロンプトテンプレート
React + Tailwind CSSで、D3.jsを使ったバイオリンプロットを実装してください。 - 使用ライブラリ: d3-array(extent・mean・max・range)・d3-scale(scaleBand・scaleLinear)・d3-shape(area・curveCatmullRom) - d3 は計算(KDE・スケール・パス)だけに使い、SVG は React の JSX で描くこと(useEffect で DOM を直接操作しない) - エパネチニコフカーネルによるKDE(カーネル密度推定)を実装し、各グループの「最小値−帯域幅」〜「最大値+帯域幅」の範囲で密度を計算すること - d3.area() の x0・x1 で左右対称のバイオリン形状を作ること - xScaleはscaleBand、yScaleはscaleLinear。viewBox を使って親要素の幅に追従させること - 3グループを横並びで表示 - サンプルデータ: グループA・B・C 各20サンプル
このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
3. ApexCharts (react-apexcharts)
ApexCharts v8 の chart.type: 'violin'。観測値の配列を渡すだけで密度(KDE)をライブラリが計算し、points で観測値の点を重ねられる。
チャートを読み込み中...
y に観測値の配列を渡すと密度を計算する(帯域幅は既定で Silverman の目安。plotOptions.violin.kde.bandwidth で変えられる)。v8 から既定のバンドルに入っていないため、import 'apexcharts/violin' で登録する(無いとエラーになり何も描かれない)。既定のツールチップの Min / Max は密度の曲線の端(KDE の裾)でデータの最小・最大ではないため、tooltip.custom で観測値の最小・中央値・最大を出している。react-apexcharts の型の type にはまだ violin が無いので、値は渡したうえで型だけ外している(コード例を参照)。 なお、片側のバイオリン・箱ひげ・反対側の点を並べる raincloud 型は Premium(有料)機能で、ライセンスが無いとグラフに透かしが入りコンソールに警告が出るため、このデモでは使っていない。 CSS変数(--apx-*)を読む仕組みはありますが、再読み込みの呼び出しが別途必要なため、サイトのダークモードには追従しません(ライト表示で固定しています)。'use client';
// ApexViolinChart.tsx(ページ側では next/dynamic の ssr: false で読み込む)
// ApexCharts v8 から violin は既定のバンドルに入っていない。描く前にこの import で登録する
import 'apexcharts/violin';
import Chart from 'react-apexcharts';
import type { ApexOptions } from 'apexcharts';
const dataMap: Record<string, number[]> = {
グループA: [52, 58, 61, 63, 65, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 80, 83, 88],
グループB: [40, 45, 50, 55, 58, 60, 62, 65, 68, 70, 72, 75, 78, 80, 83, 85, 88, 90, 93, 98],
グループC: [60, 62, 64, 65, 66, 67, 68, 69, 70, 71, 71, 72, 72, 73, 74, 75, 76, 77, 78, 80],
};
const colors = ['#4f86c6', '#f59e0b', '#10b981'];
// y に観測値の配列を渡すと、密度(KDE)はライブラリが計算する
const series = [{
name: '値',
data: Object.entries(dataMap).map(([group, values], i) => ({ x: group, y: values, fillColor: colors[i] })),
}];
// 既定のツールチップの Min / Max は密度の曲線の端(KDE の裾)で、データの最小・最大ではない。
// 観測値から最小・中央値・最大を出して、ツールチップを差し替える
const stats = Object.entries(dataMap).map(([group, values]) => {
const s = [...values].sort((a, b) => a - b);
const median = (s[(s.length - 1) >> 1] + s[s.length >> 1]) / 2;
return { group, n: s.length, min: s[0], median, max: s[s.length - 1] };
});
const options: ApexOptions = {
chart: { type: 'violin', toolbar: { show: false } },
plotOptions: { violin: { points: { show: true, size: 3 } } }, // 観測値の点を重ねる
legend: { show: false },
yaxis: { title: { text: '値' } },
tooltip: {
custom: ({ dataPointIndex }: { dataPointIndex: number }) => {
const st = stats[dataPointIndex];
return `<div style="padding:8px 10px;font-size:12px"><strong>${st.group}</strong><br>最小 ${st.min} / 中央値 ${st.median} / 最大 ${st.max}<br>観測数 ${st.n}</div>`;
},
},
};
export default function ApexViolinChart() {
// react-apexcharts の型の type には violin が無い(v8 の新しい種別に型が追いついていない)。
// type を省くと既定の line で上書きされるので、値は渡したうえで型だけ外す
return <Chart type={'violin' as never} series={series} options={options} height={340} />;
}AIプロンプトテンプレート
React + Tailwind CSSで、ApexCharts(react-apexcharts)を使ったバイオリンプロットを実装してください。
- 使用ライブラリ: react-apexcharts + apexcharts v8(chart.type: 'violin')
- v8 では violin が既定のバンドルに入っていないため、import 'apexcharts/violin' で登録すること
- データ形式: { x: グループ名, y: 観測値の配列 } を並べ、密度(KDE)はライブラリに計算させること。色は各点の fillColor で指定
- plotOptions.violin.points.show で観測値の点を重ねること
- 既定のツールチップの Min/Max は KDE の裾の値なので、tooltip.custom で観測値の最小・中央値・最大を表示すること
- TypeScript: react-apexcharts の型の type には violin が無いため、値は渡したうえで型だけ外すこと(例: 'violin' as never)
- raincloud 型は有料(Premium)機能のため使わないこと
- サンプルデータ: グループA・B・C 各20サンプルこのプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。
ライブラリ比較
| ライブラリ | バイオリン対応 | 実装難易度 | インタラクション | おすすめ用途 |
|---|---|---|---|---|
| Plotly.js | ネイティブ(violin) | 低 | ズーム・ホバー・box/points表示 | データ分析・科学系・素早い実装 |
| D3.js | カスタム実装(KDE) | 高 | 自由に実装可能 | 高度なカスタマイズ・学習目的 |
| ApexCharts | ネイティブ(violin) | 低 | ホバー・観測値の点の重ね表示 | 他のグラフも ApexCharts のダッシュボード |
選択のポイント
- Plotly.js:
type: 'violin'でそのまま動く。box.visible・pointsオプションでボックスプロットや散布点を重ねられるなど表現力が高く、ほとんどのユースケースで最初の選択肢になる。 - D3.js: カーネル関数を自分で書き、d3-array・d3-scale・d3-shape と組み合わせて組み立てるため学習コストは高いが、形状・色・アニメーションを完全にコントロールできる。デザインにこだわりたい場合や独自の可視化が必要な場合に有効。
- ApexCharts: 他のグラフも ApexCharts で揃えているダッシュボードに。観測値の配列を渡すだけで描け、点も重ねられる。v8 では機能の import を忘れると何も描かれない点と、レインクラウド(
raincloud)が有料機能である点に注意。
バイオリンプロットは、データの分布形状(密度)を視覚化するグラフ。ボックスプロットより詳細な分布の形状(密度)を確認できる。
グループ間の分布比較・外れ値の検出・データの偏り確認など、統計分析や科学系データの可視化に適している。
- ボックスプロット重ね(box.visible)
- 平均線表示(meanline)
- 散布点重ね(points: 'all')
- 横向きバイオリン(orientation: 'h')
- グループ比較(violinmode: 'group')
📊 使用しているサンプルデータ(クリックで表示)
3グループ各20サンプルの数値データを使用しています。グループAは中央集中型、グループBは広い分布、グループCは高い中央値で分布が狭い特徴を持ちます。
関連する逆引きリファレンス
同じカテゴリの他のページ
エリアチャート(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人中◯人」と内訳の切り替えのデモ・コード付き。