Set Tag List Model

From SysCAD Documentation

Navigation: Main Page -> Models -> Process Control Models

---

Contents 1 General Description 2 Set Tag List Format 2.1 Examples 3 How to use a Set Tag List 4 Data Sections 5 Adding this Model to a Project 6 Hints and Comments

General Description

The Set Tag List model can be used in both SysCAD ProBal and SysCAD Dynamic. It can be used as a fast alternative to using Excel for setting a long list of tags (usually configuration data).

The Set Tag list model reads a data file containing two or more columns. The first column must contain valid SysCAD Tags, the second and optional subsequent columns contain the corresponding tag values to be set in SysCAD models. Only one column of values can be set at a time. The column set is selected by the user.

By allowing multiple columns, the user can configure a table of values for the tags where each column represents a different scenario, case or set of inputs. Then all the user needs to do is change the current column to swap between different input sets or scenarios. The Get Tag List Model also supports optional multiple columns so if the current column number for this is changed at the same time, the Get Tag List Model can be used to report results in a corresponding column. In a dynamic model the different columns can represent a set of values to be applied at different times during a scenario. Up to 254 tag value columns are allowed.

The model can be used to set all the tags during initialisation or after initialisation (ie. during the first step) or the user can manually set the tags by pressing the Set Tag button.

If you wish to set tags before initialisation, then please use the SetTag List on the Plant Model. This is described in the following section: SetTagList Tab Page.

Set Tag List Format

The input file should be a comma or tab separated text file. Typically a csv file.

1. The first row (or line) in the Set Tag List file is ignored. The user may place column headings in the first row.
2. The first column must contain valid SysCAD Tags.
   • If the tag is invalid or can not be set (eg a result field) then SysCAD reports an error in the message window.
   • If on a row there is a blank (empty cell) for the tag, then all subsequent rows and tags are ignored.
   • String and numeric tag types are allowed.
3. The second column contains the corresponding tag values to be set.
   • Numeric values and strings are supported. See example below.
   • If on a row there is a blank (empty cell) for the value, then a value is not set. So unlike the tag column, a blank entry is allowed.
   • User can use * to denote not a number (NAN).
4. The third and any subsequent columns are optional and have the same format as the second column described above.

Note:

• When SysCAD reads the file, it will stop when it finds an empty row. So be careful not to leave rows blank.
• Some SysCAD tags can only be set when the project is not solving.

Examples

Example of different tag types:

Tag	Value
XPG_86.Qm_Rqd (t/h)	200
XPG_86.T_Rqd (C)	220
PID_CCD.Cfg.[0].Output_Tag	CCD_WashWater.Qm_Rqd (t/h)
PID_CCD.Cfg.[0].AbsTol (%)	*
PID_CCD.Cfg.[0].On	0

Example for feeder composition showing two columns of values:

Tag	Value1	Value2
Natural_Gas.Content.CH4(g) (%)	96.923	95.3845
Natural_Gas.Content.CO(g) (%)	0	0
Natural_Gas.Content.CO2(g) (%)	2.68	4.02
Natural_Gas.Content.H2(g) (%)	0	0
Natural_Gas.Content.H2O(g) (%)	0.1	0.15
Natural_Gas.Content.N2(g) (%)	0.297	0.4455
Natural_Gas.Content.NH3(g) (%)	0	0
Natural_Gas.Content.O2(g) (%)	0	0
Natural_Gas.Content.H2O(l) (%)	0	0
Natural_Gas.Content.NH3(l) (%)	0	0

How to use a Set Tag List

The easiest way to create the Set Tag List is by using MS Excel. The Set Tag List format and example is given above. Once the Set Tag List is created, save it as a csv file.

Switch to SysCAD, use the browse button to load the file into the model. The LogTagSets drop down list allows the user to have the Tag Set history displayed in the message window and/or added to the Event Log.

NOTE: Some tags can only be set when SysCAD is not running, for example, turning the PID controller on/off. These types of tags can only be set when SysCAD is stopped or by selecting the SetDuringInit tick box.

Data Sections

Tag / Symbol	Input / Calc	Description
Common First Data Section
On	Tick Box	Enables or disables the SetTagList Block.
Status	Feed back	The status of the SetTagList with a brief summary of the file.
Folder	Feed back	The full path of the Set Tag List file.
File	Input	The file name of the Set Tag List. Note: this file must be created first. File can be txt or csv format.
Edit	Button	Allow the user to edit the file.
Browse	Button	Use this button to Browse for the file.
LogTagSets	List	None -- SysCAD will not log the tag sets.
		Messages -- SysCAD will log the tag sets in the Messages window only.
		EventLog -- SysCAD will log the tag sets in the Event Log only.
		Messages and EventLog -- SysCAD will log the tag sets in both the Messages window and the Event Log.
SetTags	Button	Use this button to Set the Tags into SysCAD.
ColumnToSet	Input	This specifies which column of values will be used when the tag list is set. Default value is 1 which corresponds to the first column of values.
SetDuringInit	Tick box	This will set the tags into SysCAD during the OnInitialise stage before it solves, thus any configuration information should be set into SysCAD using this option. If tags need to be set "before" initialisation, use the set tag list model which is part of the Plant Model.
SetAfterInit	Tick Box	This is equivalent to setting tags at the Onstart Stage, thus tags sets will occur during the first iteration of SysCAD solve. Note: some tags cannot be set while SysCAD is solving, in those cases, this tick box cannot be selected.

Adding this Model to a Project

Insert into Configuration file

Sort either by DLL or Group.

	DLL:	Control1.dll	→	Units/Links	→	Control: Set Tag List
or	Group:	General	→	Units/Links	→	Control: Set Tag List

See Models Selection for general information on editing the configuration file.

Insert into Project

Insert Unit

→

Control

→

Set Tag List

See Insert Unit for general information on inserting units.

Hints and Comments

1. If you cannot see this model in the list when you try to Insert a Unit, that means that the model is not in the Configuration file. See above 'Adding this Model to a Project' and also Project Configuration - Model Selection.
2. Useful model to quickly swap between multiple feed compositions or multiple scenario cases.
3. PGM logic can be written to effectively "push the button" to set the required column of tag values.