Trends Guide - TREND Optional Values (Using TrendSpec to Produce Ad Hoc Trends)

TREND Optional Values

Place any optional TREND values outside of any other sections, but within the TREND section in a TrendSpec definition. Remember to include a comma before listing any of these optional values. Include a comma between each optional value’s definition.

Many of the optional TREND values are equivalent to the properties that you can specify using the Trend Properties window on a Pre-Configured Trend. For further information on these properties, see Configure the Display Settings for a Trend.

The optional values that you can specify within the TREND section are:

TREND Optional Values
Identifier	Value Type	Comments
Title (Use as an alternative to the TitleExpr identifier.)	String	Use to define the Trend’s title. Example: Title = 'Sensor1' Alsosee Use TrendSpec to Define a Multiple Trace Ad Hoc Trend. To use an expression to define the value of the Trend’s title, use the TitleExpr identifier instead of this Title identifier.
ShowYAxes	Boolean	Use to specify whether any y-axes are shown on the ad hoc Trend. (You need to include a YAXIS section per trace in your TrendSpec definition, regardless of the value of the ShowYAxes identifier.) Example: ShowYAxes = True If an ad hoc Trend is multi-trace and y-axes only need displaying for some of those traces, omit the TREND ShowYAxes identifier and include individual YAXIS Visible identifiers in your TrendSpec definition.
ShowXAxis	Boolean	Use to specify whether the x-axis is shown on the ad hoc Trend. (You need to include an XAXIS section in your TrendSpec definition, regardless of the value of the ShowXAxis identifier.) Example: ShowXAxis = True
ShowTitle	Boolean	Use to specify whether the Trend Title is shown on the ad hoc Trend. Example: ShowTitle = True ClearSCADA only takes into account the values of any other Title identifiers if ShowTitle = True.
ShowKey	Boolean	Use to specify whether the Trend Key is shown on the ad hoc Trend. Example: ShowKey = False
TitleExpr (Use as an alternative to the Title identifier.)	String	Use to define the Trend’s title. Example: TitleExpr = '''AdHocTrends.Sensor1''' Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes. To specify a string, rather than an expression, use the Title identifier instead of this TitleExpr identifier.
AlarmLimitLabelPos	Identifier value	Use to specify the position of the alarm limit labels. Specify one of these values: LimitLabelNone, LimitLabelAboveLeft, LimitLabelAboveRight, LimitLabelOverLeft, LimitLabelOverRight, LimitLabelLeft, or LimitLabelRight Example: AlarmLimitLabelPos = LIMITLABELABOVERIGHT Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
TitleColour	RGB	Use to specify the RGB color that is assigned to the Trend’s title. Example: TitleColour = RGB(0,0,0) Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Colors.
TitleFont	String	Use to specify the font used for the Trend’s title. Example: TitleFont = 'Tahoma' Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
TitleFontHeight	Integer	Use to specify the height of the font used for the Trend’s title. Example: TitleFontHeight = 8 Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
TitleFontStyle	Identifier value or Integer	Use to specify the attributes assigned to the Title’s text. For information on the values that you can specify, see Supported FontStyle Identifier and Integer Values. Example: TitleFontStyle = FontStyleBold or TitleFontStyle = 1 Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
MainFont	String	Use to specify the font used for the text that is shown in the main body of the Trend window. Example: MainFont = 'Tahoma' Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
MainFontHeight	Integer	Use to specify the height of the font used for the Trend’s body text. Example: MainFontHeight = 8 Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
MainFontStyle	Identifier value or Integer	Use to specify the attributes assigned to the Trend’s body text. For information on the values that you can specify, see Supported FontStyle Identifier and Integer Values. Example: MainFontStyle = FontStyleRegular or MainFontStyle = 0 Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
LabelFont	String	Use to specify the font used for the y-axes’ label. Example: LabelFont = 'Tahoma' Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
LabelFontHeight	Integer	Use to specify the height of the font used for the y-axes’ label. Example: LabelFontHeight = 8 Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
LabelFontStyle	Identifier value or Integer	Use to specify the attributes assigned to the y-axes’ label’s text. For information on the values that you can specify, see Supported FontStyle Identifier and Integer Values. Example: LabelFontStyle = FontStyleBoldItalic or LabelFontStyle = 3 Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.
BackgroundColour	RGB	Use to specify the RGB color used for the ad hoc Trend’s background. Example: BackgroundColour = RGB(236,233,216) Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Colors.