# SmartVisuals Radial Bar for Power BI

> Power BI radial bar chart and progress rings: each ring to its target, met or missed by colour and symbol, status bands, and premium pace and projected landing.

- Page: https://www.smartvisuals.io/visuals/radial-bar
- Fields and settings: https://www.smartvisuals.io/visuals/radial-bar/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-radial-bar?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-radial-bar-1.0.0.0.pbiviz
- Price: Free tier for every viewer; premium $1.99 per user per month or $19 per user per year on Microsoft Marketplace, with a 30-day free trial. Premium works in edit mode without a licence; unlicensed viewers see the free tier, never a blocked visual.
- Certified by Microsoft: no
- Version: 1.0.0.0
- GUID (visualType and publicCustomVisuals): `smartvisualsRadialBarA6A1ADAACFCDA477BCFC22469F070054`

## What is free

- **Radial bars on a shared maximum**: A circular value grid and labels at the start of each ring; arc length is proportional to the value.
- **Progress rings and a single ring**: Each ring to its own target, or one ring with a big number for one KPI.
- **Targets, free**: From a field or one target for all; met or missed by colour and by symbol, with your own Met at and Close at thresholds, and a darker second lap past the target.
- **Status bands, free**: The track shaded missed, close and met from your thresholds and colours, split by gaps and patterned so colour is never the only cue.
- **Shape**: Track, gap between rings, rounded or square ends, start angle, 270 degrees, full circle or semicircle, inner radius, sort, and a straight-on depth style (no 3D tilt).
- **Centre, labels and Other**: Centre total, the hovered ring or a measure of your own; ring labels, a legend, Top N + Other, conditional formatting (fx) and fill patterns.
- **Smart caption and footnote**: A caption that names who is furthest along and counts the rings that met their goal, and a methods footnote.
- **Power BI features**: Tooltips and report page tooltips, highlight and cross-filter with Ctrl to add, bookmarks, context menu, drilldown, a show condition, six templates, four themes, four fonts, on-object formatting and 20 languages.

## What premium adds

- **Pace**: A tick where each ring should be by now, from a Period elapsed field, a typed share or the period dates, marked on track, behind or ahead.
- **Projected landing**: A dashed extension of each ring to where the current run rate, or the plan to date, takes it.
- **Required run rate**: What each ring needs per month, week, quarter or day from here to reach its target, at the ring end, in the tooltip and in the findings.
- **Last period's ghost arc**: Where each ring stood last period, with the % change, the value change or the share shift.
- **Findings and small multiples**: Up to five findings with how each was calculated, and one set of rings per region or team.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Category | `category` | Column | Optional | The parts: slices, petals, rings, cells, icons, stages or columns |
| Values | `values` | Measure | Optional | The size of each part |
| Compare | `compare` | Measure | Optional | Last period, plan or any reference: share shift, ghost marks, findings (premium) |
| Target | `target` | Measure | Optional | A goal per part |
| Period elapsed | `elapsed` | Measure | Optional | Share of the period gone (0-1 or %): pace and landing (premium) |
| Plan to date | `planToDate` | Measure | Optional | Where the actual should be today, if not linear (premium) |
| Annotation | `annotation` | Measure | Optional | Text measure: a callout on the part |
| Small multiples | `facet` | Column | Optional | One chart per value |
| Tooltips | `tooltips` | Measure | Optional | Extra fields in tooltips |
| Centre value | `centreValue` | Measure | Optional | Shown in the centre instead of the total (a ratio: make every part return the same value, e.g. with ALLSELECTED) |
| Show condition | `showCondition` | Measure | Optional | A measure returning 1 / TRUE to show the chart, 0 / FALSE / blank to show a message instead |

## Format pane

Each card is a key under `visual.objects` in a PBIR visual.json; each setting is a property of it. Toggles take `true`/`false`, choices and text a value in single quotes (`'auto'`), numbers a `D` suffix (`12D`).

### Templates (`templates`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Style Template | `preset` | `none` (None (style defaults)), `executive` (Executive), `ibcs` (IBCS (Finance)), `minimal` (Minimal), `presentation` (Presentation), `print` (Print), `infographic` (Infographic), `custom` (Custom) |
| Applied | `applied` | Text |

### Radial Axis (`radialAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Grid Circles | `show` | On / off |
| Axis Values | `labels` | On / off |
| Number of Circles | `count` | Number |
| Maximum (0 = auto) | `max` | Number |
| Grid Colour | `color` | Colour |

### Radial Bar (`radial`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Layout | `mode` | `auto` (Auto (rings when a target is set)), `bars` (Radial bars (shared maximum)), `rings` (Progress rings (each to its target)), `single` (Single ring (KPI)) |
| Arc | `arc` | `threeQuarter` (Three quarters (270°)), `full` (Full circle), `semi` (Semicircle) |
| Start Angle (°) | `startAngle` | Number |
| Inner Radius (%) | `innerRadius` | Number |
| Gap Between Rings (%) | `gap` | Number |
| Track | `track` | On / off |
| Bar Ends | `caps` | `theme` (From theme), `round` (Rounded), `square` (Square) |
| Ring Labels | `labelPosition` | `start` (At the start of each ring), `end` (At the end of each bar), `none` (None) |
| Depth Style (no tilt) | `depth` | On / off |
| Status Bands on the Track | `bands` | On / off |

### Sorting and Other (`sorting`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Sort | `sort` | `desc` (Largest first), `asc` (Smallest first), `name` (Name), `data` (Data order), `order` (Stage order field) |
| Readers Can Change the Sort | `readerSort` | On / off |
| Group Small Items Into Other | `other` | On / off |
| Show at Most (items) | `maxItems` | Number |
| Group Items Below (%) | `minShare` | Number |
| Other Label | `otherLabel` | Text |

### Data Labels (`labels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `category` (Category), `value` (Value), `percent` (Percent of total), `categoryPercent` (Category, percent), `categoryValue` (Category, value), `valuePercent` (Value, percent), `all` (Category, value, percent) |
| Position | `position` | `auto` (Auto), `inside` (Inside), `outside` (Outside with leader lines) |
| Percent Decimals | `percentDecimals` | Number |
| Display Units | `displayUnits` | `auto` (Auto), `none` (None), `K` (Thousands), `M` (Millions), `B` (Billions) |
| Value Decimals (-1 = auto) | `valueDecimals` | Number |
| Hide Labels Below (%) | `hideBelow` | Number |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |
| Detail Text Size | `detailSize` | Number |
| Detail Text Colour | `detailColor` | Colour |

### Centre (`centre`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `total` (Total), `hover` (Hovered item, else total), `largest` (Largest item's share) |
| Caption Under the Value | `label` | Text |
| Value Font Size (0 = auto) | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Legend (`legend`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `auto` (Auto (only when labels do not name the items)), `top` (Top), `bottom` (Bottom), `right` (Right), `left` (Left) |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Colour Rules (`colorRules`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Rule | `mode` | `none` (None (one colour per item)), `rank` (Highlight the top N), `value` (Above / below a value), `share` (Above / below a share (%)) |
| Top N | `topN` | Number |
| Threshold | `threshold` | Number |
| Highlight / Above Colour | `highColor` | Colour |
| Others / Below Colour | `lowColor` | Colour |

### Compare (`compare`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show the Comparison | `show` | On / off |
| Comparison Name | `name` | Text |
| Change Labels | `labels` | `pp` (Share shift (pp)), `value` (Value change), `percent` (% change), `none` (None) |
| Draw the Comparison (ghost) | `ghost` | On / off |
| Sort by Change | `sortByChange` | On / off |
| Volume vs Mix Split | `volumeMix` | On / off |
| Concentration (HHI, top 3) | `concentration` | On / off |
| Share Bridge (points won and lost) | `shareBridge` | On / off |
| Movers in the Bridge | `bridgeItems` | Number |
| Segment CAGR Above Columns | `cagr` | On / off |
| Years Between the Periods | `years` | Number |

### Targets (`targets`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Targets | `show` | On / off |
| One Target for All (0 = off) | `global` | Number |
| Met at (% of target) | `metAt` | Number |
| Close at (% of target) | `closeAt` | Number |
| Met Colour | `metColor` | Colour |
| Close Colour | `closeColor` | Colour |
| Missed Colour | `missedColor` | Colour |
| Colour Items by Status | `statusColors` | On / off |

### Pace (`pace`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Pace | `show` | On / off |
| Share of Period Elapsed (%, 0 = from the field or dates) | `elapsed` | Number |
| Period Start (yyyy-mm-dd) | `periodStart` | Text |
| Period End (yyyy-mm-dd) | `periodEnd` | Text |
| On Track Within (%) | `tolerance` | Number |
| Projected Landing | `projection` | On / off |
| Required Run Rate | `runRate` | On / off |
| Run Rate per | `unit` | `month` (Month), `week` (Week), `quarter` (Quarter), `day` (Day) |
| Units in the Whole Period (0 = a year, or from the dates) | `units` | Number |

### Findings (`findings`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| What Changed (findings) | `show` | On / off |
| Number of Findings | `max` | Number |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Smart Caption (`caption`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `top` (Top), `bottom` (Bottom) |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Small Multiples (`smallMultiples`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Columns (0 = auto) | `columns` | Number |
| Shared Scale | `sharedScale` | On / off |
| Size Pies by Their Total | `sizeByTotal` | On / off |
| Title Font Size | `titleSize` | Number |
| Title Colour | `titleColor` | Colour |

### Annotations (`annotations`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Show Condition (`showCondition`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Message When Hidden | `message` | Text |

### Data Table (`dataTable`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Table Button in the Visual | `button` | On / off |
| Open as Table | `start` | On / off |

### Zoom (`zoom`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Ctrl + Wheel Zooms, Drag Pans | `enabled` | On / off |

### Footnote (`footnote`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Source | `source` | Text |
| State the Methods | `showMethod` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Axis Text (`axes`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Axis Values and Titles | `show` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Tabs and Buttons (`controls`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Patterns (Tell Items Apart Without Colour) | `patterns` | On / off |
| Focus Outline Colour | `focusColor` | Colour |
| Focus Outline Width | `focusWidth` | Number |
| Minimum Text Size (0 = off) | `minFontSize` | Number |
| Reduce Motion | `reduceMotion` | On / off |

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean (White)), `slate` (Slate) |
| Font | `font` | `inter` (Inter), `segoe` (Segoe UI), `arial` (Arial), `georgia` (Georgia) |
| Transparent Background | `transparentBg` | On / off |

### Data Colours (`dataPoint`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Colour | `fill` | Colour |
