> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thesys.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Visualizaton

> Present quantitative data as various graphic forms based on density and complexity of data.

**Includes:** `LineChart`, `AreaChart`, `BarChart`, `PieChart`, `RadarChart`, `RadialChart`

## Line Chart

**Definition** \
A line chart is a type of graph that displays trends or changes in data over a continuous interval by connecting individual data points with lines.

**Uses**\
**-** Show trends, correlations and fluctuations over time.\
**-** Ideal for dense time data where changes between points matter.\
**-** Examples: stock prices, sensor data, temperature readings

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/lineChart_light-bg.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=3ed1bc4eafc7e1f8f8b7df4f5308248a" alt="Light Mode Image" width="1080" height="498" data-path="library/assets/lineChart_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/lineChart_dark.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=cc8563ff6a3eba2687931daaf41bf840" alt="Dark Mode Image" width="1080" height="498" data-path="library/assets/lineChart_dark.svg" />

**Illustrative Variants**

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/qLcKVhPqCraYRjYO/library/assets/lineChart-variants_light-clean.svg?fit=max&auto=format&n=qLcKVhPqCraYRjYO&q=85&s=84b859f9b0a0f22ac3c750e02bf32632" alt="Light Mode Image" width="1081" height="288" data-path="library/assets/lineChart-variants_light-clean.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/qLcKVhPqCraYRjYO/library/assets/lineChart-variants_dark-clean.svg?fit=max&auto=format&n=qLcKVhPqCraYRjYO&q=85&s=bad8d17eb0742cf433c705d16447f31b" alt="Dark Mode Image" width="1081" height="292" data-path="library/assets/lineChart-variants_dark-clean.svg" />

***

## Area Chart

**Definition**\
An area chart displays quantitative data over a continuous interval using filled areas beneath plotted data points connected with lines.

**Uses**\
**-** Emphasize volume or magnitude of change over time, not just direction.\
**-** Showing cumulative values.\
**-** Examples: Tracking total revenue growth broken down by product line, monitoring energy consumption trends from multiple sources

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/C1mGp0p_ygBsZ7UI/library/assets/areaChart_light-bg.svg?fit=max&auto=format&n=C1mGp0p_ygBsZ7UI&q=85&s=559828608098375909b8de3aaab21238" alt="Light Mode Image" width="1080" height="498" data-path="library/assets/areaChart_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/C1mGp0p_ygBsZ7UI/library/assets/areaChart_dark.svg?fit=max&auto=format&n=C1mGp0p_ygBsZ7UI&q=85&s=56cfa394ab0dac1cf2fa947b991b4ec7" alt="Dark Mode Image" width="1080" height="498" data-path="library/assets/areaChart_dark.svg" />

**Illustrative Variants**

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/qJlsjGpiQC1sh2Br/library/assets/areaChart-variants_light-clean.svg?fit=max&auto=format&n=qJlsjGpiQC1sh2Br&q=85&s=b605b48e8ad2ede3d80b6d6fa10a642d" alt="Light Mode Image" width="1080" height="299" data-path="library/assets/areaChart-variants_light-clean.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/qJlsjGpiQC1sh2Br/library/assets/areaChart-variants_dark-clean.svg?fit=max&auto=format&n=qJlsjGpiQC1sh2Br&q=85&s=435442c077339c9c17ae19b0be9eda5f" alt="Dark Mode Image" width="1080" height="300" data-path="library/assets/areaChart-variants_dark-clean.svg" />

***

## Bar Chart

**Definition**\
A bar chart uses rectangular bars to visually represent and compare values across categories. The length or height of each bar corresponds to the value it represents.

**Uses**\
**-** Compare quantities across discrete groupings such as time intervals, sequential stages in a process, or related variables within a set.\
**-** Ideal for categorical data and most effective when there are few data series, allowing for clear comparison between items.\
**-** Examples: Bug reports by severity level, top 10 highest grossing films, sales by region in Q1

### Vertical Bar Chart

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/barChart_light-bg.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=57e00b81aee623f126f8acfc127fe4e5" alt="Light Mode Image" width="1080" height="498" data-path="library/assets/barChart_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/barChart_dark-bg.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=211f632d11065476f88c79519914a50d" alt="Dark Mode Image" width="1080" height="498" data-path="library/assets/barChart_dark-bg.svg" />

### Horizontal Bar Chart

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/horizontalBarChart_light-bg.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=599aec06dc3f659700b4970f1c694460" alt="Light Mode Image" width="1080" height="518" data-path="library/assets/horizontalBarChart_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/horizontalBarChart_dark1.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=80c80e7fc48b05ba92ef7b5778dec2b1" alt="Dark Mode Image" title={true} width="1080" height="518" data-path="library/assets/horizontalBarChart_dark1.svg" />

**Illustrative Variants**

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/barChart-comp_light-fixed.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=bdd84f3a298208fa44dfd7f161589c08" alt="Light Mode Image" width="1198" height="662" data-path="library/assets/barChart-comp_light-fixed.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/C1mGp0p_ygBsZ7UI/library/assets/barChart-comp_dark-fixed.svg?fit=max&auto=format&n=C1mGp0p_ygBsZ7UI&q=85&s=cec932527220feea5659a4183a3804b6" alt="Dark Mode Image" width="1198" height="662" data-path="library/assets/barChart-comp_dark-fixed.svg" />

***

## Radial Chart

**Definition**\
A type of chart that has a **circular y-axis** where values are compared based on proportion of the circular path completed (not the length of the arcs).

**Uses**\
**-** Emphasizing completion and visual appeal over comparison.\
**-** Useful when the space available small.\
**-** Examples: progress towards a goal, completion levels for different learning modules\\

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/radialChart-circular_light1-bg.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=9d47b547ef13d983e06a758c7abcddd0" alt="Light Mode Image" width="1080" height="473" data-path="library/assets/radialChart-circular_light1-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/radialChart-circular_dark1.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=e3c22c3372451e25eb03dab00f6eaa97" alt="Dark Mode Image" width="1080" height="473" data-path="library/assets/radialChart-circular_dark1.svg" />

**Illustrative Variants**

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/WdI8jtIZnjPIa2lq/library/assets/radialChart-variants_light.svg?fit=max&auto=format&n=WdI8jtIZnjPIa2lq&q=85&s=f69d1c6d6e13fcc262c6359639808dac" alt="Light Mode Image" width="1081" height="358" data-path="library/assets/radialChart-variants_light.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/WdI8jtIZnjPIa2lq/library/assets/radialChart-variants_dark.svg?fit=max&auto=format&n=WdI8jtIZnjPIa2lq&q=85&s=a12d9e59fca0c0722383a638ecf1087c" alt="Dark Mode Image" width="1081" height="358" data-path="library/assets/radialChart-variants_dark.svg" />

***

## Pie Chart

**Definition**\
A type of chart that displays proportionate **parts of a whole** as slices of a circle. Each slice represents a category’s contribution to the total, with its angle proportional to the value it represents.

**Uses**\
**-** To show the composition of a finite whole or at a given point in time \
**-** Best used when the data series is categorical and not too dense.\
**-** Examples: market share by brand, survey responses to multiple choice questions, time spent across activities in a day

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/pieChart-circular_light-bg.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=5e00e737bade15a9b1f45066a54ffedd" alt="Light Mode Image" width="1080" height="473" data-path="library/assets/pieChart-circular_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/pieChart-circular_dark.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=392f0b094e1a6ded803dcb1b75681d4e" alt="Dark Mode Image" width="1080" height="473" data-path="library/assets/pieChart-circular_dark.svg" />

**Illustrative Variants**

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/pieChart-variant_light.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=762e92d9e57a8e802b26352494cae602" alt="Light Mode Image" width="1080" height="390" data-path="library/assets/pieChart-variant_light.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/pieChart-variant_dark.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=3dc354cc4262ac352ccc1be41c5a951f" alt="Dark Mode Image" width="1080" height="390" data-path="library/assets/pieChart-variant_dark.svg" />

***

## Radar Chart

**Definition**\
A chart that plots three or more variables on axes radiating from a central point. Data points are connected to form a polygon for each data series, showing patterns or comparisons across categories

**Uses**\
**-** Comparing multiple metrics across sub-categories\
**-** Emphasize symmetry, imbalance or dominance\
**-** Examples: evaluating candidates across skills, products across features, showing how departments score across metrics like speed, cost, and quality

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/radarChart_light1-bg.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=1014c2ccea5c9351ec7bc9dc68d1bde9" alt="Light Mode Image" width="1080" height="498" data-path="library/assets/radarChart_light1-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/radarChart_dark1.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=677688d485a11afb7878ea5b60684cf7" alt="Dark Mode Image" title={true} width="1080" height="498" data-path="library/assets/radarChart_dark1.svg" />

**Illustrative Variants**

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/radarChart-comp_light.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=413a80fa2427563c222c4475bc88d43d" alt="Light Mode Image" width="1206" height="836" data-path="library/assets/radarChart-comp_light.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/radarChart-comp_dark.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=d55d4df126d45f802fdd9129e439b342" alt="Dark Mode Image" title="Illustrative Variants" width="1206" height="836" data-path="library/assets/radarChart-comp_dark.svg" />

***

## Anatomy

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/chartAnatomy_light-labelled.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=1524cb31f2755f1e000893f1b2f8da07" alt="Light Mode Image" width="1080" height="480" data-path="library/assets/chartAnatomy_light-labelled.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/onCkg8rRXhzVrBt1/library/assets/chartAnatomy_dark-labelled.svg?fit=max&auto=format&n=onCkg8rRXhzVrBt1&q=85&s=249d9dc7480f5479b728ec4b27eefc8b" alt="Dark Mode Image" title={true} width="1080" height="480" data-path="library/assets/chartAnatomy_dark-labelled.svg" />

1. `title`**:** Describes the main insight the chart reveals, supported by a subtitle.
2. `tooltip`**:** Expose the value(s) tied to a point, segment, or shape in the chart during interaction.
3. `grid` **:** Polar (in Radial and Radar Charts) or categorical grid lines for value reference.
4. `legend`**:** Maps colors to data categories they represent. When required, legends may also include value types/units of their respective axes.

### Legend Variants

<img className="block w-full dark:hidden select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/legend-variants_light-bg.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=afc997504ba195dc913008401a387d58" alt="Light Mode Image" width="1171" height="478" data-path="library/assets/legend-variants_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/7KJeXsvMznH0nJ6c/library/assets/legend-variants_dark.svg?fit=max&auto=format&n=7KJeXsvMznH0nJ6c&q=85&s=cd72c160df6cc0d96744a173de5a8947" alt="Dark Mode Image" title={true} width="1171" height="478" data-path="library/assets/legend-variants_dark.svg" />

***

## Prompt-Based UI Controls

A simple prompt in plain language given to C1 is enough to control the following properties.

* **Visibility of Elements**
  * Tell C1 whether x and y axis labels should be visible in the chart.
* **Orientation and Layout (only Bar Charts)**
  * Ask C1 to use vertical or horizontal bars in Bar Charts.
  * Choose whether you want to use a stacked or grouped Bar Chart.
* **Data Units**
  * Prompt whether you want the quantitative data to be shown in thousands (K), millions (M), billions (B), or trillions (T).
* **Category Labels**
  * Rename category labels shown in the chart (eg. "rename Product A to Mobile").
