Species Configuration

Navigation: User Guide ➔ Edit ➔ Project Configuration (cfg File) ➔ Species Configuration

Project Configuration (Main Page)	Edit Configuration (Step 1)	Edit Configuration (Step 2)
	Model Selection	General Configuration	Species Configuration	Species Properties Configuration	Calculation Configuration	TCE Configuration	Size Configuration

Latest SysCAD Version: 19 March 2024 - SysCAD 9.3 Build 139.35102

Related Links: Editing User Species Database, Species Table, Species Properties ($SDB)

---

Edit Configuration Step 2 of 2 - Species Tab

Introduction

This tab page allows the user to select and organise the species list for projects using this configuration file.

Each of the sections and buttons in the above image are described below:

Name	Description	Comments
Species Lists
Hardwired Species	This contains a list of species that exist in the SysCAD software. Each species in this list will have as a minimum the following properties: Heat of Formation, H25; and Specific Heat, Cp.	Species that have a tick next to them are included in the project. If the user hovers over each species in the list, a pop-up dialog will show which properties are available for that species.
Species in User Database	This contains a list of species that are saved in the User Species Database.	A species MUST be in the user database to be used in the project. If the user hovers over each species in the list, a pop-up dialog will show the 'long' name for that species. Species that have a tick next to them are included in the project.
Species in Project	This contains a list of species that are available in the project, in the order in which they will be displayed on the Species page in the units.	Users may add species to this list from either the Hardwired Species list, or from the User Database list. If the user adds a species from the Hardwired species list, then that species will be added to both the Species in Project list and to the User database. Users may also add Text or Page labels to the species list and these will appear on the Species tab in the project.
Species Display Order This selection allows users to choose how the species are displayed in the project.
Species Display Order	Sol-Liq-Gas	The species in the project will be displayed in the order Solids, Liquids and then Gases. The species in each of the phases will be displayed in alphabetical order, with the exception that Water is displayed at the top of the Liquids and Steam at the top of the Gases.
	Gas-Liq-Sol	The species in the project will be displayed in the order Gases, Liquids and then Solids. The species in each of the phases will be displayed in alphabetical order, with the exception that Water is displayed at the top of the Liquids and Steam at the top of the Gases.
	Liq-Sol-Gas	The species in the project will be displayed in the order Liquids, Solids and then Gases. The species in each of the phases will be displayed in alphabetical order, with the exception that Water is displayed at the top of the Liquids and Steam at the top of the Gases.
	Sol-Liq-Gas Custom	The species in the project will be displayed in the order Solids, Liquids and then Gases. The user may display the species in each of the phases in any order.
	Gas-Liq-Sol Custom	The species in the project will be displayed in the order Gases, Liquids and then Solids. The user may display the species in each of the phases in any order.
	Liq-Sol-Gas Custom	The species in the project will be displayed in the order Liquids, Solids and then Gases. The user may display the species in each of the phases in any order.
	Custom	The user may display the species in the project in any order - the phases do not need to be maintained separately.
Add and Remove Buttons These are used to add and remove species from the project.
	This button allows a user to add a species to the project.	The user clicks on the required species in either the Hardwired Species list or in the Species in User Database list, and then clicks on this button to add the species to the project. The species will be added to the correct phase in the project list, unless the user has selected the 'Custom' display order, in which case the species will be added at the top of the list, or where the mouse was last clicked.
	This button allows a user to remove: a) A species from the project; or b) A label or Page Header from the Species list. (Label and Page Headers may only be edited if one of the 'Custom' species display orders have been chosen)	The user clicks on the required species in the Species in Project list or on the required Label or Page Header, and then clicks on this button to remove the species from the project or the Label from the list. NOTE: The species will NOT be removed from the User Database.
Customise Configuration These buttons are only active if the user has selected one of the 'Custom' species display orders. The user may use these buttons to customise how the species list is displayed in the project.
	This button allows a user to move a Label, a species or a group of species up the species list.	In the 'Species in Project' list, the user clicks on the required Species or Label and then clicks on the 'Move Up' button. Each click will move the selection up one place. To move a group of species, click on the top species required, then hold down the 'Shift' button and click on the last species required. All of the species between the top and bottom species will be highlighted. The user may now click on the 'Move Up' button to move the selection.
	This button allows a user to move a Label, a species or a group of species down the species list.	In the 'Species in Project' list, the user clicks on the required Species or Label and then clicks on the 'Move Down' button. Each click will move the selection down one place. To move a group of species, click on the top species required, then hold down the 'Shift' button and click on the last species required. All of the species between the top and bottom species will be highlighted. The user may now click on the 'Move Down' button to move the selection.
	This button allows a user to add a Label to the species list.	In the 'Species in Project' list, the user clicks the position above which the Label is required, and then clicks on the 'Label' button. A label consisting of lines, will be inserted into the species list. The user may then highlight the lines and type in the required label.
	This button allows a user to add a new Page to the species list.	In the 'Species in Project' list, the user clicks the position above which the Page is required, and then clicks on the 'Page' button. A line will be inserted into the species list. The user may then type in the required Page label. In the project, a new species page will be created with the user defined page name.
	This button allows a user to reset the Phase Labels back to their defaults.	The user clicks on the 'Reset Labels' button and all of the Phase labels, Solids, Liquids and Vapours, will be reset to the default label.

Video Links

The following videos show you how to add a species to the Configuration file. They also explain some of the Configuration functionality:

Edit the Project Configuration and the User Species Database

Adding a New Species to the User Database

If a required species is not shown in either the Species in User Database or the 'Hardwired Species' lists, the user may add the species to the User database as follows:

1. Click on the Edit User Database button;
2. SysCAD will save any changes to the configuration file and open the Species Database editor;
3. The Species Database opened will be in the same Cfgfiles folder as the configuration file you are currently editing;
4. The user can modify the species database to add or remove species, or change existing species;
5. The user may add a species to the configuration file by ticking the box next to the new species. (It is always a good idea to check the position of the new species in the display order when you return to the configuration file editor.)
6. If the user deletes a species from this database that is required by a unit model in the project, a warning will be displayed.
7. When the user has finished modifying the database, it will save and close the database and return to step two of the edit configuration dialog.

Customising the Species Display Window

Changing the Order of Species and Calculations

There are six default and one custom view for displaying solids, liquids, gases and phase totals. You may select one of these defaults from the drop down list, under Species Display Order.

The first 3 views are as follows:

1. Sol-Liq-Gas SysCAD will display the species in the following order: Solids, Liquids and then Gases.
2. Gas-Liq-Sol SysCAD will display the species in the following order: Gases, Liquids and then Solids.
3. Liq-Sol-Gas SysCAD will display the species in the following order: Liquids, Solids and then Gases.

These three orders will obey the following rules when sorting the species:

• The species will be displayed in alphabetical order within an Individual Phase. The only exceptions to this rule are: H2O(l) will always be the FIRST species displayed in the Liquid section; and H2O(g) will always be the FIRST species displayed in the Gas section.
• Species will be sorted by Phase (Solid, Liquid, Gas) and then within each phase by the Individual Phase in alphabetical order. The only exception to this rule is for Aqueous species (aq or a) where SysCAD will group these species together with liquid (l) species. For example: if the user has defined some solid and gaseous species, some liquid and aqueous species (l and aq), some liquid organic species (o), some liquid molten species (ml) and then selects SLG as the order, they will see:

1. All Solid species, in alphabetical order;
2. Liquid and Aqueous species, in alphabetical order with H2O(l) at the top of the list;
3. Liquid molten species, in alphabetical order;
4. Liquid organic species, in alphabetical order; and finally
5. All gaseous species, in alphabetical order with H2O(g) at the top of the list.

The next3 views are as follows:

• Sol-Liq-Gas Custom SysCAD will display the species in the following order: Solids, Liquids and then Gases.
• Gas-Liq-Sol Custom SysCAD will display the species in the following order: Gases, Liquids and then Solids.
• Liq-Sol-Gas Custom SysCAD will display the species in the following order: Liquids, Solids and then Gases.

These three orders will obey the following rules when sorting the species:

• The species may be displayed in ANY order within an Individual Phase. The only exceptions to this rule are: H2O(l) will always be the FIRST species displayed in the Liquid section; and H2O(g) will always be the FIRST species displayed in the Gas section.
• Species will be sorted by Phase (Solid, Liquid, Gas) and NOT by Individual Phase.

The last view is Custom. If the user selects this option, then the species can be displayed in any order - phases may be intermixed, labels added, etc.

NOTES:

1. Selecting any of first six options will remove the user's own "Custom" display set up (last option), and apply the phase rules.
2. If "Custom" order is used (last option), any new species added have to be manually moved into the correct phase.
   • In the Custom view, the user can move the user-defined species calculations to wherever they would like it to appear within the list.
   • In the Custom view, user can also add a new page, and move all the user species calculation to display on this new separate page.

Adding a Custom Label

If one of the Custom orders has been selected, the user may add a Label to separate the groups.

1. Select the species or calculation which you would like to be the first after the label by positioning the mouse over it.
2. Click on the button.
3. SysCAD will insert a separator, indicated by the symbol Ab followed by ........
4. The user may type in a Label name by double clicking on the text. If no Label is added, the default separator (---------) will be used.

Adding a New Page

If the Custom order has been selected, the user may add a page separator. This may be desired if there are a large number of species and calculations in the display list.

1. Position the mouse on the species, calculation or label that you would like to the the first on the new page.
2. Click on the button
3. SysCAD will insert a page break, indicated by a small page symbol followed by ...
4. The user may type in a custom page label by clicking on the ... and typing in your required text. If no Page name is added, the new page will be indicated by ... in the Access Window.

Adding or Removing a Species

To add a species to the configuration:

1. Select the required species from the list of species in either of the left hand windows, Hardwired Species or Species in User Database lists. The Filter option can be used so that only liquids, solids or gases are displayed.
2. If any of the Custom display orders have been chosen, select the insertion point in the right hand window, the Display List. The new species (KCl(aq) in above example) will be displayed above the species that is clicked in the Display List, (MgSO4(aq) in the above example). This step is not required if one of the three default orders has been chosen because the species will be added to the list in accordance with the defined rules of the chosen order.
3. Press the button.

A species may be removed from the Display List by clicking on the species and then clicking on the button.

Note: The user may select one or multiple species at any one time.

Special Cases

1. Water and Steam are required in every SysCAD project and they will automatically appear in the display list. You cannot remove either of these species.
2. Sulfuric acid (H2SO4) is automatically included in all species databases. However, you may add or remove it from the configuration display list. SysCAD does expect both H2SO4(l) and H2SO4(aq) to be included in the configuration list and hence if one of these species is selected (either for addition or removal from the display) the other species will automatically be moved. Please see Sulfuric Acid for more information.

Related Topics

• Species Table;
• Editing User Species Database; and
• Sulfuric Acid.

See Calculation Configuration for editing the calculations tab page.

See Size Configuration for editing the size distribution tab pages.