Get Tag List Model
From SysCAD Documentation
Navigation: Main Page -> Models -> Process Control Models
Contents |
General Description
The Get 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 getting a long list of tags.
The Get Tag list model reads column of tags from a data file and then writes back the corresponding values to a subsequent column in the file. The first column must contain valid SysCAD Tags, any subsequent columns are optional and any data in these columns may be overwritten. Only one column of values can be written to the file at a time. The column to be written to is selected by the user.
By allowing multiple columns, the user can obtain a table of values where each column represents a different case or scenario. In a dynamic model the different columns can represent a set of values obtained at different times during a scenario. Up to 254 columns are allowed.
The model can be used to get all the tags when the model is finished solving, or the user can manually get the tags by pressing the Get Tags button.
Get Tag List Format
The input file should be a comma or tab separated text file. Typically a csv file.
- The first row (or line) in the Get Tag List file is ignored. The user may place column headings in the first row.
- The first column must contain valid SysCAD Tags.
- If the tag is invalid then SysCAD reports an error in the message window.
- String and numeric tag types are allowed.
- The second and any subsequent columns is where SysCAD will paste the values into.
Examples
Example of different tag types:
| Tag | Value Obtained |
| XPG_86.Qm (t/h) | 200 |
| XPG_86.T (C) | 220 |
| XPG_86.EqpDesc | Plant Feed |
| PID_CCD.Cfg.[0].Output_Tag | CCD_WashWater.Qm_Rqd (t/h) |
| PID_CCD.Cfg.[0].On | 0 |
Example for composition in pipe P_001 showing two columns of values:
File prior to getting tags (values in columns 2 onwards are ignored):
Tag
P_001.Qo.MF.C(s) (%)
P_001.Qo.MF.CO(g) (%)
P_001.Qo.MF.CO2(g) (%)
P_001.Qo.MF.N2(g) (%)
P_001.Qo.MF.O2(g) (%)
P_001.Qo.MF.H2O(g) (%)
P_001.Qo.MF.H2O(l) (%)
File after Get Tag List model run for column 1 and column 2:
| Tag | ||
| P_001.Qo.MF.C(s) (%), | 0, | 10 |
| P_001.Qo.MF.CO(g) (%), | 5, | 0 |
| P_001.Qo.MF.CO2(g) (%), | 5, | 0 |
| P_001.Qo.MF.N2(g) (%), | 50, | 50 |
| P_001.Qo.MF.O2(g) (%), | 10, | 20 |
| P_001.Qo.MF.H2O(g) (%), | 20, | 10 |
| P_001.Qo.MF.H2O(l) (%), | 10, | 10 |
Note: Any data which was in columns 1 and 2 prior to the Get Tag List being generated will be overwritten. Any data that was in a column that wasn't written to (eg. column 3) will remain in the file.
How to use a Get Tag List
The easiest way to create the Get Tag List is by using MS Excel. The Get Tag List format and example is given above. Once the Get Tag List is created, save it as a csv file.
Switch to SysCAD, use the browse button to load the file into the model. Ensure the ColumnToGet is set to the correct column number.
The Get Tag List can then be generated by any of the following options:
- Pressing the GetTags button.
- Selecting the GetAtEnd option and solving the model.
- Setting the tag "GTL_001.GetTags" to 1 in a PGM (effectively pressing the GetTags button from the PGM).
Data Sections
|
Tag / Symbol |
Input / Calc |
Description |
|
| ||
|
On |
Tick Box |
Enables or disables the GetTagList Block. |
|
Status |
Feed back |
The status of the GetTagList with a brief summary of the file. |
|
Folder |
Feed back |
The full path of the Get Tag List file. |
|
File |
Input |
The file name of the Get 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. |
|
| ||
|
GetTags |
Button |
Use this button to Get the Tags from SysCAD. |
|
ColumnToGet |
Input |
This specifies which column the values will be written into. Default value is 1 which corresponds to the first column. |
|
GetAtEnd |
Tick Box |
This will fetch the tags after the model has solved. |
Adding this Model to a Project
Insert into Configuration file
Sort either by DLL or Group.
|
|
DLL: |
Control1.dll |
→ |
Units/Links |
→ |
Control: Get Tag List |
|
or |
Group: |
General |
→ |
Units/Links |
→ |
Control: Get Tag List |
See Project Configuration for more information on adding models to the configuration file.
Insert into Project
|
|
Insert Unit |
→ |
Control |
→ |
Get Tag List |
See Insert Unit for general information on inserting units.
Hints and Comments
- Useful model to output the same tags for multiple scenario cases or at different times.
- PGM logic can be written to effectively "push the button" to get values at a certain point and write them to the user specified column number.
