# Gauges

{% tabs %}
{% tab title="Angular gauge" %}

## &#x20;                             <mark style="color:$success;">Angular gauge</mark>

#### **Chart setup to build an angular gauge:**

| Configuration option | Configuration value                                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Axis**             | Drag the dimension to plot on the axis (e.g., Month).                                                                           |
| **Values parameter** | Drag the measures to analyze (e.g, Actual, Plan, 2024 Actuals, 2024 Plan - Created visual measures for demonstration purposes). |
| **Chart type**       | Select **Vertical Linear gaug**e from the Chart Type dropdown menu.                                                             |

> &#x20;Angular gauges are ideal for displaying a single key performance indicator (KPI), such as system utilization, completion percentage, or performance scores.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2For9IDtaB1bUso6Ud447r%2Fimage.png?alt=media&#x26;token=edd6d39c-d5d3-4192-94b5-adc5b78cc3d3" alt=""><figcaption><p>Angular gauge pivot data</p></figcaption></figure>

The Min and Max values specify the range of values between which the actuals and target should lie.

When the secondary actuals and target are not assigned, a single gauge will be plotted.

### 1. Conditional formatting for Angular gauges

Use the Conditional formatting > Comparison band option to easily compare values visually against predefined benchmarks.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FC02uQdpQlAe030hlBKKq%2Fimage.png?alt=media&#x26;token=34a35654-7f4e-49b6-a9d9-ae10895ee83f" alt=""><figcaption><p>Comparison band for angular gauges</p></figcaption></figure>

### 2. Customization & formatting under Canvas settings

#### 2.1. Gauge type

You can plot semi-circular, circular, or arc gauges.

<div><figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FMfzi6DZStaOv9Wo0EWg5%2Fimage.png?alt=media&#x26;token=49075a1f-b7f7-44dc-801a-19eedd56e274" alt=""><figcaption><p>Circular gauge</p></figcaption></figure> <figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2Fc6rYulCqz8UlPb15oPJm%2F2025-05-08_09h36_29.png?alt=media&#x26;token=fcedeeda-18c4-4331-b787-28b34d228cbc" alt=""><figcaption><p>Arc gauge</p></figcaption></figure></div>

#### 2.2. Gap

Set the spacing between the primary and secondary gauge.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2F5DnoI5xb8Su6ssGQvVOa%2Fimage.png?alt=media&#x26;token=ce30adab-ec04-4854-b074-d582053af97c" alt=""><figcaption><p>Gap </p></figcaption></figure>

#### 2.3. Primary

* **Needle**: Render a needle to denote the actuals.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FjLwlZwNwbI50iVY5KlGL%2Fimage.png?alt=media&#x26;token=92afbcba-d8ab-401b-a60a-b5cefc03920e" alt=""><figcaption><p>Needle to depict actuals</p></figcaption></figure>

* **Remaining fill**: Customize the color of the gauge. It is set to light grey by default.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FADHiyIYH4qeQ2tl8ihQ1%2Fimage.png?alt=media&#x26;token=e33d9cc0-03ae-4550-8e12-047aa45ff836" alt=""><figcaption><p>Remaining fill </p></figcaption></figure>

* **Actuals**:  Customize the appearance and color of the Actuals measure.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FNdZB8AFvCxIX92ThY2Ez%2Fimage.png?alt=media&#x26;token=5233c136-7f32-4900-af15-3e4a32109f6b" alt=""><figcaption><p>Actuals customization</p></figcaption></figure>

* **Width**: Set the width of the gauge.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FccOqnpr5yyfxDZk7LfzH%2Fimage.png?alt=media&#x26;token=084aa450-83c2-4b6f-96bd-b13d8f32c6a9" alt=""><figcaption></figcaption></figure>

* **Target**: Customize how the target is represented. You can render a circle or a line.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FNc0XUfGwkMYlMU0p8IuU%2Fimage.png?alt=media&#x26;token=e31e2fcf-a99b-43ec-8e72-ace3fa80f3ca" alt=""><figcaption><p>Target customizations</p></figcaption></figure>

#### 2.3. Secondary

When a secondary actual and target are assigned, you can customize the second gauge with the same options discussed in the previous section.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2F7w6yr6mhRO8ApIx18x7o%2Fimage.png?alt=media&#x26;token=d0ba70ec-30e7-4c51-914d-7cd540813b2d" alt=""><figcaption><p>Secondary gauge options</p></figcaption></figure>

### Migrating from xViz Angular Gauge charts to Analytics+

{% hint style="success" %}
**Download Guide and Demo**

Access the detailed guide, which includes step-by-step settings paths and a PBIX demo report, for comprehensive configuration examples between xViz and Analytics+.
{% endhint %}

**Download ↓**

{% file src="<https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FZtoQn30cs4CgrTTPxvxk%2FxViz%20Advanced%20Gauge%20to%20Inforiver%20Analytics%2B.zip?alt=media&token=18c38086-eabd-44d4-8433-dd484030f286>" %}
Download the zip file to access the migration guide and PBIX demo file
{% endfile %}
{% endtab %}

{% tab title="Linear gauge" %}

## &#x20;                              <mark style="color:$success;">Linear gauge</mark>

#### **Chart setup to build a linear gauge:**

| Configuration option | Configuration value                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Axis**             | Drag the dimension to plot on the axis (e.g., Month).                                                      |
| **Values parameter** | Drag the measures to analyze (e.g., Actual, Plan, Created visual measures EnhcPlan, PlanMax, and PlanMin). |
| **Chart type**       | Select **Vertical Linear gauge** from the Chart Type dropdown menu.                                        |

> Linear gauges offer a minimalistic solution for showing progress toward a goal, such as tracking KPIs or completion percentages. Since they are vertically oriented, they can easily be accommodated in dashboards.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FRtSjjymF5sEmklKx3nTX%2Fimage.png?alt=media&#x26;token=a563f260-7038-4ddf-b053-790b2c42af4b" alt=""><figcaption><p>Pivot data for linear gauge</p></figcaption></figure>

Linear gauge with min and max points defined - you can specify the minimum and maximum cutoff values between which to plot the gauge.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FQGyYwVoD8JjPcKsQYGJi%2Fimage.png?alt=media&#x26;token=6897eb99-7d02-4791-8498-fa7f6acb4f5f" alt=""><figcaption><p>Linear gauge with minimum and maximum cutoff</p></figcaption></figure>

### 1. Customization & formatting options under Canvas settings

Use the Conditional formatting > Comparison band option to easily compare values visually against predefined benchmarks.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FRURVQ7tqR96VdKupVoDF%2Fimage.png?alt=media&#x26;token=9b6b3cff-ec8e-40c7-bf1c-94b624ba662f" alt=""><figcaption><p>Comparison bands for linear gauges</p></figcaption></figure>

### 2. Canvas settings for Linear gauge

#### 2.1. Linear gauge type

Choose between Qualitative linear, Regular linear, and Progress bars.

<div><figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FHAMBiBZiDzynxEwPvTfq%2Fimage.png?alt=media&#x26;token=99fe0bd9-cb2c-4977-ae0d-e0600de38a89" alt=""><figcaption><p>Linear gauge</p></figcaption></figure> <figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2F1mUewmAjV167i1a11N1P%2F2024-11-20_15h18_59.png?alt=media&#x26;token=4a393039-d340-4f6a-b065-2cbdbfd7f109" alt=""><figcaption><p>Progress bar</p></figcaption></figure> <figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2Frbk0Q3zYdEK4n2BaUqwe%2F2024-11-20_15h19_58.png?alt=media&#x26;token=1d65583e-4513-4f51-b0d2-6b2b01a2d498" alt=""><figcaption><p>Qualitative linear gauge</p></figcaption></figure></div>

#### 2.2. Rounded edge

Soften the corners by enabling the rounded edge option.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FEb7ymbtJUySMVcVLeSnv%2Fimage.png?alt=media&#x26;token=0a701421-1840-42f0-bef4-1d4c3e4fb57b" alt=""><figcaption><p>Rounded edge</p></figcaption></figure>

#### 2.3. Actuals

Customize the color and appearance of the AC measure.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FZ4fPulzDYd2JnYtVks4E%2Fimage.png?alt=media&#x26;token=9097f95e-e4c1-4b34-a861-18566783b693" alt=""><figcaption><p>AC customization</p></figcaption></figure>

* **Width**: Set the width of the Actuals bar.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FF5uEEm4Y8e0UFauZjktW%2Fimage.png?alt=media&#x26;token=3d5ddfcd-e7d2-4fd4-ab69-53b082d4a54e" alt=""><figcaption><p>AC width</p></figcaption></figure>

* **Marker**: Enable/disable the marker for AC. You can also set the style (Triangle/Diamond/Circle/Square/Line) and color.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FjbKsFmRrIaOnoUlEnhSe%2Fimage.png?alt=media&#x26;token=9d4e0741-6255-4d58-b6dc-99d938f8f172" alt=""><figcaption><p>AC marker shape and color</p></figcaption></figure>

* **Size**: Set the size of the marker.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FWKD0bhvWzwLGWDbjF0Q5%2Fimage.png?alt=media&#x26;token=86a301c6-0f60-44f1-9051-3712f97e51cd" alt=""><figcaption><p>AC marker size</p></figcaption></figure>

#### 2.4. Target

Enable the toggle to plot the target. Set the style, size, and color of the target marker.&#x20;

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2F2W2aU6KL8a9WGAge6PXK%2Fimage.png?alt=media&#x26;token=26a82ed7-90f1-4382-9e7f-cbb8c943ea7e" alt=""><figcaption><p>Target marker customization</p></figcaption></figure>

#### 2.5. Gauge width

Set the thickness of the gauge.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FSxC5CzLTGDIrLnkq7u7p%2Fimage.png?alt=media&#x26;token=4e62155d-92f7-439b-88b6-c5bf824df705" alt=""><figcaption><p>Gauge width</p></figcaption></figure>

#### 2.6. Remaining width

Choose a different color for the gauge. It is set to light grey by default.

<figure><img src="https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FbkJUK0NwKs9fRnvviyQQ%2Fimage.png?alt=media&#x26;token=d9f259bb-3547-4dcb-b9b3-4be029a3ad33" alt=""><figcaption><p>Fill color for the Gauge</p></figcaption></figure>

### Migrating from xViz Linear Gauge charts to Analytics+

{% hint style="success" %}
**Download Guide and Demo**

Access the detailed guide, which includes step-by-step settings paths and a PBIX demo report, for comprehensive configuration examples between xViz and Analytics+.
{% endhint %}

**Download ↓**

{% file src="<https://3132984990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbOoZhPvC57Z0CNgep4Ib%2Fuploads%2FFVVgUaahQ3ZccFJzN7eM%2FxViz%20Linear%20Gauge%20to%20Inforiver%20Analytics%2B.zip?alt=media&token=fdcfb5c1-90d2-46ca-9b5c-ffa05609be74>" %}
Download the zip file to access the migration guide and PBIX demo file
{% endfile %}
{% endtab %}
{% endtabs %}

## Additional formatting options

Here are the other settings that help you refine your Gauge chart.

<table><thead><tr><th width="143.5">Feature</th><th>Description</th><th data-type="content-ref">Link</th></tr></thead><tbody><tr><td>Number</td><td>Configure number formatting (decimals, units)</td><td><a href="../working-with-analytics+/3.-charts/3.8.-display-settings-for-charts/charts-number-settings">charts-number-settings</a></td></tr><tr><td>Legend</td><td>Show/hide and customize the legends</td><td><a href="../working-with-analytics+/3.-charts/3.8.-display-settings-for-charts/charts-legend-settings">charts-legend-settings</a></td></tr><tr><td>Data Label</td><td>Show exact values for each data point</td><td><a href="../working-with-analytics+/3.-charts/3.6.-data-label-customizations">3.6.-data-label-customizations</a></td></tr><tr><td>Trellis</td><td>Create small multiples using category split</td><td><a href="../working-with-analytics+/6.-trellis-customizations">6.-trellis-customizations</a></td></tr><tr><td>Conditional Formatting</td><td>Apply color rules to highlight values</td><td><a href="../working-with-analytics+/9.-conditional-formatting">9.-conditional-formatting</a></td></tr><tr><td>Sorting</td><td>Sort axis order</td><td><a href="../working-with-analytics+/10.-sort-and-reorder-data/sorting-data">sorting-data</a></td></tr><tr><td>Ranking</td><td>Limit to top/bottom N categories</td><td><a href="../working-with-analytics+/11.-ranking-data-topn/ranking-for-charts">ranking-for-charts</a></td></tr></tbody></table>