# Semi Gauge

{% hint style="success" %}
*Check out the given walk-through on how to set the Semi Gauge chart properties.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq1Y2nC9XDrWcLwg1gpYr%2Fuploads%2FSozrXpPidCsFR9S3lICV%2FSemi-Gauge%20Properties.mp4?alt=media&token=2c537671-0165-400f-a68d-3648d70ed548>" %}

Semi-Gauge charts contain a semi-circle with the needle pointing at the target value. They indicate a specific dataset by utilizing a semi-circle that changes color to indicate whether the monitored data is within the defined limits. Users need to set boundaries (minimum and maximum values) for the gauge scale and various colors to indicate the predetermined ranges. The ‘**Show Alert**’ option has been provided to indicate the situation when the target values cross the set limits. Gauges are used in dashboards, real-time monitors, and reports. They can display Key Performance Indicators (KPIs), progress indicators, and quantity indicators.

* **Best Situation to use Semi-Gauge:** To monitor any performance that contains predefined ranges
* **Examples:** The overall performance of a student/class in an examination.

<figure><img src="/files/KDMLW2PLtWv4tE9CO2H1" alt=""><figcaption><p><em><strong>Default display of Semi Gauge chart</strong></em></p></figcaption></figure>

## **Properties** <a href="#properties" id="properties"></a>

### **General Settings**

* **Minimum Value**: Set a minimum value to be shown on the chart (It should be less than the maximum set value).
* **Maximum Value**: Set a maximum value to be displayed on the chart (It should be more than the minimum set value).
* **Target**: Enable target by marking in the checkbox.
  * ***Target Value***: Set a target value to display target in the semi-gauge.
* **Field as Target:** Enable this option to select a Measure field to display the Target.
  * **Aggregation**: Select an aggregation type from the given drop-down menu.
  * **Measure**: Select a measure field from the drop-down menu to apply the target value.
* **Target Value**: User-defined value to set a target.
* **Target Color**: Set a target color.
* **Speedometer Width**: Set the width of the speedometer through this option.
* **Needle Width**: Set the needle width by using this option.
* **Center Color**: Select a color for the center by using this option.
* **Ticks Color**: Select a color for the ticks marks shown on the semi-gauge through this option.
* **Pointer Color:** Select a color for the pointer arrow by using this option.
* **Title Font Color**: Select a color of the title font by using this option.
* **Font Color**: Select a color for the font of the digit that displays overall value by using this option.
* **Marker Font Color:** Select a color for the marker fonts displayed on the semi gauge indicating the start and end limit.
* **Show ticks**: Use a checkmark in the given box to display ticks on the semi-gauge.
* **Show Range:** Use a checkmark in the given box to display ranges on the semi-gauge.
* **Title:** Insert a title for the chart.
* **Exclude Global Filter**: The View will be excluded from the Global Filter condition by putting a checkmark in the box.

<figure><img src="/files/nieQgwu5ngZU99Hpft4H" alt=""><figcaption><p><em><strong>Semi-Gauge chart with the modified General Properties</strong></em></p></figcaption></figure>

### **View Filter**

* **Filter**: Select a filter condition using the drop-down menu.

### **Range**

* **Show Alert**: Enable various ranges (in %) by using a checkmark in the given checkbox.
* **Add**: Use this option to insert a new range.
* **Value Color**: Set a value color.
* **Base Color**: Set a base color.

{% hint style="info" %}
*<mark style="color:green;">Please Note</mark>: The **Value Color** and **Base Color** options appear when the **Show Alert** option is not selected.*

![](/files/ZgI7TObIuz7mZKuMMpS8)    &#x20;
{% endhint %}

### **Format**

* **Precision**: Set the after decimal value (It can show up to 5 precision).
* **Format Type**: Select a desired format type from the drop-down menu (the provided options for this field are: None, Auto, Percent, Thousand, Lacs, Crore, Million, Billion, Trillion, Quadrillion).
* **Currency Type**: Select a currency symbol to be displayed in the View (the provided options for this field are: None, Rupees, Euro, Pound, USD, Yen, Cent).

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> The following image displays various ranges when the **Show Alert** option is enabled.*
{% endhint %}

<figure><img src="/files/9hpTexcTbRceOPl8rci7" alt=""><figcaption><p>Displaying various ranges in Semi Gauge</p></figcaption></figure>

<figure><img src="/files/jQSYijCmCyxlTEOfw5D3" alt=""><figcaption><p>Displaying Base Value when selected Target is Min of the experience</p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark>*

1. *The target value should be included in the range of minimum and maximum set values.*
2. *Semi-Gauge supports only one measure value. It converts the selected Dimension value into Measure as it considers only Measure values.*
3. *The Base color appears when the selected Maximum Value for the chart is more than the maximum value given for the selected measure.*
   {% endhint %}


---

# 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.bdb.ai/self-service-visualization-3/chart-gallery/semi-gauge.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.