Critical

1. Modified batch runs to report errors when an unhandled exception occurs. Batch runs may now continue if the unhandled exception occurred while loading or running the model file.

2. Fixed an error where Parametric Study would clear the user-defined value after the run rather than restoring it as expected.

Important

1. Improved functionality of warning icons on unit drop-down lists when units in the model file are excluded by personal user preference settings.

2. Fixed an issue where an inactive unit warning icon could display on the Graph Controls and shift the interface, making some graph options inaccessible with no scroll bar.

3. Fixed an issue in the Pipe Materials Library edit form where the Delete and Rename buttons were inoperable.

4. Fixed an issue where View->Show Object Status would always be disabled in the Toolbar.

5. Fixed an issue where creating a Design Alert from Output could throw an exception for some object types.

6. Fixed an issue where splitting a pipe at intermediate elevations caused it, and any subsequently created pipes and branches, to not be initially visible in Layers.

7. Fixed an issue where selecting junctions from Workspace selections in the Global Morph window would throw an exception.

8. Fixed a case where output would be incorrectly cleared after clicking Cancel on the confirmation pop-up, triggered by moving pipes or junctions on the workspace.

9. Improved selection logic so that selections from Model Data grids are used when launching Global Edit from Model Data tab, rather than Workspace selections.

10. Fixed issues with parameters of dynamic unit type in the internal API. The outward effect of this error was that the Parametric Study would not always correctly set or reset parameters with a dynamic unit type. The change also indirectly fixed pipe parameters not being correctly reset to their original values by the Parametric study.

11. Resolved conversion error popup in xStream when selecting “Graph Results” from Solution Progress window.

12. Fixed a calculation error for Difference Exit force sets using the option for "Point Force Ambient Pressure = Use Atmospheric Pressure from Environmental Properties". It could incorrectly use zero absolute pressure instead of the proper value and units from the Environmental Properties (1 atm by default).

Minor

1. Fixed an issue where Event Messages by Junction were not listed in junction order.

Changes that may affect engineering conclusions

1. Fixed an issue where User-Specified Valve Equivalent Loss values would be unused and overwritten in the simulation.

2. Fixed an issue in which choked branches would appear to cycle between choked and not choked.

Important non-engineering changes

1. The Specify Properties button was missing on the Pipe Material Library window.

2. Improved performance related to clearing Output once Output no longer exists - some Output clearing actions were happening repetitively when they only needed to happen once per clearage.

3. Fixed issue with Split Pipe feature not correctly connecting pipes to new junction.

4. Fixed an issue that would check out a duplicate Chempak Data license seat if the Chempak Viewer was launched while Chempak fluids were already in-use in the main application.

5. The first row of the transient data table for junctions is no longer cleared when switching to event based transients.

6. Fixed a case where the Force Set Problems window would incorrectly appear for force sets containing a branching flow path.

Miscellaneous changes

1. Some language localizations files had blank Workspace Layers abbreviation translations, resulting in Workspace labels with no corresponding abbreviation for the parameter value. Standard English abbreviations were added to the files for any parameters that had blanks in this field.

2. Fixed an issue when creating a Design Alert from output cells would cause system error.

Changes that may affect engineering conclusions

1. Fixed bug where valve opening transients dependent on K factors would cause artificial transients in xStream.

2. Fixed bug where xStream didn't correctly determine junctions to be restriction choking during the transient run, ending the run early.

3. Fixed issue with estimating sonic velocity for sectioning with real gases.

4. Fixed a bug where reverse flow restriction choked junctions in steady state output would compute results in the user-specified upstream (flow-direction downstream) pipe incorrectly, and warn of sonic choking at an incorrect junction.

5. Fixed a case where the Force Set Problems window would incorrectly appear for force sets containing a branching flow path.

6. Fixed a bug where some xStream simulations intended to end the simulation on an event would not do so, and would run to the full simulation time.

Important non-engineering changes

1. Fixed an issue where a Bend/Elbow's R/D value could be improperly imported from a PCF file in languages where a comma is used as the decimal mark.

2. Added more options to help load results faster when a very large number of Events are generated during runs.

3. Unit conversion for custom start time for force file exporting now functions properly.

4. Fixed an issue where the eLicense code entry window could appear during a license error even if a valid Registration file was present.

Miscellaneous changes

1. Removed an erroneous Detailed Tee orientation evaluation in xStream since the Detailed Tee feature is not available in xStream.

2. Added display of library file path in the Edit Junctions section of Library Manager and allowed right click to copy the path to clipboard.

3. Added 'Workspace' and 'Special' buttons to Global Junction Morph panel.

4. Fixed a case when creating Design Alerts would clear output Warning messages.

5. Implemented shift click on row and column headers within output data.

6. Updated loading new libraries with older models.

7. Updated Workflow to display when memory constraint reached.

8. Scenario Manager tree structure will now preserve scenario order when cloning scenarios with children and when adding scenarios within Batch Run.

Changes that may affect engineering conclusions

1. Fixed two issues with force sets. One is an issue where force sets with branching paths were not being calculated. The other was an issue where Analysis Setup would fail to open when the model contained point forces.

2. Fixed issue where Hydraulic Diameter in Model Data did not match Hydraulic Diameter in Output.

Important non-engineering changes

1. Updated eLicense DLL to address issues with hard drive serial checks and occasional hanging of application on close.

2. Updated "About" window to include additional licensing information.

3. Removed hard requirement for existence of license file for applications to open.

4. Fixed an issue where the registration file was unable to be copied from other/old locations in some cases.

5. Fixed issue where models with force differences were taking too long to run.

6. Fixed visual validation issue with Compressor Flow/Pressure and Compression Ratio.

7. Fixed issue when exporting tanks to EPA.

8. Fixed an issue where 'Show Time Label' setting would be ignored when copying an image of an animated graph. Additionally, the label location in the image is no longer fixed and will match the location that it was placed prior to taking the image.

9. Added user option to prevent automatic snap to grid when isometric pipe drawing mode is activated.

10. Auto-rotating area changes and check valves will now automatically adjust icons to align with the flow direction and size changes at these junctions.

11. Added missing descriptions for advanced parameters and removed Disable Enthalpy Match Logic option.

12. Fixed issue with junction icons being reset after auto rotation.

Miscellaneous changes

1. Fixed sizing for notes and status text boxes in Assigned Pressure form.

2. Improved image cropping when Copying Graph Image while showing raw data in Graph Results.

3. Improved visual mirroring of Magnification tool.

4. Fixed an issue where a Color Map defined with the "Show Value on Workspace Label" option could format the value incorrectly in the object's label.

See New in Version 4

Changes that may affect engineering conclusions

1. Fixed a problem when using standard or normal mass flow rate units for an Assigned Flow junction, where the first run of a scenario may not have the correct STP conditions set. The second run and reopening the scenario after a successful run would have the correct flow values.

2. Fixed issue where Hydraulic Diameter in Model Data did not match Hydraulic Diameter in Output.

3. Fixed an issue where a Bend/Elbow's R/D value could be improperly imported from a PCF file in languages where a comma is used as the decimal mark.

4. Unit conversion for custom start time for force file exporting now functions properly.

5. Fixed a case where creating Design Alerts would clear output Warning messages.

Important non-engineering changes

1. Fixed issue with Split Pipe feature not correctly connecting pipes to new junction.

2. Fixed a problem where a system error message was saved to the model file if it contained a CRLF character which caused the model to error when loading.

Miscellaneous changes

1. Corrected text to show that Miter bends have an angle limitation of 0-90 degrees.

2. Fixed a case where Pipe data would not copy Heat Transfer data to non-Heat Transfer pipe.

Changes that may affect engineering conclusions

1. Fixed issue where frequency graphs and API-618 and API-674 checks were reporting or using the regular amplitude instead of the peak-to-peak amplitude (double the amplitude).

2. Fixed a problem where a spray in a section of piping that is closed by another junction (like a valve) would not propagate the ambient pressure into the closed pipes which would give "No Solution" and lead to a error about a Stagnate Region.

3. Fixed an issue with units in API 618 Pulsation Summary text when using metric units.

4. Changed the K factor calculation for junctions that use a Cd (like an Orifice) or Cv (like a Valve) when the flow is reversed though the junction. This will bring the flow and losses more inline with the same junction with flow in the positive direction.

5. Fixed a problem with reporting Sonic Area and Mach Number Restriction if the flow is reversed through a junction like a valve.

6. There were a number of issues exporting the Transient Max/Min table to Excel that were fixed. One of them related to incorrect unit conversions for Superheat Temperature in the Detailed Max/Min tables when exported to Excel.

7. Fixed issue where Valve Reynolds Number and xT Valve Summary parameters were not reporting correctly for control valves.

8. Fixed an issue where a Color Map defined with the "Show Value on Workspace Label" option could format the value incorrectly in the object's label.

Important non-engineering changes

1. Fixed an issue that caused Minimum Transient Pipe Parameters in Layers to not be read in from the model file.

2. Fixed an error that caused the Paste command to be disabled in contexts where it should have been enabled.

3. Fixed issue when exporting file without raw pump data to EPA file.

4. Fixed an error with Multi-Profile plots with a Common Pipe where the offset to align the plots was not being added.

5. Fixed issue when changing pipe label color in User Options.

6. Removed "Troubleshooting" buttons.

7. Improved Global Pipe Edit Roughness application when destination pipe has no material set.

8. The Forces button on the Output Control window was not displaying. The Forces report in the Output Window was still displaying, but could not be customized as the button was hidden.

9. Fixed issue with grid formatting when exporting force files.

10. Graph Results: Fixed Default line style being set to Dash instead of Solid when clicked.

11. Graph Results: Improved Multi-Scenario Profile Animation visualization and clarity when Scenario Simulation Durations do not match.

12. Fixed issue where double-clicking Annotations in Layers Setup would not load that Annotation's properties.

13. Added user option to prevent automatic snap to grid when isometric pipe drawing mode is activated.

14. Made it so that deleting a scenario will remove that scenario from saved Graph List Items.

15. Fixed issue with printing output in landscape format.

16. Fixed issue when renaming fluid groups.

17. Auto-rotating area changes and check valves will now automatically adjust icons to align with the flow direction and size changes at these junctions.

18. Added missing descriptions for advanced parameters and removed Disable Enthalpy Match Logic option.

19. Fixed issue with junction icons being reset after auto rotation.

Miscellaneous changes

1. Fixed an issue where "Compressor/Fan Summary Parameters" in Workspace Layers was displaying as "Pump Summary Parameters"

2. Added ellipsis to Join Pipes/Junctions menu command.

3. Use of Common Junction Global Edit could fail upon initializing the common junction.

Changes that may affect engineering conclusions

1. Fixed an issue with the optional sonic CdA for venturis, screens, and valves that prevented sonic choking and prevented loading saved valve sonic CdA values.

2. Fixed several issues with exporting Transient Max/Min tables to Excel.

3. Fixed an issue that caused Pump Vs. System Efficiency curve values to plot at the Minimum Speed rather than the Speed defined in the Pump Curve Configuration Form, when that Minimum Speed curve was included in the plot.

4. Fixed a minor issue where changing a pipe or junction's Name or Number would not immediately reflect on the Workspace until another display-altering action was taken.

Important non-engineering changes

1. Zooming Workspace with Mouse Wheel no longer requires Left-Clicking Workspace first immediately after Panning with the Middle Mouse Button.

2. Fixed an issue where the Auto Save feature could start saving in the middle of a run, causing Output to be unavailable once the simulation completes.

3. Increased the speed of reading an imported CSV force set file by a factor of 3 to 4.

4. Fixed an issue where PCF models with objects that have very large (in the billions or larger) X, Y, or Z coordinate values could cause an arithmetic overflow exception during import.

5. Fixed an issue where using the Merge feature would cause merged objects to be invisible on all Layers initially, and could not be made visible on the All Objects Layer.

6. Fixed an issue where deleting the highest number junction would cause the next junction dragged onto the Workspace to duplicate Layer styling from that deleted junction.

7. Fixed an issue where Line type Annotations were being drawn in an incorrect location if the current Workspace view was not at the very top-left of the diagram.

8. Fixed issues with printing large models.

9. Movements to the Annotation Line will now be captured in Undo.

10. Added the capability to resize the background image in individual scenarios.

Miscellaneous changes

1. Graph Results: removed the colored border when Copying Graph as Image.

2. Fixed a visual error that caused Annotation Selection Handles to remain after a new model was loaded while Annotation was selected.

3. Fixed an issue that could cause incorrect screenshot bounds for animated graphs when using the Copy Graph Data button.

4. Model Data Junction grid scroll position no longer resets after opening Junction Property Window by double-clicking the grid.

5. Improved Workspace Search function user experience.

6. Select Shortest Paths will now ask to try the opposite direction if the first ordered junction pair fails to find a path in the given flow direction.

7. Fixed a minor bug where Scenario Comparison grid would be re-evaluated on closing the Scenario Comparison Tool, if the Difference Visibility Mode had been changed since entering the tool.

8. Added logic to prompt model save for more actions involving annotation edits.

9. Fixed issue with missing images in xStream Transient Solver Initialization tab of Output Control.

10. Removed AFT Notifications links from Startup Form and Help Menu. Notifications are now automatically dispatched to license holder.

Changes that may affect engineering conclusions

1. For very low flows or pressure drops, the Cv/xT calculation could have a large relative error. Added the ability to tighten the tolerance for Cv/xT calculations to Advanced Parameters to account for this rare occurrence.

Important non-engineering changes

1. Fixed issue when closing Print Preview.

2. Valves with a loss model of Resistance Curve caused the transient solver to halt - this has been corrected. Additionally, it was possible to select Exit Valve in combination with Resistance Curve, which is not supported - this selection is no longer possible.

3. Fixed error when using "Load All User Defaults" in User Options.

4. Fixed an issue with automatic conversions when selecting units for valve equivalent lengths.

5. Fixed issues with printing large models.

6. Fixed a problem where a user created fluid without vapor pressure would repeatedly ask to be updated.

7. Fixed a problem where when the advanced option to bypass the AFT Arrow Steady solver was selected and the model was run in Steady-State mode, the solver would not run and there would be an error displaying the output.

8. Added the capability to resize the background image in individual scenarios.

9. Fixed an issue where hitting the Escape key after drawing a pipe in multi-pipe drawing mode over a rectangular Annotation would cause that Annotation to be removed.

10. Fixed issue with unexpected errors when using workspace search bar.

11. Fixed an issue where copy-pasting multiple Annotations could include previous Workspace locations in the Paste Preview incorrectly.

12. Fixed issue where closed graph icons would display incorrect colors in graph list.

Miscellaneous changes

1. Model files which had been saved with at least one annotation, in which at least one of those annotations that had been previously saved was later deleted, after which the model was saved again, and model reopened would cause an error for each of the deleted annotations while reading the model file.

2. Fixed an issue that caused the 'Show Full Scenario Path' checkbox in Graph Results legend formatting not to take effect when the graph had not yet been added as a Graph List Item.

3. Updated text in license expiration message.

4. Fixed a graph scaling issue with Not a Number results (such as infinite K factor for zero loss).

5. Fixed issue where Library Manager form would collapse upon closing the Edit Cost Library form.

6. Added parameters to Excel Import Workbook.

7. Fixed issue where graph formatting flyout would close when resizing the application.

Changes that affect engineering conclusions

1. Fixed an issue where ASME Steam, Chempak, or REFPROP fluids would not appropriately use "High Accuracy" Gamma. This generally has negligible impact, but in some cases - especially near a fluid's critical point or at extreme supercritical conditions - results could be substantially affected, and/or the transient results could be unstable/unrealistic.

2. Fixed a problem displaying Standard or Normal unit types in the Heat Exchanger, Valve and Tank summary tables. These could be using an incorrect STP density if there are multiple fluids used.

Other changes

1. Fixed an issue where splitting a ZLC pipe would cause an elevation of NaN to be calculated for the new junction. This could cause an overflow exception when manipulating workspace objects later on.

2. Fixed issue where "Other" Export Type in the Excel Export Manager displayed incorrect estimates for cells occupied. Fixed issue where "Library Sources" did not display the correct information.

3. Fixed an issue that caused Plot Formatting to load incorrectly for Multi-Scenario Graph List Items.

4. Added transient events for Tank Gas Mass and Tank Temperature.

5. Fixed an problem that would cause Annotation Text Alignment properties to not be retained when reloading Graph List Items.

6. Revised scaling in Fluid Library preview graphs.

7. Correct fluid list is now displayed when closing the edit fluids tab.

8. List headers now resize to fit the header even when there are no items in its column

9. Expanded the Pipe Material Library to include Specific Heat and Modulus of Elasticity.

10. Added bends as object type in xStream Import Workbook.

11. Added a check for valid geometries when importing fittings. User can no longer import fittings with geometries that are invalid for their respective category.

12. Fixed issue with focusing when user clicked into and out of filter text box in the Output Control form.

Changes that affect results

1. Fixed an issue where, for some model configurations, a finite tank set to Calculate From Steady-state would cause convergence failure.

2. Fixed a problem where the maximum and minimum forces were not reset between runs. This would result in these values being used from one scenario to the next and could give erroneously high forces for a given scenario.

Changes that affect interface

1. Limited the number of multi-scenario output to 250 scenarios to avoid file and display errors.

2. Improved visualization of Design Alerts when graphed in Profile plots.

3. Fixed an issue where pipes would not show in the Overview Map at close zoom levels.

4. Updated Printer Page Layout and Print Area Preview on the Workspace to have more clear behavior and options.

5. Added the capability to start a valve at 0% open when using the Characteristic data.

6. Fixed the time remaining estimate not being reasonable when starting from a checkpoint.

7. Fixed an issue that caused Undo to not operate correctly for Annotations.

8. Made it so that deleting a scenario will remove that scenario from saved Graph List Items.

9. Fixed an issue where resizing an annotation could sometimes cause a System.Collections.Generic.KeyNotFoundException.

10. Fixed an issue where changing the "Background Picture Scaling" value in User Options -> Workspace -> Other was not properly scaling the background image.

Other changes

1. Fixed a problem where the Valve Source was being reset to User Specified when the model or scenario was loaded.

Changes that affect results

1. Fixed an issue where User Library fluids would not report a warning if they dropped below their defined minimum temperature during a Run.

Changes that affect interface

1. Limited the number of multi-scenario output to 250 scenarios to avoid file and display errors.

2. Added junction numbers to the Edit->Select Shortest Path menu labels for clarity.

3. Fixed an issue where valves using the Resistance Curve loss model were improperly checking transient data when accepting changes in the Valve Properties window.

4. Removed liquid-type units from the Volumetric Flow Rate unit family.

5. Fixed being unable to cancel Batch Runs.

Other changes

1. Fixed an issue that caused just the first graph in stacked graph configurations to be saved to a file by using the File->Save Graph As... dialog.

Changes that affect results

1. Fixed issue where control valves set to Fully Open - Never Control in stagnant regions were not transferring the pressure from one stagnant pipe to the other.

2. Fixed issue where some loss information was inadvertently cleared (set to zero) when loading an xStream 2 model. Affected losses were: (1) General Component K Factor, (2) Heat Exchanger K Factor, (3) Screen K Factor, (4) Venturi K Factor, (5) Venturi Cd.

3. Fixed issue where the Xt reported for a control valve with a Cv and Xt vs Open Percent table was always the full open Xt.

4. Fixed Transient Solver Initialization > Advanced Settings values being of unreasonable magnitude when unit system was set to Metric Only.

5. Fixed issue where an internal transient solver failure could cause another error that crashed the application. Now, these types of errors will fail to converge as expected and delete the output without additional failures.

6. Fixed issue that was preventing Local Iteration error messages from showing as Warning messages for Steady State runs.

Changes that affect interface

1. Fixed issue where User Default font settings in Global Layer Settings were not being saved or loaded properly in languages where a comma is used as the decimal mark.

2. Added more robust error handling for file manipulation errors commonly encountered in Library Browser.

3. Fixed issue that caused recorded animations to not prompt for a save location.

4. Made error reporting improvements in Graph Results Multi-Scenario graphs.

5. Fixed issue with copy+pasting Annotations with lines shown not displaying properly in the Paste Preview or after pasting.

6. Added import of junction image sizes and pipe thickness to Workspace Layers Import.

7. Improved performance when a large number of objects are deleted from the workspace or bulk modified in Analysis Setup.

8. Fixed issue where valves using the "From Characteristic" Loss Source with Open Percentage transients would force the first transient data point to be 100% open.

9. Fixed issue that caused Layer Label Control Parameter Lists to load incorrectly while using certain language translation files.

10. Fixed issue with EPAnet export that caused models with Exit Relief Valves to fail the export.

11. Fixed issue that caused Select Working Fluid in the Startup Form to fail when a Chempak fluid was selected.

12. Fixed issue during a batch run where the results would not be saved to a text file when this option was selected.

13. The frame on the Pipe Properties window, Optional tab, for the number of parallel pipes was being hidden by other controls. Moved the frame so it can be seen.

14. Fixed a problem where the valve K factor or resistance curves would not be retained when the model/scenario was reloaded.

15. Profile Plot titles will now display the first and last pipe numbers of the selected path, rather than the lowest and highest overall pipe numbers.

16. Fixed a problem when morphing a Valve into a Relief Valve where the Loss Type would be in and unknown state.

Other changes

1. Fixed a problem causing the Warning and Design Alerts to not be exported when using the Preformatted option.

2. Updates the descriptor for Stainless Steel Tubing, 1-3/4 from 14 BWG to 16 BWG to match wall thickness value. This would not change the engineering data but may cause some pipes to become undefined if models are using this.

3. Fixed an issue where changing Scenarios while the Recovery File or Auto-Save was running could cause corruption of some model/object data

4. Removed the prompt to convert older models and make a backup. This caused the output files to be renamed to .out.bak_X3 which caused the model to not report any valid output.

Refer to New in Version 3.