# SmartVisuals Rose for Power BI

> Power BI rose chart with petals sized by area: polar area, Nightingale rose, aster and wind rose, months, hours and compass points kept in order, stacked petals.

- Page: https://www.smartvisuals.io/visuals/rose
- Fields and settings: https://www.smartvisuals.io/visuals/rose/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-rose?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-rose-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): `smartvisualsRose5CCEA5A97DEDBE93E147DFA74BF6B189`

## What is free

- **By area, by radius or aster**: By area (the default): a petal twice the value has twice the area. By radius with a footnote that the areas exaggerate; aster with the angle from a second measure.
- **Stacked petals**: Segment stacks the parts inside each petal, Nightingale's own layout, every part sized by area.
- **Cyclical order**: Months, weekdays, hours of the day and compass points stay in order and are never folded into Other; a wind rose puts north at the top and an hour rose puts midnight there, gaps kept.
- **A radial axis**: Grid circles at round values with axis labels outside the petals, and a fixed maximum to compare visuals.
- **Arcs and centre**: Full circle, semicircle, 270 degrees or a custom start and sweep; inner radius with a centre total, a measure of your own or the largest share.
- **Top N + Other and labels**: Other with its members on hover for categories that are not a cycle, labels that add up to 100 %, sorting, gaps between petals.
- **Colour and images**: A colour per category, conditional formatting (fx), colour rules, fill patterns and images in petals from an Icon field.
- **Smart caption and footnote**: "Jul is the peak at 4.1K; Feb the low at 2.2K." and a footnote that names the encoding.
- **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

- **Last period's outline**: Last year's or the plan's outline on every petal, with the change in the label and tooltip.
- **Past seasons as outlines**: With a Seasons field, the latest season as petals and up to six past seasons as outlines that fade with age, with how far the peak sits above its seasons' average and the peak-to-low swing.
- **Targets per petal**: An arc across each petal at its target, in met, close or missed status colour, with a status mark on the label.
- **Seasonality findings**: Peak, trough, the seasonal index of each petal and whether the peak moved against last period, each with how it was calculated.
- **Small multiples**: One rose per plant or region on a shared radial scale.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Category | `category` | Column | Optional | The parts: slices, petals, rings, cells, icons, stages or columns |
| Segment | `segment` | Column | Optional | A second split: an outer ring, stacked petals or stages, Marimekko rows, waffle colours |
| 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 |
| Angle (aster) | `angle` | Measure | Optional | Petal angle in the aster layout |
| Icon | `icon` | Measure | Optional | Built-in icon name, SVG path or data:image URI per part |
| Annotation | `annotation` | Measure | Optional | Text measure: a callout on the part |
| Seasons | `season` | Column | Optional | Periods such as years: the latest is drawn, the past ones as outlines behind it (premium) |
| 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 |

### Rose (`rose`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Petal Size | `mode` | `area` (By area (honest)), `radius` (By radius), `aster` (Aster: angle from a second measure) |
| Arc | `arc` | `full` (Full circle), `semi` (Semicircle), `threeQuarter` (Three quarters (270°)), `custom` (Custom start and sweep) |
| Start Angle (°) | `startAngle` | Number |
| Sweep (°) | `sweep` | Number |
| Inner Radius (%) | `innerRadius` | Number |
| Stack Petals by Segment | `stacked` | On / off |
| Order | `order` | `auto` (Auto (months, weekdays, hours, compass)), `calendar` (Calendar (months, quarters)), `weekday` (Weekdays (Monday first)), `hour` (Hours of the day (midnight at the top)), `compass` (Compass points (north at the top)), `sort` (As the Sorting card) |
| Calendar Order for Months and Days | `calendar` | On / off |
| Past Seasons as Outlines | `seasons` | Number |
| Images in Petals | `images` | On / off |
| Gaps Between Petals | `gap` | `theme` (From theme), `none` (None), `small` (Small), `large` (Large) |

### 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 |

### 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 |

### 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 |
