---
title: "Status Chart"
description: "The Status Chart component allows you to visualize the status of one or more discrete datapoints over a time range."
---

# Status Chart

> The Status Chart component allows you to visualize the status of one or more discrete datapoints over a time range.

![A Status Chart with a timeseries X-axis spanning October 15 through October 24 and a category Y-axis listing Series1, Series2, and Series3. Each series is drawn as a horizontal band divided into red, yellow, and green segments, where each color represents a discrete state and each segment's width is how long the series held that state.](status-chart.png)

**Component Palette Icon:**  
![Status Chart component palette icon](status-chart-1.png)

## Description
The Status Chart component allows you to visualize the status of one or more discrete datapoints over a time range. The X-axis is always a timeseries axis, and the Y-axis is a category axis, with one entry per data series. The chart is populated with a single dataset, the first column of which must be a datetime column. 

### Wide vs Tall Datasets

In Wide format, all of the columns but the first must be numeric. These "series" columns' headers will be used as the names on the y-axis. In Tall format, there should be exactly 3 columns. The first is the timestamp, the second is the series name, and the third is the value. For example:

#### Wide Format

| t_stamp | Valve1 | Valve2 |
|---|---|---|
| 2010-01-13 8:00:00 | 0 | 2 |
| 2010-01-13 8:02:00 | 0 | 2 |
| 2010-01-13 8:04:00 | 1 | 2 |
| 2010-01-13 8:06:00 | 1 | 1 |
| 2010-01-13 8:08:00 | 0 | 1 |

#### Tall Format 

| t_stamp | Name | Value |
|----|---|---|
| 2010-01-13 8:00:00 | Valve1 | 0 |
| 2010-01-13 8:00:00 | Valve2 | 2 |
| 2010-01-13 8:02:00 | Valve1 | 0 |
| 2010-01-13 8:02:00 | Valve2 | 2 |
| 2010-01-13 8:04:00 | Valve1 | 1 |
| 2010-01-13 8:04:00 | Valve2 | 2 |
| 2010-01-13 8:06:00 | Valve1 | 1 |
| 2010-01-13 8:06:00 | Valve2 | 1 |
| 2010-01-13 8:08:00 | Valve1 | 0 |
| 2010-01-13 8:08:00 | Valve2 | 1 |

### Color Mapping
Apart from getting the data into the series chart, the only other commonly configured option is the mapping of discrete values to colors. This is done in the Status Chart Customizer. Each named series can have its own mapping of colors, if desired. These mappings are stored in the expert-level dataset property Series Properties Data so they can be altered at runtime.

## Properties

| Name 	| Description 	| Property Type 	| Scripting 	| Category 	|
|---	|---	|---	|---	|---	|
| Antialias 	| Draw with antialias on? Makes text smoother. 	| boolean 	| .antialias 	| Appearance 	|
| Background Color 	| The background color of the component. 	| Color 	| .background 	| Appearance 	|
| Border 	| The border surrounding this component. NOTE that the border is unaffected by rotation. 	| Border 	| .border 	| Common 	|
| Chart Title 	| Title of this chart. 	| String 	| .chartTitle 	| Appearance 	|
| Cursor 	| The mouse cursor to use when hovering over this component. 	| int 	| .cursorCode 	| Common 	|
| Data Format 	| Format of the incoming data. In "wide" format, the first column of the dataset needs to be a timestamp, and every subsequent column represents one series in the chart. In "tall" format, the first column is a timestamp, the second column is a series name. 	| int 	| .dataFormat 	| Data 	|
| Data Quality 	| The data quality code for any tag bindings on this component. 	| int 	| .dataQuality 	| Data 	|
| Date Style 	| The style to display dates in. For international support. 	| int 	| .dateStyle 	| Appearance 	|
| Domain Axis Color 	| Color used on the domain axis. 	| Color 	| .domainAxisColor 	| Domain Axis 	|
| Domain Axis Font 	| Font used on the domain axis. 	| Font 	| .domainAxisFont 	| Domain Axis 	|
| Domain Axis Label 	| Label on the domain axis. 	| String 	| .domainAxisLabel 	| Domain Axis 	|
| Domain Axis Location 	| Location of the domain axis. 	| int 	| .domainAxisLocation 	| Domain Axis 	|
| Mouseover Text 	| The text that is displayed in the tooltip which pops up on mouseover of this component. 	| String 	| .toolTipText 	| Common 	|
| Name 	| The name of this component. 	| String 	| .name 	| Common 	|
| Properties Loading 	| The number of properties currently being loaded. (Read only. Usable in bindings and scripting.) 	| int 	| .propertiesLoading 	| Uncategorized 	|
| Range Axis Color 	| Color used on the range axis. 	| Color 	| .rangeAxisColor 	| Range Axis 	|
| Range Axis Font 	| Font used on the range axis. 	| Font 	| .rangeAxisFont 	| Range Axis 	|
| Range Axis Label 	| Label on the range axis. 	| String 	| .rangeAxisLabel 	| Range Axis 	|
| Range Axis Location 	| Location of the range axis. 	| int 	| .rangeAxisLocation 	| Range Axis 	|
| Range Axis Lower Margin 	| Lower margin of the range axis. 	| double 	| .rangeAxisLowerMargin 	| Range Axis 	|
| Range Axis Upper Margin 	| Upper margin of the range axis. 	| double 	| .rangeAxisUpperMargin 	| Range Axis 	|
| Series Data 	| Data about each series. Data can be in either "wide" or "tall" format. 	| Dataset 	| .data 	| Data 	|
| Series Properties Data 	| Properties for each series. 	| Dataset 	| .properties 	| Data 	|
| Series Spacing 	| Affects the amount of spacing between series. Can be between 0.0 and 1.0. The series present on this chart are given equal space to display themselves. Series spacing is the percentage of that space that they use to do so. 	| double 	| .seriesSpacing 	| Appearance 	|
| Show Domain Axis 	| Sets whether or not the domain axis is visible. 	| boolean 	| .domainAxisVisible 	| Domain Axis 	|
| Show Range Axis 	| Sets whether or not the range axis is visible. 	| boolean 	| .rangeAxisVisible 	| Range Axis 	|
| Time Style 	| The style to display times of day. For international support. 	| int 	| .timeStyle 	| Appearance 	|
| Title Color 	| Color of the chart title. 	| Color 	| .titleColor 	| Appearance 	|
| Title Font 	| Font on the chart title. 	| Font 	| .titleFont 	| Appearance 	|
| Visible 	| If disabled, the component will be hidden. 	| boolean 	| .visible 	| Common 	|

## Scripting
See the [Status Chart Scripting Functions](status-chart-scripting.md) page for the full list of scripting functions available for this component.

### Event Handlers
Event handlers allow you to run a script based off specific triggers. See the full list of available event handlers on the [Component Events](scripting\scripting-in-ignition\component-and-window-scripting\component-events.md) page

## Customizers
The Status Chart component has its own customizer, used to set a number-to-color mapping for each series in the **Series Data** property.
 
### Status Chart Customizer

| Property | Description |
|---|---|
| Series | Selectable list of all objects in the Series Data property. **Wide** format: Each non-timestamp column.**Tall** format: each unique value in the Name column. |
| Properties Table | The number-to-color mapping for the selected Series. |
| Value | A numeric value to match against. |
| Color | The color to display for the given value. |
| Apply To All | Set all of the Series mappings to the currently selected mapping. |

![The Status Chart Customizer window. A Series list on the left holds Machine 1, Machine 2, and Machine 3, with Machine 1 selected. The Properties table on the right maps the selected series' values to colors: 0.0 to red, 1.0 to green, and 2.0 to yellow. Green plus and red X icons add and remove mappings, and an Apply To All button sits below the table, with OK and Cancel at the bottom of the window.](customizer.png)

## Examples
This example uses the Status Chart to display the state of each of the three machines over the last 5 minutes. Tag History was turned on to record history HOA values. The Series Data property's dataset populates the Status Chart using a Tag History Binding. You can view the raw data by clicking on the Dataset Viewer icon to the right of the Series Data property. Each color represents a state for the machine.

![A window titled "Machine Status" containing a Status Chart of Machine 1, Machine 2, and Machine 3 over five minutes, from 10:22 AM to 10:27 AM on Feb 1, 2017. Each machine's row is a band of red, yellow, and green segments recording its HOA state over time. Below the chart, three columns of Hand, Off, and Auto buttons, one column per machine, show each machine's current state highlighted: Hand in yellow for Machine 1, Off in red for Machine 2, and Auto in green for Machine 3.](machine-status-chart.png)

### Series Data - Dataset Viewer
![The Dataset Viewer window showing the Series Data in wide format: a t_stamp column of one-second timestamps starting at 02/01/2017 10:22:04, followed by a Machine 3, Machine 2, and Machine 1 column holding the numeric state of each machine at that timestamp.](series-data.png)

### Series Properties Data - Dataset Viewer
Each machine has three states, and each of the three states (i.e., HOA) have different colors assigned representing a different state.

![The Dataset Viewer window showing the Series Properties Data, with SeriesName, Value, and Color columns. Series1, Series2, and Series3 each have three rows mapping value 0 to red, 1 to green, and 2 to yellow.](series-properties-data.png)