BPT ROX Documentation Rev 01

Billington Process Technology AS
Hiltonsen 36, N-1341 Slependen, Norway

Org. No.: 966 233 575 MVA
User Manual
BPT-ROX for HYSYS
BPT Document Information:
Summary:
Doc. No.
Revision
Date
No of pages
This is the BPT-ROX for HYSYS User Manual, describing the

use and operation of BPT-ROX (Orifice and Venturi Flow
Meters, Restriction Orifice modelling)
P140108-1000
0.1
1.9.2014
15
BPT ROX versions covered:

Product Name
Product Version
BPT-ROX for
HYSYS
V1.0
Build No
1 (September 2014)
This document contains information about the following:
Installation of BPT-ROX as extension in HYSYS

Installation of a valid BPT-ROX license
Configuring the BPT-ROX in HYSYS.
BPT Contacts:
Name
Telephone
E-mail
Wim Van Wassenhove

Per H. Billington
Henrik Billington
+47 67 56 99 90
support@bpt.no
Billington Process Technology AS (BPT) develops, maintains and validates

process simulation tools & models (both steady state and dynamic) to efficiently
support our clients in their operational challenges in all phases of the
project/field life time, from early conceptual design throughout tail end
production.
For Internal Use

All information contained herein is the property of BPT and may not be disclosed to a third party
without the prior written consent of Billington Process Technology A.S.
BPT-ROX Documentation - rev 01.docx
Page 1
User Manual BPT ROX for HYSYS

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
User Manual for BPT ROX for HYSYS
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
2 of 15
TABLE OF CONTENT
1. INTRODUCTION .................................................................................................................... 3
1.1. About this Document ........................................................................................................ 3
1.2. About BPT ROX for HYSYS ....................................................................................... 4
2. ABBREVIATIONS .................................................................................................................. 5
3. INSTALLATION ..................................................................................................................... 6
3.1. Pre-Installation System Requirements .............................................................................. 6
3.2. Installation ......................................................................................................................... 6
4. CONFIGURE THE BPT ROX IN HYSYS.......................................................................... 10
4.1. Add BPT ROX HYSYS Unit Operation ..................................................................... 10
4.2. Modelling a Pressure Safety Valve ................................................................................. 11
LIST OF FIGURES
Figure 4-1: Add Operation property view ....................................................................................... 10
Figure 4-2 : Connections tab ........................................................................................................... 11
Figure 4-3 : Default settings for valve characteristic and valve lift behaviour ..... Error! Bookmark
not defined.
Figure 4-4 : Design / Orifice Sizes Page ......................................................................................... 12
Figure 4-6 : Rating / Sizing page..................................................... Error! Bookmark not defined.
Figure 4-7 : Rating / Nozzles page .................................................................................................. 14
DOCUMENT REVISION HISTORY

Rev.
00-1
Date
4.04.2014
Description
Issued for Internal Approval
Prep.
WVW
Chkd.
PBi
CONFIDENTIAL
All information contained herein is confidential and may not be disclosed to a third party
Appr.
Page 2

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
3 of 15
1. INTRODUCTION
1.1. About this Document
This document contains user information about the software product BPT ROX for HYSYS.
The trademark name of the software is BPT ROX, and BPT ROX for HYSYS is in the
following termed as BPT ROX.
This document contains information about the following:
Installation of BPT ROX as extension in HYSYS

Installation of a valid BPT ROX license
Configuring BPT ROX within the HYSYS environment.
All relevant installation files and product documentation (including this Manual) will be available
from a common site at BPTs ProjectPlace.
BPT will establish a dedicated account

site in ProjectPlace
(https://www.projectplace.com).
ProjectPlace is an ISO 27001 certified
information security system. Using this
collaboration system enables an
efficient platform to distribute the
software/the license file/user manuals
and may even be used to remotely assist
our customers.
CONFIDENTIAL
Page 3

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
4 of 15
1.2. About BPT ROX for HYSYS

Restriction orifices, Orifice and venture flow meters are not available as standard unit operations
in HYSYS. If the need arises to model such a unit, the user currently has to somehow fudge or
approximate the operation of this equipment. BPT ROX uses the Homogenous Equilibrium
Method, HEM as the general flow calculation method for restriction orifices and uses ISO5167
as the basis for the calculation of orifice flow meters and venture flow meters.
BPT ROX for HYSYS is usable in both steady state and dynamic simulations. BPT ROX is not
an orifice plate design tool, but if the user wishes to do a design, he can us a HYSYS adjust to
modify the main dimensions to find an orifice/throat size that fits the needs of the process. This
software comes as an extension for Aspen HYSYS v7.3 and onwards from AspenTech.
The BPT ROX is licensed software from BPT.
The BPT ROX for HYSYS is programmed as a HYSYS Extension with the following Unit
Operation display name: Orifice and venturi rating.
More information about AspenTech and Aspen HYSYS is found on http://www.aspentech.com/
More information on the orifice and venturi calculations and its terminology can be found in API
Std 520 (Sizing, Selection, and Installation of Pressure-relieving Devices in Refineries, Part I Sizing and Selection) and in the ISO norm 5167.
CONFIDENTIAL
Page 4

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
5 of 15
2. ABBREVIATIONS
Abbreviation
BPT
HYSYS
BPT ROX
Description
Aspen HYSYS
BPT ROX for HYSYS
CONFIDENTIAL
Page 5

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
6 of 15
3. INSTALLATION
3.1. Pre-Installation System Requirements
The installation account must have local Administrator privileges.
3.1.1. Hardware Requirements

BPT ROX has no specific hardware requirements beyond the specifications required for running
Aspen HYSYS.
3.1.2. Software Requirements

Requirement
Operating System
Aspen HYSYS
Microsoft .NET Framework
Specification
Windows 7 (64 bit)
The software has been tested using Windows 7
(64 bit), but Windows 7 (32 bit) should work as
well.
Aspen HYSYS V7.3 (CP3) and onwards
The software has been qualified with
Cumulative Patch 3 installed, but earlier
installations of HYSYS V7.3 may also work.
Minimum licenses required: HYSYS_Process
.NET Framework 3.5 SP 1
Usually installed as part of HYSYS
installation.
3.2. Installation
3.2.1. Installation files
The required files needed to install the BPT-ROX will be installed in the application folder by the
install routine, except the license file, which will be provided separately.
The installation files consist of a SetUp.exe file and a Setup ROX.msi package. Execute the
Setup.exe file, if you execute the .msi file directly, no checking for prerequisites is done and this
may result in a failure to correctly install and register the extension. After the installation has been
run, a few more steps are required to successfully use the extension.
CONFIDENTIAL
Page 6

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
7 of 15
3.2.2. Copy interop.HYSYS.dll & hasp_net_windows.dll to the HYSYS folder

The provided file was created using HYSYS V7.3. It will work with HYSYS V7.3 or later
versions. If you use version V8.x and you have other extensions installed, it is possible that you
would already have an interop.hysys.dll. and this file may be based on .NET version 4.0. In that
case you will need an updated version of BPT-ROX or the interop file. So, if there is already an
interop.hysys.dll present, make a backup copy before placing the supplied in the HYSYS folder!
Next copy the file hasp_net_windows.dll to the Aspen HYSYS folder. If you omit this step, the
registration process described below will most likely fail.
Filename
Description
Bpt-rox.dll
BPT ROX Extension container code
Bpt-rox.edf
BPT ROX Extension definition file. This file

makes it possible for HYSYS to communicate
with BPT ROX. It also contains the
graphical view of the BPT ROX unit
operation in HYSYS.
If the extension is installed on a machine that has only ever seen Aspen HYSYS V8.x
installations, it may be necessary to install .NET Framework 3.5 SP 1. If that proves to be
problematic, a version that references .NET Framework 4 could be created.
3.2.3. Register the BPT ROX Extension

To register BPT ROX in HYSYS, do the following:
1. Start HYSYS with the Run as Administrator option. From the Tools menu, select
Preferences. The preferences view opens.
2. On the Extensions tab, click Register an Extension.
3. Browse to the folder where the extension files are located on your computer, select the
bpt-rox.dll file and click the Open button.
4. Exit and re-start HYSYS, note that this step is no longer required in HYSYS V8.3 and higher.
Notes
CONFIDENTIAL
Page 7

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
1.
2.
Date:
14.3.2014
Page:
8 of 15
The extension definition file *.edf must reside in the same folder as the extension dll.
BPT ROX can be un-registered using the same approach, click Unregister Extension
and exit HYSYS.
3.2.4. Install the ROX License file

ROX comes as part of the BPT Toolkit. Licensing is controlled through a license server. An
ROX license will be available if enough tokens (2) are available from the license server and if the
Toolkit is licensed for BPT-ROX.
Licensing would normally be installed on a server machine by the IT department. To install the
licensing, proceed as follows:
Download the SafeNET Runtime Engine installer from the BPT ProjectPlace site.
Download the BPT License installer.exe from the same ProjectPlace site
Run the BPT License installer tool on the machine that will effectively be used as the
license server!
Select the Installation of new protection key option

CONFIDENTIAL
Page 8

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
9 of 15
Click the Collect Information button

You will be asked to provide a location and file name
Email the C2V file to BPT
BPT will send you a V2C file in return. You can use the same BPT License install program to
apply the license file:
Go to the Apply License File tab
Click the browse button to locate the V2C file
Click on the apply Update button
No local install is required for the end users of the software.
On the license server, you can manage your licenses using a web browser by navigating to
localhost:1947. The below web page will appear. It will allow monitoring of your users, logging
usage and managing license files.
CONFIDENTIAL
Page 9

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
10 of 15
4. CONFIGURE BPT-ROX IN HYSYS

Configuring the BPT ROX unit operation within the HYSYS environment.
4.1. Add BPT ROX HYSYS Unit Operation

You can add a BPT ROX Unit Operation to your HYSYS simulation:
1.
2.
3.
4.
From the Flowsheet menu, select Add Operation. The UnitOps property view appears.
Click the Extension radio button.
From the list of available unit operations select the BPT ROX with the display name
PSV Rating Model.
Click the Add button. The BPT ROX property view then appears.
Figure 4-1: Add Operation property view
CONFIDENTIAL
Page 10

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
11 of 15
4.2. Modelling an Orifice Plate or Venturi Meter

BPT ROX requires a HYSYS feed stream with a known composition, pressure and temperature.
Depending on the options selected, a feed flow rate, a discharge pressure or a pressure drop must
also be specified.
4.2.1. Specifying the information on the Design / Connections page

1. From the PFD double-click the BPT ROX icon. The BPT ROX property view
appears.
2. You should be on the Connections tab
3. You should connect an inlet and an outlet stream. Also select the type of equipment you
want to model. Although the ISO5167 orifice plate and the restriction orifice both model
an orifice plate, each type is accurate in its own domain of process conditions. The
representation in the unit Op view will automatically adapt to the chosen equipment type.
The icon of the PFD object needs to be selected by the user.
Figure 4-2 : Connections tab
CONFIDENTIAL
Page 11

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
12 of 15
4.2.2. The Design / Parameters page

On this page you fine the permanent pressure drop of device and the pressure drop as measured at
the pressure taps. The pressure drop at pressure taps is only valid for the ISSO5167 devices, NOT
for the restriction orifice.
Figure 4-3 : Design / Orifice Sizes Page
4.2.3. The Rating / Sizing page

On the rating/sizing page the requested information will vary with the device type.
ISO5167 Orifice Flow Meter:
Figure 4-4 ISO5167 Orifice Plate
The orifice flow area or diameter and the pipe diameter are required.
CONFIDENTIAL
Page 12

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
13 of 15
The Pressure Tap type has a default value, but should be set to the setting that corresponds with
the actual construction and installation of the device.
ISO5167 Venturi Flow Meter:
Figure 4-5 ISO5167 Venturi Flow Meter
The throat flow area or diameter and the pipe diameter are required.
The type of construction / finish has a default value, but should be set to the setting that
corresponds with the actual construction of the device.
Restriction Orifice:
Figure 4-6 Restriction Orifice

CONFIDENTIAL
Page 13

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
14 of 15
The orifice flow area or diameter and the pipe diameter are required.
For multiphase flow, the mixing rule for the discharge coefficient should be defined. The
discharge coefficients for each phase are manual inputs that are defaulted to the API 520 values.
The resulting discharge coefficient can be overwritten; the method will revert to a user entered
value setting.
The viscosity coefficient is only applied for single phase liquid systems. The value is by default
calculated using the API_520 curve. If the user overrides the value, this value will be used until
the user removes the coefficient value. If the number has a red colour here, it means it is defaulted,
if the number is blue, it means it is user entered.
4.2.4. The Rating / Nozzles page

This page contains the standard nozzle parameters. Note that these parameters are used on the
performance page to calculate a number of velocity related results for inlet and outlet.
Figure 4-7 : Rating / Nozzles page
CONFIDENTIAL
Page 14

Phone:
: +47 67 56 99 90
Fax No. : +47 67 54 46 39
Org. No. : 966 233 575 MVA
V1.0
Title:
Doc. No.:
Revision: 01
Date:
14.3.2014
Page:
15 of 15
4.2.5. Performance tab
The velocities at inlet and outlet use the specified diameters of the nozzles on het rating/nozzles
page to calculate the flow area. The second column concerns the orifice or throat itself.
The Generate Report button will create a report for the valve in an Excel file located in the same
folder where the simulation file is located.
CONFIDENTIAL
Page 15

BPT ROX Documentation Rev 01

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

BPT ROX Documentation Rev 01

Încărcat de

Drepturi de autor:

Formate disponibile

Billington Process Technology AS

Hiltonsen 36, N-1341 Slependen, Norway

This is the BPT-ROX for HYSYS User Manual, describing the

BPT ROX versions covered:

This document contains information about the following:

Installation of BPT-ROX as extension in HYSYS

Wim Van Wassenhove

Billington Process Technology AS (BPT) develops, maintains and validates

For Internal Use

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

DOCUMENT REVISION HISTORY

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

Installation of BPT ROX as extension in HYSYS

BPT will establish a dedicated account

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

1.2. About BPT ROX for HYSYS

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

3.1.1. Hardware Requirements

3.1.2. Software Requirements

Microsoft .NET Framework

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

3.2.2. Copy interop.HYSYS.dll & hasp_net_windows.dll to the HYSYS folder

BPT ROX Extension container code

BPT ROX Extension definition file. This file

3.2.3. Register the BPT ROX Extension

Billington Process Technology AS

User Manual BPT ROX for HYSYS

Hiltonsen 36, N-1341 Slependen, Norway

3.2.4. Install the ROX License file

Select the Installation of new protection key option