> This library is deprecated. Please see `DEPRECATED.md`.
# Radial chart
`RadialChart` is responsible for creating pie and donut charts. While this kind of chart is easy to overlook as insignificant, intentionally confusing, or almost always replaceable with a treemap; they can be useful for quickly showing small groups. People don't understand angles very well [(such is our biology)](https://www.interaction-design.org/literature/book/the-encyclopedia-of-human-computer-interaction-2nd-ed/data-visualization-for-human-perception), but over the last hundred years we have seen a lot of pie charts! This has caused us to become intimately familiar with them.
We can leverage this familiarity to quickly transmit information to our reader. The best type of information to display in this way (in our opinion) is groups of less 6 or so. More than that becomes pretty hard to compare and the reader just sees visual noise. The radial chart is easy to deploy:
```jsx
```
The radial chart accepts children if you wish to give it them. This can be useful for adding tooltips, for example:
## Data format Reference
Radial chart has a very similar API to the arc series, but with even fewer requirements. To wit the data can be as simple as
```javascript
const myData = [{angle: 1}, {angle: 5}, {angle: 2}]
```
Or as complex as
[
{angle: 1, radius: 10},
{angle: 2, label: 'Super Custom label', subLabel: 'With annotation', radius: 20},
{angle: 5, radius: 5, label: 'Alt Label'},
{angle: 3, radius: 14},
{angle: 5, radius: 12, subLabel: 'Sub Label only', className: 'custom-class'}
];
#### angle
Type: `number`
The only required property for the data, this determines the angular size of each wedge.
#### radius
Type: `number`
The distance between the origin and the outside of the arc. This values is scaled linearly by default
#### label
Type: `string`
The label to show next to the wedge.
#### subLabel
Type: `string`
The subLabel to show next to the wedge. This can be used for annotations to the top label.
#### color (optional)
Type: `string|number`
The color of a box in the series. By default the color is interpreted as number to be scaled to a color range. This can be over-ridden by providing the prop colorType="literal" to the series itself. This property can also be defined on the series level.
#### style (optional)
Type: `object`
SVG paths (which is what the arc series is made up of) have numerous manipulable properties, so rather than trying to prescribe all of them as props we offer a port to let you style it for yourself. This overrides the series level version of this property.
#### className (optional)
Type: `string`
The className to be added to an individual arc in the series.
#### padAngle (optional)
Type: `number|function`
The padding to be applied between arcs. See above donut chart for an example of a padded angle.
## Api
##### angleDomain, angleRange, angleType
Scale properties for the `angle` scale. The `angle` property _should be_ passed in the data, otherwise the chart won't be shown.
Please refer to [Scales and Data](scales-and-data.md) for more information about scales.
##### animation (optional)
Type: `boolean|Object`
Please refer to [Animation](animation.md) doc for more information.
##### className (optional)
Type: `string`
DOM classNames to be added to the wrapper component.
##### colorDomain, colorRange, colorType
Scale properties for the `color` scale. If `color` property is not passed in the data object, each new section of the chart gets the next color (e. g. the `'category'` scale is applied).
Please refer to [Scales and Data](scales-and-data.md) for more information about scales.
##### data
Type: `Array