> ## 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/FKXNpn4Pw_Bq7YCt/legacy/library/assets/lineChart_light-bg.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=689cd460517e6639a5e528a8d87d49db" alt="Light Mode Image" width="1080" height="498" data-path="legacy/library/assets/lineChart_light-bg.svg" />

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

**Illustrative Variants**

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

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/FKXNpn4Pw_Bq7YCt/legacy/library/assets/lineChart-variants_dark-clean.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=94423e45db5bd8e1899eeba9ae569d1a" alt="Dark Mode Image" width="1081" height="292" data-path="legacy/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/InTNqEKTMdilh3PP/legacy/library/assets/areaChart_light-bg.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=8cbe41b08ade0437590820a25fa23d47" alt="Light Mode Image" width="1080" height="498" data-path="legacy/library/assets/areaChart_light-bg.svg" />

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

**Illustrative Variants**

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

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/InTNqEKTMdilh3PP/legacy/library/assets/areaChart-variants_dark-clean.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=0ad6abaf04a6f7a6b7cf902c23d28552" alt="Dark Mode Image" width="1080" height="300" data-path="legacy/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/InTNqEKTMdilh3PP/legacy/library/assets/barChart_light-bg.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=d2f72e99ab17b1262c36783e9ef6fe18" alt="Light Mode Image" width="1080" height="498" data-path="legacy/library/assets/barChart_light-bg.svg" />

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/InTNqEKTMdilh3PP/legacy/library/assets/barChart_dark-bg.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=f18e8e0489b4a0d5736e460f59d4cb13" alt="Dark Mode Image" width="1080" height="498" data-path="legacy/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/InTNqEKTMdilh3PP/legacy/library/assets/horizontalBarChart_light-bg.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=370ffc919c83665bf185fecf60f201d2" alt="Light Mode Image" width="1080" height="518" data-path="legacy/library/assets/horizontalBarChart_light-bg.svg" />

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

**Illustrative Variants**

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

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/InTNqEKTMdilh3PP/legacy/library/assets/barChart-comp_dark-fixed.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=51fb3c90d9305d339cdb601bc8a9ce0f" alt="Dark Mode Image" width="1198" height="662" data-path="legacy/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/FKXNpn4Pw_Bq7YCt/legacy/library/assets/radialChart-circular_light1-bg.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=d7e8e329cf1f509f168961734eebfbbc" alt="Light Mode Image" width="1080" height="473" data-path="legacy/library/assets/radialChart-circular_light1-bg.svg" />

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

**Illustrative Variants**

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

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/FKXNpn4Pw_Bq7YCt/legacy/library/assets/radialChart-variants_dark.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=79ad4da175d712cae44319c31dc2fdee" alt="Dark Mode Image" width="1081" height="358" data-path="legacy/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/FKXNpn4Pw_Bq7YCt/legacy/library/assets/pieChart-circular_light-bg.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=6b4e76d2da345881782ff1161bb9d764" alt="Light Mode Image" width="1080" height="473" data-path="legacy/library/assets/pieChart-circular_light-bg.svg" />

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

**Illustrative Variants**

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

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/FKXNpn4Pw_Bq7YCt/legacy/library/assets/pieChart-variant_dark.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=5f4a55452913008c384e424a5b831216" alt="Dark Mode Image" width="1080" height="390" data-path="legacy/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/FKXNpn4Pw_Bq7YCt/legacy/library/assets/radarChart_light1-bg.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=884302a8c328f49ce6c6f16e5bd3f14d" alt="Light Mode Image" width="1080" height="498" data-path="legacy/library/assets/radarChart_light1-bg.svg" />

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

**Illustrative Variants**

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

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

***

## Anatomy

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

<img className="hidden w-full dark:block select-none drag-none" src="https://mintcdn.com/thesys/InTNqEKTMdilh3PP/legacy/library/assets/chartAnatomy_dark-labelled.svg?fit=max&auto=format&n=InTNqEKTMdilh3PP&q=85&s=8d743fff033ad955e7c14c05a3aee1bf" alt="Dark Mode Image" title={true} width="1080" height="480" data-path="legacy/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/FKXNpn4Pw_Bq7YCt/legacy/library/assets/legend-variants_light-bg.svg?fit=max&auto=format&n=FKXNpn4Pw_Bq7YCt&q=85&s=4f8197acc99b3f516711f8b1f7ae5834" alt="Light Mode Image" width="1171" height="478" data-path="legacy/library/assets/legend-variants_light-bg.svg" />

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