Charts · Radial

VolvelleChart

Concentric categorical rings read against one index. Family: Radial · chart 32 of 60.

Duty rota
ring	segment	under the index
Day	Mon	no
Day	Tue	no
Day	Wed	no
Day	Thu	no
Day	Fri	no
Day	Sat	yes
Day	Sun	no
Shift	Early	no
Shift	Late	no
Shift	Night	yes
Team	Atlas	no
Team	Borealis	no
Team	Cygnus	no
Team	Draco	no
Team	Eridanus	yes

Report an issue with this chart

Duty rota
ring	segment	under the index
Day	Mon	no
Day	Tue	no
Day	Wed	no
Day	Thu	no
Day	Fri	no
Day	Sat	yes
Day	Sun	no
Shift	Early	no
Shift	Late	no
Shift	Night	yes
Team	Atlas	no
Team	Borealis	no
Team	Cygnus	no
Team	Draco	no
Team	Eridanus	yes

mode="precision"

Duty rota
ring	segment	under the index
Day	Mon	no
Day	Tue	no
Day	Wed	no
Day	Thu	no
Day	Fri	no
Day	Sat	yes
Day	Sun	no
Shift	Early	no
Shift	Late	no
Shift	Night	yes
Team	Atlas	no
Team	Borealis	no
Team	Cygnus	no
Team	Draco	no
Team	Eridanus	yes

substrate="green"

Duty rota
ring	segment	under the index
Day	Mon	no
Day	Tue	no
Day	Wed	no
Day	Thu	no
Day	Fri	no
Day	Sat	yes
Day	Sun	no
Shift	Early	no
Shift	Late	no
Shift	Night	yes
Team	Atlas	no
Team	Borealis	no
Team	Cygnus	no
Team	Draco	no
Team	Eridanus	yes

ground="cyanotype"

Example

The chart above, in each framework. Pick a framework once and every example on the site follows it. Each row is a ring: a `label` and its `segments`, from the inside out.

shell

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

tsx

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

const data = [
  { label: 'Day', segments: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] },
  { label: 'Shift', segments: ['Early', 'Late', 'Night'] },
  { label: 'Team', segments: ['Atlas', 'Borealis', 'Cygnus', 'Draco', 'Eridanus'] },
];

export default function App() {
  return (
    <div style={{ width: 480 }}>
      <VolvelleChart
        data={data}
        indexRing={1}
        indexValue="Night"
        title="Duty rota"
      />
    </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 { SpVolvelleChart } from '@silverpoint/vue/volvelle-chart';

const data = [
  { label: 'Day', segments: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] },
  { label: 'Shift', segments: ['Early', 'Late', 'Night'] },
  { label: 'Team', segments: ['Atlas', 'Borealis', 'Cygnus', 'Draco', 'Eridanus'] },
];
</script>

<template>
  <div style="width: 480px">
    <SpVolvelleChart
      :data="data"
      :index-ring="1"
      index-value="Night"
      title="Duty rota"
    />
  </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 { SpVolvelleChart } from '@silverpoint/angular/volvelle-chart';

@Component({
  selector: 'app-root',
  imports: [SpVolvelleChart],
  template: `
    <div style="width: 480px">
      <sp-volvelle-chart
        [data]="data"
        [indexRing]="1"
        indexValue="Night"
        title="Duty rota"
      />
    </div>
  `,
})
export class App {
  protected readonly data = [
    { label: 'Day', segments: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] },
    { label: 'Shift', segments: ['Early', 'Late', 'Night'] },
    { label: 'Team', segments: ['Atlas', 'Borealis', 'Cygnus', 'Draco', 'Eridanus'] },
  ];
}

shell

pip install reflex-silverpoint-react

python

import reflex as rx
from reflex_silverpoint_react import volvelle_chart

DATA = [
    {"label": "Day", "segments": ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]},
    {"label": "Shift", "segments": ["Early", "Late", "Night"]},
    {"label": "Team", "segments": ["Atlas", "Borealis", "Cygnus", "Draco", "Eridanus"]},
]


def index() -> rx.Component:
    return rx.box(
        volvelle_chart(
            data=DATA,
            index_ring=1,
            index_value="Night",
            title="Duty rota",
        ),
        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 { VolvelleChart } from '@silverpoint/react/volvelle-chart';`
Vue	`import { SpVolvelleChart } from '@silverpoint/vue/volvelle-chart';`
Angular	`import { SpVolvelleChart } from '@silverpoint/angular/volvelle-chart'; // <sp-volvelle-chart>`
Reflex	`from reflex_silverpoint_react import volvelle_chart`

Props

The props VolvelleChart 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
`rings`	`rings`	`rings`	`number`	Rings shown, from the inside out; all by default.
`indexRing`	`index-ring`	`index_ring`	`number`	The ring whose segment is brought under the index, 0-based; 0 by default.
`indexValue`	`index-value`	`index_value`	`string`	The segment of `indexRing` under the index; its first segment by default.

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 VolvelleChart? Open an issue on GitHub — the form comes pre-filled with the chart and the version.

VolvelleChart

Example

Import

Props

Common props

Events