# Linear Gauge

The Linear Gauge in the KPI tool provides a clear and effective way to measure progress, performance, or comparisons against a target. With its sleek bar-like design, this highly customizable chart helps users visualize key metrics in a simple yet impactful manner. Below is a detailed guide to its features and settings.

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FQRpryWSXgUDyppio6HIL%2Fimage.png?alt=media&#x26;token=cba35416-6e70-4f69-a5eb-c4481d111eb5" alt=""><figcaption></figcaption></figure>

Here's a quick guide to create Linear Gauge in KPI:

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FCPbhERCB7RlkCWYxKim8%2FPBIDesktop_oSfWGZrVOz.gif?alt=media&#x26;token=15d1fb96-78aa-4fcf-8c72-06b871e72539" alt=""><figcaption><p>Adding Linear gauge to KPI by Powerviz</p></figcaption></figure>

## **Data Tab**

**Gauge Value**

* **Gauge Value Mode**: Use this mode to display the gauge value as a percentage (requires a gauge value field in percentage).
* **Actual-Target Mode**: Displays actual and target values (requires both actual and target fields).

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FALw6m8WciQaKvVSWZF2G%2Fimage.png?alt=media&#x26;token=5ccb585a-3eac-46e7-9aeb-d51c48b42d7d" alt="" width="305"><figcaption></figcaption></figure>

**Actual Value Field (Only available in&#x20;*****Actual-Target Mode*****)**

* Specify the field to represent the actual value.

**Target Type (Only available in&#x20;*****Actual-Target Mode*****)**

* **From Data**: Target values are derived from a field.
* **Fixed**: A constant target value is used.

**Target Field (Only available in&#x20;*****Actual-Target Mode*****)**

* Choose the field representing the target value.

**Max Value Type**

* **None**: No maximum is applied.
* **From Data**: Maximum value is derived from a data field.
* **Fixed**: Use a constant maximum value.

***

## **Gauge Tab**

**Gauge Color with** [**Conditional Formatting**](https://docs.powerviz.ai/powerviz/kpi/edit-mode-introduction/kpi-charts/conditional-formatting)

* Set a default color for the gauge and apply rules for dynamic color changes based on conditions.

**Remaining Color with** [**Conditional Formatting**](https://docs.powerviz.ai/powerviz/kpi/edit-mode-introduction/kpi-charts/conditional-formatting)

* Define the color for the remaining portion of the gauge using conditional formatting.

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2F4sxpYt3bP3oTd0iw7HnF%2Fimage.png?alt=media&#x26;token=1639bf21-17ee-4e3a-a0c7-619c5966e5b7" alt="" width="302"><figcaption></figcaption></figure>

**Gauge Radius**

* Customize the edge style of the gauge:
  * **Sharp**: Straight edges.
  * **Rounded**: Smooth, rounded edges.
  * **Custom**: Define a custom edge radius.

**Actual Marker**

* **Toggle On/Off**: Enable or disable the actual value marker.
* **Size**: Adjust the size of the marker.
* **Color**: Set the marker color.

**Target Marker**

* **Toggle On/Off**: Enable or disable the target marker.
* **Color**: Set the marker color.
* **Target Label Checkbox**: Show or hide the target label.
* **Auto Size Toggle (On/Off)**: Automatically adjust the marker size.
* **IBCS Target Marker Checkbox**: Enable or disable the International Business Communication Standards (IBCS) target marker.

**Data Labels**

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FpTGT3kWPru0wNDaIgbR4%2Fimage.png?alt=media&#x26;token=35b14a19-6e46-48e1-86c7-704e49a5b1b4" alt="" width="301"><figcaption></figcaption></figure>

* **Type**: Choose to display labels as *Actual* or *Percent* values.
* **Text Size**: Adjust the label font size.
* **Color**: Set the label color.

**Gauge Scale**

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FHcnOrVDRRYXpvbNcj7kt%2Fimage.png?alt=media&#x26;token=493edb17-036a-4971-a0de-c501d5a5893b" alt="" width="296"><figcaption></figcaption></figure>

* **Tick Mark Checkbox**: Enable or disable tick marks on the scale.
* **Tick Value Toggle**: Show or hide tick values.
* **Text Size**: Set the font size for tick values.
* **Color**: Choose the color for the scale text.

**Number Formatting**

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FNuysYlijvdm3wuNDGfkp%2Fimage.png?alt=media&#x26;token=818dd706-cc48-4b00-98d2-62d0fe7f8132" alt="" width="296"><figcaption></figcaption></figure>

* **Display Unit**: Select the unit for the gauge values:
  * None, Auto, Thousand (*K*), Million (*M*), Billion (*B*), Trillion (*T*).
* **Prefix**: Add a prefix to the values.
* **Suffix**: Add a suffix to the values.
* **Decimals**: Define the number of decimal places.
* **+Format**: Choose between `123` or `+123` for positive values.
* **-Format**: Choose between `-123` or `(123)` for negative values.
* **Percentage Checkbox**: Display values as percentages.
* **Comma Checkbox**: Enable or disable comma separators for numbers.

**Global Options**

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FzM995Dr7Mb87uXKXIIlM%2Fimage.png?alt=media&#x26;token=e3d6e1dc-c9cc-4810-b564-a3635a64d092" alt="" width="296"><figcaption></figcaption></figure>

* **Font Family**: Select a font family for all text elements.
* **Styling**: Apply styling options such as Bold (*B*), Italic (*I*), or Underline (*U*).
* **Show Tooltip**: Enable or disable tooltips on hover.

***

## **Bands Tab**

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FcXapUuq5bBqQZbKUZvTx%2Fimage.png?alt=media&#x26;token=99cd96bf-5e2b-4af6-bdbf-3c4f5f353932" alt="" width="258"><figcaption></figcaption></figure>

**Display Type**

* Choose how bands are displayed:
  * **By Percentage**: Define bands based on percentage ranges.
  * **By Value**: Define bands based on specific values.

**Show Band Names in Chart Checkbox**

* Enable or disable band names within the chart.

**Band Name Color**

* Set the color for band names.

**Band Details**

* **Band Name**: Specify the name of the band.
* **Value**: Define the range or value for the band.
* **Color**: Assign a color to the band.

***

## General tab

<figure><img src="https://2952853741-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL502qSSR9Gd1FbZtxvCe%2Fuploads%2FCj81LgFxV8MAYUaGkKdB%2Fimage.png?alt=media&#x26;token=dc58d70b-b6bb-4d29-bf90-720c193cd65d" alt="" width="308"><figcaption></figcaption></figure>

This is common tab for all visuals click [here ](https://docs.powerviz.ai/powerviz/kpi/edit-mode-introduction/kpi-charts/general-tab)to explore settings. You can adjust visual properties, manage formatting options, and fine-tune various features to align with your requirements. Make sure to explore each section for a complete configuration.