SysCAD Tags

Navigation: User Guide ➔ Windows ➔ Access Window ➔ SysCAD Tags

SysCAD Tags	Copy and Paste Tags	Change Tag	Data Transfer

---

Tag Composition

Each unit and link in SysCAD has a unique name, or Tag. A Full Tag consists of the Unit Tag, Field Tag and Conversion.

For example: P_003.Qo.Qm (t/h)

P_003 - The Full Tag represents the process unit or link, in this case pipe "P_003".

Qo.Qm - The Field Tag represents a property within the unit or link, in this case the Mass Flow (Qm) of the Outlet Stream (Qo).

(t/h) - The Conversion for the value (if applicable), in this case tonnes per hour. Note, if no conversion is assigned or the conversion is invalid, the default SI units will be used.

Model Tags

Some tag naming rules need to be observed when naming unit models (ie Feeder, Tanks, Pipes, Controllers etc). For example, the Tag name for the Feeder below is "Plant_Feed"

The following rules apply to Model Tag names:

• Must be unique within a project.
• Tags are not case-sensitive.
• A tag may not contain any "whitespace". So no spaces, tabs or control characters. Use _ (underscore) instead.
• A tag may not contain a(dot). Theis used to separate the parts of a full tag.
• Tag may not begin with =
• A tag may not contain any of the following characters
• Tags cannot only contain numeric (0-9) characters. For example "120053" is not allowed.
• If the project setting "Allow Tags Beginning with Numeric" is NOT selected then the first character of a tag cannot be a numeric character (0-9).
• The tag length should not be too long. The maximum length allowed is 50 characters

Note

1. Builds 137 and later have stricter tag naming rules, in addition to the Build136 tag restrictions, these characters are also not allowed anywhere in the tag
2. Build 136 tag restrictions:
   • tags cannot begin with
   • tags cannot contain any of these characters .
3. Tag name may not be able to handle foreign language such as Chinese, please input tag name using English keyboard if possible. This also applies to punctuation marks.
4. These tag naming rules also apply to User Property and Species Calculation variable naming and SysCAD project naming. One exception applies, the dot(.) can be used in these names.

Species Tags

Some tag naming rules need to be observed when defining species in the Species Database, these apply to the Species Definition fields as shown and explained below:

Species tags are case sensitive. For the full tag "P_002.Qo.QM.H2O(l) (t/h)" the "H2O(l)" part is case sensitive.

The following rules apply to the Long Name field when defining a species: for example "Water" or "Sodium_sulphate"

• May not contain any "whitespace". So no spaces, tabs or control characters. Build 135 and earlier allowed spaces.
• May not contain a (See Note)
• May not only contain numeric (0-9) characters.
• The maximum length allowed is 50 characters.

The following rules apply to the Short Name and Component fields when defining a species: for example "H2O" or "Na2SO4"

• May not contain any "whitespace". So no spaces, tabs or control characters.
• May not contain a (See Note)
• May not only contain numeric (0-9) characters.
• If the tag contains one or more of '+' and/or '-', these must be at the end of the tag.
• The maximum length allowed is 50 characters.

The following rules apply for the Individual Phase label when defining a species: for example "aq", "organic" or "slag"

• May not contain any "whitespace". So no spaces, tabs or control characters.
• May not contain a(dot).
• May not contain a (See Note)
• May not only contain numeric (0-9) characters.
• The maximum length allowed is 20 characters.

NOTE: Species name may not be able to handle foreign language such as Chinese, please input tag name using English keyboard if possible. This also applies to punctuation marks.