Create a Performance

Equation Tag
All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 1

1.1

Create a Performance Equation Tag

1.1.1

Description

Learn to use PI SMT (System Manager Tools) 3 to easily create a performance equation tag.
1.1.2

Objectives

Describe the PI Performance Equation Scheduler configuration.

Learn how to create PI Performance Equation Tags.

1.1.3

Problem description

After a production meeting, it has been decided to manipulate raw data coming from
measurement instruments through calculation. The results will be stored on the PI server, so
the same results will be available to everyone. As you are the PI expert, you have been
assigned the responsibility to create the calculations on the PI server.
1.1.4

Approach

There are four raw data tags that must be manipulated. They are listed below.
Tag name

Description

Eng. units

Type

CDT158

Batch reactor temperature

Degree Celsius

Float32

CDM158

Reactor mode

State

Digital state

CDEP158

Mass of ethylene produced

Kg

Int32

BA:PHASE.1

Batch process phase

State

Float32

The CDT158 tag must be calculated to show an average of the value every 5 minutes. The
BA:PHASE.1 and CDM158 must be combined to show their value concatenated. Finally, the
CDEP158 and CDT158 tags must be used to calculate volume of ethylene produced every
hour.
To achieve your goal you will create 3 tags which will contain the results of these
calculations. Create these tags following the parameters given in the tables below.
SMT Tab

SMT Field Name

Value

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 2

(PI Tag Attribute)

General

Name

CDT158.avg

Tag

General

Descriptor

Average of CDT158 over 2 minutes period

Descriptor

General

Eng Units

Degree Celsius

Engunits

General

Point type

Float32

Pointtype

General

Point source

Pointsource

Equation

Equation

tagavg('CDT158', '*-2m', '*')

ExDesc

Scheduling

Scan class

2 [for a 2 minute frequency scan class]

Location4

Archive

Zero

Zero

Archive

Span

150

Span

Archive

Typical value

50

Typicalvalue

Archive

Compressing

On (1)

Compressing

Archive

Exception Deviation

Excdev

Archive

Compression Deviation

Compdev

SMT Tab

SMT Field Name

Value

(PI Tag Attribute)

General

Name

BA:STATUS.1

Tag

General

Descriptor

Status of the batch reactor

Descriptor

General

Point type

String

Pointtype

General

Point source

Pointsource

Equation

Equation

concat(digtext('CDM158'), text("
"), 'BA:PHASE.1')

No equivalent
this is done in
ExDesc

Scheduling

Event tag

BA:PHASE.1

No equivalent
this is done in
ExDesc.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 3

Scheduling

Set timestamp of resulting

expression to:

The time when the expression is evaluated

Location3

SMT Tab

SMT Field Name

Value

(PI Tag Attribute)

General

Name

BA:Ethylene_Volume

Tag

General

Descriptor

Volume of ethylene produced by minute

Descriptor

General

Eng Units

m3

Engunits

General

Point type

Float32

Pointtype

General

Point source

Pointsource

Equation

Equation

'CDEP158' * 8.314472 * ('CDT158'

+ 273.15) /
(28.05 * 200)

ExDesc

Scheduling

Scan class

1 [for a 1 minute frequency scan class]

Location4

Archive

Zero

Zero

Archive

Span

300

Span

Archive

Typical value

50

Typicalvalue

Archive

Exception Deviation

0.1

Excdev

Archive

Compression Deviation

0.2

Compdev

*Equation: this equation is based on the Ideal Gas Law equation defined by PV = mRT/M where P is the pressure, V the
volume, m is the mass of product, R is the ideal gas constant, T the temperature and M the molecular weight of the
product. Temperature in Kelvin is obtained by adding 273.15 to the read value in Celsius.

Also, the PI performance Equation Scheduler startup file will be inspected at the start to
determine which scan classes to use for the 2 minute and 1 minute frequency required by the
exercise.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 4

Try to do this exercise on your own before proceeding to the Step-by-Step

Instructions.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 5

1.1.5

Step-by-Step Instructions

1.

Go to the \PI\bin\ directory. Right-click on the pipeschd.bat file and select edit.

2.

Look for the following scan class (frequency of execution for calculation):

/f=00:01:00,00:00:00
/f=00:02:00,00:00:00
/f=00:00:30,00:00:00

The .bat file should look like this:

The first frequency is the first item in the list, so /f=00:01:00,00:00:00; the second frequency
is the second item, so /f=00:02:00,00:00:00; the third one is the third item, so
/f=00:00:30,00:00:00.
3.

This first step is just to verify that the scan classes described below in fact exist. You do not need to
make any changes. Close the file

4.

Open the PI System Management Tools

5.

Connect to the appropriate PI Server by clicking on its check box on the Collectives and Servers
pane (PI-SERVER)

6.

Click on the Points section and then on the Performance Equations

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 6

1.
7.

Fill in the information in the form as shown below for the tag with the following attributes. The
Exdesc attribute is filled automatically with the use of Equation and Scheduling tab. The selection of
scan class for execution if there is one is done with the Scheduling tab. The equation and the
triggering tag are set with the Equation tab.
2.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 7

SMT Tab

SMT Field Name

Value

(PI Tag Attribute)

General

Name

CDT158.avg

Tag

General

Descriptor

Average of CDT158 over 2 minutes period

Descriptor

General

Eng Units

Degree Celsius

Engunits

General

Point type

Float32

Pointtype

General

Point source

Pointsource

Equation

Equation

tagavg('CDT158', '*-2m', '*')

ExDesc

Scheduling

Scan class

2 [for a 2 minute frequency scan class]

Location4

Archive

Zero

Zero

Archive

Span

150

Span

Archive

Typical value

50

Typicalvalue

Archive

Compressing

On (1)

Compressing

Archive

Exception Deviation

Excdev

Archive

Compression Deviation

Compdev

3.
8.

Click on the Save button to save this PI point.

SMT Tab

SMT Field Name

Value

(PI Tag Attribute)

General

Name

BA:STATUS.1

Tag

General

Descriptor

Status of the batch reactor

Descriptor

General

Point type

String

Pointtype

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 8

General

Point source

Pointsource

Equation

Equation

concat(digtext('CDM158'), text("
"), 'BA:PHASE.1')

No equivalent
this is done in
ExDesc

Scheduling

Event tag

BA:PHASE.1

No equivalent
this is done in
ExDesc.

Scheduling

Set timestamp of resulting

expression to:

The time when the expression is evaluated

Location3

4.
9.

Click on the Save button to save this PI point.

SMT Tab

SMT Field Name

Value

(PI Tag Attribute)

General

Name

BA:Ethylene_Volume

Tag

General

Descriptor

Volume of ethylene produced by minute

Descriptor

General

Eng Units

m3

Engunits

General

Point type

Float32

Pointtype

General

Point source

Pointsource

Equation

Equation

'CDEP158158' * 8.314472 *
('CDT158' + 273.15) /
(28.05 * 200)

ExDesc

Scheduling

Scan class

1 [for a 1 minute frequency scan class]

Location4

Archive

Zero

Zero

Archive

Span

300

Span

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 9

Archive

Typical value

50

Typicalvalue

Archive

Exception Deviation

0.1

Excdev

Archive

Compression Deviation

0.2

Compdev

*Equation: this equation is based on the Ideal Gas Law equation defined as PV = mRT/M where P is the pressure, V the
volume, m is the mass of product, R is the ideal gas constant, T the temperature and M the molecular weight of the
product.

5.
10. Click on the Save button to save this PI point.
11. Click on the Data section and then on the Archive Editor to visualize the results of the calculation
being processed. It may take up to 2 minutes before the interface detect the new points added.

12. Click on the Tag Search button to retrieve the created tag.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 10

6.

13. Fill in the tag mask with the tag name created and click on the Search button.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 11

14. When the tag is found, click on the Ok button to add the tag to the list to get the archived values.
15. Repeat the step 10 to 13 for the two other tags.

Executive Overview:

In executive overview you can see the completed solution by searching for the tags created in this lab
under the name Solution_ CDT158.avg, Solution_ BA:STATUS.1 and Solution_ BA:Ethylene_Volume. You
can review their configuration and search for archive values in SMT.

All rights reserved. No part of this publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means, mechanical, photocopying,
recording, or otherwise, without the prior written permission of OSIsoft, LLC.
Copyright 1995-2009 OSIsoft, LLC, 777 Davis St., Suite 250, San Leandro, CA 94577

Page 12