Easy Chart Customizer

The Pens tab is where you can add new pens, create custom names for your pens, and group pens. There are three types of pens, and each functions in a similar manner, but what makes them different is how their data is collected. Each pen type has a few unique properties and is listed at the bottom of the table.

• Tag pens - Pens are driven by the Tag history system. (Data from any historical provider can be used).
• Database pens - Pens that are driven by an SQL query. They can query for data in any connected SQL database.
• Calculated pens - Pens that derive their data from calculations performed on other pens.
   

Property	Description
	Add pen (Browse for Tags).
	Add a pen manually.
	Edit pen.
	Delete pen.
Edit Pen Panel	Contains all the editable fields for the pen row selected.
Name	The name of the pen is what the user will see in the legend and the pen panel.
Enabled	If false, this pen will not show up on the chart and the data will not be generated. The user will be able to enable it via the pen control panel.
Hidden	If true, the pen will not show up on the chart or the pen control panel. The data will be generated.
User Selectable	If false, the pen will show up on the chart, but not the pen control panel.
Axis	Select the Y axis this pen will use.
Subplot	Putting pens on separate subplots can increase chart clarity.
Group Name	The group name is used for logical grouping in the pen panel and for advanced dynamic grouping.
Digital Offset	If true, a small gap will be placed between this and other digital pens so they don't overlap each other.
Color	Pen color.
Style	The style of the pen determines how it looks in the chart.
Dash Pattern	Uses a dash pattern like "5,5" to specify 5 pixels on, 5 pixels off.
Line Weight	The thickness of the pen's line.
Shape	If the renderer style uses shapes, this will be the shape for each point.
Fill Shape	If true, the shape will be filled in rather than an outline.
Labels	If true, shows a label of the value above each bar.
Preview	Field where you can view the pen style.
Tag History Pens Properties
Tag Path	String-based path where the Tag is located.
Aggregation Mode	Type of calculation (i.e., Constant, UCL, UWL, Avg, LWL, LCL, MovingAvg, Multiply, Min, Max).
Database Pens Properties
Volume Column	The name of the column for the pen's value (Y value).
Time Column	The name of the column for the pen's timestamp (X value).
Table Name	The name of the table where the pen will be found.
Datasource	The name of the datasource to use for this pen (MySQL).
Where Clause	You can specify a snippet of WHERE clause here, like "TankNum = 16."
Run Diagnostics	Test this pen for data configuration for validity.
Calculated Pens Properties
Function	Function is the type of calculation (i.e., Constant, UCL, UWL, Avg, LWL, LCL, MovingAvg, Multiply, Min, Max).
Driving Pen	Dedicated pen that will drive the value.
Parameter	Value which is the horizontal line drawn on the graph. The parameter type can be different for the Function used: Constant Value - constant value of the pen.(Used with the Constant function). Window Size - the size of the moving average window, specified as a multiplier of the chart's date range. It's the percentage of time that you're going to do the moving average on. (Used with MovingAvg function). Factor - multiply by 'X' factor (Used with Multiply function). Secondary pen - another pen added to the chart to show the sum and/or the difference. (Used with the Sum and Difference functions).

For more information, refer to the following sections:

• Easy Chart - Pen Names and Groups
• Easy Chart - Calculated Pens
• Using the Easy Chart

The Axes tab is where you can configure multiple axes on the Easy Chart component.
 

For more information, refer to the Easy Chart - Axes.

The Subplot tab is where you can break up a chart's plot area into multiple distinct subplots that share the X axis, and also where you can add additional subplots.
 

For more information, go to Easy Chart - Subplots.

Dynamic Groups are used with Database pens. They allow you to apply a dynamic condition, like using a WHERE clause, to a subset of pens. For each pen group, a dynamic string property will appear in the Property Editor under Custom Properties of your Easy Chart component. You can create a WHERE clause that will search the database and return values if the pens meet a true condition.
 

Property Editor - Custom Properties - Where Clause for Dynamic Group Property

To learn more about Dynamic Groups, refer to the Easy Chart section.