Copyright Notice

The copyright in this manual and its associated computer program are the property of AEA
Technology - Hyprotech. All rights reserved. Both this manual and the computer program have
been provided pursuant to a License Agreement containing restrictions on use.

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.

No part of this manual may be reproduced, transmitted, transcribed, stored in a retrieval

system, or translated into any other language, in any form or by any means, electronic,
mechanical, magnetic, optical, chemical manual or otherwise, or disclosed to third parties
without the prior written consent of AEA Technology Engineering Software, Hyprotech Ltd.,
Suite 800, 707 - 8th Avenue SW, Calgary AB, T2P 1H5, Canada.

© 2000 AEA Technology - Hyprotech. All rights reserved.

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

HYSYS.RTO and HYSIM are registered trademarks of AEA Technology Engineering Software -
Hyprotech Ltd.

Petrofine®, Profimatics® SIM Series are registered trademarks ("KBC Trademark") 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:
Lisa Hugo, BSc, BA; Conrad Gierer, BSc; Chris Strashok BSc; Peter deJonge, BSc; Adeel Jamil,
BSc; Muhammad Sachedina, BASc; Allan Chau, BSc; Nana Nguyen, BSc; Yannick Sternon,
BIng; Kevin Hanson, PEng; Chris Lowe, 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.software.aeat.com
Technical Support: support@software.aeat.com
Information and Sales: Info@software.aeat.com

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

Technical Support section in the preface to this manual.
 Components 1-1

1 Components
BETA DOCUMENTS - March 31, 2000

1.1 Introduction .................................................................................................. 3

1.2 Component List View................................................................................... 4

1.2.1 Adding Library Components .................................................................... 5
1.2.2 Tips on Selecting Library Components .................................................... 8
1.2.3 Tips on Manipulating the Current Components List ............................... 12
1.2.4 Adding Hypothetical Components.......................................................... 14
1.2.5 Adding Components from Existing Component Lists............................. 16

1-1
1-2

1-2
 Components 1-3

1.1 Introduction
The Components Manager is accessed by selecting the Components
tab from the Simulation Basis Manager. The Components Manager
provides a location where sets of chemical components being modelled
may be retrieved and manipulated. These component sets are stored in
the form of Component Lists which may be a collection of library pure
components or Hypothetical components.

The Components Manager always contains a Master Component List

which cannot be deleted. The Master Component List contains every
component available from all component lists. If you add components
to any other Component List, they automatically get added to the
Master Component List. Also, if you delete a component from the
master, it also gets deleted from any other Component List that is using
it.

Figure 1.1

When working with the Fluid Package Manager, components are

associated with Fluid Packages through Component Lists. A
Component List must be selected for each Fluid Package created. For
further details relating to the use of Component Lists with Fluid
Packages, refer to Chapter 1 - Fluid Package.

1-3
1-4 Component List View

The Components tab of the Simulation Basis Manager view contains

six button that allow you to organize all the component lists for the
current case. Each button is described in the following table:

Button Description
Opens the Component List property view for the
selected Component List. From this view, you can
View
add, modify or remove individual components from
the current list.
Allows you to add a new Component List into the
case. The new Component List will be blank and not
Add have any components associated with it initially. New
components may be added by highlighting the
component list name and selecting the View button.
Allows you to delete a Component List from the
case. Care must be taken when using this command,
Delete
as no warning message is provided before deletion
and a deleted Component List cannot be recovered.
Makes a copy of the currently selected (highlighted)
Component List. The copied version will be identical
Copy in every way to the original, except the name. This
command may be useful for modifying Component
Lists while keeping the original list intact.
Allows you to import a pre-defined Component List
from disk. A dialog window will appear once this
Import button is pressed to select the location of the
component list file. Component Lists have the file
extension (*.cml).
Allows you to export the selected Component Lists
(*.cml) to disk. The exported list file can be retrieved
Export
into another case in the future by using the Import
function described above.

1.2 Component List View

Highlighting a Component List name from the Components tab of the
Simulation Basis Manger view and then selecting the View button

1-4
 Components 1-5

opens the Component List View:

Figure 1.2

The Name cell displays the name of the

component list currently being viewed.

The Component List View has been designed to simplify adding

components to a Component List. Access is provided to all Library
components within HYSYS and to defined Hypotheticals. The view
consists of only one tab, the Components tab, where you can add
components as well as view their properties.

The display of the Components tab will vary according to the radio
button selection in the Add Components group. A different view will
appear depending on whether you are adding Library or Hypothetical
components or using the Other List option.

1.2.1 Adding Library Components

The Component List View shown previously is the one which you will
encounter when you are adding Library components to a Component
List. The Library radio button must be selected in the Add Components
group for this view to be visible. From observing Figure 1.2, two main
groups exist on this view: the Current Components group and the
Components Available in the Component Library group. Each group is
described separately in the following sections.

1-5
1-6 Component List View

Current Components Group

Figure 1.3

Within the Current Components group, there are various functions

which allow you to manipulate the list of selected components for the
Component List.

Object Description
Current Contains all the currently installed components.
Component
List
View Comp Accesses the selected component’s property view.
The selection of one of these radio button determines the
Library/
type of components which will be displayed in the
Hypothetical
Components/Hypotheticals Available group.
Adds the highlighted component(s) from the
Add Pure Components Available group to the Current
Component List.
Swaps the highlighted current components with the
Substitute
highlighted available component.
Deletes the highlighted component from the Current
Remove Comp
Component List.
Accesses the Move Components dialog, from which you
Sort List
can re-order the current component list.

When substituting components, HYSYS replaces the

component throughout the case (i.e. all specifications for the
old component are transferred to the new component).
However, the substitution function does not automatically
handle components which are part of a Reaction.

1-6
 Components 1-7

Components Available in the Component

Library Group

Figure 1.4

Within the Components Available in the Component Library group,

there are several features designed to make the selection of
components as efficient and convenient as possible.

Object Description
As you type in this cell, HYSYS filters the component
Match list in order to locate the component that best
matches your current input.
This button opens the Filters floating view which
contains a range of property package and
Filters view: View Filter button component filtering options to assist in your
component selection process. For further details
refer to the following section: Filter Options.
SimName\ FullName These three radio buttons determine the context of
Synonym\ Formula your input in the Match cell.
When this check box is activated HYSYS includes
Show Synonyms
known synonyms for each component in the list.
This check box is available only when the Show
Synonyms check box is activated. By activating the
Cluster Cluster check box, all synonyms are indented and
listed below the component name. Otherwise, the
synonyms appear alphabetically throughout the list.

Filter Options
The Filter floating view, accessed by selecting the View Filter button
from Component List View, allows access to both Property Package
filtering options and Family Type filtering options.

The Property Package Filter group filters components based on their

compatibility with the selected property package. Once you have
chosen a property package, the Recommended Only check box works

1-7
1-8 Component List View
Whenever a component(s) is
highlighted in the Available
List, selecting the Add Pure
button moves it to the Current
Component List.
1-8
as follows:
1. If the Recommended Only check box is selected, HYSYS will only
display (in the component library list) components that are
recommended with the chosen property package.
2. If the Recommended Only check box remains un-selected, all the
components in the HYSYS library will be displayed in the
component library list. An ‘x’ will be shown beside each
component that HYSYS does not recommend for the selected
property package, however, you may still select these components
if you wish.
Note that the Property Package Filter is only a component
selection filtering tool and does not associate a Fluid Package
with the component list (this is accomplished within the Fluid
Package Manager).
The Family Type Filter group allows HYSYS to filter the list of available
components to only those belonging to a specific family. The Use Filter
check box, when selected, toggles the Family Type Filter options On
and Off. By default, all check boxes in the Family Filter group are
deactivated. You can identify which families should be included in the
list of available components by selecting the desired check box(es). The
All button activates all check boxes, and the Invert button toggles the
status of each check box individually. For instance, if you had activated
all of the check boxes, and then wanted to quickly deactivate them, you
could simply press the Invert button. If you only had the Hydrocarbons
and the Solids options activated and you pressed the Invert button,
these two options would become deactivated and the remaining
options activated.
1.2.2 Tips on Selecting Library
Components
As mentioned previously, library components are selected from the
Components Available in the Component Library group, and placed in
the Current Components group. There are many ways in which you can
select components for a component list. Once you become familiar
with the available methods for component selection, you will be able to
choose the procedure which you find most convenient.
The process of adding components from the component library to the
Current Components list can be divided into three sub-processes. By
visualizing the process of component selection in this way, you will be
 Components 1-9

made aware of all the available possibilities offered by HYSYS. You can
then adopt the most logical and efficient approach to use each time you
build a case.

For component addition to the component list, you should do the

following:

1. Filter the library list.

2. Select the desired component(s).
3. Transfer the component(s) to the Current Components list.

Filtering the Component List

A recommended practice for component selection is the use of the
available tools which HYSYS provides for filtering the component
library. This will narrow the selection range and allow you to apply one
of the various methods for transferring the selection(s) to the Current
Components list.

There are four available tools which will filter the list in the
Components Available in the Component Library group:

The filtering tools can be used independently or in combination.

Filtering Tool Description

Filters the list according to your selection of property
Property Package & package and/or component families. Refer to
Family Type Filters previous Sub-Section - Filter Options for further
details.
Component synonyms appear alphabetically
Show Synonyms
throughout the list when this check box is activated.
The Cluster check box is available only when the
Show Synonyms check box is activated and Match
Cluster input field is empty. By activating the Cluster check
box, all synonyms are indented and listed below the
component name.
This input cell allows type-matching of the
Match component simulation name, full name, synonym or
formula.

By using the Match input cell, you can access any component within
the HYSYS library that is accessible under the currently selected
Property Package. You can make the Match field active by selecting it or
by using the <Alt><M> hot key.

The Match input cell accepts keyboard input, and is used by HYSYS to

1-9
1-10 Component List View
Remember, as you are typing
into the Match cell, HYSYS
lists the components matching
what you have presently
typed. You may not have to
type the complete name or
formula before it becomes
visible in the filtered
component list.
1-10
locate the component in the current list which best matches your
input. The first character of the filtered component names must agree
with first character of the listed component name. Subsequent
characters in the Match cell must appear somewhere in each listed
component name. As well, the order of the input characters must be
honoured. Other than the first character, any number of unmatched
characters can appear within the names of the listed components.
When trying to Match a component, HYSYS searches the component
column in the list for whichever radio button is selected:
Radio Button Description
This option matches the text entered into the Match input
SimName
to the name used within the simulation.
Full Name/ This option may match the components full name or a
Synonym synonym of the SimName. It is typically a longer name.
Use this option when you are not sure of the library name,
Formula
but know the formula of the component.
Suppose the component you want to add is Water. Begin by typing H2
in the Match cell.
Figure 1.5
HYSYS filters the list of available Library Components to only those that
match your current input string. The first component in the list, H2, is
an exact match of your current input and therefore, is highlighted.
Notice that H2O is available in the list even though you have entered
only H2.
Since Hydrogen is not the component of choice, you can continue to
 Components 1-11

reduce the list of available library component options by typing in the

character O after the H2 in the Match cell.

Selecting the Component(s)

Once the list of Library Components has been filtered, you should be
able to see the desired component among the displayed components.
You can now use one of the methods available to highlight the
component(s) of choice:

Selection
Multiple selections can be Description
Method
made from the list of Library
Components. Refer to Section Place the cursor over the desired component and press
Mouse
1.1.9 - Selecting Items of the the primary mouse button.
HYSYS User Guide for details Use the <Tab> key or <Shift><Tab> combination to move
on the technique. Keyboard
the active location into the list of components.

Whenever the list of components is filtered, the highlight is placed on

the first component in the reduced list. If you use the keyboard
commands to access the list of components, you may have to move the
highlight if the first component is not the desired one.

To move through the Components Available in the Component Library

group, use one of the following methods:

Method Description
Move the highlight up or down one line in the component
Arrow Keys
list.
<PageUp>/ Use these keyboard keys to move through the list an
<PageDown> entire page at a time.
The <Home> key moves to the start of the list and the
<Home>/<End>
<End> key moves to the end of the list.
With the mouse, use the scroll bar to move up and down
Scroll Bar
through the list.

Transferring the Component(s)

Once the Library Component list has been filtered and the desired
component(s) highlighted, you can transfer the selection(s) to the
Current Components list. Use one of the following methods:

• Press the Add Pure button.

• Press the <Enter> key.
• Double click with the primary mouse button on the highlighted
item. This option works only for a single component selection.

1-11
1-12 Component List View
Refer to Chapter 2 -
Hypotheticals for details on
Hypothetical components.
You can only substitute one
component at a time. Even
though HYSYS allows you to
highlight multiple
components, the substitution
only involves the first
highlighted component.
1-12
1.2.3 Tips on Manipulating the
Current Components List
Once you have added components to the Current Components list,
there are a few things you can do to the components in the list. This
includes removing, replacing, sorting and viewing components.
To demonstrate the manipulation functions, the Current Components
group shown below will be used for reference purposes.
Figure 1.6
Removing Selected Components
You can remove any component(s) from the Current Components list.
1. Highlight the component(s) you wish to delete.
2. Press the Remove button, or use the <Delete> key.
For Library components, HYSYS removes the component(s) from the
Current Components list and places it in its appropriate spot back in
the Components Available in the Component Library list. Since
Hypothetical components are shared among Fluid Packages, there is no
actual transfer between the lists. (i.e. The Hypo always appears in the
Available group, even when it is listed in the Current Components list.)
Substituting Components
When substituting components, HYSYS replaces the component
throughout the case (i.e. all specifications for the old component are
transferred to the new component). However, the substitution function
does not automatically handle components which are part of a
Reaction.
 Components 1-13

You can substitute a component in the Current Component List with

one in the Components Available in the Component Library list by
using the following procedure:

1. From the Current Component List highlight the component you

want to remove.
2. In the Available Component list, highlight the component to
substitute.
3. Press the Substitute button.
4. The removed component is returned to the Available Component
list and the substituted component is placed in the Current
Component List.

Sorting a Component List

When there are components in the Current Components group you
can use the Sort List button to rearrange the component order.

Figure 1.7

We will use the view shown in Figure 1.7 to illustrate the sorting
procedure:

1. Press the Sort List button. The Move Components dialog appears.
2. From the Component(s) to Move group, select the component you
want to move. In this example, we have selected Methane.
3. From the Insert Before group, highlight the component before
which Methane will move. In this case, Propane has been
highlighted.

1-13
1-14 Component List View
You can highlight and move
multiple components.
You can examine the property
view for any component in the
Current Component List by
double clicking on the
component.
Refer to Section 2.4 -
Hypothetical Component
Property View for details on
the various Component
property view tabs.
1-14
4. Press the Move button to complete the move. Methane will be
inserted before Propane in the component list. Thus, Ethane is
forced to the top of the list, followed by Methane, Propane, and n-
Butane.
5. When you have completed the sorting, press the Close button to
return to the Components tab.
Viewing Components
Once a component is added to the Current Components list, the View
Component button becomes active. The View Component button
accesses the Pure Component property view for a selected component.
For example, selecting Methane and pressing the View Component
button will open the following property view:
Figure 1.8
1.2.4 Adding Hypothetical
Components
Hypotheticals can be added to a component list via the Components
tab. In the Add Components group, select the Hypothetical radio
button. The Components tab is redrawn with information appropriate
 Components 1-15

to the addition of Hypotheticals:

Figure 1.9

Some of the features on the Components tab are common to both the
selection of Hypotheticals and Library components. Items specific to
Hypotheticals are discussed in the following table:

Object Description
Adds all the Hypothetical components in the current
Add Group selection in the Hypo Group list box current to the current
component list.
Adds the currently selected Hypothetical in the Hypo
Add Hypo
Component list box to the Current Component List.
Displays all the Hypo Groups available to the current
Hypo Group
component list.
Hypo Displays all the Hypothetical components contained in the
Components currently selected Hypo Group.
Accesses the Hypotheticals tab of the Simulation Basis
Hypo Mgr Manager, from which you can create, view or edit
Hypotheticals.
A short-cut for creating a regular Hypothetical component
Quick Create A
and adds it to the currently selected Hypo Group and
Hypo Comp
opens its property view.

Quick Create A A short-cut for creating a solid Hypothetical component

and adds it to the currently selected Hypo Group and
Solid Hypo
opens its property view.

While you can add Hypos to a Component List from the

Components tab, this is merely a short-cut. To access all
features during the creation of Hypotheticals and Hypothetical
groups, you should access the Hypotheticals tab of the
Simulation Basis Manager.

1-15
1-16 Component List View

1.2.5 Adding Components from

Existing Component Lists
Components can be added from other component lists by using the
Other List option. In the Add Components group, select the Other List
radio button. The Components tab is redrawn with information
appropriate to accessing components from alternate component lists.

Figure 1.10

The Existing Components group displays a list of all available

component lists loaded into the current case. Highlighting a
component list name will display its associated group of components
in the Components in Selected Component List.

To transfer a component from an existing component list, simply

highlight the component name in the list and select the Add
Components button. The selected component will be added to the
Current Components list.

1-16