This article summarizes the fixes and enhancements included in the OLI Software V12.6 release, organized by product.
Table of Contents
OLI Flowsheet
Bug Fixes
Fixed Error with Missing Stream Name in Navigator
A process error occurred when a stream had a missing name, leading to a failure message indicating the stream was not present in the navigator. The error message specifically mentioned the stream with a name mismatch between its graphical PFD representation and the BIN file. This disparity caused confusion and errors when attempting to process the simulation. Changes have been made to ensure that the error window displays the full, correct object name rather than a truncated version, helping users to identify and resolve issues more effectively.
Reference ID: 1491
Resolved Inconsistent Values in Custom Calculation Grid
We corrected an issue where the output grid did not reflect the updated value in a custom calculation scenario. Users setting the total volume and adjusting inflow will now see consistent values between input and output grids, ensuring clarity in calculations.
Reference ID: 1519
Improved Error Display for Model Generation Failures
Previously, when a model failed to generate in the software, users encountered difficulties diagnosing the issue due to the lack of error messages. The error window did not provide details, making it challenging to understand the problem. This update ensures that error messages from dynamic models are now clearly displayed, assisting users in pinpointing and resolving generation issues more effectively.
Reference ID: 4827
Fixed Display Issue for Custom Properties in Restarted Simulations
When the option for simulation restart optimizations was activated, users sometimes encountered a '?' symbol instead of the expected values for Custom or User-Defined Properties during repeated simulations. This issue could lead to uncertainty for those who use these properties to track or verify model results, particularly when aiming to minimize runtime with restart optimizations. The expected behavior is that these properties should display correctly in every run, irrespective of optimization settings. Previously, once the optimization was enabled and the case was re-executed, the correct property values were not consistently displayed in later runs. To avoid this, users had to turn off the optimization, which could greatly increase the simulation time. Addressing this issue was important to ensure performance improvements did not compromise output reliability. The update has now resolved this by correcting the display behavior of these properties in cases of optimized restart simulations.
Reference ID: 4903
Resolved Crash Issue When Copying and Pasting Subflowsheets
We addressed a critical issue where the software crashed after copying a subflowsheet from one simulation and pasting it into a new one. This crash occurred upon attempting to open the pasted subflowsheet. Previously, users experienced disruptions due to this problem, which affected their ability to reuse existing configurations effectively. As a temporary workaround, removing callouts in the subflowsheet allowed users to copy and paste without crashing. With the recent fix, the stability of the subflowsheet copy/paste functionality has been improved, and the layout displays correctly when the pasted subflowsheet is opened.
Reference ID: 5208
Subflowsheet Inlet Stream Disconnection in Version 12.6
When using version 12.6 of the program, subflowsheets constructed in version 12.5 experienced an issue that caused their inlet streams to become disconnected. To observe the problem, users could open a simulation file in version 12.5 and see that the inlet stream was correctly connected. However, when the same file was uploaded and opened in the 12.6 alpha instance, the feed stream showed a disconnection along with an error message indicating a missing required inlet. This issue became apparent while implementing a particular story during development.
Reference ID: 5230
Refined Virtual Stream Source Handling
We improved the handling of virtual stream sources to ensure that changing the source does not automatically enable simulation restart optimizations. This adjustment allows for smoother recalculation processes when the source of a virtual stream is updated.
Reference ID: 5597
Prevented Case Corruption from Stream Copy-Pasting
Resolved an issue where case files were becoming corrupted in the program due to copy-pasting streams that originated from a water analysis. The root cause was identified as a failure to correctly reset the chemistry model of the water-analysis stream when pasting. This fix prevents future corruption, though existing corrupted cases remain unchanged.
Reference ID: 5715
Resolved Program Crash on Survey Execution
We addressed an issue where the software would abruptly close when running a survey on specific scenarios, previously causing users to miss error messages. The program now captures errors effectively, preventing unexpected exits and improving the overall stability during such operations.
Reference ID: 5806
Improved Stability for Virtual Stream Connections
The Flowsheet component has been improved to ensure that streams connected to Virtual Stream orbs no longer disconnect easily during normal operations. Previously, when a Virtual Stream orb became disconnected, users had to delete and recreate the setup, leading to disruptions in workflow and potential errors. The update addresses this issue, providing a more stable connection and allowing users to reattach streams without needing to rebuild the setup, thus preserving configuration efforts.
Reference ID: 5829
UI now flags controllers linked to unconnected streams
Previously, the interface did not validate controllers connected to streams without block connections, leading to errors during simulation execution. When running, input files were generated and processed by the engine, but would result in errors due to the invalid setup. The updated behavior requires the UI to verify that streams linked to controllers are properly connected within the flowsheet. Any controller pointing to a disconnected stream now triggers an error message and blocks execution, preventing invalid configurations from being processed by the engine.
Reference ID: 5835
Editing OLI public databases with correct credentials enabled
Users faced difficulty in editing or viewing parameters in OLI public databases despite having valid passwords, as only encrypted 'dots' appeared. This issue was linked to not being correctly connected to the OLI domain. The update introduced methods to verify OLI domain and Azure Active Directory join status, allowing users to successfully access and edit data.
Reference ID: 5893
Subflowsheet Inlet Disconnection in Version 12.6
In version 12.6, subflowsheets that were initially constructed in version 12.5 experienced disconnection of their inlet streams. This issue was observed when opening a simulated project, which had its streams correctly linked in version 12.5, in the 12.6 alpha version. Upon attempting to load such projects in 12.6, users encountered an error indicating a missing required inlet in the portal, which had not been present in the previous version. This problem was noted during the implementation of a specific feature change.
Reference ID: 6062
Fixed Confusing Database Selection Error in MSE-SRK Cases
Previously, running a corrosion calculation in MSE-SRK incorrectly showed an error stating that the Corrosion (MSE) database was not selected. This error confused users, even though the database was selected and the corrosion rate results were consistent between MSE and MSE-SRK. We have revised this error message to improve clarity and user experience.
Reference ID: 6251
Corrected solids warning in induction time calculation
An issue was resolved where the system incorrectly displayed warnings about precipitated solids invalidating induction times, even when the suspected scale's solids were disabled in the chemistry model options. This problem occurred during temperature and composition surveys with an inhibitor. The error messages have been reviewed and corrected to prevent them from appearing when solids are disabled as intended.
Reference ID: 6480
Enhanced Handling of Excessive Inhibitor Concentration
Implemented a feature to automatically detect and suppress warnings when inhibitor concentrations are excessively high, ensuring smoother operation and minimizing unnecessary alerts.
Reference ID: 6485
Cannot link OLI 12.6 with Aspen Plus via the configuration tool, Update Tool button indicates most current version
Cannot link OLI 12.6 with Aspen Plus via the configuration tool, Update Tool button indicates most current version
Reference ID: 6524
Resolved Issue with Single Point Calculations in Analyzer Tester
The OLI Studio Analyzer Tester previously experienced issues where it could not evaluate two specific calculations, resulting in an error message. This was due to compatibility issues with files created in a prior version of the software. The process involved selecting a certain database file and running tests on specific case IDs using a newer version. This update addresses the error, ensuring successful evaluation of these calculations.
Reference ID: 6539
Fixed crash in Studio during vapor fraction calculation
Resolved an issue where the Studio program crashed during vapor fraction calculations in the Analyzer Tester. Previously, selecting a specific test case involving vapor fraction caused the application to become unstable and terminate unexpectedly when running calculations. The problem was linked to an incorrect method call related to vapor phase type settings. This update ensures stability and prevents crashes under the same conditions.
Reference ID: 6540
Resolved AQ Framework Calculation Differences
We addressed the discrepancies reported in the results of the 'Base Survey' calculation between OLI Studio Versions 12.5 and 12.6. The calculation, which uses the AQ framework, unexpectedly showed variations. The issue stemmed from flagged 'Tags' in the differences file that were not initially understood. We corrected the surface species value comparison in the Analyzer, and added support for the parts per million unit.
Reference ID: 6542
Unexpected Differences in Corrosion Model Calculations Detected
OLI Studio Analyzer Tester identified discrepancies between results in OLI Studio Versions 12.5 and 12.6 for Thermal Aging Corrosion Rate calculations. These were unexpected, as the AQ framework was used, which should not have introduced changes. The issue raised questions about whether alterations to the AQ Corrosion model or database updates accounted for the observed differences.
Reference ID: 6545
Enhancements & New Features
Scaling Index Now Selectable in Contour Plots
Previously, the Scaling Index was not an option for contour plotting in OLI Studio, with users limited to accessing it through tabular data. Contour plots only included related properties like Scaling Tendencies or Total Solid Concentration. This update enables the Scaling Index, specific to solid phases like Calcite or Halite, to be chosen as a contour variable. Users can now select it under the 'Scaling Tendencies' or a new dedicated category. The enhancement ensures it handles undefined regions, such as undersaturation zones, proficiently while aligning with current contour plotting behavior.
Reference ID: 6143
Include Reporting of All Calculation Result Changes in Studio Analyzer Tester
The OLI Studio Analyzer Tester now reports any added or removed calculation results for all calculations, regardless of whether they exceed the user-defined absolute or relative error tolerance values. Previously, the tool only provided this information for calculations with results that surpassed the error tolerance thresholds. This enhancement ensures a comprehensive overview of all calculation result changes in the new OLI Studio version.
Reference ID: 6581
OLI Databook
Enhancements & New Features
Enhanced Databook Validation for ASID and Chemical Formula
The databook program now includes improved validation checks to ensure necessary data is entered. The Chemical Formula field must be filled out in the general table without exceptions. For system databanks, ASID requirements are enforced: the general table needs an ASID if the species has an Aqueous or Vapor phase, and the Solid phase requires its own ASID, all in uppercase. Additionally, all fields in the Material Code Table must be completed. This update involves UI refinements and bug fixes in tree navigation, form verification, and database operations, preventing navigation if there is unsaved or invalid data.
Reference ID: 1612
OLI Studio, Flowsheet
Bug Fixes
OLI Studio - ASSAY entered using D2887 throws and error. SME's at OLI think it is unealistic error
OLI Studio - ASSAY entered using D2887 throws and error. SME's at OLI think it is unealistic error
Reference ID: 3399
Enhancements & New Features
Expanded Chemistry Model Options Window in Studio
The Chemistry Model Options window in Studio was widened. This change ensures that users can view most solid names without excessive scrolling or truncation, improving the user experience.
Reference ID: 1671
New Functionality for Automatically Adjusting Scaling Tendencies
We introduced a new feature for automatically updating scaling tendencies in OLI Studio. This functionality, previously available in another part of our software suite, allows users to set minimum and maximum scaling tendency values. The system then automatically adjusts active solids based on these specified values, enhancing ease of use and reducing manual updates.
Reference ID: 1774
OLI Studio
Bug Fixes
Unit Display Correction in Studio's Mixer Inlets Summary for Batch Mode
In Studio, we have corrected the Mixer Inlets Summary to display only mol and L when operating in batch mode. Previously, the units were shown as mol/hr and L/hr, which was inconsistent with batch processing conventions. This issue was identified during a training course and has now been fixed. The report will match user expectations by showing units appropriate for batch processing. This change ensures clearer and more accurate data representation in batch mode.
Reference ID: 3422
Resolved Crash When Copying Stream with Assays in Studio
Studio encountered a crash when performing calculations after a FESP stream with two assays was pasted. The crash was linked to the length of pseudo component names generated from the assays, which caused conflicts in Studio. By replacing invalid tags with suitable identifiers, while keeping user-defined names intact, we resolved this issue. Users should now be able to paste streams and run calculations without crashes.
Reference ID: 4604
Fixed Crash When Opening Files in Studio 12.0
In Studio version 12.0, attempting to open certain files caused the application to close unexpectedly due to an error message stating 'Encountered an improper argument.' This issue has been resolved to ensure files open normally without causing the software to crash.
Reference ID: 4783
Resolved Program Crash in Chemical Diagram Calculation
A crash issue was identified in the Studio program when performing calculations within the chemical diagram, specifically in the Species vs. Species section. This occurred when an acid titrant could not sufficiently adjust the stream's pH to the initial value of 0, stabilizing only around pH 4-5. The instability, potentially linked to limitations in pH range handling, compromised data rendering near 99% completion. Users can circumvent this by setting the starting pH to 5 instead of 0. We recommend displaying a warning if the pH range falls outside the stream's viable chemistry range.
Reference ID: 4785
Issue with Saturator Performance under Rigorous TDS Conditions
The saturator component in Studio exhibited performance issues under rigorous TDS conditions. It was observed that the tool functioned correctly when the 'Calculate Alkalinity' option was enabled. Conversely, disabling rigorous TDS allowed the saturator to operate normally. These inconsistencies were investigated to understand why the saturator runs successfully when both 'Calculate Alkalinity' and rigorous TDS are active, but struggles when only rigorous TDS is active without 'Calculate Alkalinity'. The underlying issue seemed to be linked to a failure in the rigorous TDS process, prompting a fallback to estimation, without providing an adequate failure message.
Reference ID: 4791
Output Grid Erroneously Showed 'Estimated' for Rigorous TDS
In a specific scenario, selecting rigorous TDS for calculations resulted in the output grid incorrectly displaying 'Estimated'. This occurred despite the rigorous TDS being expected to be used. Initially, the default setting for TDS is 'Estimated'. Changing the calculation option to rigorous TDS and executing the case still led to the display issue. It appears that rigorous TDS failed and defaulted to the estimated value, yet the failure message was not shown.
Reference ID: 5034
Resolved Crashes During Facilities Copy-Paste in Studio
We fixed an issue in OLI Studio where the software crashed when users attempted to copy and paste a Facilities object. The problem originated from invalid object identifiers being retained in saved files, causing the program to malfunction when accessing these elements.
Reference ID: 5067
HC Saturator Icon Issue Resolved in Studio
In OLI Studio, the previous issue where the 'Add HC Saturator' appeared as a blank icon when 'Enable Features under Development' was activated in options has been addressed. This icon, which was not linked to any functional code, has now been removed to improve clarity and functionality.
Reference ID: 5239
Fixed Export and Import Issues with OLI Databook
Resolved an issue where exporting and importing species with Helgeson parameters did not function correctly. For interaction parameters, a problem was corrected where failing to enter a zero for a specific field led to value misalignments in the parameter column after exporting and importing the entire private databank species.
Reference ID: 5974
Resolved Inconsistency in Mass Unit Calculation for Studio
We addressed an inconsistency in OLI Studio where the calculated amount of the formate ion in the Brine Composition chart aligned perfectly with the Element Balance chart in the default unit basis. However, when users switched to a mass unit basis for liquid composition, the results between these two charts did not match. This discrepancy was fixed to ensure consistent results across different unit bases.
Reference ID: 6049
MgCO3 Component Added to 12.6 MSEPUB Databank
Previously, running cases in OLI Flowsheet involving MgCO3 chemistry resulted in a simulation start error due to the absence of the component 'MGCO3' in the selected databanks. The missing component issue has been resolved by adding MgCO3 information to the 12.6 MSEPUB databank, allowing simulations to complete without errors.
Reference ID: 6122
Resolved Warning Bar Issue in Simulation
An issue was resolved where a yellow warning bar appeared upon reopening simulations that were previously saved after a run. This problem affected multiple simulations and was consistent across different scenarios. Now, reopening and running simulations no longer triggers this warning message.
Reference ID: 6161
Disabling Copy for Existing Scale Contours
The option to copy an existing scale contour setup was disabled, effectively preventing users from duplicating prior configurations effortlessly. This change aimed to increase the accuracy of setups by eliminating potential errors from duplicating complex configurations, though it required users to manually recreate configurations, potentially affecting workflow efficiency.
Reference ID: 6207
Resolved Issue Causing Crashes in Databook When Entering Species
A crash was fixed in the species list dialog that occurred while attempting to search and re-enter certain species such as LiAlSi2O6, CaSO4, and CaSO4.2H2O in both AppStream and desktop beta versions. Earlier versions were unaffected, and the issue also resulted in stray characters in search results. The problem was identified during the handling of the list view notification and has now been addressed.
Reference ID: 6380
Issue with Opening Files in Beta Version Resolved
We addressed an issue where files created in version 12.5.32 of the OLI Flowsheet could not be opened in the beta version 12.6.9. The complication arose when a stream, copied and pasted repeatedly from a water analysis-backed stream, led to corrupted cases. This fix ensures seamless file accessibility across different versions.
Reference ID: 6635
Enhancements & New Features
Implemented Charge Balance Error Calculation
Studio now calculates the Charge Balance Error (CBE) to assess brine chemistry reliability. The CBE calculation is based on the formula: (cation charge - absolute anion charge) / (cation charge + absolute anion charge) * 100. This additional metric appears alongside the ion imbalance value in the interface. The CBE is displayed on various Studio pages and reports, ensuring users have easy access to it. Functions were introduced to compute and format the CBE for consistent use across the application.
Reference ID: 5714
General
Bug Fixes
Fixed PKG File Upload Issue in Version 12.6
Previously, users experienced a problem where PKG files that uploaded successfully in version 12.0 could not be uploaded to the cloud in versions 12.5 and 12.6. This issue has now been resolved, ensuring seamless uploading in version 12.6. The problem involved a specific process check, which has been corrected to handle user-defined calculations accurately, as addressed in the latest fix.
Reference ID: 6070
Resolved Visibility Issue with Beta Version in Aspen Hysys
The OLI Engine configuration tool within Aspen Hysys did not display the 12.6.9 Beta version, causing difficulties with linking it to Aspen Hysys V15 and halting testing processes. This issue has now been addressed, ensuring the beta version is visible and test activities can proceed smoothly.
Reference ID: 6527
OLI Engine Aspen Hysys
Bug Fixes
Resolved detection issue for Aspen Hysys V15 in Configuration tool
Aspen Hysys V15 was not appearing as a detected product with the OLI Engine 12.6.9 (Beta) Configuration tool. The detection mechanism was updated by ensuring that an empty detection value now defaults to key-existence-only, effectively enhancing detection for Aspen Hysys versions 11 to 15. Additionally, the product list functionality was improved by addressing the checkbox option to show all products. The popup for linking has been replaced with a detail-oriented warning message to guide users effectively.
Reference ID: 6526