Charts · Distributions & comparisons

ViolinChart

A mirrored kernel density per group. Family: Distributions & comparisons · chart 37 of 60.

Response time by service
service	n	min	q1	median	q3	max
Search	60	134	161.75	178.5	189.5	229
Checkout	60	116	141	200.5	258.5	311
Profile	48	100	113.75	120	128.5	290
Reports	36	303	316.25	344.5	367	518
Login	24	76	83.75	88	95.75	109

Report an issue with this chart

Response time by service
service	n	min	q1	median	q3	max
Search	60	134	161.75	178.5	189.5	229
Checkout	60	116	141	200.5	258.5	311
Profile	48	100	113.75	120	128.5	290
Reports	36	303	316.25	344.5	367	518
Login	24	76	83.75	88	95.75	109

mode="precision"

Response time by service
service	n	min	q1	median	q3	max
Search	60	134	161.75	178.5	189.5	229
Checkout	60	116	141	200.5	258.5	311
Profile	48	100	113.75	120	128.5	290
Reports	36	303	316.25	344.5	367	518
Login	24	76	83.75	88	95.75	109

substrate="green"

Response time by service
service	n	min	q1	median	q3	max
Search	60	134	161.75	178.5	189.5	229
Checkout	60	116	141	200.5	258.5	311
Profile	48	100	113.75	120	128.5	290
Reports	36	303	316.25	344.5	367	518
Login	24	76	83.75	88	95.75	109

ground="cyanotype"

Example

The chart above, in each framework. Pick a framework once and every example on the site follows it.

shell

npm install @silverpoint/react @silverpoint/grounds @silverpoint/fonts

tsx

import '@silverpoint/fonts/fonts.css';
import '@silverpoint/grounds/styles.css';
import { ViolinChart } from '@silverpoint/react/violin-chart';

const data = [
  { service: 'Search', ms: 220 },
  { service: 'Search', ms: 177 },
  { service: 'Search', ms: 158 },
  { service: 'Search', ms: 199 },
  { service: 'Search', ms: 171 },
  { service: 'Search', ms: 138 },
  { service: 'Search', ms: 186 },
  { service: 'Search', ms: 207 },
  { service: 'Search', ms: 181 },
  { service: 'Search', ms: 187 },
  { service: 'Search', ms: 176 },
  { service: 'Search', ms: 187 },
  // … 216 more rows of the same shape
];

export default function App() {
  return (
    <div style={{ width: 480 }}>
      <ViolinChart
        data={data}
        valueKey="ms"
        groupKey="service"
        title="Response time by service"
        unit="ms"
      />
    </div>
  );
}

shell

npm install @silverpoint/vue @silverpoint/grounds @silverpoint/fonts

vue

<script setup lang="ts">
import '@silverpoint/fonts/fonts.css';
import '@silverpoint/grounds/styles.css';
import { SpViolinChart } from '@silverpoint/vue/violin-chart';

const data = [
  { service: 'Search', ms: 220 },
  { service: 'Search', ms: 177 },
  { service: 'Search', ms: 158 },
  { service: 'Search', ms: 199 },
  { service: 'Search', ms: 171 },
  { service: 'Search', ms: 138 },
  { service: 'Search', ms: 186 },
  { service: 'Search', ms: 207 },
  { service: 'Search', ms: 181 },
  { service: 'Search', ms: 187 },
  { service: 'Search', ms: 176 },
  { service: 'Search', ms: 187 },
  // … 216 more rows of the same shape
];
</script>

<template>
  <div style="width: 480px">
    <SpViolinChart
      :data="data"
      value-key="ms"
      group-key="service"
      title="Response time by service"
      unit="ms"
    />
  </div>
</template>

shell

npm install @silverpoint/angular @silverpoint/grounds @silverpoint/fonts

// src/styles.css:
//   @import '@silverpoint/fonts/fonts.css';
//   @import '@silverpoint/grounds/styles.css';

import { Component } from '@angular/core';
import { SpViolinChart } from '@silverpoint/angular/violin-chart';

@Component({
  selector: 'app-root',
  imports: [SpViolinChart],
  template: `
    <div style="width: 480px">
      <sp-violin-chart
        [data]="data"
        valueKey="ms"
        groupKey="service"
        title="Response time by service"
        unit="ms"
      />
    </div>
  `,
})
export class App {
  protected readonly data = [
    { service: 'Search', ms: 220 },
    { service: 'Search', ms: 177 },
    { service: 'Search', ms: 158 },
    { service: 'Search', ms: 199 },
    { service: 'Search', ms: 171 },
    { service: 'Search', ms: 138 },
    { service: 'Search', ms: 186 },
    { service: 'Search', ms: 207 },
    { service: 'Search', ms: 181 },
    { service: 'Search', ms: 187 },
    { service: 'Search', ms: 176 },
    { service: 'Search', ms: 187 },
    // … 216 more rows of the same shape
  ];
}

shell

pip install reflex-silverpoint-react

python

import reflex as rx
from reflex_silverpoint_react import violin_chart

DATA = [
    {"service": "Search", "ms": 220},
    {"service": "Search", "ms": 177},
    {"service": "Search", "ms": 158},
    {"service": "Search", "ms": 199},
    {"service": "Search", "ms": 171},
    {"service": "Search", "ms": 138},
    {"service": "Search", "ms": 186},
    {"service": "Search", "ms": 207},
    {"service": "Search", "ms": 181},
    {"service": "Search", "ms": 187},
    {"service": "Search", "ms": 176},
    {"service": "Search", "ms": 187},
    # … 216 more rows of the same shape
]


def index() -> rx.Component:
    return rx.box(
        violin_chart(
            data=DATA,
            value_key="ms",
            group_key="service",
            title="Response time by service",
            unit="ms",
        ),
        width="480px",
    )


app = rx.App()
app.add_page(index)

Import

Each chart has its own subpath, so a bundle only carries the charts it uses. Every adapter also exports every chart from its barrel.

Framework	Import
React	`import { ViolinChart } from '@silverpoint/react/violin-chart';`
Vue	`import { SpViolinChart } from '@silverpoint/vue/violin-chart';`
Angular	`import { SpViolinChart } from '@silverpoint/angular/violin-chart'; // <sp-violin-chart>`
Reflex	`from reflex_silverpoint_react import violin_chart`

Props

The props ViolinChart adds to the ones every chart takes. Accessor props (…Key, keys, names) name fields of your rows and are ignored without data.

React / Angular	Vue	Reflex	Type	Description
`valueKey`	`value-key`	`value_key`	`Accessor<number \| null \| undefined>`	—
`groupKey`	`group-key`	`group_key`	`Accessor<string \| null \| undefined>`	—
`bandwidth`	`bandwidth`	`bandwidth`	`number`	Kernel bandwidth in data units, shared by every group; Silverman's rule by default.
`quartiles`	`quartiles`	`quartiles`	`boolean`	Marks the quartiles inside each violin; `true` by default.
`orientation`	`orientation`	`orientation`	`ChartOrientation`	—

Common props

Every chart also takes these. Framework conventions: camelCase in React and Angular, kebab-case in Vue templates, snake_case in Reflex. Read more about them.

Show the 22 common props

React / Angular	Vue	Reflex	Type	Description
`data`	`data`	`data`	`readonly Datum[]`	Rows to draw. If omitted, the demo dataset is rendered (REQ-093) and the accessor props (`…_key`, `keys`, `names`) are ignored.
`ground`	`ground`	`ground`	`GroundRef`	Style ground: `silverpoint` or `cyanotype`, or a ground object. Defaults to the app provider's, or `silverpoint`.
`substrate`	`substrate`	`substrate`	`SubstrateName`	Prepared substrate within the ground (REQ-046).
`mode`	`mode`	`mode`	`InkMode`	`ink` by default; `precision` disables inking (REQ-021).
`seed`	`seed`	`seed`	`Seed`	Seed. If omitted, it is derived from `id` stably (REQ-003).
`id`	`id`	`id`	`string`	Stable identifier. If omitted, it is generated deterministically.
`height`	`height`	`height`	`number`	Height of the drawing area in px. Width is the container's unless pinned.
`width`	`width`	`width`	`number`	—
`chrome`	`chrome`	`chrome`	`'card' \| 'bare'`	`card` draws the full frame; `bare` only the drawing area (REQ-095).
`hatchFill`	`hatch-fill`	`hatch_fill`	`'tile' \| 'per-shape'`	How areas are filled (REQ-029).
`title`	`title`	`title`	`string`	—
`badge`	`badge`	`badge`	`string`	—
`value`	`value`	`value`	`string \| number`	—
`unit`	`unit`	`unit`	`string`	—
`footerLeft`	`footer-left`	`footer_left`	`string`	—
`footerRight`	`footer-right`	`footer_right`	`string`	—
`label`	`label`	`label`	`string`	Accessible name. If omitted, it is derived from `title` (REQ-120).
`description`	`description`	`description`	`string`	Long description for screen readers (REQ-120).
`dataTable`	`data-table`	`data_table`	`'visible' \| 'hidden' \| 'none'`	Tabular alternative; `hidden` leaves it for assistive technology only (REQ-121).
`locale`	`locale`	`locale`	`string`	—
`numberFormat`	`number-format`	`number_format`	`Intl.NumberFormatOptions`	—
`className`	`class-name`	`class_name`	`string`	—

Pointer and keyboard exploration are built in. The item under the pointer or focus is reported, and a click, Enter or Space selects it. The item is { seriesKey, index, datum, value, point: { x, y } }.

Framework	Active item	Selection	Custom readout
React	`onActiveChange`	`onSelect`	`tooltip={(item, readout) => …}`
Vue	`@active-change`	`@select`	`<template #tooltip>`
Angular	`(activeChange)`	`(select)`	`<ng-template spTooltip>`
Reflex	`on_active_change`	`on_select`	`tooltip=tooltip_template(…)`

Interaction and readouts →

Report it

Found something wrong with ViolinChart? Open an issue on GitHub — the form comes pre-filled with the chart and the version.

ViolinChart

Example

Import

Props

Common props

Events