---
title: "SPC Histogram Chart - Perspective"
id: "spc-histogram-chart-perspective"
project: "MES User Manual"
url: "https://docs.sepasoft.com/articles/user-manual/spc-histogram-chart-perspective"
updated: 2026-07-31T14:56:34Z
---

# SPC Histogram Chart \- Perspective

**Sepasoft MES Module Suite**
 The Histogram chart is used to display frequency distribution of sample measurements. Different from control charts that present a picture of how a process varies over time. Histograms, on the other hand, present a picture of how the process "stacks up" over time. Histograms illustrate how many times a certain data value or range of data values occurred in a given time frame. Histograms reveal the distribution of data values, compare them with specification limits, and generate useful metrics and statistics that describe the data set in detail.

![](/resources/Storage/user-manual/spc-histogram-chart-perspective/image%20%281%29.png)

Included in Sepasoft Versions:

| ![Warning](/resources/Storage/user-manual/user-manual/Warning.png) | MES 3.81.7 RC1 and later |
| --- | --- |

![](/resources/Storage/user-manual/spc-histogram-chart-perspective/image2022-11-9_5-18-24.png)

**Ignition DesignerPerspective Component Palette**
 * * *
 ### Component Properties

Properties are provided that can be set to affect the operation and look of the component. They can be set through the **Property Editor in the Designer** or through scripting.

```python
self.getSibling("Histogram").noDataMessage = "No data message"
```


 ##  SPC Perspective Chart Dataset Properties 

These properties are available in the Ignition Properties Palette for SPC Charts.

![](/resources/Storage/user-manual/perspective-chart-dataset-properties/showAdditionalFactorColors.png)

| **Property Source** | 
```
propertySource
```
 | Sets the datasource mode. Toggle two options: **Use\_stored\_settings** | **Use\_binding**<br> <br>Included in Sepasoft Versions:<br> <br><br>| ![Warning](/resources/Storage/user-manual/user-manual/Warning.png) | MES 3.81.7 RC1 and later |<br>| --- | --- |<br> <br><br> <br>**Use\_stored\_settings:** Sets the chart to receive data from Stored Settings. **To use this, enter property values under storedSettings, see below**.<br> <br><br> <br>**Use\_binding:**Sets the chart to receive data from an SPC Controller. **To use this, bind to an SPC Controller under spcChartSettings, see below.**<br> <br><br><br>When clicking the binding icon on the left side of the propertySource, the Configure Property Binding dialog appears.<br><br>![](/resources/Storage/user-manual/perspective-chart-dataset-properties/perspective-chart-dataset-properties-2024-10-09-1.png) |
| --- | --- | --- |
| **Stored Settings** | storedSettings | Set property values here when **propertySource** is set to **Use\_stored\_settings** |
|  |  | | **Property Name** | **Data Type** | **Property Value Description** |<br>| --- | --- | --- |<br>| storedSPCName | String | **Required when propertySource = 'Use\_stored\_settings':** Sets name of the Stored SPC Setting. The name must match exactly to the name you enter in Stored SPC Selector.<br><br><br>| ![Note](/resources/Storage/user-manual/user-manual/Note.png) | Stored SPC Selector component only offered in VISION.<br><br>See [Stored SPC Selector | Vision](/articles/user-manual/stored-spc-selector-vision) |<br>| --- | --- | |<br>| location | String | **Optional:** Filter on a Location that is defined in Equipment Manager. Enter the Equipment Path to the Location. |<br>| startDate | Date | **Required:** Sets start date to filter SPC data on<br><br><br>| ![Note](/resources/Storage/user-manual/user-manual/Note.png) | Bind to form fields on the view to make dates selectable in runtime.![](/resources/Storage/user-manual/perspective-chart-dataset-properties/perspective-chart-dataset-properties-2024-10-09-2.png) |<br>| --- | --- |<br><br><br>**Required:** Sets end date to filter SPC filter on |<br>| endDate | Date |<br>| autoRefresh | Boolean | True/False **Required**: True, refreshes data when sample or definition information changes. **Set to True to use real-time data.** | |
| **SPC Chart Settings** |  | spcChartSettings <br>   ****  Set property values here when **propertySource** is set to **Use\_Binding**<br><br><br>**Bind to the SPC Controller** |
|  |  | | **Property Name** | **Data Type** | **Information** |<br>| --- | --- | --- |<br>| storedSPCName | String | Incoming property value from the SPC Controller &gt; Stored Setting. |<br>| startDate | Date | Sets start date to start filtering data on |<br>| endDate | Date | Sets end date to filter data on |<br>| autoUpdate | Boolean | Required True/False: True, updates data when a sample is taken. Use for realtime data. |<br>| autoRefresh | Boolean | Required True/False: True, refreshes data when sample or definition information changes. Use for realtime data. |<br><br> <br>![](/resources/Storage/user-manual/perspective-chart-dataset-properties/image%20%285%29.png) |
|  |  | **settings** <br> <br><br><br><br><br>| **additionalFactors**: | String - Additional factors to include in the SPC chart. |<br>| --- | --- |<br>| **attributeName:** | String - Name of the sample attribute |<br>| **attributeUnits**: | String - Adds a label for the unit of measure for the sample |<br>| **boxAndWhiskerFilter**<br><br>Chart Specific | String - Box and whisker filter items to filter on. |<br>| **controlLimits:** | String - Summarizes control limits to add to the chart |<br>| **definitionName:** | String - Name of the sample definition. |<br>| **filters:** | String -<br><br>**location:** The Location Path defined in the Equipment Manager to filter on.<br><br>**factors:** Properties &gt;Additional Factor<br><br>Filter on existing additional factors |<br>| **measurement:** | String - Measure number to filter on |<br>| **nonconformingFilter**<br><br>Chart Specific | String - Nonconforming items to filters on |<br>| **nonconformityFilter**<br><br>Chart Specific | String - Nonconformity items to filters on |<br>| **paretoFilter**<br><br>Chart Specific | String - Items to include in a Pareto chart. |<br>| **rowLimit:** | ****String - The maximum number of samples to return in the results. |<br>| **signals** | String - Summarizes your signal selections in a string. |<br>| **spcDataFormat:** | String - SPC Data<br><br><br>| ![Note](/resources/Storage/user-manual/user-manual/Note.png) | Each chart type has specific settings. Select the correct chart from the dropdown menu. |<br>| --- | --- | |<br>| **useDefaultChartTyp** **e:** | String - If true, uses the default chart type from the attribute definition. |<br>| **useDefaultChartTyp** **e:** | String - If true, uses the default chart type . |<br>| **enableFutureLimitEditing:** | String -If true, you can set limits for future (non-existing) samples. | |
|  |  | **histogram** <br> <br><br><br><br><br>| **autoBarCount**: | Boolean - If true, the number of data bars that are displayed is calculated automatically. |<br>| --- | --- |<br>| **dataBarCount** | int - The number of data bars to display when **autoBarCount** is False. |<br>| **paddingBarCount** | int - The number of bars prior to and following the data bars to include in the histogram results. | |
|  |  | **dynamic**<br><br>When using an SPC Controller to populate a Perspective SPC Chart, these dynamic filters can be used to filter the data for display in a chart.<br><br><br><br><br>| **factor** | String - Additional factors that were recorded along with the sample. |<br>| --- | --- |<br>| **location** | String - The location path where the samples were collected. |<br>| **productCode** | String - Samples returned should have this Product Code if present. |<br>| **referenceNo** | String - Samples returned should have this Reference Number if present. |<br>| **sampleApprovedBy** | String - The username of the user that approved the samples. |<br>| **sampleTakenBy** | String - The username of the user that recorded the samples. |<br>| **shift** | String - A schedule shift during which the samples were taken. | |
|  |  | **spcResults**<br><br>SPC Results including data, measurement count, messages and calculated value information.<br><br><br><br>**definitionUUI**<br><ul><li><strong>calcValueList</strong><ul><li><strong>defaultChart</strong></li><li><strong>measureFormat</strong></li><li><strong>unit</strong></li></ul></li></ul><br>**measurementCount**<br><ul><li><strong><strong>messages</strong></strong><ul><li><strong>errormessage</strong></li><li><strong>warningMessage</strong></li></ul></li></ul>**spcData: dataset - The SPC data.** |  |
| **showTable** | Boolean | Enable to display the data table. The table is updated as new data comes in. |  |

| Scripting Reference | Description | Description | Description |  |
| --- | --- | --- | --- | --- |
| **xAxisVerticalTickLabels** | **Boolean** | Set to True to show labels of the vertical tick marks on the x axis. |
| **enableControlLimitEditing** | **Boolean** | Set to True to allow end-users to edit control limits |
| **vertical** | **Boolean** | Set to True to set the chart in a vertical orientation. |
| **noDataMessage** | **String** | The message to show when there is no data returned. |
| **valueAxisTitle** | **String** | Title to show for the value axis. |
| **frequencyAxisTitle** | **String** | Title to show for the frequency axis. |

|  | **chartDataStyle** |  |
| --- | --- | --- |
|  |  | **barColor** | Color, picker available | Sets the color of the bars |
|  |  | **barSpacing** | Float | Spacing between bars as a percentage of the bar width. |
|  |  | **gradient** | Boolean | If true, bars are drawn with a gradient shine. |
|  |  | **shadow** | Boolean | If true, shows a shadow on the bars. |

|  | **tickStyle** |  |  |  |  |
| --- | --- | --- | --- | --- | --- |
|  |  | **tickLabelColor** | Color, picker available | The color of the tick labels. |
|  |  | **tickLabelFont** | String | The font of the tick labels. |

|  | **axisStyle** |  |
| --- | --- | --- |
|  |  | **axisTitleColor** | Color, picker available | Color of the axis titles |
|  |  | **axisTitleFont** | Font Family | Sets the font for the axis titles |
|  | **chartStyle** |  |  |  |  |
|  |  | **showHorizontalGridLines** | Boolean | If true, shows horizontal grid lines. |
|  |  | **horzGridLineColor** | Color, picker available | Sets the color of the horizontal grid lines on charts. |
|  |  | **chartBackground** | Color, picker available | The background color of the primary chart. |
|  |  | **showVerticalGridLines** | Boolean | f true, shows vertical grid lines on charts. |
|  |  | **vertGridLineColor** | Color, picker available | The color of vertical grid lines. |

### Meta Properties in the Perspective Property Editor

| Name<br><br>Scripting Reference | Data Type | Description | Description | Description |
| --- | --- | --- | --- | --- |
| **name** | String | Name of the component. Used in scripting and component tree paths by name, such as during Property Binding. |
| **visible** | Boolean | Whether or not this component should display. |
| **tooltip** |  |  |
| **enable** | Boolean | Whether the tooltip on hover |
| **width** | Integer | The height of the table rows. |
| **text** | String | The scroll bar x position. |
| **style** | Boolean | Toggle to show or hide the sample data table. |
| **delay** | Boolean | Image icon to show to edit control limits. |
| **sustain** | Integer | Time, in milliseconds, to display tooltip before removing it. A value of 0 results in the tooltip displaying until the mouse exits the components. |
| **location** | Boolean | The location where the tooltip displays. |
| **tail** | Boolean | Enables a decorative triangle on the tooltip that points to the tooltip owner. Ignored when location uses a value of 'mouse'. |

 ## Extension Functions

This component does not have extension functions associated with it.

 Custom Methods

Custom methods allow you to add your own component functions to a component that can be called through scripting. This is a useful and clean method of re-using script that is specific to the component (say you want to update a visual aspect of the component in the same way whether a user clicks on the component or a window property value changes). See [Component Custom Methods](https://docs.inductiveautomation.com/display/DOC79/Custom-Component-Methods) in the Ignition Help Manual for more information.

 Customizers

This component does not have any custom properties.

 ## Component Functions

Example of the component on the page root container:

**event.source.parent.getComponent('Box and Whisker Chart').showSetLimitPanel** **(True)**.

showSetLimitPanel
* Description

Causes the calculate and set control limit dialog to be shown.

* Parameters

Boolean - True/False

* Return

Nothing

* Scope

Client
 
**Sepasoft MES Module Suite**