generate_progress_chart
Create visual progress charts for proportional metrics using normalized data between 0 and 1. Supports linear, circular, gauge, and liquid chart types to represent completion rates or progress in a clear format.
Instructions
Generates a progress chart for visualizing quantitative values normalized between 0 and 1. Ideal for representing progress, completion rates, or proportional metrics. The gauge chart and liquid chart currently only supports displaying data for a single dimension.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
background | No | Chart background color (hex). Optional, defaults to white. | |
chartTheme | No | Chart theme. Optional, defaults to 'light'. | |
chartType | Yes | ||
colorField | No | Dimension field, Must exist in the data, required in linear_progress, circular_progress and gauge | |
colors | No | Color palette for chart elements. | |
dataTable | Yes | Data for the progress chart, e.g., [{ category: 'category 01', value: 0.5 }]. | |
height | No | Chart height. Optional, defaults to 500. | |
output | No | Chart output type. Defaults to 'image'. | image |
subTitle | No | Chart subtitle text. | |
title | No | Chart title text. | |
titleOrient | No | Title position in the chart. | |
valueField | Yes | Measure field with values in [0, 1]. Must exist in the data. | |
width | No | Chart width. Optional, defaults to 500. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"background": {
"description": "Chart background color (hex). Optional, defaults to white.",
"type": "string"
},
"chartTheme": {
"description": "Chart theme. Optional, defaults to 'light'.",
"enum": [
"light",
"dark"
],
"type": "string"
},
"chartType": {
"enum": [
"linear_progress",
"circular_progress",
"gauge",
"liquid"
],
"type": "string"
},
"colorField": {
"description": "Dimension field, Must exist in the data, required in linear_progress, circular_progress and gauge",
"type": "string"
},
"colors": {
"anyOf": [
{
"items": {
"description": "Color value",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Color palette for chart elements."
},
"dataTable": {
"description": "Data for the progress chart, e.g., [{ category: 'category 01', value: 0.5 }].",
"minItems": 1,
"type": "array"
},
"height": {
"description": "Chart height. Optional, defaults to 500.",
"type": "number"
},
"output": {
"default": "image",
"description": "Chart output type. Defaults to 'image'.",
"enum": [
"spec",
"image",
"html"
],
"type": "string"
},
"subTitle": {
"description": "Chart subtitle text.",
"type": "string"
},
"title": {
"description": "Chart title text.",
"type": "string"
},
"titleOrient": {
"description": "Title position in the chart.",
"enum": [
"top",
"left",
"right",
"bottom"
],
"type": "string"
},
"valueField": {
"description": "Measure field with values in [0, 1]. Must exist in the data.",
"minLength": 1,
"type": "string"
},
"width": {
"description": "Chart width. Optional, defaults to 500.",
"type": "number"
}
},
"required": [
"dataTable",
"chartType",
"valueField"
],
"type": "object"
}