Sentry User Guide

Sentry Surface Monitoring System
Software User Guide
Software Version 2.0
Prepared for Halliburton Energy Services by ProtoLink, Inc.
Document Version 2.0

March 26, 2007
Sentry Software User Guide
Publication Notice
The information in this document is subject to change without notice and should not be
construed as a commitment by Halliburton. Halliburton assumes no responsibility for any
errors that may appear in this document.
Copyright Notice
All information contained in this publication is confidential and proprietary property of
Halliburton Energy Services, a division of Halliburton. Any reproduction or use of these
instructions, drawings, or photographs without the express written permission of an
officer of Halliburton Energy Services is forbidden.
Manuals are company property and non-transferable to other employees, unless

authorized by Management. You are responsible for this manual. DO NOT leave this
manual where it may be photocopied by others.
This manual is designed to provide information useful for the optimal utilization of
Halliburton equipment. Charts, descriptions, tables and other information contained
herein may have been derived from actual tests, simulated tests, or mathematical models.
Although information has been carefully prepared and is believed to be accurate,
Halliburton cannot guarantee the accuracy of all information contained herein.
Halliburton reserves the right to modify equipment, software and documentation, and
field equipment and/or procedures may differ from those described herein. Trained
Halliburton personnel act as consultants to Halliburton customers. Practical judgment and
discretion must be used, based upon experience and knowledge, to review the
circumstances for a particular job and then to perform the job in a professional manner.
Accordingly, the information contained herein should be used as a guide by trained
personnel, and no warranties, expressed or implied, including warranty of
merchantability or fitness for use, are made in connection herewith. In no event will
Halliburton be liable for indirect or consequential damages arising from the use of the
information contained in this manual, including without limitation, subsurface damage or
trespass, or injury to well or reservoir.
Copyright 2007, Halliburton Energy Services, Inc. All Rights Reserved
Printed in the United States of America
Trademarks
Sentry is a trademark of Halliburton, Inc. Windows and Microsoft are trademarks of
Microsoft, Inc.
All other products or services mentioned in this document are identified by the
trademarks or service marks of their respective companies or organizations.
Page 2 of 130
1 Introduction..................................................................................................................5
2 Definitions...................................................................................................................6
3 The Main Form............................................................................................................7
3.1 Main menu bar.....................................................................................................9
3.1.1 File submenu..............................................................................................10
3.1.2 Configure submenu....................................................................................11
3.1.3 Actions submenu.......................................................................................12
3.1.4 Views submenu..........................................................................................13
3.1.5 Layout submenu.........................................................................................14
3.1.6 Help submenu............................................................................................15
4 File Operations...........................................................................................................16
5 OPC Servers...............................................................................................................20
6 OPC Server Properties...............................................................................................22
7 OPC Inputs.................................................................................................................24
8 OPC Input Properties.................................................................................................26
9 INSITE Inputs............................................................................................................27
10 INSITE Input Properties........................................................................................29
11 INSITE Item Address Properties...........................................................................31
12 Assigning INSITE and OPC Destinations.............................................................33
13 Output Destination Properties................................................................................34
14 Fluid Properties......................................................................................................36
15 Gas Properties........................................................................................................38
16 Special Values........................................................................................................41
17 Signals....................................................................................................................44
17.1 Direct Analog Signals........................................................................................44
17.2 Processed Analog Signals..................................................................................47
17.3 Pulse Signals......................................................................................................50
17.4 Analog Rates......................................................................................................54
17.5 Signal Scaling....................................................................................................58
17.5.1 Linear Scaling............................................................................................59
17.5.2 Piecewise Linear Scaling...........................................................................61
17.5.3 Polynomial Scaling....................................................................................64
17.6 Noise Averaging.................................................................................................66
17.7 Assigning Signal Inputs.....................................................................................67
18 Flows......................................................................................................................69
18.1 Gas Flow............................................................................................................70
18.2 Oil Flow.............................................................................................................74
18.3 Orifice Flow.......................................................................................................77
18.4 Tank...................................................................................................................81
18.5 Water Flow.........................................................................................................86
19 Cumulatives...........................................................................................................89
20 Flow Types.............................................................................................................93
21 UBA Calculations..................................................................................................94
21.1 Net Gas Rate......................................................................................................96
21.2 Separator 1 Volume............................................................................................96
21.3 Separator 2 Volume............................................................................................96
Page 3 of 130
21.4 Produced Gas Rate.............................................................................................96

21.5 Pit Active Volume..............................................................................................96
21.6 Total Surface Oil Volume...................................................................................96
21.7 Total Surface Water Volume..............................................................................97
21.8 Water Cut...........................................................................................................97
21.9 Water Oil Ratio..................................................................................................97
21.10 Gas Oil Ratio.................................................................................................97
21.11 Gas Fraction...................................................................................................97
21.12 Instantaneous Total Production Index............................................................97
21.13 Instantaneous Gas Production Index.............................................................97
21.14 Instantaneous Oil Production Index...............................................................98
21.15 Instantaneous Water Production Index..........................................................98
21.16 Net Oil...........................................................................................................98
21.17 Net Water.......................................................................................................98
21.18 Net Liquid......................................................................................................98
22 Choke Control Properties......................................................................................99
22.1 Inputs...............................................................................................................100
22.2 Parameters........................................................................................................100
22.3 Outputs.............................................................................................................102
22.4 Send Defaults to OPC Destinations.................................................................104
22.5 Restore Defaults from Choke Control.............................................................104
22.6 Update Defaults with Current Values..............................................................104
23 Display Groups....................................................................................................105
23.1 Adding, editing, and deleting display groups..................................................105
23.2 Assigning configuration objects to display groups..........................................107
23.3 Filtering a view by display group....................................................................108
24 Global Parameters................................................................................................109
25 Data Acquisition..................................................................................................110
26 Data Logging.......................................................................................................112
27 User Comments....................................................................................................114
28 Views....................................................................................................................115
28.1 Input View........................................................................................................115
28.2 Processed Signals View...................................................................................116
28.3 Total Volumes View.........................................................................................117
28.4 Mass Balance View..........................................................................................118
28.5 UBA Calculation View....................................................................................120
28.6 Productivity Index View..................................................................................121
28.7 Events View.....................................................................................................123
28.8 User Comments View......................................................................................123
28.9 Choke Control View........................................................................................124
29 Layouts................................................................................................................125
30 Troubleshooting...................................................................................................128
Page 4 of 130
1
2 Introduction
This document is intended to serve as a guide for users of the Sentry Surface
Monitoring System application. It explains how to configure and use the Sentry
application in conjunction with an INSITE database.
The Sentry application is a Microsoft Windows-based data acquisition system that

monitors UBA operations and supports Halliburtons UBA real-time reservoir evaluation
strategy.
The primary functions of Sentry involve the storage and real-time display of data
obtained in one of the following ways:
directly from an OPC Data Access server

directly from INSITE
from manual input by the user
through calculations involving data obtained via the methods listed above
The system provides tabular displays of changes to the real-time data through a Windows
application interface. The application's input data and the application's computed outputs
can be written to INSITE. All application configuration data is also stored in INSITE.
Sentry provides the user interface to allow the user to configure each calculations
inputs, outputs and calculation parameters. A fixed set of configuration objects are
supported to accomplish this goal. Configuration objects take one or more inputs, run
them through a specific algorithm, and then produce one or more outputs which are
logged to INSITE.
The inputs to a configuration object can come from an OPC server, INSITE, or from the
output of other configuration objects.
This document describes how to use Sentry to configure the applications inputs,
outputs and calculations and how to use the application to monitor various inputs, outputs
and calculations in real-time.
Page 5 of 130
3 Definitions
Configuration object Signals, flows, cumulatives and UBA calculations are referred to
collectively as configuration objects. These are constructs that allow a user to
configure the calculations performed by the application. Each configuration object is a
transfer function that accepts inputs from user defined data sources and logs its calculated
outputs to INSITE.
Cumulatives Cumulatives are user defined configuration objects that sum the flow rate
outputs of other configuration objects. The output of a cumulative may feed the input of
other cumulatives.
Flows Flows are user defined configuration objects that accept inputs from signals.
Flow outputs cannot feed the inputs of other flows.
Signals Signals are user defined configuration objects that accept inputs from OPC
servers or INSITE.
UBA Underbalanced application
UBA calculations UBA calculations are system defined configuration objects that
produce a single calculated output.
Page 6 of 130
4 The Main Form

After the application is launched, the main form will appear. The main form serves as the
workspace for the tasks that are performed within the Sentry application.
The title bar contains the file name of the project that is loaded along with buttons
that allow the user to minimize, maximize or close the application.
The main menu bar contains a set of text buttons that describe the various actions
that may be taken within the program. Clicking on one of these text buttons
causes a related submenu to be displayed as shown in the example image above.
The toolbar contains a set of graphical icons representing functions that are
frequently or commonly used in the application. Every action represented in the
toolbar is also available for selection from submenus of the main menu bar.
The main work area is the part of user interface where windows showing real-
time updates of the application data are displayed.
Page 7 of 130
The status bar displays real-time updates regarding the applications data
acquisition state and INSITE connectivity state. The left side of the status bar
contains information on the current logging and acquisition state of the
application. The right side of the status bar contains information about the state of
the connection to INSITE and the current Well ID and Run number.
Page 8 of 130
4.1 Main menu bar
The main menu bar contains the following six text buttons:
File Selecting this menu option displays a submenu of options that provide for
opening, importing, exporting or exiting the application.
Configure Selecting this menu option displays a submenu of options that

provide for configuring the various inputs, OPC Servers, special values, signals,
flows, UBA calculations, cumulatives, choke control, display groups, fluid and
gas properties, display groups and the applications global configuration
parameters.
Actions Selecting this menu option displays a submenu of options that provide
for starting and stopping data acquisition and for the logging of data to an INSITE
database. Submenu options for entering user comments into INSITE and for
launching the INSITE database administration application are also provided.
Views Selecting this menu option displays a submenu of options that provide
access to various real-time views of the applications inputs, outputs, and
calculations. Real-time views of the inputs, processed signals, total volumes,
mass balance, UBA calculations, productivity indices, events, user comments and
choke control are provided. Submenu options for arranging or closing the various
views are also provided.
Layout A user may store the position of the various views contained in the work
area by saving a layout. Selecting the Layout menu option displays a submenu
of options that provide for the storage, deletion and retrieval of these layouts.
Page 9 of 130
Help Selecting this menu option displays a submenu of options that provide
access to an application help file and information about the applications version
number.
4.1.1 File submenu
After clicking on the word File in the main menu, the file submenu is displayed. The
following five options are available from the file submenu.
New This option creates a new Sentry configuration. New configurations

cannot be created while acquiring or logging data. If the New option is selected
while the application is in acquisition or logging mode a warning dialog will
appear asking the user if he wishes to stop the acquisition or logging activity. If a
user has made changes to an existing configuration and then selects New, he will
be asked if he wants to save his current configuration before the new
configuration is created.
Open This option allows a user to load a configuration file from the INSITE
database.
Import This option allows a user to load a configuration file from disk or
other readable media.
Export This option allows the user to save a configuration file to disk or
other writeable media in one of two formats (binary or html).
Exit When this option is selected, the application exits. It is functionally

equivalent to selecting the button from the title bar. If the Exit option is
selected while the application is in acquisition or logging mode a warning dialog
will appear asking the user if he wishes to stop the acquisition or logging activity.
If a user has made changes to an existing configuration and then selects Exit, he
will be asked if he wants to save his current configuration before the application
exits.
Page 10 of 130
4.1.2 Configure submenu
Upon selecting the Configure option from the main menu a submenu of options is
displayed which provide for configuring OPC servers, OPC and INSITE inputs, fluid
and gas properties, special values, signals, flows, cumulatives, UBA calculations,
display groups and the applications global configuration parameters.
Page 11 of 130
4.1.3 Actions submenu
The Actions submenu is used to set the data acquisition and logging state of the
application. This submenu also contains options that allow the user to enter free-form
text comments into the INSITE database as well as an option to launch the INSITE
Data Admin application.
Page 12 of 130
4.1.4 Views submenu
The Views submenu provides access to screens that display real-time updates of many
of the values that are computed by the application. Many of these views allow the user to
configure filters to customize how the data is displayed.
Page 13 of 130
4.1.5 Layout submenu
The Layout submenu allows a user to manage the arrangement of views in the main
work area. A layout contains the location of each window in the application. This allows
a user to arrange application views in any manner he wishes and then recall that
arrangement by loading its layout.
Page 14 of 130
4.1.6 Help submenu

The Help submenu provides access to the online user guide and to an About Sentry
dialog.
The applications version number, copyright notice and other build information can be
found in the About Sentry dialog box.
Page 15 of 130
5 File Operations
While connected to INSITE, Sentry automatically detects and saves any changes to its
configuration. These configuration files are saved to an INSITE record for the active
well.
To open a previously saved configuration file from INSITE:

1. Select [File] [Open]
Open Configuration dialog is displayed
2. Choose a well by selecting an entry from the dialogs combo box. The currently
active well is denoted with the text (Active Well) after the well name. After
selecting a well, the list of configurations will update.
Page 16 of 130
3. If the well that the user selected has associated Sentry configuration files, the
Configurations: section of the dialog will update with a listing of those
configurations. If the selected well does not have any associated configuration
files, then the dialog will display the following option:
Select the Add button to create an initial Sentry configuration file for the well.
4. Select a configuration to load from the Configuration: section of the dialog.
5. Select _OK_ to load the configuration.
Page 17 of 130
To import a configuration file from disk:

1. Select [File] [Import]
Import Sentry Configuration File dialog is displayed
2. Select a directory from the Look in: combo box. Files within the selected
directory that have the extension .sen will be shown. Only the .sen binary
files may be imported. Configurations that were exported as .html files may not
be imported.
3. Choose a configuration file from the list provided and select the Open button to
load the configuration file.
Page 18 of 130
To export a configuration file to disk:

1. Select [File] [Export]
Export Sentry Configuration File dialog is displayed
2. Select a directory from the Look in: combo box. Files within the selected
directory that have the extension .sen will be shown.
3. Either enter a name for the configuration file in the File Name: combo box to
save a new entry or select an existing name from the list of .sen files to
overwrite an old entry.
4. Choose the export type for this file. Files exported as Sentry configuration files
will be exported in a machine readable binary format that may be read back in at a
later time by the applications Import feature. Files exported as html will be
exported as a human readable report. Configurations exported as html cannot
be read back in to the application.
5. Click the Save button to export the configuration.
Page 19 of 130
6 OPC Servers
The application accepts input from OPC servers. These raw inputs from the OPC servers
may be used to feed the four different kinds of signals supported by the application
(Direct Analog Signals, Processed Analog Signals, Pulse Signals, and Analog Rates).
To configure an OPC server for use with the application:

1. Select [Configure] [OPC Servers]
OPC Servers dialog is displayed
2. Select Add
OPC Server Properties dialog is displayed
3. Fill out the form entries in the OPC Server Properties dialog as described in
the OPC Servers Properties section.
4. Select _OK_
If any OPC server entries have been previously configured, a list of these existing server
configuration entries is shown within the OPC Servers dialog.
Question Answer
The list of configured OPC servers cant be
Select the Add... button from the OPC
edited from this dialog so how can a userServers dialog to bring up the OPC
create a new OPC server? Server Properties dialog. A user can
configure the OPC server from there.
When the Delete button is pressed, To delete an OPC server entry, a user must
nothing happens. How can I delete an OPC click on the OPC server entry he wishes to
server from the configuration? delete and then press Delete button. The
Delete button is enabled only when one or
more OPC server entries have been
selected.
Page 20 of 130
What happens if a user tries to delete an All signals that use an input belonging to
OPC server that is currently being used by the OPC server that is being deleted will set
a signal or some other component of the that input to a value of Unassigned.
application?
Can a user delete more than one OPC Yes. To select multiple OPC server entries
server at a time? for deletion, the user must press CTRL-
CLICK on each entry he wishes to delete.
Each entry will highlight as the user does
this. The user can then select the Delete
button to delete all of the selected OPC
server entries.
When the Edit button is pressed, nothing The user should select the OPC server entry
happens. How can a user edit an OPC he wishes to edit and then click the Edit
server from the configuration? button to bring up the OPC Server
Properties dialog for that entry.
How many OPC server configurations does The application places no hard limits on the
the application support? number of OPC servers that may be
configured for use.
Page 21 of 130
7 OPC Server Properties

The OPC Server Properties dialog is displayed when a user elects to add or edit an
OPC server entry from within the OPC Servers dialog. From the OPC Server
Properties dialog, a user can specify a name for the OPC server, the location of the
OPC server, and an instance of an OPC server in case more than one is available at the
same location.
No two OPC servers may have the same name. If a user attempts to enter an OPC server
name that has already been used, an error dialog will be displayed informing the user of
the problem and a new name will need to be entered.
The Computer section of this dialog allows the user to select either a Local or Remote
option. Select Local if the OPC server being configured runs on the same computer as
the Sentry application. Select Remote if the OPC server being configured runs on a
different computer than the Sentry application.
Page 22 of 130
If Remote is selected, the Name or address text box and the Browse button become
enabled. Select the name of the remote computer by either typing its name or IP address
into the text box or by clicking the Browse button and selecting a computer from the list
provided. An example of the dialog displayed when the Browse button is selected is
shown below.
If one or more OPC servers are detected at the location specified, an entry for each OPC
server will appear in the Available OPC servers: section of the OPC Server
Properties dialog. Pressing the Search for OPC servers button in the dialog
refreshes the listing of OPC servers available at the location specified.
Select one entry from the Available OPC servers: and click OK to associate the selected
OPC server with the name that was specified in the dialog. When a user wishes to use
this OPC server within the application, he will refer to it by the name he specified in the
dialog.
Page 23 of 130
8 OPC Inputs
After an OPC server has been configured via the OPC Server Properties dialog, OPC
inputs may be configured for use via the OPC Inputs dialog. An OPC input
configuration associates a unique name and an optional serial number with an input from
a configured OPC server.
To configure an OPC server for use with the application:

1. Select [Configure] [OPC Inputs]
OPC Inputs dialog is displayed
2. Select Add
OPC Input Properties dialog is displayed
3. Fill out the form entries in the OPC Input Properties dialog as described in the
OPC Input Properties section.
4. Select _OK_
If any OPC input entries have been previously configured, a list of these existing OPC
input configuration entries is shown within the dialog.
Page 24 of 130
Question Answer
The list of configured inputs cant be edited
Select the Add button from the OPC
from this dialog so how can a user create a Inputs dialog to bring up the OPC Input
new OPC input? Properties dialog. A user can create the
OPC input from there.
When the Delete button is pressed, To delete an OPC input entry, a user must
nothing happens. How can I delete an OPC first click on the OPC input entry he wishes
input entry from the configuration? to delete and then press Delete button.
The Delete button is enabled only when
one or more OPC input entries have been
selected.
What happens if a user tries to delete an The user will be warned when he attempts
OPC input that is currently being used by a to delete an OPC input that is in use by the
signal or some other component of the application. A listing of objects that are
application? using the input will be shown to the user
and he will be given the option to proceed
or cancel the delete operation. If the user
decides to continue the delete operation, all
objects that use the input being deleted will
set that input to a value of Unassigned.
Can a user delete more than one OPC input Yes. To select multiple OPC input entries
at a time? for deletion, the user must press CTRL-
button to delete all of the selected OPC
input entries.
When the Edit button is pressed, nothing The user should first select the OPC input
happens. How can a user edit an OPC entry he wishes to edit and then click the
entry? Edit button to bring up the OPC Input
Properties dialog for that entry. The
Edit button is enabled only when one
(and only one) input entry has been
selected.
How many OPC input configurations does The application places no hard limits on the
the application support? number of OPC inputs that may be
configured for a server.
Page 25 of 130
9 OPC Input Properties

The OPC Input Properties dialog is displayed when a user elects to add or edit an
OPC input entry from the OPC Inputs dialog box. From the OPC Input Properties
dialog, a user can specify a name for the OPC input and an optional serial number to
associate with the input. Before a user can add an OPC input, an OPC server must be
configured. Refer to the OPC Servers section for additional details.
A list of configured OPC servers is provided in the OPC server: combo box. The user
must select a server from the list provided.
After selecting the OPC server, the Browse for item: section of the dialog will be
updated will all of the OPC items available for that server. Either click on one of these
items as the input or type the name of the input into the OPC item name: text box.
After completing this form, click the OK button (if editing an existing entry) or the Add
button (if adding a new entry) to create the OPC input.
After creating the input, it will appear in the list of OPC inputs shown in the OPC Inputs
dialog box and it can be selected for use by configuration objects that accept OPC inputs.
Page 26 of 130
10 INSITE Inputs
INSITE inputs may be configured for use via the INSITE Inputs dialog. An INSITE
input is read from a user-specified location within the INSITE database. INSITE inputs
may be used to feed the four different kinds of signals supported by the application
(Direct Analog Signals, Processed Analog Signals, Pulse Signals, and Analog Rates).
The INSITE input may optionally feed an OPC destination as well.
To configure an INSITE input for use with the application:

1. Select [Configure] [INSITE Inputs]
INSITE Inputs dialog is displayed
2. Select Add
INSITE Input Properties dialog is displayed
3. Fill out the form entries in the INSITE Input Properties dialog as described in
the INSITE Input Properties section.
4. Select _OK_
If any INSITE input entries have been previously configured, a list of these existing
INSITE input configuration entries is shown within the dialog.
Page 27 of 130
Question Answer
The list of configured inputs cant be edited
Select the Add button from the INSITE
directly from this dialog so how can a userInputs dialog to bring up the INSITE
create a new INSITE input? Input Properties dialog. A user can
create the INSITE input from there.
When the Delete button is pressed, To delete an INSITE input entry, a user
nothing happens. How can I delete an must first click on the INSITE input entry
INSITE input entry from the configuration? he wishes to delete and then press Delete
button. The Delete button is enabled only
when one or more INSITE input entries
have been selected.
What happens if a user tries to delete an The user will be warned when he attempts
INSITE input that is currently being used to delete an INSITE input that is in use by
by a signal or some other component of the the application. A listing of objects that are
application? using the input will be shown to the user
and he will be given the option to proceed
or cancel the delete operation. If the user
decides to continue the delete operation, all
objects that use the input being deleted will
set that input to a value of Unassigned.
Can a user delete more than one INSITE Yes. To select multiple INSITE input
input at a time? entries for deletion, the user must press
CTRL-CLICK on each entry he wishes to
delete. Each entry will highlight as the user
does this. The user can then select the
Delete button to delete all of the selected
INSITE input entries.
When the Edit button is pressed, nothing The user should first select the INSITE
happens. How can a user edit an INSITE input entry he wishes to edit and then click
entry? the Edit button to bring up the INSITE
Input Properties dialog for that entry.
The Edit button is enabled only when
one (and only one) input entry has been
selected.
How many INSITE input configurations The application places no hard limits on the
does the application support? number of INSITE inputs that may be
configured.
Page 28 of 130
11 INSITE Input Properties

The INSITE Input Properties dialog is displayed when a user elects to add or edit an
INSITE input entry from the INSITE Inputs dialog box. From the INSITE Input
Properties dialog, a user can specify a name for the INSITE input, an optional serial
number to associate with the input, and the location within the INSITE database.
The INSITE Destination section shown on this dialog is the INSITE location where the
input will be read. For instructions on configuring an INSITE address, refer to the
INSITE Item Address Properties section of this document.
Page 29 of 130
The OPC Destination section allows the user to configure an optional OPC server
location where the INSITE input will be written. In order to configure this OPC location,
the user must first select the Write to OPC check box and then configure the OPC
server and OPC item name fields. The process of configuring the OPC Destination is
similar to the process of configuring an OPC Input as described in the OPC Input
Properties section of this document.
After completing this form, click the OK button to create the INSITE input.
After creating the input, it will appear in the list of INSITE inputs shown in the INSITE
Inputs dialog box and it can be selected for use by configuration objects that accept
OPC inputs.
Page 30 of 130
12 INSITE Item Address Properties

In order for the application to store or retrieve data to or from INSITE database, the user
must specify a location within INSITE where the variable of interest resides. The
primary keys that INSITE uses to uniquely describe a dataset within the database are Well
ID, Run Number, Record Type, and Description. Since the Sentry application uses
INSITEs current Well ID and Run Number for all of its data logging operations only the
Record Type and Description need to be provided by the user to specify the dataset.
An INSITE dataset is a collection of variables; an INSITE item address represents a

specific variable within a dataset. In order to specify the variable of interest within the
dataset and the type of data it represents, a variable name and unit name must also be
supplied.
To summarize, the following four items comprise an INSITE item address:

Record type
Record description
Variable
Units
The Record type is the name of the INSITE record where the variable of interest
resides.
The Record description is a label that is sometimes used within INSITE to help the
user organize datasets. Some datasets have no description.
The Variable is the name of a specific variable that is defined by the primary key
[current well, current run, selected record type, selected record description].
The Units entry represents the unit value of the variable data. For instance, a variable
might provide the number 5, while the Units entry is used to specify that the variable
represents a measurement in barrels per hour.
The INSITE Item Address Properties dialog is used to configure the four pieces of
information required to specify an INSITE item address.
Page 31 of 130
A drop-down list box is provided for each of the four required entries. To configure an
INSITE item address from this dialog, a user must follow the following steps:
1. Select a record type.

After selecting a record type, the Record description list will be updated
2. Select or type in the name of a record description.
After providing a valid record description, the Variable and Units lists will be
updated.
3. Select a variable name.
After selecting a variable name, the Units list will update to show unit values that
are valid for the variable.
4. Select the units for the variable.
5. Click the OK button.
Page 32 of 130
13 Assigning INSITE and OPC Destinations

The output of every configuration object supported by the application (signals, flows,
cumulatives, and UBA calculations) may be logged to the INSITE database and to an
OPC destination. The procedure for configuring these destinations is outlined in this
section. This procedure is the same for all configuration objects.
To assign a configuration objects output to a location within the INSITE database or to

an OPC location, the user must first activate the properties dialog for the configuration
object. The Processed Analog Signal Properties dialog is shown in the example
below, but all configuration objects have an Outputs section near the bottom of the
dialog where the INSITE and OPC destination configurations are displayed.
In the Outputs section of the dialog:

1. Locate the output entry of interest. Each output will have a name to the
left describing the value that it holds and a configuration button labeled _
_ to the right.
2. Select the entrys configuration button labeled __.

Output Destination Properties dialog is displayed
3. Fill out the Output Destination Properties dialog. Refer to the
section titled Output Destination Properties section for additional details.
Page 33 of 130
14 Output Destination Properties

The Output Destination Properties dialog allows a user to configure both an
INSITE destination and an OPC destination. When the value associated with this output
is written, it will be written to the INSITE and OPC locations specified. If the Write to
INSITE check box is cleared, the value will not be written to INSITE. Similarly if the
Write to OPC checkbox is cleared, the value will not be written to the OPC Destination.
This dialog is used to assign the write locations of the outputs of signals, flows, UBA
calculations and other configuration objects used within Sentry.
Page 34 of 130
The process of configuring the INSITE destination on this dialog is similar to the process
of configuring the INSITE address on the INSITE Item Address Properties form.
For instructions on configuring the INSITE destination, refer to the INSITE Item Address
The process of configuring the OPC destination is similar to the process of configuring an
OPC input as described in the OPC Input Properties section of this document.
After completing this form, click the OK button to create the INSITE / OPC destination.
Page 35 of 130
15 Fluid Properties
Fluid properties are used as inputs to the applications oil flow configuration objects.
These fluid properties contain details about the makeup of the fluids that are used in the
oil flows calculations.
Each fluid property configuration contains the following details:

A unique name
A numeric value for the uncorrected API gravity of the fluid
A numeric value for the uncorrected API temperature of the fluid expressed in
either degrees Celsius or degrees Fahrenheit
A value between 0 and 100 that represents the water percentage of the fluid
A value between 0 and 100 that represents the solids percentage of the fluid
A value between 0 and 100 that represents the shrinkage percentage of the fluid
The application dialog that is used to configure this information is shown below:
To add a fluid property to the configuration:

1. Select [Configure] [Fluid Properties]
Fluid Properties Setup dialog is displayed
2. Select Add
Fluid Properties dialog is displayed
3. Enter a descriptive name for the new fluid and complete the remaining entries in
the dialog.
4. Select _OK_
The list of configured fluid properties appears in the list contained in the Fluid
Properties Setup dialog.
Page 36 of 130
Page 37 of 130
16 Gas Properties
Gas properties are used as inputs to the applications gas flow and orifice flow
configuration objects. These gas properties contain details about the makeup of the gases
that are used in the gas and orifice flow calculations.
Each gas property configuration contains the following details:

A unique name
A numeric value the represents the specific gravity of the gas at 60 degrees
Fahrenheit and 14.73 psi (absolute).
A value between 0 and 1,000,000 representing the amount of hydrogen sulfide
(H2S - expressed in parts per million) that is present in the gas.
A value between 0 and 100 that represents the percentage amount of the following
items in the gas:
Carbon dioxide
Nitrogen
Methane
Ethane
Propane
Isobutane
Normal Butane
Isopentane
Normal pentane
Normal hexane
Normal heptane
Normal octane
Normal nonane
Normal decane
Water
Hydrogen
Carbon monoxide
Oxygen
Helium
Argon
The application dialog that is used to configure this information is shown below:
Page 38 of 130
The percentages entered along with the calculated percentage for the amount of hydrogen
sulfide must equal exactly 100%.
To add a fluid property to the configuration:

1. Select [Configure] [Gas Properties]
Gas Properties Setup dialog is displayed
2. Select Add
Gas Properties dialog is displayed
3. Enter a descriptive name for the new gas and complete the remaining entries in
the dialog.
4. Select _OK_
The list of configured fluid properties appears in the list contained in the Gas
Properties Setup dialog.
Page 39 of 130
Page 40 of 130
17 Special Values
Special values are user-configured numeric constants. These special values have an
associated INSITE item address and OPC Destination and are logged to the database.
To configure a special value:

1. Select [Configure] [Special Values]
Special Values dialog is displayed
2. Select Add
Special Value Properties dialog is displayed
3. Enter a descriptive name for special value.

4. Enter the numeric value to associate with this entry.
5. Configure an INSITE / OPC destination as described in the Output Destination
Properties section.
6. Select _OK_.
Special Value Properties dialog is dismissed and the Special
Values dialogs list view updates to show the newly added special value
entry.
Page 41 of 130
Page 42 of 130
Question Answer
When the Delete button is pressed, To delete a special value entry, a user must
nothing happens. How can I delete a first click on the special value entry he
special value entry from the configuration? wishes to delete and then press Delete
when one or more special value entries
have been selected.
Can a user delete more than one special Yes. To select multiple special value entries
value at a time? for deletion, the user must press CTRL-
button to delete all of the selected special
value entries.
When the Edit button is pressed, nothing The user should first select the special
happens. How can a user edit a special value entry he wishes to edit and then click
value entry? the Edit button to bring up the Special
Value Properties dialog for that entry.
one (and only one) input entry has been
selected.
How many special value configurations The application places no hard limits on the
does the application support? number of special values that may be
configured.
Page 43 of 130
18 Signals
Signals are the set of four configuration objects that process the values coming directly
from an OPC or INSITE input. Signals are the only configuration objects that may
process OPC or INSITE inputs. The outputs from these signals are logged to INSITE and
are also used to feed the inputs of other types of configuration objects such as flows,
cumulatives, and UBA calculations.
The four types of signals supported by the application are:

Direct Analog Signals
Processed Analog Signals
Pulse Signals
Analog Rates
18.1 Direct Analog Signals

The input to a direct analog signal is a value originating from either an OPC server input
or an INSITE input. The direct analog signal logs the raw data received from the OPC
server input or INSITE input to a user defined location. A flowchart describing the
computational algorithm employed by the direct analog signal is shown below.
Page 44 of 130
To configure a direct analog signal:

1. Select [Configure] [Signals]
Signals dialog is displayed
2. Select Add
Select Type dialog is displayed
Page 45 of 130
3. Select Direct Analog Signal from the list provided and select _OK_ .
Direct Analog Signal Properties dialog is displayed
4. Enter a descriptive name for the direct analog signal.

5. Optionally assign the direct analog signal to one or more display groups by
following the procedure outlined in the section titled Assigning configuration
objects to display groups.
6. Select a data input for the direct analog signal by following the procedure outlined
in the section titled Assigning Signal Inputs.
7. The user should select the Force Value checkbox only if he wishes to manually
set the output value of the direct analog signal. If checked, the value entered next
to the Force Value checkbox will become the value that is logged to the Raw:
INSITE : OPC destination. Configure the Raw destination output as described in
the section titled Assigning INSITE and OPC Destinations.
8. Select _OK_ .
Page 46 of 130
18.2 Processed Analog Signals

The input to a processed analog signal is a value originating from either an OPC server
input or an INSITE input. A flowchart describing the computational algorithm employed
by the processed analog signal is shown below.
To configure a processed analog signal:

Page 47 of 130
2. Select Add
3. Select Processed Analog Signal from the list provided and select _OK_
Processed Analog Signal Properties dialog is displayed
4. Enter a descriptive name for the processed analog signal.

5. Optionally assign the processed analog signal to one or more display groups by
following the procedure outlined in the section titled Assigning configuration
objects to display groups.
6. Select a data input for the processed analog signal by following the procedure
outlined in the section titled Assigning Signal Inputs.
Page 48 of 130
7. Choose and configure a scaling method as described in the section titled Signal
Scaling.
8. Optionally choose and configure a method for noise averaging as described in the
section titled Noise Averaging.
9. Enter a value for the offset. As shown in the computational flowchart, the offset
is a value that is added to the computed rate after the scaling and noise averaging
operations complete.
9. The user should select the Force Value checkbox only if he wishes to override
the calculated processed analog signal value. If checked, the value entered next to
the Force Value checkbox will become the calculated value that is logged to the
Calculated: destination. Enabling Force Value has no effect on the value that
is logged to the Raw: destination. Configure the Calculated and Raw
destinations as described in the section titled Assigning INSITE and OPC
Destinations.
10. Select _OK_ .
If changes are made to a processed analog signal configuration while the application is
acquiring data, the Value: column on the Processed Analog Signal Properties
dialog will update in real time to show a preview of the effect of the changes.
Page 49 of 130
18.3 Pulse Signals

The input to a pulse signal is a value originating from either an OPC server input or an
INSITE input. Each pulse count increment represents a volume amount. The user
configures the amount of volume that each pulse increment equates to during the setup of
the pulse signal. The total volume and flow rate are also computed. A flowchart
describing the computational algorithm employed by the pulse signal rate is shown
below.
Page 50 of 130
To configure a pulse signal:

2. Select Add
Page 51 of 130
3. Select Pulse Signal from the list provided and select _OK_
Pulse Signal Properties dialog is displayed
4. Enter a descriptive name for the pulse signal.

5. Assign a flow type for the pulse signals output as outlined in the section titled
Flow Types. Available options are Gas, Liquid, Oil, Solids, Water and
Unspecified.
6. Optionally assign the pulse signal to one or more display groups by following the
procedure outlined in the section titled Assigning configuration objects to display
groups.
7. Select a data input for the pulse signal by following the procedure outlined in the
section titled Assigning Signal Inputs.
8. Enter a rollover value. This is the maximum value that the pulse counter may
reach. For example, if a rollover value of 100 is specified and an input pulse count
of 90 is received followed by a value of 10, then the application will compute that
20 pulses have occurred between the two readings.
9. Enter the pulses per unit volume. This value associates a volume amount with a
pulse. For example, if the user configures 1 pulse per unit volume and the volume
units selected for the outputs are in gallons, then every time a pulse is detected,
the pulse signal will compute that 1 gallon of volume has passed.
11. Enter a value for the offset. The offset is a value that is added to the computed
rate after the scaling and noise averaging operations complete.
the computed incremental volume value. If checked, the value entered next to the
Force Value checkbox will become the incremental volume value that is logged
Page 52 of 130
to the Incremental volume: destination and will be the incremental volume used
when calculating the flow rate and total volumes. Enabling Force Value has no
effect on the value that is logged to the Raw: destination. Configure the Rate,
Incremental volume, Total volume, and Raw destination outputs as described
in the section titled Assigning INSITE and OPC Destinations.
11. Select _OK_ .
If changes are made to a pulse signal configuration while the application is acquiring
data, the Value: column on the Pulse Signal Properties dialog will update in real
time to show a preview of the effect of the changes.
Page 53 of 130
18.4 Analog Rates

The input to an analog rate is a value originating from either an OPC server input or an
INSITE input. This input value is assumed to represent an instantaneous rate value (i.e. a
unit volume per unit time). A flowchart describing the computational algorithm
employed by the analog rate is shown below.
Page 54 of 130
To configure an analog rate:

2. Select Add
Page 55 of 130
3. Select Analog Rate from the list provided and select _OK_
Analog Rate Properties dialog is displayed
4. Enter a descriptive name for the analog rate.

5. Assign a flow type for the analog rates output as outlined in the section titled
Unspecified.
6. Optionally assign the analog rate to one or more display groups by following the
groups.
7. Select a data input for the analog rate by following the procedure outlined in the
section titled Assigning Signal Inputs.
8. Choose and configure a scaling method as described in the section titled Signal
Scaling.
10. Enter a value for the offset. As shown in the computational flowchart, the offset
is a value that is added to the computed rate after the scaling and noise averaging
operations complete.
Page 56 of 130
the computed analog rate. If checked, the value entered next to the Force Value
checkbox will become the rate value that is logged to the Rate: destination and
will be the rate used when calculating the incremental and total volumes.
Enabling Force Value has no effect on the value that is logged to the Raw:
destination. Configure the Rate, Incremental volume, Total volume, and
Raw destination outputs as described in the section titled Assigning INSITE and
OPC Destinations.
12. Select _OK_ .
If changes are made to an analog rate configuration while the application is acquiring
data, the Value: column on the Analog Rate Properties dialog will update in real
time to show a preview of the effect of the changes.
Page 57 of 130
18.5 Signal Scaling

The inputs to processed analog signals and analog rates are scaled according to one of
three user selectable algorithms -- linear scaling, piecewise linear scaling, or polynomial
scaling.
Both the Processed Analog Signal Properties dialog and the Analog Rate
Properties dialog contain a section labeled Scaling that is devoted to the selection
and configuration of these scaling algorithms.
To configure the scaling algorithm, a user should click on the scaling method he desires
and then press the Configure button.
After pressing the Configure button, the user will be presented with the Linear
Scaling, Piecewise Linear Scaling, or Polynomial Scaling dialogs, depending
on which scaling method was selected. Refer to the sections titled Linear Scaling,
Piecewise Linear Scaling, and Polynomial Scaling for additional details.
Page 58 of 130
18.5.1 Linear Scaling

The applications linear scaling function requires the entry of 2 scaling points. A scaling
point is comprised of a raw (X) value and a scaled (Y) value. OPC server input or
INSITE input data feeds the linear scaling algorithm and the output value is computed
based on the two user-defined scaling points. An example of this is shown below.
Assume that a user wishes to configure a scaling transfer function that follows the
following graph:
In this case, the user would need to configure scaling points of (2, 4) and (6, 10). This
means that if an input value of 6 is being scaled, the output of the scaling function will be
10 since the user has defined the point (6, 10).
The scaling value returned is the Y value of the line that extends between the two user-
defined scaling points. Using the example data above, if an input value of 4 was
received, the scaling function would determine that when X is 4, the Y value is 7 and that
would be the value returned by the scaling function. If an input value of 1 was received,
the scaling function would determine that when X is 1, the Y value is 2.5.
Functionally, the linear scaling function behaves exactly like the piecewise linear scaling
function when only two points are defined.
To configure linear scaling, the user should follow the steps outlined in the section titled
Signal Scaling and choose Linear as the scaling option in order to reach the Linear
Scaling dialog shown below.
Page 59 of 130
On the Linear Scaling dialog, perform the following steps:
1. Enter the raw and scaled values that define each of the scaling points.
2. Select _OK_ .
Page 60 of 130
18.5.2 Piecewise Linear Scaling
The applications piecewise linear scaling function allows the entry of between 2 and 10
scaling points (inclusive), where a scaling point is comprised of a raw (X) value and a
scaled (Y) value. An OPC server input or INSITE input data feeds the scaling algorithm
and dictates which pair of adjacent points to use to scale the value. An example of this is
shown below.
Assume that a user wishes to configure a scaling transfer function that follows the
following graph:
In this case, the user would need to configure scaling points of (2, 4), (6, 10), (8, 5) and
(12, 20). This means that if an input value of 6 is being scaled, the output of the scaling
function will be 10 because the user has defined the point (6, 10).
If an input value lies between two defined scaling points, the scaling value returned is the
Y value of the line that extends between those two points. Using the example data above,
if an input value of 7 was received, the scaling function would determine that the input
value lies on the line defined by (6, 10) and (8, 5). On the line defined by those two
points, the Y value is 7.5 and that would be the value returned by the scaling function.
In the event that an input value lies at a location less than the lowest user defined raw
value or higher than the highest user defined raw value, the scaling function will use the
line defined by the two defined points whose X values are closest to the raw value. Using
the example data above, if an input value of 0 was received, the scaling function would
determine that the proper points to use are (2, 4) and (6, 10). On the line defined by those
two points, the Y value is 1 and that would be the value returned by the scaling function.
Page 61 of 130
To configure piecewise linear scaling, the user should follow the steps outlined in the
section titled Signal Scaling and choose Piecewise linear as the scaling option in
order to reach the Piecewise Linear Scaling dialog shown below.
Page 62 of 130
On the Piecewise Linear Scaling dialog, perform the following steps:
1. Enter the number of desired scaling points. This number must be between 2 and
10 (inclusive).
2. Enter the raw and scaled values that define each of the scaling points.
3. Select _OK_ .
Page 63 of 130
18.5.3 Polynomial Scaling
The polynomial scaling algorithm computes the Y location of an input value that lies
somewhere along a curve defined by a quintic equation (a polynomial of degree 5). The
following equation is used by the application to compute the scaled value:
Y = AX5 + BX4 + CX3 + DX2 + EX + F
In this equation, X is the value retrieved from an OPC server input or INSITE input, Y is
the scaled output value, and A-F represents user configurable parameters.
For example, if a user specifies A = 0, B = 0, C = 2, D = 6, E = -18, and F = 6 then the

following graph illustrates the polynomial scaling values as they appear near X = 0.
To configure polynomial scaling, the user should follow the steps outlined in the section
titled Signal Scaling and choose Polynomial as the scaling option in order to reach the
Polynomial Scaling dialog shown below.
Page 64 of 130
On the Polynomial Scaling dialog, perform the following steps:
1. Enter the coefficient values (A-F) that define the 5th degree polynomial:
Y = AX5 + BX4 + CX3 + DX2 + EX + F
2. Select _OK_ .
Page 65 of 130
18.6 Noise Averaging
The noise averaging function is configured with two user defined integers, A and B,
which are used in the following algorithm:
Xavg = (AXin + BXavg) / (A + B)

(where A >= 1 and B >= 0)
Xin represents the value that is input to the transfer function and Xavg is the computed
noise average of Xin. The first time the noise average is calculated, the Xavg = Xin.
To configure the noise averaging algorithm from the Properties, Analog Rate
Properties, or Pulse Signal Properties dialogs, a user should perform the
following steps:
1. Enable the Noise Averaging checkbox
2. Press the Configure button.

Noise Averaging dialog is displayed
3. Enter a value for noise averaging coefficient A where A >= 1

4. Enter a value for noise averaging coefficient B where B >= 0
5. Select _OK_ .
Page 66 of 130
18.7 Assigning Signal Inputs
The properties form for every signal contains a section labeled Inputs. Inside the
Inputs section there is a box which contains the name of the currently assigned input or
the name Unassigned if an input has not yet been assigned to the signal. Beside the
box is a configuration button labeled __. This button launches the Select Input
dialog as shown in the diagram below. It is from the Select Input dialog that the input
assignment is made.
Signals may only use inputs provided by OPC server or INSITE. If the input a user
wishes to use has not yet been configured when the Select Input dialog is shown, the
Page 67 of 130
user may select either the Add OPC Input or Add INSITE Input buttons to launch the
OPC Input Properties or INSITE Input Properties dialogs. After configuring the
new input, the user is returned to the Select Input dialog and the newly created input
will be displayed in the Select Input dialogs inputs list.
Page 68 of 130
19 Flows
Flows are configuration objects that perform additional processing on the applications
signals. As with signals, the application does not limit the number of flows that a user
may configure. While all flows expect at least some of their input values to come from
user-configured signals, some flows also expect input from user-supplied gas properties
or fluid properties. Flows do not accept input from any other types of configuration
objects. The calculated outputs of some flows may also be used as inputs to cumulatives
and UBA calculations. As with all configuration objects, the calculated outputs of a flow
can be logged to INSITE.
The following five types of configuration objects are referred to as flows:

Gas Flow
Oil Flow
Orifice Flow
Tank
Water Flow
Page 69 of 130
19.1 Gas Flow
The gas flow configuration object accepts input from a user-configured gas property and
three user-configured signals to produce a calculated gas flow rate, and an incremental
and total gas volume result. A flowchart describing the computational algorithm
employed by the gas flow is shown below.
Page 70 of 130
To configure a gas flow:

1. Select [Configure] [Flows]
Flows dialog is displayed
2. Select Add
Page 71 of 130
3. Select Gas Flow from the list provided and select _OK_
Gas Flow Properties dialog is displayed
4. Enter a descriptive name for the gas flow.

5. Optionally assign the gas flow to one or more display groups by following the
groups.
6. The Gas Properties: combo box lists the names of all configured gas
properties. Choose an entry from this list. If Unassigned is the only listed
option, the user must configure a gas property using the procedure outlined in the
Gas Properties section.
7. The Pressure: combo box lists the names of all configured processed analog
signals and direct analog signals. Choose a pressure entry from this list. If
Unassigned is the only listed option, the user must configure a processed analog
signal or direct analog signal that outputs a pressure value.
8. The Temperature: combo box lists the names of all configured processed analog
signals and direct analog signals. Choose a temperature entry from this list. If
signal or direct analog signal that outputs a temperature value.
9. The Instantaneous rate: combo box lists the names of analog rates and pulse
signals that have a flow type of Gas. Choose a gas flow rate entry from this list.
If Unassigned is the only listed option, the user must configure an analog rate or
pulse signal with a flow type of Gas.
10. Enter a numeric value for the meter factor. The meter factor is multiplied with the
input rate to determine the output gas rate.
Page 72 of 130
11. Enter a numeric value for the standard pressure and select the proper pressure
units.
12. Enter a numeric value for the standard temperature and select the proper
temperature units.
13. Configure the Gas rate, Gas incremental volume and Gas total volume
destination outputs as described in the section titled Assigning INSITE and OPC
Destinations.
14. Select _OK_ .
Page 73 of 130
19.2 Oil Flow
The oil flow configuration object accepts input from a user-configured fluid property and
two user-configured signals. The outputs of the oil flow calculation are a set of flow
rates, incremental volumes and total volumes for oil, water and solids. A flowchart
describing the computational algorithm employed by the oil flow is shown below.
Page 74 of 130
To configure an oil flow:

2. Select Add
Page 75 of 130
3. Select Oil Flow from the list provided and select _OK_ .
Oil Flow Properties dialog is displayed
4. Enter a descriptive name for the oil flow.

5. Optionally assign the oil flow to one or more display groups by following the
procedure outlined in section Assigning configuration objects to display groups.
6. The Fluid Properties: combo box lists the names of all configured fluid
option, the user must configure a fluid property using the procedure outlined in
the Fluid Properties section.
signals that have a flow type of Fluid. Choose a flow rate entry from this list.
If Unassigned is the only listed option, the user must configure an analog rate or
pulse signal with a flow type of Fluid.
9. Enter a numeric value for the meter factor. The meter factor is used to scale the
input rate as shown in the computational algorithm diagram.
10. Configure the rate, incremental volume and total volume entries for the Oil, Water
and Solids destination outputs as described in the section titled Assigning INSITE
and OPC Destinations.
11. Select _OK_ .
Page 76 of 130
19.3 Orifice Flow

The orifice flow configuration object accepts input from a user-configured gas property
and three user-configured signals to produce a calculated gas flow rate, and an
incremental and total gas volume result. A flowchart describing the computational
algorithm employed by the orifice flow is shown below.
Page 77 of 130
To configure an orifice flow:

2. Select Add
Page 78 of 130
3. Select Orifice Flow from the list provided and select _OK_ .
Orifice Flow Properties dialog is displayed
4. Enter a descriptive name for the orifice flow.

5. Optionally assign the orifice flow to one or more display groups by following the
groups.
6. The Gas Properties: combo box lists the names of all configured gas
option, the user must configure a gas property using the procedure outlined in the
Gas Properties section.
7. The Pressure: combo box lists the names of all configured processed analog
signals and direct analog signals. Choose a pressure entry from this list. If
signal or direct analog signal that outputs a pressure value.
9. The Differential pressure: combo box lists the names of all configured
processed analog signals and direct analog signals. Choose a pressure entry from
this list. If Unassigned is the only listed option, the user must configure a
processed analog signal or direct analog signal that outputs a pressure value.
Page 79 of 130
10. If the upstream tap is active, enable the Active checkbox as shown below. If
the upstream tap is not active, leave the Active checkbox unchecked.
11. Enter numeric values for the sizes of the orifice plate and meter tube diameter (in
inches).
12. Configure the Gas rate, Gas incremental volume and Gas total volume
destination outputs as described in the section titled Assigning INSITE and OPC
Destinations.
13. Select _OK_ .
Page 80 of 130
19.4 Tank
The tank configuration object accepts input from two configured signals to produce
calculated volume values for oil, water and solid material in a tank. A flowchart
describing the computational algorithm employed by the tank is shown below.
Page 81 of 130
To configure a tank:
2. Select Add
3. Select Tank from the list provided and select _OK_ .

Tank Properties dialog is displayed
Page 82 of 130
4. Enter a descriptive name for the orifice flow.

5. Optionally assign the orifice flow to one or more display groups by following the
groups.
Page 83 of 130
6. The temperature value may be provided by either a processed analog signal, direct
analog signal or by a user entered value.
a. If a signal input for temperature is desired, select the Temperature entrys
Analog signal: checkbox and choose a temperature entry from the
Temperature combo box. If Unassigned is the only listed option, the user
must configure a processed analog signal or direct analog signal that outputs a
temperature value.
b. To input a temperature value manually, select the Temperature entrys

Manual entry: checkbox and enter a temperature value in the space
provided. Check either F or C to specify the temperature values
measurement units.
7. The tank level value may be provided by either a processed analog signal, direct
analog signal or by a user entered value.
a. If a signal input for the tank level is desired, select the Tank Level entrys
Analog signal: checkbox and choose a depth entry from the Tank Level
combo box. If Unassigned is the only listed option, the user must configure
a processed analog signal or direct analog signal that outputs a depth value.
Page 84 of 130
b. To input a tank level value manually, select the Tank Level entrys Manual
entry: checkbox and enter a depth value in the space provided. Check either
in or cm to specify the depths value as either inches or centimeters.
8. Enter a numeric value for the API standard temperature and select the proper
temperature measurement units.
9. Enter a numeric value for the tank offset and select the proper depth measurement
units from the combo box.
10. Enter a numeric value for the volume scale factor. The units for this scale factor
are determined by the selected unit values of the Tank level entry and Tank
offset volume entries. For example, if the user selects a tank level expressed in
inches and a tank offset volume expressed in cubic feet, then the volume
scale factor would have a measurement unit of cubic feet / inch.
11. Enter a numeric value for the API oil gravity.

12. Enter a numeric value for the water level. The measurement units used for the
entered water level are the same as the measurement units used for the tank level.
13. Enter a numeric value for the solids level. The measurement units used for the
entered solids level are the same as the measurement units used for the tank level.
14. Configure the Oil total volume, Water total volume and Solids total
volume destination outputs as described in the section titled Assigning INSITE
15. Select _OK_ .
Page 85 of 130
19.5 Water Flow
The water flow configuration object accepts input from a rate signal to produce a
calculated water flow rate and an incremental and total water volume result. A flowchart
describing the computational algorithm employed by the water flow is shown below.
To configure a water flow:

Page 86 of 130
2. Select Add
3. Select Water Flow from the list provided and select _OK_
Water Flow Properties dialog is displayed
4. Enter a descriptive name for the water flow.

5. Optionally assign the water flow to one or more display groups by following the
groups.
signals that have a flow type of Water. Choose a water flow rate entry from this
list. If Unassigned is the only listed option, the user must configure an analog
rate or pulse signal with a flow type of Water.
7. Enter a numeric value for the meter factor. The meter factor is multiplied with the
input rate to determine the output water flow rate.
Page 87 of 130
8. Configure the Water rate, Water incremental volume and Water total
volume destination outputs as described in the section titled Assigning INSITE
9. Select _OK_ .
Page 88 of 130
20 Cumulatives
Cumulatives are configuration objects that accept the rate outputs of up to five other
configuration objects and combines them by addition or subtraction (depending on the
users preference). Individual rate inputs may be added or subtracted from each other to
produce an output rate, an incremental volume and a total volume result. As with signals
and flows, the application does not place a hard limit on the number of cumulatives that
may be configured. The calculated outputs of a cumulative are logged to the INSITE
destinations that are configured by the user and may also be used as inputs to some UBA
calculations. . A flowchart describing the computational algorithm employed by the
cumulative is shown below.
Cumulatives may accept input from any configuration object that provides a rate output
(including other cumulatives) so long as accepting the rate input does not cause a circular
reference. Cumulatives are prevented from feeding themselves either directly or
Page 89 of 130
indirectly through another cumulative by logic that prevents circular referencing. For
example, an invalid cumulative setup example is shown below:
In the example above, cumulative #4 cannot feed cumulative # 1 because doing so would
create a circular reference.
Page 90 of 130
To configure a cumulative:
1. Select [Configure] [Cumulatives]
Cumulatives dialog is displayed
2. Select Add
Cumulative Properties dialog is displayed
3. Enter a descriptive name for the cumulative.
Page 91 of 130
4. Assign a flow type for the cumulatives output as outlined in the section titled
Unspecified.
5. Optionally assign the cumulative to one or more display groups by following the
groups.
6. The Rate #1-5: combo boxes list the names of configuration object that provide
rate outputs. Choose a flow rate entry from this list. Rate inputs that are set to
Unassigned will not be used in the cumulatives calculation.
Select either the Add or Subtract button next to each configured rate entry to
inform the cumulative how you wish the input data to be treated. In the example
shown below, the rate output of the cumulative will be the produced gas flow rate
minus the pipeline gas flow rate.
7. Configure the Rate, Incremental volume and Total volume destination

outputs as described in the section titled Assigning INSITE and OPC
Destinations.
8. Select _OK_ .
Page 92 of 130
21 Flow Types
A flow type defines the material that a configuration object is processing. The available
options for flow type are Gas, Liquid, Oil, Solids, Water and Unspecified.
Flow types serve to filter the data presented as inputs to some of the applications
configuration objects. For example, only signals that have a flow type of Gas are
permitted as inputs to a gas flow configuration.
The properties dialogs for signals and cumulatives allow the user to configure the flow
type of their outputs. The method for assigning the flow type is the same whether it is
being assigned to a signal or cumulative. To assign the flow type, a user must first open
the properties dialog for the signal or cumulative he wishes to configure and then perform
the following steps:
1. Select the Flow type: list box button.

A listing of available flow types is displayed
2. From the list provided, select a flow type to assign to the output of this
configuration object.
Page 93 of 130
22 UBA Calculations
The application includes a set of configuration objects designed to perform certain UBA
calculations of interest. Only one of each of these UBA Calculations is allowed in the
application.
As with signals and flows, a UBA calculation accepts an external input, performs
calculations on the input and produces an output. The type of input that an individual
UBA calculation requires varies but the method for configuring the UBA calculations is
the same.
To configure a UBA calculation:

1. Select [Configure] [UBA Calculations]
UBA Calculations dialog is displayed
Page 94 of 130
2. Select a UBA calculation from the list provided and select Edit
The properties dialog for the selected UBA calculation is displayed. The
properties dialog for each UBA calculation has sections labeled Equation,
Inputs, and Output. The Separator 1 Volume Properties dialog is
shown below as an example.
3. Select or enter values in the Inputs section of the UBA calculation. Pay close
attention to the provided equation and to the required measurement units of the
form entries. Ensure that the UBA calculations parameters use the appropriate
unit values. The user is expected to only select inputs and outputs that conform to
the requirements of the listed equation. For example, in the Separator 1
Volume Properties dialog shown above, the user must ensure that the
Stage1Level input is supplied as a value expressed in inches.
4. Each UBA calculation provides a single calculated output. Configure the
destinations for this output as described in the section titled Assigning INSITE
and OPC Destinations. As with the inputs, the user must ensure that the output is
configured to use the appropriate unit values. For example, in the Separator 1
Volume Properties dialog shown above, the user must ensure that the output is
configured to produce a value expressed in barrels.
5. Select _OK_ .
The 18 UBA calculations supported by the application and the mathematical operations
that they perform are listed in following sections.
Page 95 of 130
22.1 Net Gas Rate
GasRateNet (MMscf/day) GasRateTotal (MMscf/day) GasRateInjected (MMscf/day)
22.2 Separator 1 Volume
Separator1Level (barrels) Stage1Level (inches) m b
In the equation above, m is a user configurable constant representing the volume/length

gradient and defaults to 0.55 barrels per inch. Similarly, b represents the volume of the
fluid below the stream and defaults to 17.32 barrels.
22.3 Separator 2 Volume
Separator 2 Level (barrels) Stage 2 Level (inches) m b
In the equation above, m is a user configurable constant representing the volume/length

gradient and defaults to 0.55 barrels per inch. Similarly, b represents the volume of the
fluid below the stream and defaults to 17.32 barrels.
22.4 Produced Gas Rate
GasRatePr oduced (MMscf/day) GasRateTotal (MMscf/day) InjectedGasRateTotal (MMscf/day)
22.5 Pit Active Volume
PitActiveVolume (barrels) PitTankVol ume (barrels)

All
The application supports the summation of up to 12 pit tanks.
22.6 Total Surface Oil Volume
SurfaceOilVolume Total (barrels) OilTanks Stage2 Liquid Stage1Oil (barrels)

All
The application supports the summation of up to 12 oil tanks.
Page 96 of 130
22.7 Total Surface Water Volume
SurfaceWaterVolumeTotal (barrels) WaterTanks (barrels)

All
The application supports the summation of up to 12 water tanks.
22.8 Water Cut
WaterStage 2Total
WaterCut
LiquidStage1Total
22.9 Water Oil Ratio
WaterStage 2Total
WaterOil Ratio
OilStage2Total
22.10 Gas Oil Ratio
Gas Net
GasOil Ratio
Oil Net
22.11 Gas Fraction
Gas Net
Gas Fraction
Liquid Net
22.12 Instantaneous Total Production Index
QReservoir QOut QIn

PI
PDrawdown PReservoir PPwd
22.13 Instantaneous Gas Production Index
QReservoirGas QOutGas QInGas

PI Gas
Page 97 of 130
22.14 Instantaneous Oil Production Index
QReservoirOil QOutOil QInOil

PI Oil
22.15 Instantaneous Water Production Index
QReservoirWater QOutWater QInWater

PIWater
22.16 Net Oil
OilNet OilTotal OilInjected
22.17 Net Water
Water Net WaterTotal Water Injected
22.18 Net Liquid
Liquid Net Liquid Total Liquid Injected
Page 98 of 130
23 Choke Control Properties

The Choke Control Properties Form is used to configure the input and output
locations that are used in the Choke Control View.
There are three different sets of properties that may be configured to support the choke
control: Inputs, Parameters and Outputs. Inputs are read-only values,
Parameters are read-write values, and Outputs are write-only values that are used by
the Choke Control View. An example of the Choke Control Properties Form is
shown below.
The function of the property tabs and buttons displayed on this form are described in the
following sections.
Page 99 of 130
23.1 Inputs
The Inputs tab of the Choke Control Properties Form is used to select OPC Inputs
for use as read-only entries in the Choke Control View.
An entrys Name, OPC Input source and Current Value are shown in the Inputs tab.
The user may select the OPC Input for each tag by clicking on the OPC Inputs combo
box and selecting one of the existing OPC Inputs. To define OPC Inputs for use with the
Inputs tab of the Choke Control Properties Form, the user should follow the
procedure described in the section titled OPC Inputs. When Sentry is acquiring or
logging data, the value of the selected OPC Input will be shown in the Current Value
field of the entry.
23.2 Parameters
The Parameters tab of the Choke Control Properties Form is used to select OPC
Inputs, OPC Destinations, INSITE Destinations and Default Values for use as
read-write entries in the Choke Control View.
Page 100 of 130

An entrys Name, OPC Input/Destination, INSITE Destination, Current Value

and Default Value are shown in the Parameters tab.
To configure a Parameter entry:

1. Choose the OPC Input and OPC Destination for a tag by clicking in the OPC
Input/Destination combo box and selecting one of the existing OPC Inputs.
For Parameters, the OPC Input location is the same as the OPC Destination. To
define an OPC Input/Destination location for use with a Parameters entry, the user
should follow the procedure described in the section titled OPC Inputs. The OPC
Input/Destination defines the source of the input value used by the Choke Control
entry and the OPC item location where changes to the value will be written.
Page 101 of 130

2. To configure a choke control output to be written to INSITE, the user must

configure an INSITE destination address. Click the button shown in an entrys
INSITE Destination cell to display the INSITE Item Address Properties
Form and configure the address. The INSITE Item Address Properties dialog
is shown below as an example. Refer to the section titled INSITE Item Address
Properties for additional details.
3. To define a new default output value for a Parameter entry, click on the entrys
Default Value cell and type in the new numeric value.
When Sentry is acquiring or logging data, the value of the selected OPC Input will be
shown in the Current Value field of an entry.
23.3 Outputs
The Outputs tab of the Choke Control Properties Form is used to select OPC
Destinations, INSITE Destinations and Default Values for use as write-only
entries in the Choke Control View.
Page 102 of 130

An entrys Name, OPC Destination, INSITE Destination, and Default Value are
shown in the Outputs tab.
To configure an Output entry:

1. To write output information provided by the choke control to an OPC Destination,
the user must configure the OPC Destination for the appropriate entry. Click the
button shown in an entrys OPC Destination cell to display the OPC
Destination Properties Form. The OPC Destination Properties dialog is
shown below as an example. The process of configuring an OPC Destination is
similar to the process of configuring an OPC Input as described in the OPC Input
Page 103 of 130

2. To write output information provided by the choke control to the INSITE

database, the user must configure an INSITE destination address. Click the
button shown in an entrys INSITE Destination cell to display the INSITE Item
Address Properties Form and configure the address. The INSITE Item
Address Properties dialog is shown below as an example. Refer to the section
titled INSITE Item Address Properties for additional details.
3. To define a new default output value for a Parameter entry, click on the entrys
Default Value cell and type in the new numeric value.
23.4 Send Defaults to OPC Destinations
Clicking this button will cause the default values for all entries in the Parameters and
Outputs tabs to be sent to their respective OPC Destinations. The default values will also
be sent to their respective INSITE destinations when the button is pressed and logging
mode is active.
23.5 Restore Defaults from Choke Control
Clicking this button will cause the default values for all entries in the Parameters and
Outputs tabs to be restored to their original default values. It will not send the restored
default values to the OPC Destinations.
23.6 Update Defaults with Current Values
Clicking this button will cause the current values for all Parameter entries to become the
new default values. If the current value for an entry is null, the default value for that
entry will not be changed. This operation will not send the new default values to the OPC
Destinations.
Page 104 of 130

24 Display Groups
Display groups serve to filter the data shown on the applications real-time display
screens. Each signal, flow and cumulative defined in the application may be optionally
assigned to one or more display groups.
24.1 Adding, editing, and deleting display groups
To add a display group to the configuration:

1. Select [Configure] [Display Groups]
Display Groups dialog is displayed
2. Select Add
Display Group Properties dialog is displayed
3. Enter a descriptive name for the new display group.
4. Select _OK_ .
The list of configured display groups appears in the list contained in the Display Groups
dialog.
Page 105 of 130

Question Answer
The list of configured display groups cant Select the Add... button from the Display
be edited directly from this dialog so how Groups dialog to bring up the Display
can a user create a new display group? Group Properties dialog. A user can
create a display group from there.
When the Delete button is pressed, To delete a display group entry, a user must
nothing happens. How can a user delete a first click on the display group entry he
display group entry? wishes to delete and then press Delete
when one or more display group entries
have been selected.
What happens if a user tries to delete a All configuration objects will remove the
display group that is currently being used deleted display group from their list of
by a signal or some other component of the assigned display groups.
application?
Can a user delete more than one display Yes. To select multiple display group
group at a time? entries for deletion, the user must press
CTRL-CLICK on each entry he wishes to
delete. Each entry will highlight as the user
does this. The user can then select the
Delete button to delete all of the selected
display group entries.
When the Edit button is pressed, nothing The user should first select the display
happens. How can a user edit a display group entry he wishes to edit and then click
group entry? the Edit button to bring up the Display
Group Properties dialog for that entry.
one (and only one) display group entry has
been selected.
How many display groups does the The application places no hard limits on the
application support? number of display groups that may be
configured.
Page 106 of 130

24.2 Assigning configuration objects to display groups
Once a display group has been added to the configuration, the user may place various
configuration objects such as signals, flows or cumulatives into the display group.
The properties dialogs for signals, flows and cumulatives allow the user to associate them
with one or more display groups. To do this, a user must perform the following steps:
1. Select the button next to the Display Group listing

Select Display Groups dialog is displayed
2. Select one or more display groups from the Select Display Groups dialog
3. Select OK .
Select Display Groups dialog is dismissed
Selected display group(s) now appear(s) in the configuration objects
properties dialog
Page 107 of 130

24.3 Filtering a view by display group
The Processed Signals and Total Volumes views allow the user to filter the entries
that are shown by display group. On these views, the Display group filter is a drop-
down box located at the top-right portion of the view as shown below.
Select the desired display group by choosing it from the Display group filter or select
all to see all entries regardless of their display group assignments.
Page 108 of 130

25 Global Parameters
The rate at which raw data is retrieved from OPC and INSITE inputs and the rate at
which processed data is written to INSITE outputs are configurable via the Global
Parameters dialog. The Global Parameters dialog is accessed by selecting
[Configure] [Global Parameters] from the main menu.
The acquisition rate shown on the dialog refers to the rate at which input data is read
from OPC and INSITE inputs. When data is being logged to INSITE, the raw
(unprocessed) values will be written to INSITE at the acquisition rate. Raw data is the
data taken directly from an input and processed data is data after scaling or any other
operation is done to it. The user may set the acquisition rate to a value between 1 and 60
seconds.
The logging rate is the rate at which the application writes processed data to the INSITE
database. The user may set the logging rate to a value between 1 and 600 seconds. The
logging rate value must be greater than or equal to the acquisition rate value.
Page 109 of 130

26 Data Acquisition
Data acquisition is the processes of collecting input data from OPC server and/or INSITE
inputs. Once data acquisition is started, the application computes output values for the
configuration objects at a rate determined by the acquisition rate. The acquisition rate
is a value (expressed in seconds) that is configurable via the applications Global
Parameters dialog. For example, if the acquisition rate is set to 1 second, the application
will compute the output values for each configuration object every second when data
acquisition mode is enabled.
Data acquisition may be started independently of data logging operations; however data
logging operations require data acquisition to be started. Refer to the Data Logging
section for additional details on the relationship between data logging and data
acquisition.
Data acquisition and logging status is shown on the left side of the applications status
bar.
The user may start or stop data acquisition via the applications user interface. Data
acquisition is stopped until the user manually starts it. To start data acquisition, select
[Action] [Start Data Acquisition] or click on the button in the toolbar.
Once data acquisition has started, the user may stop data acquisition at any time by
selecting [Action] [Stop Data Acquisition] or by clicking on the button in
the toolbar.
Page 110 of 130

Page 111 of 130

27 Data Logging
Data logging is the processes of writing the applications outputs to the INSITE records
of the active well. Before data logging operations may begin, the application must
connect with INSITE. This INSITE connection is established automatically. INSITE
connectivity status is shown in the right section of the application's status bar.
Data logging operations are not allowed if the application has never connected to
INSITE. If the INSITE connection is lost at any time after logging operations have
already been started, the applications output will be buffered until the INSITE
connection is re-established. Once the INSITE connection is re-established, the buffered
output will be written to the database. If the application shuts down before a connection
to INSITE can be re-established, the buffered data will be lost.
Once data logging is started, the application computes output values for the configuration
objects at a rate determined by the acquisition rate while the computed outputs are
logged to INSITE at a rate determined by the logging rate. Both the acquisition rate
and logging rates are configurable via the Global Parameters dialog.
If a user enables data logging while data acquisition is stopped, the application will first
start data acquisition and then start data logging. If a user disables data logging, the
application will keep data acquisition mode on, however if a user stops data acquisition
while data logging is on, both data acquisition and data logging are turned off. In
summary, data logging operations are dependent on the data acquisition state but the data
acquisition state does not depend on the data logging state.
Page 112 of 130

Data acquisition and logging status is shown on the left side of the applications status
bar.
The user may start or stop data logging via the applications user interface. Data logging
is stopped until the user manually starts it. To start data logging, select [Action]
[Start Logging] or click on the button in the toolbar.
Once data logging has started, the user may stop data logging at any time by selecting
[Action] [Stop Logging] or by clicking on the button in the toolbar.
Page 113 of 130

28 User Comments
Users of the application may log free-form text comments into INSITE via the Enter
Comments dialog.
To enter a comment, perform the following actions:

1. Select [Actions] [Add User Comment]
Enter Comment dialog is displayed
2. Type in an operator ID to identify who is logging the comment. The application

remembers the last five user IDs that were entered and the user may alternatively
select one of these entries from the Operator ID: drop down list.
3. Enter the comment in the text box provided. The comment cannot exceed 127
characters.
4. Select _OK_ .
Page 114 of 130

29 Views
In the Sentry application, a view is a form that displays real-time updates of
application data. The application supports nine different types of views:
Inputs OPC and INSITE input values

Processed Signals processed analog signal output values
Total Volumes all total volume values computed by the application
Mass Balance graphical display of several user-configured values
UBA Calculations output values of all UBA calculations
Productivity Index input and output values of productivity index UBA
calculations
Events Event log listing
User Comments User comment log listing
29.1 Input View
The input view displays the real-time values of the OPC and INSITE inputs that are
configured for use by the application. The values shown in the view update at the user
defined acquisition rate.
Double-clicking on an entry in the view brings up the configuration dialog for that entry.
OPC input and INSITE input management functions can be accessed by right-clicking
anywhere within the view. Options to add, edit or delete inputs are available. To open
the Inputs view, select [View] [Inputs] from the applications main menu.
Page 115 of 130

29.2 Processed Signals View
The processed signals view displays real-time updates of the computed and raw outputs
of the applications processed analog signals. The values shown in the view update at the
user defined acquisition rate.
Processed signal management functions can be accessed by right-clicking anywhere
within the view. Options to add, edit or delete processed signals are available. To open
the Processed Signals view, select [View] [Processed Signals] from the
applications main menu.
A red dot to the left of an entrys name is an indication that the entry requires
additional configuration information before it can produce a meaningful result.
The Display group: combo box allows the user to set a display group filter for the view.
By selecting all as the filter, all configured processed analog signals are displayed
regardless of their display group settings. Refer to the section titled Filtering a view by
display group for additional details.
Page 116 of 130

29.3 Total Volumes View
The Total Volumes view displays real-time updates of the computed total volume outputs
of the applications analog rates, pulse signals, flows and cumulatives. The values shown
in the view update at the user defined acquisition rate.
Configuration management functions can be accessed by right-clicking anywhere within
the view and options to add, edit or delete the various configurations objects are
available. An option to correct the total volume amount for a configuration object is also
provided when the user right-clicks on an individual view entry. To open the Total
Volumes view, select [View] [Total Volumes] from the applications main menu.
additional configuration information before it can produce a meaningful result.
The Flow type: and Display group: combo boxed allows the user to set filters for the
view. By selecting all as the filter for both the flow type and display group, all
configured total volume outputs are displayed regardless of their flow type or display
group settings. Both filters operate by the rules outlined in the section titled Filtering a
view by display group.
Page 117 of 130

29.4 Mass Balance View
The Mass Balance view allows the configuration and display of the several configuration
object outputs. The values shown in the view update at the user defined acquisition rate.
To open the Mass Balance view, select [View] [Mass Balance] from the
In order to set up the Mass Balance view, the user should double-click on the gray and
blue boxes in the view to bring up the Select Input for each entry. The blue boxes
represent tank volumes and only the total volume outputs of configuration objects will be
presented as valid data sources. The gray boxes represent instantaneous rates and only
rate outputs of configuration objects will be presented as valid data sources. The set of
configuration objects presented as valid data sources is further limited to those which
match the relevant flow type attribute as shown in the following table:
Mass Balance Quantity Flow Type

Net Gas Gas
Net Oil Oil
Net Water Water
Net Liquid Liquid
Supply Gas Gas
Injected Gas Gas
Injected Liquid Liquid
Injected Fluid Liquid
Page 118 of 130

Produced Gas Gas

Produced Oil Oil
Produced Water Water
Produced Solids Solids
Pipeline Gas Gas
Flared Gas Gas
Oil Tank Volume Oil
Water Tank Volume Water
Solids Tank Volume Solids
Pipeline Oil Oil
Recycled Liquid Liquid
Active Tank Volume Liquid
After selecting an input for a box, the value shown in that box will update once data
acquisition is started.
Page 119 of 130

29.5 UBA Calculation View

The UBA Calculations view displays real-time updates of the computed outputs of the
applications UBA calculations. The values shown in the view update at the user defined
acquisition rate.
Right-clicking on a UBA calculation entry in the list brings up a menu that provides the
option to edit the UBA calculations configuration information. To open the UBA
Calculations view, select [View] [UBA Calculations] from the applications main
menu.
additional configuration information. A yellow dot to the left of an entrys name is an
indication that the UBA calculation is properly configured but one of the configuration
objects that provide it with input data is not. Any issues that cause a red or yellow dot to
appear must be resolved before the UBA calculation can produce meaningful results.
Page 120 of 130

29.6 Productivity Index View

The Productivity Index view displays real-time updates of the values used in the
computation of the productivity index UBA calculations. The values shown in the view
update at the user defined acquisition rate.
To open the Productivity Index view, select [View] [Productivity Index] from the
The instantaneous production index entries are the computed outputs of each of the
productivity index UBA calculations.
The Current Reservoir Pressure and Shut-In Reservoir Pressure are gathered from the
inputs to the Productivity Index UBA calculations as show in the figure below:
Page 121 of 130

The Draw-down pressure is the Current Reservoir Pressure minus the Shut-in
Reservoir Pressure. Net Gas is QOutGas - QInGas as specified on the Instantaneous Gas
Production Index Properties dialog. Net Oil is QOutOil - QInOil as specified on the
Instantaneous Oil Production Index Properties dialog. Net Water is QOutWater - QInWater as
specified on the Instantaneous Water Production Index Properties dialog.
Page 122 of 130

29.7 Events View
The application logs events to INSITE. Events are logged as one of three different types:
critical, system, or information. Critical events are errors which may affect the basic
operation of the application. System events are messages that describe application state
changes or warning conditions. Information events are used to describe configuration
changes to the application such as the addition or deletion of configuration objects.
The Events view allows the user to review the event log for the active well. To open the
Events view, select [View] [Events] from the applications main menu.
This view is filterable by event type and run number.
29.8 User Comments View

Comments entered using the [Actions] [Add User Comment] dialogs may be
reviewed via the User Comments view. To open the User Comments view, select [View]
[User Comments] from the applications main menu.
Page 123 of 130

29.9 Choke Control View

The Choke Control view is a user interface that allows a user to examine the current state
of a choke and to control its operation. The inputs and outputs of this view are defined by
the views associated Choke Control Properties Form. A user must first configure the
view using the Choke Control Properties Form before this view will be able to provide
monitoring or control functionality.
Page 124 of 130

30 Layouts
With the Sentry application a user may arrange several views inside the main work
area. The layout feature of the application allows the user to save the arrangement of
these views so that the same arrangement can be quickly loaded the next time it is
desired.
To add a new layout, arrange the views in the main work area as desired and then perform
the following steps:
1. Select [Layout] [Save]
Save Current Layout dialog is displayed. Select Save as new layout
and enter a name for the layout you wish to save or select Replace existing
layout and click on the name of the layout you wish to replace.
2. Select _OK_ .
Page 125 of 130

To load a previously saved layout, select a layout from the [Layout] submenu as shown
in the diagram below. After selecting the layout, the views that were saved as part of the
layout will appear in the main work area.
Page 126 of 130

To delete a layout, perform the following steps:

1. Select [Layout] [Delete]
Save Current Layout dialog is displayed
2. Click on the name of a layout to delete or press CTRL-CLICK on multiple

names to delete more than one layout entry.
3. Select _OK_ to delete the layout(s).
Page 127 of 130

31 Troubleshooting
Issue: After launching the application, the following dialog box is displayed.
Answer: To prevent data integrity problems posed by two instances of the Sentry
potentially writing to the same INSITE outputs, only one instance of the application may
be launched. When this dialog is displayed then the Sentry application is already
running and the user should use the currently running instance.
Issue: Selecting the Start Logging operation from the Actions menu results in the
display of the following dialog box:
Answer: While the application may acquire data while INSITE is offline, a connection
to INSITE is required in order to log the Sentry calculations to the database. If the
dialog shown above is displayed, then the Sentry application is unable to establish a
connection with the INSITE application. Launch INSITE and try the operation again.
Page 128 of 130

Issue: Selecting the Add User Comment operation from the Actions menu results
in the display of the following dialog box:
Answer: Since user comments are logged to the INSITE database, a connection to
INSITE must be established before the application allows a user to enter a comment.
Launch INSITE and try the operation again.
Issue: After attempting to configure the input values for a cumulative or UBA
Calculation, the following dialog box is displayed:
Answer: The application has detected that one or more of the configured inputs
represents a circular reference. Circular referencing is not allowed among the
applications configuration objects. Refer to the Cumulatives section for additional
details regarding circular references. Click OK to dismiss this dialog and choose a
different source for the listed input.
Page 129 of 130

Issue: When attempting to add an OPC input to the configuration, the following dialog
box is displayed:
Answer: Before defining an OPC input, the OPC server that will supply the input must
be configured. To configure an OPC input, follow the directions listed the section titled
OPC Servers. After configuring the OPC server the user may add an OPC input.
Page 130 of 130

Sentry User Guide

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Sentry User Guide

Transféré par

Droits d'auteur :

Formats disponibles

Sentry Surface Monitoring System

Software User Guide

Software Version 2.0

Prepared for Halliburton Energy Services by ProtoLink, Inc.

Document Version 2.0

Manuals are company property and non-transferable to other employees, unless

Copyright 2007, Halliburton Energy Services, Inc. All Rights Reserved

Printed in the United States of America

21.4 Produced Gas Rate.............................................................................................96

The Sentry application is a Microsoft Windows-based data acquisition system that

directly from an OPC Data Access server

UBA Underbalanced application

4 The Main Form

4.1 Main menu bar

Configure Selecting this menu option displays a submenu of options that

4.1.1 File submenu

New This option creates a new Sentry configuration. New configurations

Exit When this option is selected, the application exits. It is functionally

4.1.2 Configure submenu

4.1.3 Actions submenu

4.1.4 Views submenu

4.1.5 Layout submenu

4.1.6 Help submenu

To open a previously saved configuration file from INSITE:

4. Select a configuration to load from the Configuration: section of the dialog.

5. Select _OK_ to load the configuration.

To import a configuration file from disk:

To export a configuration file to disk:

To configure an OPC server for use with the application:

7 OPC Server Properties

To configure an OPC server for use with the application:

9 OPC Input Properties

To configure an INSITE input for use with the application:

11 INSITE Input Properties

12 INSITE Item Address Properties

An INSITE dataset is a collection of variables; an INSITE item address represents a

To summarize, the following four items comprise an INSITE item address:

1. Select a record type.

13 Assigning INSITE and OPC Destinations

To assign a configuration objects output to a location within the INSITE database or to

In the Outputs section of the dialog:

2. Select the entrys configuration button labeled __.

14 Output Destination Properties

Each fluid property configuration contains the following details:

To add a fluid property to the configuration:

Each gas property configuration contains the following details:

To add a fluid property to the configuration:

To configure a special value:

3. Enter a descriptive name for special value.

The four types of signals supported by the application are:

18.1 Direct Analog Signals

To configure a direct analog signal:

4. Enter a descriptive name for the direct analog signal.

18.2 Processed Analog Signals

To configure a processed analog signal:

4. Enter a descriptive name for the processed analog signal.

18.3 Pulse Signals

To configure a pulse signal:

4. Enter a descriptive name for the pulse signal.

18.4 Analog Rates

To configure an analog rate:

4. Enter a descriptive name for the analog rate.

18.5 Signal Scaling

18.5.1 Linear Scaling