Reaction Editor
Navigation: User Guide ➔ Editors and Utilities ➔ Reaction Editor
Reaction Format | RB Data Section | RB Sub Model (Model Theory) | ||||||
---|---|---|---|---|---|---|---|---|
Reaction Editor | Text File Format | Reaction Block (RB) Summary | Individual Reactions | Reaction Extents | Source / Sink / Heat Exchange | Solving Order - Sequential or Simultaneous | Energy Balance | Heat of Reaction / Heat of Dilution / Partial Pressures |
Introduction
With all the features it provides, the SysCAD Reaction Editor makes it easier to create and edit reaction files. Therefore, we highly recommend our SysCAD users install it.
It is available with the latest install version of SysCAD, or from the Download section of our website (https://www.syscad.net/login/).
Video Links
These short video clips are available in the Tutorial Section of the Help documentation, or directly in YouTube.
- Add a Reaction using the SysCAD Reaction Editor - shows you how to add Reactions using the Reaction Editor.
- Adding a Source to the Reaction Editor - demonstrates how you can add a Source to the Reaction Editor.
- Adding a Sink to the Reaction Editor - demonstrates how you can add a Sink to the Reaction Editor.
- Adding Heat Exchange to the Reaction Editor - shows you how you can add Heat Exchange to the Reaction Editor. It briefly describes the different methods that are available.
- Using a Species Group in the Reaction Editor - shows how to set up and use a Species Group in the Reaction Editor.
Set up the Reaction Editor
Installing the SysCAD Reaction Editor
- When SysCAD is installed there is an option to install the Reaction Editor. If this option was selected then there is nothing more to do.
- If Reaction Editor wasn't installed as part of the SysCAD install then the user needs to obtain a copy of the Reaction Editor installation file. They can obtain this:
- From the folder \SysCADXXX\Setup\ReactionEditor
- By downloading it from the SysCAD Downloads Page (https://www.syscad.net/login/). Once you have downloaded the zip file, you can unzip the installer for the Reaction Editor.
- Run the Reaction Editor installer file (.msi) and follow the steps outlined in the dialog boxes. If the default settings are used, the Reaction Editor will be installed in the folder C:\Program Files\SysCAD.
- The Reaction Editor uses the .net framework (version 4.5).
- If you do not have this installed on your computer you will be prompted to download it from Microsoft. You can search for this or use this link https://www.microsoft.com/en-au/download/details.aspx?id=30653
How to Set the SysCAD Reaction Editor as the Default editor
![]() |
In SysCAD, select menu command Tools - General Options- General Tab page, under Editors (bottom option)
Once this is done, the next time you press the Edit_RCT in SysCAD (See Opening Existing Reaction Files), the SysCAD Reaction Editor will start up. Note: You may still open the reaction files with a text editor, such as Notepad, Notepad++, etc, outside of SysCAD, if required. You do not need to run SysCAD to use the Reaction Editor, so you can view and/or edit reaction files without loading a project. |
Reaction Editor Options
![]() |
On the main Reaction Editor Edit menu, there is an Options field.
This field has two options which can be enabled or disabled:
|
Reaction Files
Location of Reaction Files
Creating a New Reaction File
A reaction file can be automatically created when you press the "Edit Rct File" button.
- The RCT_Name can be left empty, in this case, the reaction file name created will be "UnitName".rct, so for the example used in the picture above, it will be Ni_Diss_2.rct.
- The RCT_Name can also be typed in prior to pressing the Edit_Rct_File" button. If the file does not exist, it will create one for you.
- The first time a reaction file is created in a project, the Reaction Editor will start with a blank reaction.
- Please see Adding a New Reaction for information on how to add the reactants and products.
Opening Existing Reaction Files
Once SysCAD has been set to use Reaction Editor (see How to Set SysCAD to use the SysCAD Reaction Editor), reaction files can be opened from SysCAD by pressing the 'Edit RCT' button.
The SysCAD Reaction Editor will start up and shows all reaction files in the current project with the selected one being in the current window. See example below:
Number | Description |
---|---|
![]() |
The existing reactions are displayed in the reaction Window. |
![]() |
The reaction editing panel will show details of the selected reaction, such as reactants, products, reaction extent, heat of reaction override and so on. Use this to edit the reaction. |
![]() |
The species used in the currently selected reaction are in bold and in blue in the species list in the right hand side window. The species used in other reactions in the current reaction file are in bold and in black in the species list in the right hand side window. |
![]() |
The filter can be used to shorten the display of the species list. For example, type in (aq) will show only the aqueous species, or type in Ni will display species containing Ni only. |
![]() |
The Title bar shows the current reaction file name. |
![]() |
All the reaction file in the current project are listed here. |
![]() |
This shows the species database location. See note in Location of Reaction Files |
![]() |
The log window will display any messages/warnings/errors found by the Reaction Editor. To clear the log go to View-Clear Log. |
Saving and Closing Reaction Files
Editing the Reactions
Adding a New Reaction
For example, let's add the following reaction, note it is in an unbalanced state:
- [math]\ce{ FeSO4(aq) + O2(g) + H2SO4(aq) \; = \; Fe2[SO4]3(aq) + H2O(l) }[/math]
The image below shows a new reaction being added:
Number | Description |
---|---|
This table continues from the previous table in Opening Existing Reaction Files, refers to the numbers listed in that table. | |
![]() |
Reactant box - drag the species from the species list ![]() |
![]() |
Product box - drag the species from the species list ![]() |
![]() |
![]() ![]() |
![]() |
Reaction Extents - Specify the reaction extent type, values, and the extent species. Please see Reaction Extents for more detail. |
![]() |
Heat of Reaction - SysCAD normally uses the Heats of Formation of the products and reactants to calculate the Heat of Reaction. However, if a Heat of Formation value is missing in the species database for any compounds involved in the reaction, then user will need to tick the Override tick box and specify a user defined Heat of Reaction. |
![]() |
Once a reaction has been entered, its status will be shown just above the log window on the status line. |
Notes:
- Users should FIRST drag species into the Reactant and Product boxes and THEN adjust the number of moles of each species reacting, or use the automatic balance functionality.
- The finished reaction may look like this
or the one shown in Opening Existing Reaction Files, depends on the stoichiometric coefficient of the first species in the reaction when thebutton is pressed. See Balancing the Reaction for more information.
Balancing the Reaction
Normally two things will happen when the button is pressed, user will either be shown the balanced reaction or be asked to specify extra species. We will explain these using two examples:
Example 1 Sufficient Species
For example, in the above topic, we have added the Ferrous to Ferric reaction,
- [math]\ce{ FeSO4(aq) + O2(g) + H2SO4(aq) \; = \; Fe2[SO4]3(aq) + H2O(l) }[/math]
- To balance the reaction, either
- When the
button is pressed, the Reaction Editor will attempt to balance the active reaction with the specified Reactants and Products.
- The Autobalancer will display both the original and the balanced reaction: and the user may
- The user may then either:
- accept the changes by pressing 'OK', or
- reject the changes by pressing 'Cancel'
- Note that the Auto balance will balance the equation to meet the number of moles specified for the first reactant. As shown in the above picture. If user prefers whole numbers, then cancel the balance, adjust the number of moles for the first species, or move the species with the lower number of moles to be the first species.
Example 2 Insufficient Species
For example,
- If a user simply enters Ferrous and Ferric as reactant and product, and nothing else, then pressed the
button,
- As we are missing Sulfuric acid, water and oxygen, we will have the "Autobalancer Additional Species" dialog box opened:
- When this happens, user can either:
- In the dialog box above there are no previous species Sets specified that is useful for this reaction, and hence we will define a new Species Set
- Type in a name in the Species Group box
- Type in the name of the required additional species, including phase
- You CANNOT drag species into this dialog box, but can select from a drop list after the first letter is entered as shown below:
- After all the additional species are entered, you can press OK and the reaction can now be balanced:
NOTES:
- When a species set is saved, users can use it again to define other reactions.
- The species sets can be managed via the reactions editor - Edit menu.
- If a species set is no longer required, press the Delete button to remove it.
- For a new group, simply change the name in the species group and modify the species in the group as we have done in Example 2 above.
- This functionality is especially useful when the user has a number of reactions that involve the same reagent and by-product.
- Please see Video Link for a video showing you how to set up and use a Species Group in the Reaction Editor.
Add Other
Adding a New Source
Number | Description |
---|---|
This table continues from the previous tables in Opening Existing Reaction Files and Adding a New Reaction, refers to the numbers listed in previous tables. | |
![]() |
Press the Add Other Button, select the Source radio button. |
![]() |
|
![]() |
Select what the source should be treated as: Source only, Recycle only or Source and recycle. Please see Reaction Source for more information. |
Adding a New Sink
This is similar to Adding a New Source. The differences are listed here:
- Click on Add Other and select Sink.
- Any species being used a sink will have a
icon displayed next to it.
- You may only add a Sink once to a reaction file, but you can add multiple species to a single Sink.
- The Sink will always be the last reaction.
- Please see Reaction Sink for more information.
Adding Heat Exchange
- To add Heat Exchange, click on Add Other and select Heat Exchange.
- In the Heat Exchange box, select the appropriate option from the drop down list and then specify the value of associated variables depending on options chosen.
- These options are explained in Reaction Heat Exchange.
Remove a Reaction, Source, Sink or Heat Exchange
- To remove a reaction, source, sink or heat exchange, simply select it in the reaction window and click Remove.
- If you only wish to disable the reaction, source, sink or heat exchange, clear the Enabled box at the bottom of the reaction window.
Specifying the Reaction Order
By default, SysCAD reactions are added sequentially. Alternatively, user can choose to specify two or more simultaneous reactions. Simultaneous reactions requires the Sequences Enabled option to be on.
- The reaction order is as they appear in the reaction file. To change the order of the reactions in the reaction file, select the desired reaction in the reaction window and click the up and down arrow buttons to move to the desired place in the reaction file.
Notes:
- If included, sources will always be first, sinks will always be last or second last and heat exchange will always be last (as shown above). These cannot be re-ordered.
- The reaction file in the picture shown above started with an existing reaction file, then new reactions, sink and HX options were added for demonstration purposes.
- Any reaction with "*" marked means it is new or has been modified, and the new information has not been saved yet
- If the reaction has been saved previously, and the order is now changed, then a number in (x) will shows the reaction order change. In the example above, the reaction 5 was saved as reaction 2 before the move.
- When the reaction file is saved, these markers will disappear.
Other Features
Clone a Reaction
The user may wish to clone a reaction when a very similar reaction is required. Select the required reaction in the reaction window and click Clone. A new reaction will be created at the bottom of the list which can be edited as for other reactions.
NOTE: when editing a cloned reaction, be sure to check and edit the extent species as this may have changed, especially if the "old" compound has been deleted.
Copying Reactions from other opened files in the Reaction Editor
Reactions can be easily copied from one reaction file to another using the Reaction Editor.
If the reaction files are in the same project, and they are both opened in the reaction editor, then
- With the Files pane open, drag the reaction to be copied with the left mouse, hold down and drop it into the other reaction file.
Copying Reactions from another instance of Reactions Editor
To copy a reaction from a reaction file in a different project, open the reaction files in a different instances of the Reaction Editor.
Select the reaction to be copied, <ctrl+C> or right mouse click and select copy.
Go to the other instance of Reaction Editor, right click on the reaction window of the desired reaction file and select paste.
NOTE:
- Existing Reaction Files can be opened from the SysCAD Reaction Editor without starting the SysCAD project.
- Start up the Reaction Editor from the start menu. Menu command <File> - <Open> and select the reaction file to open.
- Alternatively, with one instance of the reaction editor opened, Menu command <File> - <Open Folder> and select the reactions folder for a particular project. The files will be opened in another instance of the Reaction Editor.
Reversing a Reaction
A reaction may be reversed (swap Reactants and Products) by right-clicking the reaction and selecting Reverse Reaction. You may need to then update the extent settings depending on the extent type.
Options Tab
For every reaction file there is a Options tab. Click on the tab to access the Options tab. An example is shown below.
This tab allows the user to enable the following:
Sequences Enabled
- This causes the reactions to be solved simultaneously, if required. This is NOT the recommended solution method - please see Reaction Block - Solving Reactions for more information.
- With the Sequences Enabled option ticked, each reaction will automatically be assigned a Sequence number of 1 - which means that all of the reactions are placed in sequence 1 and solved simultaneously.
- The user may change the sequence number of a reaction on the Reactions tab
and hence create groups of reactions. Each group of reactions is solved simultaneously. In the example shown below, we have moved one of the reaction to a second sequence for demonstration purposes.
Always Use First Reactant for Extent
- This allows the user to specify that the first reactant is always to be used for the extent for the reactions in this reaction file.
- Normally when a reaction is inserted the default extent species used is the first reactant, but the user may change this. If this option is enabled, then the user cannot change the extent species.
Description
- Add any comments to the description box for this reaction file.
- Any comments which were previously in a reaction file created without the Reaction Editor will be automatically moved to the description box. The date that the file was first saved using the Reaction Editor will automatically be noted in the description box as shown in the example above.
Troubleshooting
- If you are getting this error message during the reaction editor start up: "An item with the same key has already been added", it may be caused by issues with the species database definition. Please check the message window - species database tab for any errors.
- Please see general notes for more information.