Appendix A. Calculator object attributes. Wonderware InBalance

Below you will find brief information for InBalance.

PDF Download

Document

Wonderware Finland InBalance Module 81

Appendix A. Calculator object attributes

The tables below contain the description of most important Calculator object attributes.

Note, that internal name for the Calculator object is MBDataRecon.

General attributes

Attribute

Calc.Duration

Calc.Iterations

Calc.LeastSquare

Calc.LsqAlgorithm

Calc.LsqMethod

Calc.Precision

Calc.Progress

Calc.RowCount

Calc.Solvable

Calc.Status

Calc.SwKey

Calc.TimeEnd

Calc.TimeStart

Calc.TotalMeasAccum

Calc.TotalMeasInput

Calc.TotalMeasOutput

Calc.TotalRecAccum

Calc.TotalRecInput

Calc.TotalRecOutput

Calc.Trigger

Cfg.DBName

Cfg.DBNode

Cfg.DBPassword

Cfg.DBUser

Data

Type

Access

Type

Description

Elapsed

Time

Calculated

Integer Calculated

Calculation time interval (Calc.TimeEnd -

Calc.TimeStart)

Number of iterations executed to found least squares

Double Calculated Minimum least squares value found

Integer Cfg Runtime Least squares method algorithm: 0

– searches minimum for streams separately; 1 (default)

– searches minimum for all streams

Integer Cfg Runtime Least squares method parameter: 0

– minimizes absolute difference between measured and reconciled data; 1 (default)

– minimizes relative difference between

Double Calculated

Integer Calculated measured and reconciled data

Double Cfg Runtime Least squares calculation precision (default -

0.0001)

Calculation progress (%)

Boolean Calculated

Total number of Historian values within defined time interval

Model solvability flag: True

– yes, False – no

(model is not solvable if non-measured values

String

Time

Calculated cannot be calculated)

Current status of reconciliation

Cfg Runtime Software license string

Runtime

Double Calculated

Calculation time interval end time

Calculation time interval start time

System total measured accumulated mass in kg (sum of measured mass in all Storage

Nodes)

Double Calculated

Double

Boolean

String

Calculated

Runtime

CFG

System total measured input (kg)

System total measured output (kg)

System total reconciled accumulated mass

(kg) (sum of reconciled mass in all Storage

Nodes)

System total reconciled input (kg)

System total reconciled output (kg)

Setting to True starts the calculation, setting to

False cancels the calculation; change back to

False indicates that the calculation process is complete.

Name of the internal MS SQL database

(contains the system model)

Computer node name where internal MS SQL database is located

User name for accessing internal MS SQL database

Password for accessing internal MS SQL

InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14

Wonderware Finland InBalance Module 82

database

Node attributes

Attribute

Node.InputMass

Node.InputStreams

Node.OutputMass

Node.OutputStreams

Node.Solvable

Node.TotalMeasInput

Node.TotalMeasOutput

Node.TotalRecInput

Node.TotalRecOutput

Data

Type

Access

Type

Double[] Calculated

String[] Calculated

Double[] Calculated

String[] Calculated

Boolean Calculated

Double Calculated

Description

Array of total mass (kg) for each input stream

Array of names of all input streams

Array of total mass (kg) for each output stream

Array of names of all output streams

Node solvability flag (indicates possibility of finding values for all connected streams) (True

– yes, False –no)

Node total measured input mass (kg)

Node total measured output mass (kg)

Node total reconciled input mass (kg)

Node total reconciled output mass (kg)

The following additional attributes are created for

Storage Nodes

only:

Attribute

Node.Meas.BadValueCount

Node.Meas.Category

Node.Meas.ConfidenceInterval

Node.Meas.Density

Node.Meas.Failed

Node.Meas.GoodValueCount

Node.Meas.GrossError

Node.Meas.ManulValue

Node.Meas.MeasType

Node.Meas.MeasuredMass

Node.Meas.ReconError

Node.Meas.ReconMass

Data

Type

Access

Type

Integer Calculated

Description

String

Double

Integer

Boolean

Integer

Boolean

Calculated

User R/W

Runtime

Calculated

Number of Historian values with bad quality or out of range (within defined time interval)

Storage node category

(e.g. “measured”)

Confidence interval for measured accumulation (= Node.Meas.ReconMass *

Node.Meas.ReconError)

Density (kg/m3) is required for mass calculation that is used in reconciliation calculation in case measurement data is not mass (kg).

Calculation failure flag. Indicates impossibility to calculate non-measured accumulation (True

– yes (impossible) , False –no (possible))

Number of good measured values, stored in

Historian, within defined time interval

Gross error flag for storage node: True

– yes;

False

– no

Double Cfg Runtime User can set Manual entered value at runtime for calculation.

Integer Cfg Runtime User can set Measurement type (0 - fixed, 1 - measured, 2

– non-measured) at runtime for calculation.

Double Cfg Runtime Measured total accumulation (kg) for defined

Double Calculated

Double Calculated time interval (= Node.Meas.EndValue -

Node.Meas.StartValue)

Reconciliation error for this storage node (%)

Reconciled accumulation for defined time interval (kg)

The following additional attributes are created for

Pipeline Nodes

only:

Attribute Description

Node.Leakage.Location

Node.Leakage.Pressure

Data

Type

Access

Type

Double Calculated

Gas pipeline leak location (km).

Gas pipeline pressure at leak location.

InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14

Wonderware Finland InBalance Module

Node.Leakage.Volume Double Calculated

Stream attributes

Attribute

Stream.Meas.BadValueCount

Stream.Meas.Category

Stream.Meas.ConfidenceInterval

Stream.Meas.Density

Stream.Meas.Failed

Stream.Meas.GoodValueCount

Stream.Meas.GrossError

Stream.Meas.ManualValue

Stream.Meas.MeasType

Stream.Meas.MeasuredMass

Stream.Meas.ReconError

Stream.Meas.ReconMass

Stream.NodeFrom

Stream.NodeTo

Stream.ReconFlow

Stream.ReconFlowConfInt

Gas pipeline leak volume.

Data

Type

Access

Type

Integer Calculated

Description

String

Double

Calculated

Number of Historian values with bad quality or out of range (within defined time interval)

S tream category (e.g. “measured/calculated”)

Confidence interval for measured total mass passed through stream within defined time interval

Integer User R/W

Runtime

Density (kg/m3) is required for mass calculation that is used in reconciliation calculation in case measurement data is not mass (kg).

Boolean Calculated Calculation failure flag. Indicates impossibility to calculate non-measured value (True

– yes

(impossible) , False

–no (possible))

Integer Calculated Number of good measured values stored in

Historian within defined time interval

Boolean Calculated Gross error flag for this stream: True

– yes;

False

– no

Double Cfg Runtime User can set Manual entered value at runtime for calculation.

Integer Cfg Runtime User can set Measurement type (0 - fixed, 1 - measured, 2

– non-measured) at runtime for calculation.

Double Cfg Runtime Measured total mass passed through stream within defined time interval (kg)

Double Calculated

String Calculated

Reconciliation error for this stream (%)

Reconciled total mass passed through stream within defined time interval (kg)

Name of source node (or empty string, if source is

“environment” node)

String Calculated

Double

Calculated

Name of destination node (or empty string, if destination is “environment” node)

Calculated reconciled flow (kg/s) (=

Stream.ReconMass / defined time interval)

Confidence interval for reconciled flow (=

Stream.ReconFlow *

Stream.Meas.ReconError)

InBalance Ver 1.x User Manual Rev 1.4 PR0016xm14

Key Features

Data validation/reconciliation
Mass balance calculation
Integration with Wonderware System Platform
Model Editor for creating system models
Calculator for data validation and mass balance calculation
Data reconciliation using least squares method
Mass balance checking for leakage detection
Accessible results as Calculator object attributes
Model import/export from/to XML file
Historian data integration for measured data

Frequently Answers and Questions

What is InBalance?

InBalance is a module that provides a solution for mass balance calculation, including data validation/reconciliation. It is integrated into Wonderware System Platform, allowing easy integration into existing and new projects.

What are the main components of InBalance?

InBalance consists of two main submodules: Model Editor and Calculator. The Model Editor is used to create a system model consisting of nodes and streams. The Calculator performs data validation/reconciliation and mass balance calculation.

What are the benefits of using InBalance?

InBalance offers several advantages over traditional dedicated systems, including reliable and proven solution, easy implementation, wide application scope, easy integration, low investment cost, and easy maintenance and upgrades.