SysCAD Documentation - User contributions [en]

Build 139 Revision History

2026-05-12T06:57:47Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37077===
:''Released 16 April 2026
* Bug fixes:
** Fix for bug where Change Tag for a tag containing an asterisk (*) failed to update correctly in referenced files (e.g. PGM) and, in some cases, caused a crash.
** Fix error in [[Calculation Configuration|Custom Calculation]] that was truncated at load time when calculation definition string exceeded 1000 characters.
** Fix for [[Downtime]] controller to use the correct parameters for Downtime (bug occurred when Uptime and Downtime used PDFs with different input types).
**:'''WARNING:''' This fix may cause different results. The previous mapping was Average ➔ Scale, and Deviation (seconds) ➔ Shape (unitless).
** Fix for [[Solids Recovery Unit]] calculating incorrect results and warnings when using RecoveryMethod = 'Grade & Recovery' or 'Mass Pull & Recovery' together with Method = 'Element'.
** Fix for crash in Tie or Tank [[Tie#Split_(Flow)_Tab_Page|Split Flows]] when using split by IPhase when project has no solid species.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.2.0 version 2.2.0], which includes additional Gravity Concentrator models.
* Model-Specific Updates:
** Improvements and fixes for [[GFEM]] when using ionic species.
** Various [[Solids Recovery Unit]] tag and display improvements. Fix for ShowQMiddlings checkbox not working.
* General Improvements:
** New error messages when trying to set multiple composition tags (e.g. [[Feeder-Cross_Page_Connector#DSp_Tab_Page|Feeder species DSp]] fractions) with conflicting View or Basis. All tag values should use the same reference (from first tag set) for tag validation to work correctly for bulk tag sets.
** Block selection of DirectLink and Tear for graphics [[Edit_Graphics_Commands#Change_Unit|Change Unit]] command.
** Improvements in workflow and error messaging when issues occur with Graphics commands for Links: Insert, Construct, Reroute, Connect and Disconnect.
** Add automatic Access window tab page breaks for large [[Class_-_Using_a_Class#ClassGrid|PGM Class Grids]] for large quantity of class instances.
** Add tags for display of IPhase counts to [[SDB_-_FS_SDB|$SDB Information]] tab page.
** Corrections for [[SDB_-_Thermo2#Gibbs_Energy_of_Formation_(DeltaGf)|Gibbs Energy of Formation (DeltaGf)]] calculation (visible on [[SDB_-_Thermo2|Thermo2 tab page of $SDB]]):
*** Implement calculation of DeltaGf for ionic species.
*** Correct calculation for species to use Standard Species G at standard conditions (i.e. standard T and P).
*** Return Undefined (*) for pseudo species.
* [[TCE]] Improvements:
** Updated ChemApp DLLs to latest versions.
** Fix incorrectly saved absolute filepath for TCE database folder in Edit CFG and browse for TCE database folder.
** Fix error when newly inserted TCE ModelCfg loads incorrect database information when project is using multiple DBS files.
** Fix for edge case issue in water checks with both liquid and aqueous species.
* New Example Projects*:
**[[Example - 05 PHREEQC Evaporation Projects#LiOH Evaporation Examples|PHREEQC - LiOH Evaporation Example]]
**[[Example - 05 PHREEQC Evaporation Projects#NaCl Evaporation Examples|PHREEQC - NaCl Evaporation Example]]
**[[Example_-_06_OLI_Projects#Autoclave_for_Downhole_Condition_Testing|OLI - Autoclave for Downhole Condition Testing]] - This project requires OLI Engine Runtime 12.5 or later.
* Tutorial Documents Updates*:
** The SysCAD Introductory Tutorial has been updated with general enhancements and a small amount of new content.
* BaseFiles Updates*:
** Minor updates to the default Quick View variable list for MetDynamic models.
** New graphics symbols for furnaces, reformers, electrolysis, electrodialysis, and more (see BaseFiles\SysCADSymbolsList.pdf for the complete list).
'''* REMINDER:''' Example Projects, Documents and BaseFiles are included in the full SysCAD installation, and are also available for download from https://www.syscad.net/download-software (under "SysCAD BaseFiles and Example Projects").

===Build 37069===
:''Released 18 December 2025
* Bug fixes:
** Fix edge case in [[Reverse Osmosis (RO) Unit]] when changing model to Simple and previous EffMethod was ImpurityFrac (it incorrectly used a setting from previous EffMethod).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.1.0 version 2.1.0], which includes the addition of a dynamic AG/SAG mill model.
* [[Excel Reports]]:
** New Excel reporting [[Excel_Get_Tag_Reports#Report_Keyword_Syntax|keyword option]] (for TagList, TagTable, etc.) "Inactive:value" to display values for inactive result tags.
** Improved feedback messages when Excel reports don't have report names.
** Excel ReportName is now optional for [[Excel_Set_Tag_Reports#SysCAD_Set_Tag_Report_in_a_Single_Row_or_Column|SetTagList]].
* General Improvements:
** Fix for [[Access_Window#Right_click_on_the_Access_Window_tab_page_names|Right Click on tab name in Access Window]] not always bring up the correct context menu including options to copy the tag for the tab page.
** Improved error messaging for managing connected tags for a [[Feeder]].
** After a [[Copy and Paste Graphics Commands|graphics Cut & Paste]], the unit counts for each graphics flowshhet shown in [[Explorer Window]] are now correct.
* [[TCE]] Improvements:
** Fix for Plotter when changing between mole and mass based Species adjustment, now retains the value when changing.
** Fix for TCE unit model references to the ChemModelCfg used when an unused TCEModelCfg unit is deleted.
* Example Projects:
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics - Dynamic Grinding Example]] with a new flowsheet page for a circuit including the new SAG mill.

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|BaseFiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated BaseFiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Build 139 Revision History

2026-05-10T08:58:09Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37077===
:''Released 16 April 2026
* Bug fixes:
** Fix for bug where Change Tag for a tag containing an asterisk (*) failed to update correctly in referenced files (e.g. PGM) and, in some cases, caused a crash.
** Fix error in [[Calculation Configuration|Custom Calculation]] that was truncated at load time when calculation definition string exceeded 1000 characters.
** Fix for [[Downtime]] controller to use the correct parameters for Downtime (bug occurred when Uptime and Downtime used PDFs with different input types).
**:'''WARNING:''' This fix may cause different results. The previous mapping was Average ➔ Scale, and Deviation (seconds) ➔ Shape (unitless).
** Fix for [[Solids Recovery Unit]] calculating incorrect results and warnings when using RecoveryMethod = 'Grade & Recovery' or 'Mass Pull & Recovery' together with Method = 'Element'.
** Fix for crash in Tie or Tank [[Tie#Split_(Flow)_Tab_Page|Split Flows]] when using split by IPhase when project has no solid species.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.2.0 version 2.2.0], which includes additional Gravity Concentrator models.
* Model-Specific Updates:
** Improvements and fixes for [[GFEM]] when using ionic species.
** Various [[Solids Recovery Unit]] tag and display improvements. Fix for ShowQMiddlings checkbox not working.
* General Improvements:
** New error messages when trying to set multiple composition tags (e.g. [[Feeder-Cross_Page_Connector#DSp_Tab_Page|Feeder species DSp]] fractions) with conflicting View or Basis. All tag values should use the same reference (from first tag set) for tag validation to work correctly for bulk tag sets.
** Block selection of DirectLink and Tear for graphics [[Edit_Graphics_Commands#Change_Unit|Change Unit]] command.
** Improvements in workflow and error messaging when issues occur with Graphics commands for Links: Insert, Construct, Reroute, Connect and Disconnect.
** Add automatic Access window tab page breaks for large [[Class_-_Using_a_Class#ClassGrid|PGM Class Grids]] for large quantity of class instances.
** Add tags for display of IPhase counts to [[SDB_-_FS_SDB|$SDB Information]] tab page.
** Corrections for [[SDB_-_Thermo2#Gibbs_Energy_of_Formation_(DeltaGf)|Gibbs Energy of Formation (DeltaGf)]] calculation (visible on [[SDB_-_Thermo2|Thermo2 tab page of $SDB]]):
*** Implement calculation of DeltaGf for ionic species.
*** Correct calculation for species to use Standard Species G at standard conditions (i.e. standard T and P).
*** Return Undefined (*) for pseudo species.
* [[TCE]] Improvements:
** Updated ChemApp DLLs to latest versions.
** Fix incorrectly saved absolute filepath for TCE database folder in Edit CFG and browse for TCE database folder.
** Fix error when newly inserted TCE ModelCfg loads incorrect database information when project is using multiple DBS files.
** Fix for edge case issue in water checks with both liquid and aqueous species.
* New Example Projects*:
**[[Example - 05 PHREEQC Evaporation Projects#LiOH Evaporation Examples|PHREEQC - LiOH Evaporation Example]]
**[[Example - 05 PHREEQC Evaporation Projects#NaCl Evaporation Examples|PHREEQC - NaCl Evaporation Example]]
**[[Example_-_06_OLI_Projects#Autoclave_for_Downhole_Condition_Testing|OLI - Autoclave for Downhole Condition Testing]] - This project requires OLI Engine Runtime 12.5 or later.
* Tutorial Documents Updates*:
** The SysCAD Introductory Tutorial has been updated with general enhancements and a small amount of new content.
* BaseFiles Updates*:
** Minor updates to the default Quick View variable list for MetDynamic models.
** New graphics symbols for furnaces, reformers, electrolysis, electrodialysis, and more (see BaseFiles\SysCADSymbolsList.pdf for the complete list).
'''* REMINDER:''' Example Projects, Documents and BaseFiles are included in the full SysCAD installation, and are also available for download from https://www.syscad.net/download-software (under "SysCAD BaseFiles and Example Projects").

===Build 37069===
:''Released 18 December 2025
* Bug fixes:
** Fix edge case in [[Reverse Osmosis (RO) Unit]] when changing model to Simple and previous EffMethod was ImpurityFrac (it incorrectly used a setting from previous EffMethod).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.1.0 version 2.1.0], which includes the addition of a dynamic AG/SAG mill model.
* [[Excel Reports]]:
** New Excel reporting [[Excel_Get_Tag_Reports#Report_Keyword_Syntax|keyword option]] (for TagList, TagTable, etc.) "Inactive:value" to display values for inactive result tags.
** Improved feedback messages when Excel reports don't have report names.
** Excel ReportName is now optional for [[Excel_Set_Tag_Reports#SysCAD_Set_Tag_Report_in_a_Single_Row_or_Column|SetTagList]].
* General Improvements:
** Fix for [[Access_Window#Right_click_on_the_Access_Window_tab_page_names|Right Click on tab name in Access Window]] not always bring up the correct context menu including options to copy the tag for the tab page.
** Improved error messaging for managing connected tags for a [[Feeder]].
** After a [[Copy and Paste Graphics Commands|graphics Cut & Paste]], the unit counts for each graphics flowshhet shown in [[Explorer Window]] are now correct.
* [[TCE]] Improvements:
** Fix for Plotter when changing between mole and mass based Species adjustment, now retains the value when changing.
** Fix for TCE unit model references to the ChemModelCfg used when an unused TCEModelCfg unit is deleted.
* Example Projects:
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics - Dynamic Grinding Example]] with a new flowsheet page for a circuit including the new SAG mill.

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|BaseFiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated BaseFiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Template:Material Content Header Tabs

2026-05-10T06:42:26Z

Keith.Armstrong:

{| border="1" cellpadding="5" cellspacing="0"
|-
!font style="background: #f8f9fa"|Material (Content)
!Colspan=6 font style="background: #f8f9fa"|Content Tab Include Properties
!font style="background: #f8f9fa"|Species (Sp)
!Colspan=4 font style="background: #f8f9fa"|Optional Tabs
{{Header table template 12Terms | currentpage = {{{currentpage}}}
| Name1= [[Material Content Section| Basic Information]]
| Name2= [[Material Content Section - Energy | Energy ValuesAtUserTandP]]
| Name3= [[Material Content Section - Density Correction, Solubility and Saturation| Density Correction Solubility Saturation]]
| Name4= [[Material Content Section - pH, Charge and Transport Properties| Acidity Charge Transport]]
| Name5= [[Material Content Section - HOC | HeatsOfCombustion]]
| Name6= [[Material Content Section - Solution Impurity and H2O Properties| Solution Impurity H2O Properties]]
| Name7= [[Material Content Section - Water Quality| Water Quality ]]
| Name8= [[Species Content Section |Sp Tab EC Tab]]
| Name9= [[Material Content Section - Lockup|DLockup LockUp]]
| Name10=[[Material Content Section - Track|DTrack Track]]
| Name11=[[Material Content Section - Size|DSz Sz MSz]]
| Name12=[[Material Content Section - SSA|DSSA SSA]]
}}
|}

Material Content Section - HOC

2026-05-10T06:38:43Z

Keith.Armstrong:

[[Category:Properties]] [[Category:Energy]]
{{Navigation|[[Models]]|[[Models#Common Sections|Common Sections]]|[[Material Content Section]]|altname=Heats of Combustion}}
{{Material Content Header Tabs | currentpage=5}}

'''Related Links:''' [[Common Content Section]]
----

This section is used to display the included properties for: Heats of Combustion

== Heats of Combustion==

{|border="1" cellpadding="5" cellspacing="0"
|-
|width=150|'''Tag (Long/Short)'''||width=80|'''Input / Calc'''||'''Description/Calculated Variables / Options'''
|-
|font style="background: #ebebeb" colspan="3" |
===Heat of Combustion===
{{Heats of Combustion Data Section |type=Content |UnitOp=content}}
|}

Template:Heats of Combustion Data Section

2026-05-10T06:32:04Z

Keith.Armstrong:

{{#if: {{{Feeder|}}}|
|}}These will only be shown if the user has chosen to display the ''HeatsOfCombustion'' Properties on the [[Plant Model - Views|Plant Model - Views tab page]] {{#if: {{{Feeder|}}}|
|or from the [[Material_{{{type}}}_Section#Qo_.28Qxxxx.29_Tab_Page|''Include Properties'']] dropdown list on the first page of the material {{{type}}} section}}.

The Heat of Combustion is the heat released (i.e. enthalpy change) if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and water. The higher heating value (HHV) (or Gross Calorific Value) is calculated by assuming that the water produced is '''liquid''' water. The lower heating value (LHV) (or Net Calorific Value) is calculated by assuming that the water is produced as steam.

'''NOTE:'''
#The Heat of Combustion is only calculated for components which contain only carbon (e.g. carbon solid), only hydrogen (e.g. hydrogen gas) or only carbon and hydrogen (i.e. a hydrocarbon, e.g. methane (CH4)).
#Components which contain only carbon and oxygen (e.g. carbon monoxide) and only carbon, hydrogen and oxygen (e.g. ethanol) are also included.
#If oxygen gas and/or carbon dioxide gas are not included in the project then the following numbers will be assumed when calculating the heat values (all values are at 298K).
::{|
|Width=250|'''Species''' ||Width=350|'''Heat of Formation (Hf) (kJ/mol)''' ||Width=350|'''Heat Capacity (Cp) (J/K.mol)'''
|-
|Oxygen (O2(g))|| 0 || 29.379
|-
|Carbon Dioxide (CO2(g))|| -393.8 || 37.171
|}
::Reference:The Properties of Gases and Liquids, 4th Edition (Reid, Prausnitz and Poling)
|-
|font style="background: #ebebeb" colspan="3" | ''HoC (Heats of Combustion)''
|-
|HHV.M150 || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at 150°C and 1 atmosphere pressure on a mass basis.
|-
|HHV.M25 || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at 25°C and 1 atmosphere pressure on a mass basis.
|-
|HHV.Ml25|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|HHV.V25 || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at 25°C and {{{UnitOp}}} pressure.
|-
|HHV.M || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at the {{{UnitOp}}} temperature and pressure on a mass basis.
|-
|HHV.Ml|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|HHV.V || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at the {{{UnitOp}}} temperature and pressure.
|-
|LHV.M150 || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at 150°C and 1 atmosphere pressure on a mass basis.
|-
|LHV.M25 || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at 25°C and 1 atmosphere pressure on a mass basis.
|-
|LHV.Ml25|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|LHV.V25 || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at 25°C and {{{UnitOp}}} pressure.
|-
|LHV.M || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at the {{{UnitOp}}} temperature and pressure on a mass basis.
|-
|LHV.Ml|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|LHV.V || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at the {{{UnitOp}}} temperature and pressure.

Template:Heats of Combustion Data Section

2026-05-10T06:30:32Z

Keith.Armstrong:

{{#if: {{{Feeder|}}}|
|}} These will only be shown if the user has chosen to display the ''HeatsOfCombustion'' Properties on the [[Plant Model - Views|Plant Model - Views tab page]] {{#if: {{{Feeder|}}}|
|or from the [[Material_{{{type}}}_Section#Qo_.28Qxxxx.29_Tab_Page|''Include Properties'']] dropdown list on the first page of the material {{{type}}} section}}.

The Heat of Combustion is the heat released (i.e. enthalpy change) if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and water. The higher heating value (HHV) (or Gross Calorific Value) is calculated by assuming that the water produced is '''liquid''' water. The lower heating value (LHV) (or Net Calorific Value) is calculated by assuming that the water is produced as steam.

'''NOTE:'''
#The Heat of Combustion is only calculated for components which contain only carbon (e.g. carbon solid), only hydrogen (e.g. hydrogen gas) or only carbon and hydrogen (i.e. a hydrocarbon, e.g. methane (CH4)).
#Components which contain only carbon and oxygen (e.g. carbon monoxide) and only carbon, hydrogen and oxygen (e.g. ethanol) are also included.
#If oxygen gas and/or carbon dioxide gas are not included in the project then the following numbers will be assumed when calculating the heat values (all values are at 298K).
::{|
|Width=250|'''Species''' ||Width=350|'''Heat of Formation (Hf) (kJ/mol)''' ||Width=350|'''Heat Capacity (Cp) (J/K.mol)'''
|-
|Oxygen (O2(g))|| 0 || 29.379
|-
|Carbon Dioxide (CO2(g))|| -393.8 || 37.171
|}
::Reference:The Properties of Gases and Liquids, 4th Edition (Reid, Prausnitz and Poling)
|-
|font style="background: #ebebeb" colspan="3" | ''HoC (Heats of Combustion)''
|-
|HHV.M150 || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at 150°C and 1 atmosphere pressure on a mass basis.
|-
|HHV.M25 || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at 25°C and 1 atmosphere pressure on a mass basis.
|-
|HHV.Ml25|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|HHV.V25 || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at 25°C and {{{UnitOp}}} pressure.
|-
|HHV.M || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at the {{{UnitOp}}} temperature and pressure on a mass basis.
|-
|HHV.Ml|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|HHV.V || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at the {{{UnitOp}}} temperature and pressure.
|-
|LHV.M150 || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at 150°C and 1 atmosphere pressure on a mass basis.
|-
|LHV.M25 || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at 25°C and 1 atmosphere pressure on a mass basis.
|-
|LHV.Ml25|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|LHV.V25 || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at 25°C and {{{UnitOp}}} pressure.
|-
|LHV.M || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at the {{{UnitOp}}} temperature and pressure on a mass basis.
|-
|LHV.Ml|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|LHV.V || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at the {{{UnitOp}}} temperature and pressure.

Template:Heats of Combustion Data Section

2026-05-10T06:27:17Z

Keith.Armstrong:

{{#if: {{{Feeder|}}}|
| These will only be shown if the user has chosen to display the ''HeatsOfCombustion'' Properties on the [[Plant Model - Views|Plant Model - Views tab page]] {{#if: {{{Feeder|}}}|
|or from the [[Material_{{{type}}}_Section#Qo_.28Qxxxx.29_Tab_Page|''Include Properties'']] dropdown list on the first page of the material {{{type}}} section}}.

The Heat of Combustion is the heat released (i.e. enthalpy change) if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and water. The higher heating value (HHV) (or Gross Calorific Value) is calculated by assuming that the water produced is '''liquid''' water. The lower heating value (LHV) (or Net Calorific Value) is calculated by assuming that the water is produced as steam.

'''NOTE:'''
#The Heat of Combustion is only calculated for components which contain only carbon (e.g. carbon solid), only hydrogen (e.g. hydrogen gas) or only carbon and hydrogen (i.e. a hydrocarbon, e.g. methane (CH4)).
#Components which contain only carbon and oxygen (e.g. carbon monoxide) and only carbon, hydrogen and oxygen (e.g. ethanol) are also included.
#If oxygen gas and/or carbon dioxide gas are not included in the project then the following numbers will be assumed when calculating the heat values (all values are at 298K).
::{|
|Width=250|'''Species''' ||Width=350|'''Heat of Formation (Hf) (kJ/mol)''' ||Width=350|'''Heat Capacity (Cp) (J/K.mol)'''
|-
|Oxygen (O2(g))|| 0 || 29.379
|-
|Carbon Dioxide (CO2(g))|| -393.8 || 37.171
|}
::Reference:The Properties of Gases and Liquids, 4th Edition (Reid, Prausnitz and Poling)
|-
|font style="background: #ebebeb" colspan="3" | ''HoC (Heats of Combustion)''
|-
|HHV.M150 || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at 150°C and 1 atmosphere pressure on a mass basis.
|-
|HHV.M25 || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at 25°C and 1 atmosphere pressure on a mass basis.
|-
|HHV.Ml25|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|HHV.V25 || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at 25°C and {{{UnitOp}}} pressure.
|-
|HHV.M || font style="background: #ebebeb" |Calc || Higher Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''liquid''' water at the {{{UnitOp}}} temperature and pressure on a mass basis.
|-
|HHV.Ml|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|HHV.V || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at the {{{UnitOp}}} temperature and pressure.
|-
|LHV.M150 || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at 150°C and 1 atmosphere pressure on a mass basis.
|-
|LHV.M25 || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at 25°C and 1 atmosphere pressure on a mass basis.
|-
|LHV.Ml25|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|LHV.V25 || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at 25°C and {{{UnitOp}}} pressure.
|-
|LHV.M || font style="background: #ebebeb" |Calc || Lower Heating Value - Heat released if the {{{UnitOp}}} components undergo complete combustion with oxygen to produce carbon dioxide gas and '''steam''' at the {{{UnitOp}}} temperature and pressure on a mass basis.
|-
|LHV.Ml|| font style="background: #ebebeb" |Calc || As above except on a molar basis.
|-
|LHV.V || font style="background: #ebebeb" |Calc || As above except on a volumetric basis. NB Gas mass per volume calculated at the {{{UnitOp}}} temperature and pressure.

Material Flow Section - HOC

2026-05-10T06:25:10Z

Keith.Armstrong: /* Heating Values */

[[Category:Properties]] [[Category:Energy]]
{{Navigation|[[Models]]|[[Models#Common Sections|Common Sections]]|[[Material Flow Section]]|altname=Heats of Combustion, Heating Values}}
{{Material Flow Header Tabs |currentpage=5}}

'''Related Links:''' [[Common Content Section]]
----

This section is used to display the included properties for: Heats of Combustion (Build 139 and later) and Heating Values (Build 138 and earlier)

== Heats of Combustion==

{|border="1" cellpadding="5" cellspacing="0"
|-
|width=150|'''Tag (Long/Short)'''||width=80|'''Input / Calc'''||'''Description/Calculated Variables / Options'''
|-
|font style="background: #ebebeb" colspan="3" |
===Heat of Combustion===
{{Heats of Combustion Data Section |type=Flow |UnitOp=stream }}
|}

Template:Feeder and Source Content Data Section

2026-05-10T06:22:45Z

Keith.Armstrong: /* Heats of Combustion Properties */

This section mainly has read only variables, except for the first section, Model.
* Model determines which species model the feeder uses. The options available to the user will depend on the species model used by the project. Please refer to the species model for a description of this page, if a species model is chosen. The default, 'Standard', will be described here.

{| border="1" cellpadding="5" cellspacing="0"
! Width=220|'''Tag (Long/short)''' || Width=110| '''Input / Calc''' || '''Calculated Variables / Options'''
|-
| colspan="3" font style="background: #ebebeb" |
==== Model ====
{{ Sp Model Data Section}}
|-
| colspan="3" font style="background: #ebebeb" |
==== Content Properties ====
|-
| Temperature / T || font style="background: #ebebeb" | Calc || The temperature of the incoming material.
|-
| Pressure / P || font style="background: #ebebeb" | Calc || The pressure of the incoming material.
{{ Density Data Section}}
{{ Density Correction Data Section | type=Flow | UnitOp={{{UnitOp}}} }}
{{ Mass and Volume Fraction Data Section | Content=Yes }}
|-
| colspan="3" font style="background: #ebebeb" |
==== Content Energy ====
{{Energy Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow}}
|-
| colspan="3" font style="background: #ebebeb" |
==== Values at User defined Temperature and Pressure ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{ValuesAtUserTandP Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow }}
|Please see included properties - [[Common_Content_Section#Values_at_User_defined_Temperature_and_Pressure|Values at User Defined T and P]].
}}
|-
| colspan="3" font style="background: #ebebeb" |
==== Solubility Values ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{Solubility Data Section | type=Flow | UnitOp={{{UnitOp}}} }}
|Please see included properties - [[Common_Content_Section#Solubility_Values|Solubility]].
}}
|-
| colspan="3" font style="background: #ebebeb" |
==== Saturation Values ====
{{Saturation Data Section | type=Flow | UnitOp={{{UnitOp}}} }}
|-
| colspan="3" font style="background: #ebebeb" |
==== Acidity (pH) ====
{{Acidity Data Section | type=Flow | UnitOp={{{UnitOp}}} }}
|-
| colspan="3" font style="background: #ebebeb" |
==== Charge ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{Charge Data Section | type=Flow | UnitOp={{{UnitOp}}} }}
|Please see included properties - [[Common_Content_Section#Charge|Charge]]
}}
|-
| colspan="3" font style="background: #ebebeb" |
==== Transport Properties ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{Transport Properties Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow }}
|Please see included properties - [[Common_Content_Section#Transport_Properties|Transport ]]
}}
|-
| colspan="3" font style="background: #ebebeb" |
==== Heats of Combustion Properties ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{Heats of Combustion Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow }}
|See included properties - [[Common_Content_Section#Heats_of_Combustion_Properties|Heats of Combustion]].
}}
|-
| colspan="3" font style="background: #ebebeb" |

==== Solution Impurities ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{Solution Impurities Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow }}
|Please see included properties - [[Common_Content_Section#Solution Impurities|Solution Impurities]].
}}
|-
| colspan="3" font style="background: #ebebeb" |
==== H2O Properties ====
{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{H2OProps Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow }}
|Please see included properties - [[Common_Content_Section#H2O_Properties|H2O Properties]]
}}
|}

=== WQ Tab Page ===

{{#ifeq: {{{ExpandIncludeTopics}}}| Yes |
{{Water Quality Data Section | UnitOp={{{UnitOp}}} | Content=Yes | type=Flow }}
|Please see included properties - [[Common_Content_Section#WQ_Tab_Page|Water Quality]].
}}

Model Selection

2026-05-10T06:18:05Z

Keith.Armstrong: /* Edit Configuration Step 1 of 2 */

[[Category: Project Configuration]]
{{Navigation|[[User Guide]]|[[Edit Command Summary]]|[[Project Configuration (cfg File)]]}}
{{Edit configuration Header Table |currentpage=1}}
----

= Edit Configuration Step 1 of 2 =

The first step is to select the SysCAD unit models to be used in the project. User may need to check the unit models from time to time due to:

# New Models may have been added through SysCAD version change, to use these new models, user must select them in this step of the Edit Configuration file.
# Some models are restricted by license agreement. If the project is to be shared with third parties, please ensure all parties involved have the correct license to access all unit models selected, otherwise user may need to de-select the "restricted" model and make modification to the project before sharing of the project with parties with less license options.

The image below shows 2 different views of the Model Selection access window, as explained in the table below:

::[[Image:Edit Configuration - Units139.png]]
{| border="1" cellpadding="5" cellspacing="0"
| Width=50| '''Number'''||Width=150|'''Setting/Selection'''||Width=1100|'''Description'''
|-
| [[Image:Button Small 1.png]] || Solver Mode || The user must choose either '''Steady-State (ProBal)''' or '''Dynamic''' (may depend on license options). This selection can also be made on the [[General Configuration|second configuration page]]. Refer to [[SysCAD_Structure#Solver_Modes|Solver Modes]] for more information.
|-
| [[Image:Button Small 2.png]] || Energy Balance || Select to either '''Allow Heat Calculations''' or not. This selection can also be made on the [[General Configuration|second configuration page]]. Refer to [[General_Configuration#Energy_Balance|Energy Balance]] for more information.
|-
| [[Image:Button Small 3.png]] || Sort By || View the available models by:
# '''DLL''' (Dynamic Link Library), as shown on the left in the image above; or
# '''Group''', as shown on the right in the image above.
'''NOTE:''' Not all models are available to all users. Please check your license agreement to see what models are available for use. Refer to [[Models]] for a list of the standard models available to users with standard licenses.
|-
|[[Image:Button Small 4.png]] || Model Libraries ||You may select (marked by the blue tick) or de-select models as required. Each dll (Dynamic Link Library) group shown in the above window contains a number of models, as indicated by the + box on the right hand side. By clicking on this + box, the user can expand the tree view and see the models available in each dll group. This is shown for the '''Control1.dll''' group.
# To select ALL of the models in a group click on the group and a blue tick will appear.
# To de-select an entire group, click on it and the blue tick will disappear.
# To select (or de-select) only some models in a group, click on the + box so that the view is expanded and you can see all of the models in the group. You may then select individual models.
# When only some models in a group are selected, this is indicated by the blue tick having a grey background.
|-
|[[Image:Button Small 5.png]] || Include All Unit Models || When enabled, all unit models for dlls which have at least one unit model selected will be automatically included. This will also apply to future new unit models for a dll automatically being available.
The image above shows the same configuration, firstly without the ''Include All Unit Models'' option selected and then in the inset, with the ''Include All Unit Models'' option selected. This shows that four unit models which belong to the Control1 dll and were not originally included, are included when the ''Include All Unit Models option'' is enabled.
|-
|[[Image:Button Small 6.png]] || Show Required Species ||Certain unit models require specific species to be present for the models to operate correctly. These include:
* The Bayer species models;
* The Potash models;
* Certain alumina models, such as the Precipitator; and
* Various client specific models.
Once you have selected the models for the project you may click on the ''Show Required Species'' button and you will see a list of all of the species that MUST be included in the project. If any of the listed species are NOT included in the project configuration, then SysCAD will give you a warning. After the '''Next>>>''' button [[Image:Button Small 7.png]] is pressed, any required species which have not been included in the project configuration will have a red triangle next to them in the list of species on the left hand side of the Species tab page. Refer to [[Species Configuration]].

'''Notes:'''
# If any of the listed species are '''NOT''' included in the project configuration, then the SysCAD will not allow you to open any projects using this configuration file.
# For most non-alumina and non-Potash projects the required species shown will be H2O(l) and H2O(g) only.
|-
|}

= Edit Configuration Step 2 of 2 =
Based on the models selected, a second dialog box with variable number of tab pages will appear for further customisation when the '''Next>>>''' button is pressed. Refer to [[General Configuration]].

Plant Model - Settings

2026-05-09T09:43:47Z

Keith.Armstrong: /* Introduction */

[[Category:Project Configuration]]
{{Navigation|[[User Guide]]|[[View Command Summary|View]]|[[Plant Model]]|altname=Settings}}
{{Plant Model Tab Pages |currentpage=2}}

----
== Introduction ==

This tab page on the Plant Model Access Window has a number of parameters that the user may either set or read for Global settings.

{| border="1" cellpadding="5" cellspacing="0"
|width=200|'''Tag (Long/Short)'''||width=120|'''Input / Calc'''||'''Description/Calculated Variables / Options'''
|-
| colspan="3" font style="background: #ebebeb" | '''''List of Species to report nett flows (shown on Links page):'''''
=== List ===
|-
| colspan="3" font style="background: #ebebeb" | This allows the user to add species for a quick species balance around a unit operation. The results of this will be displayed on a per unit operation basis, on the [[Links Table|Links]] Tab of the access window. This information can be used to create, for example, a water / steam balance.
|-
|SpeciesXX / SpXX || List || X is the number of the selected species. Select the required species from the list. The selected species will be added to the species balance, shown on the [[Links Table]]. The default species are H2O(l) and H2O(g). The last row is always blank to allow the user to add more species. To remove a species, choose the “-” option instead of the selected species. As species are added or removed, they are sorted as per the order in the configuration file. NOTE: If different species in the list have the same Component, then the net flow of the component is also added to the links table to display the overall Nett flow of the species. This is to help identify the use of the species in reactions. For example, H2O(l) and H2O(g) are added to the list, when viewing the data on the Links tab of any unit model, we will find component H2O is also added to the list. This additional field is useful for showing the nett flow of water, thus helping user identify if H2O is "consumed" or "created" via reactions.
|-
| colspan="3" font style="background: #ebebeb" |
=== Totalisers ===
(Only visible in Dynamic Transfer mode)
|-
| rowspan="4" valign="top" |Total.Flow.Options || Qm || Show Total mass flow only.
|-
|Qm,Qv || Show Total mass and Total volume flows.
|-
|Qm:AllPhases || Show mass flows for the Total and for all phases.
|-
|Qm,Qv:AllPhases || Show mass and volume flows for Total and for all phases.
|-
| rowspan="4" valign="top" |FirstFlow.Options || Off || No additional information to be shown when the first flow occurs.
|-
|Step || Show the step that flow first occurs in the pipe since the model started running.
|-
|Time || Show the time that flow first occurs in the pipe since the model started running.
|-
|Step, Time || Show both the step and the time that flow first occurs in the pipe since the model started running.

=== Display Configuration ===
|-
|Value.Zero || font style="background: #ebebeb" |Display || The value below which SysCAD will assume zero flow.
|-
|Status.ZeroFlow || font style="background: #ebebeb" |Display|| The value below which the SysCAD display status will indicate zero flow. '''Note:''' While the display will indicate zero flow, SysCAD will still use the actual values for calculations.
|-
| Status.VapourTest || font style="background: #ebebeb" |Display|| The value above which the SysCAD display status will indicate vapour flow. '''Note:''' While the display will indicate vapour flow, SysCAD will still display any values for liquids and solids.
|-
| Status.SolidsTest || font style="background: #ebebeb" |Display|| The value above which the SysCAD display status will indicate solids flow. '''Note:''' While the display will indicate solids flow, SysCAD will still display any values for liquids and vapours.
|-
| colspan="3" font style="background: #ebebeb" |

=== Old Tag Lookup Management ===
|-
|Colspan=3 font style="background: #ebebeb" | This refers to the internal renaming of tags due to SysCAD version change. The messages will be displayed to alert users of tag changes, user should manually fix these tags to prevent the messages from appearing in the future. If tags are not changed, SysCAD will attempt to look up a tag rename table to use the new tag. However, some really old tags may no longer work so it is advisable to change the tags to the new syntax as soon as possible.
|-
|Rowspan=4|Tag.ReName.MaxMessages || None ||No Tag rename messages will be displayed.
|-
| Limited(1) || One Tag rename message can be displayed.
|-
| Limited(10) || Up to ten Tag rename messages can be displayed.
|-
| All || All Tag rename messages will be displayed.
|}

Plant Model

2026-05-09T09:37:18Z

Keith.Armstrong:

[[Category:Project Configuration]]
{{Navigation|[[User Guide]]|[[Menu Commands]]|[[View Command Summary|View]]}}
{{Solver Header Table | currentpage=3 }}
----

{|
|-
|Command Button: || [[File:IconPlantModel.png]]
|-
|Command Path: || View - Plant Model
|-
|Alternate Method: || [[Graphics Window#Pop-up Access Menu on Graphics Window|Graphics Window right-click menu]] > View > Plant Model
|}

----

The Plant Model Access Window gives the user access to a number of useful global settings for the project, as well as information about the system and the project. There are a number of tab pages in the Plant Model access window, these are:
{{Plant Model Tab Pages}}
#[[Plant_Model_-_FlwSolve|FlwSolve Tab]] - Allows Access to: Spill and Vents reporting; Global Demand Configuration and Stop On Error and PGM Time out settings
#[[Plant_Model_-_Settings|Settings Tab]] - Allows access to: Closure and Audit Settings ({{Removed139||y}}); Species selection for Component Mass Balance (on unit operation basis); and Direct Link and Display Configurations Settings.
#[[Plant_Model_-_Audit|Audit Tab]] - {{Available139}} Allows access to Audit Settings.
#[[Plant_Model_-_Project|Project Tab]] - Allows user specified global values to be used in [[Calculation_Configuration#User_Defined_Constants|Custom Calculations]] and PGM files; also allows the execution of a SetTag List report at the solution building stage the project.
#[[Plant_Model_-_RC|RC Tab]] - Allows access to Range Checks.
#[[Plant Model - Species|Species Tab]] - Allows access to: Calculation method selection; VLE, Density and BPE option settings; Standard Properties Model selections (BPE and Density Correction); and Species count information.
#[[Plant Model - Views|Views Tab]] - Allows the user to add or remove information: Additional Properties Options; Material View Options (additional information on the species view tab); and Additional Display Comments.
#[[Plant Model - Soluble Tab|Soluble Tab]] - Allows the user to set the Solubility displays.
#[[Plant Model - Water Quality|WaterQuality Tab]] - Allows access to global water quality parameters. Only visible if the 'WaterQuality' properties option is selected on the [[Plant Model - Views|Views Tab]].
#[[Plant_Model_-_Qualities|Qualities Tab]] - Allows access to additional qualities specification, based on selections made in the project configuration file. These may include: [[LockUp]]; [[Material Tracking]]; [[Size_Distribution_(PSD)#Changing_Size_Distributions|Size Distributions]] and [[Specific Surface Area (SSA)]] .
#[[Plant_Model_-_Environment|Environment Tab]] - Allows access to additional qualities specification, based on selections made in the project configuration file. These may include: Project Configuration Temperature & Pressure and Ambient and Environment Conditions;
#[[Plant_Model -_System|System Tab]] - Allows access some SysCAD Version, SysCAD License and Project information. Useful for reporting.
#[[Plant_Model_-_Model List|ModelList Tab]] - Display of models used in a project that require a license AddOn. Display of DLLs and UnitTypes used in a project.
#[[Plant_Model_-_Flowsheets|Flowsheets Tab]] - Gives a list of graphics pages associated with the project. It is built dynamically after a project load. The main purpose of this is to allow user to activate/deactivate a graphics page externally through the use of macros.
#[[Plant_Model_-_PrjNetworks|PrjNetworks Tab]] - Shows information on the independent flow networks in the project.
#[[Plant_Model_-_Status|Status Tab]] - Displays the message window status and the maximum error reported for the project.
#[[Plant_Model_-_Statistics|Statistics Tab]] - Displays the Statistics for solver speed, processor usage, memory usage and so on.
#[[Plant_Model_-_States|States Tab]] - Displays the Statistics for the time that the solver spends in different states, e.g. ready, solving, stopping, paused. More detail is shown on the [[Plant Model - States - Full Detail]] tab.
#[[Plant_Model - EvalSeq|EvalSeq Tab]] - Displays the Statistics for Network Evaluation.
#[[Plant Model - Globals|Globals Tab]] - This page allows user to change global properties methods if available. This only applies to non-standard species models such as [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina]] or [[Potash Species Model#Selecting Laliberte' methods for Property Calculations |Potash]].
#[[Plant Model Info Page|Info Tab]] - This is a common tab page for all access windows.

Makeup Block (MU)

2026-05-09T09:20:23Z

Keith.Armstrong: /* Data Section */

[[Category:Sub-Models]]
{{Navigation|[[Models]]|[[Models#Sub-Models|Sub-Models]]}}
{{Other General Models Header table |currentpage=2 }}
----
{{TOC}}
== General Description ==

By enabling a Makeup (MU) Block within a unit, the user may add flow to the unit in a controlled fashion. There are a number of advantages to using a MU block to add material to a unit:
# The user needs to add and configure only a single [[Makeup Source]] to feed many different units in a project. It has the the added advantage of reporting all the separate makeup streams in one place.
# Since the Source is not connected to the MU with a standard link, there is no need for multiple links to be constructed.
# The user may often be able to avoid using either a PID or General Controller to control the flow addition.
# The MU calculation occurs in place so the unit always has the correct flow at each iteration, or step. In dynamic projects, using a MU instead of controlled flows with associated time step lags can be a significant advantage.
# A MU can be a useful modelling trick in setting up flow in a recirculating loop. [[FAQ_-_Modelling_related_questions#How_can_I_set_the_flow_in_a_closed-loop_circuit? | Setting flow in a loop]].

The Makeup Block (MU) can be added to a number of models, such as the [[Tie]], [[Tank]], [[Feeder-Cross Page Connector]], [[Pipe]] and many [[Models#Mass Separation Models|Mass Separation]] models.

'''Notes:'''
* The MU block gets the flow composition and properties from the [[Makeup Source]], so this unit needs to be inserted, selected, and configured to enable effective use of the MU in a unit.
* As a sub-model the MU is applied in sequence with other sub-models as part of an [[Evaluation Blocks]] (EB). The flow is added to the mixture for the EB when the MU is evaluated. Therefore the [[DirectLink]] flows are excluded in any reporting of feed stream flows such as QFeed for a Tank or Tie. The flow is reported on the [[Links]] tab page.
* The [[DirectLink]] created by a MU sub-model is excluded from any considerations in determining the operating pressure of the unit model, or the pressure of the mixed QFeed. For example, a [[Tie]] with AutoDetect selected for OperatingP.Method will not include the Makeup Source and associated DirectLink pressure when determining OperatingP.Result.

=== Video Links ===

The following videos are part of the Tutorial showing users how to insert and configure a Makeup Block:
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Add and Configure a Makeup Block|Add and Configure a Makeup Block video]]'''
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Optional - Review results from Makeup Block |Review results from Makeup Block video]]'''

== Adding Makeup to a Unit ==

=== Step 1 - Enable Makeup ===

The Makeup Block is enabled in a unit when the user enters an integer between 1 and 8 for the number of Makeups in the unit's access window.

The user may enable more than one Makeup Block per unit, by entering 2, 3, etc. The unit will then have the appropriate number of Tabs: MU1, MU2, MU3, etc. each of which can be configured separatly.

'''Notes:'''
# The Makeup Block is a sub-model which is evaluated sequentially. The user can change the order that the sub-models are solved using the drop down lists on the first tab page - Off, On-AutoSequence, On-Sequence1, On-Sequence2, etc.
# The ''[[Evaluation_Blocks|AutoSequence]]'' option will evaluate the sub-models as follows:
#* 1st - Makeups (MU)
#* 2nd - Reactions (RB)
#* 3rd - Environmental Heat Exchange (EHX)
#* 4th - Evaporation (Evap)
#* 5th - Vapour Liquid Equilibrium (VLE)
#* 6th - Discards (DB)
# For example, a Makeup may be added either before or after a reaction block sub-model.
#* If the Makeup is a reactant then it must be added prior to the reaction block.
#* If the user wants to achieve a final concentration from the unit then the Makeup block should be the last sub-model.
#* '''Due to the sequential nature of the sub-models, Makeups can not be used to achieve a final concentration of a reactant.'''

=== Step 2 - Connect to a Makeup Source ===

The next step is to connect the Makeup Block to a [[Makeup Source]]. Go to the MU tab and select the Makeup Source from a drop down list of available Makeup sources in the project.

Once a valid Makeup Source has been entered into the MakeupSrc field, a graphics symbol for the [[DirectLink]] will be displayed indicating that the unit has additional input. (Note: The user may change the name of this [[DirectLink]] or its graphical symbol in exactly the same way as for any other unit in SysCAD).

=== Step 3 - Configure the Makeup Block ===

The Makeup Block may then be configured as:
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* None
* [[#Fixed Makeup Model|Fixed Makeup]]
* [[#Ratio Makeup Model|Ratio Makeup]]
* [[#Product Flow Makeup Model|Product Flow]]
* [[#Product Composition Makeup Model|Product Composition]]
* [[#Product Concentration Makeup Model|Product Mass Concentration @T]]
* [[#Product Concentration @25 Makeup Model|Product Mass Concentration @25°C]]
* [[#Product Molar Concentration Makeup Model|Product Molar Concentration @T]]
* [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25°C]]
* [[#Product Density Makeup Model|Product Density]]
* [[#Product pH.negLogH Makeup Model|Product pH Estimate]]
* [[#Product User Calc Makeup Model|Product User Calculation]]
* [[#Product SpCalc Makeup Model|Product Species Calculation]]
* [[#Product SpModel Property Makeup Model|Product Species Model Property]]
* [[#Product Temperature Makeup Model|Product Temperature]]
* [[#Temperature Change Makeup Model|Temperature Change]]
</div>
Each of the different options that can be configured are described in the table below.

[[Image:Makeup01.png]]


'''NOTE''':
* When setting up the makeup block, it’s crucial to understand the evaluation order of the MU block. The term “Feed” refers to the material entering the MU block. This means that if the MU block in question is the second evaluation block in the sequence, then the “Feed” for this MU block would be the “Product” from the first evaluation block. Similarly, the term “Product” (as used in the method [[#Product Flow Makeup Model|Product Flow]]) refers to the material exiting the MU block. It’s important to note that this may not be the same as the Discharge product from the process unit if other evaluation blocks are used after the MU block.

==Data Section==

The default access window (MU) and variable names are described in detail in the following tables. These variables change as the user selects the various options that are available. Individual tables are shown for each Makeup Model, except for the [[#Common Requirements - Makeup Limits, Low Feed and Product Temperature|Common Requirements]] and [[#Common Results for All Models|Common Results]] tables that show fields that are common to all methods.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=220|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| DIO...
|-
| MakeupScr || List || Name of the MakeUp Source unit operation - this may be chosen from the drop down list of all MakeUp Sources available in the project.
|-
| DirectLink || font style="background: #ebebeb" | Display || The name of the [[DirectLink]] between the Makeup Source and the unit.
|-
| Connect || font style="background: #ebebeb" |Display || Displays any errors with the connection with MakeUpScr. If there are no errors, then OK is displayed.
|-
| colspan="3" font style="background: #ebebeb" |
=== Requirements ===
|-
| On || Tickbox || Switch Makeup block on or off
|-
|Rowspan=16 valign="top" | Model See [[#Step_3_-_Configure_the_Makeup_Block|NOTE]] || None || No makeup is added to the unit. This is the same as disabling the block.
|-
| [[#Fixed Makeup Model|Fixed Makeup]] || Makeup is added as a fixed amount set by the user (or via a controller). The section on Fixed Makeup has a description of all of the relevant fields.
|-
| [[#Ratio Makeup Model|Ratio Makeup]] || Makeup is added based as a user specified ratio relative to the feed. The ratio may be based on total flows, phases, species or elements. The section on Ratio Makeup has a description of all of the relevant fields.
|-
| [[#Product Flow Makeup Model|Product Flow]] || Makeup is added to achieve a user specified product flow. The required flow can be total flow, flow of phase or species or element. The section on Product Flow has a description of all of the relevant fields.
|-
| [[#Product Composition Makeup Model|Product Composition]] || Makeup is added to achieve a user specified product composition. The section on Product Composition has a description of all of the relevant fields. Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].
|-
| [[#Product Concentration Makeup Model|Product Concentration]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at stream temperature. The section on Product Concentration has a description of all of the relevant fields. Please also see [[ETip: Controlling Concentration using Makeup Blocks]].
|-
| [[#Product Concentration @25 Makeup Model|Product Concentration @25]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at 25°C. The section on Product Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration Makeup Model|Product Molar Concentration]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at stream temperature. The section on Product Molar Concentration has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at 25°C. The section on Product Molar Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Density Makeup Model|Product Density]] || Makeup is added to achieve a user specified product density. The section on Product Density has a description of all of the relevant fields.
|-
| [[#Product pH.negLogH Makeup Model|Product pH.negLogH]] || Makeup is added to achieve a user specified product pH. The section on Product pH has a description of all of the relevant fields. Please note that the pH calculated in SysCAD is an estimate.
|-
| [[#Product_User_Calc_Makeup_Model|Product User Calc]] || Makeup is added to achieve a user specified value of a user calculation. The section on Product User Calc has a description of all of the relevant fields.
|-
| [[#Product_SpCalc_Makeup_Model|Product SpCalc]] || Makeup is added to achieve a user specified value of a species calculation. The section on Product SpCalc has a description of all of the relevant fields.
|-
| [[#Product_SpModel_Property_Makeup_Model|Product SpModel Property]] || Makeup is added to achieve a user specified value of a species model property. The section on Product SpModel Property has a description of all of the relevant fields.
|-
| [[#Product Temperature Makeup Model|Product Temperature]] || Makeup is added to achieve a user specified product temperature. The section on Product Temperature has a description of all of the relevant fields.
|-
| [[#Temperature Change Makeup Model|Temperature Change]] || Makeup is added to achieve a user specified temperature change between the feed and the product. The section on Temperature Change has a description of all of the relevant fields.
|}

=== Fixed Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassFlow || The user specifies the Makeup amount as a mass flowrate.
|-
| VolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at temperature.
|-
| VolumeFlow25 || The user specifies the Makeup amount as a volumetric flowrate at 25°C.
|-
| NVolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at Normal Temperature.
|-
| MoleFlow || The user specifies the Makeup amount as a molar flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The amount of material added is based on the Total makeup stream.
|-
| Phase || The user can select the different phases to be included in the specified amount. For example, if the make up source has 50% solids and 50% liquids, and the user wants to specify a mass flow of 10t/h of solids, then only leave the solids tick box checked and SysCAD will add to the MUx block enough makeup to give 10t/h solids. In this case, a total of 20t/h will be added.
|-
| IndividualPhase || As per Phase, the user is allowed to select the individual phase to be included in the specified amount. For example, if user wants to specify the organic addition - individual phase (or) to be 10t/h then select the (or) individual phase, and the makeup block will add enough to give 10t/h organic.
Note: To do so, user must have defined (or) phase in the species database and the makeup source must contain organics as part of its composition.
|-
| valign="top" | All Species/Species || The user may select individual species to be included in the specified amount.
* Select required species from the list.
* Multiple selections are allowed. Up to 20 species can be selected.
|-
| valign="top" | Solid Species || The user may select individual solid species to be included in the specified amount. Up to 20 solid species can be selected.
|-
| valign="top" | Liquid Species || The user may select individual liquid species to be included in the specified amount. Up to 20 liquid species can be selected.
|-
| valign="top" | Vapour Species || The user may select individual vapour species to be included in the specified amount. Up to 20 vapour species can be selected.
|-
| valign="top" | Component || As per species above. The difference between species and component is that species is phase based, while a component is phase independent. For example, if NaCl is defined in the (aq) and (s) phases, and user wishes to select the solid phase only, then use the '''Species''' option and choose NaCl(s). If user wants to include both phases, then use the '''Component''' option and choose NaCl.
|-
| Element || The user may select individual elements to be included in the specified amount.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected all species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species, component or element. Select the required species, component or element from the list. There will usually be one extra to allow another species, component or element to be added - to a maximum of 20. To remove a species, component or element, choose the “-” option instead of the selected species, component or element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required '''(basis)''' Flow''''': xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl
|-
| Reqd.MakeUp.xx|| Input || User specified Make up amount in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.MakeUp.xx || font style="background: #ebebeb" | Feedback || User specified Make up amount as Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the makeup stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the product stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|}

=== Ratio Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassRatio || The user specifies the ratio on the basis of mass flowrates.
|-
| VolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at temperature.
|-
| Volume25Ratio || The user specifies the ratio on the basis of volumetric flowrates at 25°C.
|-
| NVolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at Normal Temperature.
|-
| MoleRatio || The user specifies the ratio on the basis of mole flowrates.
|-
|colspan=3 font style="background: #ebebeb"| '''''Feed Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Feed flow.
|-
| Phase || The ratio measurement is based on one or more Phases in the Feed.
|-
| IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Feed.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Feed.
|-
| Solid Species || The ratio measurement is based on one or more solid Species in the Feed.
|-
| Liquid Species || The ratio measurement is based on one or more liquid Species in the Feed.
|-
| Vapour Species || The ratio measurement is based on one or more vapour Species in the Feed.
|-
| Component || The ratio measurement is based on one or more Components in the Feed.
|-
| Element || The ratio measurement is based on one or more elements in the Feed.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || The user may select the required Species, Components or Elements from the displayed list. X is the number of the selected species/component/element. As for fixed makeup.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Makeup flow.
|-
|Phase || The ratio measurement is based on one or more Phases in the Makeup flow.
|-
|IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Makeup flow.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Makeup flow.
|-
| Solid Species || The ratio measurement is based on one or more solid Species in the Makeup flow.
|-
| Liquid Species || The ratio measurement is based on one or more liquid Species in the Makeup flow.
|-
| Vapour Species || The ratio measurement is based on one or more vapour Species in the Makeup flow.
|-
| Component || The ratio measurement is based on one or more Components in the Makeup flow.
|-
| Element || The ratio measurement is based on one or more elements in the Makeup flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
|Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Ratio''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.(xx)Ratio || Input || The required Make up Mass/Volume@T/Volume@25°C/NVolume/Mole Ratio as specified by the user in the ''Reqd.Basis'' field.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.xxRatio || font style="background: #ebebeb" | Feedback || User specified Make up ratio as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
| Meas.xxRatio || font style="background: #ebebeb" | Calc || Make up ratio of flowrates achieved as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) Flow ratio of MakeUp[] to Feed[]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Flow Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||MassFlow || The user may specify the required mass product flowrate.
|-
| VolumeFlow || The user may specify the required volumetric product flowrate at temperature.
|-
| VolumeFlow25 || The user may specify the required volumetric product flowrate at 25°C.
|-
| NVolumeFlow || The user may specify the required volumetric product flowrate at Normal Temperature.
|-
| MoleFlow || The user may specify the required molar product flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection || All || The Product measurement includes the full Product flow.
|-
| Phase || The Product measurement includes one or more Phases in the Product flow.
|-
| IndividualPhase || The Product measurement includes one or more Individual Phases in the Product flow.
|-
| All Species/Species || The Product measurement includes one or more Species in the Product flow.
|-
| Solid Species || The Product measurement includes one or more solid Species in the Product flow.
|-
| Liquid Species || The Product measurement includes one or more liquid Species in the Product flow.
|-
| Vapour Species || The Product measurement includes one or more vapour Species in the Product flow.
|-
| Component || The Product measurement includes one or more Components in the Product flow.
|-
| Element || The Product measurement includes one or more Elements in the Product flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (Basis) Flow rate''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xx || Input || User specified Product flowrate in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product flowrate is treated as a minimum target and there will be no warnings if this flowrate is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product flowrate is treated as a maximum target and there will be no warnings if the actual flowrate is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xx || font style="background: #ebebeb" | Display || User specified Product Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Display || Displays the Feed Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the Product stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Composition Makeup Model ===

Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||Mass || The user specifies the product composition by mass fraction
|-
| Volume || The user specifies product composition by volume fraction at product temperature
|-
| Volume25 || The user specifies product composition by volume fraction at 25°C.
|-
| NVolume || The user specifies product composition by volume fraction at Normal Temperature
|-
| Mole || The user specifies product composition by mole fraction
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=8 valign="top" | Selection || Phase || The user may specify the required composition of one or more Phases in the product stream.
|-
| IndividualPhase || The user may specify the required composition of one or more Individual Phases in the product stream.
|-
| All Species/Species || The user may specify the required composition of one or more Species in the product stream.
|-
| Solid Species || The user may specify the required composition of one or more solid Species in the product stream.
|-
| Liquid Species || The user may specify the required composition of one or more liquid Species in the product stream.
|-
| Vapour Species || The user may specify the required composition of one or more vapour Species in the product stream.
|-
| Component || The user may specify the required composition of one or more Components in the product stream.
|-
| Element || The user may specify the required composition of one or more Elements in the product stream.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X|| List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Base Measurement'''''
|-
|Rowspan=3 valign="top" | Selection || All || The user may specify the required composition as a fraction of the Total Product flow.
|-
| Phase || The user may specify the required composition as a fraction of one or more Phases in the product stream, e.g. the fraction of SiO2(s) as a fraction of the Solid phase.
|-
| IndividualPhase || The user may specify the required composition as a fraction of one or more Individual Phases in the product stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Fraction''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xxFrac || Input || The required product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product composition is treated as a minimum target and there will be no warnings if this composition is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product composition is treated as a maximum target and there will be no warnings if the actual composition is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) fraction [component/species/element(phase)]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xxFrac || font style="background: #ebebeb" | Display || User specified Product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Feed.xxFrac || font style="background: #ebebeb" | Display || Displays the Feed stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.MakeUp.xxFrac || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Prod.xxFrac || font style="background: #ebebeb" | Calc || Displays the Product stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|}

=== Product Concentration Makeup Model ===

Please also see [[ETip: Controlling Concentration using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the aqueous (aq) phase.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc || Input || The user specified product concentration (mass per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at product temperature.
|-
| Meas.Feed.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc / Conc25 || Input || The user specified product concentration (mass per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume25[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc / Conc25 || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at 25°C.
|-
| Meas.Feed.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Molar Concentration Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| ''Required Molar Concentration''
|-
| Reqd.Prod.ConcMl / MlConc || Input || The user specified product concentration (moles per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at product temperature.
|-
| Meas.Feed.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Molar Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Molar Concentration'''''
|-
| Reqd.Prod.ConcMl / MlConc25 || Input || The user specified product concentration (moles per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product molar concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product molar concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume25[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at 25°C.
|-
| Meas.Feed.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Density Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Density Measurement'''''
|-
|Rowspan=2 valign="top" | Selection || All || All phases will be used for the product density calculation.
|-
| Phase || The user selects which phases will be used for the product density calculation. For example, if the product may contain gases, then the user may tick only the Solids and Liquids tickboxes to ensure that the vapours are NOT included in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| The following three tick boxes will only be visible if the user has selected 'Phase' for the Selection field.
|-
| Solids || Tick Box|| This must be ticked if the user wishes to include solids in the density calculation.
|-
| Liquids || Tick Box|| This must be ticked if the user wishes to include liquids in the density calculation.
|-
| Vapours || Tick Box|| This must be ticked if the user wishes to include vapours in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Density'''''
|-
| Reqd.Prod.Rho || Input || User specified product density.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product density is treated as a minimum target and there will be no warnings if this density is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product density is treated as a maximum target and there will be no warnings if the actual density is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Rho || font style="background: #ebebeb"| Display || User specified Product density.
|-
| Meas.Feed.Rho || font style="background: #ebebeb"| Calc || Displays density of Feed stream
|-
| Meas.MakeUp.Rho || font style="background: #ebebeb"| Calc || Displays density of Makeup stream
|-
| Meas.Prod.Rho || font style="background: #ebebeb"| Calc || Displays density of Product stream
|}

=== Product pH.negLogH Makeup Model ===

* Please note that the pH is be measured at the point of addition, any acid/base reactions that occur after the Makeup are not considered.
* This feature is demonstrated in the [[Zinc Hydrometallurgical Project]], which is distributed with SysCAD.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required pH'''''
|-
| Reqd.Prod.pH.negLogH || Input || User specified product pH.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product pH is treated as a minimum target and there will be no warnings if the estimated pH is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product pH is treated as a maximum target and there will be no warnings if the estimated pH is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''pH Estimate'''''
|-
| Used.Prod.pH.negLogH || font style="background: #ebebeb"| Display || User specified Product pH.
|-
| Meas.Feed.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Feed stream
|-
| Meas.MakeUp.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Makeup stream
|-
| Meas.Prod.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Product stream
|}

=== Product User Calc Makeup Model ===

* Please note that User Calc (User Property Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#User_Property_Calculations |User property Calculations]] for more information.
* This option is only usable if user defined properties are present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.UserCalc || List || Lists all available user defined properties in the project, if nothing is available, the List box will display "None Defined"
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected user property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''User Calc xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected User property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the feed stream
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the Makeup stream
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the product stream
|}

=== Product SpCalc Makeup Model ===

* Please note that SpCalc (User species Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#Species_Calculations |User Species Calculations]] for more information.
* This option is only usable if user species calculation is present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpCalc || List || Lists all available user defined species calculation in the project, if nothing is available, the List box will display "None Defined"
|-
|rowspan=4 | Reqd.SpBasis || colspan=2 font style="background: #ebebeb"| Allows the user to select the phase basis of the species calculation.
|-
|All || The calculated value will be based on whole stream.
|-
|Phase || The calculated value will be by Phase.
|-
|IndividualPhase || The calculated value will be by Individual Phase.
|-
|Reqd.View || List || Dropdown list of relevant views for chosen calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required ZZZ Value'''''
|-
| Reqd.Prod.YYY.ZZZ || Input || The required value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpCalc ZZZ'''''
|-
| Used.Prod.YYY.ZZZ || font style="background: #ebebeb"| Display || The specified value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Meas.Feed.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the feed stream.
|-
| Meas.MakeUp.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the Makeup stream.
|-
| Meas.Prod.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the product stream.
|}

=== Product SpModel Property Makeup Model ===

* Please note that the species properties that are available in a project will depend on the add-ons used in that project. For example, if the project is using the Alumina add-on, then all of the species properties that are available for the Bayer property model will be available.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpModel || List || Lists all available species models in the project. Many projects will only have 'Standard', but if you have the Alumina add-on, you may also select 'Bayer'.
|-
|Reqd.Property || List || Allows the user to select the species model property that will be used to control the makeup to the unit.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected species model property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpMdlProp xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected species model property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the feed stream.
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the Makeup stream.
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the product stream.
|}

=== Product Temperature Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature'''''
|-
| Reqd.Prod.T || Input || User specified product temperature
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product temperature is treated as a minimum target and there will be no warnings if this temperature is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product temperature is treated as a maximum target and there will be no warnings if the actual temperature is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Temp || font style="background: #ebebeb"| Display || User specified Product temperature
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Product stream
|}

=== Temperature Change Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature Change'''''
|-
| Reqd.Prod.TChg || Input || User specified temperature change (between feed and product)
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.TChg || font style="background: #ebebeb"| Display || User specified temperature change
|-
| Meas.Prod.TChg || font style="background: #ebebeb"| Display || Temperature change achieved (from feed to product temperature)
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of product stream
|}

=== Common Requirements ===

The common requirements include makeup limits, low feed and product temperature.

The following input fields are required for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=10%|Tag (Long/Short) || Width=10%|Input/Calc || Width=80%|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Limits for total Makeup Flow'''''
|-
| MakeUp.QmMin || Input || User specified minimum makeup flow, usually 0. '''Note:''' this is applied to the total makeup stream.
|-
| MakeUp.QmMax || Input || User specified maximum makeup flow - the Makeup block will not add more than this value. '''Note:''' this is applied to the total makeup stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Rule for Low Feed Flow'''''
|-
|Rowspan=3 valign="top" | LowQmRule || AlwaysOn || Always add specified flow of makeup, even if the Feed flow drops to zero.
|-
| StopBelowQmLimit || Do not add any makeup if Feed flowrate is below user specified number.
|-
| StopBelowNoFlow || Do not add any makeup if Feed flowrate is zero.
|-
| LowQmLimit || Input || Only visible if ''StopBelowQmLimit'' is selected. User specified minimum feed flow below which no makeup is added.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Temperature''''' (Not visible if ''Product Temperature'' or ''Temperature Change'' are selected)
|-
|Rowspan=5 valign="top" | Temp.Final || InletTemp || Add or remove heat to make the Product temperature the same as the Feed temperature.
|-
| SourceTemp || Add or remove heat to make the Product temperature the same as the Makeup Source temperature.
|-
| StdTemp || Add or remove heat to make the Product temperature the same as Standard temperature.
|-
| Const || Add or remove heat to make the Product temperature the same as the user specified temperature.
|-
| Mixture || Default behaviour - no heat is added or removed, the Product temperature is determined by an energy balance involving the Feed and the Makeup.
|-
| Temp.Reqd || Input || Only visible if ''Const'' is selected. User specified temperature of the Product stream.
|}

=== Common Results for All Models ===

The following fields are visible for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Description || font style="background: #ebebeb"| Display || Displays a description in words of the makeup options chosen.
|-
| State || font style="background: #ebebeb"| Display || Displays any errors. If there are no errors then displays OK.
|-
|colspan=3 font style="background: #ebebeb"| '''''Total mass flow'''''
|-
| Feed.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of feed stream.
|-
| MakeUp.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of makeup stream.
|-
| Prod.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total volume flow:'''''
|-
| Feed.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of feed stream.
|-
| MakeUp.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of makeup stream.
|-
| Prod.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total heat flow'''''
|-
| Feed.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of feed stream.
|-
| MakeUp.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of makeup stream.
|-
| Prod.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of product stream (including makeup).
|-
| HeatFlow ||font style="background: #ebebeb"| Calc || Displays heat added/removed to achieve product temperature requirements.
|}

== Use in Example Projects ==

The Makeup methods are shown in the following example projects distributed with SysCAD:

''' Fixed Makeup'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Units: ''Ni_Diss_1'' and ''Acid_Addition''
#Smelter Example
#:Project Location: See [[Example_65_Smelting#Copper_Flash_Furnace_Example|Smelter Example]]
#:Unit: ''Electric_Furnace''

''' Ratio Makeup'''

Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''NiCo_Precip''

'''Product Flow'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''

'''Product Composition'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''
#Demo Uranium Project
#:Location: See [[Example 80 Uranium|Demo Uranium Project]]
#:Unit: ''P_13''

'''Product Concentration'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''Ni_Diss_2''

'''pH Control'''

#Demo Zinc Hydrometallurgical Project
#:Project Location: See [[Zinc Hydrometallurgical Project]]
#:Units: All links after acid additions for pH control.

'''User Calc'''
#Demo Gold Project
#:Project Location: See [[Example 25 Gold|Gold Project]]
#:The last reaction in the tanks are using the reaction extent [[Reaction_Block_-_Extents#User_Calculations_-_User_Defined_Properties_.28User_Calc.29|UserCalc]].

Software Licenses Expiry Dates

2026-05-09T08:51:38Z

Keith.Armstrong: /* Expiry Dates per Build */

[[Category:License]] [[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[Licensing]]}}

'''Related Links:''' [[SysCAD Version History]]
----
== Expiry Dates for Software Licenses ==

When using a [[Stand-alone Software License|software license]], each Build has a built-in expiry date that will prevent use after this date. This expiry date does not apply to [[SysCAD USB License Key|USB License Keys]]. For two months ahead of the expiry the user is given a warning message, and for one month an extra dialog, to update to the most recent supported update.

After expiry the user is given an '''"Error 733"''' requiring an update. This is simply resolved by updating from an old copy to the latest update for the Build (if staying with the same version); or the user can upgrade to the next version/build; or the user can use a USB License Key.

If you are using SysCAD 9.3 Build 137 or any earlier version we encourage you to contact us to discuss the best option to upgrade to a newer version.
Kenwalt provides upgrade support for users of the most recent SysCAD 9.3 Build 137. We encourage users of Build 137 to upgrade to the latest Build of SysCAD 9.3.

== Expiry Dates per Build ==
Expiry dates if using software license management:

* '''Build 139'''
** Build 139.37081 or later - 25 September 2027
** Build 139.37074 to 139.37080 - 25 March 2027
** Build 139.37052 to 139.37072 - 25 September 2026
** Build 139.37014 to 139.37051 - 25 March 2026
** Build 139.35613 to 139.37013 - 25 September 2025
** Build 139.34920 to 139.35612 - 25 March 2025
** Build 139.33673 to 139.34919 - 25 September 2024
** Build 139.32537 to 139.33672 - 25 March 2024
** Build 139.31825 to 139.32536 - 25 September 2023
** Build 139.30139 to 139.31824 - 25 March 2023
** Build 139.29745 to 139.30138 - 25 September 2022
** Build 139.29370 to 139.29744 - 25 March 2022

* '''Build 138'''
** Build 138.36608 or later - 25 March 2026
** Build 138.34989 to 138.36607 - 25 March 2025
** Build 138.33657 to 138.34988 - 25 March 2024
** Build 138.32536 to 138.33656 - 25 September 2023
** Build 138.30470 to 138.32535 - 25 March 2023
** Build 138.30216 to 138.30469 - 25 September 2022
** Build 138.29112 to 138.30215 - 25 March 2022
** Build 138.27557 to 138.29111 - 25 September 2021
** Build 138.24866 to 138.27556 - 25 March 2021
** Build 138.24431 to 138.24865 - 25 September 2020
** Build 138.23957 to 138.24430 - 25 March 2020

* '''Build 137''' (Upgrade Support only)
** Build 137.26777 or later - 25 September 2021
** Build 137.25087 to 137.26776 - 25 September 2020
** Build 137.23150 to 137.25086 - 25 March 2020
** Build 137.22530 to 137.23149 - 25 September 2019
** Build 137.21471 to 137.22529 - 25 March 2019
** Build 137.21470 or earlier - 25 October 2018

* '''Build 136''' (Upgrade support only)
** Build 136.22546 - 15 September 2019
** Build 136.21476 to 136.22545 - 25 January 2019
** Build 136.20983 to 136.21475 - 25 October 2018
** Build 136.20254 to 136.20982 - 25 May 2018
** Build 136.19465 to 136.20253 - 25 February 2018
** Build 136.18874 to 136.19464 - 25 August 2017
** Build 136.18873 or earlier - 25 June 2017

Build 139 Revision History

2026-04-15T08:46:57Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37069===
:''Released 18 December 2025
* Bug fixes:
** Fix edge case in [[Reverse Osmosis (RO) Unit]] when changing model to Simple and previous EffMethod was ImpurityFrac (it incorrectly used a setting from previous EffMethod).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.1.0 version 2.1.0], which includes the addition of a dynamic AG/SAG mill model.
* [[Excel Reports]]:
** New Excel reporting [[Excel_Get_Tag_Reports#Report_Keyword_Syntax|keyword option]] (for TagList, TagTable, etc.) "Inactive:value" to display values for inactive result tags.
** Improved feedback messages when Excel reports don't have report names.
** Excel ReportName is now optional for [[Excel_Set_Tag_Reports#SysCAD_Set_Tag_Report_in_a_Single_Row_or_Column|SetTagList]].
* General Improvements:
** Fix for [[Access_Window#Right_click_on_the_Access_Window_tab_page_names|Right Click on tab name in Access Window]] not always bring up the correct context menu including options to copy the tag for the tab page.
** Improved error messaging for managing connected tags for a [[Feeder]].
** After a [[Copy and Paste Graphics Commands|graphics Cut & Paste]], the unit counts for each graphics flowshhet shown in [[Explorer Window]] are now correct.
* [[TCE]] Improvements:
** Fix for Plotter when changing between mole and mass based Species adjustment, now retains the value when changing.
** Fix for TCE unit model references to the ChemModelCfg used when an unused TCEModelCfg unit is deleted.
* Example Projects:
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics - Dynamic Grinding Example]] with a new flowsheet page for a circuit including the new SAG mill.

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|Basefiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated Basefiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Software Licenses Expiry Dates

2026-04-15T08:30:56Z

Keith.Armstrong: /* Expiry Dates per Build */

[[Category:License]] [[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[Licensing]]}}

'''Related Links:''' [[SysCAD Version History]]
----
== Expiry Dates for Software Licenses ==

When using a [[Stand-alone Software License|software license]], each Build has a built-in expiry date that will prevent use after this date. This expiry date does not apply to [[SysCAD USB License Key|USB License Keys]]. For two months ahead of the expiry the user is given a warning message, and for one month an extra dialog, to update to the most recent supported update.

After expiry the user is given an '''"Error 733"''' requiring an update. This is simply resolved by updating from an old copy to the latest update for the Build (if staying with the same version); or the user can upgrade to the next version/build; or the user can use a USB License Key.

If you are using SysCAD 9.3 Build 137 or any earlier version we encourage you to contact us to discuss the best option to upgrade to a newer version.
Kenwalt provides upgrade support for users of the most recent SysCAD 9.3 Build 137. We encourage users of Build 137 to upgrade to the latest Build of SysCAD 9.3.

== Expiry Dates per Build ==
Expiry dates if using software license management:

* '''Build 139'''
** Build 139.37073 or later - 25 March 2027
** Build 139.37052 to 139.37072 - 25 September 2026
** Build 139.37014 to 139.37051 - 25 March 2026
** Build 139.35613 to 139.37013 - 25 September 2025
** Build 139.34920 to 139.35612 - 25 March 2025
** Build 139.33673 to 139.34919 - 25 September 2024
** Build 139.32537 to 139.33672 - 25 March 2024
** Build 139.31825 to 139.32536 - 25 September 2023
** Build 139.30139 to 139.31824 - 25 March 2023
** Build 139.29745 to 139.30138 - 25 September 2022
** Build 139.29370 to 139.29744 - 25 March 2022

* '''Build 138'''
** Build 138.36608 or later - 25 March 2026
** Build 138.34989 to 138.36607 - 25 March 2025
** Build 138.33657 to 138.34988 - 25 March 2024
** Build 138.32536 to 138.33656 - 25 September 2023
** Build 138.30470 to 138.32535 - 25 March 2023
** Build 138.30216 to 138.30469 - 25 September 2022
** Build 138.29112 to 138.30215 - 25 March 2022
** Build 138.27557 to 138.29111 - 25 September 2021
** Build 138.24866 to 138.27556 - 25 March 2021
** Build 138.24431 to 138.24865 - 25 September 2020
** Build 138.23957 to 138.24430 - 25 March 2020

* '''Build 137''' (Upgrade Support only)
** Build 137.26777 or later - 25 September 2021
** Build 137.25087 to 137.26776 - 25 September 2020
** Build 137.23150 to 137.25086 - 25 March 2020
** Build 137.22530 to 137.23149 - 25 September 2019
** Build 137.21471 to 137.22529 - 25 March 2019
** Build 137.21470 or earlier - 25 October 2018

* '''Build 136''' (Upgrade support only)
** Build 136.22546 - 15 September 2019
** Build 136.21476 to 136.22545 - 25 January 2019
** Build 136.20983 to 136.21475 - 25 October 2018
** Build 136.20254 to 136.20982 - 25 May 2018
** Build 136.19465 to 136.20253 - 25 February 2018
** Build 136.18874 to 136.19464 - 25 August 2017
** Build 136.18873 or earlier - 25 June 2017

Solver Setting - PB

2026-04-14T01:19:27Z

Keith.Armstrong:

[[Category:Solver]] [[Category:User Interface]]
{{Navigation|[[User Guide]]|[[Menu Commands]]|[[View Command Summary|View]]|[[Solver Settings]]|altname=ProBal}}
{{Solver Settings Header Table | currentpage=2}}
----

This tab will only be available in a '''Steady State''' (ProBal) project.

This tab page lists some of the configuration options as per the [[Solver Set up for Steady State Projects]] command.

{| border="1" cellpadding="5" cellspacing="0"
| |
'''Tag (Long/Short)'''
| |
'''Input / Calc'''
| |
'''Description'''
|-
| colspan="3" font style="background: #ebebeb" |PB...
|-
| colspan="3" font style="background: #ebebeb" |''ProBal Solver Settings''
|-
| colspan="3" font style="background: #ebebeb" |''Solver Start Actions''
|-
| SetTimeToZero|| | Tickbox|| Sets the time to zero at the start of the run.
|-
| RestartHistorian|| | Tickbox|| Restarts the [[Historian]] at the start of the run.
|-
| rowspan="2" | InActiveNodes || Ignore || Inactive units will be ignored.
|-
| Reset || Inactive units will be reset.
|-
| colspan="3" font style="background: #ebebeb" |''Options''
|-
| LowQmFracOther || Input || Used when calculating the pressure used when mixing streams and there is no overriding pressure set or active OperatingP. The AutoDetect method as described in OperatingP is used and this determines the amount required for any stream to contribute to the total flow when calculating the mixture pressure. For example, if the total feed to the unit is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| ResultsValid || font style="background: #ebebeb"|Display|| A value of 1 indicates that the results are valid, while a value of 0 indicates that the results are invalid.
|-
| colspan="3" font style="background: #ebebeb" |Closure... ({{Removed139}} Refer to [[Plant Model - Settings#Closure|Plant Model - Settings page]] for more information.)
|-
| MassAbs || Input || Maximum allowable Absolute Mass flow imbalance in models.
|-
| MassRel || Input || Maximum allowable Relative Mass flow imbalance in models.
|-
| HeatAbs || Input || Maximum allowable Absolute Heat flow imbalance in models.
|-
| HeatRel || Input || Maximum allowable Relative Heat flow imbalance in models.
|-
| HeatRel2Mdl || Input ||
|}

Template:OperatingP

2026-04-14T00:55:19Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
[[DirectLink]] feeds, for example from [[Makeup Block (MU)|Makeup Blocks]], are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the pressure and temperature of the mixture, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount required for any stream to contribute to the total flow when calculating the mixture pressure. For example, if the total feed to the unit is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

General Controller

2026-04-10T00:07:10Z

Keith.Armstrong: /* Set Tag Validation in Build139 */

[[Category:Models]] [[Category:PGM]] [[Category: Control]]
{{Navigation|[[Models]]|[[Models#Control Models|Control Models]]}}
{{Control Models Header table| currentpage=1 }}
Related Links: [[PGMs|PGM]], [[Example PGM Files]]
----
{{TOC}}
== General Description ==

This is used to simulate plant control, plant operations or calculate displays. This model is often used to customise or extend the functionality of a standard unit operation. These functions may be as simple or complex as may be required.

The General Controller reads a text file, set up by the user, which allows the user to include fairly powerful programming functions. The files are known as "pgm" files and are detailed in a separate section of the documentation '''[[PGMs]]'''. The control logic (or program code) that you write for a General Controller is executed once every iteration.

The [[PGMs|PGM language]] includes the following capabilities:
* Accessing tags by name within any unit or stream on the flowsheet.
* Modification of any permissible tags within any unit or stream on the flowsheet.
* Real, Integer and Boolean arithmetic.
* Strings and string manipulation routines.
* Declaration of user tags (PGM variables) which are then accessible at run time for view, change, reporting, trending, etc.
* General-purpose functions and classes may be defined and used.

This document only describes the access window for the general controller, and some of the more common problems that may occur. The [[PGMs|PGM help documentation]] contains examples of pgm files and various applications that can be simulated using this model.

For dynamic projects this is used extensively to simulate the control system as well as operator actions. It can be used to simulate events, for example the random failure of equipment.

Tags that are controlled (using SetTag) or referenced (using GetTag) by the General Controller will have a coloured triangle shown in the access window of that unit. When the user right clicks on one of these referenced tags it will indicate which controller is referencing the tag. See [[Controlled and Referenced Variables]].

=== Location of Control Text files ===

* When the user creates a control file, SysCAD automatically creates a sub-folder in the project called ''Controls'' and stored all control files (with the extension .pgm) in this folder.
* The user may store the control files in any other location, although this is not recommended. The use of [[Relative File Path]] is allowed.
* The user may view the location of all the control files in a project by accessing [[Project Window#Files List|Project Window - Files List]].

=== Video Links ===

The Tutorial section has a number of videos showing users how to write a simple PGM file for a General Controller:

'''[[Introductory Tutorial - General Controller and PGMs]]'''

=== Similar Models ===

* [[Set Tag Controller]] - the user may carry out the simple ratio control and set multiple tags using the the Set Tag Controller model.

=== Diagram ===

[[Image:Models-Controller-Image001.gif]]

The diagram shows the default drawing of the General Controller.

== Inputs and Outputs ==

There are no connections to this unit.

== Model Theory ==

The power of this model is contained in the program (PGM) written by the user. The pgm syntax for programing the control file is described in [[PGMs|PGM Documentation]].

== Reload File ==

The PGM file can not be reloaded unless the model is stopped. If the model is stopped and the PGM file is changed, the file will automatically be reloaded (once SysCAD is reactivated).

If the file is modified while the model is running then the file will be reloaded when any of the following occur '''after''' the model is stopped:
* the SysCAD application is activated (click anywhere on it) after another application was in use (e.g. Notepad, Excel)
* the user starts another run
* the reload button is pressed

== PGM Execution ==

#When SysCAD starts solving, only PGM code written inside the optional [[Trigger Subroutines]] InitialisePreStart(), PreStart() and InitialiseSolution() will be executed.
#When SysCAD stops, only PGM code written inside the [[Trigger Subroutines]] TerminateSolution() will be executed.
#The remaining PGM code will be executed once every iteration. So if a project was solved for 5 iterations, then the pgm file is executed 5 times.

If the user wishes to keep using the [[Predefined_Constants_and_Variables#OLD Special Constants - to be removed in future builds|OnInitialise() and OnTerminate()]] functions in SysCAD 9.3 (up to {{Removed139|||y}}), then the '''Old135Format''' box on the first Tab of the general controller must be checked, checking this box will use the SysCAD 9.2 PGM execution logic.
:[[image:old135format.png]]

NOTES:
#Ticking the '''Old135Format''' affects how the PGM is executed, and prevents the use of the new [[Trigger Subroutines]].
#Ticking the '''Old135Format''' does NOT affect other PGM functions and PGM features (implemented in SysCAD 9.3) such as [[Data Types|DropList]], [[Tag Functions|[] for GetTag]], etc.
#The '''Old135Format''' and '''OnInitialise()''' and '''OnTerminate()''' functions will be removed in future updates. We strongly recommend users convert any use of these to the [[Trigger Subroutines]].

== Set Tag Validation ==

"BulkSetTagsValidation" controls behaviour for validating tags individually or as a group when setting tags that are defined in a PGM file from a General Controller. {{Available139|}}
:[[image:bulkvalidation.png]]
*Data validation is required on many model inputs, and in some cases on a group of dependent input tags. For example, in models where the sum of all values must add up to 100, such as [[Feeder-Cross_Page_Connector#DSp_Tab_Page|DSp Tab]] in [[Feeder-Cross Page Connector|Feeder]], Size Distribution tabs in various models, and so on.
*If this option is not enabled, then data validation will be called after each tag is set. This is equivalent to a user manually entering a single value in the Access window and pressing the OK button.

'''NOTE''': 
When using the BulkSetTagsValidation option to define ''feeder compositions'', all specified values must use the same basis, either mass or mole and same phase when using fractions.
*For example, the phase total cannot be specified on a mass fraction basis while individual species are specified on a mole fraction basis. All tags defined for a given feeder must use a consistent basis.
*If mixed basis values are detected, the basis of the first tag that is set will be used to perform all calculations when validations are applied.
*{{Available139|37076}} When a mix of basis or phases is detected, error messages will be displayed in the message window to warn the user of the conflict and the specified value is ignored when trying to set the tag. The user must then edit the PGM file to ensure that all tags for the same feeder use a consistent basis.

== Data Sections ==

The default sections and variable names are described in detail in the following tables. The default General Controller access window consists of one section. The user may set up variables in the pgm code that will be shown on the access window. The number of sections in the access window will depend on the number of variables chosen,

# '''[[#General Controller Page|GControl]]''' tab - Contains general information relating to the unit.
# Any watched variables will be added to "default data tabs" (e.g. D1 for data, M1 or matrix and so on) or user defined tabs (if pagelabel is used within the PGM file).
# '''[[Common Data Sections#Common Data on Info Tab Page|Info]]''' tab - Contains general settings for the unit and allows the user to include documentation about the unit and create Hyperlinks to external documents.

=== General Controller Page ===
'''Unit Type: GControl''' - The first tab page in the access window will have this name.
{| border="1" cellspacing="0" cellpadding="5"
|Width=10%|'''Tag (Long/Short)'''|| Width=10%|'''Input / Calc'''||Width=80%|'''Description'''
|-
{{Common Data on First Tab Page}}
|-
| colspan="3" font style="background: #ebebeb" | '''''Requirements'''''
|-
|On ||Check Box || The user may enable or disable the general controller using this box.
|-
|Old135Format ||Check Box || Older pgm using [[Predefined_Constants_and_Variables#OLD Special Constants - to be removed in future builds|OnInitialise() and OnTerminate()]] predefined constants can still be loaded by checking this box. If this box is unchecked, and the pgm file contains OnInitialise() or OnTerminate(), then the PGM will failed to load.
*We recommend changing the use of OnInitialise() or OnTerminate() to [[Trigger Subroutines]] as this feature will be removed in future updates.
*'''NOTE:''': Please see [[General_Controller#PGM_Execution_SysCAD_9.2_vs_SysCAD_9.3|PGM Execution]] for more information..
|-
|BulkSetTagsValidation / BulkValidation || Tickbox || {{Available139}} This option is on by default. Performs Set Tag validation as groups (model based). See [[General_Controller#Set_Tag_Validation_in_Build139|Set Tag Validation]]
|-
| valign="top" |FileName || valign="top" |Input || The user types in the name of the pgm file required for control. The file can be entered in any text editor, and must have the file extension 'pgm'. The user need not always type in the full path of the file. SysCAD will first attempt to locate the file in the project folder, then in the cfgfiles folder. If the file is in neither of these folders, then the user should include the path of the file. If the unit cannot locate the file, it will alarm and send an error message to the 'State' box - NO PROGRAM. The easiest way to load in the pgm file is to use the '''Browse PGM''' button.
|-
|Folder || font style="background: #ebebeb" |Feed Back || The full path/folder of the pgm file is displayed here.
|-
|rowspan="4" valign="top"| FileState ||font style="background: #ebebeb" valign="top"| OK || File is found and has no errors.
|-
|font style="background: #ebebeb" valign="top"| Not Specified || The user has not specified a file.
|-
|font style="background: #ebebeb" valign="top"| Not Found || The specified file can not be found.
|-
|font style="background: #ebebeb" valign="top"| Load Error || There is an error in the file. The State and Message (MSG) fields will provide further information.
|-
| valign="top" |State || font style="background: #ebebeb" valign="top" |Output ||The state of the PGM file once a load has been attempted. If everything is correct and operating normally, the user will see 'OK' in this box. Otherwise the unit will flag an error message which helps the user to locate the problem with the controller. These messages are also displayed in the message window.
|-
| colspan="3" font style="background: #ebebeb" |'''''Errors:'''''
|-
| MSG_1 to MSG_4 || font style="background: #ebebeb" |Output ||These message lines are used to report PGM compile errors or errors while the PGM code is executing.
|-
| colspan="3" font style="background: #ebebeb" |  
|-
|Edit || font style="background: #ebebeb" |Edit PGM || This allows the user to edit the specified PGM file, normally using the Notepad text editor.
|-
|Reload|| font style="background: #ebebeb" |Reload PGM ||This reloads and recompiles the PGM code. Use this after changes to the PGM code have been made and saved. This is not necessary if the AutoReLoad check box is ticked.
|-
|Browse|| font style="background: #ebebeb" |Browse PGM ||This is used to locate a PGM file.
|-
|RuntimeDebug || font style="background: #ebebeb" |Enable Debug / Disable Debug || {{Available139|32530}} This feature toggles the PGM Runtime Debug mode on or off for the General controller. To locate where runtime errors (like divide by zero) occur in the code, click the ‘Enable Debug’ button. This action will reload the PGM, examine the code for potential division by zero errors, and store line numbers that could potentially cause such an error. This information is then used to report any runtime errors in the message window. Please note that at the next project load, any models in RuntimeDebug mode will revert to normal operation.
|-
|Concealed || font style="background: #ebebeb" |Show Concealed / Hide Concealed||This toggles the show/hide concealed variables in the PGM file.
|-
| ResetConcealed|| font style="background: #ebebeb" |Reset Concealed||This resets the concealed tag status, use this button when concealed tag status has been modified in the PGM file.
|-
|ZeroAllVars|| font style="background: #ebebeb" |Zero All Variables||Resets ALL variables to zero value and strings to empty.
|-
|ZeroVars|| font style="background: #ebebeb" |Zero Variables||Resets all result and internal variables to zero value and strings to empty. User input fields are left unchanged.
|-
|InitVars|| font style="background: #ebebeb" |Init Variables||{{Available139|33127}} Reset all variables to the user defined initial values. That is variables that have been declared with an Init value in the PGM code. A count of the number of controller variable tags with Init values is shown in comment on RHS of the button.
|-
| colspan="3" font style="background: #ebebeb" |  
|-
|EditMainPGM|| font style="background: #ebebeb" |Button||This is used to edit the main PGM file. The PGM file name will be displayed on the button.
|-
| Edit include x|| font style="background: #ebebeb" |Button||This is used to edit the include file. Each include file will have a separate button. The include file name will be displayed on the button.
|-
| NewInclude ||Input||The user types in the name of the include file required to assist with control. The file can be entered in any text editor, and must have the file extension 'pgm'. The user need not always type in the full path of the file. SysCAD will first attempt to locate the file in the project folder, then in the cfgfiles folder. If the file is in neither of these folders, then the user should include the path of the file. If the unit cannot locate the file, it will alarm and send an error message to the 'State' box - NO PROGRAM.
|-
| colspan="3" font style="background: #ebebeb" |'''TagList...'''
|-
| Inputs || Copy To Clipboard || Generates a list of all the writeable variables in the PGM (from the Watch Variable Pages). A context menu of options is given to allow selection of different groups of tags with or without conversions. Useful for reports.
|-
| Results|| Copy To Clipboard || Generates a list of all the read only variables in the PGM (from the Watch Variable Pages). A context menu of options is given to allow selection of different groups of tags with or without conversions. Useful for reports.
|-
| All || Copy To Clipboard || Generates a list of all the variables in the PGM (from the Watch Variable Pages). A context menu of options is given to allow selection of different groups of tags with or without conversions. Useful for reports.
|-
| colspan="3" font style="background: #ebebeb" |'''Global Settings'''
|-
| ExecuteTimeout || Input || This is the maximum time SysCAD will spend evaluating/executing the PGM code for one step. It is designed to prevent logic that causes an endless loop from freezing SysCAD. If a timeout error occurs, you should review the PGM logic. This a global option which applies to all general controllers. Also available in [[Plant Model - FlwSolve]] Tab.
|-
| StopForPGMFileError || Tick Box|| {{Available139|31388}} Prevents project from running if there is a PGM file missing or fails to load. This a global option which applies to all general controllers. Also available in [[Solver Setting - FS Solver|Solver Settings]]. Will not be applied if General Controller is not ''On''.
|-
|Track.DivideZeroByZero / Track.DivZeroByZero || Tick Box || {{Available139|32139}} This is used for tracking the special case of zero divide by zero (0/0). If this box is not ticked, then runtime warnings are not reported while running PGM code, the result is 0 (as before). This tick box does not apply to the normal division by zero cases, the "some value/0" cases will always return a runtime warning.
|}

=== Watched Variables Page(s) ===
{| border="1" cellspacing="0" cellpadding="5"
|Width=10%|'''Tag '''|| Width=10%|'''Input / Calc'''||Width=80%|'''Description'''
|-
| colspan="3" font style="background: #ebebeb" |
*If PageLabel() is used in the PGM code, then each page label will be displayed in a new Tab.
*If no PageLabel() is defined, then the default Tab will be '''D1''';
*If the PGM file uses of user defined [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|Classes]] with the '''ClassAsPageLabel()''' defined, then each class instance declared will be displayed on a new tab page.
|-
|Watched Variables||Variable||Any variables that the user specifies as 'watched' will be shown on one or more tab pages. This may include calculated variables, which may not be changed by the user, or variables that the user may change during execution of the program.
|}

=== TagRefs Page ===

{| border="1" cellspacing="0" cellpadding="5"
|Width=10%|'''Tag '''|| Width=10%|'''Input / Calc'''||Width=80%|'''Description'''
|-
| colspan="3" font style="background: #ebebeb" | TagRefs....
|-
| colspan="3" font style="background: #ebebeb" | ''Tag References''
|-
|ClearDuringInit || Tickbox || If this is selected, the Reference Unit Tags will be cleared during initialisation.
|-
|TagCount|| font style="background: #ebebeb" |Feedback|| The number of tags referenced in the PGM code.
|-
|UnitCount|| font style="background: #ebebeb" |Feedback || The number of unit models referenced in the PGM code.
|-
|Clear|| Clear || If this is selected, the Reference Unit Tags will be cleared during initialisation.
|-
|TryFixTags|| Change Old Tags || If the PGM code was written in an earlier build, where some of the SysCAD variable names may be different, using this button may fix the PGM code. If the PGM code was changed, SysCAD will generate a message in the message window as well as the bottom of the PGM file. Please see [[SysCAD 9.3 Tag Changes]] for more information. '''Note:''' This method uses a tag list based on the PGM code when loaded.
|-
|TryFixTags2|| Change Old Tags || If the PGM code was written in an earlier build, where some of the SysCAD variable names may be different, using this button may fix the PGM code. If the PGM code was changed, SysCAD will generate a message in the message window as well as the bottom of the PGM file. Please see [[SysCAD 9.3 Tag Changes]] for more information. '''Note:''' This method uses a tag list based on the PGM code when solved. Therefore, this button will be greyed out before the project has been solved at least once after load.
|-
|TagList|| Copy To Clipboard|| Generates a list of SysCAD Variable tags used in the PGM code. This includes both get tag and set tags.
<syntaxhighlight>
Plant_Feed.QmReqd
P815_.Qo.Qm
P814_.Qo.Qm
P800.Qo.Qm
P1050.Qo.Qm
H2SO4_Source.Total.Qm
Air_Source.Total.Qm
P101.Qo.QEl.Ni
P408.Qo.QEl.Ni
P101.Qo.QEl.Cu
P304.Qo.QEl.Cu
P612.Qo.QEl.Cu
</syntaxhighlight>
|-
| colspan="3" font style="background: #ebebeb" | Reference Unit Tags
|-
|UnitTagxxx || font style="background: #ebebeb" |Feedback || The unit tag name(s) referenced by the PGM code.
|-
|UnitsTagList|| Copy To Clipboard || Generates a list of SysCAD Unit tags used in the PGM code. This includes both get tag and set tags.
For example:
<syntaxhighlight>
Plant_Feed
P815_
P814_
P800
P1050
H2SO4_Source
Air_Source
P101
P408
P304
P612
</syntaxhighlight>
|-
|UnitTags|| Find || Opens Find dialog with the list of Unit tags from UnitsTagList selected. Not shown before first solve or if no tags referenced in the model.
|-
|}

== Adding this Model to a Project ==

{{Adding Model to a Project | DllName=Control1 | DllSubGroup=Control | UnitOp=General | Group=General}}

== Hints and Comments ==

# If the pgm file contains a tag that is invalid, SysCAD will not begin execution, but will flag that user that there is an error in the pgm. Check the Messages window for a list of the invalid tags.
# If the user edits the pgm file, loads it using the 'Reload' button, but does not see the expected changes, it may be that the pgm file has not been saved before reloading.
# If there is more than one copy of the pgm file in various folders, it is always a good idea to open the file using the 'Edit' button on the access window. This will ensure that you are editing the file that the unit is accessing.
# It is always a good idea to pause or stop the SysCAD execution before reloading a pgm file into the general controller. This is because if there is an error in the file, the unit will cease all control functions, which may cause problems in the project.

Please see [[Example PGM Files]] for some sample PGM files.

Build 139 Revision History

2026-04-09T04:01:20Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37069===
:''Released 18 December 2025
* Bug fixes:
** Fix edge case in [[Reverse Osmosis (RO) Unit]] when changing model to Simple and previous EffMethod was ImpurityFrac (it incorrectly used a setting from previous EffMethod).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.1.0 version 2.1.0], which includes the addition of a dynamic AG/SAG mill model.
* [[Excel Reports]]:
** New Excel reporting [[Excel_Get_Tag_Reports#Report_Keyword_Syntax|keyword option]] (for TagList, TagTable, etc.) "Inactive:value" to display values for inactive result tags.
** Improved feedback messages when Excel reports don't have report names.
** Excel ReportName is now optional for [[Excel_Set_Tag_Reports#SysCAD_Set_Tag_Report_in_a_Single_Row_or_Column|SetTagList]].
* General Improvements:
** Fix for [[Access_Window#Right_click_on_the_Access_Window_tab_page_names|Right Click on tab name in Access Window]] not always bring up the correct context menu including options to copy the tag for the tab page.
** Improved error messaging for managing connected tags for a [[Feeder]].
** After a [[Copy and Paste Graphics Commands|graphics Cut & Paste]], the unit counts for each graphics flowshhet shown in [[Explorer Window]] are now correct.
* [[TCE]] Improvements:
** Fix for Plotter when changing between mole and mass based Species adjustment, now retains the value when changing.
** Fix for TCE unit model references to the ChemModelCfg used when an unused TCEModelCfg unit is deleted.
* Example Projects:
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics - Dynamic Grinding Example]] with a new flowsheet page for a circuit including the new SAG mill.

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|Basefiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated Basefiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Reaction Block - Extents

2026-03-19T04:19:07Z

Keith.Armstrong: /* Equilibrium (RB & CRB) */

[[Category:Sub-Models]] [[Category:Reactions]]
{{Navigation|[[Models]]|[[Models#Sub-Models|Sub-Models]]|[[Reaction Block (RB)]]|altname=Extents}}
{{Reactions Head Tabs |currentpage=5}}
----
{{TOC|x=22%}}
= Introduction =

There are a number of methods for expressing the extent of a reaction in a Reaction Block. Some of these methods are valid for both Steady State and Dynamic reaction blocks, and some will only be valid in one or the other:
* The term '''RB''', or Reaction Block, is used for steady state projects or in units with no content in Dynamic projects.
* The term '''CRB''', or Content Reaction Block, is used in units with content in Dynamic modelling.
* If the heading has '''RB''' and '''CRB''' then the method is valid for both types of reaction block, otherwise it is only valid for the type stated.

The image below is from the [[Reaction Editor]]:
:[[Image: RB Extents.png]]
:[[Image: Button Small 1.png]] The Reaction Direction is discussed here as this is important for the various extent types that can be specified.
:[[Image: Button Small 2.png]] Choose the Extent type from the drop down list. These will be explained in detail below.
:[[Image: Button Small 3.png]] For Extent type Fraction Reacted, select the required extent in the Value box. Please note that this value can also be set from the Access Window as this is a "White" Field.
:::[[Image: RB Extents intro3.png]]
:[[Image: Button Small 4.png]] For Extent type Fraction Reacted, select the extent species from the dropdown list

NOTE:
*Different Extent Types have different number of input selections, please see [[#Summary of the Extent Types|Summary of the Extent Types]] for more information.

== Reaction Directions ==

'''-> Forward Reaction'''

Use this for forward only reactions, particularly used for simultaneous reactions. This also works well when the reaction extent is expressed using the Fraction method.

''' <-> or = Reversible Reaction'''

The reaction can proceed either way. This is recommended when using the following extent types:
* Final Concentration
* Final Fraction
* Final Flow
* Mass or Molar Ratio
* Equilibrium

If a reversible reaction is not defined for these types of extents then the requirement may not be met as the reaction can only proceed in one direction.

= Specifying Reaction Extent =

== Summary of the Extent Types ==

{|class=wikitable
|-
!Extent Type Drop List || Extent Type || RB || CRB || Input Fields Example
|-
|rowspan=16 Valign=top|[[Image: RB Extents type list.png]]
| [[#Fraction_.28RB.29|Fraction Reacted]] || Yes || {{Font color|purple|No}} || [[image:RxnExtent_FracReacted.png|link=]]
|-
| [[#Amount Reacted (RB & CRB)|Amount Reacted]] || Yes || Yes || [[image:RxnExtent_AmountReacted.png|link=]]
|-
| [[#Ratio (RB & CRB)|Ratio]] || Yes || Yes || [[image:RxnExtent_Ratio.png|link=]]
|-
| [[#Equilibrium (RB & CRB)|Equilibrium]] || Yes || Yes || [[image:RxnExtent_EqK.png|link=]]
|-
| [[#Final_Concentration_.28RB_.26_CRB.29|Final Conc]] || Yes || Yes || [[image:finalconc.png|link=]]
|-
| [[#Final_Concentration_based_on_Individual_Phase_.28RB_.26_CRB.29|Final Conc (IPhase)]] || Yes || Yes || [[image:finalconc_indP.png|link=]]
|-
| [[#Final_Fraction_.28RB_.26_CRB.29|Final Frac]] || Yes || Yes || [[image:RxnExtent_FinalFrac.png|link=]]
|-
| [[#Final Flow (RB only)|Final Flow]] || Yes || {{Font color|purple|No}} || [[image:RxnExtent_FinalFlow.png|link=]]
|-
| [[#Final_Elemental_Concentration_.28RB_.26_CRB.29|Final Elem Conc]] || Yes || Yes || [[image:finalElemconc.png|link=]]
|-
| [[#Final Elemental Concentration based on Individual Phase (RB & CRB)|Final Elem Conc (IPhase)]] || Yes || Yes || [[image:finalElemconc_indP.png|link=]]
|-
| [[#Final Elemental Fraction (RB & CRB)|Final Elem Frac]] || Yes || Yes || [[image:FinalElemFrac.png|link=]]
|-
| [[#User Defined Properties (User Calc) (RB and CRB)|User Calc]] || Yes || Yes || [[image:RxnExtent_UserCalc.png|link=]]
|-
| [[#User Defined Species Calculation (Sp Calc) (RB and CRB)|Sp Calc]] || Yes || Yes || [[image:RxnExtent_SpCalc.png|link=]]
|-
| [[#Species Model Properties (Sp Model Prop) (RB and CRB)|Sp Model Prop]] || Yes || Yes || [[image:RxnExtent_SpModelCalc.png|link=]]
|-
| [[#Dynamic Fraction (CRB)|Dynamic Fraction]] || {{Font color|purple|No}}|| Yes || [[image:RxnExtent_DynFrac.png|link=]]
|-
| [[#Dynamic Rate (CRB)|Dynamic Rate]]|| {{Font color|purple|No}} || Yes ||[[image:RxnExtent_DynRate.png|link=]]
|}

== Reaction Extent : by Fraction ==

=== Fraction (RB) ===

The user specifies the fraction of one of the reactants that must react. This fraction of the specified reactant will react provided there are sufficient quantities of all other reactants.

'''Notes:'''
# If the reaction does NOT proceed to the required fraction, this will always be caused by a lack of one of the other reactants or user specified limit (see point 4 below).
# Reactions using this extent type can be reversible if the user specifies = or <-> in the reaction file. This means that the user may specify a NEGATIVE fractional extent of reaction and this will not cause an error.
# If the user never wants the reaction to proceed in a negative direction then they must specify a forward only reaction, ->.
# User may specify a limit for the reaction extent to avoid fully reacting a species. (This option is switched on from RB Tab - under Settings - LimitFractionReacted, when switched on, extra limit fields will be visible for each individual reactions.)

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a fraction of 0.5 for H2SO4(aq).
: [[image:RxnExtent_FracReacted.png]]
: If there is sufficient NaOH(aq), 50% of the H2SO4(aq) will react.

=== Final Fraction (RB & CRB) ===

The user specifies a mass or mole fraction of a particular species required at the reaction. The reaction will proceed as required to achieve this fraction provided there are sufficient quantities of all other species.
* The species can be either a reactant or a product.
* The fraction can be specified as a fraction of all material of the same Phase (by Phase), of the same individual Phase (by IPhase), or of all material (by Total).

'''Notes:'''
# The fraction specified will be achieved at the actual reaction, NOT the fraction in the product from the reaction block.
#: Therefore, reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the fraction in the final product. Thus it is advised to only use one of these extent types in each reaction block.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final fraction, provided there are sufficient quantities of all other species. If the user specifies a forward only (->) reaction, then the final fraction may not be achieved.
# It is not advised to have more than one reaction with this extent type in a set of simultaneous reactions. This may lead to situations which have no solution or multiple solutions and may also reduce the speed of convergence.
# User may specify a limit for the reaction extent to avoid fully reacting a species. (This option is switched on from RB Tab - under Settings - LimitFractionReacted, when switched on, extra limit fields will be visible for each individual reactions.) This limit may affect the actual extent achieved.

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a Final Mass Fraction of Na2SO4(s) of 0.1 by Phase.
:[[image:RxnExtent_FinalFrac.png]]
: If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final mass fraction of 10% of Na2SO4(s) in the Solid phase.

=== Final Elemental Fraction (RB & CRB) ===

{{Available139|32925}}

The user specifies a mass or mole fraction of a particular element required at the reaction. The reaction will proceed as required to achieve this fraction provided there are sufficient quantities of all other species.
* The element must be involved in the reaction.
* The fraction can be specified as a fraction of a chosen phase or individual phase (IPhase), e.g. Liquid (Entire Phase) or Aqueous.

'''Notes:'''
# The fraction specified will be achieved at the actual reaction, NOT the fraction in the product from the reaction block.
#: Therefore, reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the fraction in the final product. Thus it is advised to only use one of these extent types in each reaction block.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final fraction, provided there are sufficient quantities of all other species. If the user specifies a forward only (->) reaction, then the final fraction may not be achieved.
# It is not advised to have more than one reaction with this extent type in a set of simultaneous reactions. This may lead to situations which have no solution or multiple solutions and may also reduce the speed of convergence.
# User may specify a limit for the reaction extent to avoid fully reacting a species. (This option is switched on from RB Tab - under Settings - LimitFractionReacted, when switched on, extra limit fields will be visible for each individual reactions.) This limit may affect the actual extent achieved.
# It is possible to choose Total (All Phases) even though the final fraction of an element is independent of any reactions that take place. In order for this to work, there needs to be a source or sink which can adjust the total elemental flow.

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a Final Mass Fraction of elemental sulphur of 5% in the Liquid entire phase.
:[[image:FinalElemFrac.png|link=]]
: If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve the final fraction.

== Reaction Extent : by Concentration ==

=== Final Concentration (RB & CRB) ===
The user specifies the concentration of a particular species required at the reaction. The reaction will proceed as required to achieve this concentration provided there are sufficient quantities of all other species.
* The species can be either a reactant or a product.
* The concentration is specified in grams (or mole) of the species per litre of material of liquid phase.
* The user can optionally specify a temperature (in °C) at which the concentration is to be calculated. If no temperature is specified, then the default is the product temperature.

'''Notes:'''
# The concentration specified will be achieved at the actual reaction, NOT the concentration in the product from the reaction block.
#*Therefore, reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the concentration achieved. Thus it is advised to only use one of these extent types in each reaction block.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final concentration, provided there are sufficient quantities of all other species.
# If the user specifies a forward only (->) reaction, then the final concentration may not be achieved.
# It is not advised to have more than one reaction with this extent type in a set of simultaneous reactions. This may lead to situations which have no solution or multiple solutions and may also reduce the speed of convergence.

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a final concentration of 5.5g/L of H2SO4(aq) at 25°C.
::[[image:finalconc.png]]
: If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final concentration of 5.5 grams of H2SO4(aq)/Litre of Liquid at 25 °C.

=== Final Concentration based on Individual Phase (RB & CRB) ===
The user specifies the mass or mole of a particular species per required individual phase for the reaction. The reaction will proceed as required to achieve this concentration provided there are sufficient quantities of all other species.
* The species can be either a reactant or a product.
* The concentration is specified in grams or mole of the species per litre of material of specified individual phase.
* The user can optionally specify a temperature (in °C) at which the concentration is to be calculated. If no temperature is specified, then the default is the product temperature.

'''Notes:'''
# The concentration specified will be achieved at the actual reaction, NOT the concentration in the product from the reaction block.
#*Therefore, reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the concentration achieved. Thus it is advised to only use one of these extent types in each reaction block.
# The aqueous phase (aq) includes water (defined as H2O(l)). The liquid phase (l) excludes water (defined as H2O(l)). So please take care when selecting the individual phase from the list. See example below.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final concentration, provided there are sufficient quantities of all other species.
# If the user specifies a forward only (->) reaction, then the final concentration may not be achieved.
# It is not advised to have more than one reaction with this extent type in a set of simultaneous reactions. This may lead to situations which have no solution or multiple solutions and may also reduce the speed of convergence.

''' Example '''
#For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a final concentration of 5.5g/L of H2SO4(aq) in aq at 25°C.
#:[[image:finalconc_indP.png]]
#*If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final concentration of 5.5 grams of H2SO4(aq)/Litre of aqueous phase (including water) at 25 °C.
#For the reaction FeO(s) = FeO(sl), the user specifies a final concentration of 1 g/L FeO(sl) in slag at 25°C.
#*If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final concentration of 1 grams of FeO in the slag phase /Litre of slag species at 25 °C.

=== Final Elemental Concentration (RB & CRB) ===
The user specifies the mass or mole of a particular element in a required individual phase per Liquid phase for the reaction. The reaction will proceed as required to achieve this concentration provided there are sufficient quantities of all other species.
* The element must be involved in the reaction.
* The concentration is specified in grams (or mole) of the element in a required individual phase per litre of material of liquid phase.
* The user can optionally specify a temperature (in °C) at which the concentration is to be calculated. If no temperature is specified, then the default is the product temperature.

'''Notes:'''
# The concentration specified will be achieved at the actual reaction, NOT the concentration in the product from the reaction block.
#*Therefore, reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the concentration achieved. Thus it is advised to only use one of these extent types in each reaction block.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final concentration, provided there are sufficient quantities of all other species.
# If the user specifies a forward only (->) reaction, then the final concentration may not be achieved.
# It is not advised to have more than one reaction with this extent type in a set of simultaneous reactions. This may lead to situations which have no solution or multiple solutions and may also reduce the speed of convergence.

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a final concentration of 1 g/L of S(aq) at 25°C.
::[[image:finalElemconc.png]]
: If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final elemental concentration of 1 grams of S in aqueous phase /Litre of Liquid at 25 °C.

=== Final Elemental Concentration based on Individual Phase (RB & CRB) ===
The user specifies the mass or mole of a Element in a required phase per required individual phase for the reaction. The reaction will proceed as required to achieve this concentration provided there are sufficient quantities of all other species.
* The element must be involved in the reaction.
* The concentration is specified in gram or mole of the element of the chosen phase per litre of material of specified individual phase.
* The user can optionally specify a temperature (in °C) at which the concentration is to be calculated. If no temperature is specified, then the default is the product temperature.

'''Notes:'''
# The concentration specified will be achieved at the actual reaction, NOT the concentration in the product from the reaction block.
#*Therefore, reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the concentration achieved. Thus it is advised to only use one of these extent types in each reaction block.
# The aqueous phase (aq) includes water (defined as H2O(l)). The liquid phase (l) excludes water (defined as H2O(l)). So please take care when selecting the individual phase from the list. See example below.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final concentration, provided there are sufficient quantities of all other species.
# If the user specifies a forward only (->) reaction, then the final concentration may not be achieved.
# It is not advised to have more than one reaction with this extent type in a set of simultaneous reactions. This may lead to situations which have no solution or multiple solutions and may also reduce the speed of convergence.

''' Example '''
#For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a final concentration of 1 g/L of S(aq) in aq phase at 25°C.
#:[[image:finalElemconc_indP.png]]
#*If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final concentration of 1 grams of elemental sulphur in aqueous phase /Litre of aqueous species (including water) at 25 °C.
#For the reaction FeO(s) = FeO(sl), the user specifies a final concentration of 1 g/L Fe(sl) in slag at 25°C.
#*If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final concentration of 1 grams of elemental Fe in the slag phase /Litre of slag species at 25 °C.

== Reaction Extent : by Flow ==

=== Amount Reacted (RB & CRB) ===
The user specifies the mass or mole flow of one of the reactants that must react. The required flow of the specified reactant will react provided there are sufficient quantities of all reactants.

'''Notes:'''
# If the reaction does NOT proceed to the required fraction, this will be caused by a lack of one of the reactants (including the specified reactant).
# Reactions using this extent type cannot be reversible.
# User may specify a limit for the reacting mass/moles. (This option is switched on from RB Tab - under Settings - LimitAmountReacted, when switched on, extra limit fields will be visible for each individual reactions.)

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a mass flow of 5 kg/h for H2SO4(aq).
:[[image:RxnExtent_AmountReacted.png]]
: If there is sufficient NaOH(aq), 5 kg/h of the H2SO4(aq) will react.

=== Final Flow (RB only) ===
The user specifies the mass or mole flow of a particular species required at the end of the reaction step. The reaction will proceed as required to achieve this flow provided there are sufficient quantities of all other species.
* The species can be either a reactant or a product.

'''Notes:'''
# The flow specified will be achieved at the end of the current reaction step, NOT the product from the reaction block.
#: if the specified species is used in multiple reactions, subsequent use of the species after the current reaction step may affect the flow calculated by the reaction.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required final flow, provided there are sufficient quantities of all other species.
# If the user specifies a forward only (->) reaction, then the final flow may not be achieved.
# It is possible to have more than one reaction with this extent type in a reaction block, provided the required species is different and only used once per reaction.
# User may specify a limit for the reacting mass/moles. (This option is switched on from RB Tab - under Settings - LimitAmountReacted, when switched on, extra limit fields will be visible for each individual reactions.)

''' Example '''

: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a final flow of 0.001 kg/h of H2SO4(aq).
:[[image:RxnExtent_FinalFlow.png]]
: If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final flow of 1 g/h of H2SO4(aq).

== Reaction Extent : Other ==

=== Ratio (RB & CRB) ===

The user specifies the required molar or mass ratio of a '''Product''' to a '''Reactant'''. The Ratio = Product/Reactant.

The reaction will proceed as required to achieve this ratio provided there are sufficient quantities of all required species.

'''Notes:'''
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required ratio, provided there are sufficient quantities of all other species. If the user specifies a forward only (->) reaction, then the ratio may not be achieved.
# Reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the ratio achieved. Thus it is advised to only use one of these extent types in each reaction block.

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(aq) + H2O(l), the user specifies a Mass Ratio of H2SO4(aq) : Na2SO4(aq) = 1:20.
: If there are sufficient quantities of the required species then the reaction will proceed (in either direction as the reaction is reversible) in order to achieve a final mass ratio of H2SO4(aq) to Na2SO4(aq) of 1:20, i.e. Na2SO4(aq) = 20 * H2SO4(aq).

[[File:Reaction Extent - Ratio.png]]

=== Equilibrium (RB & CRB) ===

The user specifies the Equilibrium constant (K) for a reaction. For liquid reactions this is Kf, for gaseous reactions this is Kp. The reaction will proceed as required to achieve equilibrium provided there are sufficient quantities of all other species.

Consider a reaction of the form: aA + bB = cC + dD

For liquid reactions:
: <math>K_f = \cfrac{[C]^c [D]^d}{[A]^a [B]^b}</math>
:Where [X] = molar concentration (molarity) of species X in mol/L.
:Solids are not included in the equilibrium equation.
:Water is not included in the equilibrium equation.

For gaseous reactions:
: <math>K_p = \cfrac{(Cpp)^c (Dpp)^d}{(App)^a (Bpp)^b}</math>
:Where Xpp = partial pressure of species X, in kPa.
:Solids are not included in the equilibrium equation.

'''Notes:'''
# Reactions which contain only solid species can not use this extent type.
# Reactions which contain both liquid and gaseous species can not use this extent type.
# Reactions using this extent type are normally reversible, i.e. use = or <-> when specifying the reaction direction. This will allow SysCAD to achieve the required equilibrium, provided there are sufficient quantities of all other species. If the user specifies a forward only (->) reaction, then equilibrium may not be achieved.
# Reactions using this extent type should be the last reaction (or be part of the last reaction sequence) in a reaction block. Otherwise the subsequent reactions may change the equilibrium achieved. Thus it is advised to only use one of these extent types in each reaction block.
# This method is particularly useful for Dynamic simulation. Set the CRB using the “equilibrium” Extent and then use the [[Reaction_Block_Summary#Reaction_Block_Settings|'''LimitAmountReacted''' or '''LimitFractionReacted''']] options to control the rate (kinetics). This is significantly easier and numerically more stable than using an amount reacted per timestep type Extent control.

'''Example:'''
:For the dissociation of CaSO4(s) = Ca2+ + SO42-, the equilibrium constant ~ 2e-5
:[[image:RxnExtent_EqK.png]]

== Reaction Extent : Calculations and Properties ==

=== User Defined Properties (User Calc) (RB and CRB) ===
This requires User calculations - User Properties to be present in the project. The user calculations are defined as part of the project configuration file, please see [[User Property Calculations]] for more information.

If a user property is present, the user may select the required property to control the reaction extent.

If a user property is not present in the project, then <No UserCalcs Available> will be displayed in the selection box of the reaction editor.

'''Notes:'''
# Not all user defined properties can be used for reaction extent, please make sure the user property selected is related to the selected reaction.

''' Example '''
: For the [[Example 25 Gold|Gold Example project]], we can replace the last reaction with User Calc of CuonCarbon_ppm. This way, the reaction extent will be adjusted based on the user calculated ratio or Cu:C.
: [[image:RxnExtent_UserCalc.png]]

=== User Defined Species Calculation (Sp Calc) (RB and CRB) ===
This requires User calculations - User Species Calculation to be present in the project. The user calculations are defined as part of the project configuration file, please see [[Species Calculations]] for more information.

If a user species calculation is present, the user may select the required calculation to control the reaction extent.

If a user species calculation is not present for the project, then <No SpCalcs Available> will be displayed in the selection box of the reaction editor.

'''Notes:'''
# Not all user defined species calculation can be used for reaction extent, please make sure the user calculation selected is related to the selected reaction.

''' Example '''
: For the [[Nickel Copper Project]], we can specify reaction extent in terms of Fe3+ or Fe2+.
:[[image:RxnExtent_SpCalc.png]]

=== Species Model Properties (Sp Model Prop) (RB and CRB) ===
This allows the user to control the reaction extent based on selected species model properties.

''' Examples '''
: For the standard species model, user can use properties such as TSS (total suspended solids), TDS (total dissolved solids) to control the solution impurities.
: For the Alumina species model, user can specify the Gibbsite Dissolution reaction in terms of the A/C:
:[[image:RxnExtent_SpModelCalc.png]]

== Reaction Extent: Dynamic ==

=== Dynamic Rate (CRB) ===

This method can only be used for Dynamic simulation unit operations with content.

The user specifies both a fraction <math>F</math> and a fractional rate <math>r</math> at which one of the reactants will react. The actual fraction of the reactant to be reacted in a given step is the product of the fraction, the fractional rate and the step size (in seconds). This fraction of the specified reactant will react provided there are sufficient quantities of all other reactants.

The reactions are applied to the content of the unit model plus the total new feed delivered for the timestep.

The user may choose to have the rate 'Stabilised' (on by default). This means the rate is a first order response and the fraction reacted is given by: <math>F(1- e^{-r\Delta T})</math>

'''Notes:'''
# Reactions using this extent type can be reversible if the user specifies = or <-> in the reaction file. This means that the user may specify a NEGATIVE fractional extent of reaction and this will not cause an error. If the user does not want to have the reaction proceed in a negative direction then they must specify a forward only reaction, ->.
# The dynamic rate option is only able to be used when the user has chosen for the reactions to occur on the content of the unit. For example turning on reactions in the Content Evaluation Block (CEB) for a Tank.
# The stabilised response is useful for large timesteps, so that the maximum fraction reacted approaches, but never exceeds the value <math>F</math>. This is useful with equilibrium models where the equilibrium value can be calculated from free energy consideration (see example 2 below).

''' Example 1'''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a fraction of 0.1 (i.e. 10%) and a fractional rate of 0.05 (i.e. 5 %/s) for H2SO4(aq).
:[[image:RxnExtent_DynRate.png]]
: If there is sufficient NaOH(aq) then the rate of reaction of H2SO4(aq) will be 0.1 * 0.05 * step size (in seconds).
: A) If the project is running with an step size of 1 second, then the rate of reaction of H2SO4(aq) = 0.1 * 0.05 * 1 = 0.005, or 0.5% per second.
: B) If the project is running with an step size of 1 minute, then the rate of reaction of H2SO4(aq) = 0.1 * 0.05 * 60 = 0.3, or 30% per minute.
: In the example displayed here we have no feed or product streams for the content.
:[[image:RxnExtent_DynRate2.png]]

''' Example 2'''
: Nitrogen Tetraoxide <chem>N2O4</chem> dissociates to Nitrogen Dioxide via the reaction <chem>N2O4 = 2 NO2</chem>

:The equilibrium for this reaction can be calculated from the change in Gibbs Free Energy for the reaction.
:*For the reactants at 40°C, G(N2O4) = -84255, and G(NO2) = -41028, so <math>\Delta G = -84255-2\times(-41028) = -2198</math>.
:*At equilibrium <math> K = e^{-\Delta G/RT} = 0.4298</math>, so at equilibrium we have 52.5% N2O4. and this determines the maximum fraction that can react.

See [[Python_Example_-_CFEM|Constrained Free Energy Minimization]] for more information on this topic.

=== Dynamic Fraction (CRB) ===

This method can only be used for Dynamic simulation unit operations with content.

The user specifies a fraction and a time period in which this fraction of the reactant will react. The time period specified can be larger or smaller than the project step size. If the time period specified is smaller than the project step size, then the fraction reacted in a single step (FracPerStep) will be greater than the fraction specified. If the time period specified is larger than the project step size, then the fraction reacted in a single step (FracPerStep) will be smaller than the fraction specified.

The reactions are applied to the content of the unit model plus the total new feed delivered for the timestep.

The fraction of the reactant to be reacted in a given step is calculated by the following formula:
: <math>(1-r)^n = 1-R</math>
: where
: Smaller Time Period = minimum(Time Period, Step Size)
: Larger Time Period = maximum(Time Period, Step Size)
: n = Larger Time Period / Smaller Time Period
: r = Fractional extent at the smaller time period (=FracForTimePeriod if Time Period < Step Size)
: R = Fractional extent at the larger time period (=FracForTimePeriod if Time Period > Step Size)

The calculated fraction of the specified reactant will react provided there are sufficient quantities of all other reactants.

'''Notes:'''
# Reactions using this extent type can be reversible if the user specifies = or <-> in the reaction file. This means that the user may specify a NEGATIVE fractional extent of reaction and this will not cause an error. If the user does not want to have the reaction proceed in a negative direction then they must specify a forward only reaction, ->.
# The dynamic fraction option is only able to be used when the user has chosen for the reactions to occur on the content of the unit. For example turning on reactions in the Content Evaluation Block (CEB) for a Tank.
# This method is can be useful for setting the equilibrium extent, which could be based on [[Thermodynamic_Calculation_Engines|TCE]] side calculations. To do this, set the fraction to the equilibrium fraction and set the time period equal to the time step of the project. To take account of kinetic effects (may take a long time for equilibrium to be reached) use the [[Reaction_Block_Summary#Reaction_Block_Settings|'''LimitAmountReacted''' or '''LimitFractionReacted''']] options to control the rate.

''' Example '''
: For the reaction H2SO4(aq) + NaOH(aq) = Na2SO4(s) + H2O(l), the user specifies a fraction of 0.1 in a time period of 60 seconds for H2SO4(aq).
:[[image:RxnExtent_DynFrac.png]]
: If there is sufficient NaOH(aq) then
: A) if the project is running with an step size of 1 second, then n = 60/1 = 60, R = 0.1 and hence the rate of reaction of H2SO4(aq) (r) = 0.175% per step.
: B) if the project is running with an step size of 1 hour, then n = 3600/60 = 60, r = 0.1 and hence the rate of reaction of H2SO4(aq) (R) = 99.82% per step.

SDB - Thermo2

2026-03-09T02:12:12Z

Keith.Armstrong: /* Thermo2 Tab */

[[Category:Species]] [[Category:Properties]]
{{Navigation|[[User Guide]]|[[Species Properties ($SDB)]]|altname=Thermo2 Tab}}
{{SDB Header Tabs | currentpage=4}}
----
==Thermo2 Tab==
This tab page displays the following thermodynamic properties of ALL species in the project:
* Entropy (Sf@T)
* Gibbs Free Energy (Gf) - This is equal to <math>H_f - S_f*T</math>.
* Gibbs Energy of Formation (DeltaGf) - <math>\Delta G_f</math> for a species is the difference <math>G_f - \sum G_f(e)</math> where the sum is over the elements forming the species. For example, in electrolysis of water, it represents the theoretical minimum energy to dissociate to the components H2 and O2, at standard conditions 237kJ/mol. Heat must be added to overcome the change in entropy, so in practice the practical limit is 286 kJ/mol, which is the ''standard heat of formation''. DeltaGf for species with a non-zero charge is not calculated and shown as NAN (*).
* Heating Values - This is the energy released if the compound is fully combusted with O2. The higher value is if the product contains liquid water while the lower value is if the product contains steam.
* Entropy at 25°C (S25) - This is independent of the temperature setting at the top. (If the species has missing H25 data in the species database, then it will be marked with <big>*</big> and assumed a S value of 0 at 0°C.)
* The lower (LoT) and upper (HiT) temperature limits for valid Cp data of individual compounds.

[[Image:SDB Thermo2 138.png]]

* The Species Property Data shown here is given for a temperature of 25°C and a pressure of 101.325 kPa.
* The temperature ('''T''') and pressure ('''P''') can be changed to obtain species properties at different conditions.
* Users can choose to display the data in either mass or mole basis. This is done via the '''Mass Basis''' check box, it toggles between the two options.
* [[Image:SpeciesShortButton.png]] and [[Image:SpeciesLongButton.png]]: The '''SpeciesTag''' buttons toggles between the short and long species names.
* [[image:SpeciesConfbutton.png]]: Pressing the [[#Copy_Species_Data_to_clipboard|CopytoClipboard]] button will add selected Properties Data onto the clipboard.
* [[image:SpeciesPropertiesbutton.png]]: The [[Species Properties Reports|Reports]] button allows the user to copy selected data onto the clipboard.
* [[Image:Button - Filter On.png]] and [[Image:Button - Filter Off.png]]: These buttons allow the user to filter the species to display only species that meet certain criteria. See '''[[Species Filter]]''' for details on how the species filter is used.

SDB - Thermo2

2026-03-09T02:06:17Z

Keith.Armstrong: /* Thermo2 Tab */

[[Category:Species]] [[Category:Properties]]
{{Navigation|[[User Guide]]|[[Species Properties ($SDB)]]|altname=Thermo2 Tab}}
{{SDB Header Tabs | currentpage=4}}
----
==Thermo2 Tab==
This tab page displays the following thermodynamic properties of ALL species in the project:
* Entropy (Sf@T)
* Gibbs Free Energy (Gf) - This is equal to <math>H_f - S_f*T</math>.
* Gibbs Energy of Formation (DeltaGf) - <math>\Delta G_f</math> for a species is the difference <math>G_f - \sum G_f(e)</math> where the sum is over the elements forming the species. For example, in electrolysis of water, it represents the theoretical minimum energy to dissociate to the components H2 and O2, at standard conditions 237kJ/mol. Heat must be added to overcome the change in entropy, so in practice the practical limit is 286 kJ/mol, which is the ''standard heat of formation''.
* Heating Values - This is the energy released if the compound is fully combusted with O2. The higher value is if the product contains liquid water while the lower value is if the product contains steam.
* Entropy at 25°C (S25) - This is independent of the temperature setting at the top. (If the species has missing H25 data in the species database, then it will be marked with <big>*</big> and assumed a S value of 0 at 0°C.)
* The lower (LoT) and upper (HiT) temperature limits for valid Cp data of individual compounds.

[[Image:SDB Thermo2 138.png]]

* The Species Property Data shown here is given for a temperature of 25°C and a pressure of 101.325 kPa.
* The temperature ('''T''') and pressure ('''P''') can be changed to obtain species properties at different conditions.
* Users can choose to display the data in either mass or mole basis. This is done via the '''Mass Basis''' check box, it toggles between the two options.
* [[Image:SpeciesShortButton.png]] and [[Image:SpeciesLongButton.png]]: The '''SpeciesTag''' buttons toggles between the short and long species names.
* [[image:SpeciesConfbutton.png]]: Pressing the [[#Copy_Species_Data_to_clipboard|CopytoClipboard]] button will add selected Properties Data onto the clipboard.
* [[image:SpeciesPropertiesbutton.png]]: The [[Species Properties Reports|Reports]] button allows the user to copy selected data onto the clipboard.
* [[Image:Button - Filter On.png]] and [[Image:Button - Filter Off.png]]: These buttons allow the user to filter the species to display only species that meet certain criteria. See '''[[Species Filter]]''' for details on how the species filter is used.

Template:OperatingP

2026-02-26T08:08:03Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
[[DirectLink]] feeds, for example from [[Makeup Block (MU)|Makeup Blocks]], are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Template:OperatingP

2026-02-26T08:05:49Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
DirectLink feeds, for example from [[Makeups]], are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Template:OperatingP

2026-02-26T08:04:53Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
DirectLink feeds, for example from Makeups, are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Template:OperatingP

2026-02-26T08:03:44Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
[[DirectLink]] feeds are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Template:OperatingP

2026-02-26T08:02:41Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
[[DirectLink]] feeds are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Template:OperatingP

2026-02-26T08:02:22Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any). 
[[DirectLink]] feeds are excluded in determining the pressure. 
Typically the specified or calculated OperatingP pressure is also the unit operating pressure and outlet stream pressure, but in some models further changes are made to the pressure.
|-
| valign="top" rowspan="5" | Method
| AutoDetect || If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds. [[DirectLink]] feeds are excluded in determining the pressure.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds. [[DirectLink]] feeds are excluded in determining the pressure.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Template:OperatingP

2026-02-26T07:56:16Z

Keith.Armstrong:

|-
|font style="background: #ebebeb" colspan="3" | '''OperatingP ''' - NOTE: this pressure is applied to the (combined) feed, before sub-models (if any).
|-
| valign="top" rowspan="5" | Method
| AutoDetect|| If there are any liquids AND no vapours present in the feed, outlet streams will take the highest pressure of the feeds. Else (e.g. some vapours present) outlet streams will take the lowest pressure of the feeds. [[DirectLink]] feeds are excluded in determining the pressure.
|-
| LowestFeed || Outlet streams will take the lowest pressure of the feeds. [[DirectLink]] feeds are excluded in determining the pressure.
|-
| HighestFeed || Outlet streams will take the highest pressure of the feeds. [[DirectLink]] feeds are excluded in determining the pressure.
|-
| Atmospheric || Outlet streams will be at Atmospheric Pressure. The atmospheric pressure is calculated by SysCAD based on the user defined elevation (default elevation is at sea level = 101.325 kPa). The elevation can be changed on the [[Plant_Model_-_Environment|Environment tab page]] of the [[Plant Model]].
|-
| RequiredP || Outlet streams will be at the user specified pressure.
|-
| IgnoreLowMassFlow / IgnoreLowQm || Tick Box || This option is only visible if the '''AutoDetect''', '''LowestFeed''' or '''HighestFeed''' methods are chosen. When calculating the outlet pressure and temperature of the tank, SysCAD will ignore the low flow feed streams should this option be selected. The low flow limit is set in the field below.
|-
| LowMassFlowFrac / LowQmFrac || Input || This field is only visible if the '''IgnoreLowQm''' option is selected. This is the amount any stream contributes to the total flow. For example, if the total feed to the tank is 10 kg/s, and this field is set to 1%. Then any feed streams with less than 0.1 kg/s will be ignored in the pressure calculations.
|-
| PressureReqd / P_Reqd || Input || This field is only visible if the '''RequiredP''' method is chosen. This is user specified pressure.
|-
| Result ||font style="background: #ebebeb"| Calc || The actual pressure used for the sum of the feeds which will also be the outlet pressure (unless further model options change the pressure).

Makeup Block (MU)

2026-02-26T07:49:45Z

Keith.Armstrong: /* General Description */

[[Category:Sub-Models]]
{{Navigation|[[Models]]|[[Models#Sub-Models|Sub-Models]]}}
{{Other General Models Header table |currentpage=2 }}
----
{{TOC}}
== General Description ==

By enabling a Makeup (MU) Block within a unit, the user may add flow to the unit in a controlled fashion. There are a number of advantages to using a MU block to add material to a unit:
# The user needs to add and configure only a single [[Makeup Source]] to feed many different units in a project. It has the the added advantage of reporting all the separate makeup streams in one place.
# Since the Source is not connected to the MU with a standard link, there is no need for multiple links to be constructed.
# The user may often be able to avoid using either a PID or General Controller to control the flow addition.
# The MU calculation occurs in place so the unit always has the correct flow at each iteration, or step. In dynamic projects, using a MU instead of controlled flows with associated time step lags can be a significant advantage.
# A MU can be a useful modelling trick in setting up flow in a recirculating loop. [[FAQ_-_Modelling_related_questions#How_can_I_set_the_flow_in_a_closed-loop_circuit? | Setting flow in a loop]].

The Makeup Block (MU) can be added to a number of models, such as the [[Tie]], [[Tank]], [[Feeder-Cross Page Connector]], [[Pipe]] and many [[Models#Mass Separation Models|Mass Separation]] models.

'''Notes:'''
* The MU block gets the flow composition and properties from the [[Makeup Source]], so this unit needs to be inserted, selected, and configured to enable effective use of the MU in a unit.
* As a sub-model the MU is applied in sequence with other sub-models as part of an [[Evaluation Blocks]] (EB). The flow is added to the mixture for the EB when the MU is evaluated. Therefore the [[DirectLink]] flows are excluded in any reporting of feed stream flows such as QFeed for a Tank or Tie. The flow is reported on the [[Links]] tab page.
* The [[DirectLink]] created by a MU sub-model is excluded from any considerations in determining the operating pressure of the unit model, or the pressure of the mixed QFeed. For example, a [[Tie]] with AutoDetect selected for OperatingP.Method will not include the Makeup Source and associated DirectLink pressure when determining OperatingP.Result.

=== Video Links ===

The following videos are part of the Tutorial showing users how to insert and configure a Makeup Block:
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Add and Configure a Makeup Block|Add and Configure a Makeup Block video]]'''
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Optional - Review results from Makeup Block |Review results from Makeup Block video]]'''

== Adding Makeup to a Unit ==

=== Step 1 - Enable Makeup ===

The Makeup Block is enabled in a unit when the user enters an integer between 1 and 8 for the number of Makeups in the unit's access window.

The user may enable more than one Makeup Block per unit, by entering 2, 3, etc. The unit will then have the appropriate number of Tabs: MU1, MU2, MU3, etc. each of which can be configured separatly.

'''Notes:'''
# The Makeup Block is a sub-model which is evaluated sequentially. The user can change the order that the sub-models are solved using the drop down lists on the first tab page - Off, On-AutoSequence, On-Sequence1, On-Sequence2, etc.
# The ''[[Evaluation_Blocks|AutoSequence]]'' option will evaluate the sub-models as follows:
#* 1st - Makeups (MU)
#* 2nd - Reactions (RB)
#* 3rd - Environmental Heat Exchange (EHX)
#* 4th - Evaporation (Evap)
#* 5th - Vapour Liquid Equilibrium (VLE)
#* 6th - Discards (DB)
# For example, a Makeup may be added either before or after a reaction block sub-model.
#* If the Makeup is a reactant then it must be added prior to the reaction block.
#* If the user wants to achieve a final concentration from the unit then the Makeup block should be the last sub-model.
#* '''Due to the sequential nature of the sub-models, Makeups can not be used to achieve a final concentration of a reactant.'''

=== Step 2 - Connect to a Makeup Source ===

The next step is to connect the Makeup Block to a [[Makeup Source]]. Go to the MU tab and select the Makeup Source from a drop down list of available Makeup sources in the project.

Once a valid Makeup Source has been entered into the MakeupSrc field, a graphics symbol for the [[DirectLink]] will be displayed indicating that the unit has additional input. (Note: The user may change the name of this [[DirectLink]] or its graphical symbol in exactly the same way as for any other unit in SysCAD).

=== Step 3 - Configure the Makeup Block ===

The Makeup Block may then be configured as:
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* None
* [[#Fixed Makeup Model|Fixed Makeup]]
* [[#Ratio Makeup Model|Ratio Makeup]]
* [[#Product Flow Makeup Model|Product Flow]]
* [[#Product Composition Makeup Model|Product Composition]]
* [[#Product Concentration Makeup Model|Product Mass Concentration @T]]
* [[#Product Concentration @25 Makeup Model|Product Mass Concentration @25°C]]
* [[#Product Molar Concentration Makeup Model|Product Molar Concentration @T]]
* [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25°C]]
* [[#Product Density Makeup Model|Product Density]]
* [[#Product pH.negLogH Makeup Model|Product pH Estimate]]
* [[#Product User Calc Makeup Model|Product User Calculation]]
* [[#Product SpCalc Makeup Model|Product Species Calculation]]
* [[#Product SpModel Property Makeup Model|Product Species Model Property]]
* [[#Product Temperature Makeup Model|Product Temperature]]
* [[#Temperature Change Makeup Model|Temperature Change]]
</div>
Each of the different options that can be configured are described in the table below.

[[Image:Makeup01.png]]


'''NOTE''':
* When setting up the makeup block, it’s crucial to understand the evaluation order of the MU block. The term “Feed” refers to the material entering the MU block. This means that if the MU block in question is the second evaluation block in the sequence, then the “Feed” for this MU block would be the “Product” from the first evaluation block. Similarly, the term “Product” (as used in the method [[#Product Flow Makeup Model|Product Flow]]) refers to the material exiting the MU block. It’s important to note that this may not be the same as the Discharge product from the process unit if other evaluation blocks are used after the MU block.

==Data Section==

The default access window (MU) and variable names are described in detail in the following tables. These variables change as the user selects the various options that are available. Individual tables are shown for each Makeup Model, except for the [[#Common Requirements - Makeup Limits, Low Feed and Product Temperature|Common Requirements]] and [[#Common Results for All Models|Common Results]] tables that show fields that are common to all methods.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=220|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| DIO...
|-
| MakeupScr || List || Name of the MakeUp Source unit operation - this may be chosen from the drop down list of all MakeUp Sources available in the project.
|-
| DirectLink || font style="background: #ebebeb" | Display || The name of the [[DirectLink]] between the Makeup Source and the unit.
|-
| Connect || font style="background: #ebebeb" |Display || Displays any errors with the connection with MakeUpScr. If there are no errors, then OK is displayed.
|-
| colspan="3" font style="background: #ebebeb" |
=== Requirements ===
|-
| On || Tickbox || Switch Makeup block on or off
|-
|Rowspan=16 valign="top" | Model See [[#Step_3_-_Configure_the_Makeup_Block|NOTE]] || None || No makeup is added to the unit. This is the same as disabling the block.
|-
| [[#Fixed Makeup Model|Fixed Makeup]] || Makeup is added as a fixed amount set by the user (or via a controller). The section on Fixed Makeup has a description of all of the relevant fields.
|-
| [[#Ratio Makeup Model|Ratio Makeup]] || Makeup is added based as a user specified ratio relative to the feed. The ratio may be based on total flows, phases, species or elements. The section on Ratio Makeup has a description of all of the relevant fields.
|-
| [[#Product Flow Makeup Model|Product Flow]] || Makeup is added to achieve a user specified product flow. The required flow can be total flow, flow of phase or species or element. The section on Product Flow has a description of all of the relevant fields.
|-
| [[#Product Composition Makeup Model|Product Composition]] || Makeup is added to achieve a user specified product composition. The section on Product Composition has a description of all of the relevant fields. Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].
|-
| [[#Product Concentration Makeup Model|Product Concentration]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at stream temperature. The section on Product Concentration has a description of all of the relevant fields. Please also see [[ETip: Controlling Concentration using Makeup Blocks]].
|-
| [[#Product Concentration @25 Makeup Model|Product Concentration @25]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at 25°C. The section on Product Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration Makeup Model|Product Molar Concentration]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at stream temperature. The section on Product Molar Concentration has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at 25°C. The section on Product Molar Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Density Makeup Model|Product Density]] || Makeup is added to achieve a user specified product density. The section on Product Density has a description of all of the relevant fields.
|-
| [[#Product pH.negLogH Makeup Model|Product pH.negLogH]] || Makeup is added to achieve a user specified product pH. The section on Product pH has a description of all of the relevant fields. Please note that the pH calculated in SysCAD is an estimate.
|-
| [[#Product_User_Calc_Makeup_Model|Product User Calc]] || Makeup is added to achieve a user specified value of a user calculation. The section on Product User Calc has a description of all of the relevant fields.
|-
| [[#Product_SpCalc_Makeup_Model|Product SpCalc]] || Makeup is added to achieve a user specified value of a species calculation. The section on Product SpCalc has a description of all of the relevant fields.
|-
| [[#Product_SpModel_Property_Makeup_Model|Product SpModel Property]] || Makeup is added to achieve a user specified value of a species model property. The section on Product SpModel Property has a description of all of the relevant fields.
|-
| [[#Product Temperature Makeup Model|Product Temperature]] || Makeup is added to achieve a user specified product temperature. The section on Product Temperature has a description of all of the relevant fields.
|-
| [[#Temperature Change Makeup Model|Temperature Change]] || Makeup is added to achieve a user specified temperature change between the feed and the product. The section on Temperature Change has a description of all of the relevant fields.
|}

=== Fixed Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassFlow || The user specifies the Makeup amount as a mass flowrate.
|-
| VolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at temperature.
|-
| VolumeFlow25 || The user specifies the Makeup amount as a volumetric flowrate at 25°C.
|-
| NVolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at Normal Temperature.
|-
| MoleFlow || The user specifies the Makeup amount as a molar flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The amount of material added is based on the Total makeup stream.
|-
| Phase || The user can select the different phases to be included in the specified amount. For example, if the make up source has 50% solids and 50% liquids, and the user wants to specify a mass flow of 10t/h of solids, then only leave the solids tick box checked and SysCAD will add to the MUx block enough makeup to give 10t/h solids. In this case, a total of 20t/h will be added.
|-
| IndividualPhase || As per Phase, the user is allowed to select the individual phase to be included in the specified amount. For example, if user wants to specify the organic addition - individual phase (or) to be 10t/h then select the (or) individual phase, and the makeup block will add enough to give 10t/h organic.
Note: To do so, user must have defined (or) phase in the species database and the makeup source must contain organics as part of its composition.
|-
| valign="top" | All Species/Species || The user may select individual species to be included in the specified amount.
* Select required species from the list.
* Multiple selections are allowed. Up to 20 species can be selected.
|-
| valign="top" | Solid Species || Only available in Build 138 or later. The user may select individual solid species to be included in the specified amount. Up to 20 solid species can be selected.
|-
| valign="top" | Liquid Species || Only available in Build 138 or later. The user may select individual liquid species to be included in the specified amount. Up to 20 liquid species can be selected.
|-
| valign="top" | Vapour Species || Only available in Build 138 or later. The user may select individual vapour species to be included in the specified amount. Up to 20 vapour species can be selected.
|-
| valign="top" | Component || As per species above. The difference between species and component is that species is phase based, while a component is phase independent. For example, if NaCl is defined in the (aq) and (s) phases, and user wishes to select the solid phase only, then use the '''Species''' option and choose NaCl(s). If user wants to include both phases, then use the '''Component''' option and choose NaCl.
|-
| Element || The user may select individual elements to be included in the specified amount.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected all species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species, component or element. Select the required species, component or element from the list. There will usually be one extra to allow another species, component or element to be added - to a maximum of 20. To remove a species, component or element, choose the “-” option instead of the selected species, component or element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required '''(basis)''' Flow''''': xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl
|-
| Reqd.MakeUp.xx|| Input || User specified Make up amount in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.MakeUp.xx || font style="background: #ebebeb" | Feedback || User specified Make up amount as Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the makeup stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the product stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|}

=== Ratio Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassRatio || The user specifies the ratio on the basis of mass flowrates.
|-
| VolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at temperature.
|-
| Volume25Ratio || The user specifies the ratio on the basis of volumetric flowrates at 25°C.
|-
| NVolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at Normal Temperature.
|-
| MoleRatio || The user specifies the ratio on the basis of mole flowrates.
|-
|colspan=3 font style="background: #ebebeb"| '''''Feed Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Feed flow.
|-
| Phase || The ratio measurement is based on one or more Phases in the Feed.
|-
| IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Feed.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Feed.
|-
| Solid Species || Only available in Build 138 or later. The ratio measurement is based on one or more solid Species in the Feed.
|-
| Liquid Species || Only available in Build 138 or later. The ratio measurement is based on one or more liquid Species in the Feed.
|-
| Vapour Species || Only available in Build 138 or later. The ratio measurement is based on one or more vapour Species in the Feed.
|-
| Component || The ratio measurement is based on one or more Components in the Feed.
|-
| Element || The ratio measurement is based on one or more elements in the Feed.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || The user may select the required Species, Components or Elements from the displayed list. X is the number of the selected species/component/element. As for fixed makeup.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Makeup flow.
|-
|Phase || The ratio measurement is based on one or more Phases in the Makeup flow.
|-
|IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Makeup flow.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Makeup flow.
|-
| Solid Species || Only available in Build 138 or later. The ratio measurement is based on one or more solid Species in the Makeup flow.
|-
| Liquid Species || Only available in Build 138 or later. The ratio measurement is based on one or more liquid Species in the Makeup flow.
|-
| Vapour Species || Only available in Build 138 or later. The ratio measurement is based on one or more vapour Species in the Makeup flow.
|-
| Component || The ratio measurement is based on one or more Components in the Makeup flow.
|-
| Element || The ratio measurement is based on one or more elements in the Makeup flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
|Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Ratio''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.(xx)Ratio || Input || The required Make up Mass/Volume@T/Volume@25°C/NVolume/Mole Ratio as specified by the user in the ''Reqd.Basis'' field.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.xxRatio || font style="background: #ebebeb" | Feedback || User specified Make up ratio as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
| Meas.xxRatio || font style="background: #ebebeb" | Calc || Make up ratio of flowrates achieved as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) Flow ratio of MakeUp[] to Feed[]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Flow Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||MassFlow || The user may specify the required mass product flowrate.
|-
| VolumeFlow || The user may specify the required volumetric product flowrate at temperature.
|-
| VolumeFlow25 || The user may specify the required volumetric product flowrate at 25°C.
|-
| NVolumeFlow || The user may specify the required volumetric product flowrate at Normal Temperature.
|-
| MoleFlow || The user may specify the required molar product flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection || All || The Product measurement includes the full Product flow.
|-
| Phase || The Product measurement includes one or more Phases in the Product flow.
|-
| IndividualPhase || The Product measurement includes one or more Individual Phases in the Product flow.
|-
| All Species/Species || The Product measurement includes one or more Species in the Product flow.
|-
| Solid Species || Only available in Build 138 or later. The Product measurement includes one or more solid Species in the Product flow.
|-
| Liquid Species || Only available in Build 138 or later. The Product measurement includes one or more liquid Species in the Product flow.
|-
| Vapour Species || Only available in Build 138 or later. The Product measurement includes one or more vapour Species in the Product flow.
|-
| Component || The Product measurement includes one or more Components in the Product flow.
|-
| Element || The Product measurement includes one or more Elements in the Product flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (Basis) Flow rate''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xx || Input || User specified Product flowrate in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product flowrate is treated as a minimum target and there will be no warnings if this flowrate is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product flowrate is treated as a maximum target and there will be no warnings if the actual flowrate is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xx || font style="background: #ebebeb" | Display || User specified Product Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Display || Displays the Feed Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the Product stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Composition Makeup Model ===

Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||Mass || The user specifies the product composition by mass fraction
|-
| Volume || The user specifies product composition by volume fraction at product temperature
|-
| Volume25 || The user specifies product composition by volume fraction at 25°C.
|-
| NVolume || The user specifies product composition by volume fraction at Normal Temperature
|-
| Mole || The user specifies product composition by mole fraction
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=8 valign="top" | Selection || Phase || The user may specify the required composition of one or more Phases in the product stream.
|-
| IndividualPhase || The user may specify the required composition of one or more Individual Phases in the product stream.
|-
| All Species/Species || The user may specify the required composition of one or more Species in the product stream.
|-
| Solid Species || Only available in Build 138 or later. The user may specify the required composition of one or more solid Species in the product stream.
|-
| Liquid Species || Only available in Build 138 or later. The user may specify the required composition of one or more liquid Species in the product stream.
|-
| Vapour Species || Only available in Build 138 or later. The user may specify the required composition of one or more vapour Species in the product stream.
|-
| Component || The user may specify the required composition of one or more Components in the product stream.
|-
| Element || The user may specify the required composition of one or more Elements in the product stream.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X|| List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Base Measurement'''''
|-
|Rowspan=3 valign="top" | Selection || All || The user may specify the required composition as a fraction of the Total Product flow.
|-
| Phase || The user may specify the required composition as a fraction of one or more Phases in the product stream, e.g. the fraction of SiO2(s) as a fraction of the Solid phase.
|-
| IndividualPhase || The user may specify the required composition as a fraction of one or more Individual Phases in the product stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Fraction''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xxFrac || Input || The required product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product composition is treated as a minimum target and there will be no warnings if this composition is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product composition is treated as a maximum target and there will be no warnings if the actual composition is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) fraction [component/species/element(phase)]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xxFrac || font style="background: #ebebeb" | Display || User specified Product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Feed.xxFrac || font style="background: #ebebeb" | Display || Displays the Feed stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.MakeUp.xxFrac || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Prod.xxFrac || font style="background: #ebebeb" | Calc || Displays the Product stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|}

=== Product Concentration Makeup Model ===

Please also see [[ETip: Controlling Concentration using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the aqueous (aq) phase.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc || Input || The user specified product concentration (mass per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at product temperature.
|-
| Meas.Feed.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc / Conc25 || Input || The user specified product concentration (mass per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume25[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc / Conc25 || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at 25°C.
|-
| Meas.Feed.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Molar Concentration Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| ''Required Molar Concentration''
|-
| Reqd.Prod.ConcMl / MlConc || Input || The user specified product concentration (moles per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at product temperature.
|-
| Meas.Feed.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Molar Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Molar Concentration'''''
|-
| Reqd.Prod.ConcMl / MlConc25 || Input || The user specified product concentration (moles per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product molar concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product molar concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume25[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at 25°C.
|-
| Meas.Feed.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Density Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Density Measurement'''''
|-
|Rowspan=2 valign="top" | Selection || All || All phases will be used for the product density calculation.
|-
| Phase || The user selects which phases will be used for the product density calculation. For example, if the product may contain gases, then the user may tick only the Solids and Liquids tickboxes to ensure that the vapours are NOT included in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| The following three tick boxes will only be visible if the user has selected 'Phase' for the Selection field.
|-
| Solids || Tick Box|| This must be ticked if the user wishes to include solids in the density calculation.
|-
| Liquids || Tick Box|| This must be ticked if the user wishes to include liquids in the density calculation.
|-
| Vapours || Tick Box|| This must be ticked if the user wishes to include vapours in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Density'''''
|-
| Reqd.Prod.Rho || Input || User specified product density.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product density is treated as a minimum target and there will be no warnings if this density is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product density is treated as a maximum target and there will be no warnings if the actual density is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Rho || font style="background: #ebebeb"| Display || User specified Product density.
|-
| Meas.Feed.Rho || font style="background: #ebebeb"| Calc || Displays density of Feed stream
|-
| Meas.MakeUp.Rho || font style="background: #ebebeb"| Calc || Displays density of Makeup stream
|-
| Meas.Prod.Rho || font style="background: #ebebeb"| Calc || Displays density of Product stream
|}

=== Product pH.negLogH Makeup Model ===

* Please note that the pH is be measured at the point of addition, any acid/base reactions that occur after the Makeup are not considered.
* This feature is demonstrated in the [[Zinc Hydrometallurgical Project]], which is distributed with SysCAD.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required pH'''''
|-
| Reqd.Prod.pH.negLogH || Input || User specified product pH.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product pH is treated as a minimum target and there will be no warnings if the estimated pH is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product pH is treated as a maximum target and there will be no warnings if the estimated pH is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''pH Estimate'''''
|-
| Used.Prod.pH.negLogH || font style="background: #ebebeb"| Display || User specified Product pH.
|-
| Meas.Feed.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Feed stream
|-
| Meas.MakeUp.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Makeup stream
|-
| Meas.Prod.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Product stream
|}

=== Product User Calc Makeup Model ===

* Please note that User Calc (User Property Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#User_Property_Calculations |User property Calculations]] for more information.
* This option is only usable if user defined properties are present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.UserCalc || List || Lists all available user defined properties in the project, if nothing is available, the List box will display "None Defined"
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected user property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''User Calc xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected User property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the feed stream
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the Makeup stream
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the product stream
|}

=== Product SpCalc Makeup Model ===

* Please note that SpCalc (User species Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#Species_Calculations |User Species Calculations]] for more information.
* This option is only usable if user species calculation is present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpCalc || List || Lists all available user defined species calculation in the project, if nothing is available, the List box will display "None Defined"
|-
|rowspan=4 | Reqd.SpBasis || colspan=2 font style="background: #ebebeb"| Allows the user to select the phase basis of the species calculation.
|-
|All || The calculated value will be based on whole stream.
|-
|Phase || The calculated value will be by Phase.
|-
|IndividualPhase || The calculated value will be by Individual Phase.
|-
|Reqd.View || List || Dropdown list of relevant views for chosen calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required ZZZ Value'''''
|-
| Reqd.Prod.YYY.ZZZ || Input || The required value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpCalc ZZZ'''''
|-
| Used.Prod.YYY.ZZZ || font style="background: #ebebeb"| Display || The specified value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Meas.Feed.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the feed stream.
|-
| Meas.MakeUp.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the Makeup stream.
|-
| Meas.Prod.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the product stream.
|}

=== Product SpModel Property Makeup Model ===

* Please note that the species properties that are available in a project will depend on the add-ons used in that project. For example, if the project is using the Alumina add-on, then all of the species properties that are available for the Bayer property model will be available.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpModel || List || Lists all available species models in the project. Many projects will only have 'Standard', but if you have the Alumina add-on, you may also select 'Bayer'.
|-
|Reqd.Property || List || Allows the user to select the species model property that will be used to control the makeup to the unit.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected species model property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpMdlProp xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected species model property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the feed stream.
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the Makeup stream.
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the product stream.
|}

=== Product Temperature Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature'''''
|-
| Reqd.Prod.T || Input || User specified product temperature
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product temperature is treated as a minimum target and there will be no warnings if this temperature is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product temperature is treated as a maximum target and there will be no warnings if the actual temperature is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Temp || font style="background: #ebebeb"| Display || User specified Product temperature
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Product stream
|}

=== Temperature Change Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature Change'''''
|-
| Reqd.Prod.TChg || Input || User specified temperature change (between feed and product)
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.TChg || font style="background: #ebebeb"| Display || User specified temperature change
|-
| Meas.Prod.TChg || font style="background: #ebebeb"| Display || Temperature change achieved (from feed to product temperature)
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of product stream
|}

=== Common Requirements ===

The common requirements include makeup limits, low feed and product temperature.

The following input fields are required for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=10%|Tag (Long/Short) || Width=10%|Input/Calc || Width=80%|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Limits for total Makeup Flow'''''
|-
| MakeUp.QmMin || Input || User specified minimum makeup flow, usually 0. '''Note:''' this is applied to the total makeup stream.
|-
| MakeUp.QmMax || Input || User specified maximum makeup flow - the Makeup block will not add more than this value. '''Note:''' this is applied to the total makeup stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Rule for Low Feed Flow'''''
|-
|Rowspan=3 valign="top" | LowQmRule || AlwaysOn || Always add specified flow of makeup, even if the Feed flow drops to zero.
|-
| StopBelowQmLimit || Do not add any makeup if Feed flowrate is below user specified number.
|-
| StopBelowNoFlow || Do not add any makeup if Feed flowrate is zero.
|-
| LowQmLimit || Input || Only visible if ''StopBelowQmLimit'' is selected. User specified minimum feed flow below which no makeup is added.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Temperature''''' (Not visible if ''Product Temperature'' or ''Temperature Change'' are selected)
|-
|Rowspan=5 valign="top" | Temp.Final || InletTemp || Add or remove heat to make the Product temperature the same as the Feed temperature.
|-
| SourceTemp || Add or remove heat to make the Product temperature the same as the Makeup Source temperature.
|-
| StdTemp || Add or remove heat to make the Product temperature the same as Standard temperature.
|-
| Const || Add or remove heat to make the Product temperature the same as the user specified temperature.
|-
| Mixture || Default behaviour - no heat is added or removed, the Product temperature is determined by an energy balance involving the Feed and the Makeup.
|-
| Temp.Reqd || Input || Only visible if ''Const'' is selected. User specified temperature of the Product stream.
|}

=== Common Results for All Models ===

The following fields are visible for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Description || font style="background: #ebebeb"| Display || Displays a description in words of the makeup options chosen.
|-
| State || font style="background: #ebebeb"| Display || Displays any errors. If there are no errors then displays OK.
|-
|colspan=3 font style="background: #ebebeb"| '''''Total mass flow'''''
|-
| Feed.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of feed stream.
|-
| MakeUp.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of makeup stream.
|-
| Prod.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total volume flow:'''''
|-
| Feed.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of feed stream.
|-
| MakeUp.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of makeup stream.
|-
| Prod.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total heat flow'''''
|-
| Feed.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of feed stream.
|-
| MakeUp.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of makeup stream.
|-
| Prod.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of product stream (including makeup).
|-
| HeatFlow ||font style="background: #ebebeb"| Calc || Displays heat added/removed to achieve product temperature requirements.
|}

== Use in Example Projects ==

The Makeup methods are shown in the following example projects distributed with SysCAD:

''' Fixed Makeup'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Units: ''Ni_Diss_1'' and ''Acid_Addition''
#Smelter Example
#:Project Location: See [[Example_65_Smelting#Copper_Flash_Furnace_Example|Smelter Example]]
#:Unit: ''Electric_Furnace''

''' Ratio Makeup'''

Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''NiCo_Precip''

'''Product Flow'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''

'''Product Composition'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''
#Demo Uranium Project
#:Location: See [[Example 80 Uranium|Demo Uranium Project]]
#:Unit: ''P_13''

'''Product Concentration'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''Ni_Diss_2''

'''pH Control'''

#Demo Zinc Hydrometallurgical Project
#:Project Location: See [[Zinc Hydrometallurgical Project]]
#:Units: All links after acid additions for pH control.

'''User Calc'''
#Demo Gold Project
#:Project Location: See [[Example 25 Gold|Gold Project]]
#:The last reaction in the tanks are using the reaction extent [[Reaction_Block_-_Extents#User_Calculations_-_User_Defined_Properties_.28User_Calc.29|UserCalc]].

Makeup Block (MU)

2026-02-26T06:44:37Z

Keith.Armstrong: /* Step 1 - Enable Makeup */

[[Category:Sub-Models]]
{{Navigation|[[Models]]|[[Models#Sub-Models|Sub-Models]]}}
{{Other General Models Header table |currentpage=2 }}
----
{{TOC}}
== General Description ==

By enabling a Makeup (MU) Block within a unit, the user may add flow to the unit in a controlled fashion. There are a number of advantages to using a MU block to add material to a unit:
# The user needs to add and configure only a single [[Makeup Source]] to feed many different units in a project. It has the the added advantage of reporting all the separate makeup streams in one place.
# Since the Source is not connected to the MU with a standard link, there is no need for multiple links to be constructed.
# The user may often be able to avoid using either a PID or General Controller to control the flow addition.
# The MU calculation occurs in place so the unit always has the correct flow at each iteration, or step. In dynamic projects, using a MU instead of controlled flows with associated time step lags can be a significant advantage.
# A MU can be a useful modelling trick in setting up flow in a recirculating loop. [[FAQ_-_Modelling_related_questions#How_can_I_set_the_flow_in_a_recycle_loop? | Setting flow in a loop]]

The Makeup Block (MU) can be added to a number of models, such as the [[Tie]], [[Tank]], [[Feeder-Cross Page Connector]], [[Pipe]] and many [[Models#Mass Separation Models|Mass Separation]] models.

'''Notes:'''
* The MU block gets the flow composition and properties from the [[Makeup Source]], so this unit needs to be inserted and configured to enable effective use of the MU in a unit.

=== Video Links ===

The following videos are part of the Tutorial showing users how to insert and configure a Makeup Block:
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Add and Configure a Makeup Block|Add and Configure a Makeup Block video]]'''
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Optional - Review results from Makeup Block |Review results from Makeup Block video]]'''

== Adding Makeup to a Unit ==

=== Step 1 - Enable Makeup ===

The Makeup Block is enabled in a unit when the user enters an integer between 1 and 8 for the number of Makeups in the unit's access window.

The user may enable more than one Makeup Block per unit, by entering 2, 3, etc. The unit will then have the appropriate number of Tabs: MU1, MU2, MU3, etc. each of which can be configured separatly.

'''Notes:'''
# The Makeup Block is a sub-model which is evaluated sequentially. The user can change the order that the sub-models are solved using the drop down lists on the first tab page - Off, On-AutoSequence, On-Sequence1, On-Sequence2, etc.
# The ''[[Evaluation_Blocks|AutoSequence]]'' option will evaluate the sub-models as follows:
#* 1st - Makeups (MU)
#* 2nd - Reactions (RB)
#* 3rd - Environmental Heat Exchange (EHX)
#* 4th - Evaporation (Evap)
#* 5th - Vapour Liquid Equilibrium (VLE)
#* 6th - Discards (DB)
# For example, a Makeup may be added either before or after a reaction block sub-model.
#* If the Makeup is a reactant then it must be added prior to the reaction block.
#* If the user wants to achieve a final concentration from the unit then the Makeup block should be the last sub-model.
#* '''Due to the sequential nature of the sub-models, Makeups can not be used to achieve a final concentration of a reactant.'''

=== Step 2 - Connect to a Makeup Source ===

The next step is to connect the Makeup Block to a [[Makeup Source]]. Go to the MU tab and select the Makeup Source from a drop down list of available Makeup sources in the project.

Once a valid Makeup Source has been entered into the MakeupSrc field, a graphics symbol for the [[DirectLink]] will be displayed indicating that the unit has additional input. (Note: The user may change the name of this [[DirectLink]] or its graphical symbol in exactly the same way as for any other unit in SysCAD).

=== Step 3 - Configure the Makeup Block ===

The Makeup Block may then be configured as:
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* None
* [[#Fixed Makeup Model|Fixed Makeup]]
* [[#Ratio Makeup Model|Ratio Makeup]]
* [[#Product Flow Makeup Model|Product Flow]]
* [[#Product Composition Makeup Model|Product Composition]]
* [[#Product Concentration Makeup Model|Product Mass Concentration @T]]
* [[#Product Concentration @25 Makeup Model|Product Mass Concentration @25°C]]
* [[#Product Molar Concentration Makeup Model|Product Molar Concentration @T]]
* [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25°C]]
* [[#Product Density Makeup Model|Product Density]]
* [[#Product pH.negLogH Makeup Model|Product pH Estimate]]
* [[#Product User Calc Makeup Model|Product User Calculation]]
* [[#Product SpCalc Makeup Model|Product Species Calculation]]
* [[#Product SpModel Property Makeup Model|Product Species Model Property]]
* [[#Product Temperature Makeup Model|Product Temperature]]
* [[#Temperature Change Makeup Model|Temperature Change]]
</div>
Each of the different options that can be configured are described in the table below.

[[Image:Makeup01.png]]


'''NOTE''':
* When setting up the makeup block, it’s crucial to understand the evaluation order of the MU block. The term “Feed” refers to the material entering the MU block. This means that if the MU block in question is the second evaluation block in the sequence, then the “Feed” for this MU block would be the “Product” from the first evaluation block. Similarly, the term “Product” (as used in the method [[#Product Flow Makeup Model|Product Flow]]) refers to the material exiting the MU block. It’s important to note that this may not be the same as the Discharge product from the process unit if other evaluation blocks are used after the MU block.

==Data Section==

The default access window (MU) and variable names are described in detail in the following tables. These variables change as the user selects the various options that are available. Individual tables are shown for each Makeup Model, except for the [[#Common Requirements - Makeup Limits, Low Feed and Product Temperature|Common Requirements]] and [[#Common Results for All Models|Common Results]] tables that show fields that are common to all methods.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=220|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| DIO...
|-
| MakeupScr || List || Name of the MakeUp Source unit operation - this may be chosen from the drop down list of all MakeUp Sources available in the project.
|-
| DirectLink || font style="background: #ebebeb" | Display || The name of the [[DirectLink]] between the Makeup Source and the unit.
|-
| Connect || font style="background: #ebebeb" |Display || Displays any errors with the connection with MakeUpScr. If there are no errors, then OK is displayed.
|-
| colspan="3" font style="background: #ebebeb" |
=== Requirements ===
|-
| On || Tickbox || Switch Makeup block on or off
|-
|Rowspan=16 valign="top" | Model See [[#Step_3_-_Configure_the_Makeup_Block|NOTE]] || None || No makeup is added to the unit. This is the same as disabling the block.
|-
| [[#Fixed Makeup Model|Fixed Makeup]] || Makeup is added as a fixed amount set by the user (or via a controller). The section on Fixed Makeup has a description of all of the relevant fields.
|-
| [[#Ratio Makeup Model|Ratio Makeup]] || Makeup is added based as a user specified ratio relative to the feed. The ratio may be based on total flows, phases, species or elements. The section on Ratio Makeup has a description of all of the relevant fields.
|-
| [[#Product Flow Makeup Model|Product Flow]] || Makeup is added to achieve a user specified product flow. The required flow can be total flow, flow of phase or species or element. The section on Product Flow has a description of all of the relevant fields.
|-
| [[#Product Composition Makeup Model|Product Composition]] || Makeup is added to achieve a user specified product composition. The section on Product Composition has a description of all of the relevant fields. Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].
|-
| [[#Product Concentration Makeup Model|Product Concentration]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at stream temperature. The section on Product Concentration has a description of all of the relevant fields. Please also see [[ETip: Controlling Concentration using Makeup Blocks]].
|-
| [[#Product Concentration @25 Makeup Model|Product Concentration @25]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at 25°C. The section on Product Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration Makeup Model|Product Molar Concentration]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at stream temperature. The section on Product Molar Concentration has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at 25°C. The section on Product Molar Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Density Makeup Model|Product Density]] || Makeup is added to achieve a user specified product density. The section on Product Density has a description of all of the relevant fields.
|-
| [[#Product pH.negLogH Makeup Model|Product pH.negLogH]] || Makeup is added to achieve a user specified product pH. The section on Product pH has a description of all of the relevant fields. Please note that the pH calculated in SysCAD is an estimate.
|-
| [[#Product_User_Calc_Makeup_Model|Product User Calc]] || Makeup is added to achieve a user specified value of a user calculation. The section on Product User Calc has a description of all of the relevant fields.
|-
| [[#Product_SpCalc_Makeup_Model|Product SpCalc]] || Makeup is added to achieve a user specified value of a species calculation. The section on Product SpCalc has a description of all of the relevant fields.
|-
| [[#Product_SpModel_Property_Makeup_Model|Product SpModel Property]] || Makeup is added to achieve a user specified value of a species model property. The section on Product SpModel Property has a description of all of the relevant fields.
|-
| [[#Product Temperature Makeup Model|Product Temperature]] || Makeup is added to achieve a user specified product temperature. The section on Product Temperature has a description of all of the relevant fields.
|-
| [[#Temperature Change Makeup Model|Temperature Change]] || Makeup is added to achieve a user specified temperature change between the feed and the product. The section on Temperature Change has a description of all of the relevant fields.
|}

=== Fixed Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassFlow || The user specifies the Makeup amount as a mass flowrate.
|-
| VolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at temperature.
|-
| VolumeFlow25 || The user specifies the Makeup amount as a volumetric flowrate at 25°C.
|-
| NVolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at Normal Temperature.
|-
| MoleFlow || The user specifies the Makeup amount as a molar flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The amount of material added is based on the Total makeup stream.
|-
| Phase || The user can select the different phases to be included in the specified amount. For example, if the make up source has 50% solids and 50% liquids, and the user wants to specify a mass flow of 10t/h of solids, then only leave the solids tick box checked and SysCAD will add to the MUx block enough makeup to give 10t/h solids. In this case, a total of 20t/h will be added.
|-
| IndividualPhase || As per Phase, the user is allowed to select the individual phase to be included in the specified amount. For example, if user wants to specify the organic addition - individual phase (or) to be 10t/h then select the (or) individual phase, and the makeup block will add enough to give 10t/h organic.
Note: To do so, user must have defined (or) phase in the species database and the makeup source must contain organics as part of its composition.
|-
| valign="top" | All Species/Species || The user may select individual species to be included in the specified amount.
* Select required species from the list.
* Multiple selections are allowed. Up to 20 species can be selected.
|-
| valign="top" | Solid Species || Only available in Build 138 or later. The user may select individual solid species to be included in the specified amount. Up to 20 solid species can be selected.
|-
| valign="top" | Liquid Species || Only available in Build 138 or later. The user may select individual liquid species to be included in the specified amount. Up to 20 liquid species can be selected.
|-
| valign="top" | Vapour Species || Only available in Build 138 or later. The user may select individual vapour species to be included in the specified amount. Up to 20 vapour species can be selected.
|-
| valign="top" | Component || As per species above. The difference between species and component is that species is phase based, while a component is phase independent. For example, if NaCl is defined in the (aq) and (s) phases, and user wishes to select the solid phase only, then use the '''Species''' option and choose NaCl(s). If user wants to include both phases, then use the '''Component''' option and choose NaCl.
|-
| Element || The user may select individual elements to be included in the specified amount.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected all species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species, component or element. Select the required species, component or element from the list. There will usually be one extra to allow another species, component or element to be added - to a maximum of 20. To remove a species, component or element, choose the “-” option instead of the selected species, component or element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required '''(basis)''' Flow''''': xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl
|-
| Reqd.MakeUp.xx|| Input || User specified Make up amount in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.MakeUp.xx || font style="background: #ebebeb" | Feedback || User specified Make up amount as Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the makeup stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the product stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|}

=== Ratio Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassRatio || The user specifies the ratio on the basis of mass flowrates.
|-
| VolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at temperature.
|-
| Volume25Ratio || The user specifies the ratio on the basis of volumetric flowrates at 25°C.
|-
| NVolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at Normal Temperature.
|-
| MoleRatio || The user specifies the ratio on the basis of mole flowrates.
|-
|colspan=3 font style="background: #ebebeb"| '''''Feed Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Feed flow.
|-
| Phase || The ratio measurement is based on one or more Phases in the Feed.
|-
| IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Feed.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Feed.
|-
| Solid Species || Only available in Build 138 or later. The ratio measurement is based on one or more solid Species in the Feed.
|-
| Liquid Species || Only available in Build 138 or later. The ratio measurement is based on one or more liquid Species in the Feed.
|-
| Vapour Species || Only available in Build 138 or later. The ratio measurement is based on one or more vapour Species in the Feed.
|-
| Component || The ratio measurement is based on one or more Components in the Feed.
|-
| Element || The ratio measurement is based on one or more elements in the Feed.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || The user may select the required Species, Components or Elements from the displayed list. X is the number of the selected species/component/element. As for fixed makeup.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Makeup flow.
|-
|Phase || The ratio measurement is based on one or more Phases in the Makeup flow.
|-
|IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Makeup flow.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Makeup flow.
|-
| Solid Species || Only available in Build 138 or later. The ratio measurement is based on one or more solid Species in the Makeup flow.
|-
| Liquid Species || Only available in Build 138 or later. The ratio measurement is based on one or more liquid Species in the Makeup flow.
|-
| Vapour Species || Only available in Build 138 or later. The ratio measurement is based on one or more vapour Species in the Makeup flow.
|-
| Component || The ratio measurement is based on one or more Components in the Makeup flow.
|-
| Element || The ratio measurement is based on one or more elements in the Makeup flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
|Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Ratio''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.(xx)Ratio || Input || The required Make up Mass/Volume@T/Volume@25°C/NVolume/Mole Ratio as specified by the user in the ''Reqd.Basis'' field.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.xxRatio || font style="background: #ebebeb" | Feedback || User specified Make up ratio as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
| Meas.xxRatio || font style="background: #ebebeb" | Calc || Make up ratio of flowrates achieved as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) Flow ratio of MakeUp[] to Feed[]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Flow Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||MassFlow || The user may specify the required mass product flowrate.
|-
| VolumeFlow || The user may specify the required volumetric product flowrate at temperature.
|-
| VolumeFlow25 || The user may specify the required volumetric product flowrate at 25°C.
|-
| NVolumeFlow || The user may specify the required volumetric product flowrate at Normal Temperature.
|-
| MoleFlow || The user may specify the required molar product flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection || All || The Product measurement includes the full Product flow.
|-
| Phase || The Product measurement includes one or more Phases in the Product flow.
|-
| IndividualPhase || The Product measurement includes one or more Individual Phases in the Product flow.
|-
| All Species/Species || The Product measurement includes one or more Species in the Product flow.
|-
| Solid Species || Only available in Build 138 or later. The Product measurement includes one or more solid Species in the Product flow.
|-
| Liquid Species || Only available in Build 138 or later. The Product measurement includes one or more liquid Species in the Product flow.
|-
| Vapour Species || Only available in Build 138 or later. The Product measurement includes one or more vapour Species in the Product flow.
|-
| Component || The Product measurement includes one or more Components in the Product flow.
|-
| Element || The Product measurement includes one or more Elements in the Product flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (Basis) Flow rate''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xx || Input || User specified Product flowrate in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product flowrate is treated as a minimum target and there will be no warnings if this flowrate is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product flowrate is treated as a maximum target and there will be no warnings if the actual flowrate is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xx || font style="background: #ebebeb" | Display || User specified Product Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Display || Displays the Feed Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the Product stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Composition Makeup Model ===

Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||Mass || The user specifies the product composition by mass fraction
|-
| Volume || The user specifies product composition by volume fraction at product temperature
|-
| Volume25 || The user specifies product composition by volume fraction at 25°C.
|-
| NVolume || The user specifies product composition by volume fraction at Normal Temperature
|-
| Mole || The user specifies product composition by mole fraction
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=8 valign="top" | Selection || Phase || The user may specify the required composition of one or more Phases in the product stream.
|-
| IndividualPhase || The user may specify the required composition of one or more Individual Phases in the product stream.
|-
| All Species/Species || The user may specify the required composition of one or more Species in the product stream.
|-
| Solid Species || Only available in Build 138 or later. The user may specify the required composition of one or more solid Species in the product stream.
|-
| Liquid Species || Only available in Build 138 or later. The user may specify the required composition of one or more liquid Species in the product stream.
|-
| Vapour Species || Only available in Build 138 or later. The user may specify the required composition of one or more vapour Species in the product stream.
|-
| Component || The user may specify the required composition of one or more Components in the product stream.
|-
| Element || The user may specify the required composition of one or more Elements in the product stream.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X|| List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Base Measurement'''''
|-
|Rowspan=3 valign="top" | Selection || All || The user may specify the required composition as a fraction of the Total Product flow.
|-
| Phase || The user may specify the required composition as a fraction of one or more Phases in the product stream, e.g. the fraction of SiO2(s) as a fraction of the Solid phase.
|-
| IndividualPhase || The user may specify the required composition as a fraction of one or more Individual Phases in the product stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Fraction''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xxFrac || Input || The required product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product composition is treated as a minimum target and there will be no warnings if this composition is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product composition is treated as a maximum target and there will be no warnings if the actual composition is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) fraction [component/species/element(phase)]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xxFrac || font style="background: #ebebeb" | Display || User specified Product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Feed.xxFrac || font style="background: #ebebeb" | Display || Displays the Feed stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.MakeUp.xxFrac || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Prod.xxFrac || font style="background: #ebebeb" | Calc || Displays the Product stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|}

=== Product Concentration Makeup Model ===

Please also see [[ETip: Controlling Concentration using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the aqueous (aq) phase.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc || Input || The user specified product concentration (mass per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at product temperature.
|-
| Meas.Feed.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc / Conc25 || Input || The user specified product concentration (mass per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume25[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc / Conc25 || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at 25°C.
|-
| Meas.Feed.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Molar Concentration Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| ''Required Molar Concentration''
|-
| Reqd.Prod.ConcMl / MlConc || Input || The user specified product concentration (moles per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at product temperature.
|-
| Meas.Feed.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Molar Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Molar Concentration'''''
|-
| Reqd.Prod.ConcMl / MlConc25 || Input || The user specified product concentration (moles per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product molar concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product molar concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume25[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at 25°C.
|-
| Meas.Feed.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Density Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Density Measurement'''''
|-
|Rowspan=2 valign="top" | Selection || All || All phases will be used for the product density calculation.
|-
| Phase || The user selects which phases will be used for the product density calculation. For example, if the product may contain gases, then the user may tick only the Solids and Liquids tickboxes to ensure that the vapours are NOT included in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| The following three tick boxes will only be visible if the user has selected 'Phase' for the Selection field.
|-
| Solids || Tick Box|| This must be ticked if the user wishes to include solids in the density calculation.
|-
| Liquids || Tick Box|| This must be ticked if the user wishes to include liquids in the density calculation.
|-
| Vapours || Tick Box|| This must be ticked if the user wishes to include vapours in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Density'''''
|-
| Reqd.Prod.Rho || Input || User specified product density.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product density is treated as a minimum target and there will be no warnings if this density is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product density is treated as a maximum target and there will be no warnings if the actual density is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Rho || font style="background: #ebebeb"| Display || User specified Product density.
|-
| Meas.Feed.Rho || font style="background: #ebebeb"| Calc || Displays density of Feed stream
|-
| Meas.MakeUp.Rho || font style="background: #ebebeb"| Calc || Displays density of Makeup stream
|-
| Meas.Prod.Rho || font style="background: #ebebeb"| Calc || Displays density of Product stream
|}

=== Product pH.negLogH Makeup Model ===

* Please note that the pH is be measured at the point of addition, any acid/base reactions that occur after the Makeup are not considered.
* This feature is demonstrated in the [[Zinc Hydrometallurgical Project]], which is distributed with SysCAD.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required pH'''''
|-
| Reqd.Prod.pH.negLogH || Input || User specified product pH.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product pH is treated as a minimum target and there will be no warnings if the estimated pH is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product pH is treated as a maximum target and there will be no warnings if the estimated pH is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''pH Estimate'''''
|-
| Used.Prod.pH.negLogH || font style="background: #ebebeb"| Display || User specified Product pH.
|-
| Meas.Feed.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Feed stream
|-
| Meas.MakeUp.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Makeup stream
|-
| Meas.Prod.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Product stream
|}

=== Product User Calc Makeup Model ===

* Please note that User Calc (User Property Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#User_Property_Calculations |User property Calculations]] for more information.
* This option is only usable if user defined properties are present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.UserCalc || List || Lists all available user defined properties in the project, if nothing is available, the List box will display "None Defined"
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected user property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''User Calc xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected User property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the feed stream
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the Makeup stream
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the product stream
|}

=== Product SpCalc Makeup Model ===

* Please note that SpCalc (User species Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#Species_Calculations |User Species Calculations]] for more information.
* This option is only usable if user species calculation is present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpCalc || List || Lists all available user defined species calculation in the project, if nothing is available, the List box will display "None Defined"
|-
|rowspan=4 | Reqd.SpBasis || colspan=2 font style="background: #ebebeb"| Allows the user to select the phase basis of the species calculation.
|-
|All || The calculated value will be based on whole stream.
|-
|Phase || The calculated value will be by Phase.
|-
|IndividualPhase || The calculated value will be by Individual Phase.
|-
|Reqd.View || List || Dropdown list of relevant views for chosen calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required ZZZ Value'''''
|-
| Reqd.Prod.YYY.ZZZ || Input || The required value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpCalc ZZZ'''''
|-
| Used.Prod.YYY.ZZZ || font style="background: #ebebeb"| Display || The specified value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Meas.Feed.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the feed stream.
|-
| Meas.MakeUp.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the Makeup stream.
|-
| Meas.Prod.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the product stream.
|}

=== Product SpModel Property Makeup Model ===

* Please note that the species properties that are available in a project will depend on the add-ons used in that project. For example, if the project is using the Alumina add-on, then all of the species properties that are available for the Bayer property model will be available.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpModel || List || Lists all available species models in the project. Many projects will only have 'Standard', but if you have the Alumina add-on, you may also select 'Bayer'.
|-
|Reqd.Property || List || Allows the user to select the species model property that will be used to control the makeup to the unit.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected species model property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpMdlProp xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected species model property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the feed stream.
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the Makeup stream.
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the product stream.
|}

=== Product Temperature Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature'''''
|-
| Reqd.Prod.T || Input || User specified product temperature
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product temperature is treated as a minimum target and there will be no warnings if this temperature is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product temperature is treated as a maximum target and there will be no warnings if the actual temperature is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Temp || font style="background: #ebebeb"| Display || User specified Product temperature
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Product stream
|}

=== Temperature Change Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature Change'''''
|-
| Reqd.Prod.TChg || Input || User specified temperature change (between feed and product)
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.TChg || font style="background: #ebebeb"| Display || User specified temperature change
|-
| Meas.Prod.TChg || font style="background: #ebebeb"| Display || Temperature change achieved (from feed to product temperature)
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of product stream
|}

=== Common Requirements ===

The common requirements include makeup limits, low feed and product temperature.

The following input fields are required for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=10%|Tag (Long/Short) || Width=10%|Input/Calc || Width=80%|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Limits for total Makeup Flow'''''
|-
| MakeUp.QmMin || Input || User specified minimum makeup flow, usually 0. '''Note:''' this is applied to the total makeup stream.
|-
| MakeUp.QmMax || Input || User specified maximum makeup flow - the Makeup block will not add more than this value. '''Note:''' this is applied to the total makeup stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Rule for Low Feed Flow'''''
|-
|Rowspan=3 valign="top" | LowQmRule || AlwaysOn || Always add specified flow of makeup, even if the Feed flow drops to zero.
|-
| StopBelowQmLimit || Do not add any makeup if Feed flowrate is below user specified number.
|-
| StopBelowNoFlow || Do not add any makeup if Feed flowrate is zero.
|-
| LowQmLimit || Input || Only visible if ''StopBelowQmLimit'' is selected. User specified minimum feed flow below which no makeup is added.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Temperature''''' (Not visible if ''Product Temperature'' or ''Temperature Change'' are selected)
|-
|Rowspan=5 valign="top" | Temp.Final || InletTemp || Add or remove heat to make the Product temperature the same as the Feed temperature.
|-
| SourceTemp || Add or remove heat to make the Product temperature the same as the Makeup Source temperature.
|-
| StdTemp || Add or remove heat to make the Product temperature the same as Standard temperature.
|-
| Const || Add or remove heat to make the Product temperature the same as the user specified temperature.
|-
| Mixture || Default behaviour - no heat is added or removed, the Product temperature is determined by an energy balance involving the Feed and the Makeup.
|-
| Temp.Reqd || Input || Only visible if ''Const'' is selected. User specified temperature of the Product stream.
|}

=== Common Results for All Models ===

The following fields are visible for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Description || font style="background: #ebebeb"| Display || Displays a description in words of the makeup options chosen.
|-
| State || font style="background: #ebebeb"| Display || Displays any errors. If there are no errors then displays OK.
|-
|colspan=3 font style="background: #ebebeb"| '''''Total mass flow'''''
|-
| Feed.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of feed stream.
|-
| MakeUp.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of makeup stream.
|-
| Prod.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total volume flow:'''''
|-
| Feed.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of feed stream.
|-
| MakeUp.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of makeup stream.
|-
| Prod.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total heat flow'''''
|-
| Feed.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of feed stream.
|-
| MakeUp.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of makeup stream.
|-
| Prod.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of product stream (including makeup).
|-
| HeatFlow ||font style="background: #ebebeb"| Calc || Displays heat added/removed to achieve product temperature requirements.
|}

== Use in Example Projects ==

The Makeup methods are shown in the following example projects distributed with SysCAD:

''' Fixed Makeup'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Units: ''Ni_Diss_1'' and ''Acid_Addition''
#Smelter Example
#:Project Location: See [[Example_65_Smelting#Copper_Flash_Furnace_Example|Smelter Example]]
#:Unit: ''Electric_Furnace''

''' Ratio Makeup'''

Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''NiCo_Precip''

'''Product Flow'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''

'''Product Composition'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''
#Demo Uranium Project
#:Location: See [[Example 80 Uranium|Demo Uranium Project]]
#:Unit: ''P_13''

'''Product Concentration'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''Ni_Diss_2''

'''pH Control'''

#Demo Zinc Hydrometallurgical Project
#:Project Location: See [[Zinc Hydrometallurgical Project]]
#:Units: All links after acid additions for pH control.

'''User Calc'''
#Demo Gold Project
#:Project Location: See [[Example 25 Gold|Gold Project]]
#:The last reaction in the tanks are using the reaction extent [[Reaction_Block_-_Extents#User_Calculations_-_User_Defined_Properties_.28User_Calc.29|UserCalc]].

Makeup Block (MU)

2026-02-26T06:43:10Z

Keith.Armstrong:

[[Category:Sub-Models]]
{{Navigation|[[Models]]|[[Models#Sub-Models|Sub-Models]]}}
{{Other General Models Header table |currentpage=2 }}
----
{{TOC}}
== General Description ==

By enabling a Makeup (MU) Block within a unit, the user may add flow to the unit in a controlled fashion. There are a number of advantages to using a MU block to add material to a unit:
# The user needs to add and configure only a single [[Makeup Source]] to feed many different units in a project. It has the the added advantage of reporting all the separate makeup streams in one place.
# Since the Source is not connected to the MU with a standard link, there is no need for multiple links to be constructed.
# The user may often be able to avoid using either a PID or General Controller to control the flow addition.
# The MU calculation occurs in place so the unit always has the correct flow at each iteration, or step. In dynamic projects, using a MU instead of controlled flows with associated time step lags can be a significant advantage.
# A MU can be a useful modelling trick in setting up flow in a recirculating loop. [[FAQ_-_Modelling_related_questions#How_can_I_set_the_flow_in_a_recycle_loop? | Setting flow in a loop]]

The Makeup Block (MU) can be added to a number of models, such as the [[Tie]], [[Tank]], [[Feeder-Cross Page Connector]], [[Pipe]] and many [[Models#Mass Separation Models|Mass Separation]] models.

'''Notes:'''
* The MU block gets the flow composition and properties from the [[Makeup Source]], so this unit needs to be inserted and configured to enable effective use of the MU in a unit.

=== Video Links ===

The following videos are part of the Tutorial showing users how to insert and configure a Makeup Block:
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Add and Configure a Makeup Block|Add and Configure a Makeup Block video]]'''
* '''[[Introductory Tutorial - Makeup and Environmental Heat Exchange#Optional - Review results from Makeup Block |Review results from Makeup Block video]]'''

== Adding Makeup to a Unit ==

=== Step 1 - Enable Makeup ===

The Makeup Block is enabled in a unit when the user enters an integer between 1 and 8 for the number of Makeups in the unit's access window.

The user may enable more than one Makeup Block per unit, by entering 2, 3, etc. The unit will then have the appropriate number of Tabs: MU1, MU2, MU3, etc. The user must then configure the Makeup Block(s) by clicking on the MUX tab.

'''Notes:'''
# The Makeup Block is a sub-model which is evaluated sequentially. The user can change the order that the sub-models are solved using the drop down lists on the first tab page - Off, On-AutoSequence, On-Sequence1, On-Sequence2, etc.
# The ''[[Evaluation_Blocks|AutoSequence]]'' option will evaluate the sub-models as follows:
#* 1st - Makeup;
#* 2nd - Reactions;
#* 3rd - Environmental Heat eXchange; and
#* 4th - VLEquilibrium.
# For example, a Makeup may be added either before or after a reaction block sub-model.
#* If the Makeup is a reactant then it must be added prior to the reaction block.
#* If the user wants to achieve a final concentration from the unit then the Makeup block should be the last sub-model.
#* '''Due to the sequential nature of the sub-models, Makeups can not be used to achieve a final concentration of a reactant.'''

=== Step 2 - Connect to a Makeup Source ===

The next step is to connect the Makeup Block to a [[Makeup Source]]. Go to the MU tab and select the Makeup Source from a drop down list of available Makeup sources in the project.

Once a valid Makeup Source has been entered into the MakeupSrc field, a graphics symbol for the [[DirectLink]] will be displayed indicating that the unit has additional input. (Note: The user may change the name of this [[DirectLink]] or its graphical symbol in exactly the same way as for any other unit in SysCAD).

=== Step 3 - Configure the Makeup Block ===

The Makeup Block may then be configured as:
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* None
* [[#Fixed Makeup Model|Fixed Makeup]]
* [[#Ratio Makeup Model|Ratio Makeup]]
* [[#Product Flow Makeup Model|Product Flow]]
* [[#Product Composition Makeup Model|Product Composition]]
* [[#Product Concentration Makeup Model|Product Mass Concentration @T]]
* [[#Product Concentration @25 Makeup Model|Product Mass Concentration @25°C]]
* [[#Product Molar Concentration Makeup Model|Product Molar Concentration @T]]
* [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25°C]]
* [[#Product Density Makeup Model|Product Density]]
* [[#Product pH.negLogH Makeup Model|Product pH Estimate]]
* [[#Product User Calc Makeup Model|Product User Calculation]]
* [[#Product SpCalc Makeup Model|Product Species Calculation]]
* [[#Product SpModel Property Makeup Model|Product Species Model Property]]
* [[#Product Temperature Makeup Model|Product Temperature]]
* [[#Temperature Change Makeup Model|Temperature Change]]
</div>
Each of the different options that can be configured are described in the table below.

[[Image:Makeup01.png]]


'''NOTE''':
* When setting up the makeup block, it’s crucial to understand the evaluation order of the MU block. The term “Feed” refers to the material entering the MU block. This means that if the MU block in question is the second evaluation block in the sequence, then the “Feed” for this MU block would be the “Product” from the first evaluation block. Similarly, the term “Product” (as used in the method [[#Product Flow Makeup Model|Product Flow]]) refers to the material exiting the MU block. It’s important to note that this may not be the same as the Discharge product from the process unit if other evaluation blocks are used after the MU block.

==Data Section==

The default access window (MU) and variable names are described in detail in the following tables. These variables change as the user selects the various options that are available. Individual tables are shown for each Makeup Model, except for the [[#Common Requirements - Makeup Limits, Low Feed and Product Temperature|Common Requirements]] and [[#Common Results for All Models|Common Results]] tables that show fields that are common to all methods.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=220|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| DIO...
|-
| MakeupScr || List || Name of the MakeUp Source unit operation - this may be chosen from the drop down list of all MakeUp Sources available in the project.
|-
| DirectLink || font style="background: #ebebeb" | Display || The name of the [[DirectLink]] between the Makeup Source and the unit.
|-
| Connect || font style="background: #ebebeb" |Display || Displays any errors with the connection with MakeUpScr. If there are no errors, then OK is displayed.
|-
| colspan="3" font style="background: #ebebeb" |
=== Requirements ===
|-
| On || Tickbox || Switch Makeup block on or off
|-
|Rowspan=16 valign="top" | Model See [[#Step_3_-_Configure_the_Makeup_Block|NOTE]] || None || No makeup is added to the unit. This is the same as disabling the block.
|-
| [[#Fixed Makeup Model|Fixed Makeup]] || Makeup is added as a fixed amount set by the user (or via a controller). The section on Fixed Makeup has a description of all of the relevant fields.
|-
| [[#Ratio Makeup Model|Ratio Makeup]] || Makeup is added based as a user specified ratio relative to the feed. The ratio may be based on total flows, phases, species or elements. The section on Ratio Makeup has a description of all of the relevant fields.
|-
| [[#Product Flow Makeup Model|Product Flow]] || Makeup is added to achieve a user specified product flow. The required flow can be total flow, flow of phase or species or element. The section on Product Flow has a description of all of the relevant fields.
|-
| [[#Product Composition Makeup Model|Product Composition]] || Makeup is added to achieve a user specified product composition. The section on Product Composition has a description of all of the relevant fields. Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].
|-
| [[#Product Concentration Makeup Model|Product Concentration]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at stream temperature. The section on Product Concentration has a description of all of the relevant fields. Please also see [[ETip: Controlling Concentration using Makeup Blocks]].
|-
| [[#Product Concentration @25 Makeup Model|Product Concentration @25]] || Makeup is added to achieve a user specified product mass concentration, calculated using volume at 25°C. The section on Product Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration Makeup Model|Product Molar Concentration]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at stream temperature. The section on Product Molar Concentration has a description of all of the relevant fields.
|-
| [[#Product Molar Concentration @25 Makeup Model|Product Molar Concentration @25]] || Makeup is added to achieve a user specified product molar concentration, calculated using volume at 25°C. The section on Product Molar Concentration @25 has a description of all of the relevant fields.
|-
| [[#Product Density Makeup Model|Product Density]] || Makeup is added to achieve a user specified product density. The section on Product Density has a description of all of the relevant fields.
|-
| [[#Product pH.negLogH Makeup Model|Product pH.negLogH]] || Makeup is added to achieve a user specified product pH. The section on Product pH has a description of all of the relevant fields. Please note that the pH calculated in SysCAD is an estimate.
|-
| [[#Product_User_Calc_Makeup_Model|Product User Calc]] || Makeup is added to achieve a user specified value of a user calculation. The section on Product User Calc has a description of all of the relevant fields.
|-
| [[#Product_SpCalc_Makeup_Model|Product SpCalc]] || Makeup is added to achieve a user specified value of a species calculation. The section on Product SpCalc has a description of all of the relevant fields.
|-
| [[#Product_SpModel_Property_Makeup_Model|Product SpModel Property]] || Makeup is added to achieve a user specified value of a species model property. The section on Product SpModel Property has a description of all of the relevant fields.
|-
| [[#Product Temperature Makeup Model|Product Temperature]] || Makeup is added to achieve a user specified product temperature. The section on Product Temperature has a description of all of the relevant fields.
|-
| [[#Temperature Change Makeup Model|Temperature Change]] || Makeup is added to achieve a user specified temperature change between the feed and the product. The section on Temperature Change has a description of all of the relevant fields.
|}

=== Fixed Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassFlow || The user specifies the Makeup amount as a mass flowrate.
|-
| VolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at temperature.
|-
| VolumeFlow25 || The user specifies the Makeup amount as a volumetric flowrate at 25°C.
|-
| NVolumeFlow || The user specifies the Makeup amount as a volumetric flowrate at Normal Temperature.
|-
| MoleFlow || The user specifies the Makeup amount as a molar flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The amount of material added is based on the Total makeup stream.
|-
| Phase || The user can select the different phases to be included in the specified amount. For example, if the make up source has 50% solids and 50% liquids, and the user wants to specify a mass flow of 10t/h of solids, then only leave the solids tick box checked and SysCAD will add to the MUx block enough makeup to give 10t/h solids. In this case, a total of 20t/h will be added.
|-
| IndividualPhase || As per Phase, the user is allowed to select the individual phase to be included in the specified amount. For example, if user wants to specify the organic addition - individual phase (or) to be 10t/h then select the (or) individual phase, and the makeup block will add enough to give 10t/h organic.
Note: To do so, user must have defined (or) phase in the species database and the makeup source must contain organics as part of its composition.
|-
| valign="top" | All Species/Species || The user may select individual species to be included in the specified amount.
* Select required species from the list.
* Multiple selections are allowed. Up to 20 species can be selected.
|-
| valign="top" | Solid Species || Only available in Build 138 or later. The user may select individual solid species to be included in the specified amount. Up to 20 solid species can be selected.
|-
| valign="top" | Liquid Species || Only available in Build 138 or later. The user may select individual liquid species to be included in the specified amount. Up to 20 liquid species can be selected.
|-
| valign="top" | Vapour Species || Only available in Build 138 or later. The user may select individual vapour species to be included in the specified amount. Up to 20 vapour species can be selected.
|-
| valign="top" | Component || As per species above. The difference between species and component is that species is phase based, while a component is phase independent. For example, if NaCl is defined in the (aq) and (s) phases, and user wishes to select the solid phase only, then use the '''Species''' option and choose NaCl(s). If user wants to include both phases, then use the '''Component''' option and choose NaCl.
|-
| Element || The user may select individual elements to be included in the specified amount.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected all species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species, component or element. Select the required species, component or element from the list. There will usually be one extra to allow another species, component or element to be added - to a maximum of 20. To remove a species, component or element, choose the “-” option instead of the selected species, component or element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required '''(basis)''' Flow''''': xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl
|-
| Reqd.MakeUp.xx|| Input || User specified Make up amount in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.MakeUp.xx || font style="background: #ebebeb" | Feedback || User specified Make up amount as Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the makeup stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the product stream Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|}

=== Ratio Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis || MassRatio || The user specifies the ratio on the basis of mass flowrates.
|-
| VolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at temperature.
|-
| Volume25Ratio || The user specifies the ratio on the basis of volumetric flowrates at 25°C.
|-
| NVolumeRatio || The user specifies the ratio on the basis of volumetric flowrates at Normal Temperature.
|-
| MoleRatio || The user specifies the ratio on the basis of mole flowrates.
|-
|colspan=3 font style="background: #ebebeb"| '''''Feed Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Feed flow.
|-
| Phase || The ratio measurement is based on one or more Phases in the Feed.
|-
| IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Feed.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Feed.
|-
| Solid Species || Only available in Build 138 or later. The ratio measurement is based on one or more solid Species in the Feed.
|-
| Liquid Species || Only available in Build 138 or later. The ratio measurement is based on one or more liquid Species in the Feed.
|-
| Vapour Species || Only available in Build 138 or later. The ratio measurement is based on one or more vapour Species in the Feed.
|-
| Component || The ratio measurement is based on one or more Components in the Feed.
|-
| Element || The ratio measurement is based on one or more elements in the Feed.
|-
|colspan=3 | If Phase/Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || The user may select the required Species, Components or Elements from the displayed list. X is the number of the selected species/component/element. As for fixed makeup.
|-
|colspan=3 font style="background: #ebebeb"| '''''MakeUp Measurement'''''
|-
|Rowspan=9 valign="top" | Selection || All || The ratio measurement is based on the full Makeup flow.
|-
|Phase || The ratio measurement is based on one or more Phases in the Makeup flow.
|-
|IndividualPhase || The ratio measurement is based on one or more Individual Phases in the Makeup flow.
|-
| All Species / Species || The ratio measurement is based on one or more Species in the Makeup flow.
|-
| Solid Species || Only available in Build 138 or later. The ratio measurement is based on one or more solid Species in the Makeup flow.
|-
| Liquid Species || Only available in Build 138 or later. The ratio measurement is based on one or more liquid Species in the Makeup flow.
|-
| Vapour Species || Only available in Build 138 or later. The ratio measurement is based on one or more vapour Species in the Makeup flow.
|-
| Component || The ratio measurement is based on one or more Components in the Makeup flow.
|-
| Element || The ratio measurement is based on one or more elements in the Makeup flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
|Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Ratio''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.(xx)Ratio || Input || The required Make up Mass/Volume@T/Volume@25°C/NVolume/Mole Ratio as specified by the user in the ''Reqd.Basis'' field.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.xxRatio || font style="background: #ebebeb" | Feedback || User specified Make up ratio as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
| Meas.xxRatio || font style="background: #ebebeb" | Calc || Make up ratio of flowrates achieved as Mass / Volume@T / Volume@25°C / NVolume / Mole.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) Flow ratio of MakeUp[] to Feed[]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Calc || Displays the Feed stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Flow Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||MassFlow || The user may specify the required mass product flowrate.
|-
| VolumeFlow || The user may specify the required volumetric product flowrate at temperature.
|-
| VolumeFlow25 || The user may specify the required volumetric product flowrate at 25°C.
|-
| NVolumeFlow || The user may specify the required volumetric product flowrate at Normal Temperature.
|-
| MoleFlow || The user may specify the required molar product flowrate.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection || All || The Product measurement includes the full Product flow.
|-
| Phase || The Product measurement includes one or more Phases in the Product flow.
|-
| IndividualPhase || The Product measurement includes one or more Individual Phases in the Product flow.
|-
| All Species/Species || The Product measurement includes one or more Species in the Product flow.
|-
| Solid Species || Only available in Build 138 or later. The Product measurement includes one or more solid Species in the Product flow.
|-
| Liquid Species || Only available in Build 138 or later. The Product measurement includes one or more liquid Species in the Product flow.
|-
| Vapour Species || Only available in Build 138 or later. The Product measurement includes one or more vapour Species in the Product flow.
|-
| Component || The Product measurement includes one or more Components in the Product flow.
|-
| Element || The Product measurement includes one or more Elements in the Product flow.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (Basis) Flow rate''''' (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xx || Input || User specified Product flowrate in Mass/Volume@T/Volume@25°C/NVolume/Mole Flow.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product flowrate is treated as a minimum target and there will be no warnings if this flowrate is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product flowrate is treated as a maximum target and there will be no warnings if the actual flowrate is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) flow [component/species/element/phase]:''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xx || font style="background: #ebebeb" | Display || User specified Product Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Feed.xx || font style="background: #ebebeb" | Display || Displays the Feed Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.MakeUp.xx || font style="background: #ebebeb" | Calc || Displays the Makeup stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|-
| Meas.Prod.xx || font style="background: #ebebeb" | Calc || Displays the Product stream Mass / Volume@T / Volume@25°C / NVolume / Mole Flow.
|}

=== Product Composition Makeup Model ===

Please also see [[ETip: Controlling phase fraction using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Rowspan=5 valign="top" | Reqd.Basis ||Mass || The user specifies the product composition by mass fraction
|-
| Volume || The user specifies product composition by volume fraction at product temperature
|-
| Volume25 || The user specifies product composition by volume fraction at 25°C.
|-
| NVolume || The user specifies product composition by volume fraction at Normal Temperature
|-
| Mole || The user specifies product composition by mole fraction
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Measurement'' '''
|-
|Rowspan=8 valign="top" | Selection || Phase || The user may specify the required composition of one or more Phases in the product stream.
|-
| IndividualPhase || The user may specify the required composition of one or more Individual Phases in the product stream.
|-
| All Species/Species || The user may specify the required composition of one or more Species in the product stream.
|-
| Solid Species || Only available in Build 138 or later. The user may specify the required composition of one or more solid Species in the product stream.
|-
| Liquid Species || Only available in Build 138 or later. The user may specify the required composition of one or more liquid Species in the product stream.
|-
| Vapour Species || Only available in Build 138 or later. The user may specify the required composition of one or more vapour Species in the product stream.
|-
| Component || The user may specify the required composition of one or more Components in the product stream.
|-
| Element || The user may specify the required composition of one or more Elements in the product stream.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X|| List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Base Measurement'''''
|-
|Rowspan=3 valign="top" | Selection || All || The user may specify the required composition as a fraction of the Total Product flow.
|-
| Phase || The user may specify the required composition as a fraction of one or more Phases in the product stream, e.g. the fraction of SiO2(s) as a fraction of the Solid phase.
|-
| IndividualPhase || The user may specify the required composition as a fraction of one or more Individual Phases in the product stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required (basis) Fraction''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Reqd.Prod.xxFrac || Input || The required product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product composition is treated as a minimum target and there will be no warnings if this composition is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product composition is treated as a maximum target and there will be no warnings if the actual composition is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''(Basis) fraction [component/species/element(phase)]''''': (xx = selected Reqd.Basis = Qm, Qv, Qv25, NQv or QMl)
|-
| Used.Prod.xxFrac || font style="background: #ebebeb" | Display || User specified Product composition as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Feed.xxFrac || font style="background: #ebebeb" | Display || Displays the Feed stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.MakeUp.xxFrac || font style="background: #ebebeb" | Calc || Displays the Makeup stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|-
| Meas.Prod.xxFrac || font style="background: #ebebeb" | Calc || Displays the Product stream as Mass/Volume@T/Volume@25°C/NVolume/Mole fraction.
|}

=== Product Concentration Makeup Model ===

Please also see [[ETip: Controlling Concentration using Makeup Blocks]].

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'' '''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the aqueous (aq) phase.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc || Input || The user specified product concentration (mass per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at product temperature.
|-
| Meas.Feed.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.Conc || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Mass Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the mass of the whole stream.
|-
| Phase || The Product concentration will be based on the mass of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the mass of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the mass of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the mass of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the mass of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the mass of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Concentration'''''
|-
| Reqd.Prod.Conc / Conc25 || Input || The user specified product concentration (mass per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Concentration: Mass[] / Volume25[]''''' (Product Mass Measurement / Product Volume Measurement)
|-
| Used.Prod.Conc / Conc25 || font style="background: #ebebeb"| Display || User specified Product concentration (mass per volume) at 25°C.
|-
| Meas.Feed.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.Conc / Conc25 || font style="background: #ebebeb"| Calc || Displays concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Molar Concentration Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at product temperature.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at product temperature.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(s) at temperature in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at product temperature. E.g. a required concentration of NaCl(aq) at temperature in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at product temperature. E.g. a required concentration of HCl(g) at temperature in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at product temperature.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| ''Required Molar Concentration''
|-
| Reqd.Prod.ConcMl / MlConc || Input || The user specified product concentration (moles per volume) at product temperature.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at product temperature.
|-
| Meas.Feed.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at feed temperature.
|-
| Meas.MakeUp.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at make up source temperature.
|-
| Meas.Prod.ConcMl / MlConc || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at product temperature.
|}

=== Product Molar Concentration @25 Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Molar Measurement'''''
|-
|Rowspan=9 valign="top" | Selection ||All || The Product concentration will be based on the moles of the whole stream.
|-
| Phase || The Product concentration will be based on the moles of one or more Phases.
|-
| IndividualPhase || The Product concentration will be based on the moles of one or more Individual Phases.
|-
| All Species/Species || The Product concentration will be based on the moles of one or more Species. '''Note''' that if the user selects more than one species, the unit will control the concentration of the sum of the species selected to the required concentration.
|-
| Solid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more solid Species. '''Note''' that if the user selects more than one solid species, the unit will control the concentration of the sum of the solid species selected to the required concentration.
|-
| Liquid Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more liquid Species. '''Note''' that if the user selects more than one liquid species, the unit will control the concentration of the sum of the liquid species selected to the required concentration.
|-
| Vapour Species || Only available in Build 138 or later. The Product concentration will be based on the moles of one or more vapour Species. '''Note''' that if the user selects more than one vapour species, the unit will control the concentration of the sum of the vapour species selected to the required concentration.
|-
| Component || The Product concentration will be based on the moles of one or more Components. '''Note''' that if the user selects more than one Component, the unit will control the concentration of the sum of the Components selected to the required concentration.
|-
| Element || The Product concentration will be based on the moles of one or more Elements. '''Note''' that if the user selects more than one Element, the unit will control the concentration of the sum of the Elements selected to the required concentration.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species, Component or Element is selected: All species/components/elements added will be displayed here.
|-
| Species0X / Component0X / Element0X || List || X is the number of the selected species/component/element. Select species/component/element from the list. There will usually be one extra to allow another species/component/element to be added (but never more than 20). To remove any species/component/element, choose the “-” option instead of the selected species/component/element.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Volume Measurement @25'''''
|-
|Rowspan=8 valign="top" | Selection || All || The required Product concentration will be based on the Full Product volume flow, measured at 25°C.
|-
| Phase || The required Product concentration will be based on one or more Phases of Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in the Liquid phase.
|-
| IndividualPhase || The required Product concentration will be based on one or more Individual Phases of Product volume flow, measured at 25°C.
|-
| All Species/Species || The required Product concentration will be based on one or more Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Solid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more solid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(s) at 25°C in SiO2(s).
|-
| Liquid Species || Only available in Build 138 or later. The required Product concentration will be based on one or more liquid Species in the Product volume flow, measured at 25°C. E.g. a required concentration of NaCl(aq) at 25°C in H2O(l).
|-
| Vapour Species || Only available in Build 138 or later. The required Product concentration will be based on one or more vapour Species in the Product volume flow, measured at 25°C. E.g. a required concentration of HCl(g) at 25°C in H2O(g).
|-
| Component || The required Product concentration will be based on one or more Components in the Product flow, measured at 25°C.
|-
|colspan=3 | If Phase or Individual Phase is selected:
|-
| For each phase || Tickbox || Select phase/s required.
|-
|colspan=3 | If All Species/Species, Solid Species, Liquid Species, Vapour Species or Component is selected: All species/components added will be displayed here.
|-
| Species0X / Component0X || List || X is the number of the selected species/component. Select species/component from the list. There will usually be one extra to allow another species/component to be added (but never more than 20). To remove any species/component, choose the “-” option instead of the selected species/component.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Molar Concentration'''''
|-
| Reqd.Prod.ConcMl / MlConc25 || Input || The user specified product concentration (moles per volume) at 25°C.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product molar concentration is treated as a minimum target and there will be no warnings if this concentration is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product molar concentration is treated as a maximum target and there will be no warnings if the actual concentration is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Molar Concentration: Mole[] / Volume25[]''''' (Product Molar Measurement / Product Volume Measurement)
|-
| Used.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Display || User specified Product concentration (moles per volume) at 25°C.
|-
| Meas.Feed.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in feed stream at 25°C.
|-
| Meas.MakeUp.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Makeup stream at 25°C.
|-
| Meas.Prod.ConcMl / MlConc25 || font style="background: #ebebeb"| Calc || Displays molar concentration of specified phase/component/species/element in Product stream at 25°C.
|}

=== Product Density Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Density Measurement'''''
|-
|Rowspan=2 valign="top" | Selection || All || All phases will be used for the product density calculation.
|-
| Phase || The user selects which phases will be used for the product density calculation. For example, if the product may contain gases, then the user may tick only the Solids and Liquids tickboxes to ensure that the vapours are NOT included in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| The following three tick boxes will only be visible if the user has selected 'Phase' for the Selection field.
|-
| Solids || Tick Box|| This must be ticked if the user wishes to include solids in the density calculation.
|-
| Liquids || Tick Box|| This must be ticked if the user wishes to include liquids in the density calculation.
|-
| Vapours || Tick Box|| This must be ticked if the user wishes to include vapours in the density calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Density'''''
|-
| Reqd.Prod.Rho || Input || User specified product density.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product density is treated as a minimum target and there will be no warnings if this density is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product density is treated as a maximum target and there will be no warnings if the actual density is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Rho || font style="background: #ebebeb"| Display || User specified Product density.
|-
| Meas.Feed.Rho || font style="background: #ebebeb"| Calc || Displays density of Feed stream
|-
| Meas.MakeUp.Rho || font style="background: #ebebeb"| Calc || Displays density of Makeup stream
|-
| Meas.Prod.Rho || font style="background: #ebebeb"| Calc || Displays density of Product stream
|}

=== Product pH.negLogH Makeup Model ===

* Please note that the pH is be measured at the point of addition, any acid/base reactions that occur after the Makeup are not considered.
* This feature is demonstrated in the [[Zinc Hydrometallurgical Project]], which is distributed with SysCAD.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required pH'''''
|-
| Reqd.Prod.pH.negLogH || Input || User specified product pH.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product pH is treated as a minimum target and there will be no warnings if the estimated pH is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product pH is treated as a maximum target and there will be no warnings if the estimated pH is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''pH Estimate'''''
|-
| Used.Prod.pH.negLogH || font style="background: #ebebeb"| Display || User specified Product pH.
|-
| Meas.Feed.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Feed stream
|-
| Meas.MakeUp.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Makeup stream
|-
| Meas.Prod.pH.negLogH || font style="background: #ebebeb"| Calc || Displays estimated pH of Product stream
|}

=== Product User Calc Makeup Model ===

* Please note that User Calc (User Property Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#User_Property_Calculations |User property Calculations]] for more information.
* This option is only usable if user defined properties are present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.UserCalc || List || Lists all available user defined properties in the project, if nothing is available, the List box will display "None Defined"
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected user property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''User Calc xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected User property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the feed stream
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the Makeup stream
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected User property in the product stream
|}

=== Product SpCalc Makeup Model ===

* Please note that SpCalc (User species Calculation) is defined as part of the project configuration file, please see [[Calculation_Configuration#Species_Calculations |User Species Calculations]] for more information.
* This option is only usable if user species calculation is present in the project.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpCalc || List || Lists all available user defined species calculation in the project, if nothing is available, the List box will display "None Defined"
|-
|rowspan=4 | Reqd.SpBasis || colspan=2 font style="background: #ebebeb"| Allows the user to select the phase basis of the species calculation.
|-
|All || The calculated value will be based on whole stream.
|-
|Phase || The calculated value will be by Phase.
|-
|IndividualPhase || The calculated value will be by Individual Phase.
|-
|Reqd.View || List || Dropdown list of relevant views for chosen calculation.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required ZZZ Value'''''
|-
| Reqd.Prod.YYY.ZZZ || Input || The required value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpCalc ZZZ'''''
|-
| Used.Prod.YYY.ZZZ || font style="background: #ebebeb"| Display || The specified value of the selected user species calculation (ZZZ) based on the chosen view (YYY).
|-
| Meas.Feed.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the feed stream.
|-
| Meas.MakeUp.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the Makeup stream.
|-
| Meas.Prod.YYY.ZZZ || font style="background: #ebebeb"| Calc || Displays the value of the selected user species calculation (ZZZ) based on the chosen view (YYY) in the product stream.
|}

=== Product SpModel Property Makeup Model ===

* Please note that the species properties that are available in a project will depend on the add-ons used in that project. For example, if the project is using the Alumina add-on, then all of the species properties that are available for the Bayer property model will be available.

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|Reqd.SpModel || List || Lists all available species models in the project. Many projects will only have 'Standard', but if you have the Alumina add-on, you may also select 'Bayer'.
|-
|Reqd.Property || List || Allows the user to select the species model property that will be used to control the makeup to the unit.
|-
|colspan=3 font style="background: #ebebeb"| '''''Required xxxx Value'''''
|-
| Reqd.Prod.xxxx || Input || The required value of the selected species model property.
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required value is treated as a minimum target and there will be no warnings if the value is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required value is treated as a maximum target and there will be no warnings if the value is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''SpMdlProp xxxx'''''
|-
| Used.Prod.xxxx || font style="background: #ebebeb"| Display || The specified value of the selected species model property.
|-
| Meas.Feed.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the feed stream.
|-
| Meas.MakeUp.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the Makeup stream.
|-
| Meas.Prod.xxxx || font style="background: #ebebeb"| Calc || Displays the value of the selected species model property in the product stream.
|}

=== Product Temperature Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature'''''
|-
| Reqd.Prod.T || Input || User specified product temperature
|-
| Reqd.IsMinTarget || Tickbox || If ticked, the required product temperature is treated as a minimum target and there will be no warnings if this temperature is exceeded.
|-
| Reqd.IsMaxTarget || Tickbox || If ticked, the required product temperature is treated as a maximum target and there will be no warnings if the actual temperature is less than the requirement.
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.Temp || font style="background: #ebebeb"| Display || User specified Product temperature
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of Product stream
|}

=== Temperature Change Makeup Model ===

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Required Temperature Change'''''
|-
| Reqd.Prod.TChg || Input || User specified temperature change (between feed and product)
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Used.Prod.TChg || font style="background: #ebebeb"| Display || User specified temperature change
|-
| Meas.Prod.TChg || font style="background: #ebebeb"| Display || Temperature change achieved (from feed to product temperature)
|-
| Meas.Feed.Temp || font style="background: #ebebeb"| Calc || Displays temperature of feed stream
|-
| Meas.MakeUp.Temp || font style="background: #ebebeb"| Calc || Displays temperature of makeup stream
|-
| Meas.Prod.Temp || font style="background: #ebebeb"| Calc || Displays temperature of product stream
|}

=== Common Requirements ===

The common requirements include makeup limits, low feed and product temperature.

The following input fields are required for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=10%|Tag (Long/Short) || Width=10%|Input/Calc || Width=80%|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Limits for total Makeup Flow'''''
|-
| MakeUp.QmMin || Input || User specified minimum makeup flow, usually 0. '''Note:''' this is applied to the total makeup stream.
|-
| MakeUp.QmMax || Input || User specified maximum makeup flow - the Makeup block will not add more than this value. '''Note:''' this is applied to the total makeup stream.
|-
|colspan=3 font style="background: #ebebeb"| '''''Makeup Rule for Low Feed Flow'''''
|-
|Rowspan=3 valign="top" | LowQmRule || AlwaysOn || Always add specified flow of makeup, even if the Feed flow drops to zero.
|-
| StopBelowQmLimit || Do not add any makeup if Feed flowrate is below user specified number.
|-
| StopBelowNoFlow || Do not add any makeup if Feed flowrate is zero.
|-
| LowQmLimit || Input || Only visible if ''StopBelowQmLimit'' is selected. User specified minimum feed flow below which no makeup is added.
|-
|colspan=3 font style="background: #ebebeb"| '''''Product Temperature''''' (Not visible if ''Product Temperature'' or ''Temperature Change'' are selected)
|-
|Rowspan=5 valign="top" | Temp.Final || InletTemp || Add or remove heat to make the Product temperature the same as the Feed temperature.
|-
| SourceTemp || Add or remove heat to make the Product temperature the same as the Makeup Source temperature.
|-
| StdTemp || Add or remove heat to make the Product temperature the same as Standard temperature.
|-
| Const || Add or remove heat to make the Product temperature the same as the user specified temperature.
|-
| Mixture || Default behaviour - no heat is added or removed, the Product temperature is determined by an energy balance involving the Feed and the Makeup.
|-
| Temp.Reqd || Input || Only visible if ''Const'' is selected. User specified temperature of the Product stream.
|}

=== Common Results for All Models ===

The following fields are visible for all models:

{| border="1" cellpadding="5" cellspacing="0"
|-
! Width=200|Tag (Long/Short) || Width=200|Input/Calc || Width=1470|Description
|-
|colspan=3 font style="background: #ebebeb"| '''''Results'''''
|-
| Description || font style="background: #ebebeb"| Display || Displays a description in words of the makeup options chosen.
|-
| State || font style="background: #ebebeb"| Display || Displays any errors. If there are no errors then displays OK.
|-
|colspan=3 font style="background: #ebebeb"| '''''Total mass flow'''''
|-
| Feed.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of feed stream.
|-
| MakeUp.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of makeup stream.
|-
| Prod.MassFlow / Qm ||font style="background: #ebebeb"| Calc || Displays total mass flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total volume flow:'''''
|-
| Feed.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of feed stream.
|-
| MakeUp.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of makeup stream.
|-
| Prod.VolFlow / Qv ||font style="background: #ebebeb"| Calc || Displays total volume flow of product stream (including makeup).
|-
|colspan=3 font style="background: #ebebeb"| '''''Total heat flow'''''
|-
| Feed.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of feed stream.
|-
| MakeUp.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of makeup stream.
|-
| Prod.Temperature / T ||font style="background: #ebebeb"| Calc || Displays temperature of product stream (including makeup).
|-
| HeatFlow ||font style="background: #ebebeb"| Calc || Displays heat added/removed to achieve product temperature requirements.
|}

== Use in Example Projects ==

The Makeup methods are shown in the following example projects distributed with SysCAD:

''' Fixed Makeup'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Units: ''Ni_Diss_1'' and ''Acid_Addition''
#Smelter Example
#:Project Location: See [[Example_65_Smelting#Copper_Flash_Furnace_Example|Smelter Example]]
#:Unit: ''Electric_Furnace''

''' Ratio Makeup'''

Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''NiCo_Precip''

'''Product Flow'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''

'''Product Composition'''

#Solvent Extraction Example
#:Location: See [[Example_-_03UnitModels_Projects_2#Solvent_Extraction_Project|Solvent Extraction Example]]
#:Unit: ''Loaded_Organic_Tank'' and ''Spent_Electrolyte_Tank''
#Demo Uranium Project
#:Location: See [[Example 80 Uranium|Demo Uranium Project]]
#:Unit: ''P_13''

'''Product Concentration'''

#Demo Nickel Copper Project
#:Project Location: See [[Nickel Copper Project|Demo Nickel Copper Project]]
#:Unit: ''Ni_Diss_2''

'''pH Control'''

#Demo Zinc Hydrometallurgical Project
#:Project Location: See [[Zinc Hydrometallurgical Project]]
#:Units: All links after acid additions for pH control.

'''User Calc'''
#Demo Gold Project
#:Project Location: See [[Example 25 Gold|Gold Project]]
#:The last reaction in the tanks are using the reaction extent [[Reaction_Block_-_Extents#User_Calculations_-_User_Defined_Properties_.28User_Calc.29|UserCalc]].

File Encryption Service

2026-02-13T07:23:24Z

Keith.Armstrong: /* Introduction */

[[Category:PGM]]
{{Navigation|[[User Guide]]}}

'''Related Links:''' [[PGMs]], [[Reaction Block (RB)]]
----
{{TOC}}
== Introduction ==
For clients with a current SysCAD upgrade and support agreement, Kenwalt can provide a file encryption utility, or more correctly a file obfuscation utility. This utility, or website service, obfuscates portions of a SysCAD project which can be a useful way to share a SysCAD project with a third party while limiting some functionality and visibility in the SysCAD project. This process does not rigorously encrypt or protect intellectual property (IP) in SysCAD projects.

The utility takes text files in original native format and creates obfuscated versions with .x file extensions. The user is responsible for keeping copies of the original files, and repeating the process if any changes to original files are made.

Currently, this can be used to obfuscate General Controller(PGM), Model Procedures(MP), Reaction(RCT), and Graphics Page(DXF) files, which are used with SysCAD projects. Primary use is for PGM files. When a file is obfuscated, it will be:
#'''Illegible''' in native format, but recognised by SysCAD during project load.
#'''Read only''' within SysCAD. This will help prevent any unwanted changes to the project for these files.
#*A General controller, or model with Model Procedures, with an obfuscated PGM or MP file will have the edit functionality disabled. User will be able to view and edit the data field values from the Access window, but they will not be allowed to view or make any changes to the file on a code level.
#*A Reaction Block with an obfuscated Reaction file will have the edit functionality disabled. User will be able to view all the reactions from the Access window and adjust any adjustable values as normal, but they won't be able to add or remove reactions.
#*A graphics window with an obfuscated DXF file will have all the Graphics Editing commands disabled. User will be able to see the flowsheet drawing and navigate, but they will not be allowed to make any changes to the drawing. The user will not be able to delete or add models, nor will they be able to manipulate the graphics in any way.
#The obfuscated files will '''stay obfuscated''' as projects are saved. The process is not reversible.
#All obfuscated files in a project can be identified by an extra '''.x''' file extension.

'''Notes:'''
*A project may only have a few files of a type obfuscated. The reduced functionality only applies to the obfuscated files. Obfuscating some PGM include files with calculation function definitions is a practical example for using this feature.
*Kenwalt provides no guarantee on the security of the obfuscated (encrypted) files.
*Client is responsible for retaining copies of the original files. We do not provide a method of converting obfuscated files back to the original format.




== How to Encrypt Files ==

If you wish to use the file obfuscation (encryption) service, please contact the [https://www.syscad.net/contact-us/ SysCAD Team] for access to the utility.

===Encryption Workflow:===
#Save and close the final version of your project.
#Encrypt the required files (see [[#Steps to Encrypt Files:|steps]] below).
#Replace the original files in the project folders with the encrypted versions.
#Delete the original files from the project (or open the project and perform a "Save Version").
#Load the updated project and confirm it runs correctly.
#Verify encryption:
#*Open the access window for each General Controller or Reaction Block using an encrypted file.
#*If encryption is active, the Edit PGM/RCT button will not be visible.
#Close the project.
#Send the project to the third party.

===Steps to Encrypt Files:===
#Obtain the utility from the SysCAD Team.
#Create a working folder for the utility and place the following inside:
#*The utility.exe file (Replace with actual file names as needed)
#*The files you want to obfuscate (e.g., .PGM)
#Open Command Prompt and navigate to the folder.
#Run the command:
#*<syntaxhighlight lang="MS-DOS" inline> utility.exe file1.pgm file2.pgm </syntaxhighlight>
#*(Replace with actual file names as needed)
#The utility will generate encrypted files:
#*file1.pgm.x
#*file2.pgm.x

File Encryption Service

2026-02-13T07:21:04Z

Keith.Armstrong:

[[Category:PGM]]
{{Navigation|[[User Guide]]}}

'''Related Links:''' [[PGMs]], [[Reaction Block (RB)]]
----
{{TOC}}
== Introduction ==
For clients with a current SysCAD upgrade and support agreement, Kenwalt can provide a file obfuscation encryption utility, or more correctly a file obfuscation utility. This utility, or website service, obfuscates portions of a SysCAD project which can be a useful way to share a SysCAD project with a third party while limiting some functionality and visibility in the SysCAD project. This process does not rigorously encrypt or protect intellectual property (IP) in SysCAD projects.

The utility takes text files in original native format and creates obfuscated versions with .x file extensions. The user is responsible for keeping copies of the original files, and repeating the process if any changes to original files are made.

Currently, this can be used to obfuscate General Controller(PGM), Model Procedures(MP), Reaction(RCT), and Graphics Page(DXF) files, which are used with SysCAD projects. Primary use is for PGM files. When a file is obfuscated, it will be:
#'''Illegible''' in native format, but recognised by SysCAD during project load.
#'''Read only''' within SysCAD. This will help prevent any unwanted changes to the project for these files.
#*A General controller, or model with Model Procedures, with an obfuscated PGM or MP file will have the edit functionality disabled. User will be able to view and edit the data field values from the Access window, but they will not be allowed to view or make any changes to the file on a code level.
#*A Reaction Block with an obfuscated Reaction file will have the edit functionality disabled. User will be able to view all the reactions from the Access window and adjust any adjustable values as normal, but they won't be able to add or remove reactions.
#*A graphics window with an obfuscated DXF file will have all the Graphics Editing commands disabled. User will be able to see the flowsheet drawing and navigate, but they will not be allowed to make any changes to the drawing. The user will not be able to delete or add models, nor will they be able to manipulate the graphics in any way.
#The obfuscated files will '''stay obfuscated''' as projects are saved. The process is not reversible.
#All obfuscated files in a project can be identified by an extra '''.x''' file extension.

'''Notes:'''
*A project may only have a few files of a type obfuscated. The reduced functionality only applies to the obfuscated files. Obfuscating some PGM include files with calculation function definitions is a practical example for using this feature.
*Kenwalt provides no guarantee on the security of the obfuscated (encrypted) files.
*Client is responsible for retaining copies of the original files. We do not provide a method of converting obfuscated files back to the original format.




== How to Encrypt Files ==

If you wish to use the file obfuscation (encryption) service, please contact the [https://www.syscad.net/contact-us/ SysCAD Team] for access to the utility.

===Encryption Workflow:===
#Save and close the final version of your project.
#Encrypt the required files (see [[#Steps to Encrypt Files:|steps]] below).
#Replace the original files in the project folders with the encrypted versions.
#Delete the original files from the project (or open the project and perform a "Save Version").
#Load the updated project and confirm it runs correctly.
#Verify encryption:
#*Open the access window for each General Controller or Reaction Block using an encrypted file.
#*If encryption is active, the Edit PGM/RCT button will not be visible.
#Close the project.
#Send the project to the third party.

===Steps to Encrypt Files:===
#Obtain the utility from the SysCAD Team.
#Create a working folder for the utility and place the following inside:
#*The utility.exe file (Replace with actual file names as needed)
#*The files you want to obfuscate (e.g., .PGM)
#Open Command Prompt and navigate to the folder.
#Run the command:
#*<syntaxhighlight lang="MS-DOS" inline> utility.exe file1.pgm file2.pgm </syntaxhighlight>
#*(Replace with actual file names as needed)
#The utility will generate encrypted files:
#*file1.pgm.x
#*file2.pgm.x

Downloading SysCAD Software and Updates

2026-02-13T06:38:00Z

Keith.Armstrong: /* Downloads (from SysCAD.net) */

{{Navigation|[[User Guide]]|[[Getting Started]]}}
{{Tutorial Header Table |currentpage=2}}

'''Related Links:''' [[File Transfers (Basecamp)]]
----
{{TOC}}
== Introduction ==

There are typically two types of downloading that SysCAD users routinely perform:
#Downloading SysCAD software and updates from the SysCAD website: '''https://www.syscad.net/'''
#Sharing projects and related files on the Basecamp file sharing site: https://syscad-users.basecamphq.com/login
*Note that these sites have different logins and passwords.

This page is for '''Downloading SysCAD Software and Updates'''. See [[File Transfers (Basecamp)]] for Basecamp information.

Each new client is set up with an Administrative user, this user (and others that are given permission) can login to the SysCAD website '''https://www.syscad.net/''' and download the latest software and updates.
This includes:
{|
|[[image:downloadingSysCAD138.png]]
|
# Full installation files for major builds (this is for new users or users upgrading to a new build (e.g. from Build138 to Build139). Please note the full install does not include client specific add-ons. For clients with specific add-ons, please refer to section immediately below.
# SysCAD update files for minor builds, (this is for updates within the same Major Build number, aimed at users with SysCAD Build139 already installed, and wanting to update from say Build139.30918 to Build139.31157).
#* Users can securely download the main SysCAD files. Users will only be able to download SysCAD versions (Build numbers) to which they are entitled. For clients with specific add-ons, please refer to section immediately below.
# Updated and additional documentation (some documentation are included as part of the full install, others are only available here, i.e. supplementary tutorial files)
# Updated separate downloads for Basefiles and Example Files (these are included as part of the full install)
# Updated Utilities files (these are included as part of the full install)
|-
|[[image:downloading addons SysCAD139.png]]
|
SysCAD update files for client specific add-ons.
* Users can securely download their client specific add-ons. Users will only be able to see the client add-ons to which they are entitled. Ensure that the build number for the client add-on is an exact match to the SysCAD version number of the main SysCAD files.
|}

== Downloads (from SysCAD.net) ==

=== Admin User / User Login ===

{|
|[[Image:Download Login.png]]
|
Once a valid username and password have been entered, the user will be directed to a client specific set of available files to download:
* For companies with current upgrade and support agreement, or lease agreement, this will include the latest SysCAD version update, the most current full install file for SysCAD and other related files.
* If the company is entitled to any client specific downloads, then these will also be available on this page.
* For Full installation, please see [[SysCAD Installation Instructions]].
* For SysCAD updates, please see [[SysCAD Installation Instructions#Updating SysCAD|Updating SysCAD]]
|}

=== Reset Password ===

[[Image:Passwordreset2.png]]
If the user has forgotten their password, please click the '''Forgot Password''' button. If this is a valid registered email address, a password reset link will be emailed to you.

=== Admin User ===

[[Image:ManageAccountbutton.png]]

*SysCAD requires each client to nominate a Primary SysCAD Contact(user) and an optional IT/Technical Contact person, contact details required include: Name, email address, contact phone number, contact physical address, position in the company.
*Both the nominated contacts will be set as an "Admin User" for the user site.
*Once the '''Admin User''' logs in with the provided username (usually email address) and password, they can change the password if they wish.
*Admin user can add other users to the site.
*Should the main contact person details change, please notify the SysCAD team, so new Admin User details can be setup to allow your company continued access to the download site.

Once the '''Admin User''' is logged in, they will have an additional button called '''Manage Account'''. (This button is only visible to the Admin user, at the bottom of the page.) This button allows the Admin User to control user access to the company downloads site.

=== Admin User - Manage User Access===

*Admin user can add or remove users
*Users added can choose their own passwords.
To add a new user:
#Fill in the form with the user details
#Select the '''"Send NEW members the welcome email"''' tickbox.
#Press submit.
:[[Image:Add New user.png]]

To remove a user, from the list of names, press the Remove button next to the person to be removed.
:[[Image:Remove user.png]]

=== Trial User ===

'''Downloading the Trial Version'''
*SysCAD Trial Software can be downloaded from the SysCAD Website. For detailed instructions, please refer to the help page: [[SysCAD_License_Options#Trial_Version|Requesting a Trial Version]]
*Once you receive your trial login credentials via email, you can download the SysCAD installation file for evaluation purposes.
*Please note: The trial version is intended for short-term evaluation and typically expires within three months. If your trial expires before your evaluation is complete, contact SysCAD to request an updated trial version of the software.

'''Installing the Trial Version'''
To install the trial version of SysCAD:
*Ensure the installer has local administrator rights on the computer.
*Follow the installation prompts to complete setup.

{{Obtaining a Trial License}}

Tutorial Overview

2026-02-13T06:36:24Z

Keith.Armstrong: /* Supplementary Steady State Tutorial Documentation */

[[Category:Tutorial]]
{{Navigation|[[User Guide]]|[[Getting Started]]|altname=Tutorial}}
{{Tutorial Header Table |currentpage=7}}

----
{{TOC}}

== Introduction ==

To help new SysCAD users, a number of Tutorial documents and example projects are available to demonstrate the many features and functionality in the SysCAD software. Ideally, new users should attend a SysCAD training course.

This section outlines the Tutorial documentation and Projects distributed with SysCAD.

== Tutorial Workbooks and Projects ==

=== Introductory Steady State Tutorial Documentation===
As part of the SysCAD install, some tutorial files are distributed to help users get started with creating their first simple SysCAD project. These files are available to all SysCAD users, they can be found under the '''SysCADxxx\Tutorial''' folder which include:
#'''SysCADGettingStarted.pdf''' - gives a brief introduction on how to obtain a license, and how open and run an existing SysCAD project.
#'''SysCADIntroductoryTutorial.pdf''' (was '''SysCADBasicTutorial.pdf''') - a step-by-step guide to assist the user when learning to build a SysCAD project. This is also a useful reference document for all SysCAD users. See [[#Tutorial Documentation|Tutorial Documentation]] for the course outline.
#'''SysCADQuickReference.pdf''' - a quick reference guide for the commonly used SysCAD commands. We recommend printing this file for easy reference.
#'''Distributed Tutorial Projects''' - Many SysCAD tutorial projects are included in the Tutorial Folder. They are either pre-drawn or saved at the end of each tutorial section. The user may use these to check their projects at the end of each section, if required.

=== Supplementary Steady State Tutorial Documentation ===

The following supplementary steady state tutorial documentation files are available for additional training. Please note that these files are not accessible to all users. Only SysCAD users with a current upgrade and support agreement, or license lease agreement, can download the latest versions from the SysCAD Downloads page https://www.syscad.net/download-software/.
#SysCAD Supplementary Tutorial - [[#Steady State Tutorial - Additional Features|Additional Features]]
#SysCAD Supplementary Tutorial - [[#Steady State Tutorial - Additional Modelling Topics|Additional Modelling Topics]]

The following supplementary tutorial documents are typically used as part of our formal training. They will be provided by the trainer or can be made available upon request:
#SysCAD Supplementary Tutorial - [[#Steady State Tutorial - Gibbs FEM Tutorial|GFEM Tutorial]]
#SysCAD Supplementary Tutorial - [[#Steady State Tutorial - Thermodynamic Calculation Engines|TCE Aqueous Introduction]]
#SysCAD Supplementary Tutorial - [[#Steady State Tutorial - Thermodynamic Calculation Engines|ChemApp Introduction]]


=== Introductory Dynamic Tutorial Documentation ===

The following tutorial document is typically used as part of our formal training. It will be provided by the trainer or can be made available upon request:
#SysCAD Dynamic Tutorial

== Tutorial Content==

A brief summary of the topics covered in each of the tutorial documentation is listed below.

=== Steady State Introductory Tutorial ===
The '''SysCADIntroductoryTutorial.pdf''' document (or '''SysCADBasicTutorial.pdf''' in earlier versions) covers some introduction to SysCAD features in a step-by-step manner.

Topics covered in this document include:
# The basic Commands required in building a SysCAD project.
# Entering Data into the SysCAD Model.
# Editing the SysCAD Species Database and Configuration file.
# Adding Reactions.
# Adding different types of control.
# Merge two existing projects.
# Connect flows between flowsheets.
# Introduction to some advanced features.
# Create and edit reports.

NOTES:
#The document '''SysCADIntroductoryTutorial.pdf''' (or '''SysCADBasicTutorial.pdf''' in earlier versions) is updated from time to time to include the most up to date features. Please check [https://www.syscad.net/login/ SysCAD Downloads] for any new release of software or document updates.
#This document is also available in Spanish and Chinese upon request.

=== Tutorial Videos ===

Some Tutorial Videos are available [[Tutorial Videos | here]]. The user can refer to these for quick demonstrations of selected SysCAD features/functions.

Please note that these videos supplement the SysCADIntroductoryTutorial.pdf, but not all topics covered in the tutorial document contain supplementary video files.

=== Steady State Tutorial - Additional Features ===

Topics covered in this document include:
#Standard Species Model & Energy Balance;
#Density Correction, Heat of Dilution, Solubility and Boiling Point Elevation;
#Introduction to industry related Species Models such as Alumina, Potash and Sugar;
#Adding Annotation (data tables) to the flowsheet;
#Creating New Graphics Symbol;
#Sensitivity Analysis - scenarios, tag list document, command script and COM automation.

=== Steady State Tutorial - Additional Modelling Topics ===

Topics covered in this document include:
#Using sub models in the unit operation. This includes Makeup control, heat loss, evaporation, vapour liquid equilibrium, mass distribution, energy distribution and pressure drop;
#Setting up Demand requirements;
#Deactivating and activating selected flowsheets;
#Using Composition Fetch to set up Feeders, Makeup Sources or increase the convergence speed of large networks;
#Adding user defined property calculations or species information calculations;
#Adding calculations using PGM or MP files;
#Flash Trains;
#Size Distribution;
#Using Ionic Species;
#Using Multi-stage Counter flow tie to model columns and dryers.

=== Steady State Tutorial - Gibbs FEM Tutorial ===

Topics covered in this document relate to using the Gibbs Free Energy Minimisation Reactor model in SysCAD and include:
#How to set up the Reactor(Gibbs FEM) involving single or multiple reactions;
#Using the Reactor(Gibbs FEM) to find Vapour Equilibrium, Adiabatic Flame Temperature;
#Using the Reactor(Gibbs FEM) to simulate a blast furnace - introduction to pyrometallurgy.
#Using the Reactor(Gibbs FEM) for aqueous chemistry, e.g. prediction of pH

=== Steady State Tutorial - Thermodynamic Calculation Engines ===

Thermodynamic Calculation Engines (TCE) currently available are: OLI Studio, PHREEQC, ChemApp and AQSol.

Topics covered in these documents include:
#How to set up the SysCAD project to use the TCE Add-on.
#How to load the TCE database file.
#How to map species between TCE and SysCAD.
#How to use the TCE models such as Direct Calculation, Feeder, Side Calculation and Reactor.
#How to use the TCE utility to create a SysCAD database.
#Demonstrates some common TCE model features.
#Provide answers to some frequently asked questions.

=== Dynamic Introductory Tutorial ===

Topics covered in this tutorial:
#How to set up a dynamic project
#*Model Configuration
#*Adding Level Control
#*Adding Initial contents to tanks
#*Adding variable feed using profiles and noise
#*Adding an event
#*How to handle recycles
#*Adding Batch output
#*Adding Layer Tanks
#How to collect and report data
#*How to set up the archiver to collect data
#*How to set up statistical models
#How to add simple fill and toggle animation
#Introduction to setting up a Material Handling Project
#Introduction to setting up a Flash Train Project
#Introduction to setting up a Precipitation project (Alumina Only)

== Formal Training Course ==

KWA Kenwalt Australia does offer formal training courses on an as needed basis. Please refer to [[Training]] for more information.

== SysCAD Modelling Guideline and Check List ==

Please see [[SysCAD Modelling Guideline and Check List]] for information.

== Example Projects ==

A number of example projects are included as part of the install, these example projects will demonstrate certain features or functionality of SysCAD.

For more information on the distributed example projects, please see [[Example Projects]] for project descriptions.

Template:Notes for USB License Key

2026-02-13T06:32:54Z

Keith.Armstrong:

* Compared to the software license option, a USB License Key is a robust licensing option.
* A USB License Key is convenient when using SysCAD on different desktops and laptops.
* A USB License Key is issued for the purchase of each stand-alone license – the USB License Key "is the SysCAD license".
* USB License Keys can be updated remotely with the purchase of additional license options.
* The USB License Key option is not available for Network licenses or short-term license leases.
* If a USB License Key is lost or stolen, Kenwalt will not be held responsible and the client will need to purchase a replacement SysCAD license. However, if the client has a current upgrade and support agreement, Kenwalt will issue a temporary software license to cover a limited time period so that the client can search for the missing USB License Key or organise to purchase a replacement license.
* If a USB License Key is shown to be faulty, it can be mailed to Kenwalt who will replace the USB License Key. If the client has a current upgrade and support agreement, this will be replaced for free and Kenwalt will issue a temporary software license to cover the time period while the faulty USB License Key is being replaced. If the client does not have a current upgrade and support contract, then they will need to pay an administration fee for their USB License Key to be replaced.
* If a USB License Key has been formatted, cleared, or physically damaged by the client, it can be mailed to Kenwalt who will replace the USB License Key after the client has paid an administration fee. If the client has a current upgrade and support agreement, Kenwalt will issue a temporary software license to cover the time period while the damaged USB License Key is being replaced.

Template:ProductBlog

2026-02-02T05:17:00Z

Keith.Armstrong:

__NOEDITSECTION__{{#if: {{{condensed|}}}||== Latest Updates ==}}
;05 Jan 2026
:{{Info}} Happy New Year 2026!
;18 Dec 2025
:{{Release}} [[Build_139_Revision_History#Build 37069|Build 139.37069]]
::{{MinorUpdate}} Met Dynamics Add-On updated to version 2.1.0
::{{MinorUpdate}} Enhanced Met Dynamics Grinding example project
::{{MinorUpdate}} Various bug fixes and model/UI improvements
;19 Nov 2025
:{{Release}} [[Build_139_Revision_History#Build 37066|Build 139.37066]]
::{{MinorUpdate}} PHREEQC updated to version 3.8.8
::{{MinorUpdate}} New ratio conversion families for mass, mole and volume
::{{MinorUpdate}} Various crash and bug fixes and model and UI improvements
;18 Nov 2025
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-minexcellence-2025/ Minexcellence 2025]
;13 Nov 2025
:{{Info}} Conference attendance: We are exhibiting at [https://www.syscad.net/syscad-at-extraction-2025/ Extraction 2025]

{{#if: {{{condensed|}}}||
== Older Updates ==
;16 Sep 2025
:{{Release}} [[Build_139_Revision_History#Build 37057|Build 139.37057]]
::{{MajorUpdate}} New Evaporator Fixed Pressure example project
::{{MinorUpdate}} Command Line and Command Script improvements
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.9
::{{MinorUpdate}} Various bug fixes, improvements and example project updates
;12 Sep 2025
:{{Info}} Conference attendance: We attended [https://www.syscad.net/syscad-at-uplift-2025/ UPLift 2025]
;25 Jun 2025
:{{Release}} [[Build_139_Revision_History#Build 37044|Build 139.37044]]
::{{MajorUpdate}} New Sugar Evaporator example project
::{{MinorUpdate}} Minor bug fixes
;20 Jun 2025
:{{Release}} [[Build_139_Revision_History#Build 37043|Build 139.37043]]
::{{MinorUpdate}} Updated and enhanced various unit models
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.8
::{{MinorUpdate}} Refreshed and improved multiple example projects
;30 Apr 2025
:{{Release}} [[Build_139_Revision_History#Build 37030|Build 139.37030]]
::{{Info}} The SysCAD installer has been updated to include the latest Microsoft Visual C++ Redistributable
::{{MajorUpdate}} New Met Dynamics Flotation example project
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.7
::{{MinorUpdate}} PHREEQC updated to version 3.8.7
::{{MinorUpdate}} Updated various OLI and AQSol example projects
::{{MinorUpdate}} Wide range of unit model and TCE updates and improvements
;25 Feb 2025
:{{Release}} [[Build_139_Revision_History#Build 37016|Build 139.37016]]
::{{Warning}} WARNING: May require manual updating of Microsoft Visual C++ Redistributable (vc_redist.x86.exe)
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.6
:{{Article}} Discussion Page: [[Discussion: Dynamic Batch Process Modelling|Dynamic Batch Process Modelling]]
;12 Feb 2025
:{{Release}} [[Build_139_Revision_History#Build 37014|Build 139.37014]]
::{{Warning}} WARNING: May require manual updating of Microsoft Visual C++ Redistributable (vc_redist.x86.exe)
::{{MajorUpdate}} Significantly expanded and improved reporting of TCE usage statistics
::{{MajorUpdate}} New Met Dynamics Gravity, Dense Medium and Magnetic Separation example project
;15 Jan 2025
:{{Release}} [[Build_139_Revision_History#Build 37009|Build 139.37009]]
::{{Warning}} WARNING: May require manual updating of Microsoft Visual C++ Redistributable (vc_redist.x86.exe)
::{{MinorUpdate}} Wide range of unit model and TCE updates and improvements
::{{MinorUpdate}} Various Access Window improvements and bug fixes
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.5
;06 Jan 2025
:{{Info}} Happy New Year 2025!
;20 Dec 2024
:{{Info}} Happy Holidays! Our office is closed 21 Dec - 5 Jan. For any issues please [mailto:support@syscad.net contact support].
;14 Nov 2024
:{{Info}} Conference attendance: We attended [https://www.syscad.net/syscad-at-icsoba-2024/ ICSOBA 2024]
;08 Nov 2024
:{{Info}} Conference attendance: We presented at [https://www.syscad.net/syscad-at-skmb-cmp-2024/ SK/MB Canadian Mineral Processors Regional Conference 2024]
;06 Nov 2024
:{{Article}} News: [https://www.syscad.net/syscad-joins-hilt-crc/ SysCAD joins HILT CRC] (Heavy Industry Low-carbon Transition Cooperative Research Centre)
:{{Info}} Conference attendance: We attended the HILT CRC Annual Conference and HiTeMP Forum
;25 Oct 2024
:{{Release}} [[Build_139_Revision_History#Build 36522|Build 139.36522]]
::{{MinorUpdate}} Bug fixes and improvements for copy/paste and data entry
::{{MinorUpdate}} Tidy-up of various Access Window options
;16 Oct 2024
:{{Info}} Conference attendance: We presented at [https://www.syscad.net/syscad-at-geochemical-modelling/ Geochemical Modelling: PHREEQC and Beyond]
;26 Sep 2024
:{{Release}} [[Build_139_Revision_History#Build 36389|Build 139.36389]]
::{{Warning}} WARNING: This build contains a bug where keyboard Insert mode is on by default.
::{{MajorUpdate}} New PHREEQC Ion Exchange and Met Dynamics Grinding example projects
::{{MinorUpdate}} Correction to Bayer3 Dewey BPE method for Alumina add-on
::{{MinorUpdate}} Various Access Window and other bug fixes
::{{MinorUpdate}} New electrical and magnetic conversion families
;19 Sep 2024
:{{Info}} Conference attendance: We are exhibiting at [https://www.syscad.net/syscad-at-impc-2024/ IMPC 2024]
;22 Aug 2024
:{{Release}} [[Build_139_Revision_History#Build 36089|Build 139.36089]]
::{{MinorUpdate}} Important fix for Access Window memory leak
::{{MinorUpdate}} Fix for Bulk Tag Change on Paste Graphics
;20 Aug 2024
:{{Release}} [[Build_139_Revision_History#Build 36061|Build 139.36061]]
::{{Warning}} WARNING: This build contains a bug causing Access Window to become sluggish over time.
::{{MajorUpdate}} New TCE Dynamic Tank models for ChemApp and PHREEQC
::{{MajorUpdate}} Met Dynamics Add-On updated 2.0.3 & new example project
::{{MinorUpdate}} Reworked Change Monitor troubleshooting tool
::{{MinorUpdate}} Various bug/crash fixes and UI improvements
;19 Aug 2024
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-critical-minerals-2024/ Critical Minerals 2024]
;28 Jun 2024
:{{Article}} News: [https://www.syscad.net/met-dynamics-add-on-for-mineral-processing/ Met Dynamics Add-On for Mineral Processing]
;03 Jun 2024
:{{Info}} Conference attendance: We are exhibiting at [https://www.syscad.net/syscad-at-molten-2024/ MOLTEN 2024]
;31 May 2024
:{{Release}} [[Build_139_Revision_History#Build 35544|Build 139.35544]] update released.
::{{MajorUpdate}} New Met Dynamics add-on and example project for mineral processing
::{{MajorUpdate}} New REE SX example project developed for ALTA 2024
::{{MinorUpdate}} PGM, TCE and unit updates and improvements
;21 May 2024
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-alta-2024/ ALTA 2024]
;13 May 2024
:{{Article}} Spotlight Article: [https://www.syscad.net/the-sweet-spot-simulation-for-sugar-processing/ The Sweet Spot - Simulation for Sugar Processing]
;23 Apr 2024
:{{Release}} [[Build_139_Revision_History#Build 35250|Build 139.35250]] update released.
::{{MajorUpdate}} New Reboiler/Condenser Heat Exchanger unit model and example project
::{{MajorUpdate}} New Dynamic Sugar Centrifuge example project
::{{MinorUpdate}} Fixes for various crashes and calculation methods
::{{MinorUpdate}} New engineering unit conversion families
;22 Apr 2024
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-sit-2024/ SIT 2024]
;15 Apr 2024
:{{Info}} Conference attendance: We are exhibiting and presenting a keynote address at [https://www.syscad.net/keynote-address-at-aqw-2024/ AQW 2024]
;19 Mar 2024
:{{Release}} [[Build_139_Revision_History#Build 35102|Build 139.35102]] update released.
::{{MinorUpdate}} Important fix for droplists not updating in Feeder, Makeup and Discard
::{{MinorUpdate}} Various bug, crash and stability fixes for UI, save/load and TCE
;06 Mar 2024
:{{Release}} [[Build_139_Revision_History#Build 34985|Build 139.34985]] update released.
::{{Warning}} WARNING: This build contains a bug with Feeder, Makeup and Discard droplists.
::{{MajorUpdate}} New OLI Solvent Extraction unit model
::{{MinorUpdate}} Improved graphics symbol preview for Insert Unit and Symbol
::{{MinorUpdate}} Fix for tag size/rotation bug
;29 Feb 2024
:{{Tip}} Remember to account for leap years in "per year" calculations, e.g. by using a [[Discussion: Annual Climate Data for Dynamic Modelling, Part III#The Julian Year|Julian Year]] (365.25 days)
;28 Feb 2024
:{{Video}} Video: [https://www.youtube.com/watch?v=_c4v2gtPUFI First Principles Modelling of Mine Wastewater Treatment]
;16 Feb 2024
:{{Release}} [[Build_139_Revision_History#Build 34893|Build 139.34893]] update released.
::{{MajorUpdate}} Support for AQSol v3 DLLs with faster solve time
::{{MajorUpdate}} Selection of fonts for Insert/Change Text
::{{MinorUpdate}} Fix for reaction extent using User Calc
::{{MinorUpdate}} Wide variety of unit model, UI, PGM and TCE improvements
;14 Feb 2024
:{{Article}} Discussion Page: [[Discussion: Machine Learning and Neural Networks for Process Simulation|Machine Learning and Neural Networks for Process Simulation]]
;11 Jan 2024
:{{Release}} [[Build_139_Revision_History#Build 34613|Build 139.34613]] update released.
::{{MinorUpdate}} Flash train reporting improvements at max pressure
::{{MinorUpdate}} Fix for startup crash with PGM setting Makeup Block
;08 Jan 2024
:{{Info}} Happy New Year 2024!
:{{Tip}} Follow us on [https://www.linkedin.com/company/syscad LinkedIn] for the latest news and articles.
;22 Dec 2023
:{{Info}} Happy Holidays! Our office is closed 22 Dec - 8 Jan. For any issues please [mailto:support@syscad.net contact support].
;19 Dec 2023
:{{Article}} Spotlight Article: [https://www.syscad.net/seven-golden-rules-of-process-modelling/ Seven Golden Rules of Process Modelling]
;14 Dec 2023
:{{Release}} [[Build_139_Revision_History#Build 34461|Build 139.34461]] update released.
::{{MajorUpdate}} New Raffinate Water Treatment with Adsorption example project
::{{MinorUpdate}} Added display for Normalised Relative Error (CvgError)
::{{MinorUpdate}} Improved Pipe recycle Tears
;15 Nov 2023
:{{Release}} [[Build_139_Revision_History#Build 34246|Build 139.34246]] update released.
::{{MajorUpdate}} New OLI Pond TCE unit model
::{{MinorUpdate}} Various TCE fixes and improvements
::{{MinorUpdate}} Fix for Reaction Block with zero extent
;19 Oct 2023
:{{Release}} [[Build_139_Revision_History#Build 34068|Build 139.34068]] update released.
::{{MajorUpdate}} Updated Reaction Editor - recommend upgrading
::{{MinorUpdate}} Fixes and improvements for various VLE and HX units
::{{MinorUpdate}} SysCAD Data Entry Style for RHS of string fields
::{{MinorUpdate}} TCE SideCalc and Feeder bug fixes
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-metplant-2023/ MetPlant 2023]
;03 Oct 2023
:{{Article}} Discussion Page: [[Discussion: Ternary Saturation Diagrams using PHREEQC|Ternary Saturation Diagrams using PHREEQC]]
;28 Sep 2023
:{{Release}} [[Build_139_Revision_History#Build 33873|Build 139.33873]] update released.
::{{MinorUpdate}} Fix for incorrect VLE BPE.Method on insert unit
::{{MinorUpdate}} Fix for User Species Calculations using volume
::{{MinorUpdate}} Wide range of fixes for various other units and models
;22 Sep 2023
:{{Article}} Discussion Page: [[Discussion: K Values in Multicomponent VLE|K Values in Multicomponent VLE]]
;29 Aug 2023
:{{Release}} [[Build_139_Revision_History#Build 33632|Build 139.33632]] update released.
::{{MajorUpdate}} New Green Steelmaking example project
::{{MinorUpdate}} Additional stream property tags
::{{MinorUpdate}} Fixes for various unit models
;28 Aug 2023
:{{Video}} Video: [https://youtu.be/jaGRn5Eu4sg Theoretical and Practical Limitations of Hydrogen Steelmaking – A Process Simulation Perspective]
;08 Aug 2023
:{{Release}} [[Build_139_Revision_History#Build 33513|Build 139.33513]] update released.
::{{MajorUpdate}} New 'Step or Idle' (F10) command in Actions menu
::{{MinorUpdate}} Improved Conversions tab in Project Window
::{{MinorUpdate}} Fix for edge case bug with TCE ion mapping
;07 Aug 2023
:{{Info}} Conference attendance: We presented at the [https://www.syscad.net/syscad-at-the-14th-annual-academic-conference-of-the-nonferrous-metals-society-of-china/ 14th Annual Academic Conference of the Nonferrous Metals Society of China]
;02 Aug 2023
:{{Release}} [[Build_139_Revision_History#Build 33457|Build 139.33457]] update released.
::{{MajorUpdate}} New 'FeedCalc' option for Simple Heater
::{{MajorUpdate}} New keyboard shortcut commands, including 'Copy Displayed'
::{{MinorUpdate}} Updates for various unit models, TCE ion mapping and example projects
::{{MinorUpdate}} Updated Introductory Tutorial and Reaction Editor
;24 Jul 2023
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-com-2023/ COM 2023]
;13 Jul 2023
:{{Article}} Discussion Page: [[Discussion: Estimation of Specific Heat for Mineral Species|Estimation of Specific Heat for Mineral Species]]
;05 Jul 2023
:{{Video}} Video: [https://www.youtube.com/watch?v=D_FwFJ-JZzc Use of the THEREDA Database in ChemApp for Potash Process Modelling]
;22 Jun 2023
:{{Release}} [[Build_139_Revision_History#Build 33127|Build 139.33127]] update released.
::{{MajorUpdate}} Upgraded to PHREEQC version 3.7.3-15968.
::{{MinorUpdate}} Trend window x-axis grid improvements.
::{{MinorUpdate}} Flange, Tear, DirectLink and Links Table tidy-ups.
::{{MinorUpdate}} General Controller option to reset values to initial defaults.
;14 Jun 2023
:{{Info}} Conference attendance: We are presenting at the [https://www.syscad.net/syscad-at-25th-gtt-users-meeting-2023/ 25th GTT Users' Meeting 2023]
;18 May 2023
:{{Release}} [[Build_139_Revision_History#Build 33001|Build 139.33001]] update released.
::{{MinorUpdate}} Reaction Block improvements.
::{{MinorUpdate}} Fix for crash with OLI units in Build 139.32925.
;04 May 2023
:{{Release}} [[Build_139_Revision_History#Build 32925|Build 139.32925]] update released.
::{{MajorUpdate}} New VS Code extension for PGM syntax highlighting
::{{MajorUpdate}} Reaction Editor v1.5 and reaction block improvements
::{{MajorUpdate}} New Target Stream split flows method
::{{MinorUpdate}} Various unit model improvements and bug fixes
::{{MinorUpdate}} Options to change graphics and trend line weight
::{{MinorUpdate}} 'Upgrade Compatibility Checks' option to identify old models
:{{Tip}} To access new features, we recommend a full install for Build 139.32925
;21 Apr 2023
:{{Video}} Video: [https://www.youtube.com/watch?v=GTuftUA5iks Modelling Non-Ideal Binary Solutions using SysCAD GFEM and Optimising Solution Parameters]
;29 Mar 2023
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-ex-mente-pyro-week-2023/ Ex Mente Pyro Week 2023]
;23 Feb 2023
:{{Release}} [[Build_139_Revision_History#Build 32530|Build 139.32530]] update released.
::{{MajorUpdate}} New PGM syntax, macros, functions, class options
::{{MajorUpdate}} New debug option for General Controller PGM
::{{MinorUpdate}} Heap Leach model and TCE fixes/improvements
::{{MinorUpdate}} Fix for recycle tears without flow
;02 Feb 2023
:{{Article}} Spotlight Article: [https://www.syscad.net/learning-with-syscad/ Learning with SysCAD]
;17 Jan 2023
:{{Release}} [[Build_139_Revision_History#Build 32335|Build 139.32335]] update released.
::{{MajorUpdate}} New functionality for dynamic model spills and vents
::{{MajorUpdate}} New Hybrid GFEM + ChemApp Electric Furnace example project
::{{MinorUpdate}} Updated keywords and syntax for PGM
::{{MinorUpdate}} TCE forward mapping summary with results
;09 Jan 2023
:{{Info}} Happy New Year! We look forward to working with you in 2023.
:{{Tip}} Follow us on [https://www.linkedin.com/company/syscad LinkedIn] for the latest news and articles.
;21 Dec 2022
:{{Info}} Happy Holidays! Our office is closed 22 Dec - 3 Jan. For any issues please [mailto:support@syscad.net contact support].
;19 Dec 2022
:{{Release}} [[Build_139_Revision_History#Build 32217|Build 139.32217]] update released.
::{{MajorUpdate}} New PHREEQC Raffinate Water Treatment example project
::{{MajorUpdate}} Range of new PGM functions and keywords
::{{MinorUpdate}} Fixes for demand with offline units or zero flow
::{{MinorUpdate}} Various TCE, UI and unit model improvements
;21 Nov 2022
:{{Article}} Spotlight Article: [https://www.syscad.net/from-digital-prototype-to-digital-twin/ From Digital Prototype to Digital Twin]
;08 Nov 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=QQvJLG7ZSVE Advances in Simulation of Agglomeration in Bayer Precipitation (Part I)]
:{{Video}} Video: [https://www.youtube.com/watch?v=7heIAGTiy-8 Advances in Simulation of Agglomeration in Bayer Precipitation (Part II)]
;26 Oct 2022
:{{Release}} [[Build_139_Revision_History#Build 31866|Build 139.31866]] update released.
::{{MajorUpdate}} OLI officially released as part of TCE add-on
::{{MajorUpdate}} New example project using Python for multivariable optimisation
::{{MinorUpdate}} Reworked steady-state monitor and finder for dynamic solver
::{{MinorUpdate}} Significant list of bug fixes and improvements
:{{Tip}} TCE license options are now combined as a single TCE add-on.
;18 Oct 2022
:{{Info}} Honoured to be awarded [//www.linkedin.com/feed/update/urn:li:activity:6988095699053596672 Best Alumina Paper] at ICSOBA 2022!
;07 Oct 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-icsoba-2022/ ICSOBA 2022]
;06 Sep 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=phRdsPywXvE Modelling Dynamic Ion Exchange Uranium Processes]
;27 Aug 2022
:{{Release}} [[Build_139_Revision_History#Build 31623|Build 139.31623]] update released.
::{{MinorUpdate}} Fixes for various crashes in recent updates
;22 Aug 2022
:{{Release}} [[Build_139_Revision_History#Build 31602|Build 139.31602]] update released.
::{{MinorUpdate}} Allow loading TCE demo projects without license add-on
::{{MinorUpdate}} Fix for dynamic control reset of PID and tank level control
::{{MinorUpdate}} Various TCE and PGM improvements
;16 Aug 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=x_khIJOq6-0 Digital Transformation using Simulation in a Project Life Cycle]
;03 Aug 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=aZsECW1WoO8 Dynamic Simulation of Batch Copper Converting with ChemApp]
;02 Aug 2022
:{{Release}} [[Build_139_Revision_History#Build 31388|Build 139.31388]] update released.
::{{MajorUpdate}} New option to prevent solver start in case of missing files
::{{MajorUpdate}} New PGM functionality
::{{MinorUpdate}} Various user interface bug fixes and improvements
;29 Jul 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-com-2022/ COM 2022]
;13 Jul 2022
:{{Article}} Spotlight Article: [https://www.syscad.net/thermodynamic-calculation-engines-in-syscad/ Thermodynamic Calculation Engines in SysCAD]
;12 Jul 2022
:{{Release}} [[Build_139_Revision_History#Build 31218|Build 139.31218]] update released.
::{{MajorUpdate}} New PGM PSD class functions
::{{MinorUpdate}} Fix for bugs introduced in 31207
;08 Jul 2022
:{{Release}} [[Build_139_Revision_History#Build 31207|Build 139.31207]] update released.
::{{MinorUpdate}} Explorer window, toolbars and graphics improvements
::{{MinorUpdate}} Fix for Makeup Blocks and Sources
;29 Jun 2022
:{{Release}} [[Build_139_Revision_History#Build 31157|Build 139.31157]] update released.
::{{MajorUpdate}} Implemented TagSelect within Command Script ReportTags
::{{MinorUpdate}} Option to control phase change limits for VLE, plus new warnings
::{{MinorUpdate}} Fix for graphics (.dxf) file size increasing
;27 Jun 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-gtt-users-meeting-2022/ GTT Users' Meeting 2022]
;25 May 2022
:{{Article}} Discussion Page: [[Discussion: Annual Climate Data for Dynamic Modelling, Part III|Annual Climate Data for Dynamic Modelling, Part III]]
:{{Video}} Video: [https://www.youtube.com/watch?v=PDLnWF5ntkY Modelling Solvent Extraction of Uranium with Molybdenum Control]
;24 May 2022
:{{Article}} Discussion Page: [[Discussion: Annual Climate Data for Dynamic Modelling, Part II|Annual Climate Data for Dynamic Modelling, Part II]]
;18 May 2022
:{{Release}} [[Build_139_Revision_History#Build 30918|Build 139.30918]] update released.
::{{MajorUpdate}} New Uranium Solvent Extraction demo project using PHREEQC
::{{MinorUpdate}} Energy balance correction for CCD and Classifier
::{{MinorUpdate}} Various stability improvements
;11 May 2022
:{{Release}} [[Build_139_Revision_History#Build 30874|Build 139.30874]] update released.
::{{MajorUpdate}} New Waveform Controller options
::{{MinorUpdate}} Improved display for multi-component VLE
::{{MinorUpdate}} Various TCE improvements
;03 May 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-alta-2022/ ALTA 2022]
;27 Apr 2022
:{{Release}} [[Build_139_Revision_History#Build 30807|Build 139.30807]] update released.
::{{MajorUpdate}} Fix for Precip3 PSD method with PSD Create/Modify in Product stream.
::{{MajorUpdate}} TCE improvements including new TCE Feeder unit model.
::{{MinorUpdate}} Various new PGM functions and improvements.
;13 Apr 2022
:{{Article}} Discussion Page: [[Discussion: Annual Climate Data for Dynamic Modelling|Annual Climate Data for Dynamic Modelling]]
;05 Apr 2022
:{{Release}} [[Build_139_Revision_History#Build 30670|Build 139.30670]] update released.
::{{MajorUpdate}} New Link to Makeup Source option.
::{{MinorUpdate}} Access window and TCE fixes.
;23 Mar 2022
:{{Release}} [[Build_139_Revision_History#Build 30613|Build 139.30613]] update released.
::{{MajorUpdate}} New Alumina Precip3 agglomeration kernel David-Rijkeboer.
;21 Mar 2022
:{{Release}} [[Build_139_Revision_History#Build 30599|Build 139.30599]] update released.
::{{MajorUpdate}} New PGM functions for Classes and Arrays.
::{{MinorUpdate}} Stricter checking of TCE ion definitions (ionlist.txt).
::{{MinorUpdate}} Various Access Window display improvements.
;04 Mar 2022
:{{Release}} [[Build_139_Revision_History#Build 30498|Build 139.30498]] update released.
::{{MajorUpdate}} New Filter Press WashCalc option.
;25 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30448|Build 139.30448]] update released.
::{{MajorUpdate}} New access window auto-layout option.
::{{MinorUpdate}} Crash fixes for ChemApp and TagList.
;22 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30427|Build 139.30427]] update released.
::{{MinorUpdate}} Fixed critical solver convergence error in Builds 30316 and 30376.
;15 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30376|Build 139.30376]] update released.
::{{MinorUpdate}} Further reduced memory usage, various bug fixes and improvements.
:{{Article}} Discussion Page: [[Discussion: Transfer Push and Pull for Batch Processes|Transfer Push and Pull for Batch Processes]]
;04 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30316|Build 139.30316]] update released.
;02 Feb 2022
:{{Article}} Discussion Page: [[Discussion: Air in Modelling|Air in Modelling]]
;01 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30270|Build 139.30270]] update released.
::{{MinorUpdate}} Reduced memory usage.
::{{MinorUpdate}} Various TCE model improvements.
;31 Jan 2022
:{{Article}} Discussion Page: [[Discussion: New Reaction Heat Features in Alumina Precipitation Models|New Reaction Heat Features in Alumina Precipitation Models]]
;12 Jan 2022
:{{Release}} [[Build_139_Revision_History#Build 30140|Build 139.30140]] update released.
::{{MajorUpdate}} Official release of [[AQSol Add-On]], plus new [[Example - 08 AQSol Projects|AQSol example projects]].
::{{MajorUpdate}} Reaction Editor 1.4 including improved reaction balancing.
::{{MinorUpdate}} Various species database, energy balance, PGM, feeder and makeup improvements.
;21 Dec 2021
:{{Info}} Happy Holidays! Our office is closed 22 Dec - 5 Jan. For any issues please [mailto:support@syscad.net contact support].
;15 Dec 2021
:{{Article}} Spotlight Article: [https://www.syscad.net/potash-process-modelling-for-a-growing-industry/ Potash - Process Modelling for a Growing Industry]
;29 Nov 2021
:{{Release}} [[Build_139_Revision_History#Build 29945|Build 139.29945]] update released.
;23 Nov 2021
:{{Release}} [[Build_139_Revision_History#Build 29907|Build 139.29907]] update released.
::{{MajorUpdate}} New search function for Insert Symbol/Unit graphics.
::{{MinorUpdate}} Improved TCE Configuration for AQSol.
::{{MinorUpdate}} Various visual, project crash and bug fixes.
;03 Nov 2021
:{{Article}} Discussion Page: [[Discussion: Rare Earths Example Project|Rare Earths Example Project]]
;27 Oct 2021
:{{Release}} [[Build_139_Revision_History#Build 29722|Build 139.29722]] update released.
::{{MinorUpdate}} Improved entropy calculation for water below 0°C.
;26 Oct 2021
:{{Article}} Discussion Page: [[Discussion: Alumina Precipitation and Classification with PSD|Alumina Precipitation and Classification with PSD]]
;22 Oct 2021
:{{Release}} [[Build_139_Revision_History#Build 29706|Build 139.29706]] update released.
::{{MajorUpdate}} New configuration editor for Thermodynamic Calculation Engine (TCE) databases.
::{{MinorUpdate}} Reaction Block (RB), TCE and FEM improvements.
;22 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29552|Build 139.29552]] update released.
::{{MajorUpdate}} New example project - [[Precipitation Projects#Example 5: Precipitation and Classification Example Project using Full Particle Size Data (PSD)|Alumina Precipitation and Classification with PSD]]
::{{MajorUpdate}} Added column to sort configuration (cfg) files by access date.
::{{MinorUpdate}} Improved project save/load.
;14 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29506|Build 139.29506]] update released.
::{{MinorUpdate}} Improvements for Shell and Tube Heat Exchanger 2 condensing mode.
:{{Article}} Spotlight Article: [https://www.syscad.net/bayer-process-modelling-for-the-alumina-industry/ Bayer Process Modelling for the Alumina Industry]
;06 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29465|Build 139.29465]] update released.
;01 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29437|Build 139.29437]] update released.
::{{MajorUpdate}} New option to zip project files (Project > Zip Project).
;27 Aug 2021
:{{Release}} [[Build_139_Revision_History#Build 29390|Build 139.29390]] update released.
::{{MinorUpdate}} Improved handling for multiple users on same project file.
;26 Aug 2021
:{{Video}} Video: [https://www.youtube.com/watch?v=kxLHuw3P91s Modelling Solvent Extraction Separation of Neodymium from Praseodymium]
;25 Aug 2021
:{{Release}} '''Build 139 official release''' - [[Build_139_Revision_History#Build 29370|Build 139.29370]]
::{{MajorUpdate}} See [[Build 139 Release Notes]] for full list of changes and new features.
::{{Tip}} Now available on the [https://www.syscad.net/login/ Downloads page] for users with active Upgrade & Support.
::{{Info}} If required, please [mailto:support@syscad.net contact us] for upgrade support.
;19 Aug 2021
:{{Release}} [[Build_139_Revision_History#Build 29334 (BETA)|Build 139.29334 BETA]] update released.
::{{MajorUpdate}} New [[Alumina3 Precip - Full PSD#Kernel Builder|Agglomeration Kernel Builder]] added to Alumina [[Precipitation3]].
;12 Aug 2021
:{{Video}} Video: [https://www.youtube.com/watch?v=0zde5f7-NeA Particle Size Distribution Visualisation]
;06 Aug 2021
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-com-2021/ COM 2021]
;28 Jul 2021
:{{Release}} [[Build_139_Revision_History#Build 29199 (BETA)|Build 139.29199 BETA]] update released.
;15 Jul 2021
:{{Release}} [[Build_139_Revision_History#Build 29102 (BETA)|Build 139.29102 BETA]] update released.
;23 Jun 2021
:{{Article}} Spotlight Article: [https://www.syscad.net/syscad-in-the-life-cycle-of-plant-development/ SysCAD in the Life Cycle of Plant Development]
;18 Jun 2021
:{{Info}} Follow us on [https://www.linkedin.com/company/syscad LinkedIn] for company news and process modelling highlights.
;17 Jun 2021
:{{Video}} Video: [https://www.youtube.com/watch?v=SA3nlthmg-c SysCAD Reporting Tools]
;10 Jun 2021
:{{Release}} [[Build_139_Revision_History#Build 28898 (BETA)|Build 139.28898 BETA]] released.
::{{MajorUpdate}} See [[Build 139 Release Notes]] for full list of changes and new features.
::{{Info}} Please [mailto:info@syscad.net contact us] for BETA access.
;09 Jun 2021
:{{Info}} Welcome to the '''Product Blog'''! Check back here for the latest SysCAD news and updates.
== Icon Legend ==
:{{Release}} Build Release
::{{MajorUpdate}} Major Update
::{{MinorUpdate}} Minor Update
::{{Warning}} Warning
:{{Tip}} [[Tips and Tricks|Tips & Tricks]]
:{{Article}} [https://www.syscad.net/category/articles/ Spotlight Articles] and [[Discussion Pages]]
:{{Video}} [https://www.youtube.com/SysCADVideos Videos]
:{{Info}} [https://www.syscad.net/category/news/ News] and General Information
}}

Template:ProductBlog

2026-02-02T05:15:16Z

Keith.Armstrong:

__NOEDITSECTION__{{#if: {{{condensed|}}}||== Latest Updates ==}}
;18 Dec 2025
:{{Release}} [[Build_139_Revision_History#Build 37069|Build 139.37069]]
::{{MinorUpdate}} Met Dynamics Add-On updated to version 2.1.0
::{{MinorUpdate}} Enhanced Met Dynamics Grinding example project
::{{MinorUpdate}} Various bug fixes and model/UI improvements
;19 Nov 2025
:{{Release}} [[Build_139_Revision_History#Build 37066|Build 139.37066]]
::{{MinorUpdate}} PHREEQC updated to version 3.8.8
::{{MinorUpdate}} New ratio conversion families for mass, mole and volume
::{{MinorUpdate}} Various crash and bug fixes and model and UI improvements
;18 Nov 2025
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-minexcellence-2025/ Minexcellence 2025]
;13 Nov 2025
:{{Info}} Conference attendance: We are exhibiting at [https://www.syscad.net/syscad-at-extraction-2025/ Extraction 2025]

{{#if: {{{condensed|}}}||
== Older Updates ==
;16 Sep 2025
:{{Release}} [[Build_139_Revision_History#Build 37057|Build 139.37057]]
::{{MajorUpdate}} New Evaporator Fixed Pressure example project
::{{MinorUpdate}} Command Line and Command Script improvements
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.9
::{{MinorUpdate}} Various bug fixes, improvements and example project updates
;12 Sep 2025
:{{Info}} Conference attendance: We attended [https://www.syscad.net/syscad-at-uplift-2025/ UPLift 2025]
;25 Jun 2025
:{{Release}} [[Build_139_Revision_History#Build 37044|Build 139.37044]]
::{{MajorUpdate}} New Sugar Evaporator example project
::{{MinorUpdate}} Minor bug fixes
;20 Jun 2025
:{{Release}} [[Build_139_Revision_History#Build 37043|Build 139.37043]]
::{{MinorUpdate}} Updated and enhanced various unit models
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.8
::{{MinorUpdate}} Refreshed and improved multiple example projects
;30 Apr 2025
:{{Release}} [[Build_139_Revision_History#Build 37030|Build 139.37030]]
::{{Info}} The SysCAD installer has been updated to include the latest Microsoft Visual C++ Redistributable
::{{MajorUpdate}} New Met Dynamics Flotation example project
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.7
::{{MinorUpdate}} PHREEQC updated to version 3.8.7
::{{MinorUpdate}} Updated various OLI and AQSol example projects
::{{MinorUpdate}} Wide range of unit model and TCE updates and improvements
;25 Feb 2025
:{{Release}} [[Build_139_Revision_History#Build 37016|Build 139.37016]]
::{{Warning}} WARNING: May require manual updating of Microsoft Visual C++ Redistributable (vc_redist.x86.exe)
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.6
:{{Article}} Discussion Page: [[Discussion: Dynamic Batch Process Modelling|Dynamic Batch Process Modelling]]
;12 Feb 2025
:{{Release}} [[Build_139_Revision_History#Build 37014|Build 139.37014]]
::{{Warning}} WARNING: May require manual updating of Microsoft Visual C++ Redistributable (vc_redist.x86.exe)
::{{MajorUpdate}} Significantly expanded and improved reporting of TCE usage statistics
::{{MajorUpdate}} New Met Dynamics Gravity, Dense Medium and Magnetic Separation example project
;15 Jan 2025
:{{Release}} [[Build_139_Revision_History#Build 37009|Build 139.37009]]
::{{Warning}} WARNING: May require manual updating of Microsoft Visual C++ Redistributable (vc_redist.x86.exe)
::{{MinorUpdate}} Wide range of unit model and TCE updates and improvements
::{{MinorUpdate}} Various Access Window improvements and bug fixes
::{{MinorUpdate}} Met Dynamics Add-On updated 2.0.5
;06 Jan 2025
:{{Info}} Happy New Year 2025!
;20 Dec 2024
:{{Info}} Happy Holidays! Our office is closed 21 Dec - 5 Jan. For any issues please [mailto:support@syscad.net contact support].
;14 Nov 2024
:{{Info}} Conference attendance: We attended [https://www.syscad.net/syscad-at-icsoba-2024/ ICSOBA 2024]
;08 Nov 2024
:{{Info}} Conference attendance: We presented at [https://www.syscad.net/syscad-at-skmb-cmp-2024/ SK/MB Canadian Mineral Processors Regional Conference 2024]
;06 Nov 2024
:{{Article}} News: [https://www.syscad.net/syscad-joins-hilt-crc/ SysCAD joins HILT CRC] (Heavy Industry Low-carbon Transition Cooperative Research Centre)
:{{Info}} Conference attendance: We attended the HILT CRC Annual Conference and HiTeMP Forum
;25 Oct 2024
:{{Release}} [[Build_139_Revision_History#Build 36522|Build 139.36522]]
::{{MinorUpdate}} Bug fixes and improvements for copy/paste and data entry
::{{MinorUpdate}} Tidy-up of various Access Window options
;16 Oct 2024
:{{Info}} Conference attendance: We presented at [https://www.syscad.net/syscad-at-geochemical-modelling/ Geochemical Modelling: PHREEQC and Beyond]
;26 Sep 2024
:{{Release}} [[Build_139_Revision_History#Build 36389|Build 139.36389]]
::{{Warning}} WARNING: This build contains a bug where keyboard Insert mode is on by default.
::{{MajorUpdate}} New PHREEQC Ion Exchange and Met Dynamics Grinding example projects
::{{MinorUpdate}} Correction to Bayer3 Dewey BPE method for Alumina add-on
::{{MinorUpdate}} Various Access Window and other bug fixes
::{{MinorUpdate}} New electrical and magnetic conversion families
;19 Sep 2024
:{{Info}} Conference attendance: We are exhibiting at [https://www.syscad.net/syscad-at-impc-2024/ IMPC 2024]
;22 Aug 2024
:{{Release}} [[Build_139_Revision_History#Build 36089|Build 139.36089]]
::{{MinorUpdate}} Important fix for Access Window memory leak
::{{MinorUpdate}} Fix for Bulk Tag Change on Paste Graphics
;20 Aug 2024
:{{Release}} [[Build_139_Revision_History#Build 36061|Build 139.36061]]
::{{Warning}} WARNING: This build contains a bug causing Access Window to become sluggish over time.
::{{MajorUpdate}} New TCE Dynamic Tank models for ChemApp and PHREEQC
::{{MajorUpdate}} Met Dynamics Add-On updated 2.0.3 & new example project
::{{MinorUpdate}} Reworked Change Monitor troubleshooting tool
::{{MinorUpdate}} Various bug/crash fixes and UI improvements
;19 Aug 2024
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-critical-minerals-2024/ Critical Minerals 2024]
;28 Jun 2024
:{{Article}} News: [https://www.syscad.net/met-dynamics-add-on-for-mineral-processing/ Met Dynamics Add-On for Mineral Processing]
;03 Jun 2024
:{{Info}} Conference attendance: We are exhibiting at [https://www.syscad.net/syscad-at-molten-2024/ MOLTEN 2024]
;31 May 2024
:{{Release}} [[Build_139_Revision_History#Build 35544|Build 139.35544]] update released.
::{{MajorUpdate}} New Met Dynamics add-on and example project for mineral processing
::{{MajorUpdate}} New REE SX example project developed for ALTA 2024
::{{MinorUpdate}} PGM, TCE and unit updates and improvements
;21 May 2024
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-alta-2024/ ALTA 2024]
;13 May 2024
:{{Article}} Spotlight Article: [https://www.syscad.net/the-sweet-spot-simulation-for-sugar-processing/ The Sweet Spot - Simulation for Sugar Processing]
;23 Apr 2024
:{{Release}} [[Build_139_Revision_History#Build 35250|Build 139.35250]] update released.
::{{MajorUpdate}} New Reboiler/Condenser Heat Exchanger unit model and example project
::{{MajorUpdate}} New Dynamic Sugar Centrifuge example project
::{{MinorUpdate}} Fixes for various crashes and calculation methods
::{{MinorUpdate}} New engineering unit conversion families
;22 Apr 2024
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-sit-2024/ SIT 2024]
;15 Apr 2024
:{{Info}} Conference attendance: We are exhibiting and presenting a keynote address at [https://www.syscad.net/keynote-address-at-aqw-2024/ AQW 2024]
;19 Mar 2024
:{{Release}} [[Build_139_Revision_History#Build 35102|Build 139.35102]] update released.
::{{MinorUpdate}} Important fix for droplists not updating in Feeder, Makeup and Discard
::{{MinorUpdate}} Various bug, crash and stability fixes for UI, save/load and TCE
;06 Mar 2024
:{{Release}} [[Build_139_Revision_History#Build 34985|Build 139.34985]] update released.
::{{Warning}} WARNING: This build contains a bug with Feeder, Makeup and Discard droplists.
::{{MajorUpdate}} New OLI Solvent Extraction unit model
::{{MinorUpdate}} Improved graphics symbol preview for Insert Unit and Symbol
::{{MinorUpdate}} Fix for tag size/rotation bug
;29 Feb 2024
:{{Tip}} Remember to account for leap years in "per year" calculations, e.g. by using a [[Discussion: Annual Climate Data for Dynamic Modelling, Part III#The Julian Year|Julian Year]] (365.25 days)
;28 Feb 2024
:{{Video}} Video: [https://www.youtube.com/watch?v=_c4v2gtPUFI First Principles Modelling of Mine Wastewater Treatment]
;16 Feb 2024
:{{Release}} [[Build_139_Revision_History#Build 34893|Build 139.34893]] update released.
::{{MajorUpdate}} Support for AQSol v3 DLLs with faster solve time
::{{MajorUpdate}} Selection of fonts for Insert/Change Text
::{{MinorUpdate}} Fix for reaction extent using User Calc
::{{MinorUpdate}} Wide variety of unit model, UI, PGM and TCE improvements
;14 Feb 2024
:{{Article}} Discussion Page: [[Discussion: Machine Learning and Neural Networks for Process Simulation|Machine Learning and Neural Networks for Process Simulation]]
;11 Jan 2024
:{{Release}} [[Build_139_Revision_History#Build 34613|Build 139.34613]] update released.
::{{MinorUpdate}} Flash train reporting improvements at max pressure
::{{MinorUpdate}} Fix for startup crash with PGM setting Makeup Block
;08 Jan 2024
:{{Info}} Happy New Year 2024!
:{{Tip}} Follow us on [https://www.linkedin.com/company/syscad LinkedIn] for the latest news and articles.
;22 Dec 2023
:{{Info}} Happy Holidays! Our office is closed 22 Dec - 8 Jan. For any issues please [mailto:support@syscad.net contact support].
;19 Dec 2023
:{{Article}} Spotlight Article: [https://www.syscad.net/seven-golden-rules-of-process-modelling/ Seven Golden Rules of Process Modelling]
;14 Dec 2023
:{{Release}} [[Build_139_Revision_History#Build 34461|Build 139.34461]] update released.
::{{MajorUpdate}} New Raffinate Water Treatment with Adsorption example project
::{{MinorUpdate}} Added display for Normalised Relative Error (CvgError)
::{{MinorUpdate}} Improved Pipe recycle Tears
;15 Nov 2023
:{{Release}} [[Build_139_Revision_History#Build 34246|Build 139.34246]] update released.
::{{MajorUpdate}} New OLI Pond TCE unit model
::{{MinorUpdate}} Various TCE fixes and improvements
::{{MinorUpdate}} Fix for Reaction Block with zero extent
;19 Oct 2023
:{{Release}} [[Build_139_Revision_History#Build 34068|Build 139.34068]] update released.
::{{MajorUpdate}} Updated Reaction Editor - recommend upgrading
::{{MinorUpdate}} Fixes and improvements for various VLE and HX units
::{{MinorUpdate}} SysCAD Data Entry Style for RHS of string fields
::{{MinorUpdate}} TCE SideCalc and Feeder bug fixes
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-metplant-2023/ MetPlant 2023]
;03 Oct 2023
:{{Article}} Discussion Page: [[Discussion: Ternary Saturation Diagrams using PHREEQC|Ternary Saturation Diagrams using PHREEQC]]
;28 Sep 2023
:{{Release}} [[Build_139_Revision_History#Build 33873|Build 139.33873]] update released.
::{{MinorUpdate}} Fix for incorrect VLE BPE.Method on insert unit
::{{MinorUpdate}} Fix for User Species Calculations using volume
::{{MinorUpdate}} Wide range of fixes for various other units and models
;22 Sep 2023
:{{Article}} Discussion Page: [[Discussion: K Values in Multicomponent VLE|K Values in Multicomponent VLE]]
;29 Aug 2023
:{{Release}} [[Build_139_Revision_History#Build 33632|Build 139.33632]] update released.
::{{MajorUpdate}} New Green Steelmaking example project
::{{MinorUpdate}} Additional stream property tags
::{{MinorUpdate}} Fixes for various unit models
;28 Aug 2023
:{{Video}} Video: [https://youtu.be/jaGRn5Eu4sg Theoretical and Practical Limitations of Hydrogen Steelmaking – A Process Simulation Perspective]
;08 Aug 2023
:{{Release}} [[Build_139_Revision_History#Build 33513|Build 139.33513]] update released.
::{{MajorUpdate}} New 'Step or Idle' (F10) command in Actions menu
::{{MinorUpdate}} Improved Conversions tab in Project Window
::{{MinorUpdate}} Fix for edge case bug with TCE ion mapping
;07 Aug 2023
:{{Info}} Conference attendance: We presented at the [https://www.syscad.net/syscad-at-the-14th-annual-academic-conference-of-the-nonferrous-metals-society-of-china/ 14th Annual Academic Conference of the Nonferrous Metals Society of China]
;02 Aug 2023
:{{Release}} [[Build_139_Revision_History#Build 33457|Build 139.33457]] update released.
::{{MajorUpdate}} New 'FeedCalc' option for Simple Heater
::{{MajorUpdate}} New keyboard shortcut commands, including 'Copy Displayed'
::{{MinorUpdate}} Updates for various unit models, TCE ion mapping and example projects
::{{MinorUpdate}} Updated Introductory Tutorial and Reaction Editor
;24 Jul 2023
:{{Info}} Conference attendance: We are exhibiting and presenting at [https://www.syscad.net/syscad-at-com-2023/ COM 2023]
;13 Jul 2023
:{{Article}} Discussion Page: [[Discussion: Estimation of Specific Heat for Mineral Species|Estimation of Specific Heat for Mineral Species]]
;05 Jul 2023
:{{Video}} Video: [https://www.youtube.com/watch?v=D_FwFJ-JZzc Use of the THEREDA Database in ChemApp for Potash Process Modelling]
;22 Jun 2023
:{{Release}} [[Build_139_Revision_History#Build 33127|Build 139.33127]] update released.
::{{MajorUpdate}} Upgraded to PHREEQC version 3.7.3-15968.
::{{MinorUpdate}} Trend window x-axis grid improvements.
::{{MinorUpdate}} Flange, Tear, DirectLink and Links Table tidy-ups.
::{{MinorUpdate}} General Controller option to reset values to initial defaults.
;14 Jun 2023
:{{Info}} Conference attendance: We are presenting at the [https://www.syscad.net/syscad-at-25th-gtt-users-meeting-2023/ 25th GTT Users' Meeting 2023]
;18 May 2023
:{{Release}} [[Build_139_Revision_History#Build 33001|Build 139.33001]] update released.
::{{MinorUpdate}} Reaction Block improvements.
::{{MinorUpdate}} Fix for crash with OLI units in Build 139.32925.
;04 May 2023
:{{Release}} [[Build_139_Revision_History#Build 32925|Build 139.32925]] update released.
::{{MajorUpdate}} New VS Code extension for PGM syntax highlighting
::{{MajorUpdate}} Reaction Editor v1.5 and reaction block improvements
::{{MajorUpdate}} New Target Stream split flows method
::{{MinorUpdate}} Various unit model improvements and bug fixes
::{{MinorUpdate}} Options to change graphics and trend line weight
::{{MinorUpdate}} 'Upgrade Compatibility Checks' option to identify old models
:{{Tip}} To access new features, we recommend a full install for Build 139.32925
;21 Apr 2023
:{{Video}} Video: [https://www.youtube.com/watch?v=GTuftUA5iks Modelling Non-Ideal Binary Solutions using SysCAD GFEM and Optimising Solution Parameters]
;29 Mar 2023
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-ex-mente-pyro-week-2023/ Ex Mente Pyro Week 2023]
;23 Feb 2023
:{{Release}} [[Build_139_Revision_History#Build 32530|Build 139.32530]] update released.
::{{MajorUpdate}} New PGM syntax, macros, functions, class options
::{{MajorUpdate}} New debug option for General Controller PGM
::{{MinorUpdate}} Heap Leach model and TCE fixes/improvements
::{{MinorUpdate}} Fix for recycle tears without flow
;02 Feb 2023
:{{Article}} Spotlight Article: [https://www.syscad.net/learning-with-syscad/ Learning with SysCAD]
;17 Jan 2023
:{{Release}} [[Build_139_Revision_History#Build 32335|Build 139.32335]] update released.
::{{MajorUpdate}} New functionality for dynamic model spills and vents
::{{MajorUpdate}} New Hybrid GFEM + ChemApp Electric Furnace example project
::{{MinorUpdate}} Updated keywords and syntax for PGM
::{{MinorUpdate}} TCE forward mapping summary with results
;09 Jan 2023
:{{Info}} Happy New Year! We look forward to working with you in 2023.
:{{Tip}} Follow us on [https://www.linkedin.com/company/syscad LinkedIn] for the latest news and articles.
;21 Dec 2022
:{{Info}} Happy Holidays! Our office is closed 22 Dec - 3 Jan. For any issues please [mailto:support@syscad.net contact support].
;19 Dec 2022
:{{Release}} [[Build_139_Revision_History#Build 32217|Build 139.32217]] update released.
::{{MajorUpdate}} New PHREEQC Raffinate Water Treatment example project
::{{MajorUpdate}} Range of new PGM functions and keywords
::{{MinorUpdate}} Fixes for demand with offline units or zero flow
::{{MinorUpdate}} Various TCE, UI and unit model improvements
;21 Nov 2022
:{{Article}} Spotlight Article: [https://www.syscad.net/from-digital-prototype-to-digital-twin/ From Digital Prototype to Digital Twin]
;08 Nov 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=QQvJLG7ZSVE Advances in Simulation of Agglomeration in Bayer Precipitation (Part I)]
:{{Video}} Video: [https://www.youtube.com/watch?v=7heIAGTiy-8 Advances in Simulation of Agglomeration in Bayer Precipitation (Part II)]
;26 Oct 2022
:{{Release}} [[Build_139_Revision_History#Build 31866|Build 139.31866]] update released.
::{{MajorUpdate}} OLI officially released as part of TCE add-on
::{{MajorUpdate}} New example project using Python for multivariable optimisation
::{{MinorUpdate}} Reworked steady-state monitor and finder for dynamic solver
::{{MinorUpdate}} Significant list of bug fixes and improvements
:{{Tip}} TCE license options are now combined as a single TCE add-on.
;18 Oct 2022
:{{Info}} Honoured to be awarded [//www.linkedin.com/feed/update/urn:li:activity:6988095699053596672 Best Alumina Paper] at ICSOBA 2022!
;07 Oct 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-icsoba-2022/ ICSOBA 2022]
;06 Sep 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=phRdsPywXvE Modelling Dynamic Ion Exchange Uranium Processes]
;27 Aug 2022
:{{Release}} [[Build_139_Revision_History#Build 31623|Build 139.31623]] update released.
::{{MinorUpdate}} Fixes for various crashes in recent updates
;22 Aug 2022
:{{Release}} [[Build_139_Revision_History#Build 31602|Build 139.31602]] update released.
::{{MinorUpdate}} Allow loading TCE demo projects without license add-on
::{{MinorUpdate}} Fix for dynamic control reset of PID and tank level control
::{{MinorUpdate}} Various TCE and PGM improvements
;16 Aug 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=x_khIJOq6-0 Digital Transformation using Simulation in a Project Life Cycle]
;03 Aug 2022
:{{Video}} Video: [https://www.youtube.com/watch?v=aZsECW1WoO8 Dynamic Simulation of Batch Copper Converting with ChemApp]
;02 Aug 2022
:{{Release}} [[Build_139_Revision_History#Build 31388|Build 139.31388]] update released.
::{{MajorUpdate}} New option to prevent solver start in case of missing files
::{{MajorUpdate}} New PGM functionality
::{{MinorUpdate}} Various user interface bug fixes and improvements
;29 Jul 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-com-2022/ COM 2022]
;13 Jul 2022
:{{Article}} Spotlight Article: [https://www.syscad.net/thermodynamic-calculation-engines-in-syscad/ Thermodynamic Calculation Engines in SysCAD]
;12 Jul 2022
:{{Release}} [[Build_139_Revision_History#Build 31218|Build 139.31218]] update released.
::{{MajorUpdate}} New PGM PSD class functions
::{{MinorUpdate}} Fix for bugs introduced in 31207
;08 Jul 2022
:{{Release}} [[Build_139_Revision_History#Build 31207|Build 139.31207]] update released.
::{{MinorUpdate}} Explorer window, toolbars and graphics improvements
::{{MinorUpdate}} Fix for Makeup Blocks and Sources
;29 Jun 2022
:{{Release}} [[Build_139_Revision_History#Build 31157|Build 139.31157]] update released.
::{{MajorUpdate}} Implemented TagSelect within Command Script ReportTags
::{{MinorUpdate}} Option to control phase change limits for VLE, plus new warnings
::{{MinorUpdate}} Fix for graphics (.dxf) file size increasing
;27 Jun 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-gtt-users-meeting-2022/ GTT Users' Meeting 2022]
;25 May 2022
:{{Article}} Discussion Page: [[Discussion: Annual Climate Data for Dynamic Modelling, Part III|Annual Climate Data for Dynamic Modelling, Part III]]
:{{Video}} Video: [https://www.youtube.com/watch?v=PDLnWF5ntkY Modelling Solvent Extraction of Uranium with Molybdenum Control]
;24 May 2022
:{{Article}} Discussion Page: [[Discussion: Annual Climate Data for Dynamic Modelling, Part II|Annual Climate Data for Dynamic Modelling, Part II]]
;18 May 2022
:{{Release}} [[Build_139_Revision_History#Build 30918|Build 139.30918]] update released.
::{{MajorUpdate}} New Uranium Solvent Extraction demo project using PHREEQC
::{{MinorUpdate}} Energy balance correction for CCD and Classifier
::{{MinorUpdate}} Various stability improvements
;11 May 2022
:{{Release}} [[Build_139_Revision_History#Build 30874|Build 139.30874]] update released.
::{{MajorUpdate}} New Waveform Controller options
::{{MinorUpdate}} Improved display for multi-component VLE
::{{MinorUpdate}} Various TCE improvements
;03 May 2022
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-alta-2022/ ALTA 2022]
;27 Apr 2022
:{{Release}} [[Build_139_Revision_History#Build 30807|Build 139.30807]] update released.
::{{MajorUpdate}} Fix for Precip3 PSD method with PSD Create/Modify in Product stream.
::{{MajorUpdate}} TCE improvements including new TCE Feeder unit model.
::{{MinorUpdate}} Various new PGM functions and improvements.
;13 Apr 2022
:{{Article}} Discussion Page: [[Discussion: Annual Climate Data for Dynamic Modelling|Annual Climate Data for Dynamic Modelling]]
;05 Apr 2022
:{{Release}} [[Build_139_Revision_History#Build 30670|Build 139.30670]] update released.
::{{MajorUpdate}} New Link to Makeup Source option.
::{{MinorUpdate}} Access window and TCE fixes.
;23 Mar 2022
:{{Release}} [[Build_139_Revision_History#Build 30613|Build 139.30613]] update released.
::{{MajorUpdate}} New Alumina Precip3 agglomeration kernel David-Rijkeboer.
;21 Mar 2022
:{{Release}} [[Build_139_Revision_History#Build 30599|Build 139.30599]] update released.
::{{MajorUpdate}} New PGM functions for Classes and Arrays.
::{{MinorUpdate}} Stricter checking of TCE ion definitions (ionlist.txt).
::{{MinorUpdate}} Various Access Window display improvements.
;04 Mar 2022
:{{Release}} [[Build_139_Revision_History#Build 30498|Build 139.30498]] update released.
::{{MajorUpdate}} New Filter Press WashCalc option.
;25 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30448|Build 139.30448]] update released.
::{{MajorUpdate}} New access window auto-layout option.
::{{MinorUpdate}} Crash fixes for ChemApp and TagList.
;22 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30427|Build 139.30427]] update released.
::{{MinorUpdate}} Fixed critical solver convergence error in Builds 30316 and 30376.
;15 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30376|Build 139.30376]] update released.
::{{MinorUpdate}} Further reduced memory usage, various bug fixes and improvements.
:{{Article}} Discussion Page: [[Discussion: Transfer Push and Pull for Batch Processes|Transfer Push and Pull for Batch Processes]]
;04 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30316|Build 139.30316]] update released.
;02 Feb 2022
:{{Article}} Discussion Page: [[Discussion: Air in Modelling|Air in Modelling]]
;01 Feb 2022
:{{Release}} [[Build_139_Revision_History#Build 30270|Build 139.30270]] update released.
::{{MinorUpdate}} Reduced memory usage.
::{{MinorUpdate}} Various TCE model improvements.
;31 Jan 2022
:{{Article}} Discussion Page: [[Discussion: New Reaction Heat Features in Alumina Precipitation Models|New Reaction Heat Features in Alumina Precipitation Models]]
;12 Jan 2022
:{{Release}} [[Build_139_Revision_History#Build 30140|Build 139.30140]] update released.
::{{MajorUpdate}} Official release of [[AQSol Add-On]], plus new [[Example - 08 AQSol Projects|AQSol example projects]].
::{{MajorUpdate}} Reaction Editor 1.4 including improved reaction balancing.
::{{MinorUpdate}} Various species database, energy balance, PGM, feeder and makeup improvements.
;21 Dec 2021
:{{Info}} Happy Holidays! Our office is closed 22 Dec - 5 Jan. For any issues please [mailto:support@syscad.net contact support].
;15 Dec 2021
:{{Article}} Spotlight Article: [https://www.syscad.net/potash-process-modelling-for-a-growing-industry/ Potash - Process Modelling for a Growing Industry]
;29 Nov 2021
:{{Release}} [[Build_139_Revision_History#Build 29945|Build 139.29945]] update released.
;23 Nov 2021
:{{Release}} [[Build_139_Revision_History#Build 29907|Build 139.29907]] update released.
::{{MajorUpdate}} New search function for Insert Symbol/Unit graphics.
::{{MinorUpdate}} Improved TCE Configuration for AQSol.
::{{MinorUpdate}} Various visual, project crash and bug fixes.
;03 Nov 2021
:{{Article}} Discussion Page: [[Discussion: Rare Earths Example Project|Rare Earths Example Project]]
;27 Oct 2021
:{{Release}} [[Build_139_Revision_History#Build 29722|Build 139.29722]] update released.
::{{MinorUpdate}} Improved entropy calculation for water below 0°C.
;26 Oct 2021
:{{Article}} Discussion Page: [[Discussion: Alumina Precipitation and Classification with PSD|Alumina Precipitation and Classification with PSD]]
;22 Oct 2021
:{{Release}} [[Build_139_Revision_History#Build 29706|Build 139.29706]] update released.
::{{MajorUpdate}} New configuration editor for Thermodynamic Calculation Engine (TCE) databases.
::{{MinorUpdate}} Reaction Block (RB), TCE and FEM improvements.
;22 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29552|Build 139.29552]] update released.
::{{MajorUpdate}} New example project - [[Precipitation Projects#Example 5: Precipitation and Classification Example Project using Full Particle Size Data (PSD)|Alumina Precipitation and Classification with PSD]]
::{{MajorUpdate}} Added column to sort configuration (cfg) files by access date.
::{{MinorUpdate}} Improved project save/load.
;14 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29506|Build 139.29506]] update released.
::{{MinorUpdate}} Improvements for Shell and Tube Heat Exchanger 2 condensing mode.
:{{Article}} Spotlight Article: [https://www.syscad.net/bayer-process-modelling-for-the-alumina-industry/ Bayer Process Modelling for the Alumina Industry]
;06 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29465|Build 139.29465]] update released.
;01 Sep 2021
:{{Release}} [[Build_139_Revision_History#Build 29437|Build 139.29437]] update released.
::{{MajorUpdate}} New option to zip project files (Project > Zip Project).
;27 Aug 2021
:{{Release}} [[Build_139_Revision_History#Build 29390|Build 139.29390]] update released.
::{{MinorUpdate}} Improved handling for multiple users on same project file.
;26 Aug 2021
:{{Video}} Video: [https://www.youtube.com/watch?v=kxLHuw3P91s Modelling Solvent Extraction Separation of Neodymium from Praseodymium]
;25 Aug 2021
:{{Release}} '''Build 139 official release''' - [[Build_139_Revision_History#Build 29370|Build 139.29370]]
::{{MajorUpdate}} See [[Build 139 Release Notes]] for full list of changes and new features.
::{{Tip}} Now available on the [https://www.syscad.net/login/ Downloads page] for users with active Upgrade & Support.
::{{Info}} If required, please [mailto:support@syscad.net contact us] for upgrade support.
;19 Aug 2021
:{{Release}} [[Build_139_Revision_History#Build 29334 (BETA)|Build 139.29334 BETA]] update released.
::{{MajorUpdate}} New [[Alumina3 Precip - Full PSD#Kernel Builder|Agglomeration Kernel Builder]] added to Alumina [[Precipitation3]].
;12 Aug 2021
:{{Video}} Video: [https://www.youtube.com/watch?v=0zde5f7-NeA Particle Size Distribution Visualisation]
;06 Aug 2021
:{{Info}} Conference attendance: We are presenting at [https://www.syscad.net/syscad-at-com-2021/ COM 2021]
;28 Jul 2021
:{{Release}} [[Build_139_Revision_History#Build 29199 (BETA)|Build 139.29199 BETA]] update released.
;15 Jul 2021
:{{Release}} [[Build_139_Revision_History#Build 29102 (BETA)|Build 139.29102 BETA]] update released.
;23 Jun 2021
:{{Article}} Spotlight Article: [https://www.syscad.net/syscad-in-the-life-cycle-of-plant-development/ SysCAD in the Life Cycle of Plant Development]
;18 Jun 2021
:{{Info}} Follow us on [https://www.linkedin.com/company/syscad LinkedIn] for company news and process modelling highlights.
;17 Jun 2021
:{{Video}} Video: [https://www.youtube.com/watch?v=SA3nlthmg-c SysCAD Reporting Tools]
;10 Jun 2021
:{{Release}} [[Build_139_Revision_History#Build 28898 (BETA)|Build 139.28898 BETA]] released.
::{{MajorUpdate}} See [[Build 139 Release Notes]] for full list of changes and new features.
::{{Info}} Please [mailto:info@syscad.net contact us] for BETA access.
;09 Jun 2021
:{{Info}} Welcome to the '''Product Blog'''! Check back here for the latest SysCAD news and updates.
== Icon Legend ==
:{{Release}} Build Release
::{{MajorUpdate}} Major Update
::{{MinorUpdate}} Minor Update
::{{Warning}} Warning
:{{Tip}} [[Tips and Tricks|Tips & Tricks]]
:{{Article}} [https://www.syscad.net/category/articles/ Spotlight Articles] and [[Discussion Pages]]
:{{Video}} [https://www.youtube.com/SysCADVideos Videos]
:{{Info}} [https://www.syscad.net/category/news/ News] and General Information
}}

Build 139 Revision History

2025-12-19T02:28:40Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|Basefiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated Basefiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Build 139 Revision History

2025-12-18T04:12:38Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|Basefiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated Basefiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Build 139 Revision History

2025-12-18T04:08:21Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|Basefiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated Basefiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access

Access Window

2025-12-18T03:58:40Z

Keith.Armstrong: /* Right click on the Access Window Background */

[[Category: User Interface]]
{{Navigation|[[User Guide]]|[[Windows]]}}
{{Windows Header table |currentpage=4}}

'''Related Links:''' [[Quick View]], [[SysCAD Tags]], [[General Options Access]]
----
{{TOC|x=20%}}
== Introduction ==

The '''Access Window''' is a "properties page" used to display information in SysCAD unit models such as configuration data, flow information and connectivity with other units. Access Windows are also used to display global pages such as [[Plant Model]] or [[Solver Settings]].
*Information displayed in the Access Window is different for each unit type or global page, and may differ between Steady State (ProBal) and Dynamic solver configuration.
*Two Access Windows are available and may be opened at any time:
# '''Access.1''' is the default Access Window for unit models.
#* ''RIGHT click'' on a unit's graphics symbol to open its Access Window.
# '''Access.2''' is the default Access Window for global pages. It can also be used as a secondary Access Window for unit models.
#* ''SHIFT + RIGHT click'' on a unit's graphics symbol to open a second instance of the access window.
#* Alternatively, ''SHIFT + LEFT click'' on the unit operation, and select the Access.2 "Name" from the pop-up menu.
*For information on how to configure different unit types, see [[Models]] help.
*Unit model Access Windows have several [[Models#Common Sections|common sections]] including [[Common Data Sections|Info]], [[Links Table|Links]] and [[Audit]].

<big>'''Video Link'''</big>

Please see this '''[http://www.youtube.com/watch?v=VDVumo6Txsc YouTube video link]''' for a brief description of some of the Access Window buttons and functionality.

<big>'''Example'''</big>

The Access Window for a Feeder/Cross Page Connector is shown below. There may be minor layout differences for different SysCAD versions. 
(Please see [[Feeder-Cross Page Connector]] for specific information about this unit type.)

{| border="0" cellpadding="5" cellspacing="0"
|-
|rowspan=5|[[Image:Access Window138.png]] || Height=50|[[Image: Button Small 1.png]]|| Each of these tabs represents a separate page with information about the unit. The first Tab is the Unit Type, in this case Feeder / Sink / Cross Page Connector.
|-
|Height=50|[[Image: Button Small 2.png]] ||These are access window buttons, they will be explained in detail in [[#Selection Buttons|Selection Buttons]]
|-
|Height=140|[[Image: Button Small 3.png]] ||These White Fields are INPUT files, the user may change these values. [[#Accessing Data Fields|Accessing Data Fields]]
|-
|Height=140|[[Image: Button Small 4.png]] ||Fields with an arrow on the left contain drop-down lists. Click on the arrow to see the available selection.
|-
|Height=140|[[Image: Button Small 5.png]] ||These grey fields are CALCULATED fields, the user may NOT change these values. [[#Accessing Data Fields|Accessing Data Fields]]
|}

== Data Entry in SysCAD ==

Some Access Window display and behaviour options can be set in Tools - General Options - Access Tab. The various options are described here: [[General Options Access]].

The method by which text or values are entered into Access Window input fields (white fields) depends on the the location of the text cursor, whether or not <nowiki><INS></nowiki> (Insert) keyboard option is active, and whether or not '''Excel Style Field Editing''' is selected in General Options, as above.

Double-clicking on a text or number input field (i.e. not a droplist or checkbox) enters '''Text Edit Mode''', where standard text editing rules apply. This includes text overwrite (standard behaviour - wide cursor over characters) or insert (keyboard key <nowiki><INS></nowiki> has been pressed - thin cursor between characters).

The following applies after a single left-click on the input field:

{|
|-
|[[File:DataEntryAccessWindow1.png]]
|
#'''Excel Style Editing''' (Excel Style Field Editing option On) - behaves as per data entry in Microsoft Excel.
#*When typing a new value, the old value is completely replaced, no matter where the text cursor is placed.
#'''SysCAD Style Editing''' (Excel Style Field Editing option Off) - default SysCAD behaviour.
#*New text overwrites or inserts at the text cursor position, depending on keyboard <nowiki><INS></nowiki>. The example below [[Image: Button Small 1.png| 25 px]] shows the behaviour of overwrite.
#*If the text cursor is in the white space (to the left of a value, or to the right of text), then the old value is completely replaced (same as Excel Style). See [[Image: Button Small 2.png| 25 px]] in the example below for the cursor position.
|}

{|class = wikitable
|-
|For Example: SysCAD Style Editing
:[[File:DataEntryAccessWindow2.png]]
|}

== Accessing Data Fields ==

# [[image:AccessWhiteField.png]]The data fields that appear in '''White''' are changeable and user inputs are normally required.
#* These fields can be number boxes, text boxes (with or without pull down lists), or checkboxes.
#* All required fields come with default values.
#* The SysCAD [[Models]] Documentation offers more help on data fields for individual models.
# [[image:AccessGreyField.png]] The data fields that appear in {{Background color|silver|'''Grey'''}} are NOT changeable by the user. These fields are results calculated by SysCAD.
# Some data fields are only changeable when SysCAD is not solving. That is, when a flowsheet is solving (steady state) or running (dynamic), some originally changeable data fields can be greyed out also.
#* [[image:AccessSolvingGreyField.png]] Examples of such are solving methods or Unit Operation On Tickbox.
# Most data fields can be copied and pasted into changeable data fields (white cells), trends, MS Excel or Notepad by using the <Ctrl + T> and <Ctrl + V> key strokes. For more information, see section [[Copy and Paste]].
# Most data fields are displayed with a conversion unit - e.g. '''Mass Flow''' may be displayed in ''t/h''. The user may change either the Default conversion units, or the conversion units for the individual data field, at any time. Please see '''[[Conversions]]'''.
# When entering data into SysCAD data fields, the default mode is overwrite. This is represented by a flashing wide text cursor positioned over a character. If the cursor is placed in the white space of a field (to the left of a value, or to the right of text), the new value entered will completely replace the old value. If the cursor is placed on a character/digit, then the normal overwrite rule will apply. Pressing the <nowiki><INS></nowiki> key will activate the insert mode. This is represented by a thin text cursor between characters.
#* Alternatively, the [[#Data Entry in SysCAD|Excel Editing Style]] may be used, where the action is to always replace the old value.
# While solving or running, data is not updated on the Access Window, to update, press [[Image:User Guide image044.jpg]] as required. The Access Window data is updated when SysCAD is stopped.

== Selection Buttons ==

{| border="1" cellpadding="5" cellspacing="0"
|Colspan=2| [[Image:AccessWindowButtons139.png]] ||Colspan=2|The access window buttons are displayed at the top of every unit Access Window.
|-
|[[Image:OK Button.png]] || '''OK''' Button ||Colspan=2|This is used to accept all changes made to the Access Window. When a user types in a value, it will be displayed in Blue text with a Blue Dot until the '''OK''' button has been clicked. At that point the change is accepted and the value will change to Black.
#Pressing [Enter] or [Ctrl+Enter] key is the same as pressing the OK button. Key setting may be changed via the [[General Options Access]] dialog.
#If the user makes changes and does NOT click on the OK button before closing the Access Window, or changing to another command then a dialog box will be displayed to alert the user to save or cancel the unsaved changes.
#If AutoSave (see [[#Options Button|Options Button]]) is on, then any changes made will be saved automatically without user confirmation.
#*'''NOTE:''' 2 & 3 were {{Removed139|36522|y}} - changes are now always auto-saved.
|-
|[[Image:Cancel Button.png]] or [[Image:Close Button.png]]||'''Cancel''' or '''Close''' Buttons ||Colspan=2|{{Available139|37009}} The Cancel button is used to cancel all unsaved changes made to the Access Window (i.e., outstanding user-changed values are displayed in {{Font color|blue|Blue}}). The Close button closes the Access Window.
|-
|[[Image:Options Button.png]] || '''Options''' Button || Colspan=2|The options are listed under the [[#Options Button|Options Button]] heading.
|-
|[[Image:MoreButton.png]] or [[Image:LessButton.png]] || '''Display More''' or '''Display Less''' Buttons ||Colspan=2|The [[Image:MoreButton.png]] button will display ALL the fields on an Access Window. A number of fields may be ''Hidden'', either by default or the user may have chosen to hide them to keep the Access Window uncluttered. The normally Hidden fields are marked by [[Image:User Guide image049.jpg]]. By clicking on [[Image:MoreButton.png]] these hidden fields will be visible. While all fields are visible, user may click on the individual [[Image:User Guide image049.jpg]] mark or Dot (just to the left of the variable) to toggle the show/hide status for the variable.

Once this button has been clicked and all the fields are displayed, the button changes to [[Image:LessButton.png]]. Clicking on this button will only display those fields that are not Hidden.
|-
|[[Image:QuickViewButton.png]] || '''Quick View''' Button || Colspan=2|This will open the [[Quick View]] dialog box.
|-
|[[Image:TagLong.png]] or [[Image:TagShort.png]]|| '''Tag:Long''' and '''Tag:Short''' Button ||This allows the user to toggle variable tags between Long and short.

Examples of differences between Symbols and Tags for a Pipe is shown:
|
{| border="1" cellpadding="0" cellspacing="0" align="Centre"
|Width=100|'''Short''' || Width=150|'''Long'''
|-
| Qm || MassFlow
|-
| Qv || VolFlow
|-
| Ti || TemperatureIn
|-
| Rho || Density
|-
| SrcIO || SourceLink
|}
|-
|[[Image:Unit Help Button93.png]] or [[Image:UnitHelpIcon.png]]|| '''Model Help''' Button||Colspan=2|Clicking on this will open the Online SysCAD Help to the section for the unit model associated with the open Access Window.

'''Note:''' This will only access the Online Help file if the user has access to the Internet.
|-
|[[Image:Change Tag Button93.png]] or [[Image:ChangeTagIcon.png]]|| '''Change Tag''' Button||This allows you to change the unit model's tag name from the Access Window.

''Old Tag'' will display the unit's current tag and the user may type in the required tag into ''New Tag''. Please observe [[SysCAD_Tags#Model_Tags|SysCAD tag naming rules]] when specifying the new tag name. Press OK to change the tag. The tag will be changed in the model and any other place where it is referred to within SysCAD, such as PIDs and trend windows.

Please also see [[Change Tag]] for more information.

'''Notes:'''
# User will be warned if the new tag names "already exist", "contain illegal characters" or "too long". Please see [[SysCAD_Tags#Model_Tags|Model Tags]] for information on tag naming rules.
# If user types in Space between words, they will be replaced with _ when the tag is changed. For example, "PLANT FEED" will be changed to "PLANT_FEED" when the OK button is pressed.
# The Change Tag command will also result in tags changes to all PGM files in the project if the "Apply Tag Change in PGM files" tickbox has been selected from the [[General Options Project]] dialog box.
# The Change Tag command will also result in tags changes to all CSV and TXT files in the project if the "Apply Tag Change in CSV and TXT files" tickbox has been selected from the [[General Options Project]] dialog box.
|[[Image:ChangeTag137.png]]
|-
|[[File:Refresh.png]] ||'''Refresh Access Window''' Button ||Colspan=2|When a project is being solved, the access window data is not updated until the solver stops. To force an access window display update manually during a project solve, user can click on this refresh button. User may need to click this repeatedly to keep receiving updated information. Alternatively, the [[Quick_View#Permanent_.28Pinned.29_Quick_View|Quick View]] pop up window or [[Trend_Window|Trend Window]] can be used to get continuously updated information on selected variables.
|-
||[[Image:PreviousUnit.png]] and [[Image:NextUnit.png]] || '''Browsing Graphics''' buttons||Colspan=2|
Pressing [[Image:PreviousUnit.png]] shows the model data for the upstream unit operation; Pressing [[Image:NextUnit.png]] shows the model data for the downstream unit operation. If the model has more than one upstream or downstream connections, then a pop up list will appear, user needs to select one of the connections to keep going. This will also find the unit on the graphics window and brings into view.

For [[Image:ShiftKey.png]] and / or [[Image:CtrlKey.png]] key variations, see [[#Access_Window_Short_Cut_Keys|Access Window Scroll Short Cut Keys]] for more information.
|-
|[[Image:Find Button93.png]] || '''Find Unit''' Button || Colspan=2|If the user clicks on this button SysCAD will jump to the Graphics page containing the unit associated with the Access Window and it will highlight the unit.
|-
|[[Image:Access2.png]] || '''Open in Other Access Window''' Button || Colspan=2| Clicking this button will open the other Access Window for the unit (Access.2 from Access.1 and vice versa). User can use the second window to view data on another Tab. The second access window is also useful for comparing data between two different unit operations. NOTE: User can only "see" the second Access Window when NOT using "Maximised Screen".
|-
|[[Image:AccessWindowHeight93.png]] ||'''Fit Window Vertically''' Button||Colspan=2|Clicking on this will adjust the Access Window height to the full height of the SysCAD window. This is useful when opening a project that was created on a different PC using a different screen resolution.
|-
|[[Image:FitAcc1.png]]: For Access Window 1 || '''Move Access.1 beside Graphics''' Button || {{Available139|30447}} This button can be used to adjust the layout of the Access window 1 / graphics page(s) to allow both document types be displayed neatly in the application window.
*Clicking on this button will resize the Access Window 1 and position to the right of the graphics window(s), so that there is no overlapping display of the graphics window(s) and Access Window 1.
*If there is not enough space to fit both the graphics window(s) and access window 1 using the current window width, the windows will auto resize so that Access window1 will be right-aligned with the application window, and the graphics page will be repositioned to the left of the access window 1.
|[[File:FitAcc1 Example.png|thumb|left|Fit Access 1 Example]]
|-
|[[Image:FitAcc2.png]]: For Access Window 2|| '''Move Access.2 beside Access.1''' Button || {{Available139|30447}} This button can be used to adjust the layout of the Access window 2 to allow easy side by side comparison of access window data.
*If the Access Window1 is position on the right hand side of the application window, clicking on this button will resize and reposition the Access Window 2 to the left of Access Window 1.
*If the Access Window1 is position on the left hand side of the application window, clicking on this button will resize and reposition the Access Window 2 to the right of Access Window 1.
*This button does not adjust the layout of flowsheets.
|
[[File:Fit Access 2 Example.png|thumb|left|Fit Access 2 Example]]
|-
|[[Image:PrevUnit.png]] || '''Go to previous Access Window''' Button || Colspan=2|Shows the model data for the previous (most recently) accessed unit operation, this is useful for filling in data for controllers. This will also find the unit on the graphics window and brings into view.

For [[Image:ShiftKey.png]] and / or [[Image:CtrlKey.png]] key variations, see [[#Access_Window_Short_Cut_Keys|Access Window Scroll Short Cut Keys]] for more information.
|-
|[[Image:GoTo.png]] || '''Go to recent...''' Drop Down List ||Colspan=2|SysCAD keeps a record of the units you have accessed in the past, starting with the most recently accessed unit. You can access any of the listed units by clicking on it. This will also find the unit on the graphics window and brings into view.

For [[Image:ShiftKey.png]] and / or [[Image:CtrlKey.png]] key variations, see [[#Access_Window_Short_Cut_Keys|Access Window Scroll Short Cut Keys]] for more information.
|}

== Options Button==

{| border="1" cellpadding="5" cellspacing="0"
|-
|These options are available by pressing [[Image:Options Button.png]] button on the Access Window. [[Image:AccessOptions.png]] Note: The options shown here are for the latest version of SysCAD. They may differ in earlier versions of SysCAD. ||
* '''Data Transfer''': See section on [[Model Data Transfer|Data Transfer]].
* '''Print''': This command prints the Access Window data by performing screen captures of each access window tab pages.
----
* {{Font color|#808080| '''Auto Save''': If this option is selected, any changes made in the Access Window are automatically saved when switching to other unit operations' access window without clicking on the ''OK'' button. }}{{Removed139|36522}}
* '''Excel Field Edit Style''': When editing values in writable fields, the new value will replace the old value. See [[General Options Access]]
----
* '''Default Fixed Format''': User may specify the default number format based on the number of decimal or significant points
* '''Default Floating Format''': User may specify the default number format to be based on the number of decimal point, using scientific notation.
* '''Reset formatting, conversions and visibility (for ModelX)''': This option resets the formatting, conversions and visibility (Show/Hide) of all tags in this model back to their default values. The formatting, conversions and visibility (Show/Hide) options for individual tags are set by [[#Right click on Access Window variables|right clicking on the variable in the Access Window]].
* '''Reset formatting, conversions and visibility for ALL models''': This is the same as the option described above except it is for ALL models within the project.
* '''Conversions Management''': This allows the user to manage the [[Conversions]] units for the project.
* '''Describe Indicators''': This will add a section to the top of the access window, describing the status indicators, see [[#Access_Field_Reference_Tag_Status_Colour|Access Field Reference Tag Status Colour]] for more information.
----
* '''Reset''': complete Reset of for the current model only.
* '''Reset Actions''' (Dynamic Only): Please see [[Solver_Settings#FS_Solver_Tab|Solver Settings]] for more information.
* '''Remove Qualities''': This option is used to remove any Qualities inherited in the model. Useful for cleaning up unwanted build-up values.
*'''Content to Preset''': Sets the content (where available) to the Preset settings. (Dynamic Only)
----
* '''Show Network''': This option is available only in Dynamic Transfer mode. It will open the Show Network Summary window, which lists all the process units in the local flow network. For more information see [[Setting up Transfer Pull Network]]

|}

== Other Buttons==

{| border="1" cellpadding="5" cellspacing="0"
|-
|[[Image:CopytoClipboardButton.png]] or [[Image:PasteFromClipboardButton.png]]||
*The [[Image:CopytoClipboardButton.png]] button can be found on unit operations such as Pipe or Tank Feed/Prod pages, it copies the T, P and Component Mass Flow data to the Clipboard.
*The [[Image:PasteFromClipboardButton.png]] button can be found on FeederSink unit operation, it will paste the T, P and Component Mass Flow data from the Clipboard to the Feeder. User can choose to paste:
*# Species Mass Flow - Only the mass flow data will be pasted, T and P are not used.
*# Temperature & Pressure - Only T and P will be pasted, the mass flow data is not used.
*# MassFlows and T & P - All data is used.
|-
|[[Image:Include Properties Button.png]] || [[Image:IncludeProperties139.png]] User can select to see more or less groups of data. Please see [[Plant_Model_-_Views#Data_Section|Additional Properties Options]] for more information.
|-
|[[Image:ShowZeroButton.png]] or [[Image:HideZeroButton.png]] ||
* [[Image:ShowZeroButton.png]] can be found on the Sp Tabs, all species will be displayed, including those with no flow.
* [[Image:HideZeroButton.png]] can be found on the Sp Tabs, it will hide all species with no flow.
|-
|[[File: Button - Filter On.png]] or [[File: Button - Filter Off.png]] || The Filter On allows the user to filter the species display on the Sp tab. The various Filter Options are described in [[Species Filter]].
|-
|[[Image:SpeciesLongButton.png]] or [[Image:SpeciesShortButton.png]]|| Toggles between long / short Species Names. For Example: [[Image:LongShortTag.png]]
|-
|[[Image:ShowECPageButton.png]] or [[Image:HideECPageButton.png]]|| Toggles between showing/Hiding the Elemental information. See [[Species_Flow_Section#Hide_.2F_Show_Elements_.2B_Components_Button|Hide / Show Elements + Components Button]]
|-
|[[Image:ShowComponentsButton.png]] or [[Image:HideComponentsButton.png]] || Toggles between showing/Hiding the Component information. See [[Species_Flow_Section#Hide_.2F_Show_Elements_.2B_Components_Button|Hide / Show Elements + Components Button]]
|-
|}

== Right click on Access Window variables ==

{| border="1" cellpadding="5" cellspacing="0"
|-
|Valign=top|Right clicking Pop Up Menu for Access Window: [[Image:User RightClickAccessWindow139.png]] ||
*'''Conversions''':Internally SysCAD stores all data in SI units but you can change the engineering units for the data as they are displayed on screen or reported elsewhere, please see '''[[Conversions#Changing Conversion units for a Data Field|Changing Conversion units for a Data Field]]'''.
* '''Format''':The number format of the value displayed can be changed to a Fixed or Floating format.
----
* '''Send to Quick View''':This will add the selected variable(s) to the [[Quick View]] list.
* '''Send to Topmost Trend''' (previously '''Send to Trend''') : Adds the highlighted variable(s) to the Trend window. The project must contain at least one Trend window. If the project contains multiple trend windows, this command will send the tag to the most recently opened Trend window. The placement of the Tag on the trend window will be:
*# On the highlighted line if it is blank; or
*# On the line below the highlighted line if it is not blank; or
*# Below the most recently accessed line.
* '''Send to Topmost TagList''': {{Available139}} Adds the highlighted variable(s) to the TagList window. The project must contain at least one TagList window. If the project contains multiple TagList windows, this command will send the tag to the most recently opened TagList window. The placement of the Tag on the TagList window will be the first available empty row.
*'''Send to Annotation''': {{Available139}} This option can be used while the [[Animation_Commands#Insert_Annotation_Table|Insert Annotation Table]] dialogue is opened. The variable(s) will be added the "Variable List" box.
*'''Open Find Results''': This will open the [[Find_Units_using_Query#Find_Results_List|Find Results List]], the Find Query used to generate the result is the current Field you have right clicked on.
*'''ReOpen Find Results''': This option will only be visible if the Find Results window is already open. Selecting this option will close and reopen the Find results window, thus clearing any previous search results.
*'''Extend Find Results''': This option will only be visible if the Find Results window is already open. Selecting this option will append the results to the previous search results.
----
* '''Record in Historian''':This can add/remove tags to/from the Historian. User can choose to add/remove the selected tag belong to the active unit operation only; or add/remove the selected tag for all unit operations of the same type (eg, all pipes or all tanks); or add/remove the selected tag for unit operation types.
----
*'''Show / Hide Field''': Toggles the visibility of the variable. If all fields are displayed (by pressing [[Image:MoreButton.png]]), the normally hidden variable(s) will be marked with [[Image:User Guide image049.jpg]].
**While all fields are displayed, user may click on the individual [[Image:User Guide image049.jpg]] mark to directly toggle the show/hide status for the variable.
**Some variables cannot be hidden, e.g.: Tag
*'''Show / Hide Row''' : Only visible if the field is part of a Grid display, toggles the visibility of the row. (e.g.: Audit Tab top table)
*'''Show / Hide Column''' : Only visible if the field is part of a Grid display, toggles the visibility of the column. (e.g.: Audit Tab top table)
----
[[image:copytags138.png|right]] [[image:copytags139.png|right]]
* '''Copy Full Tag''': This will copy the full tag name(s) of the variable(s) you have highlighted on to the clipboard. This must be used if variable being copied is part of a Table. (Eg. Sp Tab, where multiple columns of data are being displayed)
* '''Copy Tag for PGM''': This will copy the full tag with the PGM tag function syntax already added, user can paste this tag directly into the PGM file without having to add the [" "] syntax separately.
*# If the function returns a values, syntax added is ["Valid SysCAD Tag"], for example:<syntaxhighlight lang="pgm" inline> ["P_003.Qo.Qm (t/h)"] </syntaxhighlight>
*# If the function returns a string, syntax added is [Str "Valid SysCAD Tag"], for example: <syntaxhighlight lang="pgm" inline> [Str "Feed01.ConnectTo"] </syntaxhighlight> {{Available139}}
* '''Copy Tag''': This will copy the field name(s) - without the unit operation tag name - you have highlighted on to the clipboard. This is primarily used for building reports where secondary tags are required. For more information on Excel reports see [[Excel Get Tag Reports#Basic_Format_of_a simple Get Tag Report|Basic Format of a simple Get Tag Report]].
* '''Copy''': This is used when a copy of the actual value of a field is required. Choosing Copy will copy the values of the highlighted data fields. For floating point numbers, it will copy the full underlying value and not the rounded formatted value displayed. '''NOTE:''' If the variable tags that are not in a Table are highlighted then instead of coping the variable name displayed, the underlying full tags will be copied (i.e. same as "Copy Full Tag").
* '''Copy Displayed''': This copies all '''text''' as displayed in the Access window. For floating point numbers, it will copy the rounded formatted value displayed if using {{Available139|36522|y|y}} or newer, or the full underlying value if using an older Build. Unlike "Copy" this copies the displayed variable name and not the underlying full tag for any variable tags selected that are not in a Table. {{Available139|33457}}
*'''Paste''': This will paste the information from the clipboard onto the selected fields. This is the same as pressing <Ctrl+V>.
*{{Font color|#808080| '''Paste Special''': If multiple columns are selected for the paste area, this will allow space separated values in clipboard to be pasted. A normal Paste requires tab separated values.}} {{Removed139|36522}}
*'''Data Transfer''': This will open the [[Model Data Transfer|Data Transfer]] Dialogue box with the selected field(s) marked (tick) for transfer. NOTE: User must right click on a "writeable" (white background) field to see the data transfer option. Block variables selection are allowed, all writeable variables in the selected block will be marked for data transfer.
----
'''Control Tags''': See [[Controlled_and_Referenced_Variables_9.3#Navigating_to_Control_Unit|Controlled and Referenced Variables]]
|}

== Right click on the Access Window Background ==

Right clicking on the background of the Access Window, away from the variable names will give you a pop up menu box similar to this example for a Pipe:

{|
|-
|[[Image:RightClickBackground.png]] ||
* '''Refresh''': The Access Window values are not updated as SysCAD solves, pressing Refresh will update the Access Window display once.
* '''Find (name of unit operation)''': Finds the graphics symbol for the active unit model on the Graphics Window.
* '''Model Help''': Access [[Models]] help for the current unit model type.
----
A list of all connected pipes or units will be shown next, in this example:
* Access Input: Name of Unit operation: This will open the access window of the connected source unit.
* Access Output: Name of Unit operation: This is open the access window of the connected destination unit.
|}

== Right click on the Access Window tab page names ==

Right clicking on the names of the tab pages at the top of the Access Window, will give you the pop up menu box described for [[#Right click on the Access Window Background|right click on background]], but with two additional menu items for copying tags. This is particularly useful for copying partial tags for sub-model or sections. For example, right click on Qo in a stream to copy the tag for use in Composition Fetch.

== Left click on the Access Window Background Symbols ==

For some variables, these symbols: [[Image:User Guide image054.gif]] will be displayed to the right of the field. Clicking on the Binoculars symbol will find the Unit Operation on the Graphics Window, while pressing the Magnifying Glass symbol will open the Access Window for the corresponding Unit Operation.

== Access Field Reference Tag Status Colour ==

A full list of the available status colour can be view by selecting the [[Image:Options Button.png]] Button - [[#Options_Button|Describe Indicators]] option. When this option is used, the following will be added to the top of the access window, describing the status indicators.
{|
|Width=500|[[General Options Access|Field Indicators:Show Standard]]
[[File:DescribeIndicators137.png]]
|[[General Options Access|Field Indicators:Show All]]
[[File:DescribeIndicatorsShowAll.png]]
|}
Detailed description of some of the most common status colours are described below:

{|border="1" cellpadding="5" cellspacing="0"
!Type||Description || SysCAD View
|-
|Stopped
|These are variables that can only be changed if SysCAD is stopped (no simulation running).
|For example, Tank sub-model selections. If [[General Options Access|Tools - General Options - Access - Field Indicators:Show All]] is used, then these fields will be displayed in dark grey colour. [[File:DescribeIndicatorsShowAll2.png]]
|-
|PreStart
|These are variables that will only be executed once during the PreStart Step of the simulation. This means when using these tags in a PGM file, they have to be put inside the [[Trigger_Subroutines#Initialise_PreStart|Initialise PreStart]] Subroutine.
|For example, PlantModel - Flowsheets 
See [[Trigger_Subroutines#Initialise PreStart Examples|Initialise PreStart Examples]] for an example of how to set these in the PGM file.
|-
|Global
|Fields with a thin blue Rectangle block indicates the variable is global, changes to this variable will be applied to all access windows.
|For example, Pipe - Sp Tab, SpBasis is global [[File:GlobalIndicator.png]]
|-
|Dependent
|Fields with Yellow Field Colour means something is setting the value, if the field has no triangle indicator, then it is likely due to Composition Fetch, Feeder Calculator (Bayer, Sugar, Potash) or Solubility. 
For Example, If composition fetch is set to continuously fetching the composition from another unit, then the composition in the feeder is Linked to the other unit, these fields are presented with the yellow background. User should not change these fields as any changes will be overridden by SysCAD when the project is solved.
|[[File:DepandantIndicator.png]]
|-
|Quick View
|Fields with a small turquoise square indicates the variable is displayed in [[Quick View]].
|[[File:QuickviewIndicator.png]]
|-
|Set or Get Reference Tags
|
*Yellow Forward Triangle and Yellow Field Colour: This Variable is being set by some logic. eg, PID, SetTag or General Controller.
*Green Backward Triangle: This variable is being read by some logic. eg, PID, SetTag or General Controller.
*Red Forward Triangle and Red Field Colour: This variable is being set by more than one logic, it is in conflict and should be looked into.
*Placing the cursor on the field will bring out a help box, detailing which controls are trying to write to the field.
NOTE: If the triangle is not shaded (i.e. only the outline is shown) then the tag was not set or read for that particular iteration.
|[[Image:ReferenceTagStatusColour.png]]
|-
|Manual User Input Value Change
|Fields with a Blue Dot indicates the value has been changed by the user, but the change has not been applied yet. To apply the change, hit the [[Image:OK Button.png]] button, or the Enter or Ctrl-Enter keys.
|[[File:ValueChangeIndicator.png]]
|-
|Inactive Tags
|Fields with values displayed in mustard colour indicates the model is NOT active, most likely due to the flowsheet being Deactivated.
|[[File:inactiveIndicator.png]]
|}

NOTE:The above status colour will also appear on the trend window.

== Zero Values Verses Small Number Display ==

SysCAD displays all data with two decimal points by default. The user can change the number format as needed anywhere on the Access Window, Trend, TagList, etc.

'''WARNING:''' There is an exception - by default SysCAD displays zero values as 0 with no decimal points. If a number appears as 0.00, it means the number has a small value and the user may get its exact value by changing the number format. This is not to be confused with true zero values.

== Drop List ==

There are two types of droplist in SysCAD:
# Returns a value - the drop list that returns a value will have an integer value listed to the right of the droplist, e.g.:
#:[[image:droplist_value.png]]
#*When making the droplist selection from a PGM file, user needs to set the integer value. For example: ["Cementation.GM.Operation"] = 43
# Returns a string - the drop list that expects a string input will not have an integer value listed.
#:[[image:droplist_string.png]]
#*In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in the description.
#*When making the droplist selection from a PGM file, user needs to set a string variable. For example: [Str "Cementation.MU1.Model"] = "Product Composition"

== Access Window Short Cut Keys ==

{|
|[[Image:CtrlKey.png]] + Enter || Same as pressing the [[#Selection Buttons|OK button]].
|-
|[[Image:CtrlKey.png]] + Home || Scrolls to the Top Left of the Current Access Window Tab Page
|-
|[[Image:CtrlKey.png]] + End || Scrolls to the Bottom Left of the Current Access Window Tab Page
|-
|[[Image:CtrlKey.png]] + [[Image:LeftRightArrow.png]] || Pans the horizontal scroll bar left/right (1 character width at a time)
|-
|[[Image:CtrlKey.png]] + [[Image:UpDownArrow.png]] || Pans the Vertical scrolls bar up/down (1 row at a time)
|-
|[[Image:ShiftKey.png]] + [[Image:UpDownArrow.png]] [[Image:LeftRightArrow.png]] || Highlights the fields which the text cursor travels over (e.g. for Copy/Paste)
|-
|[[Image:CtrlKey.png]] + PageUp || Go to the next Access Window tab page
|-
|[[Image:CtrlKey.png]] + PageDown || Go to the Previous Access Window tab page.
|-
|[[Image:CtrlKey.png]] + Various [[#Selection Buttons|Selection Buttons]] || Displays the model data on the Current Access Window without finding the unit on the Graphics Window.
|-
|[[Image:ShiftKey.png]] + Various [[#Selection Buttons|Selection Buttons]] || Displays the model data on the other Access Window, and finds the unit on the Graphics Window.
|-
|[[Image:ShiftKey.png]] + [[Image:CtrlKey.png]] + Various [[#Selection Buttons|Selection Buttons]] || Displays the model data on the other Access Window without finding the unit on the Graphics Window.
|}

Access Window

2025-12-18T03:48:13Z

Keith.Armstrong: /* Right click on the Access Window Background */

[[Category: User Interface]]
{{Navigation|[[User Guide]]|[[Windows]]}}
{{Windows Header table |currentpage=4}}

'''Related Links:''' [[Quick View]], [[SysCAD Tags]], [[General Options Access]]
----
{{TOC|x=20%}}
== Introduction ==

The '''Access Window''' is a "properties page" used to display information in SysCAD unit models such as configuration data, flow information and connectivity with other units. Access Windows are also used to display global pages such as [[Plant Model]] or [[Solver Settings]].
*Information displayed in the Access Window is different for each unit type or global page, and may differ between Steady State (ProBal) and Dynamic solver configuration.
*Two Access Windows are available and may be opened at any time:
# '''Access.1''' is the default Access Window for unit models.
#* ''RIGHT click'' on a unit's graphics symbol to open its Access Window.
# '''Access.2''' is the default Access Window for global pages. It can also be used as a secondary Access Window for unit models.
#* ''SHIFT + RIGHT click'' on a unit's graphics symbol to open a second instance of the access window.
#* Alternatively, ''SHIFT + LEFT click'' on the unit operation, and select the Access.2 "Name" from the pop-up menu.
*For information on how to configure different unit types, see [[Models]] help.
*Unit model Access Windows have several [[Models#Common Sections|common sections]] including [[Common Data Sections|Info]], [[Links Table|Links]] and [[Audit]].

<big>'''Video Link'''</big>

Please see this '''[http://www.youtube.com/watch?v=VDVumo6Txsc YouTube video link]''' for a brief description of some of the Access Window buttons and functionality.

<big>'''Example'''</big>

The Access Window for a Feeder/Cross Page Connector is shown below. There may be minor layout differences for different SysCAD versions. 
(Please see [[Feeder-Cross Page Connector]] for specific information about this unit type.)

{| border="0" cellpadding="5" cellspacing="0"
|-
|rowspan=5|[[Image:Access Window138.png]] || Height=50|[[Image: Button Small 1.png]]|| Each of these tabs represents a separate page with information about the unit. The first Tab is the Unit Type, in this case Feeder / Sink / Cross Page Connector.
|-
|Height=50|[[Image: Button Small 2.png]] ||These are access window buttons, they will be explained in detail in [[#Selection Buttons|Selection Buttons]]
|-
|Height=140|[[Image: Button Small 3.png]] ||These White Fields are INPUT files, the user may change these values. [[#Accessing Data Fields|Accessing Data Fields]]
|-
|Height=140|[[Image: Button Small 4.png]] ||Fields with an arrow on the left contain drop-down lists. Click on the arrow to see the available selection.
|-
|Height=140|[[Image: Button Small 5.png]] ||These grey fields are CALCULATED fields, the user may NOT change these values. [[#Accessing Data Fields|Accessing Data Fields]]
|}

== Data Entry in SysCAD ==

Some Access Window display and behaviour options can be set in Tools - General Options - Access Tab. The various options are described here: [[General Options Access]].

The method by which text or values are entered into Access Window input fields (white fields) depends on the the location of the text cursor, whether or not <nowiki><INS></nowiki> (Insert) keyboard option is active, and whether or not '''Excel Style Field Editing''' is selected in General Options, as above.

Double-clicking on a text or number input field (i.e. not a droplist or checkbox) enters '''Text Edit Mode''', where standard text editing rules apply. This includes text overwrite (standard behaviour - wide cursor over characters) or insert (keyboard key <nowiki><INS></nowiki> has been pressed - thin cursor between characters).

The following applies after a single left-click on the input field:

{|
|-
|[[File:DataEntryAccessWindow1.png]]
|
#'''Excel Style Editing''' (Excel Style Field Editing option On) - behaves as per data entry in Microsoft Excel.
#*When typing a new value, the old value is completely replaced, no matter where the text cursor is placed.
#'''SysCAD Style Editing''' (Excel Style Field Editing option Off) - default SysCAD behaviour.
#*New text overwrites or inserts at the text cursor position, depending on keyboard <nowiki><INS></nowiki>. The example below [[Image: Button Small 1.png| 25 px]] shows the behaviour of overwrite.
#*If the text cursor is in the white space (to the left of a value, or to the right of text), then the old value is completely replaced (same as Excel Style). See [[Image: Button Small 2.png| 25 px]] in the example below for the cursor position.
|}

{|class = wikitable
|-
|For Example: SysCAD Style Editing
:[[File:DataEntryAccessWindow2.png]]
|}

== Accessing Data Fields ==

# [[image:AccessWhiteField.png]]The data fields that appear in '''White''' are changeable and user inputs are normally required.
#* These fields can be number boxes, text boxes (with or without pull down lists), or checkboxes.
#* All required fields come with default values.
#* The SysCAD [[Models]] Documentation offers more help on data fields for individual models.
# [[image:AccessGreyField.png]] The data fields that appear in {{Background color|silver|'''Grey'''}} are NOT changeable by the user. These fields are results calculated by SysCAD.
# Some data fields are only changeable when SysCAD is not solving. That is, when a flowsheet is solving (steady state) or running (dynamic), some originally changeable data fields can be greyed out also.
#* [[image:AccessSolvingGreyField.png]] Examples of such are solving methods or Unit Operation On Tickbox.
# Most data fields can be copied and pasted into changeable data fields (white cells), trends, MS Excel or Notepad by using the <Ctrl + T> and <Ctrl + V> key strokes. For more information, see section [[Copy and Paste]].
# Most data fields are displayed with a conversion unit - e.g. '''Mass Flow''' may be displayed in ''t/h''. The user may change either the Default conversion units, or the conversion units for the individual data field, at any time. Please see '''[[Conversions]]'''.
# When entering data into SysCAD data fields, the default mode is overwrite. This is represented by a flashing wide text cursor positioned over a character. If the cursor is placed in the white space of a field (to the left of a value, or to the right of text), the new value entered will completely replace the old value. If the cursor is placed on a character/digit, then the normal overwrite rule will apply. Pressing the <nowiki><INS></nowiki> key will activate the insert mode. This is represented by a thin text cursor between characters.
#* Alternatively, the [[#Data Entry in SysCAD|Excel Editing Style]] may be used, where the action is to always replace the old value.
# While solving or running, data is not updated on the Access Window, to update, press [[Image:User Guide image044.jpg]] as required. The Access Window data is updated when SysCAD is stopped.

== Selection Buttons ==

{| border="1" cellpadding="5" cellspacing="0"
|Colspan=2| [[Image:AccessWindowButtons139.png]] ||Colspan=2|The access window buttons are displayed at the top of every unit Access Window.
|-
|[[Image:OK Button.png]] || '''OK''' Button ||Colspan=2|This is used to accept all changes made to the Access Window. When a user types in a value, it will be displayed in Blue text with a Blue Dot until the '''OK''' button has been clicked. At that point the change is accepted and the value will change to Black.
#Pressing [Enter] or [Ctrl+Enter] key is the same as pressing the OK button. Key setting may be changed via the [[General Options Access]] dialog.
#If the user makes changes and does NOT click on the OK button before closing the Access Window, or changing to another command then a dialog box will be displayed to alert the user to save or cancel the unsaved changes.
#If AutoSave (see [[#Options Button|Options Button]]) is on, then any changes made will be saved automatically without user confirmation.
#*'''NOTE:''' 2 & 3 were {{Removed139|36522|y}} - changes are now always auto-saved.
|-
|[[Image:Cancel Button.png]] or [[Image:Close Button.png]]||'''Cancel''' or '''Close''' Buttons ||Colspan=2|{{Available139|37009}} The Cancel button is used to cancel all unsaved changes made to the Access Window (i.e., outstanding user-changed values are displayed in {{Font color|blue|Blue}}). The Close button closes the Access Window.
|-
|[[Image:Options Button.png]] || '''Options''' Button || Colspan=2|The options are listed under the [[#Options Button|Options Button]] heading.
|-
|[[Image:MoreButton.png]] or [[Image:LessButton.png]] || '''Display More''' or '''Display Less''' Buttons ||Colspan=2|The [[Image:MoreButton.png]] button will display ALL the fields on an Access Window. A number of fields may be ''Hidden'', either by default or the user may have chosen to hide them to keep the Access Window uncluttered. The normally Hidden fields are marked by [[Image:User Guide image049.jpg]]. By clicking on [[Image:MoreButton.png]] these hidden fields will be visible. While all fields are visible, user may click on the individual [[Image:User Guide image049.jpg]] mark or Dot (just to the left of the variable) to toggle the show/hide status for the variable.

Once this button has been clicked and all the fields are displayed, the button changes to [[Image:LessButton.png]]. Clicking on this button will only display those fields that are not Hidden.
|-
|[[Image:QuickViewButton.png]] || '''Quick View''' Button || Colspan=2|This will open the [[Quick View]] dialog box.
|-
|[[Image:TagLong.png]] or [[Image:TagShort.png]]|| '''Tag:Long''' and '''Tag:Short''' Button ||This allows the user to toggle variable tags between Long and short.

Examples of differences between Symbols and Tags for a Pipe is shown:
|
{| border="1" cellpadding="0" cellspacing="0" align="Centre"
|Width=100|'''Short''' || Width=150|'''Long'''
|-
| Qm || MassFlow
|-
| Qv || VolFlow
|-
| Ti || TemperatureIn
|-
| Rho || Density
|-
| SrcIO || SourceLink
|}
|-
|[[Image:Unit Help Button93.png]] or [[Image:UnitHelpIcon.png]]|| '''Model Help''' Button||Colspan=2|Clicking on this will open the Online SysCAD Help to the section for the unit model associated with the open Access Window.

'''Note:''' This will only access the Online Help file if the user has access to the Internet.
|-
|[[Image:Change Tag Button93.png]] or [[Image:ChangeTagIcon.png]]|| '''Change Tag''' Button||This allows you to change the unit model's tag name from the Access Window.

''Old Tag'' will display the unit's current tag and the user may type in the required tag into ''New Tag''. Please observe [[SysCAD_Tags#Model_Tags|SysCAD tag naming rules]] when specifying the new tag name. Press OK to change the tag. The tag will be changed in the model and any other place where it is referred to within SysCAD, such as PIDs and trend windows.

Please also see [[Change Tag]] for more information.

'''Notes:'''
# User will be warned if the new tag names "already exist", "contain illegal characters" or "too long". Please see [[SysCAD_Tags#Model_Tags|Model Tags]] for information on tag naming rules.
# If user types in Space between words, they will be replaced with _ when the tag is changed. For example, "PLANT FEED" will be changed to "PLANT_FEED" when the OK button is pressed.
# The Change Tag command will also result in tags changes to all PGM files in the project if the "Apply Tag Change in PGM files" tickbox has been selected from the [[General Options Project]] dialog box.
# The Change Tag command will also result in tags changes to all CSV and TXT files in the project if the "Apply Tag Change in CSV and TXT files" tickbox has been selected from the [[General Options Project]] dialog box.
|[[Image:ChangeTag137.png]]
|-
|[[File:Refresh.png]] ||'''Refresh Access Window''' Button ||Colspan=2|When a project is being solved, the access window data is not updated until the solver stops. To force an access window display update manually during a project solve, user can click on this refresh button. User may need to click this repeatedly to keep receiving updated information. Alternatively, the [[Quick_View#Permanent_.28Pinned.29_Quick_View|Quick View]] pop up window or [[Trend_Window|Trend Window]] can be used to get continuously updated information on selected variables.
|-
||[[Image:PreviousUnit.png]] and [[Image:NextUnit.png]] || '''Browsing Graphics''' buttons||Colspan=2|
Pressing [[Image:PreviousUnit.png]] shows the model data for the upstream unit operation; Pressing [[Image:NextUnit.png]] shows the model data for the downstream unit operation. If the model has more than one upstream or downstream connections, then a pop up list will appear, user needs to select one of the connections to keep going. This will also find the unit on the graphics window and brings into view.

For [[Image:ShiftKey.png]] and / or [[Image:CtrlKey.png]] key variations, see [[#Access_Window_Short_Cut_Keys|Access Window Scroll Short Cut Keys]] for more information.
|-
|[[Image:Find Button93.png]] || '''Find Unit''' Button || Colspan=2|If the user clicks on this button SysCAD will jump to the Graphics page containing the unit associated with the Access Window and it will highlight the unit.
|-
|[[Image:Access2.png]] || '''Open in Other Access Window''' Button || Colspan=2| Clicking this button will open the other Access Window for the unit (Access.2 from Access.1 and vice versa). User can use the second window to view data on another Tab. The second access window is also useful for comparing data between two different unit operations. NOTE: User can only "see" the second Access Window when NOT using "Maximised Screen".
|-
|[[Image:AccessWindowHeight93.png]] ||'''Fit Window Vertically''' Button||Colspan=2|Clicking on this will adjust the Access Window height to the full height of the SysCAD window. This is useful when opening a project that was created on a different PC using a different screen resolution.
|-
|[[Image:FitAcc1.png]]: For Access Window 1 || '''Move Access.1 beside Graphics''' Button || {{Available139|30447}} This button can be used to adjust the layout of the Access window 1 / graphics page(s) to allow both document types be displayed neatly in the application window.
*Clicking on this button will resize the Access Window 1 and position to the right of the graphics window(s), so that there is no overlapping display of the graphics window(s) and Access Window 1.
*If there is not enough space to fit both the graphics window(s) and access window 1 using the current window width, the windows will auto resize so that Access window1 will be right-aligned with the application window, and the graphics page will be repositioned to the left of the access window 1.
|[[File:FitAcc1 Example.png|thumb|left|Fit Access 1 Example]]
|-
|[[Image:FitAcc2.png]]: For Access Window 2|| '''Move Access.2 beside Access.1''' Button || {{Available139|30447}} This button can be used to adjust the layout of the Access window 2 to allow easy side by side comparison of access window data.
*If the Access Window1 is position on the right hand side of the application window, clicking on this button will resize and reposition the Access Window 2 to the left of Access Window 1.
*If the Access Window1 is position on the left hand side of the application window, clicking on this button will resize and reposition the Access Window 2 to the right of Access Window 1.
*This button does not adjust the layout of flowsheets.
|
[[File:Fit Access 2 Example.png|thumb|left|Fit Access 2 Example]]
|-
|[[Image:PrevUnit.png]] || '''Go to previous Access Window''' Button || Colspan=2|Shows the model data for the previous (most recently) accessed unit operation, this is useful for filling in data for controllers. This will also find the unit on the graphics window and brings into view.

For [[Image:ShiftKey.png]] and / or [[Image:CtrlKey.png]] key variations, see [[#Access_Window_Short_Cut_Keys|Access Window Scroll Short Cut Keys]] for more information.
|-
|[[Image:GoTo.png]] || '''Go to recent...''' Drop Down List ||Colspan=2|SysCAD keeps a record of the units you have accessed in the past, starting with the most recently accessed unit. You can access any of the listed units by clicking on it. This will also find the unit on the graphics window and brings into view.

For [[Image:ShiftKey.png]] and / or [[Image:CtrlKey.png]] key variations, see [[#Access_Window_Short_Cut_Keys|Access Window Scroll Short Cut Keys]] for more information.
|}

== Options Button==

{| border="1" cellpadding="5" cellspacing="0"
|-
|These options are available by pressing [[Image:Options Button.png]] button on the Access Window. [[Image:AccessOptions.png]] Note: The options shown here are for the latest version of SysCAD. They may differ in earlier versions of SysCAD. ||
* '''Data Transfer''': See section on [[Model Data Transfer|Data Transfer]].
* '''Print''': This command prints the Access Window data by performing screen captures of each access window tab pages.
----
* {{Font color|#808080| '''Auto Save''': If this option is selected, any changes made in the Access Window are automatically saved when switching to other unit operations' access window without clicking on the ''OK'' button. }}{{Removed139|36522}}
* '''Excel Field Edit Style''': When editing values in writable fields, the new value will replace the old value. See [[General Options Access]]
----
* '''Default Fixed Format''': User may specify the default number format based on the number of decimal or significant points
* '''Default Floating Format''': User may specify the default number format to be based on the number of decimal point, using scientific notation.
* '''Reset formatting, conversions and visibility (for ModelX)''': This option resets the formatting, conversions and visibility (Show/Hide) of all tags in this model back to their default values. The formatting, conversions and visibility (Show/Hide) options for individual tags are set by [[#Right click on Access Window variables|right clicking on the variable in the Access Window]].
* '''Reset formatting, conversions and visibility for ALL models''': This is the same as the option described above except it is for ALL models within the project.
* '''Conversions Management''': This allows the user to manage the [[Conversions]] units for the project.
* '''Describe Indicators''': This will add a section to the top of the access window, describing the status indicators, see [[#Access_Field_Reference_Tag_Status_Colour|Access Field Reference Tag Status Colour]] for more information.
----
* '''Reset''': complete Reset of for the current model only.
* '''Reset Actions''' (Dynamic Only): Please see [[Solver_Settings#FS_Solver_Tab|Solver Settings]] for more information.
* '''Remove Qualities''': This option is used to remove any Qualities inherited in the model. Useful for cleaning up unwanted build-up values.
*'''Content to Preset''': Sets the content (where available) to the Preset settings. (Dynamic Only)
----
* '''Show Network''': This option is available only in Dynamic Transfer mode. It will open the Show Network Summary window, which lists all the process units in the local flow network. For more information see [[Setting up Transfer Pull Network]]

|}

== Other Buttons==

{| border="1" cellpadding="5" cellspacing="0"
|-
|[[Image:CopytoClipboardButton.png]] or [[Image:PasteFromClipboardButton.png]]||
*The [[Image:CopytoClipboardButton.png]] button can be found on unit operations such as Pipe or Tank Feed/Prod pages, it copies the T, P and Component Mass Flow data to the Clipboard.
*The [[Image:PasteFromClipboardButton.png]] button can be found on FeederSink unit operation, it will paste the T, P and Component Mass Flow data from the Clipboard to the Feeder. User can choose to paste:
*# Species Mass Flow - Only the mass flow data will be pasted, T and P are not used.
*# Temperature & Pressure - Only T and P will be pasted, the mass flow data is not used.
*# MassFlows and T & P - All data is used.
|-
|[[Image:Include Properties Button.png]] || [[Image:IncludeProperties139.png]] User can select to see more or less groups of data. Please see [[Plant_Model_-_Views#Data_Section|Additional Properties Options]] for more information.
|-
|[[Image:ShowZeroButton.png]] or [[Image:HideZeroButton.png]] ||
* [[Image:ShowZeroButton.png]] can be found on the Sp Tabs, all species will be displayed, including those with no flow.
* [[Image:HideZeroButton.png]] can be found on the Sp Tabs, it will hide all species with no flow.
|-
|[[File: Button - Filter On.png]] or [[File: Button - Filter Off.png]] || The Filter On allows the user to filter the species display on the Sp tab. The various Filter Options are described in [[Species Filter]].
|-
|[[Image:SpeciesLongButton.png]] or [[Image:SpeciesShortButton.png]]|| Toggles between long / short Species Names. For Example: [[Image:LongShortTag.png]]
|-
|[[Image:ShowECPageButton.png]] or [[Image:HideECPageButton.png]]|| Toggles between showing/Hiding the Elemental information. See [[Species_Flow_Section#Hide_.2F_Show_Elements_.2B_Components_Button|Hide / Show Elements + Components Button]]
|-
|[[Image:ShowComponentsButton.png]] or [[Image:HideComponentsButton.png]] || Toggles between showing/Hiding the Component information. See [[Species_Flow_Section#Hide_.2F_Show_Elements_.2B_Components_Button|Hide / Show Elements + Components Button]]
|-
|}

== Right click on Access Window variables ==

{| border="1" cellpadding="5" cellspacing="0"
|-
|Valign=top|Right clicking Pop Up Menu for Access Window: [[Image:User RightClickAccessWindow139.png]] ||
*'''Conversions''':Internally SysCAD stores all data in SI units but you can change the engineering units for the data as they are displayed on screen or reported elsewhere, please see '''[[Conversions#Changing Conversion units for a Data Field|Changing Conversion units for a Data Field]]'''.
* '''Format''':The number format of the value displayed can be changed to a Fixed or Floating format.
----
* '''Send to Quick View''':This will add the selected variable(s) to the [[Quick View]] list.
* '''Send to Topmost Trend''' (previously '''Send to Trend''') : Adds the highlighted variable(s) to the Trend window. The project must contain at least one Trend window. If the project contains multiple trend windows, this command will send the tag to the most recently opened Trend window. The placement of the Tag on the trend window will be:
*# On the highlighted line if it is blank; or
*# On the line below the highlighted line if it is not blank; or
*# Below the most recently accessed line.
* '''Send to Topmost TagList''': {{Available139}} Adds the highlighted variable(s) to the TagList window. The project must contain at least one TagList window. If the project contains multiple TagList windows, this command will send the tag to the most recently opened TagList window. The placement of the Tag on the TagList window will be the first available empty row.
*'''Send to Annotation''': {{Available139}} This option can be used while the [[Animation_Commands#Insert_Annotation_Table|Insert Annotation Table]] dialogue is opened. The variable(s) will be added the "Variable List" box.
*'''Open Find Results''': This will open the [[Find_Units_using_Query#Find_Results_List|Find Results List]], the Find Query used to generate the result is the current Field you have right clicked on.
*'''ReOpen Find Results''': This option will only be visible if the Find Results window is already open. Selecting this option will close and reopen the Find results window, thus clearing any previous search results.
*'''Extend Find Results''': This option will only be visible if the Find Results window is already open. Selecting this option will append the results to the previous search results.
----
* '''Record in Historian''':This can add/remove tags to/from the Historian. User can choose to add/remove the selected tag belong to the active unit operation only; or add/remove the selected tag for all unit operations of the same type (eg, all pipes or all tanks); or add/remove the selected tag for unit operation types.
----
*'''Show / Hide Field''': Toggles the visibility of the variable. If all fields are displayed (by pressing [[Image:MoreButton.png]]), the normally hidden variable(s) will be marked with [[Image:User Guide image049.jpg]].
**While all fields are displayed, user may click on the individual [[Image:User Guide image049.jpg]] mark to directly toggle the show/hide status for the variable.
**Some variables cannot be hidden, e.g.: Tag
*'''Show / Hide Row''' : Only visible if the field is part of a Grid display, toggles the visibility of the row. (e.g.: Audit Tab top table)
*'''Show / Hide Column''' : Only visible if the field is part of a Grid display, toggles the visibility of the column. (e.g.: Audit Tab top table)
----
[[image:copytags138.png|right]] [[image:copytags139.png|right]]
* '''Copy Full Tag''': This will copy the full tag name(s) of the variable(s) you have highlighted on to the clipboard. This must be used if variable being copied is part of a Table. (Eg. Sp Tab, where multiple columns of data are being displayed)
* '''Copy Tag for PGM''': This will copy the full tag with the PGM tag function syntax already added, user can paste this tag directly into the PGM file without having to add the [" "] syntax separately.
*# If the function returns a values, syntax added is ["Valid SysCAD Tag"], for example:<syntaxhighlight lang="pgm" inline> ["P_003.Qo.Qm (t/h)"] </syntaxhighlight>
*# If the function returns a string, syntax added is [Str "Valid SysCAD Tag"], for example: <syntaxhighlight lang="pgm" inline> [Str "Feed01.ConnectTo"] </syntaxhighlight> {{Available139}}
* '''Copy Tag''': This will copy the field name(s) - without the unit operation tag name - you have highlighted on to the clipboard. This is primarily used for building reports where secondary tags are required. For more information on Excel reports see [[Excel Get Tag Reports#Basic_Format_of_a simple Get Tag Report|Basic Format of a simple Get Tag Report]].
* '''Copy''': This is used when a copy of the actual value of a field is required. Choosing Copy will copy the values of the highlighted data fields. For floating point numbers, it will copy the full underlying value and not the rounded formatted value displayed. '''NOTE:''' If the variable tags that are not in a Table are highlighted then instead of coping the variable name displayed, the underlying full tags will be copied (i.e. same as "Copy Full Tag").
* '''Copy Displayed''': This copies all '''text''' as displayed in the Access window. For floating point numbers, it will copy the rounded formatted value displayed if using {{Available139|36522|y|y}} or newer, or the full underlying value if using an older Build. Unlike "Copy" this copies the displayed variable name and not the underlying full tag for any variable tags selected that are not in a Table. {{Available139|33457}}
*'''Paste''': This will paste the information from the clipboard onto the selected fields. This is the same as pressing <Ctrl+V>.
*{{Font color|#808080| '''Paste Special''': If multiple columns are selected for the paste area, this will allow space separated values in clipboard to be pasted. A normal Paste requires tab separated values.}} {{Removed139|36522}}
*'''Data Transfer''': This will open the [[Model Data Transfer|Data Transfer]] Dialogue box with the selected field(s) marked (tick) for transfer. NOTE: User must right click on a "writeable" (white background) field to see the data transfer option. Block variables selection are allowed, all writeable variables in the selected block will be marked for data transfer.
----
'''Control Tags''': See [[Controlled_and_Referenced_Variables_9.3#Navigating_to_Control_Unit|Controlled and Referenced Variables]]
|}

== Right click on the Access Window Background ==

Right clicking on the background of the Access Window, away from the variable names will give you a pop up box similar to this example for a Pipe:

{|
|-
|[[Image:RightClickBackground.png]] ||
* '''Refresh''': The Access Window values are not updated as SysCAD solves, pressing Refresh will update the Access Window display once.
* '''Find (name of unit operation)''': Finds the graphics symbol for the active unit model on the Graphics Window.
* '''Model Help''': Access [[Models]] help for the current unit model type.
----
A list of all connected pipes or units will be shown next, in this example:
* Access Input: Name of Unit operation: This will open the access window of the connected source unit.
* Access Output: Name of Unit operation: This is open the access window of the connected destination unit.
|}

== Left click on the Access Window Background Symbols ==

For some variables, these symbols: [[Image:User Guide image054.gif]] will be displayed to the right of the field. Clicking on the Binoculars symbol will find the Unit Operation on the Graphics Window, while pressing the Magnifying Glass symbol will open the Access Window for the corresponding Unit Operation.

== Access Field Reference Tag Status Colour ==

A full list of the available status colour can be view by selecting the [[Image:Options Button.png]] Button - [[#Options_Button|Describe Indicators]] option. When this option is used, the following will be added to the top of the access window, describing the status indicators.
{|
|Width=500|[[General Options Access|Field Indicators:Show Standard]]
[[File:DescribeIndicators137.png]]
|[[General Options Access|Field Indicators:Show All]]
[[File:DescribeIndicatorsShowAll.png]]
|}
Detailed description of some of the most common status colours are described below:

{|border="1" cellpadding="5" cellspacing="0"
!Type||Description || SysCAD View
|-
|Stopped
|These are variables that can only be changed if SysCAD is stopped (no simulation running).
|For example, Tank sub-model selections. If [[General Options Access|Tools - General Options - Access - Field Indicators:Show All]] is used, then these fields will be displayed in dark grey colour. [[File:DescribeIndicatorsShowAll2.png]]
|-
|PreStart
|These are variables that will only be executed once during the PreStart Step of the simulation. This means when using these tags in a PGM file, they have to be put inside the [[Trigger_Subroutines#Initialise_PreStart|Initialise PreStart]] Subroutine.
|For example, PlantModel - Flowsheets 
See [[Trigger_Subroutines#Initialise PreStart Examples|Initialise PreStart Examples]] for an example of how to set these in the PGM file.
|-
|Global
|Fields with a thin blue Rectangle block indicates the variable is global, changes to this variable will be applied to all access windows.
|For example, Pipe - Sp Tab, SpBasis is global [[File:GlobalIndicator.png]]
|-
|Dependent
|Fields with Yellow Field Colour means something is setting the value, if the field has no triangle indicator, then it is likely due to Composition Fetch, Feeder Calculator (Bayer, Sugar, Potash) or Solubility. 
For Example, If composition fetch is set to continuously fetching the composition from another unit, then the composition in the feeder is Linked to the other unit, these fields are presented with the yellow background. User should not change these fields as any changes will be overridden by SysCAD when the project is solved.
|[[File:DepandantIndicator.png]]
|-
|Quick View
|Fields with a small turquoise square indicates the variable is displayed in [[Quick View]].
|[[File:QuickviewIndicator.png]]
|-
|Set or Get Reference Tags
|
*Yellow Forward Triangle and Yellow Field Colour: This Variable is being set by some logic. eg, PID, SetTag or General Controller.
*Green Backward Triangle: This variable is being read by some logic. eg, PID, SetTag or General Controller.
*Red Forward Triangle and Red Field Colour: This variable is being set by more than one logic, it is in conflict and should be looked into.
*Placing the cursor on the field will bring out a help box, detailing which controls are trying to write to the field.
NOTE: If the triangle is not shaded (i.e. only the outline is shown) then the tag was not set or read for that particular iteration.
|[[Image:ReferenceTagStatusColour.png]]
|-
|Manual User Input Value Change
|Fields with a Blue Dot indicates the value has been changed by the user, but the change has not been applied yet. To apply the change, hit the [[Image:OK Button.png]] button, or the Enter or Ctrl-Enter keys.
|[[File:ValueChangeIndicator.png]]
|-
|Inactive Tags
|Fields with values displayed in mustard colour indicates the model is NOT active, most likely due to the flowsheet being Deactivated.
|[[File:inactiveIndicator.png]]
|}

NOTE:The above status colour will also appear on the trend window.

== Zero Values Verses Small Number Display ==

SysCAD displays all data with two decimal points by default. The user can change the number format as needed anywhere on the Access Window, Trend, TagList, etc.

'''WARNING:''' There is an exception - by default SysCAD displays zero values as 0 with no decimal points. If a number appears as 0.00, it means the number has a small value and the user may get its exact value by changing the number format. This is not to be confused with true zero values.

== Drop List ==

There are two types of droplist in SysCAD:
# Returns a value - the drop list that returns a value will have an integer value listed to the right of the droplist, e.g.:
#:[[image:droplist_value.png]]
#*When making the droplist selection from a PGM file, user needs to set the integer value. For example: ["Cementation.GM.Operation"] = 43
# Returns a string - the drop list that expects a string input will not have an integer value listed.
#:[[image:droplist_string.png]]
#*In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in the description.
#*When making the droplist selection from a PGM file, user needs to set a string variable. For example: [Str "Cementation.MU1.Model"] = "Product Composition"

== Access Window Short Cut Keys ==

{|
|[[Image:CtrlKey.png]] + Enter || Same as pressing the [[#Selection Buttons|OK button]].
|-
|[[Image:CtrlKey.png]] + Home || Scrolls to the Top Left of the Current Access Window Tab Page
|-
|[[Image:CtrlKey.png]] + End || Scrolls to the Bottom Left of the Current Access Window Tab Page
|-
|[[Image:CtrlKey.png]] + [[Image:LeftRightArrow.png]] || Pans the horizontal scroll bar left/right (1 character width at a time)
|-
|[[Image:CtrlKey.png]] + [[Image:UpDownArrow.png]] || Pans the Vertical scrolls bar up/down (1 row at a time)
|-
|[[Image:ShiftKey.png]] + [[Image:UpDownArrow.png]] [[Image:LeftRightArrow.png]] || Highlights the fields which the text cursor travels over (e.g. for Copy/Paste)
|-
|[[Image:CtrlKey.png]] + PageUp || Go to the next Access Window tab page
|-
|[[Image:CtrlKey.png]] + PageDown || Go to the Previous Access Window tab page.
|-
|[[Image:CtrlKey.png]] + Various [[#Selection Buttons|Selection Buttons]] || Displays the model data on the Current Access Window without finding the unit on the Graphics Window.
|-
|[[Image:ShiftKey.png]] + Various [[#Selection Buttons|Selection Buttons]] || Displays the model data on the other Access Window, and finds the unit on the Graphics Window.
|-
|[[Image:ShiftKey.png]] + [[Image:CtrlKey.png]] + Various [[#Selection Buttons|Selection Buttons]] || Displays the model data on the other Access Window without finding the unit on the Graphics Window.
|}

Excel Get Tag Reports

2025-12-18T03:21:43Z

Keith.Armstrong: /* Report Keyword Syntax */

[[Category:Reports]]
{{Navigation|[[User Guide]]|[[Reports]]|[[Excel Reports]]|altname=Get Tag Reports}}
{{Excel Reports Header Tabs | currentpage=3}}

'''Related Links:''' [[Example SysCAD Excel Reports]], [[Sensitivity Analysis]]
----
{{TOC|x=20%}}
= Introduction =

This report is used to obtain the current value of tags. SysCAD loads the specified Excel file and searches all the sheets in the workbook for any of the SysCAD Get Tag Report key words such as '''"SysCAD_TagTable"''', '''"SysCAD_TagList"''' or '''"SysCAD_TagSelect"'''. The key words can be on any number of sheets, any quantity of times at any location.

{| border="1" cellpadding="5" cellspacing="0"
|-
| colspan="5" font style="background: #ebebeb" |'''''SysCAD Report Type and Keywords'''''
|-
!Width=100|'''Type''' || Width=350|'''Example Keyword''' (See also [[Excel_Get_Tag_Reports#Report Keyword Syntax|Keyword Syntax]])||Width=220|Tag / Variable Required ||Width=850|'''Brief Description '''
|-
| rowspan="2"|List || SysCAD_TagList("KPI", V, 20) ||rowspan=2| Tag = Full Variable Tag (Use [[Copy_and_Paste#Copying_Tags|Copy Full Tag]]) Eg: P101.Qo.Qm (t/h) ||[[Excel Get Tag Reports#SysCAD Report in a Single Row or Column|SysCAD Report in a Single Column]] - This reports SysCAD values to Excel. Use this form to report a group of tags from different unit operation models, for example, the Key Process Indicators for the project.
|-
| SysCAD_TagList("KPI", H, 20) ||[[Excel Get Tag Reports#SysCAD Report in a Single Row or Column|SysCAD Report in a Single Row]] - This reports SysCAD values to Excel. Use this form to report a group of tags from different unit operation models, for example, the Key Process Indicators for the project.
|-
| Lists using Offset || SysCAD_TagListOffSet(B12, "Case2") || Referencing an existing List, No new tags required||[[Excel Get Tag Reports#Multiple_Reports_from_a_Single_Row_or_Column_.28OffSet.29|Multiple Reports from a Single Row or Column (OffSet)]]. This is used in combination with the [[Excel Reports#SysCAD Report in a Single Row or Column|SysCAD_TagList Report]]. Using the keyword SysCAD_TagListOffSet, the user can obtain multiple lists of values from SysCAD using a single set of SysCAD tags.
|-
| rowspan="2"|Table Simple || SysCAD_TagTable("Inputs", H, 50, 50) ||rowspan=4|Primary Tag: must include Unit Name Eg: P101 Secondary Tag: variable name (Use [[Copy_and_Paste#Copying_Tags|Copy Tag]]) Eg: Qo.Qm (t/h) ||[[Excel Get Tag Reports#SysCAD Report in a Table|SysCAD Report in a Table]] - This reports SysCAD values to Excel, the unit tags will be column headings, and variables are row headings. Best used for overall mass balance tables.
|-
| SysCAD_TagTable("Streams", V, 50, 2000) || [[Excel Get Tag Reports#SysCAD Report in a Table|SysCAD Report in a Table]] - This reports SysCAD values to Excel, the unit tags will be row headings, and variables are column headings. Best used for stream data tables.
|-
| Table Multi Column || SysCAD_TagTable("MultiCol", H, 2, 25, 3) || [[Excel Get Tag Reports#SysCAD report in Multi Column Blocks|SysCAD Report in Multi Column blocks]], This is an extension of the [[Excel Reports#SysCAD Report in a Table|SysCAD TagTable Report]]. Using an additional parameter, the user can obtain multiple columns of values from SysCAD using a single primary SysCAD tag. This reports SysCAD values to Excel, the unit tags will be column headings, and variables are row headings.
|-
| Table Multi Row ||SysCAD_TagTable("MultiRow", V, 6, 3, 5) || [[Excel Get Tag Reports#SysCAD report in Multi Row Blocks|SysCAD Report in Multi Row Blocks]], This is an extension of the [[Excel Reports#SysCAD Report in a Table|SysCAD TagTable Report]]. Using an additional parameter, the user can obtain multiple columns of values from SysCAD using a single primary SysCAD tag. This reports SysCAD values to Excel, the unit tags will be row headings, and variables are column headings.
|-
| Table with Select Option || SysCAD_TagSelect("Streams", V, 30, 2000, Where [UnitGroup] == "Stream", Orderby [Graphic] [Tag], ClearTags: On) ||Primary Tag: not required, created by tagselect Secondary Tag: variable name (Use [[Copy_and_Paste#Copying_Tags|Copy Tag]]) Eg: Qo.Qm (t/h) || [[Excel Tag Select Reports|SysCAD Report in a Table based on Select criteria]]. Using the keyword '''SysCAD_TagSelect''', the user can obtain a table of values from SysCAD as described for [[Excel Reports#SysCAD Report in a Table|SysCAD_TagTable Report]], but with the additional feature of using a SQL type select statement to get SysCAD to return a list of models that meet the select statement rather than entering the unit model tags.
|-
|}

'''Notes:'''
# The keyword "SysCAD_TagTable" has replaced the keyword "SysCAD_Tags" that was used in previous versions of SysCAD. SysCAD will still recognise this keyword and generate a report table.
# The example keywords in the above table can be copied and pasted directly into an Excel spreadsheet for an Excel report.
# The SysCAD key words (such as SysCAD_TagTable and SysCAD_TagList) are '''not''' case sensitive;
# The column/row at which the SysCAD key word resides, as well as the tags, can be hidden to improve the presentation of the report.
#* In the distributed [[Example SysCAD Excel Reports]], these columns/row are normally hidden using outline.

= Report Keyword Syntax =
{|class = wikitable
!Keyword Function Parameter || Used by Report type || Description
|-
|
====Report Name====
(Recommended/Optional)
|all Reports types
|
*The first parameter within the function is the name of the report.
**For example, for keyword function "'''SysCAD_TagTable({{Background color|yellow|Streams}}, H, 4, 4)'''", the name of the report is "'''{{Background color|yellow|Streams}}'''".
*If the name contains spaces, then it should be enclosed in quotes.
* The report name is only used by SysCAD to find a match if a specific report has been requested. If user intend to generate all the reports in the workbook at the same time, then the name can be left blank with {{Background color|yellow|""}} as the first parameter.
* The same report name may be used more than once - this is useful if you want to generate a number of reports at the same time.
** For example, when running scenarios, user can set up multiple reports for the same case run, while naming them all '''{{Background color|yellow|Case1}}'''. At the end of the first case, all the reports can be generated with one report call.
* This is not to be confused with the MS Excel File name or MS Excel Worksheet Name.
* See also [[Excel_Reports#SysCAD_Report_Name| using and managing SysCAD report name]]
|-
| '''Primary Tag Direction''' (Required)
|all Reports types except [[#Multiple Reports from a Single Row or Column (OffSet)|Tag_ListOffset]]
|
The second parameter defines the direction of the SysCAD Tags; H (or h) for Horizontal OR V (or v) for Vertical. If this parameter is invalid then 'V' (vertical) is assumed.

If '''H''' (horizontal) is entered for: 
:a) A ''SysCAD_TagTable'' report, then SysCAD expects to find the '''primary tags''' in cells to the right of the key word; 
:b) A ''SysCAD_TagList'' report, then SysCAD expects to find the full tags in cells to the right of the key word.

If '''V''' (vertical) is entered for: 
:a) A ''SysCAD_TagTable'' report, then SysCAD expects to find the '''primary tags''' in cells directly below the key word; 
:b) A ''SysCAD_TagList'' report, then SysCAD expects to find the full tags in cells directly below the key word.
|-
| '''Horizontal search length''' (Required/Optional)
|all [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel Tag Select Reports|Tag Select]] and [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] - Horizontal
|
*
*For simple Tag List and Tag Table, this parameter determines how many cells to the '''right''' of the key word SysCAD must process.
*For multi Column or Multi Row Tag Table, this parameter determines how many Primary Tag Blocks to the '''right''' of the key word SysCAD must process.
* The exact number of columns with tags does not have to be specified, e.g. if a value of 5 is specified SysCAD will read five cells looking for tags.
* If there are more than one report on the same worksheet, then care should be taken when specifying the search length, it must not be too big so that it overlaps the start of another report on the same row.
* When using "Excel 97-2003 Workbook (*.xls)" the search area must not exceed column 256 because of this limitation in this Excel file format.
|-
| '''Vertical search length''' (Required/Optional)
|all [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel Tag Select Reports|Tag Select]] and [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] - Vertical
|
*For simple Tag List and Tag Table, this parameter determines how many cells '''below''' the key word SysCAD must process.
*For multi Column or Multi Row Tag Table, this parameter determines how many Primary Tag Blocks '''below''' the key word SysCAD must process.
* The exact number of rows that contain tags does not have to be specified.
* If there are more than one report on the same worksheet, then care should be taken when specifying the search length, it must not be too big so that it overlaps the start of another report on the same column.
|-
|'''Primary Tag Block Size''' (Optional)
|Multi Column or Multi Row Tag Tables
|
*This allows the user to specify the block size for each Primary tag. See [[#SysCAD report in Multi Column Blocks|SysCAD report in Multi Column Blocks]] and [[#SysCAD report in Multi Row Blocks|SysCAD report in Multi Row Blocks]] for examples.
|-
|'''Inactive:XXX''' (Optional)
|All [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] and [[Excel Tag Select Reports|Tag Select]]
|
*It is used to report "inactive" model values, usually as a results of inactivated flowsheets. These are normally displayed within SysCAD using the "inactive status colour". 
*The default for inactive is: '''{{Background color|yellow|*Inactive*}}''', this parameter does not have to be added if user is happy with the default value. 
*To display the true value of the tag even if it is inactive, use "value". So the entry would be {{Background color|yellow|Inactive:value}}. {{Available139|32346}} 
*For customised display, please enter the required text after {{Background color|yellow|Inactive: }}
*For example:
*#The left image is generated using default inactive settings: SysCAD_TagTable("Stream", V, 12, 100)
*#The right image is generated using user defined inactive settings: SysCAD_TagTable("Stream", V, 12, 100, {{Background color|yellow|Inactive:N/A}})
*: [[image:Report138_inactive.png]]
|-
| '''NAN:XXX''' (Optional)
|All [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] and [[Excel Tag Select Reports|Tag Select]]
|
*It is used when the reported value is not a number (NAN), the variable would normally be displayed within SysCAD as "*". an example of this would be the volume fraction of an aqueous species using density correction function.
*The default for inactive is: '''{{Background color|yellow|*}}''', this parameter does not have to be added if user is happy with the default value. 
*For customised display, please enter the required text after {{Background color|yellow|NAN: }}
*For example:
*#The left image is the value displayed in the SysCAD access window
*#The middle image is generated using default NAN settings: SysCAD_TagTable("Stream", V, 12, 100)
*#The right image is generated using user defined NAN settings: SysCAD_TagTable("Stream", V, 12, 100, {{Background color|yellow|NAN:Not Applicable}})
*: [[image:Report138_nan.png]]

|}

= Report Layout Requirements =

== Basic Format of a simple Get Tag Report ==

Two examples of simple reports are shown below, all tags in blue are required for the report:
:[[Image:tagtable.png]]    [[Image:taglist1.png]]

# The first example (left image) is in the form of a function '''SysCAD_TagTable('''Report Name, (Primary) Tag Direction - Horizontal or Vertical, Horizontal search length, Vertical search length''')'''. The keyword parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
#* This example will create a table of values from the primary tags in cells D1 to F1 combined with the secondary tags in cells C2 to C5;
#* Cell C1 contains the key for the report;
#* Columns A & B are optional.
#* When generated, the values will be populated in cells D2 to F5.
#The second example (right image) is in the form of a function '''SysCAD_TagList('''Report Name, Tag Direction - Horizontal or Vertical, Horizontal or Vertical search length''')'''. The keyword parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
#* This example will create a list of values from the full tags in cells C2 to C5.
#* Cell C1 contains the key for the report.
#* Columns A & B are optional.
#* When generated, the values will be populated in cells D2 to D5.

==Adding SysCAD Tags and variables to the reports ==
# The '''exact''' SysCAD tag is required when referenced in the report. The SysCAD tag can be copied and pasted into the report. See section on [[Copy and Paste#Copying_Tags|Copying Tags]].
# '''Full Variable Tag''': some report type (e.g.: Tag List report) requires the Full Variable Tag, please use [[Copy_and_Paste#Copying_Tags|Copy Full Tag]] to copy the tag.
# '''Primary tag''': When a full tag is copied from SysCAD, the first part of the tag (separated by dots) is the unit tag name. This is usually referred to as the primary tag.
#*For example, if P_001.Qo.Qm (t/h) is the full tag, then P_001 is usually the Primary Tag.
#* The Primary tag can also the be portion of the tag that is common for the list of variables, so, if all variables are from the Qo tab, then the Primary tag can be P_001.Qo
# '''Secondary tag''': This is the remaining of the full tag when Primary tag is removed. This is usually what is copied from [[Copy_and_Paste#Copying_Tags|Copy Tag]].
#* Using the same example as above, if Primary Tag is P_001, the secondary tag is Qo.Qm (t/h)
#* If the primary tag is P_001.Qo, then the secondary tag is Qm (t/h)
# Tags are not case sensitive, e.g. the secondary tag ''Qm'' or ''QM'' would both work; as would primary tag P_001 or p_001.
# The required engineering unit is specified after the secondary tags.
#* The secondary tag and the engineering units are separated by a space.
#* The Engineering units are usually placed in round brackets, but this is optional.
#* '''Engineering units are case sensitive'''. Check the spelling in SysCAD if different units are needed.
#* If the engineering units requested are invalid, unknown or not specified then the result is returned in the SysCAD default SI units.
#There are two special graphics Names that can be used as variable names in a SysCAD get tag reports that are not actual 'variable tags' on the access window of the unit. These special graphics tags are:
#* '''Graphic''' - this will return the name of the graphics page that the model appears on.
#* '''Symbol''' - this will return the name of the graphics symbol used by a model.
#*Please see the TagTable example in the [[Excel Tag Select Reports#List Graphics Symbols|List Graphics Symbols]] example on the TagSelect page.

== Reporting Rules ==

SysCAD follows the following rules when placing results in the cells:
# If the primary or secondary or full tag for a cell is blank, the resulting cell is left unchanged.
# If the primary or full tag for a cell only contains a single period/dot (.), the resulting cell is left unchanged. {{Available139|32925}}
# If the relevant cell contains a formula, the cell is left unchanged. The cell is not altered even if the corresponding tag is valid.
# For ''SysCAD_TagTable'' reports, SysCAD generates a full tag by combining the corresponding primary and secondary tags.
#* If this tag does not exist in SysCAD, the cell will be left blank.
#* If the full tag does exist the resulting value in the required units is placed in the relevant cell.
# All styles such as fonts, borders, colours, bold text etc. are ignored when SysCAD is transferring data. The format styles of the results are not changed when SysCAD writes the values to these cells.
# SysCAD provides feedback about the report on a separate sheet with the title ''Tag Errs''. All errors and messages can be viewed on this page after a report has been generated.

=Report Type Examples =

== SysCAD Report in a Table ==

This report is used to obtain the current value of tags in a table format. Using the keyword '''SysCAD_TagTable''', the user can obtain a table of values from SysCAD built up from primary and secondary tags in the row and column headings.

The syntax for this type of report is '''SysCAD_TagTable(Report Name, (Primary) Tag Direction (H or V), Horizontal search length, Vertical search length)'''. These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].

An example of a simple report is shown below, all tags in blue are required for the report:

'''SysCAD_TagTable("Flow",H,3,4)'''

[[Image:tagtable.png]]

The exact SysCAD Tag is required when referenced in the report.
* The primary tags (cells D1 to F1 in the example) are the unit model names (i.e. the name of the pipes, tanks, etc.) See [[Excel_Reports#Obtaining_Equipment_.26_Pipe_List_for_the_Report_Generation|Obtaining Equipment & Pipe List for the Report Generation]] for hints on how to copy the required Tags to Excel.
* The secondary tags (cells C2 to C5 in the example) are the quantities to be measured such as mass flow or temperature. Please use [[Copy_and_Paste#Copying_Tags|Copy Tag]] for secondary tags.
*If there are more than one report on the same MS Excel worksheet, please make sure the search length is not too large so that it overlaps with a different report.
*An example of a Tagtable report is included with the SysCAD install, see [[Example SysCAD Excel Reports]]

== SysCAD Tag Select Reports ==

An extension of the Table report is the Select report which is a SysCAD Report in a Table based on Select criteria. Same as SysCAD_TagTable with extra options to specify selection criteria to return the list of model tags that match the select statement as well as the table data.

*There are many examples of the tag select reports, these are documented on a separate page, please see [[Excel Tag Select Reports]].
*The [[Adding_and_Executing_Excel_Reports#Report_Templates_and_Default_Reports|Default Reports]] uses the Tag Select Reports extensively. User may open these default reports to view some working examples.

== SysCAD Report in a Single Row or Column ==

This variation of SysCAD Get Tag report is for a user wanting to generate a small report, either in a straight row or column. Using the keyword '''SysCAD_TagList''', the user can obtain a list of values from SysCAD using full tags in the adjacent row or column.

The syntax for these types of reports is '''SysCAD_TagList(ReportName, Tag Direction (H or V), Search Length)'''. These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].

Some examples are as follows:

==== A Report in a single Row ====

:'''SysCAD_TagList("Results",H,4)'''
:[[Image:taglistH.png]]
*The full SysCAD tags in blue are required as part of the report set up. Please use [[Copy_and_Paste#Copying_Tags|Copy Full Tags]] when copying the variable from SysCAD.
*The results are always placed in the row directly underneath the SysCAD Tags.
*If there are more than one report on the same MS Excel worksheet, please make sure the search length is not too large so that it overlaps with a different report.

==== A Report in a single Column ====

:'''SysCAD_TagList("Results",V,4)'''
:[[Image:taglist1.png]]
*The full SysCAD tags in blue are required as part of the report set up. Please use [[Copy_and_Paste#Copying_Tags|Copy Full Tags]] when copying the variable from SysCAD.
*The results are always placed in the column directly adjacent to the SysCAD tags.
*If there are more than one report on the same MS Excel worksheet, please make sure the search length is not too large so that it overlaps with a different report.
*An example of a full TagList report is included with the SysCAD install, see [[Example SysCAD Excel Reports]]

== Multiple Reports from a Single Row or Column (OffSet) ==

:This report format is most useful for users wanting to compare key results in a summary table for multiple scenarios or runs under various conditions. To do this:
:# First set up a report using [[#SysCAD Report in a Single Row or Column|SysCAD_TagList]] in a single row or column. (See column C.)
:# Then use the key word '''SysCAD_TagListOffSet(cell reference, ''Report Name'')''' to point to the reference SysCAD_TagList Report created in the previous step.
:#*columns E, and F are examples of offset reports. The reference report Case1 we have set up is located in Cell '''C4''' (keyword location), so we will enter '''SysCAD_TagListOffSet(C4, ''Case2'')''' for case2.
:#As before, writing in blue forms the SysCAD report,
:#* Both column C and row 4 can be hidden when presenting the report for neatness.
:# Different [[Excel_Get_Tag_Reports#Report_Name|Report Name]] '''must''' be used for each new offset report. In our example, we have used Case2 and Case 3 as report names (highlighted in the picture below).
:#:[[Image:report_offset.png]] (This is an extract from the Digestion.xlsm report, located in the \Examples\Alumina\Digestion Example.spf\Reports folder.)
:#To populate the reports, after each case/scenario solve, specify the [[Excel_Get_Tag_Reports#Report_Name|Report Name]] to be generated, and only generate that report. That is, DO NOT leave '*' as the report name, as this will populate all the reports, and not the desired case report for the scenario.
:#:[[Image:report_offset2.png]]
:#Alternatively, once the reports are set up, the user may use a command script (see section on [[Command Scripts]]) or the automation macro interface (see section on [[COM Automation]]) to automate the process of running and reporting on multiple cases.

== SysCAD report in Multi Column Blocks ==

This is an extension to the [[#SysCAD Report in a Table|SysCAD TagTable Report]].

The syntax used is '''SysCAD_TagTable(Report Name, (Primary) Tag Direction (H or V), Horizontal search length, Vertical search length, Primary Tag block Size)'''.

These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
*In the example below, the Horizontal search length is 5, the Primary Tag block size is 3, this means that there are five Primary Tags, and they will be located 3 columns apart (cells F1, G1 and then I1 and J1 (and so on) are ignored).

'''SysCAD_TagTable("MultiCol",H,5,30,{{Background color|yellow|3}})'''

[[Image:Excel Report 3.png]]

NOTES:
#In the above example, the writing in blue and Shaded Cells are user-defined information.
# Columns B,C and D can be hidden when presenting the report for neatness.
# Blank cells are allowed in this report type.

== SysCAD report in Multi Row Blocks ==

This is an extension to the [[#SysCAD Report in a Table|SysCAD TagTable Report]].

The syntax used is '''SysCAD_TagTable(Report Name, (Primary) Tag Direction (H or V), Horizontal search length, Vertical search length, Primary Tag block Size)'''.

These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
* In the example below, the Vertical search length is 3, the Primary Tag block size is 5, this means that there are three Primary Tags, and they will be located 5 rows apart.

'''SysCAD_TagTable("MultiRow",V,6,3,{{Background color|yellow|5}})'''

[[Image:reportmultirow.png]]

NOTES:
#In the above example, the writing in blue and Shaded Cells are user-defined information.
# Rows 1 to 5 can be hidden when presenting the report for neatness.
# Blank cells are allowed in this report type.

Excel Get Tag Reports

2025-12-18T03:20:35Z

Keith.Armstrong: /* Report Keyword Syntax */

[[Category:Reports]]
{{Navigation|[[User Guide]]|[[Reports]]|[[Excel Reports]]|altname=Get Tag Reports}}
{{Excel Reports Header Tabs | currentpage=3}}

'''Related Links:''' [[Example SysCAD Excel Reports]], [[Sensitivity Analysis]]
----
{{TOC|x=20%}}
= Introduction =

This report is used to obtain the current value of tags. SysCAD loads the specified Excel file and searches all the sheets in the workbook for any of the SysCAD Get Tag Report key words such as '''"SysCAD_TagTable"''', '''"SysCAD_TagList"''' or '''"SysCAD_TagSelect"'''. The key words can be on any number of sheets, any quantity of times at any location.

{| border="1" cellpadding="5" cellspacing="0"
|-
| colspan="5" font style="background: #ebebeb" |'''''SysCAD Report Type and Keywords'''''
|-
!Width=100|'''Type''' || Width=350|'''Example Keyword''' (See also [[Excel_Get_Tag_Reports#Report Keyword Syntax|Keyword Syntax]])||Width=220|Tag / Variable Required ||Width=850|'''Brief Description '''
|-
| rowspan="2"|List || SysCAD_TagList("KPI", V, 20) ||rowspan=2| Tag = Full Variable Tag (Use [[Copy_and_Paste#Copying_Tags|Copy Full Tag]]) Eg: P101.Qo.Qm (t/h) ||[[Excel Get Tag Reports#SysCAD Report in a Single Row or Column|SysCAD Report in a Single Column]] - This reports SysCAD values to Excel. Use this form to report a group of tags from different unit operation models, for example, the Key Process Indicators for the project.
|-
| SysCAD_TagList("KPI", H, 20) ||[[Excel Get Tag Reports#SysCAD Report in a Single Row or Column|SysCAD Report in a Single Row]] - This reports SysCAD values to Excel. Use this form to report a group of tags from different unit operation models, for example, the Key Process Indicators for the project.
|-
| Lists using Offset || SysCAD_TagListOffSet(B12, "Case2") || Referencing an existing List, No new tags required||[[Excel Get Tag Reports#Multiple_Reports_from_a_Single_Row_or_Column_.28OffSet.29|Multiple Reports from a Single Row or Column (OffSet)]]. This is used in combination with the [[Excel Reports#SysCAD Report in a Single Row or Column|SysCAD_TagList Report]]. Using the keyword SysCAD_TagListOffSet, the user can obtain multiple lists of values from SysCAD using a single set of SysCAD tags.
|-
| rowspan="2"|Table Simple || SysCAD_TagTable("Inputs", H, 50, 50) ||rowspan=4|Primary Tag: must include Unit Name Eg: P101 Secondary Tag: variable name (Use [[Copy_and_Paste#Copying_Tags|Copy Tag]]) Eg: Qo.Qm (t/h) ||[[Excel Get Tag Reports#SysCAD Report in a Table|SysCAD Report in a Table]] - This reports SysCAD values to Excel, the unit tags will be column headings, and variables are row headings. Best used for overall mass balance tables.
|-
| SysCAD_TagTable("Streams", V, 50, 2000) || [[Excel Get Tag Reports#SysCAD Report in a Table|SysCAD Report in a Table]] - This reports SysCAD values to Excel, the unit tags will be row headings, and variables are column headings. Best used for stream data tables.
|-
| Table Multi Column || SysCAD_TagTable("MultiCol", H, 2, 25, 3) || [[Excel Get Tag Reports#SysCAD report in Multi Column Blocks|SysCAD Report in Multi Column blocks]], This is an extension of the [[Excel Reports#SysCAD Report in a Table|SysCAD TagTable Report]]. Using an additional parameter, the user can obtain multiple columns of values from SysCAD using a single primary SysCAD tag. This reports SysCAD values to Excel, the unit tags will be column headings, and variables are row headings.
|-
| Table Multi Row ||SysCAD_TagTable("MultiRow", V, 6, 3, 5) || [[Excel Get Tag Reports#SysCAD report in Multi Row Blocks|SysCAD Report in Multi Row Blocks]], This is an extension of the [[Excel Reports#SysCAD Report in a Table|SysCAD TagTable Report]]. Using an additional parameter, the user can obtain multiple columns of values from SysCAD using a single primary SysCAD tag. This reports SysCAD values to Excel, the unit tags will be row headings, and variables are column headings.
|-
| Table with Select Option || SysCAD_TagSelect("Streams", V, 30, 2000, Where [UnitGroup] == "Stream", Orderby [Graphic] [Tag], ClearTags: On) ||Primary Tag: not required, created by tagselect Secondary Tag: variable name (Use [[Copy_and_Paste#Copying_Tags|Copy Tag]]) Eg: Qo.Qm (t/h) || [[Excel Tag Select Reports|SysCAD Report in a Table based on Select criteria]]. Using the keyword '''SysCAD_TagSelect''', the user can obtain a table of values from SysCAD as described for [[Excel Reports#SysCAD Report in a Table|SysCAD_TagTable Report]], but with the additional feature of using a SQL type select statement to get SysCAD to return a list of models that meet the select statement rather than entering the unit model tags.
|-
|}

'''Notes:'''
# The keyword "SysCAD_TagTable" has replaced the keyword "SysCAD_Tags" that was used in previous versions of SysCAD. SysCAD will still recognise this keyword and generate a report table.
# The example keywords in the above table can be copied and pasted directly into an Excel spreadsheet for an Excel report.
# The SysCAD key words (such as SysCAD_TagTable and SysCAD_TagList) are '''not''' case sensitive;
# The column/row at which the SysCAD key word resides, as well as the tags, can be hidden to improve the presentation of the report.
#* In the distributed [[Example SysCAD Excel Reports]], these columns/row are normally hidden using outline.

= Report Keyword Syntax =
{|class = wikitable
!Keyword Function Parameter || Used by Report type || Description
|-
|
====Report Name====
(Recommended/Optional)
|all Reports types
|
*The first parameter within the function is the name of the report.
**For example, for keyword function "'''SysCAD_TagTable({{Background color|yellow|Streams}}, H, 4, 4)'''", the name of the report is "'''{{Background color|yellow|Streams}}'''".
*If the name contains spaces, then it should be enclosed in quotes.
* The report name is only used by SysCAD to find a match if a specific report has been requested. If user intend to generate all the reports in the workbook at the same time, then the name can be left blank with {{Background color|yellow|""}} as the first parameter.
* The same report name may be used more than once - this is useful if you want to generate a number of reports at the same time.
** For example, when running scenarios, user can set up multiple reports for the same case run, while naming them all '''{{Background color|yellow|Case1}}'''. At the end of the first case, all the reports can be generated with one report call.
* This is not to be confused with the MS Excel File name or MS Excel Worksheet Name.
* See also [[Excel_Reports#SysCAD_Report_Name| using and managing SysCAD report name]]
|-
| '''Primary Tag Direction''' (Required)
|all Reports types except [[#Multiple Reports from a Single Row or Column (OffSet)|Tag_ListOffset]]
|
The second parameter defines the direction of the SysCAD Tags; H (or h) for Horizontal OR V (or v) for Vertical. If this parameter is invalid then 'V' (vertical) is assumed.

If '''H''' (horizontal) is entered for: 
:a) A ''SysCAD_TagTable'' report, then SysCAD expects to find the '''primary tags''' in cells to the right of the key word; 
:b) A ''SysCAD_TagList'' report, then SysCAD expects to find the full tags in cells to the right of the key word.

If '''V''' (vertical) is entered for: 
:a) A ''SysCAD_TagTable'' report, then SysCAD expects to find the '''primary tags''' in cells directly below the key word; 
:b) A ''SysCAD_TagList'' report, then SysCAD expects to find the full tags in cells directly below the key word.
|-
| '''Horizontal search length''' (Required/Optional)
|all [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel Tag Select Reports|Tag Select]] and [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] - Horizontal
|
*
*For simple Tag List and Tag Table, this parameter determines how many cells to the '''right''' of the key word SysCAD must process.
*For multi Column or Multi Row Tag Table, this parameter determines how many Primary Tag Blocks to the '''right''' of the key word SysCAD must process.
* The exact number of columns with tags does not have to be specified, e.g. if a value of 5 is specified SysCAD will read five cells looking for tags.
* If there are more than one report on the same worksheet, then care should be taken when specifying the search length, it must not be too big so that it overlaps the start of another report on the same row.
* When using "Excel 97-2003 Workbook (*.xls)" the search area must not exceed column 256 because of this limitation in this Excel file format.
|-
| '''Vertical search length''' (Required/Optional)
|all [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel Tag Select Reports|Tag Select]] and [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] - Vertical
|
*For simple Tag List and Tag Table, this parameter determines how many cells '''below''' the key word SysCAD must process.
*For multi Column or Multi Row Tag Table, this parameter determines how many Primary Tag Blocks '''below''' the key word SysCAD must process.
* The exact number of rows that contain tags does not have to be specified.
* If there are more than one report on the same worksheet, then care should be taken when specifying the search length, it must not be too big so that it overlaps the start of another report on the same column.
|-
|'''Primary Tag Block Size''' (Optional)
|Multi Column or Multi Row Tag Tables
|
*This allows the user to specify the block size for each Primary tag. See [[#SysCAD report in Multi Column Blocks|SysCAD report in Multi Column Blocks]] and [[#SysCAD report in Multi Row Blocks|SysCAD report in Multi Row Blocks]] for examples.
|-
|'''Inactive:XXX''' (Optional)
|All [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] and [[Excel Tag Select Reports|Tag Select]]
|
*It is used to report "inactive" model values, usually as a results of inactivated flowsheets. These are normally displayed within SysCAD using the "inactive status colour". 
*The default for inactive is: '''{{Background color|yellow|*Inactive*}}''', this parameter does not have to be added if user is happy with the default value. 
*To display the true value of the tag even if it is inactive, use "value". So the entry would be {{Background color|yellow|Inactive:value}}. {{Available139|32346}}. 
*For customised display, please enter the required text after {{Background color|yellow|Inactive: }}
*For example:
*#The left image is generated using default inactive settings: SysCAD_TagTable("Stream", V, 12, 100)
*#The right image is generated using user defined inactive settings: SysCAD_TagTable("Stream", V, 12, 100, {{Background color|yellow|Inactive:N/A}})
*: [[image:Report138_inactive.png]]
|-
| '''NAN:XXX''' (Optional)
|All [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Table|SysCAD_TagTable]], [[Excel_Get_Tag_Reports#SysCAD_Report_in_a_Single_Row_or_Column|SysCAD_TagList]] and [[Excel Tag Select Reports|Tag Select]]
|
*It is used when the reported value is not a number (NAN), the variable would normally be displayed within SysCAD as "*". an example of this would be the volume fraction of an aqueous species using density correction function.
*The default for inactive is: '''{{Background color|yellow|*}}''', this parameter does not have to be added if user is happy with the default value. 
*For customised display, please enter the required text after {{Background color|yellow|NAN: }}
*For example:
*#The left image is the value displayed in the SysCAD access window
*#The middle image is generated using default NAN settings: SysCAD_TagTable("Stream", V, 12, 100)
*#The right image is generated using user defined NAN settings: SysCAD_TagTable("Stream", V, 12, 100, {{Background color|yellow|NAN:Not Applicable}})
*: [[image:Report138_nan.png]]

|}

= Report Layout Requirements =

== Basic Format of a simple Get Tag Report ==

Two examples of simple reports are shown below, all tags in blue are required for the report:
:[[Image:tagtable.png]]    [[Image:taglist1.png]]

# The first example (left image) is in the form of a function '''SysCAD_TagTable('''Report Name, (Primary) Tag Direction - Horizontal or Vertical, Horizontal search length, Vertical search length''')'''. The keyword parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
#* This example will create a table of values from the primary tags in cells D1 to F1 combined with the secondary tags in cells C2 to C5;
#* Cell C1 contains the key for the report;
#* Columns A & B are optional.
#* When generated, the values will be populated in cells D2 to F5.
#The second example (right image) is in the form of a function '''SysCAD_TagList('''Report Name, Tag Direction - Horizontal or Vertical, Horizontal or Vertical search length''')'''. The keyword parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
#* This example will create a list of values from the full tags in cells C2 to C5.
#* Cell C1 contains the key for the report.
#* Columns A & B are optional.
#* When generated, the values will be populated in cells D2 to D5.

==Adding SysCAD Tags and variables to the reports ==
# The '''exact''' SysCAD tag is required when referenced in the report. The SysCAD tag can be copied and pasted into the report. See section on [[Copy and Paste#Copying_Tags|Copying Tags]].
# '''Full Variable Tag''': some report type (e.g.: Tag List report) requires the Full Variable Tag, please use [[Copy_and_Paste#Copying_Tags|Copy Full Tag]] to copy the tag.
# '''Primary tag''': When a full tag is copied from SysCAD, the first part of the tag (separated by dots) is the unit tag name. This is usually referred to as the primary tag.
#*For example, if P_001.Qo.Qm (t/h) is the full tag, then P_001 is usually the Primary Tag.
#* The Primary tag can also the be portion of the tag that is common for the list of variables, so, if all variables are from the Qo tab, then the Primary tag can be P_001.Qo
# '''Secondary tag''': This is the remaining of the full tag when Primary tag is removed. This is usually what is copied from [[Copy_and_Paste#Copying_Tags|Copy Tag]].
#* Using the same example as above, if Primary Tag is P_001, the secondary tag is Qo.Qm (t/h)
#* If the primary tag is P_001.Qo, then the secondary tag is Qm (t/h)
# Tags are not case sensitive, e.g. the secondary tag ''Qm'' or ''QM'' would both work; as would primary tag P_001 or p_001.
# The required engineering unit is specified after the secondary tags.
#* The secondary tag and the engineering units are separated by a space.
#* The Engineering units are usually placed in round brackets, but this is optional.
#* '''Engineering units are case sensitive'''. Check the spelling in SysCAD if different units are needed.
#* If the engineering units requested are invalid, unknown or not specified then the result is returned in the SysCAD default SI units.
#There are two special graphics Names that can be used as variable names in a SysCAD get tag reports that are not actual 'variable tags' on the access window of the unit. These special graphics tags are:
#* '''Graphic''' - this will return the name of the graphics page that the model appears on.
#* '''Symbol''' - this will return the name of the graphics symbol used by a model.
#*Please see the TagTable example in the [[Excel Tag Select Reports#List Graphics Symbols|List Graphics Symbols]] example on the TagSelect page.

== Reporting Rules ==

SysCAD follows the following rules when placing results in the cells:
# If the primary or secondary or full tag for a cell is blank, the resulting cell is left unchanged.
# If the primary or full tag for a cell only contains a single period/dot (.), the resulting cell is left unchanged. {{Available139|32925}}
# If the relevant cell contains a formula, the cell is left unchanged. The cell is not altered even if the corresponding tag is valid.
# For ''SysCAD_TagTable'' reports, SysCAD generates a full tag by combining the corresponding primary and secondary tags.
#* If this tag does not exist in SysCAD, the cell will be left blank.
#* If the full tag does exist the resulting value in the required units is placed in the relevant cell.
# All styles such as fonts, borders, colours, bold text etc. are ignored when SysCAD is transferring data. The format styles of the results are not changed when SysCAD writes the values to these cells.
# SysCAD provides feedback about the report on a separate sheet with the title ''Tag Errs''. All errors and messages can be viewed on this page after a report has been generated.

=Report Type Examples =

== SysCAD Report in a Table ==

This report is used to obtain the current value of tags in a table format. Using the keyword '''SysCAD_TagTable''', the user can obtain a table of values from SysCAD built up from primary and secondary tags in the row and column headings.

The syntax for this type of report is '''SysCAD_TagTable(Report Name, (Primary) Tag Direction (H or V), Horizontal search length, Vertical search length)'''. These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].

An example of a simple report is shown below, all tags in blue are required for the report:

'''SysCAD_TagTable("Flow",H,3,4)'''

[[Image:tagtable.png]]

The exact SysCAD Tag is required when referenced in the report.
* The primary tags (cells D1 to F1 in the example) are the unit model names (i.e. the name of the pipes, tanks, etc.) See [[Excel_Reports#Obtaining_Equipment_.26_Pipe_List_for_the_Report_Generation|Obtaining Equipment & Pipe List for the Report Generation]] for hints on how to copy the required Tags to Excel.
* The secondary tags (cells C2 to C5 in the example) are the quantities to be measured such as mass flow or temperature. Please use [[Copy_and_Paste#Copying_Tags|Copy Tag]] for secondary tags.
*If there are more than one report on the same MS Excel worksheet, please make sure the search length is not too large so that it overlaps with a different report.
*An example of a Tagtable report is included with the SysCAD install, see [[Example SysCAD Excel Reports]]

== SysCAD Tag Select Reports ==

An extension of the Table report is the Select report which is a SysCAD Report in a Table based on Select criteria. Same as SysCAD_TagTable with extra options to specify selection criteria to return the list of model tags that match the select statement as well as the table data.

*There are many examples of the tag select reports, these are documented on a separate page, please see [[Excel Tag Select Reports]].
*The [[Adding_and_Executing_Excel_Reports#Report_Templates_and_Default_Reports|Default Reports]] uses the Tag Select Reports extensively. User may open these default reports to view some working examples.

== SysCAD Report in a Single Row or Column ==

This variation of SysCAD Get Tag report is for a user wanting to generate a small report, either in a straight row or column. Using the keyword '''SysCAD_TagList''', the user can obtain a list of values from SysCAD using full tags in the adjacent row or column.

The syntax for these types of reports is '''SysCAD_TagList(ReportName, Tag Direction (H or V), Search Length)'''. These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].

Some examples are as follows:

==== A Report in a single Row ====

:'''SysCAD_TagList("Results",H,4)'''
:[[Image:taglistH.png]]
*The full SysCAD tags in blue are required as part of the report set up. Please use [[Copy_and_Paste#Copying_Tags|Copy Full Tags]] when copying the variable from SysCAD.
*The results are always placed in the row directly underneath the SysCAD Tags.
*If there are more than one report on the same MS Excel worksheet, please make sure the search length is not too large so that it overlaps with a different report.

==== A Report in a single Column ====

:'''SysCAD_TagList("Results",V,4)'''
:[[Image:taglist1.png]]
*The full SysCAD tags in blue are required as part of the report set up. Please use [[Copy_and_Paste#Copying_Tags|Copy Full Tags]] when copying the variable from SysCAD.
*The results are always placed in the column directly adjacent to the SysCAD tags.
*If there are more than one report on the same MS Excel worksheet, please make sure the search length is not too large so that it overlaps with a different report.
*An example of a full TagList report is included with the SysCAD install, see [[Example SysCAD Excel Reports]]

== Multiple Reports from a Single Row or Column (OffSet) ==

:This report format is most useful for users wanting to compare key results in a summary table for multiple scenarios or runs under various conditions. To do this:
:# First set up a report using [[#SysCAD Report in a Single Row or Column|SysCAD_TagList]] in a single row or column. (See column C.)
:# Then use the key word '''SysCAD_TagListOffSet(cell reference, ''Report Name'')''' to point to the reference SysCAD_TagList Report created in the previous step.
:#*columns E, and F are examples of offset reports. The reference report Case1 we have set up is located in Cell '''C4''' (keyword location), so we will enter '''SysCAD_TagListOffSet(C4, ''Case2'')''' for case2.
:#As before, writing in blue forms the SysCAD report,
:#* Both column C and row 4 can be hidden when presenting the report for neatness.
:# Different [[Excel_Get_Tag_Reports#Report_Name|Report Name]] '''must''' be used for each new offset report. In our example, we have used Case2 and Case 3 as report names (highlighted in the picture below).
:#:[[Image:report_offset.png]] (This is an extract from the Digestion.xlsm report, located in the \Examples\Alumina\Digestion Example.spf\Reports folder.)
:#To populate the reports, after each case/scenario solve, specify the [[Excel_Get_Tag_Reports#Report_Name|Report Name]] to be generated, and only generate that report. That is, DO NOT leave '*' as the report name, as this will populate all the reports, and not the desired case report for the scenario.
:#:[[Image:report_offset2.png]]
:#Alternatively, once the reports are set up, the user may use a command script (see section on [[Command Scripts]]) or the automation macro interface (see section on [[COM Automation]]) to automate the process of running and reporting on multiple cases.

== SysCAD report in Multi Column Blocks ==

This is an extension to the [[#SysCAD Report in a Table|SysCAD TagTable Report]].

The syntax used is '''SysCAD_TagTable(Report Name, (Primary) Tag Direction (H or V), Horizontal search length, Vertical search length, Primary Tag block Size)'''.

These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
*In the example below, the Horizontal search length is 5, the Primary Tag block size is 3, this means that there are five Primary Tags, and they will be located 3 columns apart (cells F1, G1 and then I1 and J1 (and so on) are ignored).

'''SysCAD_TagTable("MultiCol",H,5,30,{{Background color|yellow|3}})'''

[[Image:Excel Report 3.png]]

NOTES:
#In the above example, the writing in blue and Shaded Cells are user-defined information.
# Columns B,C and D can be hidden when presenting the report for neatness.
# Blank cells are allowed in this report type.

== SysCAD report in Multi Row Blocks ==

This is an extension to the [[#SysCAD Report in a Table|SysCAD TagTable Report]].

The syntax used is '''SysCAD_TagTable(Report Name, (Primary) Tag Direction (H or V), Horizontal search length, Vertical search length, Primary Tag block Size)'''.

These parameters are explained in [[#Report Keyword Syntax|Report Keyword Syntax]].
* In the example below, the Vertical search length is 3, the Primary Tag block size is 5, this means that there are three Primary Tags, and they will be located 5 rows apart.

'''SysCAD_TagTable("MultiRow",V,6,3,{{Background color|yellow|5}})'''

[[Image:reportmultirow.png]]

NOTES:
#In the above example, the writing in blue and Shaded Cells are user-defined information.
# Rows 1 to 5 can be hidden when presenting the report for neatness.
# Blank cells are allowed in this report type.

Build 139 Revision History

2025-12-18T03:12:06Z

Keith.Armstrong: /* SysCAD 9.3 Build 139 Revision History */

[[Category:SysCAD Versions and Builds]]
{{Navigation|[[User Guide]]|[[SysCAD Version History]]}}

'''Related Links:''' [[What's New]], [[Product Blog]], [[SysCAD Installation Instructions|Installation Instructions]], [[Upgrading Builds]], [[Upgrading Projects]], [[Software Licenses Expiry Dates]]
----
__NOTOC__
This page contains details of all revisions since the initial release of [[Build 139 Release Notes|SysCAD 9.3 Build 139]].

'''NOTE:''' New builds can be downloaded from [https://www.syscad.net/login/ the SysCAD website]. It is recommended that a full install, rather than an update, is performed from time to time to ensure that the latest supporting files, utilities and examples are included.

==SysCAD 9.3 Build 139 Revision History==

===Build 37066===
:''Released 19 November 2025
* Bug fixes:
** Fixed crash when [[PGM]] code references a tag in a Tear.
** Fixed an edge-case load-time crash caused by projects saved with a window arrangement that included an excessively large, invalid [[Project Window]] width.
** Fixed a crash in the [[Trend Window]] when pasting, caused by comment handling.
** Fixed errors and crashes in [[Archive Reporter]] when using SQLite with table names containing parentheses "(" or ")".
* General Improvements:
** Added new [[Conversion List Table|conversion]] families for mass/mole/volume ratios: "MMolRatio", "MVolRatio", "MolMRatio", "MolVolRatio", "VolMRatio" and "VolMolRatio".
** Minor display improvements in [[Project Window]].
* PGM Improvements:
** Fixed issue where [[PGM]] files were not auto-reloaded when SysCAD was reactivated after external edits and saves. Users no longer need to manually press the ‘Reload PGM’ button after making changes.
** Updated display for tags with [[Declaring_Variables#Declaring_variables_with_ranges|Min or Max-only ranges]] to show >= or <= instead of > or <.
* Model-Specific Updates:
** [[Filter Press]]: Added CompConcWashEff tag alongside CompWashEff and improved feedback on calculation used.
** [[FlashTank2]] and [[Evaporator]]: Corrected setting of Vent outlet stream SpModel when VapStandardSpModel is off.
** [[PID Controller]] using PID4: Grouped FeedFwd tag and variables in Access window; FeedFwd value now clears when tag is cleared.
* [[TCE]] Improvements:
** Fixed graphics status colour for TCE Feeder (shows green when acting as a source).
** Corrected save/recover of MaxSI species for product streams.
**Improved error handling when TCE Engine DLL fails to load (e.g. license expired):
***Fixed display errors in models with TCE Bypass.
***Resolved crash during subsequent project save-as.
**[[PHREEQC]] Updates
*** Upgraded [[PHREEQC]] version in SysCAD from 3.7.3 to 3.8.8.
*** Fixed loading issues for some PHREEQC databases (e.g. sit.dat).
*** Added validation: reactions must have a log K value before user changes are allowed.
**[[OLI]] Updates
*** Added warnings/errors when loading databases with mismatched DBS version numbers.
*** Blocked OLI load if engine version is older than database version.
* Example Projects:
** The Demo Lithium Carbonate CRM Project has been renamed to [[Example_30_Lithium#Demo_Lithium_Carbonate_CO2_Bicarbonation_Project|Demo Lithium Carbonate CO2 Bicarbonation Project]]. This project also includes various general updates.
** Extended expiry date for [[Example_-_07_ChemApp_Projects#Nickel_Laterite_Smelter|Nickel Laterite Smelter]] ChemApp example project database (.CST) until Jan 2027 for all user IDs.
** Many other example projects have been updated with minor improvements.

===Build 37057===
:''Released 16 September 2025
* Fix a crash opening [[TagList Window]] that was minimised.
* Fix for graphics [[Animation_Commands#Annotation_Table|Annotation Tables]] not being updated when solver stops when the graphics windows were minimised.
* Fix for [[PHREEQC Side Calc]] incorrectly calculating output enthalpy and reverse mapping, which can cause unneccessary error messages.
* [[Command Scripts]] improvements:
** Fixed bug in script command StopSolve.
** Added script command WaitTime as alternate to existing Wait command.
** New script commands SolveUntilCount(steps/iterations) and SolveUntilTime(seconds). These are more convenient than sequence of 3 commands: StartSolve, WaitCount/WaitTime, StopSolve.
** New script command ReportConditions(filename) which can be used to retrieve the contents of the Conditions tab page of messages window to a text file (CSV format). Ideal for use after ProBal solve.
* Implemented new [[CommandLine|Command Line]] option to override number of flowsheet solver threads usually controlled by tag $Solver.SolverThreadsRequired. New option is --solverthreads N, where N is the required number of solver threads, when N = 1 single threaded solver is used.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.9 version 2.0.9].
* Added new [[Conversions]] family "Force" with SI unit "N" as future replacement for existing "F" family with incorrect SI unit "kN".
* Improved functionality in mixing streams when [[Size Distribution (PSD)]] is missing from one stream. The PSD for the stream with solids without PSD will have the same PSD as the stream with PSD defined.
* Fixes for [[Pipe - Dynamic Mode]] capacity control for (a) pipes from layered tank; and (b) pipes with batch control where batch is by volume and flow capacity is by mass.
* Improve [[Tie]] in dynamic transfer push without SplitFlows to use capacity control of outlet pipes to control flow splits.
* Expanded PGM load time feedback for use of [[PGM]] syntax and variables that will be discontinued in future. Added display on Access window for [[General Controller]] if any legacy syntax is used that will prevent PGM file load in next Build.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[PGM]] syntax and variables that will be discontinued in the next Build.
* General User Interface Improvements:
** In [[Access Window]] improved display for long drop list to prevent scroll bar hiding the associated drop list number.
** Improved [[Access Window]] flyby window when mouse hovers over a drop list to show both the string and the value of the current selection.
** Improved behaviour and Message window messages when a tag added to the [[TagList Window]] or [[Trend Window]] has (a) incorrect conversion units (it is changed to display default); (b) conversion units not specified (it assumes display default); (c) conversion units specified but tag doesn't have any (removes the conversion).
** For [[Model Selection]] when editing a CFG file, the list of models that are now forced on are now Standard SpModel, Pipe, and unit models FeederSink, Tie-1, MakeupSource and DiscardSink.
** Minor updates to About dialog.
* Model User Interface Improvements:
** On [[Common Data Sections|Info]] tab page for Steady State projects, added new reporting tag FlashTrain.InUse which can be useful for reporting all models used in a [[Flash Train]] using TagSelect.
** For unit models that are part of a [[Flash Train]] show the actual equipment names in FlashTrainEqp droplist.
** On [[Plant Model - System]] tab page, added report tag "ApplicationTitle" which would show the text specified using [[CommandLine]] option --title.
** Improve [[Reaction Block (RB)]] load error message when Sources/Sinks are not allowed and are removed.
** Added new condition warnings for [[Evaporation Block (Evap)]] when user is targeting evaporation flowrate and it is not achieved.
** For TCE Solvent Extraction unit, added user option to display aqueous and organic product streams.
* Example Projects:
** Added new example project: [[Example_-_03UnitModels_Projects_2#Evaporator_Fixed_Pressure_Example|Evaporator Fixed Pressure Example]].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use a new method for the Dense Medium Separator.
** Updated the [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Dynamic Flotation Example]] to use the [[Piping System Model]] for simulating orifice plates and valves.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to include [[Desuperheater|desuperheaters]].
** Updated the [[Example_-_07_ChemApp_Projects#Combustion_Example|Combustion Example]] to allow easier comparison of the three simulation circuits using different unit models.
** Updated the [[Dynamic Centrifuge Example Project]] to run without requiring Sugar species model add-on and license option.

===Build 37044===
:''Released 25 June 2025
* Resolved false energy balance error warnings in the dynamic [[Heap Leach]] model. These occurred when a layer emptied but its reaction block (RB) results were not cleared, leading to incorrect error messages.
* For the [[Compressor]] acting as an expander, increase the allowed pressure ratio (and temperature change) before applying a limit.
* Updated example projects:
** Added a version of the [[Sugar_Example_Projects#Sugar_Falling_Film_Evaporation_Example|Sugar Evaporator project]] that can be opened without requiring the Sugar Species model.

===Build 37043===
:''Released 20 June 2025
* Fixes for bugs introduced in previous Builds:
** Build 37030: Fix crash for TCE SideCalc when stream tags not specified or not valid.
** Build 37009: Fix in dynamic for [[Feeder]] using Const Pressure mode with outlet pipe capacity control, it was not setting the flow rate correctly.
** Build 37009: Fix in dynamic for [[Multi-Storage]] with capacity control in outlet pipes that was ignored.
* Include support for Linux style [[Command_Line_Options#Command_Line_Options|Command Line Options]] as an alternative to the original format.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.8 version 2.0.8].
* Feeder [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] and Stream Fetch improvements:
** Resolved an issue where Stream Fetch could initially use incorrect "flow required" values when the tag was changed, cleared, or when the FetchFlow option was modified.
** Updated behavior for invalid tags:
*** The "flow required" value is now set to zero instead of retaining the previous value.
*** The Feeder "flow required" tag is now treated as a result field (set to 0 when invalid), rather than an input field.
** Improved condition error reporting.
* Changed default for [[Tank]] OperatingP to be AutoDetect when project is ProBal, for Dynamic default is Atmospheric.
* The Reset Action now clears the previous results for [[Evap]] and [[EHX]] sub-models.
* Various miscellaneous improvements including minor user interface improvements in various Access windows and dialog boxes.
* Fix for [[GFEM]] ActivityParameter still being used when WithActivityCoeff is switched off.
* Fix bug in the [[Solvent Extraction Unit]] when using Density Separation Method and PreMixEntrained, where the behaviour incorrectly depended on previous settings for the IndPhase method. (PreMix was mistakenly using the last-used IndPhase settings.)
* Fix for [[Tank_-_Dynamic_Mode|dynamic tank]] OperatingP not using the correct pressure for LowestFeed, HighestFeed, and AutoDetect options.
* TCE:
** Improved ion mapping to correctly handle mixed redox species (e.g. Fe₃O₄ + 4 H₂O → 2 Fe+3 + Fe+2 + 8 OH-).
** Improved handling of different [[AQSol]] versions for solve from previous solution. Reset Action now clears previous results.
** Fixed errors for AQSol SideCalc when calculating energy balance when vapours are present.
** For [[ChemApp]] improved logic for solving for target temperature by bounding solution temperature range.
** Various user interface improvements:
*** Improved Copy & Paste functionality. When a TCE Model Configuration unit (TMC) is copied and pasted, the database base settings and species mapping information are excluded, allowing the new TMC unit to be configured with a different TCE database.
*** Improved the display of InUse status in ModelCfg and added the InUse tag to the individual TCE unit models.
*** For [[PHREEQC]] feeder remove display of TCE Energy Balance and feed Enthalpy which are not applicable.
*** Block reverse mapping to SysCAD ionic species.
*** Enhanced error message reporting for better clarity and troubleshooting.
* Third Party software updates (available in the SysCAD139\Setup folder):
** [[AQSol Overview|AQSol]]: AQSol001.dll has a new update. (Also available from [https://www.phasediagram.dk https://www.phasediagram.dk]).
** [[Using VS Code|VS Code]]: The SysCAD PGM extension has been updated to version 1.0.2. This version is required for users installing the VS Code extension for the first time.
* Updated example projects:
** Updated the [[Example_-_03UnitModels_Projects_1#Calcine_&_Fuel_Project| Calciner & Fuel Example Project]] with energy recovery improvements.
** Modified the [[Example_-_03UnitModels_Projects_2#Mechanical_Vapour_Recompression_MVR_Example|Mechanical Vapour Recompression MVR Example]] to support one or two stages of evaporators.
** Updated the [[Example_-_05_PHREEQC_Projects#Simple_Reactor_Example|PHREEQC]] / [[Example_-_08_AQSol_Projects#Simple_Reactor_Example|AQSol]] / [[Example_-_06_OLI_Projects#Simple_Reactor_Example|OLI]] Simple Reactor projects.
** The AQSol Light Example Projects require the updated AQSOL001.dll. Available at [https://www.phasediagram.dk https://www.phasediagram.dk].
** Updated the [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] to use the new spiral model.
** Updated the [[Example_-_05_PHREEQC_Projects#REE_SX_Example|PHREEQC REE SX]] example project.

===Build 37030===
:''Released 30 April 2025
*'''NOTE:''' The full SysCAD installer has been updated to correctly install the latest "Microsoft Visual C++ Redistributable" files. This resolves errors where this was not installed by installer for Builds 37009, 37014, and 37016.
* Improved convergence tolerance method and testing for internal solver for all [[Reaction Block - Extents]] types except FractionReacted and AmountReacted. These use RB.Extent.Tol.Rel and RB.Extent.Tol.Abs when target is zero. This should result in less internal RB iterations (faster). It also solves an edge case where internal solver fails to solve and ends at a MaxIterations. '''Note''': This may affect results for reactions with slightly less accurate results in terms of displayed extent but tolerance is met in terms of moles reacted.
* Added new PGM [[Species Database Class|SDB Class]] functions SpmlHfMf, SpmsHfMf, and SpDensityMf. They have one extra parameter compared to SpmlHf / SpmsHf / SpDensity for solute mass fraction which is ranged between 0 and 1.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.7 version 2.0.7].
* Added new display tags for Molar Density in [[Material Flow Section]] shown in streams and [[Material Content Section]] shown in container contents.
* Reorganised [[Plant Model - Views]] tab page providing clarity where some user display settings are saved. Added some additional display settings tags. Improved logic for when these are saved.
* For [[Feeder]] and [[Makeup Source]] with Composition Fetch or Link to MakeupSrc improved logic for testing connected tags and corrected display of associated Condition Error messages.
* Removed edge case false error condition for [[Simple Heater]] Duty not met.
* Fixed some calculation errors of estimated flow for some combinations of setting for pipe segments for dynamic [[Piping System Model]].
* Improvements to [[Graphics_Window#Associated_Graphics|Associated Graphics]] Dialog for managing display of associated graphics for DirectLinks (Makeups, Discards, Spills, etc).
* Fix display in [[Reaction Block Summary]] table for RHX HsGain (now shows value instead of *).
* Fix [[Class_-_Using_a_Class#ClassGrid|PGM Class Grid]] display for column width that is too wide for row tags.
* Fix for [[Hydrocyclone]] result tags UF/OF Passing and Passes.
* Fix for incorrect units for Heat of Dilution output for [[Species Properties Reports]] when mass basis is selected.
* Improved logic when mixing streams for selection of [[Material_Flow_Section_-_Density_Correction,_Solubility_and_Saturation#Saturation_Values|Saturation.Component]] in resulting mixed stream.
* Fix errors for [[Copy and Paste Graphics Commands]]: Fix crash in dynamic for copy if disconnected pipe. Fix data copy errors with PSD_Defn used and with user partition curve in Solids Recovery, Screen, etc.
* Fix crash when copying (very) large amounts of data in [[Access Window]] to clipboard.
* Fix crash in [[Explorer Window]] caused by a failed attempt to rename a graphics (or trend or similar) page to a page name that already exists.
* Fix for edge case crash in multithreading while solving, model has inactive flowsheets, and certain user actions in Access window.
* TCE:
** Speedup improvement for some use cases to use previous calculation results as an estimate. Improved logic applicable to some TCE engines to solve from initial conditions based on a previous solution. Can speedup solve time for call to TCE and hence project solve times.
** Significantly improved the flexibility and user interface related to use of the [[TCE_Species_Mapping#Calculate_Enthalpy_Balance|CalcEnthalpyBalance]] option (previously called CalcEnthalpy) for the different OpModes for the different TCE Unit models. For some combination of unit models and/or settings this is forced on and for others this is selectable. In some use cases, it may not be necessary to call TCE for each incoming stream for the purposes of retrieving feed enthalpies to then display TCE enthalpy balance across the unit. Switching this off, when not needed, can provide a speedup in project solve time due to reduced calls to TCE Engine calculations.
** Fix edge case error during project initialisation where building of all possible breakdown reactions got stuck in an infinite loop causing SysCAD to hang.
** New ''UseLastResultOnFail'' option in most TCE units for use in ProBal projects to optionally allow use of last iteration results when TCE fails (rather than setting QProd=QFeed). Intent is possible flowsheet solver stability when occasional TCE failures.
** TCE Feeder now calculates TCE conditions and outlet stream every iteration which fixes the error where it was not recalculated after certain changes in feed options (e.g. change to zero flow).
** Various UI improvements for clarity and consistency across the different TCE's.
** Improved TCE usage statistics reporting.
** [[PHREEQC]]: Updated to version 3.8.7.
** PHREEQC: Updated database load to support newer and older databases (i.e. support of new PHREEQC database keywords).
** [[ChemApp]]: Fixed error with species suppression.
** ChemApp: For CFE (inert) constrained fraction should be zero if CFE is off regardless of inputted value.
** ChemApp: Added additional information displays in [[ChemApp Model Configuration]] for selected CST database file loaded.
** [[OLI]]: Some improved error reporting when calls to OLI calculations fail (including convergence failures).
** OLI: Added additional information displays in [[OLI Model Configuration]] for selected DBS file loaded.
* Example projects:
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Flotation_Example|Met Dynamics Dynamic Flotation Example]] showcasing dynamic mode use of [https://help.syscad.net/Met_Dynamics_-_Flotation Flotation] in a Rougher-Scavenger Flotation Process circuit.
** Updated [[Nickel Copper Project]] - improved some PGM files on the 99 Summary page.
** Various updates to [[Example - 08 AQSol Projects|AQSol]] and [[Example - 05 PHREEQC Projects|PHREEQC]] example projects.
** Updated [[Example - 06 OLI Projects|OLI example projects]] to use OLI databases created with OLI Chemistry Wizard 12.0. These projects require OLI Engine Runtime (32-bit) 12.0.0 or newer to open.

===Build 37016===
:''Released 25 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug and will be corrected in the next release.
* Fixes for bugs introduced in previous Builds:
** Build 37014: Fixed incorrect calculation for generating PHREEQC water adjustment warning messages based on reporting relative tolerance.
** Build 37009: Fix crash in dynamic caused by an edge case tight recycle (with no flow).
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.6 version 2.0.6].
* In a [[Feeder]], when using FlowBasis phase and the mass fraction of species for specified phase is zero, set outlet flow to zero and give a warning condition message.
* Fix for TCE Feeder to recalculate after a Reset or after any change in settings, including calculation type.
Example Project:
* Minor update for [[Example_-_09_Met_Dynamics_Projects#Crushing, Grinding and Flotation Example | Met Dynamics - Crushing, Grinding and Flotation Example]].

===Build 37014===
:''Released 12 February 2025
*'''WARNING:''' Starting from Build 37009, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Remove false condition warning "Tube outlet T limited to Shell T" that occurs under certain conditions for [[Shell and Tube Heat Exchanger 2]] operating in stand alone condensing mode.
* Fix for [[Evaporator]], [[Potash Evaporator]], and TCE Evaporator when in stand alone mode when pressure method is RequiredT. The incorrect pressure was used for the outlet streams. CAUTION: This fix may affect results.
* Improved robustness for [[Evaporator]], [[Potash Evaporator]] and TCE Evaporator for handling the edge case where a very large Duty from embedded heater is applied. Excess duty is not applied and discarded as a loss. Added associated warnings and new result tags for user feedback.
* Display improvement for dynamic reactions in tanks (CRB) in [[Reaction_Block_(RB)#RS_-_Summary_Table_Information|Reactions Summary (RS) table]] to include FracForStep tag in extent Required column for Extent Control types Dynamic Rate and Dynamic Fraction.
* TCE:
** Fixed edge case reverse mapping bug, where a large ion was breaking down to a small ion and then sometimes incorrectly breaking down to an even smaller ion leading to incorrect SysCAD outlet stream compositions.
** Improved efficiency of TCE SideCalc when a method is selected that is iterative. In subsequent SysCAD solver iterations, if the Side Calc is configured to solve each iteration, then the previous result is used as an initial estimate that can result in a significant reduction in number of calls made to TCE.
** PHREEQC improvement for user feedback when small water flow adjustments are made for charge balance. For example this occurs when calculation is targeting a pH.
* Overall improved reporting of TCE usage statistics:
** Added new Stats section on bottom of Results page for all TCE unit models reporting number of calls to TCE DLL, time taken, etc. for each iteration and overall for the project solve.
** Updated calculation of and reporting of WaitTime (where a flowsheet solver thread is waiting to get access to an available TCE Engine).
** Expanded and updated display for overall TCE Engine statistics, as shown on the Engines tab page for the TCE ModelCfg.
** Expanded displays for statistics on the UsedBy page for the TCE ModelCfg to include a repeat of some of the TCE Calc stats for each TCE unit model.
* Example projects:
** New [[Example_-_09_Met_Dynamics_Projects#Gravity,_Dense_Medium_and_Magnetic_Separation_Example|Met Dynamics Gravity, Dense Medium and Magnetic Separation Example project]] showcasing the [[Met Dynamics]] add-on.

===Build 37009===
:''Released 15 January 2025
*'''WARNING:''' Starting from this build, SysCAD requires the latest version of the "Microsoft Visual C++ Redistributable" files to function correctly. If these files are not updated on your computer, SysCAD will fail to start. To update these files, you can:
*#If you have only updated the bin files: Please update your computer to use the latest "Microsoft Visual C++ Redistributable" version by installing the file from Microsoft: [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist vc_redist.x86.exe].
*#Alternatively: Perform a full installation of the latest SysCAD build, then manually update the "Microsoft Visual C++ Redistributable" files by running the file located at: \SysCAD139\Setup\MS VC Redist\vc_redist.x86.exe.
**Note: This is a known bug.
* Fix in [[Reaction Block (RB)]] for an edge case mass balance issue when there is a Recycle species used without a Source.
* Fix for PSD Default Species not changing correctly when using Custom species display order in [[Project Configuration (cfg File)]].
* Fix for [[Flotation Cell]] Size Recovery Mass Balance bug that can occur if no mass flow for the default PSD species.
* Corrected the hardwired data for Laliberte_Rho and Laliberte_Visc for species H2SO4(aq).
** '''WARNING:''' If a project was using this hardwired data, then results will change.
* Fix for specifying StatTag1 and StatTag2 in [[Bivariate Statistics]] and other minor improvements.
* Dynamic solver fixes:
** Fix edge case where solver does not stop at completion of a [[Solver Setting - Scenario|dynamic scenario]].
** Fix for edge case for Dynamic Pull mode where the required volume flow was not met.
** Fix for edge case issue where a mass balance error occurs when switching Push mode pipe capacity between 0.0 and some user value.
* For graphics, fixed an issue where SysCAD would lock up when 'Graphics Cut' was pasted with the 'Bulk Tag Change' option selected.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.5 version version 2.0.5].
* New option for [[Hot Flash Tie]] when model is Off to allow user to BypassAll when all connections are present (HotFeed to Product and WetFeed to Vent).
* For [[Direct Contact Heater 2]] added new result tags Product.MaxTRise and Product.TRise. Moved location of option CondenseExcessSteam.
* [[Ion Exchange]] updates:
** Updated and reorganised Access window.
** New result tags.
** Liquor feed and Liquor1Out product are now required connections.
** Updated Offline flow destinations.
** Added new Solids Loss method.
** Added new BedVolume (BV) method.
** Added ShowQ options for outlet streams.
* [[Access Window]] updates:
** Improvements for data copied to clipboard, including a fix for copy of a column on SpPage when Hide.Zeros is on.
** [[Access_Window#Selection_Buttons|Cancel]] button now changes between Cancel/Close as needed (based on if there are outstanding user changes). Cancel does not close the window.
** Improve response to button clicks very close to the right of checkboxes.
** Save and Recover user selection for Field Indicators option in [[General Options Access]].
** Various other minor improvements in displays, options and functionality.
* TCE:
** Fix for edge case in calculation of elemental composition of TCE species, which failed when name includes a dot (.) such as CuO.CuSO4.
** Fix for edge case ion mapping/breakdown issue (e.g., Cl2(aq)).
** Removed the TCE Input stream result tag for volume flow (which was often incorrect).
** Minor TCE Plotter functionality and messaging improvements.
**TCE DirectCalc Model changes
**#Improved the Direct Calc unit Access Window display.
**#Added a new tab "TCE" where ChemModel, Model, and OpMode are selected.
**#Temperature, pressure, and mass/mole selection are now available only on the DInput tab.
** TCE SideCalc Model changes
**#Reworked user settings for reverse mapping in SideCalc to calculate a product SysCAD stream.

**#For PHREEQC SideCalc, the "CalcEnthalpy" checkbox has been removed.
**ChemApp Model Changes
**#The OpMode option "Enthalpy" and the "CalcEnthalpy" checkbox have been removed.

===Build 36522===
:''Released 25 October 2024
* Fixes for bugs introduced in previous Builds:
** Build 36389: Insert mode for the Access window is off by default. Restored to original behaviour.
** Build 36389: Fix for the ''Copy Tag to PGM'' function in context menu.
** Build 36389: Fix for various ''Copy and Paste'' issues within Access Window and with TagList or Trend windows.
* [[Access Window]] updates:
** Removed [[Access_Window#Options_Button|Access Window]] "Auto Save" option. Outstanding changes (blue text with blue dot) are now always auto-saved when navigating between Access Windows, or executing another command (e.g. Run Project, Save Project).
** Removed [[General Options Access|Access Window Option]] "Compact Tab Names (for Streams, etc.)".
** For [[Access_Window#Right_click_on_Access_Window_variables|Copy Displayed]] the full floating point number is not copied, instead the displayed rounded number is copied to clipboard.
** Removed [[Access_Window#Right_click_on_Access_Window_variables|right-click option]] for Paste Special.
* Fix for graphics DXF file corruption when Annotation Table includes string (memo) with carriage return.
* Fix for incorrect graphics pan & zoom positioning when bringing up the Access window for a model.

===Build 36389===
:''Released 26 September 2024
* '''WARNING:''' This build contains the following Access window user interface bugs:
# In the Access Window, Insert mode is on by default. Use the Insert or INS key on your keyboard to toggle between Insert and Overwrite modes (see [[Access Window#Data Entry in SysCAD|Data Entry in SysCAD]] for more details). This will be reverted in the next build.
# The ''Copy Tag to PGM'' function generates an extra set of quotation marks and a line break. For example: [""P506.Qo.T (C)""]. Please remove the extra set of quotes and line break manually. The correct syntax for the example should be ["P506.Qo.T (C)"].
# All Copy Tag functions include a line break when pasted. Please remove the extra line break manually if used in PGM files.
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error where Edit RCT or Edit PGM buttons do not change the focus from SysCAD to the text editor resulting in the auto-reload of RCT or PGM not working when switching back to SysCAD (unless user changes focus to another application and back to SysCAD).
** Build 33513: Fix for [[Access Window#Data Entry in SysCAD|Excel Style editing]] in Access window, etc.
** Build 32544: Fix for occasional crash in [[Precipitator3 Dynamic Mode|dynamic Alumina Precipitation tank]] using PSD when multiple iterations are required in a time step.
* Implement corrected Bayer3 [[Bayer3 Species Model Theory#Dewey Equation2|Dewey BPE]] method. User can select to use original or corrected method. Warnings are given if using the old method, which will be discontinued in future.
* [[Access Window]] improvements:
** Various improvements for editing Memo field in Access window, and fixes for copy and paste including memo fields.
** Fix for bug where changing Format back to Default for a tag wasn't saved.
** Improved display on Sp tab page for species column width with hide/show zeros and short/long species names.
* Fix error in [[Direct Contact Heater 2]] that is changed to Condense All when previous method used a [[Flash Train]] connection. Previously it did not clear the Flash Train connection, resulting in incorrect results and demand feedback.
* Fix for false error condition reporting [[Simple Heater]] Duty not met when the target has been achieved.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.4 version 2.0.4]. Includes new Magnetic Separator unit model.
* Double click on [[Feeder]] or [[Makeup Source]] with Operation "Link to MakeupSrc" now takes user to the associated Makeup Source. Double click on [[DirectLink]] takes user to associated [[Makeup Source]] or [[Discard Sink]].
* Added new [[Conversions]] Families:
** Electric Field strength: ElecField (V/m)
** Electrical Capacitance: ElecCap (F)
** Electrical Conductance: ElecCon (S)
** Electrical Resistance: ElecRes (ohm) which replaces old "Ohms" conversion family
** Electrical Resistivity: Resistivity (ohm.m)
** Magnetic Field Strength: MagField (A/m)
** Magnetic Flux: MagFlux (Wb)
** Magnetic Flux Density: MagFluxDen (Wb/m^2)
** Magnetic Susceptibility (Mass): MagSusM (m^3/kg)
** Magnetic Susceptibility (Molar): MagSusMl (m^3/kmol)
** Mass Flux: QmFlux (kg/s/m^2)
** Volumetric Flux: QvFlux (m^3/s/m^2)
** Energy Flux: EFlux (kJ/m^2)
* TCE:
** Removed incorrect stream property tags "Sf@T" and "Gf@T" which had incorrect results. Replaced with corrected values using conventional tags as mass and mole basis.
** Removed non-equilibrium aqueous feed stream enthalpy calculation options for OLI.
* Example projects:
** New [[TCE_Dynamic_Projects#PHREEQC_Ion_Exchange_Column_Example|Dynamic TCE Ion Exchange Column Example]] showcasing dynamic mode use of [[PHREEQC Overview|PHREEQC]] in a batch process ion exchange column.
** New [[Met_Dynamic_-_Dynamic_Example_Projects#Dynamic_Grinding_Example|Met Dynamics Dynamic Grinding example project]] showcasing dynamic mode using [[Met Dynamics]] add-on.

===Build 36089===
:''Released 22 August 2024
* Fixes for bugs introduced in previous Builds:
** Build 36061: Fix for error in Access window tooltips causing memory leaks and the system to become sluggish over time.
* As part of graphics copy and paste, implemented option in [[Copy_and_Paste_Graphics_Commands#Paste|Paste]] dialog to bring up the [[Change_Tag#Bulk_Tag_Change|Bulk Tag Change]] dialog on completion to allow user to change the tag names of the newly inserted models.

===Build 36061===
:''Released 20 August 2024
* '''WARNING:''' This build contains a bug in Access Window, with Tooltips causing a memory leak and the system to become sluggish over time. A SysCAD restart is required. Recommend updating to the latest build.
* Fixes for bugs introduced in previous Builds:
** Build 34884: Fix for memory leak for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" and "User Calc" extent]] control types.
* Fix for edge case error in [[Thermocompressor]] setting invalid outlet stream under very poor feed stream conditions, which can sometimes cause a crash in subsequent iterations.
* Fix for [[Direct Contact Heater 2]] with RB that did not perform reactions when a vent stream was not connected.
* Fix crash in [[Transmitter]] when MeasTag value is NAN(*). MinValue is used when the measured value is NAN.
* Fix for edge case crash when trying to display Access window for a [[Flash Train]] tear that has been removed (become inactive).
* Implemented more stable behaviour when graphics commands are in progress and other windows are selected. This fixes a crash when busy with a graphics command that has a floating graphics toolbar, then user selects another window (e.g. trend window), then user selects a button on the graphics toolbar.
* Fix for [[Alumina_3_Bayer_Species_Model#Global_Properties_Calculation_Method_Selection|Alumina3 Global Setting]] for ''Density_UseScale'' option. The user specified global ''Density_Factor'' was not correctly applied in all cases for calculated properties and Bayer feed calculator. If this option was used, project results may be affected.
* For [[Alumina_3_Bayer_Species_Model#Bayer_Properties_Data|Alumina3 Bayer Properties]] removed the ''Molality'' result tag. It was calculated incorrectly by a factor of 1000.
* Updated [[Met Dynamics]] add-on to [https://wiki.metdynamics.com.au/view/Revision_History#Met_Dynamics_Models_v2.0.3 version 2.0.3]. '''Note''': This update includes restructured filing so projects saved in Build 139.35544 using v2.0.2 will require input parameters to be checked.
* Implemented tests at project load to check for duplicate named graphics pages if there is a corrupt list of page names in project.spj. Warning messages are given and duplicates are ignored.
* For the [[Boiler]], added new tags HeatLoss and Overall.HeatFlow tags for clearer energy balance reporting. The old confusing HeatFlow tag is hidden, but retained for backward compatibility.
* Added new [[Conversions]] Families:
** Specific Count Length: SpCntL (#/m)
** Specific Count Length Rate: SpCntLRate (#/m/s)
** Specific Count Area: SpCntArea (#/m^2)
* Added right click context menu in [[Conversions#Manage_Conversion_Defaults_and_Display|Manage Conversions Dialog]] to copy to clipboard PGM formatted conversion text for use with declaring variables.
* Added BulkValidation option (same as option in [[General Controller]]) to [[Noise Controller]], [[Slew Rate Controller]], [[Profile]], [[Queue Profile]] and [[Signal Waveform]] which allows bulk setting of tags before validation (fixes issue with setting individual composition fractions one by one).
* Correctly allow use of quote (") in Tag and Description column for [[Trend Window]] and [[TagList Window]].
* Various minor improvements in [[Access Window]] displays.
* In [[RB]] prevent complete hiding of Off reactions when all 3 of a tab are hidden. Off reactions are added to the end of the previous tab instead. R1 tab always shown.
* Reworked solver [[Solver Setting - Changes|Change Monitor]], the Changes tab page for [[Solver Settings|$Solver]], used for troubleshooting difficulties in solving projects.
* For [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]] added test for use of [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB "Sp Calc" Extent Type]] SuperHeat and SubCooling which will be discontinued in the next Build.
* [[TCE]] Improvements:
** '''NEW''': TCE Dynamic Reactor Tank for [[ChemApp Tank]] and [[PHREEQC Tank]]. Simple tank with TCE on contents, with overflow and up to 5 product outlet streams.
** Allow species Na2SO4(aq), Na2SO4(s) and Na2SO4.10H2O(s) with [[PHREEQC]] TCE in unlicensed demo mode. Allows use of new TCE tutorial without a TCE license.
** Various TCE Plotter Parameter Sweep improvements in display and some bug fixes for parameter selections.
** Corrected TCE ChemModel Cfg to report elements used in TCE database (was incorrectly reporting elements used in SysCAD).
** Automatic conversion of OLI Legacy unit models to OLI 2 when selecting OLI2.dll in project configuration to upgrade legacy projects to newer TCE interface. Full upgrade requires additional steps regarding all OLI unit model settings, IonList and species database checks.
* Example projects:
** New [[Example - 09 Met Dynamics Projects#Crushing_and_Grinding_Example|Met Dynamics Crushing and Grinding example project]] showcasing new Met Dynamics add-on.

===Build 35544===
:''Released 31 May 2024
* '''NEW:''' Announcing release of '''Met Dynamics add-on''':
** A mature and significant new library of mineral processing [[Models#Met_Dynamics_Models|unit models from Met Dynamics]] is now available in SysCAD.
** Library includes common and advanced steady state and dynamic unit models with multiple calculation methods for crushers, mills, HPGR, classifiers, DMS, gravity concentrators, hydrocyclones, screens and flotation cells.
** Requires SysCAD Size Distribution and Integrated Libraries add-ons as well as a license from [https://metdynamics.com.au/ Met Dynamics].
** Met Dynamics SysCAD add-on and example projects are included with the full SysCAD install.
* Fix for individual connection Qm reference tag values not always updating in [[Makeup Source]].
* Fix for [[Tank]] with Demand and [[Discard Block (DB)|Discard Block]] incorrectly applying Discard flow (results in mass balance error).
* In dynamic mode for Tank with [[Heat Exchanger (HX)]], fix an error in LMTD method when time step is not equal to 1 second.
* Fix for [[EB]] sub-model that should always be last (e.g. FlashTank.VLE) not being last based on some user selections of evaluation sequence.
* Corrected some conversion values for RatioLQm [[Conversions]] family.
* Improved graphics DXF [[Symbol Management Commands]] for default symbols for models with a '*' in UnitType name.
* PGM Improvements:
** Added functionality to exclude some variables in PGM Class from being displayed in [[Class_-_Using_a_Class#ClassGrid|ClassGrid]]. They are displayed in normal list outside of grid display. Use {eg} or {excludegrid} when declaring variables in class. Also any class variable added using Watch command is excluded from grid display.
**Added the subroutine <syntaxhighlight lang="pgm" inline>SetFromStr(Str s, Str Separ)</syntaxhighlight> to both the [[Array Class]] and [[StrArray Class]]. This allows for the unpacking of a string into an array as real numbers, or into a StrArray as strings. Additionally, incorporate the function <syntaxhighlight lang="pgm" inline>Str CopyToStr(Str Separ)</syntaxhighlight> into both the Array and StrArray classes. This enables the conversion of an Array or StrArray’s contents into a single string.
* [[TCE]] Improvements:
** Fix energy balance bug when bypass in place. May affect PHREEQC results when using fixed enthalpy mode and/or using the heat flow calculated by a PHREEQC unit operation.
** Improved logic for checking use of TCE license requirements based on user settings in TCE Unit Models. Corrected display of AddOnsUsedList on Info tab page for all TCE unit models.
** Various display improvements for Scaling tab page.
** Fix for accuracy for solve for phase boundaries.
** Fix for some tags not working with DataTransfer or Copy and Paste.
* Example projects:
** New [[Example - 05 PHREEQC Projects#REE SX Example|REE SX example project]] developed for the ALTA 2024 conference.
** New [[Example - 09 Met Dynamics Projects#Crushing,_Grinding_and_Flotation_Example|Met Dynamics Crushing, Grinding and Flotation example project]] showcasing new Met Dynamics add-on.

===Build 35250===
:''Released 23 April 2024
* Fix for edge case incorrect reaction Final extent calculation for some [[Reaction Block - Extents]] with a Sink. '''Note:''' this can affect the result for the final extent tag but doesn't change the amount reacted (unless a controller is using the final extent tag as its measured value).
* Fix for [[General Controller]] PGM crash when toggling RuntimeDebug mode on/off.
* Fix for inconsistent calculations in Tank and Tie Demand when using massflow [[Split Flows (Split)]] options.
* Fix for crash for [[Conveyor Belt]] with length of zero when using Weightometers or Loading displays.
* Fix for managing project document list when opening a document (eg graphics page) from external folder from project folder. Fixes document list becoming corrupt with duplicate named flowsheets.
* Fix for occasional crash in [[Solids Recovery Unit]] when changing RecoveryMethod to "Size Recovery".
* Fix for [[Species_Table_-_Specific_Heat_(Cp)#Gibbs_Extended_Equation_format|GibbsEx_Cp]] (and GibbsChemApp_Cp) equation when optional polynomial term (Pi) was incorrectly treated as zero when it's absolute value was small (less than 1e-7).
* Improved tag displays related to setting count of External Heat Exchangers for [[Evaporator]] and [[Potash Evaporator]].
* New [[Reboiler/Condenser Heat Exchanger]] Unit model now available in general release (in HeatExchange.DLL).
* Added ShowQWashings option to [[Filter Press]] and [[Belt Filter]], available when washings outlet is connected.
* Improved display for the crosshairs for 'Find in Graphics' which was nearly invisible.
* For flowsheet Area management, when AllowUnassigned is not selected ([[Plant Model - Flowsheets]] tab page), then create the first Area if none and force any new graphics pages to belong to first Area.
* Added option to include Min, Max and Description in historian [[Trend_Window#Query_Dialog_Box|trend query]] report.
* Added new [[Conversions]] Families:
** Current Density: IdA (A/m^2)
** Electric Charge: Charge (C)
** Electric Flux: ElecFlux (Vm)
** Electric Surface Charge: SurfCharge (C/m^2)
* [[TCE]] Improvements:
** [[OLI]]: Added result display of WaterActivity (=aqueous mole fraction of water * its activity coefficient)
** [[ChemApp]]: Fix a database load failure for some edge case ChemApp CST or DAT files.
** [[AQSol]]: Improved functionality in AQSol when feed stream includes steam or vapours. There may be changes in results in some cases, depending on how the AQSol interface is being used.
** Handle edge case for reverse mapping in iterative solver when a species in a specific phase is not mapped.
*Example projects:
** New [[Example_-_03UnitModels_Projects_2#Reboiler_Condenser_Heat_Exchanger_Example|Reboiler/Condenser Heat Exchanger Example]] project introducing the use of the [[Reboiler/Condenser Heat Exchanger]] Unit model.
** New Dynamic Sugar Centrifuge Example demonstrating [[Sugar Species Model|Sugar Add-On Species Properties Model]] in Dynamic solver.

===Build 35102===
:''Released 19 March 2024
* Fixes for bugs introduced in previous Builds:
** Build 34985: Important usability fix for building flowsheets where dropdown list of available unit models is not updated. This affected three areas of functionality (a) ConnectTo tag in Feeder used for connecting cross page connectors, (b) MakeupSrc tag in Makeup Block for selecting Makeup Source, (c) DiscardSnk tag in Discard Block for selecting Discard Sink.
** Build 34985: Fix for graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] when the selected scale is not 100% (the preview was incorrectly scaled and drawn over the contents of the dialog box).
* Fix for saving, loading and use of global user display setting for Symbolic Paths in [[Project Window]].
* Project load now fails with error message when selecting a model DLL with required species and the species are not selected for use in the project in the [[Species Configuration|configuration file]].
* Fix for a crash when loading a project after removing (or renaming) a species from the configuration that is referenced in a [[Makeup Block (MU)]] or [[Discard Block (DB)]].
* For [[Set Tag Controller]] for specific case of using (a) MatchCnvFromTag, (b) Tag conversion family is "Temperature", (c) Calculation is "Ratio and Offset"; the Offset tag conversion is now "Temperature Change" (dT).
* Fix for enthalpy change values used for phase change when adding H2O(s) (ice) using same H2O component as hardwired H2O(l) and H2O(g).
* Minor [[Access Window]] display improvements. Remove incorrect trace marks left behind when changing selection of text. Added missing faint horizontal row guidelines between tags and data values for grid displays.
* [[TCE]] Improvements:
** If TCE equilibrium solve fails, retain previous property results rather than clear the results. This helps with smoother control actions (e.g. PID) for occasional failed equilibrium calculations.
** For forward mapping, unmapped species (shown in QUnmapped, QRxnUnmapped) were not set to the correct temperature for this bypass, resulting in an energy balance error occurring when this bypass is mixed with the results. Other Bypass options functioned correctly.
**:'''NOTE:''' Energy balance results may be different for cases of unmapped reaction species.
** For Scaling results page, fix for tags not working in Excel reports, Trends, etc. with hide zeros.

===Build 34985===
:''Released 6 March 2024
* '''WARNING:''' This build contains a bug with Makeup and Cross-Page Connector dropdown lists not updating. This will affect building/editing models (running existing models is safe). Recommendations:
** Use a Different Build: If you intend to make model changes and wish to use the droplist to select connected tags, we recommend updating to a newer build.
** Reopen Project Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), to force the dropdown list update, save, close, and re-open the project.
** Manual Entry Workaround: After the new unit operations have been added (Feeder/Sink, Makeup Source, Discard Block), manually type or paste in the name of the connector or makeup source tag. Manual entry will function correctly.
* Fixes for bugs introduced in previous Builds:
** Build 34893: Fix for changing tag size or rotation in graphics from [[Edit_Graphics_Commands#Tag_Position.2C_Show_or_Hide|Update Tag Annotation]] dialog.
* Improved graphics symbol preview for [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] and [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]].
* [[TCE]] Improvements:
** For OLI, PHREEQC and AQSol add new optional Scaling tab page to display SatIndex result values for solids (Scaling tendencies). For OLI, display extra tab page (if needed) of solids that have been excluded in OLI database file.
** Implemented new [[OLI Solvent Extraction]] unit model.
** Implemented support for [[OLI_Overview#OLI_Liquid-2|OLI Liquid-2]] phase (Liq2) for immiscible liquids (typically organics) used in various OLI reactors and unit models including [[OLI Solvent Extraction]].
** Fix for [[AQSol]] for some DLLs where a calculation fails when a floating point exception occurs.
** Fix for crash when using [[OLI]] with some solid species excluded in the database (DBS) file.

===Build 34893===
:''Released 16 February 2024
* Now support [[AQSol]] Version 3 DLLs with significantly accelerated solve times (especially for AQSol libraries with larger number of species).
* New functionality for graphics for [[Insert_Graphics_Commands#Insert_Text|Insert Text]] and [[Edit_Graphics_Commands#Change_Text|Change Text]] to allow user so select which dxf font is used. These are based in the dxf .shp files located in the [[SysCAD_Files#Base_Files_Folder|Basefiles\Font]] folder. Allows use of various fonts, including fonts with various symbols.
* Updated [[Audit]] tags and tables to include a display of Normalised Relative Error (NormRelError) in addition to the existing error tags. This provides clearer transparency for the Audit mass balance checks using [[Tolerance Testing]] calculations.
* For [[Excel Reports]] Feedback worksheet, reorganised the 2 heading lines over 3 lines with the feedback report date on it's own line.
* Model improvements for dynamic projects:
** Added totaliser display tags in [[Feeder]], [[Makeup Source]] and [[Discard Block (DB)|Discard Block]].
** For [[Simple Heater]] removed option for DemandConnection (only valid for ProBal).
** Fixed bug in [[Tank_-_Dynamic_Mode#Layered_Flow|Layered Tank]] that had a Mass Balance error if the dynamic project required multiple iterations to solve a time step.
** Fixed a crash on solve error when unit models did not have all the required pipes connected.
* Fix for bug in [[Reaction Block (RB)]] individual reaction using a [[Reaction_Block_-_Extents#User_Defined_Properties_(User_Calc)_(RB_and_CRB)|User Calc]] extent control method. The error was that the User Calc, calculated during RB convergence, may be performed using the incorrect temperature and/or composition.
*:'''NOTE:''' This will affect reaction results where User Calc is used for extent control.
**Added example on how to use User Calc reaction as reaction extent: [[Reaction_Block_Summary#Example_-_Using_UserCalc_Reaction_Extent|Using UserCalc Reaction Extent]]
* Fix for incorrect [[Conversions]]: MJ/L for H(V) and some (normally hidden) US units such as cal/lb for H(Ms); Ha/s and Ha/h for ThermDiff and some other cal based US units. May affect results if these units were used in controllers or reporting.
* Fix errors in parsing OrderBy for multiple tags for [[Setting_and_Reporting_Tags_from_text_files#Reporting_Tags_to_text_files|TagSelect Text file reporting]]. Expanded [[Excel_Tag_Select_Reports#Tag_Select_Report_Function_Syntax|TagSelect OrderBy]] terms used in Excel and Text reports to support alternate formats for Asc and Desc (Des, Descend and Ascend).
* Fix error where SysCAD incorrectly exits when pressing the F9 key from the [[Access Window]].
* Fix for crash in [[Copy and Paste Graphics Commands|Graphics Copy and Paste]] when pasting a Tie or Tank with two outlets using a [[Split Flows (Split)|SplitFlow]] operation with a Target Stream.
* Various miscellaneous usability improvements: Some improvements in model condition warnings. Improved Access window displays for various models. Some dialog box display improvements. New popup warning dialog when closing Insert Unit or Insert Symbol with 2 or more objects added.
* [[PGM]] Improvements:
** Fixes for some miscellaneous edge case errors. (Too many display tags in a class; Checking for duplicate classes in ClassGrid; Loading some old project PGM state information.)
** Fix for compile and runtime errors for PGM code referencing nested class within an array of classes. Code such as "x = Tanks[3].SomeClass.SomeFunc()" failed with a crash or wrong result, as did code such as "Tanks[3].SomeClass.abc = x"
** New PGM load error messages if incomplete expressions (i.e. ending in an operator). Examples: "if (a or )" or "x = a + b + "
** Allow PGM/MP files saved in "UTF-8 with BOM" format to load and work.
* [[TCE]] Improvements:
** Added tag to display expiry date of [[ChemApp]] CST files.
** Fix for [[PHREEQC]] edge case where feed enthalpies did not always match those of the feed SysCAD streams due to mapping algorithm issues.
** Fix for TCE Feeder where outlet composition may be cleared.
** Fix in TCE Unit models (stream displays) when referenced TCE model cfg is changed, even if a model is selected that is not yet loaded.
** Updated TCE Utilities for generating initial databases.

===Build 34613===
:''Released 11 January 2024
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for solver startup crash where PGM is setting [[Makeup Block (MU)]] Model during startup.
* [[Flash Train]] tag and error reporting improvements when flashtrain is at maximum limit of allowed pressure. This helps with resolving The maximum allowed flash pressure for each steam source (FlashTank, Evaporator, etc.) is shown in new tag FeedSatP. A new condition warning is given for the flashtrain and any unit models at the flash pressure limit.

===Build 34461===
:''Released 14 December 2023
* Fixes for bugs introduced in previous Builds:
** Build 33632: Fix for various user interface bugs in [[Controls Window]] (e.g. Context menu with incorrect options for selected tag).
* Pipe recycle [[Tear]] improvements:
** Fix bugs in save and recover of overrides of [[Tear#Settings_Tab|tolerance settings]] of individual variables in a Tear Block.
** Improved save and recover of Tear state.
** Fixed bug for use of Tol.Strategy overrides when selecting tolerance value to be used.
** Added Access window display warnings (and red text for values) when overriding a tolerance value that would be ignored based on the Tol.Strategy.
* For [[PID]] in ProBal, added display tag CvgError which is the Normalised Relative Error used for solver convergence criteria. New CvgError tag matches the reported Error in [[Solver Status]] and [[Solver Setting - Convergence|Convergence]] criteria. This new tag is also added to [[Controls]] page.
* Fix for edge case where tag is not selected in [[Model Data Transfer]] dialog when using context menu option "Data Transfer" from Access window tag.
* [[Size Distribution (PSD)]] improvements:
** Expanded [[Plant_Model_-_Qualities#SzDist_(PSD)_Quality_Configuration|PlantModel Qualities]] to include display table of the full sieve series intervals.
** Updated the [[Size_Distribution_(PSD)#Size_Data_Sections_(Sz_Tab)|Sz]] and DSz tab pages to display a description (in mm) of the size interval on RHS of each row in the table.
** Updated displays of size data in unit models such as [[Screen2]], [[Solids Recovery Unit]], etc. to include a a description (in mm) of the size interval on RHS of each row in the table.
* Fix for [[TCE]] save and recover of breakdown reaction extents and phase mapping. Database save errors occurred with multiple saves of a project.
* Fixed bug in reporting of [[TCE]] phase deportment.
*Example projects:
** New [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example_With_Adsorption|Raffinate Water Treatment Example With Adsorption]] project used with paper presented at MetPlant 2023. Project uses [[PHREEQC]] to model a multistage water treatment circuit for waste water streams. It includes multicomponent adsorption to ferrihydrite and alumina.

===Build 34246===
:''Released 15 November 2023
* Fixes for bugs introduced in previous Builds:
** Build 34068: Update for SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of numeric fields when clicking on whitespace on LHS of existing number and entering a new value.
* Fix for display bug for [[Audit]] for PowerIn and PowerOut under the "Streams Audit Summary" heading which did not display in correct column.
* Fix for edge case [[Reaction Block (RB)]] convergence error message when target for reaction extent solver is zero.
* Updated messaging for [[Upgrading_Projects#Upgrade_Compatibility_Check|Upgrade Compatibility Checks]].
* [[TCE]] Improvements:
** Include new dynamic mode [[OLI Pond Model]].
** Fixed error for [[ChemApp]] use for phase electron balance issues.
** Improved [[ChemApp]] log file outputs used for trouble shooting.
** Improved displays for timing and statistics for TCE Engines.
** Fix for issue with copy and paste for operating mode settings.
** Fix for issue with copy and paste of TCE Model Configurations.
** For [[PHREEQC]] use of Surface Adsorption calculations, don't fail the overall calculation when the Adsorption part fails.

===Build 34068===
:''Released 19 October 2023
*Fixes for bugs introduced in previous Builds:
** Build 33873: Fix for use of "like" in [[TagSelect]] statements primarily used in Excel TagSelect reports and PGM TagSelect class. A statement such as "[Tag] like 'P_.*'" fails in Build 33873. The original functionality is restored to what it was before 33645.
* For string input field in Access window, when clicking on RHS of text (more than 2 spaces after last characters) then the entire field is selected and overwritten with newly typed text. This makes SysCAD [[Access_Window#Data_Entry_in_SysCAD|Data Entry Style]] of string fields the same as numeric fields. Excel Data Entry Style is unchanged.
* New option in [[Evaporator]] with external HX outlet connection, or with embedded heat exchanger, to specify the amount of solids to include with HX recycle. Can select this outlet to have liquids only.
* Fixes and improvements in [[Shell and Tube Heat Exchanger 2]] condensing mode to support selection of component other then H2O in VLE block.
* The Comment field entered in [[Reaction Editor]] for each reaction is now shown as a result tag in [[Reaction Block - Individual Reactions]].
* [[TCE]] Improvements:
** Fix for intermittent crash seen in TCE SideCalc.
** For TCE SideCalc QProd no longer valid if ''Model'' is SideCalc. To include reverse mapping after TCE equilibrium calculation to SysCAD stream and optional QProd display select Reactor for ''Model''.
** Fix for TCE Feeder that stopped working after an Empty action.
* [[Reaction Editor]] version 1.5.34041:
** Fix for bug introduced in version 1.5.33315 where selection for HoR conditions droplist was stuck at Custom.
** For newly created reactions - extent now changes live in table and entry correctly has * marker.

===Build 33873===
:''Released 28 September 2023
*Fixes for bugs introduced in previous Builds:
** Build 32582: Fix for PlantModel.Area1.Activate (and Deactivate) tag not working due to incorrect indexing where PlantModel.AreaN.Activate tags being applied to Area(N-1) instead of Area(N). This only applies to use of these tags in PGM, etc. Tags are displayed correctly in [[Plant Model - Flowsheets]] Access window.
** Build 33457: Fix in [[Access Window]] for paste of single value from Clipboard to each field of multiple selected fields.
** Build 32925: Fix for a SysCAD startup error for users of older versions of Windows 10.
** Build 33127: Fix for edge case crash with error message "Some PostConnects not called at EO_Execute" occurring at Solve when drawing flowsheets.
* Update to not include [[Qualities Models]] on [[Plant Model - Qualities]] tab page (and in Feeder select Qualities) if Quality model is NOT selected in the cfg file. This also removes invalid error messages related to incomplete configuration of Qualities settings.
*:'''NOTE:''' For some projects where a Quality (e.g. "Size Distribution") is required, but was not selected in the cfg file, all data and settings related to use of the Quality may be removed at project load. To solve this, first edit the cfg file and ensure the required Quality [[Model Selection|models are selected]] (e.g. "Size Distribution" for SzDist1.dll).
* Fix for occasional incorrect selection of initial VLE BPE.Method when inserting units with [[VLE]] (e.g. [[Flash Tank 2]]). The initial setting was sometimes (seemingly randomly) "None" (or "VantHoff") instead of the default "StreamModel".
*:'''NOTE:''' Projects may have unintended BPE.Method selected for Single Component VLE blocks in FlashTanks and other units where VLE is used to flash. We recommend that users check settings for VLE.BPE.Method in projects. One way to check this is to right click on the tag and select "Open Find Results" menu option (or press F8) to get a [[Find_Units_using_Query#Find_Results_List|list of values]] for this tag in all unit models of the same type.
* Fix for User [[Species Calculations]] using Volume as one of the terms.
*:'''NOTE:''' Any project using a User Species Calculation that includes stream or phase Volume as one of the calculation terms may have had incorrect results. This may affect project results if Species Calculation using volumes is used in model control.
* Fix for memory leak (reduction to available memory in SysCAD application) that occurs when closing a project using [[TCE]].
* Fix in Tank and Tie for incorrect Order for SplitFlows where Operation is [[SplitFlow - General Operation|General]] and Priority "Last" is used together with "Auto".
* [[General Separator]] now correctly handles the edge case where feed solid conditions exactly match target conditions.
* Fix for Find filters "StartsWith" and "Contains" used in [[Quick Find]] and [[Explorer Window]] when searching where tags containing wildcard characters such as ? and *. Find using Contains or StartsWith now correctly searches based on exactly what user has entered.
* Fix for [[Precipitation3]] using SSA method where Seed Solids option did not work correctly when solving from empty.
* Fix for recycle [[Tear]] Streams incorrectly creating [[Qualities Models]] (e.g. PSD) in outlet of pipe with Tear when the Quality should not be used in the project based on user selection and configuration of the quality definition.
* Fix in dynamic for edge case bug where error 'Over specified' warning are generated in a [[Makeup Source]] and there is no makeup flow. Error can occur when first configuring the makeup block and pressing solve.
* Fix for false error message in [[Simple Evaporator]] when applying small Duty that simply heats the stream slightly (does not reach saturation temperature).
* Improved [[Reaction Block (RB)]] test for Starved reaction if reaction is Forward Only or Reverse Only which was previously giving a false reaction not converged error message.
* Updated [[COM Automation]] API behaviour when trying to get/set tags and an empty tag string is provided. Reports error code instead of failing.
* Updates to [[PHREEQC Pond Model|TCE Pond]] for energy balance reporting for heat of mixing.
* For [[VLE]], added new LiquidMassFlow (LQm) result tag. Fix for Reset not clearing all results. Multicomponent VLE now correctly calculates result fields VapFlashed.Qm and LiqFlashed.Frac.
* For TCE [[PHREEQC]] product results, added tag for oxidation reduction potential (ORP).
* Include Upgrade Compatibility Checks at project save.
* [[Reaction Editor]] version 1.5.33781:
** Fix to handle ionic species names ending with one or more + characters (e.g. +++).
* SysCAD [[VS Code]] PGM Extension:
** Released a minor update with expanded list of PGM syntax keywords.

===Build 33632===
:''Released 29 August 2023
*Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for SysCAD startup crash when user folder name for [[VS Code]] selection as PGM Editor was no longer valid, or related VS Code folder for extensions is not found or changed.
** Build 31866: Fix in Access window display where + and - buttons did not expand or collapse groups of tags.
*Added result tags Rho25, LRho25 and SolidConc25 for [[Material_Flow_Section#Properties|Stream Properties]] display.
*New [[Species_Table_-_Specific_Heat_(Cp)#Cp_Equation_Format|Cp (Enthalpy) equation formats]] for Gibbs functions including parameters for Magnetic effects of species. GibbsMag_Cp(...) and GibbsExMag_Cp(...).
*For [[Disk Centrifuge]], added new result tags for Feed Qm, Sf and SolidConc25. Added option for QFeed stream display.
*Fix for [[Disk Centrifuge]] behaviour when feed solids concentration was below 700g/L, hardwired limit is removed. Edge case behaviour improved.
*:'''NOTE:''' This may affect results of projects operating at these "edge" case settings.
*Fix for dynamic tank with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]] and Makeups or Discards where the selected Stream tag was not recovered at project load. Added new StreamTag string tag to allow setting of Level Control outlet stream tag by PGM, etc.
*Fix for edge case crash on solve for [[Set Tag Controller]] when making multiple changes to list of tags to be set that includes removing and then adding back the same tag.
*Updated "Tear not converged" Condition messages shown as solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
*If SysCAD is started with any [[Command Line Options]], these are shown in Message window at startup for information.
*Don't remove project from "Most Recently Used" file list if project load fails.
*Example projects:
** New [[Example_-_GFEM_Projects#Green_Steelmaking_Example|Green Steelmaking]] example project used with paper presented at COM 2023. Project uses GFEM with RK parameters to demonstrate use of Hydrogen for green steelmaking.

===Build 33513===
:''Released 8 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33457: Fix for bug in TCE ion mapping error that can occur for some edge cases.
*Project Window the [[Project_Window#Conversion_List|Conversions]] tab page improvements:
** Shows selected default in bold.
** Added right click context menu with actions to change Default conversion, Show/Hide conversions, Copy conversion to clipboard in PGM format and option to open Manage Conversions Dialog.
*Added "[[Actions_Command_Summary|Step or Idle]] (F10)" command to Actions menu.
*Fix for RB with ShowSpRequirements and/or ShowReactionLimits selected not clearing related results after a Reset action or during solve when the RB is switched off.
*Improved [[Simple Heater]] "FeedCalc" calculation to correctly calculate required flow for a greater range of feed flow conditions.

===Build 33457===
:''Released 2 August 2023
* Fixes for bugs introduced in previous Builds:
** Build 33001: Fix for for incorrect RB results for [[Reaction Block - Other|RB with Src/Recycle/Sink]] that occurs after a full [[Actions_Commands#Reset|Reset]]. The unit models with RB with this condition report a mass balance error due to incorrect Src/Recycle/Sink calculation. Result is corrected on subsequent project load and solve.
* For [[Disk Centrifuge]], added new "CentSolids/SolidAnalysis" option for Method. This allows user to specify target CentrateSolidFracReqd and CakeSolidFracReqd.
* New "FeedCalc" option for [[Simple Heater]] to optionally calculate the required flow to achieve a target temperature. This can optionally be connected to use General Demand.
* Updated [[Reaction Editor]] (from Version 1.5.32836 to 1.5.33315). Includes fix for display of sequence number on high resolution (4K) displays, and improved functionality for selecting HOR override species (especially with reverse reaction option).
* Fix for losing "Create new Tab for User Property Calculations" setting in cfg file for [[User Property Calculations]]. Setting was lost when editing Species Database from open project.
* Fix for custom [[Calculation Configuration|User Calculations]] where a "specialist function" with parameters, such as Density(phase,T,P), was not parsed and calculated correctly when the specialist function is part of a larger full calculation.
* Fix to allow use of [[Split Thermal (SplitT)]] for Tie/Tank when Operation is Phase Recovery, Solids Recovery, Water Recovery or Gas Vent. Both outlet pipes are now shown and configurable on the SplitT tab page.
* Fixed bug where Qualities could not be set in the [[Makeup Source]] when it is first inserted.
* Fix for edge case in [[Simple Heat Exchanger]] using Other.FlowCalc where there was a runaway flow demand. Improved error messages for inoperative conditions/settings for flow demand calc.
* Improved [[Heap Leach|Heap / Column]] model top layer evaporation logic and included user feedback when required evaporation is not met. Added display of evaporation flowrates for each layer and overall. Added display of "Heatflow" associated with water removed due to evaporation (as Heap Layer temperatures remain unchanged with evaporation).
* New [[Print#Print_Multiple_PDF|Printing Graphics flowsheets]] functionality:
** Can now select to print in Colour or Black & White.
** Can now optionally include/exclude animations (Dynamic Bars, etc.).
** The new print settings are available on [[General Options Graphics]] tab page.
* Fix for a new graphics page not using the specified [[Project_Settings#Graphics_and_Tags|Drawing Frame]] when "Frame Extent" was "None". Note that list of available frame symbols has been extended in SysCAD install.
* Fix for "Tear not converged" Condition messages not being shown when solver is paused when $Solver.Convergence.Message.Frequency (found on [[Solver Setting - Convergence]] page) was "StoppedOrPaused".
* For Access window added new "Copy Displayed" Ctrl+Shift+C copy to clipboard command for [[Access_Window#Right_click_on_Access_Window_variables|right click popup menu]]. The purpose is to copy text as displayed in Access window, in particular unlike "Copy" Ctrl+C for listed tags it copies the displayed text rather than the underlying full tag. Values are always copied in full.
* Added Ctrl+Q shortcut key for Close Project.
* Added new solver "Step or Idle" action command associated with F10 shortcut key. It is a single convenient button for solver stepping regardless of solver state. Three possible solver state actions:
** (a) solver Step if Paused/Idle. Same as Actions|Step command. Use Shift+F10 shortcut to apply multiple steps.
** (b) go to Paused/Idle if Stopped. Same as Actions|Idle command.
** (c) go to Paused/Idle if Solving. Same as Actions|Idle command.
* Rearranged and extended the [[Windows#Application_Window_Background_Pop-up_Options|context popup menu for right click on the background]]. This provides an ideal shortcut to access common commands rather then navigating through menus. Three possible menus are given: (a) when no project loaded; (b) when solver is stopped; (c) when solver is busy or paused.
* Renamed [[Conversions]] menu options "Defaults and Display" to "Manage Conversions", and "Conversions Database" to "User Database".
* Changed the default display conversion units for Cp(Ms), Cp(Ml), S(Ms), S(Ml), HCap, HCapF, DPperQm and DPperVol. Updated some [[Conversion List Table|Conversion Family]] full descriptive names for clarity and consistency. Added a few more conversions to some Conversion Families.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* Various improvements to reduce memory use in projects.
* SysCAD updated to use a newer version of "Microsoft Visual C++ Redistributable" package. An updated version of vc_redist.x86.exe is included with SysCAD install.
* [[TCE]] Improvements:
** Updates for determining optimal breakdown reactions for forward ion mapping to TCE Input species and ions.
** Significant updates for ion mapping algorithms that results in improved product SysCAD species list after TCE calculation for a range of conditions. Algorithm changes relate to minimising the use of water in forward/reverse species to ion breakdowns and avoiding combined production of reduced and oxidised products.
*:'''NOTE:''' These changes will likely affect the results of some models using the TCE interface for OLI, AQSol and/or PHREEQC.
** Fix for displayed PHREEQC stream density when solids present (PHREEQC only returns liquid phase density).
** ChemApp minimum version required updated to version 8.2.2 from 7.4.0. Updated ChemApp DLL (ca_sc_e.dll) included with SysCAD.
*Tutorial:
** The [[Tutorial_Overview#Introductory_Steady_State_Tutorial_Documentation|Introductory Tutorial]] has been updated (Rev 35.6) and renamed from "Basic Tutorial" to "Introductory Tutorial".
** The associated Introductory Tutorial projects have been updated.
*Example projects:
** New [[Example_-_03UnitModels_Projects_1#Absorption_Tower_.28MultiK.29_Project|Absorption Tower (MultiK)]] example project to demonstrate use of multicomponent VLE to remove HCl and SO2 from fumes.
** [[Example_-_03UnitModels_Projects_2#Cooling_Tower_Project|Cooling Tower Example]] updated to demonstrate using slightly "dirty" water in Cooling Tower feed.
** Updated [[Example_80_Uranium|Demo Uranium Project]] to use General Controller instead of PID for ammonia addition to stripping.
** Minor updates to various other example projects.

===Build 33127===
:''Released 22 June 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for not being able to change the state of a CheckBox in a Grid (Table) in the Access window.
* For [[Explorer Window]] Graphics section, updated the heading display of Graphics Window and Area counts. Drag and drop of individual Graphics windows is easier by allow drop on existing pages as well as on Area heading.
* Fix for [[Access Window]] Grid (Table) headings not being correctly lined up with the column of data in some tables.
* Fix for inconsistency in VLE Grid/List display of tags for [[Vapour_Liquid_Equilibrium_(VLE)#Data_Section_for_Multi_Component_VLE|Multicomponent VLE]].
* For [[Flange]] and [[DirectLink]], improved Access window display text and added additional tags for clarity of connections. Improved the text generated for the GeneralDescription.
* Updated [[Links Table]] display when TableInfo is Detailed, with display of PortID on both sides of each connection.
* For [[Pipe#Tear|Pipe Tear]] settings, renamed Tear.ReqdType option "NoTear" to "TearIfReqd" to more clearly convey its use.
* For [[EB]] with multiple blocks switched on, display Evaluation sequence in comment on RHS of tag.
* Added new PGM [[Formatting#TextBreak|TextBreak]] keyword to leave a blank line in Access window - alternate to TextLabel "" or TextLabel() or TextLabel("").
* For [[General Controller]], added new button "Init Variables" to reset all tags (numeric types with Init values) to their Init values defined in the PGM code.
* Fix for [[Queue Profile]] control model that was incorrectly setting tags with AdvanceRow, etc. when the model is off and SetTagAlways is unchecked.
* Fix for edge case in [[Flotation Cell]] with air connection where a small energy balance error (slightly incorrect exit temperatures) occurred for some types of stream compositions.
* For [[Models#Mass_Separation_Models|Filter Separation Models]] increased the maximum allowed CakeMoistReqd. For SplitFlows [[Split_Flows_(Split)#OPERATION_-_Water_Recovery|Water Recovery]] option increased the recovery allowed.
* Reduced memory use in [[Multi-Storage]]. Fix for display of Up/Down buttons to cycle through individual Store displayed in the Access window.
* Implemented additional Upgrade Compatibility Checks to lists all models and options used that are "old" and will be discontinued in the next Build.
* [[Trend Window]] improvements:
** Improved logic for selecting x-axis grid widths with zoom in/out for ProBal projects.
** Added new option to display grid x-axis spacing label together with the window width label. The new option can set in [[General Options Trends]] and is on by default.
** Fix for ScrollBack and ScrollBackFast menu/button [[Trend/Control Command Summary|trend commands]] which were back to front.
* [[TCE]] Improvements:
** Upgraded [[PHREEQC]] version in SysCAD from 3.5.0-14000 to 3.7.3-15968.
**:'''NOTE''': This may affect project results using PHREEQC.
** Added missing error message displays for manual TCE [[PHREEQC Direct Calc Model|Direct Calc]].
** Allow use of OLI Engine V11.x DLLs with [[OLI_Chemistry_Model|Legacy OLI]] interface.
** Modifications to adsorption calculation algorithm for [[PHREEQC]].
**:'''NOTE''': This may affect project results for projects that implement adsorption calculations in PHREEQC.

===Build 33001===
:''Released 18 May 2023
* Fixes for bugs introduced in previous Builds:
** Build 32925: Fix for crash with loading TCE OLI projects.
* [[Reaction Block (RB)]] improvements:
** Updated checks for RB Extent type [[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]] when using by Total instead of by Phase.
** Improved convergence tolerance test for individual reactions in a RB. The result is greater accuracy in achieving reaction extents to more significant digits, and less "Extent not achieved" error condition messages where extent is almost achieved.
** Reduced memory use in RB.
* TCE: New option for [[TCE_Species_Mapping#Reverse_Mapping_Algorithms|Reverse Mapping Algorithm]] which can greatly improve the calculated final composition of aqueous SysCAD species from TCE outlet ion composition. Tag is "RevIonMap.BreakdownFirst" in TCE ModelCfg. For existing projects behaviour is as before, user can change this setting and check the results.
* For [[Hydrocyclone]] using Whiten Fishhook method with a "large" fishhook and low WaterRecovery (Rf), prevent small "negative" flows in small PSD sizes and give an error condition message.
* For [[Single Variable Histogram]] added option to specify number of display digits for bucket percentages. Various other improvements including grid display in Access window of the histogram bucket values.
* New graphics display commands "Update Makeup/Discard/SrcLink Graphics" to reset (repair) the default associated DirectLink graphics. Functionality is similar to existing [[Display_Graphics_Commands#Update_Tear_Graphics|Update Tear Graphics]]. Found in graphics Display menu (and graphics context menu).

===Build 32925===
:''Released 5 May 2023
* '''NOTE''': Full install recommended as Build 32925 includes new Reaction Editor, updated Basefiles (symbols, template reports, Notepad++ syntax files, etc.), new VS Code extension for SysCAD PGM and updated example projects.
* Improved options for PGM (and MP) code editing:
** Microsoft [[Using VS Code|VS Code]] is an alternative text editor to [[Using Notepad++|Notepad++]] for editing PGM files. Kenwalt has developed a VS Code extension for SysCAD PGM files which provides a productive rich environment for editing PGM files with full syntax colour highlighting, etc. If Microsoft VS Code is not installed, download and install the software. Then install the SysCAD PGM extension using syscad-pgm.cmd (located in SysCAD139\Setup\VSCode_PGM_Extension\syscad-pgm.cmd).
** The colours for keyword highlighting (for VS Code and Notepad++) have been updated, with a particular focus on use of a separate colour for all non-logic (i.e. formatting) type keywords. To update Notepad++ PGM Syntax keywords, follow [[Using_Notepad%2B%2B#Repairing_or_updating_User_Defined_Language|updating user defined language]] instructions.
** Expand selections of editors in [[General Options General]] to include separate selection of PGM editor. This now includes functionality to find and use VS Code. Improved functionality under new "Select" button for selecting preferred editor.
* Updates to rework Flowsheet Area management in [[Explorer Window]] and [[Plant Model - Flowsheets]] tab page for cleaner management of flowsheets by Area. Rework logic for "Unassigned" flowsheets. Removed Global Area. Added option to allow/disallow flowsheets to be unassigned to areas (belong to "None" when not assigned). New Explorer Window context menu option (for graphics Area) to add new graphics directly to Areas.
* Added support for a Graphics, Trend or TagList document to have the same name. Names must be unique within the document window type.
* New menu option "Tools|Upgrade Compatibility Checks". This lists all models and options used that are "old" and will be discontinued in the next Build. This will allow user to check a project, and make any changes to resolve any reported issues, before it can be used in a newer Build.
* Improved [[Merge Project]] efficiency and robustness, primarily related to managing Flange tags (auto create new flanges in imported project). For system DirectLinks (Src/Snk/Spill) added option to include in tag checks or ignore and create new tags (as per Flange tags).
* Improved functionality for [[Access Window]] copy and paste of multiple fields including Checkboxes.
* Display conversion family name in [[Conversions#Changing_Conversion_units_for_a_Data_Field|right click]] popup context menu for change conversions - useful for quick lookup of conversion family name for editing PGM files. Last entry is now "Change *CnvName* Default..." instead of "Change Default...".
* Some rework of opening [[General Options]] and [[Project Settings]] dialog boxes to prevent occasional crashes on some PC's or failure to open dialog box.
* Fix for initial placement of toolbars after install.
* For [[Zip Project]] added new option to open containing folder after zip; and new option to include scenario files.
* [[Reaction Block (RB)]] improvements:
** Implemented new "[[Reaction_Block_-_Extents#Final_Elemental_Fraction_.28RB_.26_CRB.29|Final Elem Frac]]" reaction [[Reaction Block - Extents|extent method]]. Allows control of reaction extent to achieve a target elemental molar or mass fraction.
** For "[[Reaction_Block_-_Extents#Final_Fraction_.28RB_.26_CRB.29|Final Frac]]" Extent method, added support for final fraction by IPhase.
** It is now possible to load an empty reaction file (no reactions). Previously this gave errors and prevented project solve. RCT file can have RHX only.
** Condition warnings for reaction extents at user limit when using LimitAmountReacted or LimitFracReacted are not shown if Extent.Type is Target (i.e. only shown for Strict).
** Improved RB.Status feedback descriptions.
** Improved display when reactions in a RB are off and HideOffReactions is selected.
** Improved error message reporting when RCT file fails to load.
* [[Reaction Editor]] improvements:
** Released new [[Reaction Editor]] version 1.5 with multiple functionality improvements and various bug fixes.
** Supports new Final Elem Frac extent method and Final Frac by IPhase.
** Added 'Open Containing Folder' option for quick access to reaction files.
** Added right-click option to Reverse Reaction (swap reactants and products).
** UI improvements, including sharper image on high resolution screens.
** Fractional extents are now input and displayed as percentages.
* Improvements and fixes for selection and use of component for use in VLE in [[Simple Condenser]] and [[Simple Evaporator]].
* For the [[Compressor]] added a new Polytropic calculation method. Improved options for Adiabatic Efficiency.
* Added new [[Conversions]] family LRate "Length Rate (Level Change)" as an alternate to Ldt "Velocity". Useful for display of rainfall rate, etc. in PGM files.
* Stricter checking for case sensitive unique names for Individual Phases (IPhase) in [[Species_Table#Species_Definition|Species Definition]]. Fail project load when an error.
* Added new functionality for Tank/Tie [[SplitFlows]] with new Operation option [[Split_Flows_(Split)#OPERATION_-_Target_Stream|Target Stream]] that allows selection of a single outlet stream where all flow is directed.
* Improved [[Dynamic_Tank_-_Optional_Data_Sections#Level_Lookup_.28LL.29_Tab_Page|Level Lookup]] functionality for Dynamic Tank.
* Added functionality in Dynamic for Batch control (new tag BatchClearOnEmpty) in [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipes]] and [[Feeder-Cross_Page_Connector#Batch_Feed|feeders]] to allow batch amount to be reset (cleared) with Empty Action.
* For [[GFEM]] all the tags on Results tab page are now shown on project load.
* Fix for crash in use of [[Species_Table_-_Transport_Properties#Laliberté_Viscosity_Function|Laliberté Viscosity]] correlation when large AqFrac.
* Fix for [[Drum Filter]] vent causing mass balance error warning when vapours in feed goes on/off.
* Fix for incorrect [[Feeder]] outlet flowrate when FlowBasis is Solids or Liquids and Mode is VolumeFlow.
* Fix error in load [[Scenarios]] with [[Set Tag Controller]] getting the conversion units wrong.
* [[EHX]] Ambient5 method updated to limit outlet temperature to ambient conditions.
* Dynamic mode [[Heap Leach]] (or layered column) model now included with standard SysCAD install. Was previously available on request.
* [[Heap Leach]] unit model improvements in displays for Measurements and RBControl. Added Langmuir RBControl for Extent type "Amount Reacted - Molar". Changed measurements used in Langmuir extent control to be feed plus content.
* Improved functionality in [[General Controller]] for Copy to Clipboard buttons for TagList of all PGM Input/Result tags, with additional options in popup menu.
* Added PGM [[Matrix Class]] function MultLeftArray and CopyMultLeftArray for Vector times Matrix (useful alongside existing Matrix times Vector function).
* [[Excel Reports]]:
** Improved management of template files, including a change in logic to only create copies of template report files when first generated or viewed in Excel.
** Expanded options for [[Adding_and_Executing_Excel_Reports#Right_Click_Pop_Up_Options|right click context menu options]] for Reports in Excel Report list dialog.
** Improved warning message in Excel feedback worksheet, when full tags (or primary tags in TagTable) start with a dot (.).
** Where a Cell in Excel for a full tag (or primary tag in TagTable) only contains a dot (.) this is now [[Excel_Get_Tag_Reports#Reporting_Rules|treated as a special case]] equivalent to an empty cell.
* [[Graphics Window]] (flowsheets):
** For [[Print#Print_Multiple_PDF|Print Multiple PDF]] of graphics flowsheets, added new option to open containing folder after print to pdf.
** Fixed crash for graphics paste after [[Copy_and_Paste_Graphics_Commands#Cut|graphics cut]] if some other command occurred between these two actions.
** Implemented functionality in project to select default drawing frame for new flowsheet pages. The Frames drawing symbols are now installed to a separate symbols folder.
** For [[General Options Colours]]: Removed unused option for negative flow. Fixed an error with underlying save and load of settings. (Current user settings may be replaced with defaults when first using this new Build.)
** For [[General Options Drawing]]: Added new user option to select thickness (weight) of drawn lines. For different screen resolution displays (DPI) and depending on graphics window size or zoom, line thicknesses could vary. Line thickness (or weight) is now more consistent based on user selection, including option to always display single pixel line widths for all screen display types.
* [[Trend Window]]:
** Improved display of vertical green line for current timeline cursor display. Results in smoother trendline display without scrolling gaps in trend lines.
** Improved display of text labels in trend line window.
** [[General Options Trends]]: Added new user option to select thickness (weight) of trend lines, including option to always display single pixel line widths for all screen display types. Line thickness (or weight) is now more consistent for different screen resolution displays (DPI) and user sizing of trend window.
* [[TCE]] Improvements:
** General improvements for error reporting.
** TCE Pond functionality improvements.
** Fix for false TCE error reporting when TCE is Off (i.e. Model = "None (Off)")
** For OLI display of IonicStrength changed calculation and display units to mol/kg to be consistent with all TCE's and common use. Old tag was mol fraction. Caution: projects using this tag may get different results.
** Added option to copy OLI Apparent species to clipboard.

===Build 32530===
:''Released 23 February 2023
* Fix for recycle tears with no flow that were not detected as NoFlow state. This gave errors in convergence reporting and false convergence of temperature in recycle with no flow.
* Improved display of Criteria, [[Solver Setting - Tears|Tear Blocks]] and [[Tear|Tears]] shown in $Solver and for individual Tears. Includes some additional result fields (e.g. tear state), and changes to tags for consistency.
* For dynamic projects, moved reporting options for [[Solver Setting - Spills|Spills]] from PlantModel to $Solver.
* Improved [[Model Data Transfer]] dialog by excluding global parameters and some repeated tags in the list of tags. Removal of repeated tags fixes errors in Data Transfer not working correctly for some use cases.
* Graphics dialog improvements: For [[Insert Graphics Commands|Insert Unit]] allow user to clear and enter the tag without a default tag being automatically created when field is cleared. For [[Construct Graphics Commands|Construct Unit/Link]] hide the Search field.
* Renamed the SysCAD temp folder folder in system user temp from SysCAD139 to _SysCAD_139_.
* For species database temperature range for [[Species_Table_-_Specific_Heat_(Cp)|Cp (Enthalpy)]], if value is below 1K, give warning message and use 1K as the minimum temperature.
* [[Merge Project]] is more efficient. New system flange tags are automatically created instead of trying to manage flange tag naming conflicts.
* Bug fix for [[Zip Project]] for large projects.
* Clearer display of IsothermComponent selection for use in [[Solvent Extraction Unit]].
* Updated calculations and tags for recently introduced [[Sugar Fugal 2]].
* [[Heap Leach]] model improvements:
** Fix for incorrectly including solids flow between layers when LiqDrain method is None.
** Improved calculation of LiqFrac holdup when solids included with LiqDrain.
** Reduced memory use.
** Display improvements: Fix for some layer result displays for empty layers. Add display of Sf for feed to each layer. Add display of last step OpModeUsed. Add result display of Product.Qm.
** New condition warnings: When OreFeed flow and OpMode is not stacking. When OreFeed flow and heap is full.
*Example projects:
**Updated all [[Example - 05 PHREEQC Projects|PHREEQC Examples]].
*New [[General Controller]] PGM Runtime Debug mode. To track down where in the code runtime errors (such as divide by zero) occur, select the "Enable Debug" button which will reload the PGM with stored line numbers that are then used when reporting any runtime errors in the message window. At next project load, any models in RuntimeDebug mode are returned to normal operation.
*New PGM '''[[Class - Macros|Macros]]''' for use with Classes providing significant new functionality for working with collections (lists) of class instances:
** Added ForEachSub macro as alternate to ForEachClass. Syntax ForEachSub(Classes, SubName(...)) Example ForEachSub(TankClass, Exec())
** New ForEachFn macro. Syntax ForEachFn(ResultVariable, OperationMethod, Classes, FunctName(...)) Example ForEachFn(Total, +, {T1,T2,T3}, CalcArea()) is equivalent to Total = T1.CalcArea() + T2.CalcArea() + T3.CalcArea()
** New ForEachVar macro. Syntax ForEachVar(ResultVariable, OperationMethod, Classes, ClassVariable). Example ForEachVar(TotalVol, +, {T1,T2,T3}, Volume) is equivalent to TotalVol = T1.Volume + T2.Volume + T3.Volume
** New ForEachVarSet macro. Syntax ForEachVarSet(Classes, Variable, Expression). Example ForEachVarSet({T1,T2,T3}, Height, 17) is equivalent to T1.Height = 17 T2.Height = 17 T3.Height = 17
** New ForEachFnCalc macro function. Syntax ForEachFnCalc(OperationMethod, Classes, FunctName(...)). Example: Total = ForEachFnCalc(+, {T1,T2,T3}, CalcArea())
** New ForEachVarCalc macro function. Syntax ForEachVarCalc(OperationMethod, Classes, ClassVariable). Example: TotalVol = ForEachVarCalc(+, {T1,T2,T3}, Volume)
** New ForEach macro function. Syntax ForEach(OperationMethod, Classes, FunctName(...)/ClassVariable). This auto detects last parameter type and is then equivalent to ForEachFnCalc or ForEachVarCalc.
** New ClassCount(Classes). This returns the number of class instances in the list. Example: AveArea = ForEach(+, {T1,T2,T3}, CalcArea()) / ClassCount({T1,T2,T3})
** For ''OperationMethods'' parameter the available operators are : +, *, -, or, and, bor, band, bxor
** For ''Classes'' parameter in these macros, this can be a named ClassList, a list of specific class instances and/or a class arrays all enclosed in {}, or a list of class types enclosed in {}.
*New PGM '''[[Class_-_Using_a_Class#ClassList|ClassList]]''' command to define a list of class instances, including class arrays, that can then be referenced in subsequent code (for example in multiple calls to ForEach macros).
** Syntax is ClassList ListName {classes}. Example ClassList L1 {T1,T2,T3} or ClassList TanksList {Tanks,T1,T7,MoreTanks[2],MoreTanks[7],T12} (where Tanks and MoreTanks are arrays of classes).
** A ClassList provides the convenience of defining a class list (collection) once. For example: If we have "TankClass T1,T2,T3,T4,T5". We can have different lists such as "ClassList L1 {T1,T2,T3}" and "ClassList L2 {T3,T4,T5}" intentionally including T3 in both lists.
** A ClassList can be declared when defining the class instances, where the list is all the instances. For example TankClass{List(TanksList)} T1,T2,T3,T4,T5
** Some examples: ForEachVarSet(L1, CalcHeatLoss, true) ForEachSub(TanksList, Exec())
*New PGM '''[[Class_-_Using_a_Class#ClassGrid|ClassGrid]]''' keyword to display classes in a grid (table):
** New [[Class_-_Using_a_Class#ClassGrid|ClassGrid]] keyword for displaying classes in a grid format, where each column is a grid and each row is a variable for the class.
** Syntax is ClassGrid classes. Where classes is a previously defined ClassList or list of classes similar to use in ForEach macros. Examples: ClassGrid {T1,T2,T3} ClassGrid L1 ClassGrid {TankClass} ClassGrid Tanks (where ''Tanks'' is an array of classes)
** Use ClassGridMaxColumns within class definition to set the maximum number of columns. Default is 10. Multiple grids are shown when larger number of class instances.
** Use ClassGridColumnWidth within class definition to set the column width. Default is 14.
** TextLabels within the class grid are shown as row separators, however blank lines and multiple text lines are ignored (only the last textlabel in a group is shown). All TextLabels in a grid can be hidden if using keyword ClassGridHideText in the class definition.
** If comments are used for class instances, these are shown as text for each column in first row of grid. This can be disabled using keyword ClassGridHideComment in the class definition.
** If option ClassGridPageLabel is used in class definition, then the grid is displayed on a new tab page in the Access window.
** Instead of using ClassGrid keyword, it is possible to use a grid when declaring the class instances using the keyword Grid within {} or use the # symbol For example TankClass# T1,T2,T3,T4
*General [[PGM]] Improvements:
** Allow use of @ or @@ when declaring [[Data_Types#User_Defined_Constants_using_the_Const_Keyword|const]] variables to provide visibility. Example: const double MinAreaT@ = 18
** Allow use of previously defined constant in declaring options [[Declaring_Variables#Declaring_variables_with_an_Initial_Value|Init]] or [[Declaring_Variables#Declaring_variables_with_ranges|Range]] for variable. For example: double ValReqd*{Init(PI)} double T_Reqd*<MinAreaT,MaxAreaT>.
** Allow use of previously defined string constant in [[Declaring_Variables|declaring variable]] comment option. Must use Comment() keyword. For example: double QmReqd*{comment(Desc)} where Desc is previously defined as: const Str Desc = "Some common description"
** When specifying comments when [[Declaring Variables]], it is not necessary to include the "comment()" keyword. For example use: real FlowReqd*{"Enter feed flowrate"} instead of: real FlowReqd*{comment("Enter feed flowrate")}
** Use new keyword ClassAsGroup in class definition to display class instances in Access window with "ClassName..." instead of repeating "ClassName.xxx" for each variable of class.
** Allow specification of Comments for Class Instances. The display of the comment in the Access window depends on use of ClassAsGroup and if class is shown in Grid. Example TankClass T1{"Feed Tank"}, T2{"Acid Tank"}. The keyword [[Class_-_Using_a_Class#ClassComment|ClassComment]] can also be used, where syntax is ClassComment Class "comment". Example: ClassComment T[1] "Feed tank"
** New functions [[Predefined_Functions#User_Defined_Messages_and_Errors_Functions|StopSolver(..) and PauseSolver(..)]] as alternates to PGM variables StopSimulation and PauseSimulation.
** General improvements in PGM load error reporting. Stricter checking for literal string parameters being enclosed in quotes ("). New warnings for unexpected scope use of keywords within functions, if-blocks or while-blocks. New warnings if using special characters ':', '~' or '&' in variable/function names, they will not be allowed in future Builds.
** Added load time warnings if any old PGM syntax or keywords are used (will be discontinued in future Builds).
* [[TCE]] Improvements:
** Various improvements in Ion mapping algorithm.
** PHREEQC bug fix for saving and loading SatIndex when < 0.
** Don't allow loading of PHREEQC databases containing '''-no_check''' reactions because this allows PHREEQ equilibrium calculations that don't conserve mass. If you get this error, edit PHREEQ database to remove these reactions.
** Fix for OLI projects failing to load (bug introduced in 32335).
** Fix for TCE Feeder where the outlet stream was not properly calculated after changes to the selected model configuration (i.e. changes to SatIndex, mapping tolerances, etc.)
** Added option to copy to clipboard all connected feeds/products.
** Plotter bug fixes and improvements.

===Build 32335===
:''Released 17 January 2023
* Fixes for bugs introduced in previous Builds:
** Build 32217: The maximum number of PGM tab pages were mistakenly limited to 10. Returned the limit to 250.
* For Dynamic projects, in [[Solver Settings]] ($Solver) added new functionality for reporting [[Solver Setting - Spills|Spills]] and [[Solver Setting - Vents|Vents]]. Includes some options for some detailed analysis of when and where spills occur.
* Added optional display of QFeed and QProd to [[Valve]], [[Pump]], [[Gas Pump]], [[Reducer]], and QPrimary and QSecondary feeds for [[Thermocompressor]].
* For [[Precipitation3]] changed various Ea/R tags from temperature conversion to dimensionless for clarity. K is shown as comment in Access window.
* Improved display of CheckBoxes in [[Access Window]] at different high resolutions.
* Example projects:
** New GFEM + ChemApp example project [[Example - 07 ChemApp Projects#Hybrid GFEM + ChemApp Electric Furnace|Electric Furnace]].
* [[PGM]] Improvements:
** For PGM ForEachClass macro used with PGM [[Class - Introduction | Class]], now require use of brackets for the subroutine used. For example use "ForEachClass(TankClass, Init())" instead of "ForEachClass(TankClass, Init)".
** For defining constant [[Array Class|Array]], [[StrArray Class|StrArray]] and [[Matrix Class|Matrix]], the const keyword is now required. For example "const array Vals = {1,4,2,98}" instead of "array Vals = {1,4,2,98}".
** Give PGM load time warnings if strings for [[Formatting#Labels|PageLabel and TextLabel]] are not enclosed in quotes (").
* [[TCE]] Improvements:
** Added a Forward Mapping Summary to Results page
** Allow selection of Off for TCE in all TCE unit models. Allow solve when no license for TCE (TCE calculations bypassed).
** New OnStart option for TCE side calculations.

===Build 32217===
:''Released 19 December 2022
* Fixes for bugs introduced in previous Builds:
** Build 31866: Fix crash or freeze that can occur when list of PIDs in [[Controls Window]] is being updated while building flowsheets by inserting a PID.
* Fix for [[Info_Report#Species_Information_Report|Excel Species Info]] report for project with large number of species.
* Fixed tag visibility error of Isotherm options in [[Solvent Extraction Unit]].
* Fix for edge case [[Flash Train]] not solving correctly where a Tie/Tank SplitFlows using General OpMode has multiple outlets with QmDemand and the last of these doesn't find a demand sink (e.g. condensing Shell&Tube heater). The Tie/Tank outlet in Demand mode without a detected demand destination is now treated as a zero demand flow.
* Added option for [[Shell and Tube Heat Exchanger 2]] for when the model is Off, so that a condition warning is given when model is off but there is flow to the shell side. Especially useful for Condensing mode.
* Added option "OFSolidsPriority" to [[General Separator]] for "SplitMethod" selection "Solid Separation". This is to prioritise OF or UF Solids requirements for the OF "SolidsSeparMethod" choices when the feed solids are too low to meet any requirement. For some flowsheet arrangements (recycles), this can help project convergence reach required OF setpoints and solids flow.
* For [[Vapour_Liquid_Equilibrium_(VLE)#Multiple_Component_VLE|Multicomponent VLE]] user specified K values, implemented a fix to allow user to specify a 0 value for K (resulting in all of that component going to liquid phase).
* Fix for dynamic mode where the Historian restarted twice at solver startup for set time option for [[Solver_Setting_-_Scenario|Scenario management]].
* For dynamic mode Feeder using volume flow [[Feeder-Cross_Page_Connector#Batch_Feed|Batch Feed]], fixed edge case where this failed to work due to previous zero outlet flow.
* Added new option for OPC [[Marshal]] to block Marshal setting mapped SysCAD tags when Marshal OPC tags are invalid or Marshal cannot connect to OPC Server.
* New [[Sugar Fugal 2]] model as an alternate to [[Sugar Fugal]].
* New option in [[Heap Leach]] for bottom up flow of liquid feed in the column, in addition to original top down behaviour. Implemented other display improvements and bug fixes in [[Heap Leach]] model.
* Added optional display of QFeed and QProd to [[Compressor]], [[Valve 2]], [[Pump 2]], [[Piping System Model]] and [[Pressure Exchanger]].
* Improved management of user [[Conversions#Changing_Conversion_units_for_a_Data_Field|selection of conversion units]] in the [[Access Window]]. In particular, for tags on stream pages (Qo, QFeed, etc.), the user selections are now applied to all Streams in all unit models. Fixed a bug where after a conversion change the numerical values were not immediately shown for the "same" tag displayed in other tab pages of the model.
* Improved efficiency and responsiveness on close of [[Insert Graphics Commands|Insert Unit]] dialog.
*Example projects:
** New PHREEQC example project [[Example_-_05_PHREEQC_Projects#Raffinate_Water_Treatment_Example|Raffinate Water Treatment]].
*[[PGM]] Improvements:
** Fix for PGM Array and Matrix recovering the data when pressing the Reload button. Previously the Array and Matrix size was set to zero length when reloading a PGM when the project is open.
** Added alternate variable [[Data Types]] bool and boolean for bit; and int for long/integer.
** New [[String Functions]] StrInsert, StrErase, StrReplace and StrReplaceFrom.
** Alternate [[String Functions]] StrFind for StrStr, and StrFindFrom for StrStrFrom.
** For [[Array Class]] and [[StrArray Class]] added new functions InsertAt(Index, Value) and RemoveAt(Index, Count).
** Added support for const readonly PGM [[StrArray Class]] declared with = {"..", "..", etc}.
** New [[Class_-_Defining_a_Class#Syntax_for_Class_Declaration|ClassAsPageLabel]] keyword for use in class definitions. Use this to automatically create page labels for each instance of a class.
** Don't report special case of 0/0 runtime warnings while running PGM code, the result is 0 (as before). SomeValue/0 still gives a runtime warning always. This runtime warning message can be switched on in the [[General Controller]].
** Some improved PGM load time checks and build error messages for declaring variables, functions and classes.
* [[TCE]] Improvements:
** Further improvements to Ion mapping algorithm to handle edge cases in reverse mapping.
** IonList.txt file should not have charged neutral species. They are ignored.
** Improved error reporting for loading IPhaseMap.txt file. New option to edit file from edit configuration dialog.
** To manage warnings about Acids and Bases being present in a product stream, user can select target breakdown reaction in $SDB species properties to control if a species is seen as an Acid, Base or Amphoteric.
** Only display TCE Density value tags (and SolidsConc) if these are calculated by the TCE.
** Corrected tag names and column display headings for solid/liquid/gas phase ActivityCoeff / Activity / Fugacity / SatIdx /etc. for the different TCE prod streams. Values are now correctly saved and recovered at project load. Any reports/controllers using these tags may need updating.
** Fixed inconsistent stream tags QRxnUnmapped and QUnmapped in all TCE models.
** Various improvements in displays and options for SideCalc, including use of optional reverse mapping.
** For ChemApp updated direct reporting of Feed and Prod Enthalpy and Heatflow.
** For PHREEQC allow user to set maximum number of iterations and fix of crash in loading of specific database files.
** For OLI various improvements in display of property results and apparent species.
** User can select Phases allowed for Mapping for Forward and Reverse mapping separately.

===Build 31866===
:''Released 26 October 2022
* Fixes for bugs introduced in previous Builds:
** Build 31157 - Show the option "IndividualPhase" for tag "EleBasis" on [[Material_Flow_Section#Sp_and_EC_Tab_Pages|EC]] tab page to report concentrations, etc. of elements by IndividualPhase - drop down option was mistakenly hidden.
** Build 31602 - Fix PGM bug where on editing and/or reload of the PGM, the contents of all pgm strings were discarded.
** Build 31388 - Fix error for [[Command Scripts]] or [[COM Automation]] stopping on SaveProject command (i.e. not completing the command and returning control).
** Build 30874 - Fix for graphics symbol using NURB splines (e.g. forklift) that caused dxf files to expand in size with each save (and eventually crash SysCAD).
* License administration changes:
** Renamed license add-on option "SMDK Runtime" to "[[SysCAD_Structure#Integrated_Libraries_.28SMDK_Runtime.29_Add-On|Integrated Libraries]]" add-on.
** Combined previously named OLI add-on, PHREEQC add-on, AQSol add-on and ChemApp add-on to a single combined add-on called "[[SysCAD_Structure#TCE_.28Thermodynamic_Calculation_Engines.29_Add-On|TCE add-on]]". Any existing license using these old add-ons will automatically include "TCE add-on" providing all TCE options.
* Second generation of OLI integration libraries (now as part of TCE) are now included with standard SysCAD installation - see [[OLI Overview]]. Separate download and Beta label has been removed.
*Example projects:
**New example project using Python script for [[Example - 07 ChemApp Projects#Nickel Laterite Smelter Multivariable Optimisation|multi-variable optimisation of ChemApp Nickel Laterite Smelter]].
* The list of all PID controls on [[Controls]] is now ordered alphabetically.
* The list of all PIDs is now automatically updated on existing [[Controls Window]].
* For [[SplitFlows]] in Tank/Tie added new option "Last" for "Priority". Useful to mark a pipe as always last (doesn't change with adding/removing pipes.)
* Significant rework of Dynamic mode [[Solver Setting - SS Monitor|Steady State Monitor (SSM)]] and [[Solver Setting - SS Finder|Steady State Finder (SSF)]] functions. SSM is ideal for analysis of changes in flows and contents in a dynamic model, especially at startup.
* When specifying isotherms in text files, added support for specifying conversion units in column headings.
*[[PGM]] Improvements:
** Improved PGM and MP runtime error condition reporting at solver startup.
** Allow [[Tag_Functions#SetTag_Functions|PGM setting of tags]] that change from results to parameters during a model run. Various improvements and fixes in error reporting for failing to write to tags from PGM or MP.
** Added [[Matrix Class]] class functions ColOffset, ColSum, ColAvg, ColMin, ColMax, ColMinIndex and ColMaxIndex.
* Other fixes:
** Fix for error (or occasional crash) in activating/deactivating pages from [[Plant Model - Flowsheets]] Access window.
** Fix for controller "Not in evaluation sequence" error message after page activate/deactivate.
** Fix for [[Discard Sink]] that reported incorrect temperature (and enthalpy) for total QProd. Error was in accounting for first discard link in list.
** Fix for dynamic push/pull not achieving correct volume flow in a time step for edge case of use of Tie with no flows in "local network".
** Fix for error for [[Historian]] where for a new project it was not located in the correct folder leading to subsequent historian errors on project load.
** Fix in [[Drum Filter]] when using recycle option.
** For [[Adding_and_Executing_Excel_Reports#Excel_Automation:_Export_Reports_and_Import_Data_Dialog_Box|Excel reporting Dialog]] allow Excel filename with a quote (') in filename.
* [[TCE]] Improvements:
** Improved TCE ion mapping logic and project load time for building ion mapping lists from [[Ion Definitions]] file.
** Improved tests for errors loading TCE libraries or licenses. When an error occurs, prevent project save. Save-as is allowed.
** Improved dialog for [[TCE Configuration]]. New option when editing cfg files to allow IonMapping for selected TCE ChemApp databases.
** For TCE tab page for TCE unit models, improved the Access window layout of tags. Selection of linked Chemistry Model is always first. TCE Reactor and TCE SideCalc now have a separate TCE page consistent with other TCE unit models.
** TCE RO model fixes and improvements.

===Build 31623===
:''Released 27 August 2022
* Fixes for bugs introduced in recent Builds:
** Build 31602 - Fix for crash editing a cfg file when selecting the Calculations tab page.
** Build 31388 - Fix for crash in Tank or Tie with large number of connected pipes.
** Build 31602 - Fix for being unable to load ChemApp model even when license is valid.
* For dynamic projects, introduced a warning message if invalid [[SplitFlows]] option "Demand Mass Flow" is selected in Ties.

===Build 31602===
:''Released 22 August 2022
* Allow projects using [[TCE]] Demo (Light) versions to load and solve without requirement for TCE license add-on.
* Improved error reporting for loading of rct files in [[Reaction Block (RB)]].
* Updated functionality for Dynamic Steady State Monitor ([[Solver Setting - SS Monitor|SS Monitor]]).
* For Dynamic Control Reset, fixed an issue in initialising values in range for [[PID]] and for [[Tank_-_Dynamic_Mode#Level_Control|Tank Level Control]].
* Improved error reporting for [[Feeder-Cross Page Connector]] when connecting/disconnecting pipes.
* New PGM [[String Functions]] StrStrFrom(String1, String2, FromIndex). Similar to StrStr(String1, String2) but allows user to specify start position for the find.
* Fixed crash in [[PGM]] load/save where PGM contained strings in excess of 1000 characters.
* Fix for Tie/Tank [[SplitFlows]] for edge case of separating out individual species to cause an automatic phase change at mass fraction, as can occur for H2SO4.
* Updated version of [[ChemApp Overview|ChemApp]] libraries included with SysCAD to ChemApp version 8.2.
* Fixed errors for TCE models with VLE and Bypass - allow separate bypass for Feed and VLE Rxn.
* Miscellaneous improvements in [[TCE]] error reporting and DLL load checks.
* Minor improvements writing to temporary files, and moved some of these to the LogOutputs folder.
* Miscellaneous improvements in ProBal solver to reduce memory use and provide some minor solve time efficiencies.

===Build 31388===
:''Released 2 August 2022
* Fixes for bugs introduced in recent Builds:
** Fixed bug for incorrect [[Demand]] calculation through a Tie, Tank or Pipe with [[Makeup Block (MU)]]. Bug was introduced in Build 31207.
** Fix error preventing use of [[ChemApp Overview|ChemApp]] CFE species. Bug was introduced in Build 31218.
* New option to prevent solver start if reaction (RCT), general controller (PGM) or model procedure (MP) files failed to load or are missing. The user can turn this global option off in the individual unit models or in [[Solver Setting - FS Solver|Solver Settings]] on first tab page.
**'''NOTE''' that as these new options are on by default, existing projects with these errors will not solve unless user fixes the error or turns the option off.
* For [[SysCAD Marshal]] improved error reporting and feedback when loading the slots tag list. Improved support for optional fields. Includes fixes for crashes.
* Allow MultiStep.StepCount used with solver [[Actions Command Summary|MultiStep Action]] to be configured on first tab page of [[Plant Model]]. This setting is now saved and recovered with the project.
* Added display of HeatFlow, Feed and Prod T for [[Discard Block (DB)]]. Improved Discard Block calculation of outlet temperature due to heat of mixing.
* For the [[Sugar Fugal]] model the BasketWash connection is now optional.
* For the [[Filter Press]], fixed edge case error for bad feed conditions that resulted in incorrect (invalid) outlet streams.
* For dynamic [[Multi-Storage]] display of list of connected Feeds and Prods added Find and Access buttons for pipe tags.
* Fix error for [[Save Project]] with extra dots in user specified project name being truncated.
* Fix for bug in Dynamic where [[Pipe_-_Dynamic_Mode#FC.28FlowCapacity.29|pipe capacity and Batch]] settings, for example at tank outlet, are not saved and recovered in a new model that hasn't been run before a save.
* For Stream [[Material_Flow_Section#Properties|Material Flow]] (e.g. QFeed) and [[Common_Content_Section#Content_Properties|Content]] added new slurry based fraction tags SLf, SLvf, Slurry.Svf, Slurry.Lvf and MlSLf.
* For Tank and Tie [[Split Flows (Split)]] and [[Split Thermal (SplitT)]] added tags for total feed MassFlow and Temperature shown at top of Split and SplitT tab pages.
* Various [[Split Thermal (SplitT)]] improvements:
** Fixed bug for setting required mode, or settings getting lost when adding/removing connected streams.
** New option to set order to match the order of the outlet streams in the SplitFlows section.
** New error condition messages for case where target temperature is not achieved in a stream. Additional HeatCorrection result tag to show the HeatFlow variation that would be required to meet the temperature outlet targets.
** Improved display for outlet streams in Result field and display of massflow.
** Various improvements in efficiency of calculations.
** Option is now disabled and hidden when Heat Exchange is switched off.
* Added new Engineering [[Conversions]] family "Specific Power Volume" (PwrV). Various additions to available conversions in a number of conversion families.
* For the [[Access Window]] displays, ensure text lines are Italics (reverted back to original behaviour).
* Improvements in [[Quick_View#Copy_Data_for_Excel_Reports|Quick View copy]] to clipboard for tags without conversions.
* [[Explorer Window]] improvements:
** Fixed bug where DirectLinks were inconsistently excluded from lists.
** Fix for selection count (numbers shown in brackets) based on filter string. Added selection count for UnitTypes.
** Added optional section "[[Explorer_Window#Flange_Flows|Flange Flows]]" which lists all flanges (the connection flange objects between pipes and models).
** Restore vertical scroll position when adding/deleting models in the flowsheets.
** Improved right click context menus.
* [[Graphics Window]] improvements:
** Fix arrow keys for editing graphics that stopped working after project save and some other actions.
** Updated context menu for right click for graphics window.
** Fix freeze when pressing F11 in Access window for "Send to Annotation Table" when the Dialog is not open.
* Expanded PGM ForEachClass [[Class - Macros]] function:
** Allow a ClassTypeList of class definition types as first parameter. List in {} e.g. ForEachClass({TankClass,ThickenerClass}, Exec())
** Allow a ClassList of class instances as first parameter. List in {}. They can be different class definition types as long as they all have a sub with the same name. e.g. ForEachClass({T1,T3,W.T,X}, Exec())
** Allow the Sub to have any number of parameters. String parameters not supported. e.g. ForEachClass(ThickenerClass, SetCalcsOn(true))
** New function ExcludeClass that can be used to mark a class instance for exclusion from ForEachClass function. Ideal to pair with ExcludeWatch to skip class at index 0 in an array. e.g. ExcludeClass T[0]
* New PGM [[String Functions]]:
** string ConstStr(constant) returns the constant (including enum constant) as a string.
** string EnumStr(EnumDropList variable) to return as a string the current enum value of the supplied EnumDropList variable. Useful for display of enum mode, state, etc. e.g. StateDesc = EnumStr(FilterState)
* New PGM [[Mathematical Functions]]:
** bit IsClose(Val1, Val2) and IsCloseTol(Val1, Val2, AbsTol, RelTol) that returns true or false if the values match within tolerance. Default tolerances are 1e-9. Useful for convergence loops, or any comparison within some tolerance.
** double IsCloseError(Val1, Val2) and IsCloseTolError(Val1, Val2, AbsTol, RelTol) return error value of comparison. A value less than 1 is considered "close".
* [[TCE]] Improvements:
** Various Reverse Osmosis (RO) unit model improvements including new option for ion permeability, membrane interface and concentration polarization.
** ChemApp - allow use of newer versions of ChemApp DLL
** For TCE Unit models such as TCE Evaporator & TCE FlashTank, moved the TCE settings to separate tab page in Access window.

===Build 31218===
:''Released 12 July 2022
* Fixes for bugs introduced in recent Build 31207:
** Fix for [[Explorer Window]] right click on page names not bringing up context menu.
** Fix for [[Makeup Block (MU)]] in dynamic mode not calculating any flows after a Reset action.
* For PGM [[Particle Size Definition Class]] (PSD Class), added new functions ParticleCountFactor(), SmallestSize(Dist), GeomMeanArray(Dist, Array), TopSizeArray(Dist, Array).

===Build 31207===
:''Released 8 July 2022
* Improved [[Explorer Window]] functionality for selecting current window on open, maintaining vertical scroll position while editing flowsheets and improved behaviour when using Explorer window to select windows.
* Fixed error introduced in 30918 for Toolbar positioning. Added new menu command View|Toolbars as short cut for [[General Options Toolbars]] Dialog.
* For Tank in dynamic mode with [[Tank_-_Dynamic_Mode#Level_Control|Level Control]], implemented new options for specifying flow limits on a volume flow basis.
* Fixed error in calculating combined makeup flows for some arrangements of multiple cascaded [[Makeup Source]]s and [[Makeup Block (MU)|Makeup Blocks]].
* Fix for reporting mass balance error in dynamic after deleting a [[Makeup Block (MU)]].
* Fix display error in [[Graphics]] where drawing was shifted after printing.

===Build 31157===
:''Released 29 June 2022
* [[Graphics]] improvements:
** IMPORTANT: Fix for error introduced in Build 30874 where saved dxf files progressively grow in size eventually leading to a crash at project load. With fix, the saved dxf file is returned to correct size at next save.
** Fixed error in [[Print#Print_Multiple_PDF|printing]], where all flowsheet pages are now correctly in black & white, in the past some pages "randomly" were in colour.
** Fixed error in graphics symbol preview where some symbols were not shown in preview, these are now correctly displayed for Insert Unit, Change Symbol, etc.
* Implemented new report format for [[Command Scripts]] ReportTags command used for generating csv file reports. The new formats "TagSelectTable" and "TagSelectList" are described in [[Setting and Reporting Tags from text files]]. TagSelectTable is text file equivalent of Excel TagSelect report.
* For single component [[VLE]] species, allow user to set maximum amount of species flashed and the minimum amount retained as liquid. These are set on the [[Plant Model - Species#VLE Liquid Phase Change Limits|Plant Model - Species]] tab page. These limits are applied in VLE in some unit models such as the [[Evaporator]]. When the model is operating at a limit a warning condition is given.
* Fix for [[Conveyor Belt]] outlet massflow error for first time step under certain operating conditions; and fix Preset not emptying conveyor contents for option PresetClear.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Whiten_Crusher_Method|Crusher2 Whiten Method]] implemented some improvements in display of results for clarity.
* For [[Crusher_2_Model_Theory#Model_Theory_-_Test_Data|Crusher2 Test Data Method]] added new option to allow size increase ("agglomeration") as an alternative to the existing size reduction ("breakage") functionality.
* Fix for [[Gibbs FEM]] when using ionic species.
* [[TCE]] Updates:
** Solver efficiency improvement for [[ChemApp Overview|ChemApp]] with use of previous results and when excluding species.
** For aqueous TCE, implemented a new warning at reverse mapping step testing if both aqueous acid species and aqueous base species are present in the SysCAD solution.
** New display of total solids yield, useful for overall display of nett precipitation or dissolution.
** For [[PHREEQC Side Calc Model|TCE Side Calc]] implemented option for user to set frequency of iterations for calculation.
** Clearer reporting, displays and tags for forward and reverse mapping.
** [[PHREEQC Reverse Osmosis Unit|TCE Reverse Osmosis]] Model improvements. New heat balance options. Enhancements may result in slight changes to existing models.

===Build 30918===
:''Released 18 May 2022
* Fix bug introduced in recent Build 30874 for occasional crash when opening Access window for a model using [[VLE]].
* Improved handling of [[TCE]] error case where after a call to TCE equilibrium solve the reverse mapping of ions to SysCAD species fails.
* Improved energy balance accuracy in [[CCD]] and [[Classifier]] when there is a heat of dilution effect (results in small change in outlet stream temperatures).
* Fix a save and load error for some user parameters for [[Sugar Fugal]].
* Improvements for dynamic [[Controller -- Waveform Controller|Waveform Controller]], including new option for B-Spline interpolation of data points, and descending option for SawTooth signal.
* Implemented functionality in dynamic simulation projects for user selection of time (including date) at project load. New option can be set on [[Solver_Setting_-_Dyn|$Solver Dynamic]] tab page. This can be set to last time in historian (current behaviour) or to time at last project save.
* Extended [[Plant Model - Flowsheets]] to display count of different model groups on each flowsheet. Also displays a count of graphics symbols for the models which can also be useful to show that there are multiple symbols for a model on a page.
* Full install includes new [[Example - 05 PHREEQC Projects#USX Example|Uranium Solvent Extraction demo project]] using [[PHREEQC Add-On]].

===Build 30874===
:''Released 11 May 2022
* For [[Solvent Extraction Unit]] (Mixer/Settler) the PreMixEntrained option is now used for ''None'' Method as well as ''Isotherm'' Method. Improved display of results with additional tags and clearer Access window text. When using PreMixEntrained and NOT using the Isotherm Method, this will change the result of OARatio reported.
* For dynamic projects, four new WaveformType options for [[Controller -- Waveform Controller|Waveform Controller]] to allow user to specify a sequence of values that are then repeated every time Period. The output value will be calculated from the points (or averages) using a Periodic Spline or Linear interpolation. Ideal to generate smooth data for a repeated period (e.g. annual temperatures). The Averaging Periodic Spline method will conserve "area under the graph" (totaliser of outputs). This model provides a useful alternative to [[Controller -- Profile|Profile Controller]] configured in WrapAround mode.
* Improved display results for Multi-component [[VLE]] to include BubblePt and DewPt. For Multi-component VLE option "Multi/Ideal K's" exclude components that don't have a VapourP equation defined.
* For [[VLE]] added a display for status of any Inerts (Non Condensables and/or NonVolatiles) that are present for VLE calculation.
* For [[TCE]] added new display of Reverse Mapping Summary on the TCEResults tab page. Useful to compare the reported TCE stream Enthalpy against the SysCAD Stream Enthalpy immediately after reverse mapping.
* Improved data entry and displays for [[PHREEQC_Feeder_Model|TCE Feeder]] and [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]]. Fix bug with display of SatIndex for PurePhases in [[ChemApp Overview|ChemApp]].
* For [[PHREEQC_Model_Configuration|TCE ModelCfg]] expanded global options for elemental convergence tolerance, and for PHREEQC allow user to set the Tolerance to be used in call to PHREEQC calculations.
* New Graphics [[Symbol Management Commands]] menu command "List And Highlight Tear and DirectLink Symbols" that on a graphics page can be used to show all [[Tear]] and [[DirectLink]] models automatically created.
* Fix for crash in graphics for loading (importing) a dxf drawing or symbol that contains NURB (Non-Uniform Rational B-spline) curve elements in symbols. These are now supported in SysCAD [[Graphics]].
* For PGM [[StrArray Class]] and [[Array Class]] added function AppendItem(Item) which will increase the length of the array by one by adding the supplied data.

===Build 30807===
:''Released 27 April 2022
* Fixed error in implementation of ''SumElemIPhase'' function in Build 139 used in custom "User Property Calculations" or "Species Calculations" in [[Calculation Configuration]]. The implementation of SumElemIPhase caused some local memory corruption causing incorrect results for the function and in same cases a crash in SysCAD.
*:'''IMPORTANT NOTE''': Projects using SumElemIPhase in [[User Property Expressions]] or [[Species Calculation Expressions]] may produce different reported results, and if used as control measurements different results for model solve.
* Fix for [[Precipitation3]] using [[Alumina3_Precip_-_Full_PSD|PSD method]] where outlet stream has PSD Create or Modify action. As this may impact model behaviour, a checkbox [[Precipitator3 Data Sections#PSD Tab|''AcknowledgePSDOutletChange'']] will appear in affected units, and will need to be checked before the model can run. Model results will need to be reviewed and the model may need to be retuned.
* Fix for Precipitation3 new [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option (introduced in Build 139.30599) where mid size was incorrectly applied in old project upgrade.
* Fix for [[Merge Project]] where in some cases the flowsheet (and trend) document windows were not correctly merged.
* Fix for mass balance error in [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|Condensing Shell & Tube Heat Exchanger]] for the very specific case of stand-alone condensing mode, with vent connected and species in shell feed that are not water/steam. Non H2O species were discarded.
* Added options to show outlet streams for [[Shell and Tube Heat Exchanger 2]], [[Simple Heat Exchanger]], [[Simple Heater]] and [[Steam Turbine]].
* Improved condition warning messages for [[Simple Heater]] when Duty is not met due to Critical temperature for water. Fix for save & recover of all results.
* Implemented results display for Multi-component [[VLE]]. Previously (invalid) results for a single component system were displayed even when multi-component VLE is used.
* Display IdealK value on [[SDB - Vapours]] tab page for vapour phase species with Vapour Pressure equations.
* Some improvements in [[Graphics Symbols]] management:
** Fix for error in buttons/menus shown for Activating or Deactivating graphics pages (from [[Explorer_Window#Graphics|Explorer window]] context menu or [[Plant Model - Flowsheets]]) when there are multiple symbols on the flowsheet for a model.
** New Graphics [[Symbol Management Commands]] menu command "List And Highlight Multiple Symbols" that can be used to show all tags (units/pipes/tears/etc.) that have multiple graphics symbols on a graphics page.
** Fix for bug where multiple symbols for tears are created (can eventually lead to a crash). Duplicates are removed from flowsheet at project load.
* [[TCE]] improvements:
** '''New [[PHREEQC_Feeder_Model|TCE Feeder]] unit model'''. Allow data entry of TCE species directly. After TCE equilibrium calculation, reverse mapping is completed to form SysCAD stream which becomes the outlet product stream. Useful new model to specify a feed in terms of TCE composition.
** Added option to [[PHREEQC_Direct_Calc_Model|TCE DirectCalc]] to optionally complete reverse mapping and display the resulting SysCAD stream.
** Significant solve time speedup in [[ChemApp Overview|ChemApp]] projects by eliminating unnecessary extra function calls.
** For data entry of TCE input species composition in [[PHREEQC_Direct_Calc_Model#DInput tab page|TCE DirectCalc]] and [[PHREEQC_Feeder_Model#DInput tab page|TCE Feeder]] added functionality to report charge balance (and give condition warning when not balanced). Added option for user to optionally specify balance TCE species which adjusted to try maintain neutral mixture.
** Improved display of Feed and Product massflow summaries in [[PHREEQC_Reactor#PHREEQCResults_tab_page|TCE Results]] tab page.
** Added display comments for unmapped species when entering data for [[PHREEQC_Reactor#Bypass_tab_page|TCE Bypass]] and [[PHREEQC_Feeder_Model|TCE Feeder]].
** Rework and expansion of displayed statistics for TCE Interface Engines, as shown on [[PHREEQC_Model_Configuration#Engines_tab_page|TCE Engines]] tab page for TCE ModelCfg.
** Improved save and recover of some TCE block energy balance tag values.
* [[PGM]] improvements:
** New [[Mathematical Functions]] RoundTo(Value, Decimals) and Cbrt(Value).
** New [[Predefined Constants and Variables|Predefined Constants]] MinLong and MaxLong.
** New [[StrArray Class]] functions: Copy(StrArray), Append(StrArray), Reverse(), Sort(CaseSensative).
** New [[Array Class]] functions: Append(Array), Reverse(), Norm().
** For [[StrArray Class]] and [[Array Class]] implemented SetSize(len) as alternate to SetLen(len) and Size() as alternate to GetLen().
** New [[Matrix Class]] functions: Norm(), SwopRows(row1, row2), SwopCols(col1, col2), SortByRefRow(row, increasing), SortByRefCol(col, increasing).
** For [[Matrix Class]] implemented Rows() as alternate to GetRowCount() and Cols() as alternate to GetColCount().
** New [[Matrix Class]] row functions (Array functions on a row): RowSum(row), RowAvg(row), RowMin(row), RowMax(row), RowMinIndex(row), RowMaxIndex(row), RowNorm(row), RowReverse(row), RowSetAll(row, Value), RowScale(row, Value), RowOffset(row, Value), RowSort(row, Ascending), RowIsSorted(row, Ascending)
** New [[Matrix Class]] column functions: ColSetAll(col, Value), ColScale(col, Value)

===Build 30670===
:''Released 5 April 2022
* For [[Makeup Source]] added new option '''Link to MakeupSrc''' in list for '''[[Makeup_Source#MakeupSource_Operation_Selection|Operation]]''' to connect with a Direct Link to another Makeup Source. This is particularly useful for cascaded Makeup Sources. For example defining a single water source in a MakeupSrc, then each area has a local MakeupSrc linked back to the single MakeupSrc. The area Makeup Sources provide reporting for area water use and single MakeupSrc provides overall water use.
* For [[TCE]] product stream, display actual and effective saturation index for solids (actual = Q/K; effective = Q/(K*factor)).
* Fix for [[Access Window]] not always displaying the correct context menu for right mouse click on a tag.

===Build 30613===
:''Released 23 March 2022
* Implemented new [[Alumina3 Precip - Full PSD]] agglomeration method [[Alumina3_Precip_-_Full_PSD#David-Rijkeboer_Kernel|David-Rijkeboer Kernel]].
* For [[TCE]] ModelCfg added a button to add any missing ions (required for mapping) to [[Ion Definitions|ionlist.txt (Ion Definitions)]].

===Build 30599===
:''Released 21 March 2022
* For [[TCE]] projects, implemented stricter checking for inclusion of ions in [[Ion Definitions|ionlist.txt (Ion Definitions)]] to ensure more robust and correct forward and reverse mapping. Solver will not start if any ions are not mapped. For existing AQSol and PHREEQC projects it may be necessary to edit the ionlist.txt file and add the missing ions.
* Improvements in [[TCE]] SideCalc, including new option to select species for adjustment for charge Balance.
* Implemented new dynamic mode [[PHREEQC Pond Model]], currently in Beta.
* For user defined PGM [[Class - Introduction | Class]] implemented functions '''ClassName'''() that returns class name ("type") as a string; and '''ClassTag'''() that returns the class instance variable name (tag) as a string. The ClassTag function is particularity useful when class instance name matches model tag in flowsheet, so that an Init function or similar can use this instead of having to enter this separately.
* Implemented new PGM [[Mathematical Functions]] '''Floor''' and '''Ceil''' for use alongside Trunc and Round.
* Implemented new functions for PGM [[Array Class]] '''CircConv'''(Array) and '''CopyCircConv'''(Array) for Circular (Cyclic) Convolution function.
* New [[Precipitator3 Data Sections#Agglomeration Parameters|Agglom.UseMidSize]] option to choose between PSD interval mid size or top size for agglomeration kernel calculations.
* Improved [[TagList Window]] context menu options for inserting rows at end. Improved error reporting of unknown tags.
* [[Access Window]] improvements:
** LHS Margin is narrower and does not change with More/Less button.
** Display help descriptions in flyby tooltips when mouse is over [[Access_Window#Selection_Buttons|Selection Buttons]] at top of page.
** Fix issues with selected fields when changing tabs or using resize button.

===Build 30498===
:''Released 4 March 2022
* Implemented new WashCalc calculation option in [[Filter Press]] to calculate wash water feed required to meet a selected target wash ratio. With this new feature controllers for wash water addition can be removed or simplified. Wash Water feed can optionally be connected to General Demand to automatically control the wash addition.
* New option for user to select rule for positioning of dialog (or floating window) on Displays when the dialog box or window is opened. This is especially useful when working with multiple Displays (screens). For example user can select to keep the Explorer window on the same display as the SysCAD application, or within the SysCAD Application window. The options for this can be set in [[General_Options_General|General Options on the General]] tab page.
* Fixed error when inserting a new pipe and setting for "Simplify" was inconsistently (randomly) selected. Error was introduced in Build 30270.
* Fix error in Tie/Tank using [[Split Flows (Split)]] for specific case of selecting (a) Operation as [[SplitFlow - General Operation|"General"]], and for an outlet pipe (b) QmMode as "VolumeFlow" and (c) MkMode as "Composition". The calculated output flow is now calculated correctly for the targeted composition.
* Allow PGM [[Class - Macros|ForEachClass]] to be used within functions/sub (but not functions/sub within a class definition).

===Build 30448===
:''Released 25 February 2022
* Fix for crash and error in handling a [[ChemApp Overview|ChemApp]] cst file containing CFE species.
* New [[Access_Window#Selection_Buttons|Access Window Selection Button]] alongside "Adjust Access Window Height" button to position Access.1 window to RHS of graphics so that their is no overlap with graphics windows. In some cases this may move graphics windows to the left. This is a useful windows layout feature for navigating flowsheets and viewing model values in Access window displayed alongside the graphics.
* Fix for reported values in [[Discard Sink]] under "Results: Total Flow Conditions" on Total tab page, it was showing values for the first discard link only.
* Fix for crash in [[TagList Window]] when right clicking on tag to bring up context menu and the tag is referenced by controllers.

===Build 30427===
:''Released 22 February 2022
* IMPORTANT fix for Build 30316 and 30376: Fix for tears not being listed in count of convergence criteria shown in [[Solver Setting - Convergence|Solver Convergence]]. This may on occasion prevent the solver from stopping (iterations continue after convergence).
* New option for managing graphics display for Tears. The graphics symbol for the [[Tear]] can be incorrectly located based on previous actions in redrawing and moving links. New graphics [[Display_Graphics_Commands#Display|Display]] menu option "Graphic|Display|Update Tear Graphics" will recreate all Tear graphics on a flowsheet. This is also available under the Display button in a [[Group Operations]] dialog to apply to multiple flowsheets.
* Correctly use the "Link Text Size" defined in [[General Options Drawing]] when creating Makeup or Discard link graphics.

===Build 30376===
:''Released 15 February 2022
* Updated new Volume based Wash Efficiency options in [[Filter Press]] introduced in Build 30316.
* For [[TCE]] Reactors added FeedT OpMode to perform calculations at SysCAD feed stream temperature.
* Fix failure when editing cfg file for [[TCE Configuration Options]].
* Further reductions in memory use for SysCAD projects.
* Fix error in [[Feeder]] with Mode set to NVolumeFlow with a Fetch. The targeted NQv was not achieved, or only achieved in subsequent iterations.
* Allow [[Precipitation3]] to be a network isolator in Dynamic models.

===Build 30316===
:''Released 4 February 2022
* Implemented additional Wash Efficiency (WashEffMethod) options in [[Filter Press]] for Volume based calculations. Expand results display to include additional volume based efficiency results.
* Fix for crash in [[Precipitator3 Dynamic Mode]] edge case where no solids.
* Reduced memory use for SysCAD projects.

===Build 30270===
:''Released 1 February 2022
* Reduced memory use for SysCAD projects (especially for Steady State).
* For [[Plant_Model_-_Environment|PlantModel Environment]] improved '''DryAir''' functionality to include option to always use composition based on CIPM-2007 Standard Air definition.
* For all [[Thermodynamic Calculation Engines]] (TCE) the ModelCfg includes a new section listing all Unit models using this TCE ModelCfg. Ideal to follow usage of the Chemistry Model Configuration in the project flowsheets.
* For all [[Thermodynamic Calculation Engines]] (TCE) improved functionality for the selection in TCE unit models (ChemModel.UnitTag) of Model Configuration used to allow a blank selection. Provides significantly easier management of changing Chemistry Model databases for use in different unit models.
* For [[ChemApp Overview|ChemApp]] TCE, improved upgrading of Build 138 projects for ModelCfg cst databases used. Fixed issues for use of CFE token species in CST files.
* For [[AQSol Overview|AQSol]] TCE, allow entry of larger SaturationIndex values to block formation of selected solids. Improved Cfg editor to automatically mark Demo version when selecting AQSol001.
* For [[Plant_Model_-_Species#SpUse_(Species_Use)|Species Use]] (SpUse section) on Species tab page of PlantModel, added a button to report list of all species referenced in all reaction (RCT) files. List is built at project load.
* Miscellaneous [[Explorer Window]] improvements.
* For [[Tear]] added Tear.ConvergeType tag and improved links to related tags. For [[Solver Setting - Tears]] fixed links to Tear tags.

===Build 30140===
:''Released 12 January 2022
* SysCAD [[AQSol Add-On]] now included as part of standard installation. Existing users of AQSol in SysCAD no longer need to download and unzip this add-on separately.
* Full install includes 3 new [[Example - 08 AQSol Projects|AQSol example projects]].
* New [[Reaction Editor]] (Version 1.4), with new options and improvements for balancing reactions.
* [[Makeup Source]] has new option '''Operation''' similar to the [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option. This significantly improves flexibility of how the MakeupSource composition, T & P can be defined.
* Improvements in [[Find_Units_using_Query|Find Results]] dialog - Sort by column now works correctly, value in first row uses correct conversion units.
* In [[Reactor (Gibbs FEM)]] add displays of individual Heats Of Reactions (HoR), as well as overall change in Hf@0 (which is equal to overall HOR when no EHX or temperature override).
* Additional displays on [[SDB - Elements]] tab page for list of elements used, and on [[SDB - Components]] additional displays when multiple components with the same elemental definition.
* For PGM [[Species Database Class]] added functions for accessing Elements used in the project: FindElem(Str ElemName), ElemCount(), ElemName(long ElemIndex), ElemAW(long ElemIndex). In addition added function [[Predefined_Functions#Species_Functions|ElemI("ElementName")]].
* For PGM implemented new function [[Class - Macros|ForEachClass]] to efficiently loop through all instances of a class type calling a specified Subroutine.
* For [[Precipitation3]] implemented new "EnthalpyCalcs" option that gives finer control for energy balance calculations for Heats of Reaction for the different precipitation reactions. Functionality is dependent on data entry of H25 and Cp equations for participating species.
* Implemented some improvements in [[Importing_Species_into_User_Species_Database#Importing_Species_from_HSC_Database|importing species from HSC]] for illegal characters in species names.
* For [[Plant_Model_-_Environment|PlantModel Environment]] added option to define DryAir composition in addition to Air. DryAir can be specified on mass or mole fraction basis and will always have zero for H2O(g).
* Added new [[Feeder-Cross_Page_Connector#Feeder_Operation_Selection|Feeder Operation]] option "PlantModel DryAir" that uses global DryAir composition specified in [[Plant Model - Environment]].
* Fix for bug when using [[Reaction_Block_-_Extents#Reaction_Extent_:_Calculations_and_Properties|RB Extent]] method "Final SpModel Property : Standard.BPE".
* Improved logic for [[Heat_Exchanger_(HX)|Tank HX]] Mode "Simple" selections. Improved error reporting and edge case tests. When water is present, limit maximum outlet temperature to H2O critical temperature. When used with "Other.CalcFlow" the general demand logic has been improved to demand zero flow when inoperative.
* Numerous [[Thermodynamic Calculation Engines]] (TCE) improvements. Includes: improved routine for loading data; improved handling & reporting of edge cases; reworked TCE mixing (calculating total feed enthalpy); other miscellaneous improvements & fixes.

===Build 29945===
:''Released 29 November 2021
* Fix for crashes using [[AQSol Add-On]] demonstration version.
* Fix for [[Access Window]] "go to previous" button.

===Build 29907===
:''Released 23 November 2021
* Improve calculation for pass through [[Demand]] through a Tie/Tank/Pipe/etc. that includes [[Discard Block (DB)]].
* Updated editing of [[TCE Configuration Options]]. Settings for AQSol have changed. Existing AQSol projects will require review of TCE settings in cfg.
* Fix in dynamic mode Feeder where [[Feeder-Cross_Page_Connector#Batch_Feed|Batch]] tags were hidden.
* For graphics [[Insert_Graphics_Commands#Insert_Symbol|Insert Symbol]] and [[Insert_Graphics_Commands#Insert_Unit|Insert Unit]] a new Search box has been added to help find the desired graphics symbol. This is particularly useful with Group set to *All*.
* Improved options for Arrow Style and Scaling when editing graphics using [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]], [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]], etc.
* Display the correct status colour in graphics for [[Feeder]] configured with Operation "Link to MakeupSrc".
* Fix for project close crash if project contained a reaction rct file that failed to load. Improved warning condition message for [[Reaction Block (RB)]] rct file load errors.
* Fix for crash in [[Excel Reports]], reporting some tags that are dropdown lists.
* Fix for crash running SysCAD [[Command Scripts]] that start with the command WaitTillStop.
* Miscellaneous improvements in computational efficiency and memory use in stream mixing and property calculations.

===Build 29722===
:''Released 27 October 2021
* Fix for error introduced in Build 29706 for for [[Tank_-_Dynamic_Mode|Dynamic Tank]] with Vent connection that produced a mass balance error for vent outlet.
* Improved implementation of Entropy function for [[Plant_Model_-_Species#Water_properties_below_0C|water below 0°C]].

===Build 29706===
:''Released 22 October 2021
* Allow tighter tolerances in [[RB]] Extent and Convergence calculations. Default tolerances are tighter (for existing projects you will need to edit each RB to change existing values). Using tighter tolerances allows Concentration reaction extents to achieve results closer to the target by a few more significant figures by solving a few extra iterations to meet the tighter tolerance.
* Improved calculations for [[Reaction_Block_-_Individual_Reactions#Display_Additional_Reaction_Information|RB ShowSpRequirements]] option implemented. In some cases, the displayed amounts of species flow required to exactly meet the reaction extent were incorrect (and are fixed in this update). This improves robustness in use of feed forward controllers using these tags to adjusting reagent additions.
* Improved checking and error reporting for selection of water species in [[Reactor (Gibbs FEM)|Gibbs FEM]] when any aqueous species are selected.
* [[Thermodynamic Calculation Engines]] (TCE) improvements - SideCalc pressure selection; Copy&Paste in Direct Calc; TCE Databases used now included in project file list and backup zip files; miscellaneous improvements in Access window result displays.
* Updated cfg editor for [[TCE_Configuration_Options|Thermodynamic Calculation Engines Configuration]] settings. Can now browse for the folder where the TCE databases are located and select the databases you want to make available in the project. No longer need to edit these in the cfg file manually. Database list is auto-upgraded, but in some cases you may need to edit the cfg file and check the selections on the TCEs tab page.
* Implemented new "Isentropic Full" constant Entropy method for [[Compressor]].
* For large projects: (1) fix save error for large number of graphics pages; and (2) fix error for selecting cross page connection "ConnectTo" for a large number of sinks.
* Fix error for reported enthalpy values for species using [[Species_Table_-_Specific_Heat_(Cp)#Shomate_Equation|Shomate_Cp]].
* Implemented new PGM function [[Conditional_Functions#IIfStr|IIfStr]] for returning String data type, similar to inline function [[Conditional_Functions#IIf|IIf]] returning a numerical result.
* Fix error on first solve when converting SteadyState ProBal projects to Dynamic.
* Dynamic mode [[Tank_-_Dynamic_Mode|Tank]] using [[Tank_-_Dynamic_Mode#Layered_Flow|Layered]] Mixing.Model now supports multiple inlets at multiple heights adding material to the layer located at the inlet stream connection height.
===Build 29552===
:''Released 22 September 2021
* Improved user experience when working with multiple projects and cfg files. When editing or selecting a project [[Project_Configuration_(cfg_File)|Configuration (cfg) file]] there is a new "Last Accessed" column showing when a cfg file was last used (i.e. used by a project load, or cfg file edited). Select any column header to sort by the column.
* Improve project load and save to support a large number of [[RB]] reactions (and associated reaction species).
* Significantly improve implementation (speed) of setting bulk tags using [[COM Automation]] API function TagValues.SetValues(...).
* Fix for [[Save_Project#Save_Version|Project Save-As / Save-Version]] where selected unused (un-referenced) files were not copied across to the new project folder.

===Build 29506===
:''Released 14 September 2021
* All [[Historian]] files are now all located in a sub-folder of the project. On first project save in this Build, the existing historian files are moved to the new "Historian" folder resulting in a more organised project folder.
* [[Reactor (Gibbs FEM)|Gibbs FEM]] "Assign Phases" action button updated to apply to all species rather than selected species only.
* Improvements for '''condensing''' mode '''with non-condensables''' for [[Shell and Tube Heat Exchanger 2]]. For two of the [[Shell_and_Tube_Heat_Exchanger_2#Method:_Condensing|CondensingMethod]] options ("Demand (UA)" and "Demand (UA & TubeT)") when non-condensables are present in Shell feed, the model was evaluated at total pressure (SatT@P) instead of at partial pressure (SatT@PP). This causes a difference (proportional to non-condensables fraction) in shell operating temperature and heat transfer. For backward compatibility an option "IgnoreNoncondensables" is provided. A warning message is given when non-condensables are present and the old method (using total P) is used to alert the user to this condition. In these cases the recommended fix is to switch off "IgnoreNoncondensables" and resolve/retune the model.
* Fix for [[TagSelect]] reports not reporting correct [[DirectLink]] tags in results.
* Improvements in PHREEQC: output calculated gas fugacity, improvements in managing gas pure phase solubility calculations. Note that SysCAD-PHREEQC interface only supports pure phase gas solubility at this time. Thus, for any gas solubility to be calculated correctly, it must be the only gas present in the vapour phase. For insoluble gases, such as N2, the error is small if it is in a vapour mixture. However, the error is large for reactive and/or soluble gases, such as O2 and NH3, when in a vapour mixture.

===Build 29465===
:''Released 6 September 2021
* For graphics [[Edit_Graphics_Commands#Redraw_Link|Redraw Link]] and [[Edit_Graphics_Commands#Reroute_Link|Reroute Link]] improved logic and user interface when selecting a "non standard" (i.e. "constructed") pipe graphics.
* New option in pipes to block [[Pipe#General_Demand|demand transfer]] when the required demand flow (Qm_Demand.Dst) is small (less than PlantModel.DemandThresholdQm).

===Build 29437===
:''Released 1 September 2021
* Implemented new user option to zip a project. This is available in main Project menu - [[Zip Project]] or from 'Zip Project' button in [[Project_Window#Files_List|project window]] (on Files tab page).
* For [[Models#Mass_Separation_Models|Separation Models]] (Thickeners, Filters, SolidsRecovery, etc.), added optional outlet stream displays for QOF, QUF, QCake, QTailings, etc.
* If underlying data type of a [[Access_Window#Drop_List|drop list]] is a string (e.g. XPG_001.ConnectTo P_001.EHX.Model), then do not show RHS integer values in displayed dropdown list. The purpose is to make it clearer that tag can't be set by integer value from PGM, Excel, etc. In addition, the tooltip window shown when mouse hovers over the drop list field includes 'Underlying tag is a String type' in description.
* In Access window, when using [[Access_Window#Right_click_on_Access_Window_variables|context menu]] option "[[Copy_and_Paste#Copy_Tag_For_PGM|Copy Tag for PGM]]" for any string tag (including dropdown list with underlying string) the clipboard value is now [Str "fulltag"].

===Build 29390===
:''Released 27 August 2021
* Implemented locks to prevent multiple users (or SysCAD instances) of the ''same'' project (i.e. same local or network folder location) being saved simultaneously and corrupting the project data. Also delay (or prevent) project load if another user is busy saving.
* For [[Models#Thermodynamic Calculation Engines|Thermodynamic Calculation Engine (TCE) Models]], added new options for selecting actions to be followed when encountering unmapped species for forward- and reverse-mapping.
* [[Alumina3_Precip_-_Full_PSD#Agglomeration|Precipitation3 Agglomeration]] - include power term for solids volume fraction in Agglom kernel. Added fine tuning factor.

===Build 29370===
:''Released 25 August 2021
* '''First full release of Build 139.''' See [[Build 139 Release Notes]] for full list of changes and new features

===Build 29334 (BETA)===
:''Released 19 August 2021
* Improved support and error handling for very long full path and filenames, especially for errors caused by loss of graphics flowsheet pages.
* Improved Alumina [[Precipitation3|Precipitator3]] Agglomeration options including new [[Alumina3_Precip_-_Full_PSD#Kernel_Builder|Kernel Builder]] options.
* Fix for [[Feeder-Cross_Page_Connector#Composition_Fetch|Composition Fetch]] where the entered tag was from a [[Discard Sink]].
* Correctly handle energy balance (exit temperatures) in [[Reverse Osmosis (RO) Unit]] where heat of dilution occurs.
* [[EHX]] methods in pipes in dynamic mode that specify pipe diameter and length, now correctly use these values (they were ignored).
* Some improvements in [[Copy_and_Paste_Graphics_Commands|Copy & Paste]] of flowsheet graphics and data.
* During project load, added an extra user feedback message on Species Database tab of [[Message_Window#Species_Database_Tab|Message Window]] for when user has selected "[[Species_Properties_Configuration#Selecting_Hardwired_or_User_data_for_Properties|Ignore Data]]" for a species property in the cfg file.
* Miscellaneous Beta version bug and feature fixes.

===Build 29199 (BETA)===
:''Released 28 July 2021
* Bug fix for [[Edit_Graphics_Commands#Change_Unit|Change Unit]].
* New optional Vent outlet connection for [[Reactor (Gibbs FEM)|Gibbs FEM]].
* Improved organisation of Access window tags and options in TCE Models Configuration for species mapping.
* Limit pH output to 7.0 for [[Standard_Species_Model#Acidity_.28pH.29_Calculations|Acidity (pH)]] calculation for very low OH- or H+ concentrations.

===Build 29102 (BETA)===
:''Released 15 July 2021''
* Log and debug files now go to project subfolder ''\LogOutputs''. If opening multiple copies of same project, additional folders are created to avoid conflicts.
* Improved handling for very large (>300) number of graphics/trend pages.
* Additional [[Reactor (Gibbs FEM) | Gibbs Free Energy Minimisation (FEM)]] warnings when S25 for species is not specified.
* Improved TCE loading, multithreading, Ion Mapping and error handling.
* [[Ion Definitions|IonList.txt]] file used in TCE projects must now be located in the CfgFiles folder. If file is missing, the file located in BaseFiles folder is copied to CfgFiles folder. For TCE projects IonList.txt is now included in backup zip file with project save and displayed in list of files in Project window.
* New option ''BulkSetTagsValidation'' in [[General Controller]] (default ON) which affects how all tags are set in referenced models at the end of PGM execution. If new option is ON then validation of model tags data occurs '''after''' setting '''all''' the values. If this option is OFF (original behaviour) then after each tag value is set, the data is immediately validated. The new option is more efficient and fixes error for setting interdependent tags (e.g. species composition fractions in a feeder).
* For new low temperature (below 0C) Cp and Density implement options on [[Plant_Model_-_Species#Water_properties_below_0C|PlantModel.Species]], implement logic to initialise correctly based on original project temperature range.
* Updates for new [[Material Body]] model.
* Simplified [[Solver_Set_up_for_Dynamic_Projects|Dynamic Solver Setup Dialog]] and related tags in [[Solver_Setting_-_Method|$Solver Method tab page]] simplified options. Removed StepsPerUpdate option. Added user specified min and max dynamic step sizes.
* When using a species model other than Standard in a [[Makeup Source]], then the [[MU|Makeup Block]] now selects Makeup Source SpModel if the feed to the MakeupBlock is using Standard SpModel.

===Build 28898 (BETA)===
:''Released 10 June 2021''
* See [[Build 139 Release Notes]] for full list of changes and new features
* Please [mailto:info@syscad.net contact us] for BETA access