Get Started

1.
0 Documentation
Get Started
Copyright Notice
© 2000 AEA Technology - Hyprotech Ltd. All rights reserved.
© 2000 KBC Advanced Technologies plc. All rights reserved.
AEA Technology - Hyprotech Ltd and KBC Advanced Technologies plc are the owners of, and
have vested in them, the copyright and all other intellectual property rights of a similar nature
relating to their software, which includes, but is not limited to, our computer programs, user
manuals and all associated documentation, whether in printed or electronic form (the
"Software"), which is supplied by us or our subsidiaries to our respective customers. No
copying or reproduction of the Software shall be permitted without our prior written consent,
save to the extent permitted by law.
Hyprotech reserves the right to make changes to this manual or its associated computer
program without obligation to notify any person or organization. Companies, names and data
used in examples herein are fictitious unless otherwise stated.
HYSYS, HYSYS.Plant, HYSYS.Process, HYSYS.Refinery, HYSYS.Concept, HYSYS.OTS,

HYSYS.RTO, DISTIL, HX-NET, HYPROP III and HYSIM are registered trademarks of AEA
Technology Engineering Software - Hyprotech Ltd. All rights reserved.
Petrofine®, Catop®, Distop®, Vistop® and Profimatics® SIM Series are registered trademarks
of KBC Advanced Technologies plc. All rights reserved.
Microsoft® Windows®, Windows® 95/98, Windows NT®, Windows® 2000 and Excel® are
registered trademarks of the Microsoft Corporation.
This product uses WinWrap® Basic, Copyright 1993-1998, Polar Engineering and Consulting.
Documentation Credits
Authors of the current release, listed in order of historical start on project:
Conrad Gierer, BASc; Chris Strashok BSc; Peter deJonge, BSc; Adeel Jamil, BSc; Sarah-Jane
Brenner, BASc; Ron Brown, PhD, FRDC, FISTC; Lisa Hugo, BSc, BA; Kevin Hanson, PEng
Since software is always a work in progress, any version, while representing a milestone, is
nevertheless but a point in a continuum. Those individuals whose contributions created the
foundation upon which this work is built have not been forgotten. The current authors would
like to thank the previous contributors.
A special thanks is also extended by the authors to everyone who contributed through
countless hours of proof-reading and testing.
Contacting AEA Technology - Hyprotech

AEA Technology - Hyprotech can be conveniently accessed via the following:
Website: www.hyprotech.com
Technical Support: support@hyprotech.com
Information and Sales: info@hyprotech.com
Detailed information on accessing Hyprotech Technical Support can be found in the

Technical Support section in the preface to this manual.
Table of Contents
1 Introducing HYSYS.Refinery ............................ 1-1

1.1 Refinery Modeling Solutions.............................................. 1-2
1.2 The HYSYS Philosophy .................................................... 1-6
2.3 Use of the Manuals ........................................................... 1-9
2.4 Technical Support ........................................................... 1-17
2 Installing HYSYS.Refinery................................ 2-1

2.1 Basic Requirements .......................................................... 2-1
2.2 Installing HYSYS ............................................................... 2-2
2.3 The Standalone Key Version of HYSYS ........................... 2-4
2.4 The Network Key Version of HYSYS ................................ 2-9
3 Get Started ....................................................... 3-1

3.1 Starting HYSYS.Refinery .................................................. 3-1
3.2 Steady State Case ............................................................ 3-7
3.3 Refinery Case.................................................................. 3-17
iii
iv
Introducing HYSYS.Refinery 1-1
1 Introducing
HYSYS.Refinery
‘Breaking Performance Barriers’
We are pleased to introduce HYSYS.Refinery — the first and only
process simulator capable of truly scalable refinery-wide modeling.
HYSYS.Refinery provides ground-breaking technology to support
benchmarking, evaluation and sustained profit improvement. Refinery
owners gain a competitive advantage and enhance profitability by
reducing error, improving decision-making and providing for easy
access to refinery-wide knowledge and expertise.
HYSYS.Refinery is the result of a collaborative development effort

between AEA Technology - Hyprotech Ltd. — the leading supplier of
engineering knowledge deployment solutions to the process industries,
focused on improving profitability and operating performance
throughout the enterprise lifecycle, and KBC Advanced Technologies
plc — the world’s leading consulting company for profit improvement
in the refining industry and a leading supplier of refinery-wide
simulation technology and kinetic reactor models.
HYSYS.Refinery uses the same interface, solving mechanisms,

thermodynamics, and other technology found in the other HYSYS
products. Through the completely interactive HYSYS interface, you
have the ability to easily manipulate process variables and unit
operation topology, as well as the ability to fully customize your
simulation using its OLE extensibility capability.
1-1
1-2 Refinery Modeling Solutions
1.1 Refinery Modeling

Solutions
HYSYS.Refinery will allow refiners to break performance barriers and
improve profitability in four ways:
1. By providing the ability to develop refinery-wide models and

assess key economic and environmental variables within the
refinery supply chain economics. By developing single refinery-
wide models, one unit does not have to be optimized at the
expense of another.
2. Through the integration of KBC’s Profimatics® Sim Series and
Petrofine® reactor models into HYSYS.Refinery flowsheets.
3. By incorporating KBC's comprehensive mechanisms for assay
management and refinery physical property prediction, letting you
optimize to the true specifications and constraints.
4. By allowing refiners to draw on KBC's expertise for refinery profit
improvement while leveraging the same models.
HYSYS.Refinery has been developed with Hyprotech’s overall vision of

the ultimate refinery-wide simulation solution in mind. This vision has
led to a product with a number of key capabilities:
Plant Wide Models

Traditionally, models have been limited in scope because plant wide
models are difficult to build and maintain and computer hardware
requirements limited the model size. HYSYS.Refinery allows users to
develop plant wide models by providing technical capabilities never
offered before.
Refinery Assays
Refinery assays are based on the Refinery Oil Model which is a
conceptual model with an associated collection of software methods
for characterizing the measurements and properties of hydrocarbon
materials. A refinery assay matrix is a collection of information about
hydrocarbon-based material that holds the basic data needed to drive
the refinery physical property system. The refinery assay matrix is
organized as a series of property contribution values defined as
hypo(thetical) components in HYSYS.
1-2
Oils contain predefined properties such as MON, RON, PNA etc. Users
will also be able supply their own properties. This allows tracking of
properties such as sulfur or mineral content, C:H ratio and %
aromatics. Crudes may be synthesized and blended and compared to
raw data. A complete range of refinery inspection properties and
finished product specification properties are available with refinery
assays.
Variable Component Properties

The integration of refinery assay technology into the HYSYS
thermodynamic architecture allows individual reactor models to
predict property changes across the reactor based on feedstock
properties and operating conditions. This generates property
distributions for the product.
Because unit operations and mixing effects alter the component

properties, modeling an entire refinery accurately normally requires
using several thousand components. Because the component
properties in HYSYS.Refinery are variable, the entire refinery can be
modeled with only about 100 components.
Subflowsheet Technology
This technology allows user to "box" a collection of unit operations to
more easily manage large flowsheets. Operations may be moved into
and out of sub-flowsheets and the sub-flowsheets may be copied and
pasted, or turned into templates for use in other flowsheets.
Predictive Properties
Properties such as Octane Number, Pour Pt., Cloud Pt, etc. are
predicted using industry proven methods. The prediction of these
properties will take into account blending and flowsheet topology. This
will allow refiners to assess the operation of their plant with the
variables that dictate the economics.
1-3
1-4 Refinery Modeling Solutions
Distillation Column Capabilities

Depending on the detail warranted users might model columns in any
of the following ways:
• Distop solver, a robust algorithm which performs a section by

section analysis that may be tuned to match plant data
• rigorous first principles column models which perform tray by
tray analysis as currently supplied in HYSYS
• simple splitter where the user defines the outlets.
Reactor Capabilities
HYSYS.Refinery will allow for incorporating additional unit operations
with varying levels of fidelity as needed.
For detailed reactor modeling, the KBC reactor models, including the
Profimatics reactors may be incorporated into the flowsheet. A suite of
tools is also provided to manipulate stream data to match operations
and refining reactions may also be modeled by simple material
balance.
KBC Advanced Technologies Expertise

KBC pioneered the development of simulation products that capture
the interactions of individual process units in a refinery. They are the
world’s only supplier of refinery-wide process simulation models that
capture individual refinery conversion units. KBC is the leading
supplier of kinetic reactor models to the refining industry for analysis
and optimization. KBC’s extensive refinery experience, expert
knowledge, advanced technology and consulting services are provided
to 250 refineries representing 1/3 of the world’s total capacity.
Through the integration of the complete set of Profimatics® and other

KBC reactor models into the HYSYS environment, capabilities for
modeling reactors are extended far beyond any other engineering
software application.
HYSYS is also an integral part of the KBC Profit Improvement Program

(PIP) and because HYSYS.Refinery is easily maintained by engineers,
profit opportunities are sustainable when changing economics alter
optimum setpoints.
1-4
Value
The HYSYS.Refinery approach provides top to bottom and multi-
discipline benefit. Engineering builds and maintains models which are
validated against the plant and serve as an information source to actual
plant performance. Refinery-wide models allow for true optimization
rather than enhancing one unit at the expense of another. Furthermore,
these models are used as data for LP supply models to improve their
accuracy, planning and scheduling decisions. Additionally, the models
provide training and performance monitoring.
Used in conjunction with KBC expertise for refining profit

improvement, HYSYS.Refinery can improve refinery profitability by at
least 50 cents/bbl. Additional cost savings will be realized by the
elimination of rework because the same models are deployed for
design, engineering, operations, training, and planning and
scheduling. Finally, work processes are stream lined and barriers
between disciplines are eliminated. All workgroups use the same data
and management can access a complete picture of the refinery with the
details required to assess the interaction between various units and
groups.
1-5
1-6 The HYSYS Philosophy
1.2 The HYSYS Philosophy

The HYSYS family of products have been developed with Hyprotech’s
overall vision of the ultimate process simulation solution in mind. The
vision has led us to create a product that is:
• integrated
• intuitive and interactive
• open and extensible.
Integrated Simulation Environment

In order to meet the ever-increasing demand of the process industries
for rigorous, streamlined software solutions, Hyprotech developed the
HYSYS Integrated Simulation Environment. The philosophy underlying
our truly integrated simulation environment is conceptualized in the
diagram below:
Figure 2.1
The central wedge represents the common parameters at the core of

the various modeling tools:
• Model topology
• Interface
• Thermodynamics
1-6
The outer ring represents the modeling application needs over the
entire plant lifecycle. The arrows depict each Hyprotech product using
the common core, allowing for universal data sharing amongst the
tools, while providing a complete simulation solution.
As an engineer you undoubtedly have process modeling requirements

that are not all handled within a single package. The typical solution is
to generate results in one package, then transfer the necessary
information into a second package where you can determine the
additional information. At best, there is a mechanism for exchanging
information through file transfer. At worst, you must enter the
information manually, consuming valuable time and risking the
introduction of data transfer errors. Often the knowledge you gain in
the second application has an impact on the first model, so you must
repeat the whole process a number of times in an iterative way.
In a truly integrated simulation environment all of the necessary

applications work is performed within a common framework,
eliminating the tedious trial-and-error process described previously.
Such a system has a number of advantages:
• Information is shared, rather than transferred, among

applications.
• All applications use common thermodynamic models.
• All applications use common flowsheet topology.
• You only need to learn one interface.
• You can switch between modeling applications at any time,
gaining the most complete understanding of the process.
The plant lifecycle might begin with building a conceptual model to

determine the basic equipment requirements for your process. Based
on the conceptual design, you could build a steady-state model and
perform an optimization to determine the most desirable operating
conditions. Next, you could carry out some sizing and costing
calculations for the required equipment, then do some dynamic
modeling to determine appropriate control strategies. Once the design
has become a reality, you might perform some online modeling using
actual plant data for "what-if" studies, troubleshooting or even online
optimization. If a change at any stage in the design process affects the
common data, the new information is available immediately to all the
other applications — no manual data transfer is ever required.
While this concept is easy to appreciate, delivering it in a useable

manner is difficult. Developing this multi-application, information-
sharing software environment is realistically only possible using Object
Oriented Design methodologies, implemented with an Object Oriented
1-7
1-8 The HYSYS Philosophy
Programming Language. Throughout the design and development

process, we have adhered to these requirements in order to deliver a
truly integrated simulation environment as the HYSYS family of
products:
HYSYS Product Description

Refinery Modeling - HYSYS.Refinery provides
For information on any of truly scalable refinery-wide modeling. Detailed
these products, contact your models of reaction processes can be combined with
local Hyprotech HYSYS.Refinery detailed representations of separation and heat
representative. integration systems. Each hydrocarbon stream is
capable of predicting a full range of refinery
properties based on a Refinery Assay matrix.
Process Design - HYSYS.Process provides the
accuracy, speed and efficiency required for process
HYSYS.Process design activities. The level of detail and the
integrated utilities available in HYSYS.Process
allows for skillful evaluation of design alternatives.
Plant Design - HYSYS.Plant provides an integrated
steady-state and dynamic simulation capability,
offers rigorous and high-fidelity results with a very
HYSYS.Plant fine level of equipment geometry and performance
detail. HYSYS.Plant+ provides additional detailed
equipment configurations, such as actuator
dynamics.
Conceptual Design Application - HYSYS.Concept
includes DISTIL which integrates the distillation
synthesis and residue curve map technology of
Mayflower with data regression and thermodynamic
database access. HYSYS.Concept also includes
HYSYS.Concept
HX-Net, which provides the ability to use pinch
technology in the design of heat exchanger
networks. Conceptual design helps enhance process
understanding and can assist in the development of
new and economical process schemes.
Operations Training System - HYSYS.OTS
provides real-time simulated training exercises that
train operations personnel and help further develop
their skills performing critical process operations.
HYSYS.OTS
Increased process understanding and procedural
familiarity for operations personnel can lead to an
increase in plant safety and improvements in
process performance.
Real-Time Optimization - HYSYS.RTO is a real-
time optimization package that enables the
optimization of plant efficiency and the management
HYSYS.RTO
of production rate changes and upsets in order to
handle process constraints and maximize operating
profits.
1-8
2.3 Use of the Manuals

HYSYS Electronic Documentation
All HYSYS documentation is available in electronic format as part of the
The HYSYS Documentation
Suite includes all available HYSYS Documentation Suite. The HYSYS Documentation CD-ROM is
documentation for the HYSYS included with your package and may be found in the Get Started box.
family of products. The content of each manual is described in the following table:
Manual Description
Contains the information needed to install HYSYS,
plus a Quick Start example to get you up and
Get Started
running, ensure that HYSYS was installed correctly
and is operating properly.
Provides in depth information on the HYSYS
User’s Guide interface and architecture. HYSYS Utilities are also
covered in this manual.
Contains all information relating to the available
HYSYS fluid packages and components. This
Simulation Basis includes information on the Oil Manager,
Hypotheticals, Reactions as well as a
thermodynamics reference section.
Steady State Steady state operation of HYSYS unit operations is
Modeling covered in depth in this manual.
Refinery specific operations are covered in depth in
this manual. These include the following unit
Refinery Modeling
operations: FCCU, Catalytic Reformer and Refinery
Feed.
Details the many customization tools available in
HYSYS. Information on enhancing the functionality
of HYSYS by either using third-party tools to
Customization programmatically run HYSYS (Automation), or by
the addition of user-defined Extensions is covered.
Guide
Other topics include the current internally extensible
tools available in HYSYS: the User Unit Operation
and User Variables as well as comprehensive
instruction on using the HYSYS View Editor.
Provides step-by-step instructions for building some
Tutorials
industry-specific simulation examples.
The Get Started manual provides a step-by-step example reviewing the

Contact Hyprotech for basics needed to build your first HYSYS.Refinery case. It is also
information on HYSYS recommended that new users read Chapter 1 - Refinery Modeling in
training courses.
the Refinery Modeling manual to get the most of HYSYS.Refinery.
If you are new to HYSYS, you may want to begin by completing one or
more of the HYSYS tutorials, which give the step-by-step instructions
needed to build a simulation case. If you have some HYSYS experience,
but would still like to work through some more advanced sample
problems, refer to the HYSYS Applications.
1-9
1-10 Use of the Manuals
Since HYSYS is totally interactive, it provides virtually unlimited

flexibility in solving any simulation problem. Keep in mind that the
approach used in solving each example problem presented in the
HYSYS documentation may only be one of the many possible methods.
You should feel free to explore other alternatives.
Viewing the Online Documentation

HYSYS online documentation is viewed using Adobe Acrobat Reader®,
which is included on the Documentation CD-ROM. Install Acrobat
Reader 4.0 on your computer following the instructions on the CD-
ROM insert card. Once installed, you can view the electronic
documentation either directly from the CD-ROM, or you can copy the
Doc folder (containing all the electronic documentation files) and the
file named menu.pdf to your hard drive before viewing the files.
Manoeuvre through the online documentation using the bookmarks on

the left of the screen, the navigation buttons in the button bar or using
the scroll bars on the side of the view. Blue text indicates an active link
to the referenced section or view. Click on that text and Acrobat Reader
will jump to that particular section.
Selecting the Search Index

Ensure that your version of One of the advantages in using the HYSYS Documentation CD is the
Acrobat Reader has the ability to do power searching using the Acrobat search tools. The
Search plug-in present. This
plug-in allows you to add a Acrobat Search command allows you to perform full text searches of
search index to the search list. PDF documents that have been indexed using Acrobat Catolog®.
For more information on the
search tools available in To attach the index file to Acrobat Reader 4.0, use the following
Acrobat Reader, consult the procedure:
help files provided with the
program.
1. Open the Index Selection view by selecting Edit-Search-Select
Indexes from the menu.
2. Click the Add button. This will open the Add Index view.
3. Ensure that the Look in field is currently set to your CD-ROM drive
label. There should be two directories visible from the root
directory: Acrobat and Doc.
1-10
Figure 2.2
4. Open the Doc directory. Inside it you should find the Index.pdx
file. Select it and click the Open button.
Figure 2.3
5. The Index Selection view should display the available indexes that
can be attached. Select the index name and then click the OK
button. You may now begin making use of the Acrobat Search
command.
Using the Search Command

The Acrobat Search command allows you to perform a search on PDF
documents. You can search for a simple word or phrase, or you can
expand your search by using wild-card characters and operators.
To search an index, first select the indexes to search and define a search
query. A search query is an expression made up of text and other items
to define the information you want to define. Next, select the
documents to review from those returned by the search, and then view
the occurrences of the search term within the document you selected
1-11
To perform a full-text search do the following:
1. Choose Edit-Search-Query from the menu.

2. Type the text you want to search for in the Find Results Containing
Text box.
3. Click Search. The Search dialog box is hidden, and documents that
match your search query are listed in the Search Results window in
order of relevancy.
4. Double-click a document that seems likely to contain the relevant
information, probably the first document in the list. The document
opens on the first match for the text you typed.
5. Click the Search Next button or Search Previous button to go to
other matches in the document. Or choose another document to
view.
Other Acrobat Reader features include a zoom-in tool in the button bar,
which allows you to magnify the text you are reading. If you wish, you
may print pages or chapters of the online documentation using the
File-Print command under the menu.
1-12
Conventions used in the Manuals

The following section lists a number of conventions used throughout
the documentation.
Keywords for Mouse Actions

As you work through various procedures in the manuals, you will be
given instructions on performing specific functions or commands.
Instead of repeating certain phrases for mouse instructions, keywords
are used to imply a longer instructional phrase.
Keywords Action
These are the normal (default) Move the mouse pointer to position it over an item.
Point
settings for the mouse, but you For example, point to an item to see its Tool Tip.
can change the positions of the Position the mouse pointer over the item, and rapidly
left- and right-buttons. press and release the left mouse button. For
Click
example, click Close button to close the current
window.
As for click, but use the right mouse button. For
Right-Click example, right-click an object to display the Object
Inspection menu.
Position the mouse pointer over the item, then
rapidly press and release the left mouse button
Double-Click
twice. For example, double-click the Hysys.Refinery
icon to launch the program.
Position the mouse pointer over the item, press and
hold the left mouse button, move the mouse while
Drag the mouse button is down, and then release the
mouse button. For example, you drag items in the
current window, to move them.
Whenever you pass the mouse pointer over certain
objects, such as tool bar icons and flowsheet
Tool Tip objects, a Tool Tip will be displayed. It will contain a
brief description of the action that will occur if you
click on that button or details relating to the object.
1-13
A number of text formatting conventions are also used throughout the

manuals:
Format Example
When you are asked to access a HYSYS menu ‘Select File-Save from the
command, the command is identified by bold menu to save your case.’
lettering.
When you are asked to select a HYSYS button, ‘Click the Close button to
the button is identified by bold, italicized close the current view.’
lettering.
When you are asked to select a key or key ‘Press the F1 key on the
combination to perform a certain function, keyboard to open the
keyboard commands are identified by words in context sensitive help.’
bolded small capitals (small caps).
The name of a HYSYS view (also know as a ‘Selecting this command
property view or window) is indicated by bold opens the Session
lettering. Preferences view.’
The names of pages and tabs on various views ‘Click Composition page
are identified in bold lettering. on the Worksheet tab to
see all the stream
composition information.’
The name of radio buttons, check boxes and ‘Click the Ignored check
cells are identified by bold lettering. box to ignore this
operation.’
Note that blank spaces are Material and energy stream names are Column Feed,
acceptable in the names of identified by bold lettering. Condenser Duty
streams and unit operations. Unit operation names are identified by bold Inlet Separator,
lettering. Atmospheric Tower
When you are asked to provide keyboard input, ‘Type 100 in the cell to
it will be indicated by bold lettering. define the stream
temperature.’
Bullets and Numbering

Bulleted and numbered lists will be used extensively throughout the
manuals. Numbered lists are used to break down a procedure into
steps, for example:
1. Select the Name cell.

2. Type a name for the operation.
3. Press ENTER to accept the name.
1-14
Bulleted lists are used to identify alternative steps within a procedure,

or for simply listing like objects. A sample procedure that utilizes
bullets is:
1. Move to the Name cell by doing one of the following:

• Select the Name cell
• Press ALT+N
2. Type a name for the operation.
3. Press ENTER to accept the name.
Notice the two alternatives for completing Step 1 are indented to

indicate their sequence in the overall procedure.
A bulleted list of like objects might describe the various groups on a

particular view. For example, the Options page of the Simulation tab on
the Session Preferences view has three groups, namely:
• General Options
• Errors
• Column Options
Callouts
A callout is a label and arrow that describes or identifies an object. An
example callout describing a graphic is shown below.
Figure 2.4
HYSYS.Refinery
Icon
Annotations
Annotation text appears in the Text appearing in the outside margin of the page supplies you with
outside left page margin. additional or summary information about the adjacent graphic or
paragraph. An example is shown to the left.
1-15
Shaded Text Boxes

A shaded text box provides you with important information regarding
HYSYS’ behaviour, or general messages applying to the manual.
Examples include:
The resultant temperature of the mixed streams may be quite

different than those of the feed streams, due to mixing effects.
Before proceeding, you should have read the introductory

section which precedes the example problems in this manual.
The use of many of these conventions will become more apparent as

you progress through the manuals.
1-16
2.4 Technical Support

There are several ways in which you can contact Technical Support. If
you cannot find the answer to your question in the manuals, we
encourage you to visit our website at www.hyprotech.com, where a
variety of information is available to you, including:
• answers to frequently asked questions

• example cases and product information
• technical papers
• news bulletins
• hyperlink to support email
You can also access Support directly via email. A listing of Technical
Support Centres including the Support Email address is at the end of
this chapter. When contacting us via email, please include in your
message:
• Your full name, company, phone and fax numbers.

• The version of HYSYS you are using (shown in the Help, About
HYSYS view).
• The serial number of your HYSYS security key.
• A detailed description of the problem (attach a simulation case
if possible).
We also have toll free lines that you may use. When you call, please have
the same information available.
1-17
1-18 Technical Support
Technical Support Centres

Calgary, Canada
AEA Technology - Hyprotech Ltd. support@hyprotech.com (email)
Suite 800, 707 - 8th Avenue SW (403) 520-6181 (local - technical support)
Calgary, Alberta 1-888-757-7836 (toll free - technical support)
T2P 1H5 (403) 520-6601 (fax - technical support)
1-800-661-8696 (information & sales)
Barcelona, Spain (Rest of Europe)

AEA Technology - Hyprotech Ltd. support@hyprotech.com (email)
Hyprotech Europe S.L. +34 93 215 68 84 (technical support)
Pg. de Gràcia 56, 4th floor 900 161 900 (toll free - technical support - Spain only)
E-08007 Barcelona, Spain +34 93 215 42 56 (fax - technical support)
+34 93 215 68 84 (information & sales)
Oxford, UK (UK clients only)

AEA Technology Engineering Software support@hyprotech.com (email)
Hyprotech 0800 7317643 (freephone technical support)
404 Harwell, Didcot +44 1235 434351 (fax - technical support)
Oxfordshire, OX11 0RA +44 1235 435555 (information &
United Kingdom sales)
Kuala Lumpur, Malaysia

AEA Technology - Hyprotech Ltd.
Hyprotech Ltd., Malaysia
Lot E-3-3a, Dataran Palma support@hyprotech.com (email)
Jalan Selaman ½, Jalan Ampang +60 3 470 3880 (technical support)
68000 Ampang, Selangor +60 3 471 3811 (fax - technical support)
Malaysia +60 3 470 3880 (information & sales)
Yokohama, Japan
AEA Technology - Hyprotech Ltd.
AEA Hyprotech KK
Plus Taria Bldg. 6F.
3-1-4, Shin-Yokohama
Kohoku-ku support@hyprotech.com (email)
Yokohama, Japan 81 45 476 5051 (technical support)
222-0033 81 45 476 5051 (information & sales)
1-18
Offices
Calgary, Canada Yokohama, Japan
Tel: (403) 520-6000 Tel: 81 45 476 5051
Fax: (403) 520-6040/60 Fax: 81 45 476 3055
Toll Free: 1-800-661-8696
Newark, DE, USA Houston, TX, USA

Tel: (302) 369-0773 Tel: (713) 339-9600
Fax: (302) 369-0877 Fax: (713) 339-9601
Toll Free: 1-800-688-3430 Toll Free: 1-800-475-0011
Oxford, UK Barcelona, Spain

Tel: +44 1235 435555 Tel: +34 93 215 68 84
Fax: +44 1235 434294 Fax: +34 93 215 42 56
Oudenaarde, Belgium Düsseldorf, Germany

Tel: +32 55 310 299 Tel: +49 211 577933 0
Fax: +32 55 302 030 Fax: +49 211 577933 11
Hovik, Norway Cairo, Egypt

Tel: +47 67 10 6464 Tel: +20 2 517 0787
Fax: +47 67 10 6465 Fax: +20 2 352 0289
Kuala Lumpur, Malaysia Seoul, Korea

Tel: +60 3 470 3880 Tel: 82 2 3453 3144 5
Fax: +60 3 470 3811 Fax: 82 2 3453 9772
1-19
1-20 Technical Support
Agents
International Innotech, Inc. Tel: (281) 492-2774
Katy, USA Fax: (281) 492-8144
International Innotech, Inc. Tel: 86 10 6499 3956
Beijing, China Fax: 86 10 6499 3957
International Innotech Tel: 886 2 809 6704
Taipei, Taiwan Fax: 886 2 809 3095
KBTECH Ltda. Tel: 57 1 258 44 50
Bogota, Colombia Fax: 57 1 258 44 50
KLG Systel Tel: 91 124 346962
New Delhi, India Fax: 91 124 346355
Logichem Process Tel: 27 11 465 3800
Johannesburg, South Africa Fax: 27 11 465 4548
Process Solutions Pty. Ltd. Tel: 61 7 544 81 355
Peregian, Australia Fax: 61 7 544 81 644
Protech Engineering Tel: +421 7 4488 8286
Bratislava, Slovak Republic Fax: +421 7 4488 8286
PT. Danan Wingus Sakti Tel: 62 21 567 4573 75/62 21 567 4508 10
Jakarta, Indonesia Fax: 62 21 567 4507/62 21 568 3081
Ranchero Services (Thailand)
Co. Ltd. Tel: 66 2 381 1020
Bangkok, Thailand Fax: 66 2 381 1209
S.C. Chempetrol Service srl Tel: +401 330 0125
Bucharest, Romania Fax: +401 311 3463
Soteica De Mexico Tel: 52 5 546 5440
Mexico D.F., Mexico Fax: 52 5 535 6610
Soteica Do Brasil Tel: 55 11 533 2381
Sao Paulo, Brazil Fax: 55 11 556 10746
Soteica S.R.L. Tel: 54 11 4555 5703
Buenos Aires, Argentina Fax: 54 11 4551 0751
Soteiven C.A. Tel: 58 2 264 1873
Caracas, Venezuela Fax: 58 2 265 9509
ZAO Techneftechim Tel: +7 095 202 4370
Moscow, Russia Fax: +7 095 202 4370
Internet
Website: www.hyprotech.com
Email: info@hyprotech.com
1-20
Installing HYSYS.Refinery 2-1
2 Installing HYSYS.Refinery
2.1 Basic Requirements
The following system requirements will ensure satisfactory
performance by HYSYS on reasonably sized simulations.
System Component Requirement

Minimum usable: Pentium® 200Mhz
Microprocessor
Recommended: Pentium® II or better
Microsoft® Windows® 95/98, Windows® 2000, or
Operating System
Windows NT® 4.0 with Service Pack 5 or later
128 MB of available RAM on Windows® 95/98, Windows® 2000, or
Physical Memory
Windows NT® 4.0 with Service Pack 5 or later (256 MB recommended)
>300 MB of total memory (RAM+Virtual Memory) on Windows® 95/98,
Total Memory
Windows® 2000, or Windows NT® 4.0 with Service Pack 5 or later
Approximately 60 MB of free hard disk space is required for a full
Disk Space
installation with all options.
The GREEN security key used with the "standalone key" version of
HYSYS can only be attached to a serial communications port of the
Serial Port
computer running the application (do not plug in a serial mouse behind
the security key).
The BEIGE security key used with the "network key" version of HYSYS
Parallel Port must be attached to the parallel communications port of a computer on
the network.
Minimum usable: SVGA (800x600)
Monitor/Video
Recommended: SVGA (1024x768)
Keyboard Enhanced (101 key) keyboard.
Required. Note that a mouse cannot be plugged into the back of the
Mouse
green serial port key used with the "standalone" version of HYSYS.
If you wish to install the refinery reactor calibration applications, you

will also need to have Microsoft Excel© 97 or later installed.
2-1
2-2 Installing HYSYS
2.2 Installing HYSYS

The following instructions are written assuming installation on
Windows 2000/NT 4.0 or Windows 95/98.
The HYSYS installation program creates files mainly in the directory

specified to it during the installation setup procedure, with the
exception of a number of system dlls that may be added to the
Windows system directory.
For Windows NT installations, the program should be installed

from a user account with administrator rights.
1. Shut down all other operating Windows programs on the computer

before starting the installation process.
2. Insert the HYSYS software CD into the CD-ROM drive of the
computer.
Note that for computers which have the CD-ROM Autorun

feature enabled, steps #3 and #4 will be automatically
performed.
3. From the Start Menu, select Run

4. In the Run dialog box, type: d:\setup.exe and click on the OK
button (where d: corresponds to the drive letter of the CD-ROM
drive).
5. Follow the on-screen instructions to proceed with installation
using the Next button to proceed from screen to screen. The
Product Install Code (PIC) requested by the installation program is
located on a sticker affixed to the CD case. The PIC controls
2-2
whether a “Standalone Key” version (see Section 2.3 - The

Standalone Key Version of HYSYS) or “Network Key” version (see
Section 2.4 - The Network Key Version of HYSYS) is installed.
Figure 2.1
6. The next screen allows you to choose the destination location to

install HYSYS. Either select the default or choose another directory.
To install the refinery reactor
7. Next, select the type of setup you wish to install. If you wish to
calibration applications ,
choose the Custom setup install the refinery reactor calibration applications (hosted in
option, then on the following Microsoft Excel), the Custom option should be selected as shown
screen select the Calibration below.
component.
Figure 2.2
2-3
2-4 The Standalone Key Version of HYSYS
8. Once the installer has completed copying the program files to the
Note that Step 8 is done up
specified directory, it will perform a check of the versions of several
front and may result in the
installer suggesting a reboot. Windows files required for OLE interaction between HYSYS and
other applications. If warranted, the installation program will
suggest updating these files. Follow the on-screen instructions. For
more information on this topic, review the HYSYS README.WRI
file.
2.3 The Standalone Key

Version of HYSYS
The standalone key version of HYSYS checks for the presence of a GREEN
AEA Technology hardware security key on the serial (COM) port of the
computer running the software. If you are using a BEIGE Rainbow
Technologies Inc. NetSentinel-C security key refer to Section 2.4 - The
Network Key Version of HYSYS.
Connecting the Security Device

The arrow on the label indicates the proper orientation of the key (the
arrow must point towards the computer). The key can be plugged into
either a 9-pin or 25-pin serial port. AEA Technology ships a 9 to 25-pin
Do not plug a serial mouse converter with the key but a standard modem cable can also be used.
into the back of the green AEA
Technology security key.
The ports on the rear of many PCs are unlabelled. For the serial ports (9
or 25-pin) the "pins" of the connector are visible. For the parallel port
and the video port where the monitor is plugged in, a "socket" type
connector can be seen. To prevent damage, all equipment should be
switched off when connecting/disconnecting devices from ports on the
computer.
The security key has limited pass-through capabilities. Certain other

serial peripherals may be connected to the back of the key to allow
non-concurrent use of the security key and the peripheral. Do not plug
a serial mouse into the back of the key. The mouse will operate, but
HYSYS will be unable to find the key.
2-4
2.3.1 HYSYS Installation to a

Network Server
The following discussion is optional and applies to both the

standalone key and network key versions of HYSYS.
If HYSYS is to be run on a relatively large number of computers, it may

be advantageous to install the software on a network server rather than
on individual computer hard disks.
The disadvantage of installing the software on a network server is that

HYSYS startup will be slower as the program is loaded over the network
from the hard disk of the server into the memory on the local computer.
Except for the fact that it
searches for a security key on
the network, rather than on a Installing HYSYS onto a server follows exactly the same process as
serial port of the local outlined in the previous section. Simply choose the network drive
computer, the network key instead of the local drive when on the Select Components screen. To
version of HYSYS is identical
to the standalone key version. prevent accidental modification or deletion of files, it is recommended
that HYSYS users be allowed read-only access to the software. Each
HYSYS user should then configure an individual preferences file as
follows and store that file on their local hard disk (or write-enabled
network drive).
To run HYSYS on users’ computers,
1. Create a shortcut to HYSYS.EXE (on the desktop or in the Start

menu).
2. Set the Start In directory to a directory on the local hard disk (e.g.
C:\AEA Technology\HYSYS). On startup, HYSYS will search this
directory for the user's preferences file (HYSYS.PRF).
3. In this directory, create the subdirectories CASES, PAKS and USER.
4. Start HYSYS and, from the menu bar, select Tools, then
Preferences.
5. Go to the Files tab of the Session Preferences view and select
Locations.
2-5
6. Configure the Default Files and Paths as is shown in the

accompanying Figure 2.3. These are suggestions only and some
modification may be required depending on the circumstances.
Figure 2.3
7. Select the Save Preference Set button, and direct the file save
operation to the HYSYS working directory on the local disk.
2.3.2 Potential Problems Starting

the Standalone Key Version
of HYSYS
HYSYS displays the message "Error X: This Security

Key has an Invalid Serial Number. (Error sub-code
X)"
The HYSYS software is coded to operate with either a single security key
or a group of security keys in use at your organization. Check the
Product Install Code label on the CD case for the number of the security
key for which the Product Install Code was produced. If the security key
number on the label matches that on the key being used, contact AEA
Technology for resolution of the problem.
2-6
If the security key number on the label does not match that of the key,
but you believe that this key is one of a group of keys that are
interchangeable, contact AEA Technology for resolution of the
problem. When contacting AEA Technology, provide both the security
key number and the Product Install Code.
HYSYS displays "Error X: Cannot find a Security Key

on a serial port of this computer. (Error sub-code X)".
Use the following checklist to diagnose the problem:
1. Check that the green AEA Technology security key is correctly

connected to the serial port of the computer.
The arrow on the key must point towards the computer. If it is

pointing away from the computer, it is plugged into the parallel
port (connecting the key to the parallel port may de-program the
key).
While the key can connect directly to a 25-pin serial port, a

converter (supplied with the key) is required to attach the key to a
9-pin serial port. A standard external modem cable can also be
used for this purpose. Consider the possibility that the fault lies in
the cable, if one is being used.
2. Ensure that a serial mouse is not plugged into the back of the key.
The mouse will work, but HYSYS will not find the security key.
3. Check for another operating Windows program that is configured
to use the serial port. There does not need to be an external device
(e.g. modem) actually connected to the port for this to be the
problem. A recurring problem which fits this description is
monopolization of the serial port by the “hotlink” software for
personal digital assistants (PDA) like the Palm Pilot.
4. If HYSYS still cannot see the security key, the two possibilities that
remain are that the key has been de-programmed (they are quite
robust and this rarely occurs) or the serial port of the computer is
non-functional (disabled, misconfigured or suffering from a
hardware problem).
If the opportunity exists, this is a good time to install the software

and key on another computer(s). If HYSYS still cannot see the key
on a second computer, there is a good possibility that the key is
non-functional.
Another valid test is to check the key on another computer that has
other AEA Technology software installed that also uses the same
kind of key (most AEA Technology "standalone" software uses the
same green hardware key). Even if not configured to work with this
2-7
new key, the software will display an error message making it

obvious whether or not the key was found. If the key is found by the
software, the error message will be similar to “Invalid Serial
Number” or “This security key is not licensed to run this program.”
If the software does not see the key, the error message will be of the
form, “Could not find security device.” If the key cannot be found
by AEA Technology software on several computers, you should
contact AEA Technology Technical Support for further
information.
If HYSYS is able to see the security key on another computer, then

the problem on the first computer lies with the serial port. Contact
your company’s IT personnel for assistance in solving this
problem. Because these problems are machine specific, AEA
Technology's Technical Support staff can be of limited assistance.
These cases and are best handled by on-site personnel.
Security Key Tips for IT Personnel
An excellent test (Win 2000/NT/98/95) to determine if the serial

port is functional is to disconnect the normally used mouse and
attach a serial mouse to the port. If Windows reports that a mouse
could not be found on startup, then the port is not working. If
Windows does find the mouse, the port itself may still be disabled,
preventing its use by other peripherals, so that needs to be checked
(in the CMOS setup). Windows will "override the disable" on the
port if it finds a mouse there.
It is not a valid test to disconnect a working serial mouse on a

powered-up Windows computer, connect the security key in its
place, and start HYSYS. Windows will still be holding the port for
exclusive use by the mouse, so HYSYS will not find the key in this
situation. To test the key on a serial port which normally services a
serial mouse, restart the computer with the key in place of the
mouse. Use keyboard commands to initiate HYSYS (Ctrl-Esc opens
the "Start" menu, then use the arrow keys to manoeuvre through
the menus, and Enter to select the software).
As portable computers become more prevalent, a recurring

problem reported to AEA Technology Technical Support involves
the infrared (IR) communications port common to many
portables. Most portables can have either the single serial port OR
the IR port enabled, but not both. Check the CMOS setup or the
manufacturer's configuration utility to confirm that the serial port
is enabled and the IR port disabled.
5. Very rarely, the key and the serial port are proven to be working
properly, but HYSYS is still unable to find the key. In this instance,
try starting the software with a command line option that tells it on
2-8
which COM port the key is located. Open Windows Explorer and
navigate to the HYSYS directory. Right-click on HYSYS.EXE and
select "Create Shortcut" from the menu. Once the shortcut has
been created, right-click on it and select "Properties" from the
menu. Go to the "Shortcut" page and modify the "Target:" to the
format:
"C:\Program Files\AEA Technology\HYSYS\HYSYS.EXE" -c2
The path may be different on your computer. Note the location of

the double-quotes required because of the space in "Program
Files". Use -c1 for COM1, etc. Initiate HYSYS by double-clicking on
the shortcut. The main HYSYS item in the Windows Start Menu is
also a shortcut, located in the Windows directory. This shortcut can
be modified instead, if desired.
6. If all else fails, the addition of a very inexpensive serial expander
card may be the solution to the problem (for desktop computers, of
course). This has solved several unexplained problems in accessing
what appear to be perfectly functional on-board serial ports.
2.4 The Network Key

Version of HYSYS
Except for the fact that it searches for a security key on the
network, rather than on a serial port of the local computer, the
network key version of HYSYS is identical to the standalone key
version. Because of the added complexity involved in setting up
the central resource that manages the multi-user network key,
it is recommended that the setup of the network key version of
HYSYS be undertaken by your organization’s IT personnel.
The network version of HYSYS uses a BEIGE Rainbow Technologies Inc.

NetSentinel-C security key to allow centralized management of licenses
required to run the application. The key is attached to the parallel port
of a computer on the network (the "keyserver" computer). Keyserver
software is run on that computer to manage requests from HYSYS users
on the network for access to licenses on the key. If you are using a GREEN
AEA Technology hardware security key refer to Section 2.3 - The
Standalone Key Version of HYSYS.
On program startup, the network key version of HYSYS inquires from

the keyserver computer over the network if a license is available. If a
license is available, it is allocated to that user, and the number of
available licenses on the key is decreased by one.
2-9
2-10 The Network Key Version of HYSYS
2.4.1 Quick Start - Using the

Network Key in Local Mode
A useful feature with the network key version of HYSYS is the ability to
use the network key as a "standalone" (single-user) HYSYS key. That is,
the key can be used to enable the operation of HYSYS on a single
computer. No network connection or keyserver software is required.
On Windows 2000/NT computers, it is necessary to install the

NetSentinel System Driver Software - see Section - Install the
NetSentinel System Driver Software for more information.
Once the network key is attached to the parallel port of the computer,
start the network key version of HYSYS with the command line option
"-local" to enable local mode. To do this perform the following steps.
1. Open the Windows Explorer and navigate to the HYSYS directory.

2. Right-click on HYSYS.EXE and select Create Shortcut from the
menu.
3. Once the shortcut has been created, right-click on it and select
Properties from the menu.
4. Go to the Shortcut page and modify the Target to the format:
“C:\Program Files\AEA Technology\HYSYS\HYSYS.EXE" -local
The path may be different on your computer. Note the locations of the
double-quotes required because of the space between “Program” and
“Files”. If there are no spaces in the path name quotes are not required.
Initiate HYSYS in local mode by double-clicking on the shortcut. The

main HYSYS item in the Windows Start Menu is also a shortcut, located
in the Windows directory. This shortcut can be modified instead, if
desired.
2.4.2 Setting Up the Network Key

for Normal Operation
The following discussion assumes the use of a Windows 2000/NT/98/
95 computer as the “keyserver computer” (the computer with the
network key attached to it). For other operating systems, please consult
the Rainbow Technologies website at http://www.rainbow.com.
2-10
Because the keyserver computer must be operational for HYSYS users

to run their software, the best choice for the keyserver computer is a
one that is left on continually. The most trouble-free installation will
result from a keyserver computer used only for the keyserver function.
This avoids conflicts with other software.
Note that the keyserver computer does not need to be a powerful or fast
computer. The powerful personal computer of a HYSYS user is one of
the poorer choices for the keyserver computer. This computer can be
switched off behind locked doors for the weekend, rebooted after
lockup in another software program (terminating HYSYS users), or
require reconfiguration to suit the needs of a new software program,
causing difficulties for existing programs (like the keyserver software).
Install the Key on the Key Server Computer

To avoid damage to the computer or key, the computer should be
powered down before installation of the network key. Install the key on
the parallel port (printer port) of the computer that will be performing
the keyserver function. The key has an arrow on it, indicating which
end should be plugged into the computer.
It is possible to cascade two or more Rainbow NetSentinel-C keys on

the same port if those two keys have different family codes. The family
code is an identifier burned into the key by the manufacturer. A utility
program from Rainbow Technologies for interrogating a NetSentinel-C
key for the family code is available from AEA Technology Technical
Support (support@software.aeat.com).
Install the NetSentinel System Driver

Software
The Rainbow NetSentinel System Driver software is required only on
computers that have the network key attached. This will generally be
only the keyserver computer, but could include computers on which
HYSYS is run in "local" mode (see Section 2.4.1 - Quick Start - Using
the Network Key in Local Mode). The System Driver software enables
communication with the key, either by the keyserver software or by
HYSYS itself, when run in "local" mode.
Windows 2000/NT computers require the System Driver software. On

Windows 98/95, the System Driver software may or may not be
required. Try operation without the System Driver software, but if the
keyserver software or HYSYS in local mode is unable to find the key,
load the System Driver software as the first diagnostic step.
2-11
To install the System Driver software on Windows 2000/NT, run

SETUPX86.EXE located in the \NETDISK\DRIVERS\WIN_NT
subdirectory of the HYSYS software CD.
To install the System Driver software on Windows 98/95, run

SSNTW9X.EXE located in the \NETDISK\DRIVERS\WIN_9X
subdirectory of the HYSYS software CD.
Install and Run the NetSentinel Keyserver

Software
There are two choices of keyserver software that can be run on the
keyserver computer. Do not run both of them. The following table
describes the capabilities of each.
KeyServer Software Configuration

Can be run on Windows 2000/NT/98/95.
Concurrently supports TCP/IP, IPX/SPX, NetBIOS
NSRVGX.EXE and NetBEUI as network protocals.
Provides an interface screen indicating usage of
licenses
Can be run on Windows 2000/NT.
Concurrently supports TCP/IP, IPX/SPX, NetBIOS
and NetBEUI as network protocals.
NSSRVICE.EXE Because it runs as a service, it does not require a
network logon of the computer.
Does NOT provide an interface screen indicating
usage of licenses.
To Install NSRVGX.EXE
1. Copy NSRVGX.EXE from the \NETDISK\SERVERS\WIN32
subdirectory of the HYSYS software CD to a location on the hard
disk of the keyserver computer.
Known problems with NSRVGX.

• The directory path to NSRVGX cannot contain spaces, or the
application will fail to start, displaying “ERROR: Extra command line
parameter ignored...”.
• On Windows 98/95 computers, the screen-saver must be disabled to
prevent a conflict resulting in extremely slow performance by the
keyserver software
2. Execute NSRVGX.EXE. The following table lists all available

command line options. NSRVGX.EXE displays a copyright message
as it loads. The program will load minimized. To view connection
information, maximize the server.
2-12
3. To unload NSRVGX.EXE, close the program.
NSRVGX.EXE Command Line Options
Option Description
Overrides the default "Find_Server" UDP broadcast
mask to limit the search over TCP/IP to within a
/BI:<mask>
specified subnet mask. (The default is set at
255.255.255.255.)
Changes the server’s department name from
/DN:<name>
NETINEL to <name>.
Sets the maximum number of licenses that can be in
use at any one time on this server to <nnn>. The
default is 150.
Your effective license limit is the smaller of (1) the
/H:<nnn> number you set here and (2) the sum of the limits of
the keys connected to this server. Specifying a limit
higher than what the attached keys support has no
effect. Specifying a limit lower than what the
attached keys support effectively disables some
licenses.
Sets the maximum number of servers running this
server’s department name and using this server’s
protocol to <nnn>. The indicated value ranges from 1
/MS:<nnn>
to 5, and is used to determine the range of server
names. A value of 5, for example, causes servers to
be named NETINEL0 through NETINEL4.
Sets the name displayed by the monitor for this
server to <name>. The default is your computer’s
/N:<name>
Ethernet address (NetBIOS) or IPX node number
(NetWare).
Suppresses the copyright message when the server
/Q
is being loaded.
Defines the number of retry operations when
/RI:<num> searching for servers running over TCP/IP. The
default is 3.
Sets the number of threads devoted to handling
TCP/IP clients to <nnnn>. Values range from 0 to 4;
/SI:<nnnn>
the default is 4. Specifying /SI:0 disables all TCP/IP
support.
Defines the number of entries in the sub-license
/SL:<nnnn>
table. Applies to the NetSentinel-C only.
NetBIOS/NetBEUI clients to <nnnn>. Values range
/SN:<nnnn>
from 0 to 4; the default is 4. Specifying /SN:0
disables all NetBIOS/NetBEUI support.
2-13
Option Description
Enables strict license time-out enforcement. If this
option is set, active licenses are immediately
revoked and made available for reuse if no query is
performed within the key’s configured time-out
/ST
interval. Subsequent use of the handle yields an
error. By default, a timed-out license is revoked only
if a handle is requested and no other licenses are
available.
Sets the number of threads devoted to handling IPX/
SPX (NWLINK) clients to <nnnn>. Values range from
/SW<nnnn>
0 to 4; the default is 4. Specifying /SW:0 disables all
IPX/SPX (NWLINK) support.
Sets a password of up to 12 characters. If the server
is set with a password option, that password will be
required by the monitor, whenever licenses are
/W:<password>
being deleted. If the server is not set to require a
password, the server will delete all licenses from the
monitor without requiring a password.
Sets the timeout value in seconds for each retry
/TI:<num> operation when searching for servers running over
TCP/IP. The default is 5.
To Install NSSRVICE.EXE
1. Copy NSSRVICE.EXE from the directory
\NETDISK\SERVERS\WIN32 to the Windows NT\System32
directory.
2. To install the service, run the NSSRVICE.EXE executable with "/i"
command line option, i.e. NSSRVICE /i.
3. After installation, a registry entry for the NetSentinel service is

created under:
KEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
4. By default, the service is configured to run automatically the next

time the system is restarted. No user logon is required, unless
desired. Configuration can be made via Control Panel -> Services->
NetSentinel.
Service Event Logging

Status information pertaining to this service is reported to the
application log. Upon successful startup of the service, information
such as server version, protocol stacks, and available keys is logged as
two separate events in the application log. Access Event Viewer in the
Administrator Tools group to view this information.
2-14
NSSRVICE.EXE Command Line Options

(used when installing the service in addition to “/i”).
Option Description
Overrides the default "Find_Server" UDP broadcast
mask to limit the search over TCP/IP to within a
/BI:<mask>
specified subnet mask. (The default is set at
255.255.255.255).
Changes the server’s department name from
/DN:<name>
NETINEL to <name>.
Sets the maximum number of licenses that can be in
use at any one time on this server to <nnn>. The
default is 150.
Your effective license limit is the smaller of (1) the
/H:<nnn> number you set here and (2) the sum of the limits of
the keys connected to this server. Specifying a limit
higher than what the attached keys support has no
effect. Specifying a limit lower than what the
attached keys support effectively disables some
licenses.
Sets the maximum number of servers running in this
server’s department name and using this server’s
protocol to <nnn>. The indicated value ranges from 1
/MS:<nnn>
to 5, and is used to determine the range of server
names. A value of 5, for example, causes servers to
be named NETINEL0 through NETINEL4.
Sets the name displayed by the monitor for this
server to <name>. The default is your computer’s
/N:<name>
Ethernet address (NetBIOS) or IPX node number
(NetWare).
Defines the number of retry operations when
/RI:<num> searching for servers running over TCP/IP. The
default is 3.
TCP/IP clients to <nnnn>. Values range from 0 to 4;
/SI:<nnnn>
the default is 4. Specifying /SI:0 disables all TCP/IP
support.
Defines the number of entries in the sub-license
/SL:<nnnn>
table. Applies to the NetSentinel-C only.
NetBIOS/NetBEUI clients to <nnnn>. Values range
/SN:<nnnn>
from 0 to 4; the default is 4. Specifying /SN:0
disables all NetBIOS/NetBEUI support.
Enables strict license time-out enforcement. If this
option is set, active licenses are immediately
revoked and made available for reuse if no query is
performed within the key’s configured time-out
/ST
interval. Subsequent use of the handle yields an
error. By default, a timed-out license is revoked only
if a handle is requested and no other licenses are
available.
2-15
Option Description
Sets the number of threads devoted to handling IPX/
SPX (NWLINK) clients to <nnnn>. Values range from
/SW:<nnnn>
0 to 4; the default is 4. Specifying /SW:0 disables all
IPX/SPX (NWLINK) support.
Lets a password of up to 12 characters. If the server
is set with a password option, that password will be
required by the monitor, whenever licenses are
/W:<password>
being deleted. If the server is not set to require a
password, the server will delete all licenses from the
monitor without requiring a password.
Sets the timeout value in seconds for each retry
/TI:<num> operation when searching for servers running over
TCP/IP. The default is 5.
S/I Installs the service.
/U Uninstalls the service.
/V Displays the version number
2.4.3 HYSYS Installation to a

Network Server
The following discussion is optional and applies to both the
standalone key and network key versions of HYSYS.
If HYSYS is to be run on a relatively large number of computers, it may

be advantageous to install the software on a network server rather than
on individual computer hard disks.
The disadvantage of installing the software on a network server is that

HYSYS startup will be slower as the program is loaded over the network
from the hard disk of the server into the memory on the local computer.
Except for the fact that it
searches for a security key on
the network, rather than on a Installing HYSYS onto a server follows exactly the same process as
serial port of the local outlined in the previous section. Simply choose the network drive
computer, the network key instead of the local drive when on the Select Components screen. To
version of HYSYS is identical
to the standalone key version. prevent accidental modification or deletion of files, it is recommended
that HYSYS users be allowed read-only access to the software. Each
HYSYS user should then configure an individual preferences file as
follows and store that file on their local hard disk (or write-enabled
network drive).
2-16
To run HYSYS on users’ computers,
1. Create a shortcut to HYSYS.EXE (on the desktop or in the Start

menu).
2. Set the Start In directory to a directory on the local hard disk (e.g.
C:\AEA Technology\HYSYS). On startup, HYSYS will search this
directory for the user's preferences file (HYSYS.PRF).
3. In this directory, create the subdirectories CASES, PAKS and USER.
4. Start HYSYS and, from the menu bar, select Tools, then
Preferences.
5. Go to the Files tab of the Session Preferences view and select
Locations.
6. Configure the Default Files and Paths as is shown in the
accompanying Figure 2.4. These are suggestions only and some
modification may be required depending on the circumstances.
Figure 2.4
7. Select the Save Preference Set button, and direct the file save
operation to the HYSYS working directory on the local disk.
2-17
2.4.4 Potential Problems Running

the Network Key Version of
HYSYS
While using TCP/IP as the network communications

protocol, HYSYS.Network is unable to connect to
the network security key.
Unless directed to do otherwise, HYSYS generates a general broadcast
message on startup, in search of the keyserver computer. Depending on
the IP address of client and keyserver computer, broadcast mask in use
and router configuration on the network, this general broadcast
message may not be received at the keyserver computer. To resolve this
problem, HYSYS can be configured to send a directed message to the IP
address of the keyserver. To do this, create a text file called HYSYS.INI in
the main HYSYS directory (e.g. C:\Program Files\AEA
Technology\HYSYS) containing the following two lines (making the
appropriate IP address substitution).
[RainbowKey]
BroadcastAddress=192.139.200.134
Note the square brackets on the first line and the lack of any spaces on
the second line. This fix will not impact on WINMON’s (the monitor
tool installed with the network key version of HYSYS) failure to
communicate with a network keyserver.
While using IPX/SPX as the network communications

protocol, HYSYS.Network is unable to connect to
the network security key.
Check to see if routers between the client and keyserver computer are
filtering SAP broadcast messages with an ID of 0361.
There is a suspicion that other operating copies of

the keyserver software on the network are
interfering with the ability of HYSYS.Network to
connect to its network key.
Unless directed to do otherwise via a command line option, the
keyserver software initiates with the default "department name" of
NETINEL.
2-18
It is necessary for each keyserver to have a unique identifier. To ensure

this, the keyserver software broadcasts a message on startup requesting
that like-department-named keyservers respond. If no other keyservers
respond, an initiating copy of the keyserver software using the default
"NETINEL" department name would take the unique name NETINEL0.
If a previously operating NETINEL0 had responded to the broadcast
message generated by this copy of the keyserver software on startup,
this second keyserver would have taken the name NETINEL1.
There can be a maximum of five keyservers with the same department

name visible to each other on the network (the defaults would be
NETINEL0 - NETINEL4). Unless directed to do otherwise, when HYSYS
initiates, it begins its search for its network key by interrogating
NETINEL0, followed by NETINEL1 and so on up to NETINEL4.
The network key technology used by HYSYS is used by other non-AEA

Technology software. It is possible that another "NETINEL" named
keyserver cannot be added to the network for use with the HYSYS key
because there are already five operating keyservers. It is also possible
(although unlikely) that some configuration issue on the network
allows, for example, a NETINEL0 keyserver to be initiated servicing the
HYSYS key while at the same time there is a pre-existing NETINEL0
keyserver servicing another key on the network.
To move away from the default "NETINEL" department name for

HYSYS.Network, modifications must be made to the keyserver
software, the monitor software (WINMON.EXE) and to HYSYS itself.
Use the command line option "/dn:" to specify a non-default

department name for the keyserver software on startup.
The easiest way to reconfigure WINMON.EXE to search for non-default

department-named keyservers is to directly edit the configuration file
MAPFILE.TXT.
To direct HYSYS to search for non-default named keyservers, create a

text file called HYSYS.INI in the main HYSYS directory (e.g. C:\Program
Files\AEA Technology\HYSYS) containing the following two lines
(making the appropriate substitution for the work "HYSYS", if desired).
[RainbowKey]
DepartmentName=HYSYS
2-19
Note the square brackets on the first line and the lack of any spaces on
the second line. Multiple entries can be make in the [RainbowKey]
section of the HYSYS.INI file, as follows.
[RainbowKey]
DepartmentName=HYSYS
BroadcastAddress=192.139.200.134
HYSYS displays the message "Error X: No more

users are allowed on this Network Security key or
there are no valid operating AEA Technology
network Security Keys. Use one of the supplied
Rainbow Technologies key monitoring programs for
further information. (Error sub-code -10)"
Other software also uses the third-party network keys used with HYSYS.
Every AEA Technology NetSentinel-C key has an Algorithm ID of 498D
(one of the parameters displayed in the WINMON interface). When
HYSYS started up and searched on the network for operating copies of
the keyserver software, it found one of two possible things.
1. It didn’t find any copies of the keyserver software that were

servicing 498D keys, but it did find one or more that were servicing
non-498D keys.
2. It did find a 498D key, but all of the licenses on the key were in use.
HYSYS displays the message "Error X: Cannot find a

Security Key Server on the network. No operating
copies of the necessary Security Key Software can
be found. (Error sub-code -12)
When HYSYS started up, it looked for operating copies of the
appropriately department-named keyserver software on the network,
but didn’t find any. Running WINMON.EXE at this point, on the same
computer, should yield the same results, assuming that HYSYS and
WINMON are configured to search for keyservers of the same
“department name.” Check the first two items in this trouble-shooting
section for reasons as to why this may be happening.
2-20
HYSYS displays the message "Error X: A AEA

Technology network Security Key was found that
has an Invalid Serial Number. No more licenses were
available on other valid AEA Technology network
Security Keys. Use one of the supplied Rainbow
Technologies key monitoring programs for further
information. (Error sub-code -14)"
HYSYS found a 498D (AEA Technology) key, gained a license on it,
interrogated the key to ensure that the key was coded for operation
with this software, discovered that was not the case, released the license
on that key, went looking for another, and didn’t find one.
HYSYS displays the message "Error X: Invalid

Network Protocol selection for connection to the
network Security Key. (Error sub-code -19)"
If operating HYSYS in "local" mode, ensure that the "NetSentinel
System Driver Software" has been installed. If operating in normal
network mode, this error message indicates that HYSYS is unable
access the network protocols on the computer.
2-21
2-22
Get Started 3-1
3 Get Started
This first Get Started chapter gives a quick introduction to some of the
features incorporated into both the standard HYSYS.Process
application and the enhanced HYSYS.Refinery application.
To get the most out of
HYSYS.Refinery, it is strongly HYSYS.Refinery uses the same interface, solving mechanisms,
suggested that new users read thermodynamics, and other technology found in HYSYS.Process but
Chapter 1 - Refinery Modeling in also contains additional methods for characterizing the measurements
the Refinery Modeling manual
which describes the necessary and properties of hydrocarbon materials. In HYSYS.Refinery, the
background concepts important refinery physical property system and associated refinery assay matrix
to effectively use this program. are the key to the characterization methods.
There are two example cases used in this chapter. The first one (Section
3.2 - Steady State Case) shows how to recall a saved HYSYS.Process case
and illustrates how to manoeuvre around the program. The second
example (Section 3.3 - Refinery Case) outlines some key features
specific to HYSYS.Refinery. If you are already familiar with
HYSYS.Process, you may choose to skip the steady state case and
proceed to the refinery case on page 3-17.
3.1 Starting HYSYS.Refinery

To start HYSYS:
1. Select the Start menu.

2. Move from Programs to AEA Technology to HYSYS.Refinery.
3. Choose HYSYS.Refinery.
HYSYS.Refinery Icon
Now you are ready to Get Started with HYSYS!
3-1
3-2 Starting HYSYS.Refinery
After you start HYSYS, the HYSYS Desktop will appear:

Keep in mind that throughout
the manuals the terms HYSYS
and HYSYS.Refinery will be Figure 3.1
used interchangeably.
Maximize Button
Note that the view shown in Figure 3.1 has been resized; your Desktop
view should appear larger than this when initially opened. To re-size
the view, click and drag the outside border. To make the view full size,
click the button in the upper right hand corner.
Before opening the pre-built Get Started case, you should choose the
HYSYS unit set used for displaying information. You can check your
current unit set by accessing the Session Preferences.
4. Select Tools-Preferences from the menu.
Figure 3.2
The Session Preferences view will open.
3-2
Get Started 3-3
5. Move to the Units page of the Variables tab.
The Current Unit Set is shown highlighted in the list of Available

Unit Sets. The HYSYS default is SI; however the Get Started
example has been developed in Field units.
Figure 3.3
The default unit set

is SI.
Units
page
Click on the Variables tab

to access the Units page.
3-3
6. Click on Field to make it the Current Unit Set.
Figure 3.4
Click on Field to make it Close button.

the current unit set.
7. Click the button to close the Session Preferences view.
Recalling the Simulation Case from Memory

Included with your HYSYS package are a number of pre-built
simulation cases, located in the Samples subdirectory of the HYSYS
root directory. One of these cases is named gstrt-ss.hsc and is the
example used for this Get Started example. To load the case:
8. Do one of the following:

• Click the Open Case button on the button bar.
• Select File-Open-Case from the menu.
Open Case Button
• Press CTRL+O.
3-4
Get Started 3-5
The Open Simulation Case dialog will appear.
Figure 3.5
9. Open the Samples subdirectory and scroll through the list of files
until gstrt-ss.hsc is visible.
10. Highlight gstrt-ss.hsc, then click the Open button. The pre-built
simulation case will appear on your Desktop.
Figure 3.6
3-5
Saving the Case Under a New Name

Before working with this case, you should save it using a new name to
ensure that the original file remains intact.

• Select File-Save As from menu.
• Press CTRL+SHIFT+S
The Save Simulation Case As dialog box will become visible.
12. If the Save in field does not show the Cases folder, click to
move up to the Cases folder. The dialog will appear as shown below
in Figure 3.7.
13. Type a new name, for example MyCase, in the File name field. Note
that you do not have to enter the .hsc extension; HYSYS will add it
automatically.
Figure 3.7
14. Click the Save button, and HYSYS will save your case with the new
name.
3-6
Get Started 3-7
3.2 Steady State Case

This steady state simulation example models the production of
propylene glycol. Using a continuously-stirred-tank reactor (CSTR),
propylene oxide and water are reacted at atmospheric pressure. The
reaction is exothermic, so a coolant is circulated to the reactor to
maintain its temperature. The reactor effluent, consisting of propylene
glycol and unreacted feed, is fed to a distillation column. In the column,
99.5 mol% glycol is produced from the bottoms, while unreacted
propylene oxide and water are recovered overhead.
Three windows, or views, are currently displayed on the HYSYS

Desktop. Each view is identified by its title at the top of the view. The
current active view is the PFD (process flow diagram), which is a
graphical representation of the process flowsheet. The PFD shows:
• streams and unit operations, represented by symbols (called

icons), in the flowsheet
• connectivity amongst the streams and unit operations
• property tables for the Reactor Prods stream.
Figure 3.8
Unit operation icon for a Maximize button

CSTR reactor.
Zoom All Properties table for

button Reactor Prods
3-7
3-8 Steady State Case
If you wish, you can re-size the PFD view to make it more readable by:
1. Doing one of the following:

• Click and drag the outside corner to the new size.
• Click the button in the upper right corner of the view.
2. Pressing the Zoom All button to zoom in on all items in the PFD,
filling the resized view.
You can display summary information for a particular object (stream or

operation) simply by placing the cursor over the object’s icon. For
example, position the cursor over the icon for stream Prop Oxide. A fly-
by view will appear at the cursor tip, showing the stream temperature,
Stream Fly-By pressure and molar flow.
Accessing Stream Information from the PFD

Every stream and operation (object) contained in a HYSYS simulation
has its own property view, which contains multiple tabs and related
pages of information or properties describing the object. You can
access the property view for a stream directly from the PFD by simply
double-clicking on the stream icon.
For example, open the property view for one of the streams entering the
reactor. Double-click on Prop Oxide icon on the PFD. The property
view for Prop Oxide is shown in Figure 3.9:
Prop Oxide Icon
Figure 3.9
Pages associated
with the Worksheet
tab are listed along
the left side.
Property view tabs

are listed along the
bottom of the pages.
3-8
Get Started 3-9
When an object’s property view is initially opened, it displays the first

page on the first tab of the view. For the Material Stream property view,
the first tab is the Worksheet tab which has the Conditions page as the
first page. Tabs are listed along the bottom of an object’s view. Each tab
has associated pages that are listed in the column on the left-hand side
of the view, under the tab name. Change the page or tab by left-clicking
the tab/page with the mouse. The Conditions page of the Worksheet
tab gives the basic conditions of the stream: the vapour fraction,
temperature, pressure, material flows and heat flow (enthalpy).
Move to the Composition page by selecting Composition in the left-

hand column of the view. This page displays the material composition
of the stream. In this case, five components are displayed along with
the liquid volume flow for each component. You can display the
composition on another basis, such as mass or molar fraction, by
pressing the Basis button.
Figure 3.10
3-9
Each stream property view tab and associated pages are described in
the following table:
Tab Description
• Conditions page - displays all of the default
stream information available for the current
stream
• Properties page - shows all the transport
properties for each stream phase
• Composition page - lists composition details
along with options for loading and saving
refinery assays
Worksheet
• Notes page - allows you to add notes to be
saved with the stream
• K Value page - displays the K values or
distribution coefficients for each component in
the stream
• Package Properties page - allows you to
activate and view calculated values for various
Packaged Properties
• Unit Ops page - lists the unit operation(s) to
which the stream is attached
• Utilities page - allows you to create and attach
Attachments
utilities to the stream
• DRU Stream page - allows a transfer stream to
be added
• Specs page - Applicable only in Dynamic mode.
Dynamics You activate dynamic specifications on this
page
(not applicable in • Stripchart page - allows the response of key
HYSYS.Refinery) process variables to be monitored during
dynamic calculations
• Lets you write and attach code as a User
User Variables Variable to extend the functionality of your
stream
Plots • Allows you to view plottable Package Properties
Once you have finished examining the stream properties, close the view
using the button in the upper right hand corner of the view. The next
time you open the property view, it will open to the last page that you
Close Button accessed before closing the view.
3-10
Get Started 3-11
Using the Workbook to Change a Stream

Temperature
Select the Workbook button from the button bar to change the current
view to the Workbook.
Figure 3.11
Workbook Button
Lists the unit operations to Vertical scroll arrow.

which the stream is attached.
The Workbook view displays tabular information pertaining to the

streams and unit operations in the simulation. You can also add, delete
or modify streams and unit operations in the Workbook. The first tab of
the Workbook, Material Streams, displays for each stream the same
information that is available on the Conditions page of the stream
property view. You can view the streams that are not currently visible by
re-sizing the view, or by clicking repeatedly on the vertical scroll arrow.
The remaining Workbook tabs include:
• Compositions - displays the composition of each material

stream.
• Energy Streams - displays the name and heat flow of each
energy stream.
• Unit Ops - lists summary information for all unit operations.
Suppose you want to investigate the amount of cooling required to

maintain the reactor at certain temperatures. The reactor is currently
operating at 135oF, which is the temperature of the product Reactor
Prods.
3-11
Figure 3.12
The temperature of
Reactor Prods is
currently 135 oF.
To see the cooling requirement to achieve this temperature, move to

the Energy Streams tab in the Workbook.
Figure 3.13
The reactor cooling Click here to move to
requirement is represented the Energy Streams
by the Heat Flow of the tab of the Workbook.
stream Coolant.
The cooling duty required to maintain the specified reactor

temperature is 4.79 MMBtu/hr, the Heat Flow of the energy stream
Coolant. Check the cooling requirement for outlet temperatures of
100oF. The reactor temperature is set by the specification on the outlet
stream Reactor Prods.
3-12
Get Started 3-13
To specify the new separator temperature:
3. Return to the Material Streams tab in the Workbook by clicking on

its tab.
4. Select the temperature cell for the Reactor Prods stream.
5. Type 100, then press ENTER. HYSYS will automatically re-calculate
the Flowsheet based on the new temperature.
Figure 3.14
Enter 100 in the
Temperature cell for
Reactor Prods.
Workbook values shown in

blue are user-specified. Values
in black are calculated by
HYSYS.
6. Return to the Energy Streams tab to see the re-calculated cooling

requirement.‘
Figure 3.15
The temperature change has decreased the required cooling duty to

4.46 MMBTU/hr.
3-13
Suppose you want to examine the cooling duty at a number of other

temperatures. Instead of repeating the above procedure for each new
temperature, the HYSYS Case Study feature will automatically make
changes and tabulate the results for you.
Using the Case Study

The third view open on your Desktop is the Case Studies view. To access
this view,
7. Select Window on the HYSYS menu bar to open the available

menu. The three views that are currently open on the DeskTop are
listed at the bottom of the menu. A check mark indicates the view
that currently has focus. In this case, it is the Workbook view.
Figure 3.16
8. Select Case Studies - Main from the menu to make it the active
You might expect the cooling
requirement to increase as the view. The case studies view is shown in Figure 3.17:
reactor temperature is
lowered. However, the reaction Figure 3.17
has two attributes that
dominate the reactor’s heat
balance:
1. The reaction produces
heat proportional to the
amount of reaction
occurring.
2. Less reaction occurs at
100oF than at 135oF.
So by lowering the reactor
temperature, less reaction is
taking place and less heat is
produced by the reaction.
Therefore, less cooling is
required.
3-14
Get Started 3-15
The Case Studies view shows a plot of the separator cooling duty and
the Glycol stream molar flow rate (dependent variables) versus the
separator temperature (independent variable).
Case Study 1 has been configured to calculate and plot values over an
independent temperature range of 75oF to 130oF with an increment of
10oF. You may actually want to observe the results over a wider range.
To change the bounds of the independent variable for the case study,
click the Setup button at the bottom of the view.
The Case Studies Setup view will open:
Figure 3.18
Leave the Low Bound at its value of 75 oF, and the Step Size as 10oF.
Change the High Bound value to 215 oF. Click the Start button then the
Results button on the Case Studies Setup view. HYSYS will begin
calculations immediately, solving the Flowsheet at each temperature
and plotting the results on the Case Studies view. When the Flowsheet
has been solved at the final temperature of 215oF, calculations will stop
automatically.
3-15
The final Case Studies view is shown in the following figure.
Figure 3.19
The Case Study shows that the cooling requirement increases to its
maximum value at approximately 125 oF and then decreases, while the
glycol production rate increases over the entire temperature range.
You have now completed your first HYSYS steady state simulation!
You can save your case by doing one of the following:
• Click the Save button on the button bar.

Save Button
• Select File-Save from menu.
• Press CTRL+S.
You are now free to explore this case on your own. If you wish, you can
quit HYSYS by doing one of the following:
• Select the File-Exit from menu.

• Press ALT+F4
• Click the button in the right hand corner of the HYSYS
window.
If you have made any changes to your case since the last time it was
saved, HYSYS will prompt you to save before exiting.
This concludes the steady state Get Started example. You are
encouraged to proceed to the following refinery Get Started example.
3-16
Get Started 3-17
3.3 Refinery Case

This example provides that basics needed to build your first case using
the state-of-the-art refinery modeling capabilities available in
HYSYS.Refinery.
Specifically, you will transform an existing prebuilt HYSYS.Process

steady state case simulating a fractionation facility into a refinery case
by:
• configuring a number refinery properties using the global

Package Properties settings
• using the Refinery Oil Manager to import an existing
synthesized refinery assay into your simulation
• creating several crude feed streams to your process based on
refinery assays using the Refinery Feed operation
• accessing refinery properties using the Package Properties
support in a Stream view
• using the Mixer operation to combine two refinery streams
• installing a vacuum distillation tower using the Distop solver to
separate this combined refinery stream
• setting up an Adjust operation on a product stream TBP cut
point specification to meet a targeted refinery property.
In this simulation, crude oil is processed in a fractionation facility. An

atmospheric tower is used to produce naphtha, kerosene, diesel,
atmospheric gas oil and atmospheric residue products. The residue
product is then combined with another crude stream and fed to
vacuum tower. A flowsheet for this process is shown in Figure 3.20.
Figure 3.20
3-17
3-18 Refinery Case
Before opening the pre-built Get Started case, you should choose the
HYSYS unit set used for displaying information. You can check your
current unit set by accessing the Session Preferences.
1. Select Tools-Preferences from the menu.
Figure 3.21
The Session Preferences view will open.
2. Move to the Units page of the Variables tab.
The Current Unit Set is shown highlighted in the list of Available

Unit Sets. Ensure that for this example, the unit set is SI units.
Figure 3.22
Ensure that the SI
unit set is selected. Close button.
Click on the Variables tab

to access the Units page.
3. Click the button to close the Session Preferences view.
3-18
Get Started 3-19
3.3.1 Recalling the Simulation

Case from Memory
Included with your HYSYS package are a number of pre-built
simulation cases, located in the Samples subdirectory of the HYSYS
root directory. One of these cases is named gstrt-ref.hsc and is the
example used for this Get Started example. To load the case:

• Click the Open Case button on the button bar.
• Select File-Open-Case from the menu.
• Press CTRL+O.
Open Case Button
The Open Simulation Case dialog will appear.
2. Open the Samples subdirectory and scroll through the list of files
until gstrt-ref.hsc is visible.
3. Highlight gstrt-ref.hsc, then click the Open button. The pre-built
simulation case will appear on your Desktop.
Figure 3.23
3-19
3-20 Refinery Case
This prebuilt simulation case consists of a raw crude feed stream that is
being fed to a pre-flash drum (PreFlash) where vapors are separated
from the liquids, which are heated in a furnace (Crude Heater). The
pre-flash vapors bypass the furnace and are recombined with the hot
crude from the furnace using a mixer. The combined streams is then
fed to the atmospheric crude column (Atmos Tower) for fractionation.
The crude column consists of a refluxed absorber with three side
strippers and three cooled pump around circuits.
3.3.2 Stream Configuration

For this example, you need to have certain refinery assay properties
available throughout the simulation, therefore you must set global
preferences for the Refinery Package Properties.
Package Properties are property groups in HYSYS with unique handling

characteristics for dealing with specific component families. Refinery
properties are one of these unique groups.
4. To set Package Properties preferences globally for the entire

Click the (-) to open the simulation, select Tools-Preferences from the menu then click the
Refinery tree branch:
Stream Configuration tab (located on the far right).
5. Open the Refinery tree branch and highlight Point to list all
available refinery Point properties.
Figure 3.24
The Configuration Scope options

allow you to save these
configuration settings either for
the current Session only (default)
or with the Case.
This tab allows you to configure the various property groups available,
however keep in mind that only supported packages will be accessible.
In HYSYS.Refinery, the refinery Package Property group is supported.
3-20
Get Started 3-21
From the Stream Configuration tab, you can activate various Package
A Point property shows you the
property value calculated for the Properties globally for the entire simulation. For this example, let us
whole stream, while Plottable activate the following Point properties:
properties show how the property
is distributed across the streams
boiling range. Point Properties
All properties are calculated from Mean Average Boiling Point
underlying distributions in Paraffins by vol
HYSYS and some properties may
appear in both categories. Specific Gravity (dry)
Reid Vapor Pressure
Aromatics by vol
Flash Point TBP/PMCC
Freeze Point
Cloud Point
Pour Point
MON (Clear)
RON (Clear)
6. From the Configuration Scope drop down list, select the Case
option which will allow all property settings to be saved with the
case.
7. Next, select the properties (listed in the previous table) by scrolling
through the list and clicking their associated Activate cell.
Figure 3.25
Select Case as your

configuration scope.
Activate
various
properties by
clicking their
Activate cell
and then the
Make Active
button.
8. Once finished close the property selection view by clicking .
3-21
3-22 Refinery Case
All refinery properties selected will now appear along with their current
values on the Package Properties page of each stream’s view and are
accessible to other HYSYS objects. Section 3.3.11 - Examining the
Product at the end of this example outlines how to view Package
Properties values for streams and also how to activate them locally for
an individual stream.
At this point in the simulation case, keep in mind that you will not see
properties immediately as this case does not have any refinery assays
installed yet. The Package Properties supported by HYSYS.Refinery
allow access to various refinery properties.
3.3.3 Installing a Refinery Assay

The current simulation already has standard HYSYS.Process
hypothetical oil properties generated. HYSYS.Refinery also supports
very detailed oil synthesis data in the form of refinery assays. For this
example, imported refinery assay oil data is required to utilize the
powerful property handling features in HYSYS.Refinery.
One of the important concepts upon which HYSYS is based is that of

environments. The Basis environment allows you to input or access
information within the Simulation Basis manager while other areas of
HYSYS are put on hold. Once you return to the Main environment, all
changes made in the Basis environment will take effect in the
simulation once the solver is enabled.
9. You are currently in the Main simulation environment. Enter the

Basis environment by doing one of the following:
• click the Basis Environment button from the button bar
• select Simulation-Enter Basis Environment from the menu
Basis Environment Button
• press CTRL+B.
The Simulation Basis Manager view will appear.
3-22
Get Started 3-23
10. Click the Oil Manager tab.
Figure 3.26
11. Enter the Oil Characterization environment by doing one of the

following:
• click the Oil Environment button from the button bar
• click the Enter Oil Environment button on the Oil Manager
tab.
You are now in the standard Oil Characterization environment that

The Refinery Assay tab is where
you create refinery assays or load contains all the standard HYSYS oil characterization tools with the
pre-built ones from disk. A addition of the Refinery Assay tab. This tab acts as an entry point into
refinery simulation always needs the Refinery Assay environment.
at least one refinery assay
installed.
3-23
3-24 Refinery Case
12. If not already selected, click the Refinery Assay tab.
Figure 3.27
13. Click the Import button and the refinery assay import dialog will
appear.
An assay template file holds 14. For this example, you’ll require an assay template file to import.
all source information related From the Files of type: drop down, select Refinery Assay Templates
to the assay matrix but does (*.ast).
not contain component list or
fluid package details as with
the complete assay (*.asy) Figure 3.28
format.
Select this file.
Ensure that
you select
refinery assay
template as
your file type.
15. Highlight the file gs_assay.ast, then click the Open button.
You have just imported a previously synthesized refinery assay into

your simulation.
3-24
Get Started 3-25
16. Highlight the assay in the Available Refinery Assays list and click
the View button. The dialog which appears presents various details
about this imported assay.
Figure 3.29
This button
accesses the
synthesis
environment.
17. Click the View Refinery Assay Source to enter the refinery assay
synthesis environment.
The Refinery Assay Source (Synthesized) view shows a grid listing all
synthesis laboratory data for your refinery assay. Synthesis data is
entered into one or more grids of information called Plant Data Groups.
Each Plant Data Group grid contains data on one or more cuts of the
material, with properties forming rows of the grid and cuts forming the
columns.
3-25
3-26 Refinery Case
Figure 3.30
Select a
group by Use these
clicking its buttons to
group name modify your
and then click Plant Data
the Edit Groups.
button to edit.
Synthesize button
A typical laboratory assay for a whole crude will contain data on light
ends composition, naphtha range piano distribution from GC (gas
chromatograph) and a number of distillate and residue cuts. Arranging
your laboratory data into Plant Data Groups helps you make sense of
the information contained in your refinery assay.
3-26
Get Started 3-27
Let’s examine the synthesis data for the Distillates Plant Data Group:
18. Click the Distillates Plant Data Group name from the list, then
click the Edit button.
Figure 3.31
Click the Setup Properties button
to modify synthesis properties
The Plant Data Group: Distillates view shown in Figure 3.31 lists 6 cuts
with 28 properties in total. From this view you can add, edit or delete
various cuts and modify property values directly. Properties may be
added or removed using the Setup Properties button located on the
right.
19. Close this view by clicking its button.
Since this assay was just imported it is always a good idea to perform
the synthesis again to ensure that the assay has loaded successfully.
20. Click the Synthesize button to re-synthesize the assay. The status
bar on the view will read “Synthesis Succeeded” in green.
21. Close this view by clicking its button and then click the return
arrow button on the Desktop button bar; once to exit the synthesis
Return arrow environment and then once again to exit the Oil environment and
button
return to the Main simulation environment.
3-27
3-28 Refinery Case
Before entering the Main simulation environment, the following

message will appear:
Figure 3.32
Always keep in mind that

HYSYS will automatically solve
your case only if the solver is
22. Click No to have HYSYS automatically solve your simulation case
active as shown below.
without having to turn the solver back on.
You have now successfully imported a refinery assay into your case and
If your case is not solving be
are ready to edit your simulation to take advantage of the new detailed
sure to check that the solver is
active. refinery assay.
3.3.4 Adding a Refinery Feed

Operation
We will now use the Refinery Feed operation to load the refinery assay
into the Raw Crude feed stream.
23. Add a Refinery Feed operation by doing one of the following:

Refinery Ops button
• Click the Refinery Ops button located on the Object Palette
(press F4 to open the palette) then double-click the Refinery
Feed button. You can also single-click the Refinery Feed
button and then drag the icon into place on the flowsheet.
Refinery Feed button • Select Flowsheet-Add Operation (or press F12), highlight
Refinery Feed from the Logicals category then click Add. You
may want to drag the icon to the left of the Raw Crude stream
for keep the flowsheet tidy.
24. If not already open, double-click the Refinery Feed icon on the
flowsheet to open its property view. By default, you will be placed
on the Connections tab.
3-28
Get Started 3-29
25. Load the refinery assay by clicking on the empty <<Assay>> cell in
the Oil Manager group and selecting Get Started Assay from the
drop down list above.
Figure 3.33
Use this drop down list to
select and load your assay.
Click in this
area to
enable the
drop down list
above.
Once selected, the loaded assay will appear under the Oil Manager
group. You now must attach a product stream to the operation.
Product drop down list:
26. Click the Product cell and select the Raw Crude stream from the
drop down list.
3-29
3-30 Refinery Case
Ensure that the solver is activated (the “green light” icon must be
pressed on the button bar) and HYSYS will attempt to solve for this new
configuration. During the solving attempt, an Consistency Error dialog
window will appear.
Figure 3.34
Closing this dialog (and any other modal views) and then clicking the
Solver Active button again, forces HYSYS to attempt to resolve again on
the next iteration. This time, the refinery assay is now fully loaded in all
Solver Active button. streams and the simulation solves completely.
Inconsistency messages usually appear when operations are overspecified

and these messages should always be carefully examined. In this case
however, the message occurred as HYSYS attempts to solve the loop
around the Heater operation while at the same time loading the refinery
assay into each stream. At one point during the calculation loop, the
stream leaving the heater does not have a refinery assay loaded but the
vapor leaving the pre-flash drum does. HYSYS issues an inconsistency
error at this iteration but the inconsistency disappears on the next
iteration loop.
Your solved simulation now incorporates a refinery assay matrix as the

basis for its property handling. The refinery assay matrix holds values
for around 130 basic refinery properties, together with estimated
thermodynamic properties and component distribution properties.
Using this information, you can blend values to get physical property
values for streams defined by an assay. You will perform a blending
further on in this example.
3-30
Get Started 3-31
To observe the true advantage of incorporating a refinery assay matrix

into your simulation, you should examine each stream’s global Package
Properties that were activated in Section 3.3.2 - Stream Configuration.
Open any stream property view, then click the Package Properties page
on the Worksheet tab. The refinery properties listed on this page are
additional properties not available with the standard (HYSYS) oils.
3.3.5 Importing from an Assay

Database File
An assay database file differs For this part of the example, you will add another refinery assay, this
from an assay template file in time from a database file and generate a stream based on a 350°C+ true
that the database file is boiling point cut of this assay. You will then mix this stream with the
designed to hold a number of
pre-defined assays and is
Residue stream leaving the atmospheric tower. The combined stream
based on a standard KBC will become the feed to a vacuum distillation tower (still to be built).
assay database format. No
synthesis information is 27. To enter the refinery Oil Characterization environment once again,
available in this format.
follow steps 9 to 11 outlined previously in Section 3.3.3 - Installing
a Refinery Assay.
28. On the Refinery Assay tab click the Add button.
Select Refinery Assay Data Source
dialog window.
You will be presented with a dialog window with two choices for
selecting a refinery assay data source.
29. Click the KBC Assay Database radio button then click OK.
The dialog window for importing refinery database files will open. This
dialog allows you to select a database file which may hold several
refinery assays. You can then select which assay to import into your
simulation.
30. Click the Browse button and select the existing database file:
Example.adb from the list.
Figure 3.35
3-31
3-32 Refinery Case
31. Click Open once selected to return to the import dialog window.
This particular database file contains two refinery assays: Arab Light
and Brent.
32. Highlight the ARAB_LGT assay from the selections on the left and
its property information will appear on the right of the view.
Figure 3.36
33. Click the Import button to import this refinery assay into your
simulation case.
You have now successfully imported a refinery assay from a database

file. You can now use this assay throughout your simulation.
34. Click the return arrow button on the button bar once to exit the
synthesis environment and then once again to exit the oil
Return arrow environment and return to the Main simulation environment.
button
3.3.6 Adding a TBP Cut Range

You now need to create a refinery stream based on 350°C+ cut range of
the Arab Light refinery assay and combine this stream with the Residue
stream leaving the tower using a Mixer operation.
Typing a new stream name in 35. Add another Refinery Feed operation by following steps 22 to 23
the Product cell will outlined previously.
automatically create a stream
for you on the flowsheet. 36. From the Connection tab, load the Arab Light assay by clicking on
the empty <<Assay>> cell in the Oil Manager group and selecting
ARAB_LGT from the drop down list.
37. Click the Product cell and type the name “Arab Lt 350+” to define
the product stream leaving this operation then press ENTER. A new
stream named Arab Lt 350+ will then be created.
3-32
Get Started 3-33
38. To define the 350°C+ cut of this refinery assay, click the Sources of
Assay tab and then on the Specification page click the Edit
Composition button to open the Change Composition view.
39. Ensure that the TBP Cuts radio button is selected for cut
specification and in the Initial TBP Cut Point cell enter the value
350 (°C).
Figure 3.37
Enter 350 (°C) for your

initial TBP cut point.
40. Click OK to close this view.
You have just defined an initial true boiling point cut range for this
refinery assay. Only the cuts above 350°C will be included in the
Refinery Feed product stream.
41. To fully define the product stream, click the Product Stream tab
and on the Conditions page enter the following values in the
appropriate cells:
Stream Property Value

Temperature (C) 350
Pressure (kPa) 225
Molar Flow (kgmol/h) 100
The stream will now flash and become completely solved. You are now
ready to add the Mixer.
3-33
3-34 Refinery Case
3.3.7 Mixing Crude Streams

The next step at this stage involves mixing the two crude streams
together using the Mixer operation. A Mixer combines two or more
inlet streams to produce a single outlet stream by performing a
complete heat and mass balance.
42. Add a Mixer operation by doing one of the following:

• Double-click the Mixer button located on the Object Palette
Mixer icon
(press F4 to open the palette).
• Select Flowsheet-Add Operation (or press F12), highlight
Mixer from the Piping Equipment category then click Add.
43. If not already open, double-click the Mixer icon on the flowsheet to
open its property view. By default, you will be placed on the Design
tab.
44. Click on the empty << Stream >> cell in the Inlets group and select,
first the Residue stream from the drop down list above.
45. Repeat the previous step again by clicking on the next empty cell
and select Arab Lt 350+ stream from the drop down list.
Figure 3.38
Typing a new stream name in the

Outlet cell will automatically
create a stream for you on the 46. For the Outlet stream, create a new stream by typing the name
flowsheet. “Residue Mix” in the Outlet cell and then pressing ENTER.
The Mixer will now completely solve defining a product stream based
on the mixing of these two crude streams.
3-34
Get Started 3-35
3.3.8 Adding a Valve

A valve will be used to reduce the pressure of the Residue Mix stream to
a sub atmospheric level.
47. Add a Valve by doing one of the following:

Valve icon • Double-click the Valve button located on the Object Palette
Valve from the Piping Equipment category then click Add.
48. If not already open, double-click the Valve icon on the flowsheet to
open its property view. By default, you will be placed on the
Connections page of the Design tab.
49. On the Inlet side, use the drop down list to select Residue Mix
stream.
50. On the Outlet side, create a new stream by typing the name: “To
Vac Tower” in the Outlet cell and then pressing ENTER.
The Connections page should appear as shown in Figure 3.39. To solve

completely, the Valve needs to know the pressure drop.
Figure 3.39
51. Click on the Worksheet tab and ensure that the Conditions page is
selected.
52. Under To Vac Tower enter value of 10 (kPa) in the Pressure cell and
press ENTER.
With the outlet pressure defined, the Valve will fully solve. The To Vac
Tower stream, now at vacuum conditions, can be used as the feed
stream into a vacuum tower.
3-35
3-36 Refinery Case
The completed Refinery Feed, Mixer and Valve combination will appear
on the flowsheet similar to that shown below:
Figure 3.40
3.3.9 Adding the Vacuum Tower

A typical vacuum tower operates at pressures between 3 and 10 kPa (0.5
to 1.5 psia). Operating at a lower pressure means that the residue
stream can boil and be distilled without raising its temperature past the
thermal cracking point.
The vacuum tower allows refineries to extract any valuable

components remaining in the atmospheric column’s residue stream.
Typically this stream is cut into four product streams: Vacuum Gas,
Light Vacuum Gas Oil (LVGO), Heavy Vacuum Gas Oil (HVGO) and
Vacuum Residue.
To model the vacuum tower, you will use the Absorber column
template which has no condenser or reboiler, only the tray section. For
this column, the Distop solver method will be used.
53. Add an Absorber to the flowsheet by doing one of the following:

Absorber button • Double-click the Absorber button located on the Object Palette
Absorber from the Prebuilt Columns category then click Add.
54. If not already open, double-click the Absorber icon on the
flowsheet to open the Absorber Column Input Expert.
3-36
Get Started 3-37
Using the Column Input Expert

Input Experts guide you through the installation of a Column (in this
case the Absorber template). Successive pages are provided where you
must supply information about the column before proceeding to the
next one.
55. Enter the following specifications on the first page of the Input
Expert so that the information appears as shown in Figure 3.41.
• Column Name - click in this cell and type “Vac Tower” to
rename your column.
• Top Stg Reflux - click the Pumparound radio button to define
the top stage reflux using a pumparound on stage 2 (default).
• # Stages - click in this cell and enter a value of 12 for the
number of stages.
• Optional Inlet Streams - select the To Vac Tower stream
from the drop down list and set the Inlet Stage cell to stage 9
(9__TS-1).
• Bottom Stage Inlet - click in this cell and type “Steam” to
define a new steam stream.
• Ovhd Vapor Outlet - click in this cell and type “Ovhd Vap” to
define a new top stage vapor stream.
• Optional Side Draws - first type “LVGO” in this cell and set its
draw stage to 2 (2__TS-1). Next type “HVGO” in the cell below
with a draw stage of 6 (6__TS-1).
• Bottoms Liquid Outlet - click in this cell and type “Bttms Liq”
to define a new bottom stage liquid stream.
Figure 3.41
Set # Stages to 12.
Type “Vac Tower”

to change the
name of your
column.
Type “Ovhd Vap” to
define the top stage
vapor outlet stream.
Select the To Vac
Tower stream at
Set Top Stage
inlet stage 9.
Reflux option to
Pump-around.
Type “Steam” to
define bottom stage
inlet steam stream.
Type “Bttms Liq” to
define the bottom
stage liquid outlet
stream.
First define the LVGO stream and set its draw

stage to 2 (2__TS-1). Next define the HVGO
stream with a draw stage of 6 (6__TS-1).
3-37
3-38 Refinery Case
56. Click the Next button to proceed to the next Input Expert window.
57. In the Top Stage Pressure cell enter 4.8 (kPa) in the Bottom Stage
Pressure cell enter 7.5 (kPa).
58. Click the Next button to proceed to the final window of the
Absorber Column Input Expert. For this example, no initial
estimates or pump around specifications are required so leave all
fields blank.
You are now ready to install the second pump around for this column.
The easiest way is to use the Side Operations Input Expert.
Side Operations Input Expert

The top stage pump around installed already provides reflux by
drawing liquid from the second stage and returning it to the first. The
second pump around you are about to install draws liquid from the
sixth stage and returns it to the fifth.
59. Click the Side Ops button located at the bottom of the dialog
Side Ops button window. This will allow you to proceed directly to the Side
Operations Input Expert which will assist you in installing the
pump arounds.
60. Ignore the next three pages by clicking Next three times since you
do not need to install any reboilers, strippers or rectifiers for this
column. Stop when you reach the pump around specifications
page as shown in Figure 3.42.
Once you have reached the pump arounds page you are ready to install
the second pump around.
Figure 3.42
3-38
Get Started 3-39
61. Click the Add Pump-Around button.

62. For the second pump around, select a return stage of 5 and a draw
stage of 6 then click Install. The page will appear as shown below
in Figure 3.43.
Figure 3.43
Select a return
stage of 5.
Select a draw
stage of 6.
63. Once both pump arounds are installed, click the Next button
several times until you reach the end then click the Done button.
You are now finished with the Input Experts and will be brought to the
column’s property view.
64. On the column property view, click the Worksheet tab.
Defining Steam Properties

The Worksheet tab displays tabular information pertaining to the
streams and unit operations in the simulation. Here, you will use it to
modify the Steam stream values.
65. Enter the following values for the Steam stream:

• Temperature - 200 (°C)
• Pressure - 200 (kPa)
The steam stream must have a composition of 100% water. You can edit
stream composition values directly on the Composition page.
3-39
3-40 Refinery Case
66. Click the Compositions page and in the H20 cell for the Steam
stream, enter the value of 1. Press ENTER and the composition input
dialog will appear allowing you to edit any composition value for
this stream.
67. Click the Normalize button to set all other compositions to zero.
The composition input dialog window will appear as shown in the
following figure.
Figure 3.44
68. Click OK to close this dialog and return to the Worksheet tab.
Using the Distop Solver

To take full advantage of the refinery assay handling features in
The Distop solver is based HYSYS.Refinery, the Distop solver will be used to solve this column. The
on KBC Distop® column Distop solver is specifically optimized to solve refinery columns rapidly
technology fully integrated
into HYSYS.Refinery. and robustly. It is particularly suited to atmospheric and vacuum crude
towers, FCCU, coker and hydrocracker main fractionators and similar
separations. The solver also has the advantage of being tunable to
match plant data. Refer to Chapter 7 - Column in the Steady State
Modeling manual for a discussion on Distop tuning.
69. Click the Parameters tab and then select the Solver page.
3-40
Get Started 3-41
70. In the Solving Method group, select Distop from the drop down
Note that the Distop solver
only works with refinery assay list.
streams and has various
unique calibration Figure 3.45
parameters and specifications
found on the Distop tab of the
column view.
You will notice that all the information with the exception of the Solver
Method group has now become greyed and disabled. The Distop solver
is unique from all other standard HYSYS solvers and thus only required
information will be made available, most of which can be found on the
Distop tab.
The Distop tab includes various calibration parameters and

specifications required to run a column based on the Distop solver.
71. Click the Distop tab and ensure that the General page is selected.
Enter the following specifications so that the information appears
as shown in Figure 3.46.
• Distop Column Type - select Vacuum Column (EFVC) from
the drop down list.
• Top T - enter the value of 50 (°C) in this cell.
• Heat Balance Closure group - click the Overflash radio
button and enter a value of 1.0 for overflash on the feed.
3-41
3-42 Refinery Case
Figure 3.46
Select Vacuum Column (EFVC)
for Distop column type.
Enter 50 (°C) for your

the top section
temperature.
Select the Overflash

option for Heat Balance
Closure and ensure that
the Overflash Feed
option is selected.
Set overflash on
feed to 1.0.
72. Click on the Efficiencies page and in the Efficiencies group, set
section efficiency of all four streams listed to 100 (%).
73. Next, on this same page, set stripper efficiency to 50 (%) for the
Bttm Liq stream only. The Efficiencies group should appear as
shown.
Figure 3.47
Set section efficiency to 100 (%) for all streams.
Set stripper
efficiency
(residue
section only) to
50 (%)
74. Click on the Pumparounds page and in the Pump Around Specs
group set the percent max heat removal to 100 (%) and 70 (%) for
the first (TopStagePA) and second pump (PA_1) arounds
respectively.
3-42
Get Started 3-43
75. Click on the Product Specs page and define a Strip Steam Ratio of
20 (kg steam/m3)for the Bttms Liq stream only.
Figure 3.48
Enter a value 20 for the Bttms

Liq stream stripping steam ratio
76. Finally, enter the following values for initial TBP cutpoint on the
feed:
Stream Temp (°C)

Ovhd Vap -273
LVGO 345
HVGO 382
Bttm Liq 587
The Flow Specs group should appear as shown in the following figure.
Figure 3.49
Congratulations! You have now successfully built and configured your

Distop column.
If not already solved, click the Run button on the Column view to
converge this column and solve the simulation.
3-43
3-44 Refinery Case
3.3.10 Adding an Adjust Operation

In this step, you will use an Adjust operation to adjust the TBP cut point
specification for the HVGO stream to meet a target pour point value of
60°F (~15.5°C). Pour point is one of the refinery Package Properties
activated previously.
77. Add an Adjust operation by doing one of the following:

• Double-click the Adjust button located on the Object Palette
Adjust from the Logicals category then click Add.
78. If not already open, double-click the Adjust icon on the flowsheet
to open its property view. By default, you will be placed on the
Connections tab.
79. Since we are adjusting HVGO TBP cut point spec, click the Select
Var... button in the Adjusted Variable group. The Variable
Navigator window will appear.
Since the vacuum tower (Vac Tower) uses the Distop solver method, a
number of predefined Distop specifications are accessible.
80. Highlight Case then Vac Tower then Distop TBP Cut Point then
finally HVGO.
Figure 3.50
81. Click OK once the HVGO stream is highlighted.
You are now ready to select Pour Point property for the LVGO stream as
your target variable.
82. Click the Select Var... button in the Target Variable group. The
selection dialog window will appear again.
3-44
Get Started 3-45
Since pour point is a Package Property, it is listed in the Variable

Navigator under a separate sub-category list called Corr Feed Value. All
refinery properties are listed this way.
83. Highlight Vac Tower then LVGO then Corr Feed Value then finally
Pour Point.
Figure 3.51
84. Click OK once Pour Point is highlighted.

85. In the Specified Target Value cell for the Adjust operation, enter
15.6 (°C). This value will be the target value which the Adjust
operation will attempt to meet.
The completed Connection page will appear as follows:
Figure 3.52
3-45
3-46 Refinery Case
86. Click the Parameters tab and enter a tolerance of 0.1 (°C) and a
step size of 5 (°C) so that the information appears as shown below
in Figure 3.35. Since minimum and maximum values are optional,
ignore them for this example.
Figure 3.53
87. When you are ready, click the Start button to start the Adjust
operation and re-solve the column to meet this target
specification. You can click the button at this time also to close
the Adjust property view.
3-46
Get Started 3-47
3.3.11 Examining the Product

The simulation will now resolve completely. Let’s now finish this
example by examining some qualities of our HVGO product stream
important in FCC (fluid catalytic cracking) feed evaluation.
Package Properties are In Section 3.3.2 - Stream Configuration you learned how to activate
property groups with unique Package Properties globally for the entire simulation. You can also
handling characteristics for activate Package Properties locally for an individual stream from its
dealing with property groups
with specific component property view. Using this method, you can view refinery properties for
families. Refinery properties individual streams without affecting the entire simulation.
based on the refinery assay
matrix are one of these unique 88. Open the stream’s property view by double-clicking the HVGO
groups.
stream icon on the flowsheet.
Figure 3.54
89. Next, click the Package Properties page.
This page lets you view calculated values for the various activated
Package Properties. Keep in mind that even if a property is activated, no
value may be listed since the calculated value is outside the allowable
physical range.
90. Click the Stream Property Selection button to open the Package
Property selection dialog window.
3-47
3-48 Refinery Case
The Stream Property Selection button allows access to a view very

similar to the Stream Configuration tab in the Session Preferences
view shown in Figure 3.55. The key difference is that any Package
Properties activated (or de-activated) from this stream’s property view
are set locally for the current stream only and will not appear in any
other streams throughout the flowsheet.
91. Open the Refinery tree list and highlight Point to list all available
refinery Point properties. Note that any globally activated
properties will already be activated.
Figure 3.55
92. Activate the following additional Point properties for the HVGO
stream by clicking in their Activate cell:
Kerosene Properties
Conradson Carbon Content
Sulfur
Nickel Content
Vanadium Content
Sodium Content
93. Once finished close the property selection view by clicking .
3-48
Get Started 3-49
The properties just activated will now show the values listed in the
previous table on the Package Properties page for the HVGO stream
only along with the globally activated properties enabled in the
preferences. Inspect these product stream properties at this time. Their
calculated values are listed in the following table.
Kerosene Properties Calculated Value

Conradson Carbon Content 6.389
Sulfur (wt%) 0.2308
Nickel Content (ppmwt) 6.627E4
Vanadium Content (ppmwt) 1.018E4
Sodium Content (ppmwt) 4.983E4
Congratulations! You have now successfully built your first refinery Get
Started case in HYSYS.
You can save your case by doing one of the following:
• Click the Save button on the button bar.

• Select File-Save from menu.
Save Button • Press CTRL+S.
You are now free to explore this case on your own. If you wish, you can
quit HYSYS by doing one of the following:
• Select File-Exit from menu.

• Press ALT+F4
• Click the button in the right hand corner of the HYSYS
window.
This concludes the refinery Get Started case. If you would like more
help in understanding HYSYS.Refinery, you are encouraged to review
the Refinery Modeling manual which covers all refinery operations in
detail and the Refinery Oil Manager chapter found in the Simulation
Basis manual which describes the refinery assay synthesis
environment in detail.
3-49
3-50 Refinery Case
3-50

Get Started

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Get Started

Uploaded by

Copyright:

Available Formats

1.

HYSYS, HYSYS.Plant, HYSYS.Process, HYSYS.Refinery, HYSYS.Concept, HYSYS.OTS,

Contacting AEA Technology - Hyprotech

Detailed information on accessing Hyprotech Technical Support can be found in the

1 Introducing HYSYS.Refinery ............................ 1-1

2 Installing HYSYS.Refinery................................ 2-1

3 Get Started ....................................................... 3-1

HYSYS.Refinery is the result of a collaborative development effort

HYSYS.Refinery uses the same interface, solving mechanisms,

1.1 Refinery Modeling

1. By providing the ability to develop refinery-wide models and

HYSYS.Refinery has been developed with Hyprotech’s overall vision of

Plant Wide Models

Variable Component Properties

Because unit operations and mixing effects alter the component

Distillation Column Capabilities

• Distop solver, a robust algorithm which performs a section by

KBC Advanced Technologies Expertise

Through the integration of the complete set of Profimatics® and other

HYSYS is also an integral part of the KBC Profit Improvement Program

Used in conjunction with KBC expertise for refining profit

1.2 The HYSYS Philosophy

Integrated Simulation Environment

The central wedge represents the common parameters at the core of

As an engineer you undoubtedly have process modeling requirements

In a truly integrated simulation environment all of the necessary

• Information is shared, rather than transferred, among

The plant lifecycle might begin with building a conceptual model to

While this concept is easy to appreciate, delivering it in a useable

Programming Language. Throughout the design and development

HYSYS Product Description

2.3 Use of the Manuals

The Get Started manual provides a step-by-step example reviewing the

Since HYSYS is totally interactive, it provides virtually unlimited

Viewing the Online Documentation

Manoeuvre through the online documentation using the bookmarks on

Selecting the Search Index

Using the Search Command

To perform a full-text search do the following:

1. Choose Edit-Search-Query from the menu.

Conventions used in the Manuals

Keywords for Mouse Actions

A number of text formatting conventions are also used throughout the

Bullets and Numbering

1. Select the Name cell.

Bulleted lists are used to identify alternative steps within a procedure,

1. Move to the Name cell by doing one of the following:

Notice the two alternatives for completing Step 1 are indented to

A bulleted list of like objects might describe the various groups on a

Shaded Text Boxes

The resultant temperature of the mixed streams may be quite

Before proceeding, you should have read the introductory

The use of many of these conventions will become more apparent as

2.4 Technical Support

• answers to frequently asked questions

• Your full name, company, phone and fax numbers.

Technical Support Centres

Barcelona, Spain (Rest of Europe)

Oxford, UK (UK clients only)

Kuala Lumpur, Malaysia

Newark, DE, USA Houston, TX, USA

Oxford, UK Barcelona, Spain

Oudenaarde, Belgium Düsseldorf, Germany