Introduction to Version 3.2

Welcome to HYSYS Version 3.2 - HYSYS 3.2 is the second minor release on the HYSYS 3 series and builds on the significant advancement in simulation technology offered in HYSYS 3.01 and 3.1. As with every AspenTech product, it reflects our commitment to delivering Process Asset Lifecycle Management within a platform that is the world leader in ease of use and flexibility, and sets the standard for an open engineering environment. This version provides the technology framework to support Steady State process design, Dynamic operability and management, Asset Planning and Utilization and Real Time Optimization. This allows you, our customer, to further leverage your modeling investment to obtain real business benefits.

HYSYS 3.2 was designed with three main purposes in mind. One to deliver the first level of integration between HYSYS and the Aspen Engineering Suite products since the combination of Hyprotech and Aspentech. Second, improve the Upstream capabilities of HYSYS by providing a Upstream option which delivers new thermodynamic capabilities in Black oils and PVT as well as improved integration with Upstream well and flowline modeling tools. Thirdly to continue to add engineering enhancements for both steady state and dynamics that will enable users to extract more value from HYSYS.

HYSYS 3.2

New Features

Aspen Engineering Suite Integration
Aspen WebModels Aspen Enterprise Engineering Aspen OnLine Aspen Custom Modeler Aspen DMCPlus
Upstream Option

AspenTech is excited to deliver the first phase of HYSYS Upstream with the release of HYSYS 3.2. The purpose of HYSYS Upstream is to extend the upstream capabilities of the HYSYS simulation enviroment. These improvement introduced in HYSYS Upstream are in two main areas, thermodynamics and hydraulics. Thermodynamics: HYSYS Upstream delivers new capabilities to utilize the key upstream thermodynamic methods, Black Oils and PVT. New tools for Lumping and Delumping hydrocarbon components have also been developed. Hydraulics: HYSYS Upstream also delivers mechanisms for integrating with production field models built in PIPESIM, an industry leading well and flowline modeling tool from Schlumberger. Using HYSYS Upstream will allow consistent thermo and models across an integrated asset. These holistic models create powerful tools to make better decisions on Oil and Gas assets to improve the return on capital employed.

Black Oil Methods and Thermodynamics Black Oil Flowsheeting Black Oil Translator Component Lumping/Delumping PVT Integration PIPESIM Link The link to Schlumberger's PIPESIM, a single branch well and flowline modeling tool has been updated. Previously the link was made available for PIPESIM 2000. This link has been enhanced and upgraded to work with PIPESIM 2003. Using PIPESIM together with HYSYS, users can integrate models of petroleum wells with compressor station or facility models. PIPESIM-NET Operation
Engineering Enhancements - Steady State
Data Reconciliation Solver RVP Property Correlations TACITE Heat Curve Points Electrolytes Depressuring Enhancements Stream Description Compressor Curves
Engineering Enhancements - Dynamics
Real Separator Event Scheduler Cause & Effect Matrix Profiling Tool COMThermo Support Orifice Types Vessel Emulsions Tray Rating Trace Messaging
Other new Capabilities
HYSYS Browser - Link to Excel Rotating Equipment - Inertia and Friction Loss Print PFD in SVG format Neural Net Improvements Clean Fuels Extension Property Package.
Training

AspenTech is now taking a new approach to customer education, training and technology transfer. We are looking at new ways to deliver training to our customers which will include self training, animated tutorials, computer based training, web based training, class room training and project training. As a start we are making our training materials publicly available to facilitate self-training and in-house training. From within HYSYS go to the Help menu and select the Training item. This will lead you directly to the Aspen Training Centre website and all the relevant training materials of the HYSYS product. The materials include full course materials and modules and animated tutorials. From the Training Centre website you can browse to training materials available for all other AspenTech products.

PIPESYS v2.0
The HYSYS 3.2 CD also contains a new version of PIPESYS. Version 2.01 build 67 has these new capabilities and enhancements:
  1. The Erosion Velocity check calculation was changed so that no maximum erosion velocity is computed for a single phase liquid or single phase gas fluid when there is no sand production. Single phase liquid, single phase gas and multiphase fluids do compute both the maximum sand free and with sand erosion velocities.
  2. A problem was encountered that under certain circumstances would cause the Beggs and Brill liquid holdup correlation to predict a liquid volume fraction greater than one causing the calculations to fail. This has now been corrected.
  3. A problem exited with the reverse pressure calculation in PIPESYS that caused the incorrect flow rate to be used for the feed stream after the pressure estimate is done when side streams exist in the profile. This has been corrected.
  4. The reference to pipe types has been removed from the list of available external coatings types at the request of Hyprotech's support staff.

Rectified Issues

  1. Cut\Copy\Paste - Custom Icons are no longer lost while performing cut/copy/paste operations in the PFD.
  2. Liq Vol Flow @ Std Cond variable in the stream now supports kbpd. Kbpd = 1000 bbl/d
  3. Strip Charts are now properly imported in templates.
  4. The compositions on the Compositions page of the Workbook can now be properly displayed by selecting the choices for different fluid package.
  5. Implicit Check valve
  6. The Esso Tabular property package now works properly under COMThermo.
  7. The BIPs for Water and Ethanol were improved to better represent the VLE of these systems.
  8. Dynamic initialzation has been improved to be able to manipulate groups of objects in order to better support large places.
  9. Solid components are now properly handled in Dynamics.

Known Issues

For the most up to date list of known issues and work-arounds visit the Knowledge Base at: support.aspentech.com
  1. Property Package Extensions - Your custom property package extensions MUST be recompiled against the HYSYS 3.2 Type Library to ensure that they properly function with version 3.2 if they were last compiled against the HYSYS 3.0.1 type library. Property Packages last compiled against v2.4.1 do NOT need to be recompiled for v3.2
  2. The old Depressuring utility has been intentionally removed in favor of the newer Dynamics Depressuring utility. The old utility can still be used in older versions.
  3. Black Oils: The Black Oils package is not supported in Dynamics
  4. PIPESIM 2003 links: The new links to PIPESIM and PIPESIM-Net are designed to work with the PIPESIM 2003 version.
  5. PIPESIM 2003 links: These links only support Compositional mode inside PIPESIM 2003.
  6. Solid Unit Operations are not supported in Dynamics.
  7. Tool Tips: If HYSYS 3.2 is started for the first time after installation and a users preference set is loaded the Tool Tips may have duplicate values being displayed. To avoid this, after installation load HYSYS and then exit before loading a user preference set. If you already have duplicate values in the Tool Tips, find the ToolTip.xml file in the Cases directory and delete it. Next start HYSYS and exit. This will create a new ToolTip.xml file without the duplicates.
  8. MSXML Parser - During the installation of HYSYS 3.2, users on different language versions of Windows (Japanese, Korean, Chinese) may experience problems with the registration of MSXML4 (the Microsoft XML parser). Should you experience this problem, simply go to the MSXML folder on the CD, open the folder corresponding to your language, and run the standalone MSXML installer within that folder.
  9. XML - Extension Property Packages, Extension Unit Operations and User Variables are currently not supported by the XML file input/output systems.
  10. XML - Not all calculated data is available in the xml output file.
  11. XML limitations - Cases can be saved in XML format in Dynamics mode but not enough information is stored at this time to fully reload the case. COM Thermo specific data is not output to XML. A HYSYS case using COM Thermo will not reload all the COM Thermo data.
  12. Stream Correlations - Some stream properties are currently not supported in the correlation manager but they can still be accessed via the workbook and PFD tables.
  13. Security - Infrared ports setup for PDA devices may interfere with SLM keys.
  14. Security & Automation - Automation applications in VB, Excel or Word may not successfully achieve a license when the LSHOST environment variable is defined in the User Variables section as opposed to the System Variables section.

For the most up to date list of known issues and work-arounds visit the Knowledge Base at www.aspentech.com/support.

Minimum and Recommended Systems

The following describes the minimum platform requirements needed to run HYSYS v3.2.

Minimum Recommended
Processor Pentium II 400 MHz Pentium III 700 MHz or better
Physical Memory (RAM) 128 MB 256 MB of RAM
Total Memory (physical + virtual) 300 MB >300 MB
Disk Space 500 MB

For more information regarding the operating systems that Hyprotech products support please visit us at: http://www.aspentech.com/support

Installation

For the most detailed installation instructions refer to the Get Started PDF document on the Software or Documentation CD included in your package. The PDF document will be more accurate then the printed Get Started manual.

Upgrade/Release Package

Your package may include:

If you are a new HYSYS customer or upgrading network licensing from version 2.2 and lower then your release/upgrade package will also include:

Upgrading From HYSYS v2.4 or Higher

If you have installed HYSYS v2.4 or higher, you are already using the SLM Security system. You are receiving HYSYS 3.1 as a regular update so you will not receive a new key or license file; there is no need to install new licenses during the installation. There is no need to update your license server if you are using network security. Proceed with the Installation instructions in the Get Started manual.

Upgrading From HYSYS v.2.2.2 or Older

Older versions of HYSYS used a different security system. Standalone users can proceed with the HYSYS installation described below; green keys will work with HYSYS 3.0 and continue to function with your old HYSYS version. New parallel port SLM keys will only work with HYSYS v2.4 or higher. If you are using Hyprotech's old network security you will need to upgrade your network security to use HYSYS 3.0. Please refer to the Get Started manual for Upgrading Your Network Security instructions before installing HYSYS.

New HYSYS 3.2 Customers

Welcome to HYSYS. You will have received a new Grey SLM key(s) and license file(s) along with your documentation and Software. For Network security, a SLM License Server must be set up by following the instructions in section 2.2.5 of the Get Started manual. To install HYSYS, refer to section 1.4 in the same manual.

SLM Security System

Software License Manager (SLM) Security System

HYSYS version 2.4 and above uses a new security system that has been implemented in all Hyprotech products. The new SLM security system uses a license file that contains the list of software and features you are licensed to run. The key is simply a locking device and no longer contains licensing information. The SLM offers many advantages over the old Hyprotech security system, including simpler installation, easier upgrades and improved diagnostic tools. Previous versions of HYSYS had two types of installations, one for network users and a separate one for standalone users. A security code was entered during the installation process that defined the type of installation being performed. This distinction meant that the type of security being used could not be easily changed. With the SLM only one installation is required, regardless of how HYSYS is being accessed. The only factor determining the licensing mode you will be using is the location of the license file and security key. Thus, license modes can be mixed between standalone and network without modifying HYSYS. Your license files control all features that constitute these applications. Upgrading to new features is as simple as changing the license file.

SLM Security System FAQ

  1. Can I use the same server for the old and new network security systems?

    -Unfortunately, no. The new SLM network security and the old network security systems are not compatible. The SLM security system must not be installed on the same computer as the old network security system.

  2. How do I know if my license file and key are matched?

    -The license file on your disk will be named according to your serial number (for standalone “green” keys) or lock code (for standalone or network SLM keys).

  3. With the new system will I still be able to move the key around?

    Yes. However as each key is configured for a specific license file, you must install all license files you will be using with the application. It is also possible to add these files later by following the instructions in the Get Started manual.

  4. I need a license file. How do I get one?

    -You should have received a license file on disk with your copy of the software. Alternately, if your company is running a network version of the program, the server will contain the required license files. Otherwise, contact your local Hyprotech sales representative. If you are unsure whom to contact, Technical Support can put you in contact with someone. The request must include the serial number and lock code for your key. The lock code can be determined by running the echoid32 software as described in the Get Started manual. Please install the license file as outlined in the Get Started manual.

  5. I need some features I am not currently licensed for. How do I get licensed for new features?

    -Contact your local Hyprotech sales representative. If you are unsure whom to contact, Technical Support can put you in contact with someone. You will also need to replace your current license file with a new one. If you do not have one, please refer to “I need a license file. How do I get one?” for details on how to obtain one. If you are running an old version of HYSYS or other Hyprotech software which does not support the use of license files, you will be required to exchange your current network grey key for a new network SLM key with updated license information.

  6. What if I need to use an older version of the program?

    -If you have a standalone “green” key, you will still be able to use your copy of the program. If you were on a network, you will need to speak with your sales representative to arrange for a temporary key.

  7. What if I need to install another Hyprotech product and it has a new license file?

    -Allow the installer to add the new license file. It will place the files in the appropriate location to ensure that everything works together.

Further information can be found in the Troubleshooting section of the Get Started manual.

Troubleshooting SLM Installations

Before contacting Technical Support, please go through the following steps: If you require further support, please contact your local Hyprotech technical support office. A complete listing of these offices can be found in the Get Started manual. Inquires can also be sent to support@hyprotech.com or visit our Web site at www.hyprotech.com. Reporting Problems Please report any problems you encounter to Hyprotech. Provide a detailed bug report, providing as much information as you can. If you are having trouble in getting AXSYS to run, or you are experiencing a problem that you feel may be related to your system configuration, please provide copies of your configuration files. For Windows NT and Windows 2000, please provide the output from Windows Diagnostics. When contacting Technical Support please supply the following 5 pieces of information:
  1. Product name(s) with which you are having problems)
  2. System Configuration:
  3. Exact description of the error encountered: i.e. what is occurring, when is the error encountered (during installation, startup, when opening a case, etc.) and most importantly, the specific text of the error message(s) received (preferably screen-shots of all error messages should be supplied)

    ** The error message is the most important piece of information required to trouble-shoot your problem. Having a complete picture of the error is critical for a quick response.**

  4. A copy of your license file
  5. The Echoid32.txt output file generated by running the Echoid32 application on the computer to which the hardware key is attached (refer to Section 2.5.1 of the Get Started guide)
Supplying this information will enable a timely resolution to your problem.

Contacting Support

AspenTech Customer Support has implemented an extensive online Knowledge Base, including a fully browsable and searchable FAQ database, technical articles, sample cases, and animated tutorials. Visit support.aspentech.com If you are unable to find effective answers to your technical queries in the product documentation or online, we encourage you to contact our support engineers using one of the following options:

Reporting Problems

Please report any problems you encounter to Hyprotech. Provide a detailed bug report, providing as much information as you can. You are encouraged to use the Bug Reports facility in HYSYS itself. This utility may be found under "Help" in the main menu.

If you are having trouble in getting HYSYS to run, or you are experiencing a problem that you feel may be related to your system configuration, please provide copies of your configuration files. For Windows 98, please provide copies of autoexec.bat, config.sys, system.ini, and win.ini. Under Windows NT, please provide the output from Windows NT Diagnostics.

Whenever possible, please supply copies of any and all error messages encountered.