# 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="/files/5aTSeaNcUhigoLisAF2q" 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="/files/yXC2A7epg8oNQgKuestH" 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="/files/GVFos0Ffnu1JHsH3hK60" alt=""><figcaption><p>Circular gauge</p></figcaption></figure> <figure><img src="/files/89R7ajcYqh2lxcWC0Jyo" alt=""><figcaption><p>Arc gauge</p></figcaption></figure></div>

#### 2.2. Gap

Set the spacing between the primary and secondary gauge.

<figure><img src="/files/WC9rM8JB4vCTDFifuLlT" alt=""><figcaption><p>Gap </p></figcaption></figure>

#### 2.3. Primary

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

<figure><img src="/files/d4tpK2RQQBsRHcq8Jb0w" 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="/files/gpLO4pYQujn8tv1Ypebi" alt=""><figcaption><p>Remaining fill </p></figcaption></figure>

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

<figure><img src="/files/W21j1QxhBCjZXDDi8bjo" alt=""><figcaption><p>Actuals customization</p></figcaption></figure>

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

<figure><img src="/files/qBdCGnj39jz8LYJeBJro" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/Ek4fOgHEHus04b4Og7Mw" 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="/files/QIBsliIEvUGtLCLqAX98" 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="/files/uDRtBCDIhm7GTY9DOzWu" %}
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="/files/8Pr3CHQDOhOTiAp01iyc" 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="/files/pO1KyAvIGvwHkE2yrJGo" 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="/files/eH1seO3WO9nXjhY6chTO" 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="/files/J33y2xllMvzvLdV49XFH" alt=""><figcaption><p>Linear gauge</p></figcaption></figure> <figure><img src="/files/rsVN7ykXItHBh73olZe6" alt=""><figcaption><p>Progress bar</p></figcaption></figure> <figure><img src="/files/MRwchih6l8fg1Y2USdwW" 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="/files/6eu96ttXCcFrcI7Qs0sr" alt=""><figcaption><p>Rounded edge</p></figcaption></figure>

#### 2.3. Actuals

Customize the color and appearance of the AC measure.

<figure><img src="/files/tTeQlGvxUv0sM5zl2tfw" alt=""><figcaption><p>AC customization</p></figcaption></figure>

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

<figure><img src="/files/nPMeGGfGT24kaIkNDQ5F" 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="/files/mLCwcDTffqLMgXVeXuo7" alt=""><figcaption><p>AC marker shape and color</p></figcaption></figure>

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

<figure><img src="/files/b3OLVBP6vHzdIW09zHI9" 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="/files/gXaPD84mj5h0QnRk0iVg" alt=""><figcaption><p>Target marker customization</p></figcaption></figure>

#### 2.5. Gauge width

Set the thickness of the gauge.

<figure><img src="/files/0l2EHITSggHPIEPLfmPH" 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="/files/IP5r5d2Bvuz0MMwdRD6v" 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="/files/sc69Q5dlGhY9m366CKJR" %}
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="/pages/5luh7CNmlb8gDCUt1Cdo">/pages/5luh7CNmlb8gDCUt1Cdo</a></td></tr><tr><td>Legend</td><td>Show/hide and customize the legends</td><td><a href="/pages/DKKnFEcoc3dq7SY8pPwT">/pages/DKKnFEcoc3dq7SY8pPwT</a></td></tr><tr><td>Data Label</td><td>Show exact values for each data point</td><td><a href="/pages/hlfbb3nncB1Juac8B2M1">/pages/hlfbb3nncB1Juac8B2M1</a></td></tr><tr><td>Trellis</td><td>Create small multiples using category split</td><td><a href="/pages/gZGiSWPH6pyEPgCUyJ7G">/pages/gZGiSWPH6pyEPgCUyJ7G</a></td></tr><tr><td>Conditional Formatting</td><td>Apply color rules to highlight values</td><td><a href="/pages/eAlYz7nnGGHBwj0vsrG2">/pages/eAlYz7nnGGHBwj0vsrG2</a></td></tr><tr><td>Sorting</td><td>Sort axis order</td><td><a href="/pages/DBrCRJn3JzquaVGXnE0Z">/pages/DBrCRJn3JzquaVGXnE0Z</a></td></tr><tr><td>Ranking</td><td>Limit to top/bottom N categories</td><td><a href="/pages/AmGsNJOt6hyWbMuwohm6">/pages/AmGsNJOt6hyWbMuwohm6</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.inforiver.com/analytics+/quick-charts/gauges.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.