Calculated Pen Functions
There are a variety of functions that can be used to calculate the pen value. On the Edit Pen screen, they are in the Function dropdown list. The following table defines them all.
|Function||Display Name||Description||Extra Properties|
|Constant||Constant||A constant value on the chart.||Constant Value - The constant value of the pen|
|Upper Control Limit||UCL||The upper control limit of the driving pen, which is three standard deviations above the mean of the Driving Pen|
|Upper Warning Limit||UWL||The upper warning limit of the driving pen, which is two standard deviations above the mean of the Driving Pen|
|Average||Avg||The average of the driving pen.|
|Lower Warning Limit||LWL||The lower warning limit of the driving pen, which is two standard deviations below the mean of the Driving Pen|
|Lower Control Limit||LCL||The lower control limit of the driving pen, which is three standard deviations below the mean of the Driving Pen|
|Moving Average||MovingAvg||A series of averages based on subsets of the driving pen. The subsets are determined by the window size.||Window Size - The size of the moving average window, specified as a multiplier of the chart's date range.|
|Multiply Pen||Multiply||Multiply each data point of the driving pen by a factor.||Factor - The factor that each data point of the driving pen is multiplied by.|
|Minimum Value||Min||The minimum value of the driving pen.|
|Maximum Value||Max||The maximum value of the driving pen.|
|Running Sum||RunningSum||A running sum or running total of the driving pen.|
|Sum||Sum||The sum of two different driving pens.||Secondary Pen - The second driving pen.|
|Difference||Difference||The difference of two separate driving pens.||Secondary Pen - The second driving pen.|
|Linear Regression||LinearRegression||Will create a linear regression line for the driving pen.|
Configuring Calculated Pens
- Drag an Easy Chart component onto your window.
- Drag a tag onto the chart. We used Realistic 1 from Sim_Generic.
- Right click on the Easy Chart component and choose Customizers > Easy Chart Customizer.
The Pens tab will open and you'll notice a Calculated Pens Table at the bottom of the screen. Click the Addicon.
Calculated pens are just like other pens, so you can specify the style, color, axis and subplot in the Edit Pen window.
Set the calculated pen options as follows:
Name: High SP
Function field: Constant
Constant Value: 25
- Click OK again to view your High SP pen on your Easy Chart. The High SP value of 25 is represented on your Easy Chart by a blue horizontal line.
- Next, let's add a second calculated pen. On the Calculated Pens Table at the bottom of the screen. Click the Add icon.
- Set the calculated pen options as follows:
Function field: MovingAvg
- Driving Pen: Realistic1
Window Size: .2
If you have more Tags that you dragged on to your Easy Chart from the Tag Browser, you'll have more pens to choose from in the Driving Pen dropdown list.
- Click OK. The chart now displays a running average.
- Lets add two more calculated pens: one for Upper Control Limit (UCL) and another for Lower Control Limit (LCL), and set the Driving Property to 'Realistic1.'
- Once you added all your calculated pens, you'll see all your pens in the Calculated Pens Table at bottom of the window. Press OK.
- Now, all your calculations are displayed on your Easy Chart. The blue pen is the Constant, the pink pen is the Moving Average, and UCL and LCL are brown and green respectively.
Hide Driving Pens
Once you have your Calculated Pens created, you'll notice that they disappear if you disable the pen driving them. If you want to remove the Driving Pen but leave the Calculated Pens, set the Hidden property of the Driving Pen.