U0 8801

WEScalc Calculation Builder Users Guide
Section Title Page
Section 1. Introduction
1-1. 1-2. 1-3. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Contents of this Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Reference Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Section 2. Initialization
2-1. 2-2. 2-3. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operational Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Start-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3.1. Start-up from Operator WEStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3.2. Start-up from Engineering WEStation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3.3. Start-up from a Command Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . System Security and Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 2-2 2-3 2-3 2-3 2-3 2-5
2-4.
Section 3. Calculation Builder Subsystem Overview

3-1. 3-2. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Design Philosophy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 3-2.1. Calculation Builder Subsystem Main Module. . . . . . . . . . . . . . . . . . . . . . . 3-3 3-2.2. Calculation Builder Subsystem Properties Module . . . . . . . . . . . . . . . . . . . 3-5 Data Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8 3-3.1. Permanent Sets versus Working Sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8 Modes of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 3-4.1. Off-line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 3-4.2. On-line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Quality of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
3-3. 3-4.
3-5.
Section 4. Using the Main Module Menus

4-1. 4-2. 4-3. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 Accessing the Main Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Using the File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 4-3.1. Loading a Permanent Calculation Set as a Working Set . . . . . . . . . . . . . . . 4-5 4-3.2. Saving a Working Calculation Set as Permanent Sets. . . . . . . . . . . . . . . . 4-11 4-3.3. Clearing the Existing Working Set Data . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13 4-3.4. Deleting a Permanent/Working Calculation Set . . . . . . . . . . . . . . . . . . . . 4-14 Using the View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15 4-4.1. Filtering/Sorting Items of Calculation Set Lists . . . . . . . . . . . . . . . . . . . . 4-17 4-4.2. Locating Entries in the Scrolling Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18 4-4.3. Clearing Current Entries in the Scrolling List . . . . . . . . . . . . . . . . . . . . . . 4-20
i
Westinghouse Proprietary Class 2C
4-4.
9/98
U0-8801
Table of Contents, Contd

Section Title Page
Section 4. Using the Main Module Menus, Contd

4-5. 4-6. Using the Properties Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Calculate Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6.1. Performing Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6.2. Loading Inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6.3. Updating Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6.4. Displaying Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Report Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21 4-23 4-24 4-25 4-27 4-27 4-29
4-7.
Section 5. Using the Properties Module Menus

5-1. 5-2. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Accessing the Properties Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 5-2.1. Accessing the Properties Module Using the Properties Menu. . . . . . . . . . . 5-2 5-2.2. Accessing the Properties Module Using the Scrolling Lists . . . . . . . . . . . . 5-3 Editor Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5 5-3.1. Calculated Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5 5-3.2. Input Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7 5-3.3. Output Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 5-3.4. Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10 5-3.5. Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 5-3.6. Conditional Evaluation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12 Using the View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14 5-4.1. Using the Filter/Sort Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16 5-4.2. Using the Locate Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21 5-4.3. Using the Clear List Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21 Using the Insert Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22 Using the Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23 5-6.1. Undoing an Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23 5-6.2. Copying an Item from a Scrolling List . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23 5-6.3. Inserting an Item into a Scrolling List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24 5-6.4. Deleting an Item From a Scrolling List . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24 Using the Print Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25 5-7.1. Selecting Print Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
5-3.
5-4.
5-5. 5-6.
5-7.
U0-8801
ii
9/98

Section Title Page
Section 6. CBS Applications

6-1. 6-2. Section Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 Creating a Calculation Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 6-2.1. Copying an Existing Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 6-2.2. Creating a New Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3 Defining Calculation Set Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5 6-3.1. Defining Calculation Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6 6-3.2. Defining Inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7 6-3.3. Defining Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8 6-3.4. Defining Numerical Constants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 6-3.5. Defining Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 6-3.6. Defining Conditional Evaluation Expressions. . . . . . . . . . . . . . . . . . . . . . 6-10 Viewing a Calculation Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11 Executing a Set in the Off-line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12 Scheduling a Set for On-line Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13 6-6.1. Changing the Execution Mode to On-line . . . . . . . . . . . . . . . . . . . . . . . . . 6-13 6-6.2. Stopping an On-line Set from Executing . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15 6-6.3. Changing the Execution Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15 Printing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16 6-7.1. Printing Reports from the Main Module . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16 6-7.2. Printing Reports from the Properties Module . . . . . . . . . . . . . . . . . . . . . . 6-16
6-3.
6-4. 6-5. 6-6.
6-7.
Appendix A. Supplied Numerical Library Functions

A-1. A-2. A-3. A-4. A-5. A-6. A-7. A-8. A-9. A-10. A-11. A-12. A-13. A-14. A-15. A-16. A-17. Appendix Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1 HCLSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1 HCLTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2 HISTPP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2 HSLP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3 HSLT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4 HSSTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4 HSVP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5 HSWSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5 PSLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6 SCLHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7 SCLTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7 SSLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8 SSLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8 SSSTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9 SSVP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10 SSWHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
9/98
iii
U0-8801

Section Title Page
Appendix A. Supplied Numerical Library Functions, Contd

A-18. A-19. A-20. A-21. A-22. A-23. A-24. A-25. A-26. A-27. A-28. A-29. A-30. A-31. A-32. A-33. A-34. A-35. A-36. A-37. A-38. A-39. A-40. A-41. A-42. A-43. A-44. TCLHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TCLSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TSLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TSWHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TSWSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VCLTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VSLT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VSSTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VSVP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VSWHP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VSWSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . XSWHP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . XSWSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HICTPP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIBNSRCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GOLDSRCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INTRPAXS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . KAVL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . REGFALS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ENTHAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALC_AVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WBDENSVOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WBENTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HUMID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RELHUMID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RELHMDEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WETBLB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11 A-12 A-12 A-13 A-13 A-14 A-15 A-15 A-16 A-16 A-17 A-18 A-18 A-19 A-19 A-20 A-21 A-22 A-23 A-23 A-25 A-25 A-26 A-27 A-27 A-28 A-29
Glossary Index
U0-8801
iv
9/98

List of Figures
Figure Title Page

3-1. 3-2. 3-3. Calculation Builder Subsystem (CBS) Main Window . . . . . . . . . . . . . . . . . . . . . . 3-3 Properties Editor - Output Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6 Quality Override Check Box (for Calculated Variables Option). . . . . . . . . . . . . . 3-14

4-1. 4-2. 4-3. 4-4. 4-5. 4-6. 4-7. 4-8. 4-9. 4-10. 4-11. 4-12. 4-13. 4-14. 4-15. File Menu Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 File Menu Window (Load Options). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Example of Calculation List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 Example of Window with Loaded Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8 Filter/Sort Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10 File Menu WIndow (Save As) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12 View Menu Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15 View Menu Window (showing available options list) . . . . . . . . . . . . . . . . . . . . . 4-16 Filter/Sort Window (Input Variables) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17 Locate Window (Input Variables) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19 Properties Menu Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22 Calculate Menu Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24 Calculate Menu Window (Load Inputs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26 Display Errors Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28 Report Window (Report List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29

5-1. 5-2. 5-3. 5-4. 5-5. 5-6. 5-7. 5-8. 5-9. 5-10. 5-11. 5-12. 5-13. Accessing the Properties Module Using the Scrolling Lists . . . . . . . . . . . . . . . . . . 5-3 Properties Module Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 Calculated Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6 Input Variables Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8 Output Variables Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 Constants Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10 Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11 Conditional Evaluation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 View Menu Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15 Filter/Sort Window (Calculated Variables) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16 Filter/Sort Window (Input Variables) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17 Filter/Sort Window (Output Variables) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18 Filter/Sort Window (Constants). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
9/98
v
U0-8801

List of Figures, Contd
Figure Title Page
Section 5. Using the Properties Module Menus, Contd

5-14. Filter/Sort Window (Comments) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20 5-15. Print Menu Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26 5-16. Print Menu Window (Options) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27

6-1. 6-2. Input Variables Window (for Defining Calculation Expression) . . . . . . . . . . . . . . 6-7 CBS Main Window (On-line Execution). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14
U0-8801
vi
9/98

List of Tables
Table Title Page
1-1. Reference Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
2-1. Start-up Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

3-1. 3-2. Main Module Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 Properties Module Editor Menu Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7

6-1. Naming Conventions for Calculation Set Properties . . . . . . . . . . . . . . . . . . . . . . . . 6-5
9/98
vii
U0-8801
1-1. Overview
The Calculation Builder Subsystem (CBS) of the Relational Database Management System (RDBMS) allows the user to perform very complex calculations on an Engineering/Operator WEStation in a user-friendly environment. A WEStation equipped with the Calculation Builder software (referred to as WEScalc) enables the user to perform system calculations outside of the DPU environment, on any system point and stored variable. The functions of the CBS are as follows:
Provides user friendly Graphical User Interface to create and modify equations on-line. Allows user to include calls to supplied functions (such as, steam table functions) in equations. Does not require user to compile and link equations. Does not require source code modications. Ability to run concurrently with other WEStation software. Provides sophisticated report generation.
The calculations created in the CBS are named and stored in sets. A calculation set consists of:
Calculated variables derived from user-dened calculations. Set execution conditional statement. User-dened constants used in the calculations. User-dened WDPF inputs used in the calculations. User-dened WDPF points that broadcast the calculation results onto the WDPF system. User-dened comments. On-line scheduling properties.
9/98
1-1
U0-8801
1-2. Contents of this Document

Section 1. Introduction denes the purpose of the Calculation Builder Subsystem (CBS) Database Management System (RDMS) and describes the content and organization of this manual. Section 2. Initialization discusses start-up procedures and security issues. Section 3. Calculation Builder Subsystem Overview provides an overview of the structure and operation of the program. Section 4. Using the Main Module Menus describes the Main module and its functions. Section 5. Using the Properties Module Menus describes the Properties module, its functions, and the six editors of the Properties module. Section 6. CBS Applications describes the general operations of the CBS. Appendix A. Supplied Numerical Library Functions lists the numerical functions.
U0-8801
1-2
9/98
1-3. Reference Documents

Table 1-1 lists additional reference documentation that may be helpful while using this document.
Table 1-1. Reference Documents
Document Number U0-8100 U0-8110 U0-8200 U0-8500
Title Operator WEStation Users Guide Operator WEStation Configuration Manual Engineering WEStation Users Guide WEStation Historian (HSR) Users Guide PL/SQL Users Guide and Reference Oracle SQL*Connect Users Guide Oracle 7 Server Concepts Manual
Description Discusses the operations and functions of the Operator WEStation. Discusses menu set-up and describes the procedure for configuring menu windows. Discusses the operations and functions of the Engineering WEStation. Discusses the operation and functions of the WEStation Historian (HSR). Describes SQL (Structured Query Language) syntax. Provides a description of the remote database processing function. Discusses the Oracle database instance concept.
Westinghouse documents are designated by a U0 number. In addition to the documents listed in Table 1-1, this manual may refer to applicable vendor documentation, which is dened on a project basis. These documents may include:
Operating system (UNIX/Solaris) manuals. Window manager (OpenWindows) documentation. Workstation hardware (Sun) documentation. Peripheral device documentation.
Man pages (standard UNIX on-line documentation) are also available for operating system functions and certain WDPF functions.
9/98
1-3
U0-8801
2-1. Section Overview
This section will address the following topics:
Operational requirements (Section 2-2). Start-up and start-up options (Section 2-3). System security and restrictions (Section 2-4).
9/98
2-1
U0-8801
2-2. Operational Requirements
2-2. Operational Requirements

The hardware and software requirements for the Calculation Builder Subsystem (CBS) are as follows:
Operator WEStation using the Solaris 2.3 (or later) Operating System. Engineering WEStation using the Solaris 2.3 (or later) Operating System. Oracle Version 7 software.
U0-8801
2-2
9/98
2-3. Start-up
2-3. Start-up
The CBS can be started from either of the following:
An Operator WEStation (Section 2-3.1). An Engineering WEStation (Section 2-3.2) A command tool (Section 2-3.3)
When started from a command tool, command line options may be used for program customization (see Section 2-3.3 for details on command line options). (Additionally, the Operator WEStation Conguration Manual (U0-8110) describes the procedure for conguring menu windows and customizing menus.)
2-3.1. Start-up from Operator WEStation

The Calculation Builder Subsystem (CBS) can be started from the Data Analysis and Maintenance Menu of an Operator WEStation. Refer to Operator WEStation Users Guide (U0-8100) for additional information on the Operator WEStation.
2-3.2. Start-up from Engineering WEStation

The Calculation Builder Subsystem (CBS) can be started from the Data Analysis and Maintenance Menu or the SDS Menu of an Engineering WEStation. Refer to Engineering WEStation Users Guide (U0-8200) for additional information on the Engineering WEStation.
2-3.3. Start-up from a Command Tool

The CBS can be started from a command tool using start-up options. The CBS is located in the $WDPF_HOME/rdbms/bin directory. To access the CBS, change directories by typing the following at the command tools prompt ($):
cd $WDPF_HOME/rdbms/bin
To start-up the CBS, type the following at the prompt ($):

calc -u wdpf -p wdpf -a wdpf
9/98
2-3
U0-8801
2-3. Start-up
Start-up Options Command line options allow the user to include information for customizing programs. Additional parameters and options may be added to the command line to customize functions such as character font style selection, debug option. Refer to Table 2-1 for a list and description of available parameters.
Table 2-1. Start-up Options
Parameter -u -p -a wdpf wdpf wdpf
Options
Description user name password Oracle database instance (Refer to Oracle 7 Server Concepts manual for information regarding database instance.) font
Function Refers to Oracle user name Refers to Oracle user password Denes the Oracle database accessed.
-fn
Any valid font style
Species character font style.
U0-8801
2-4
9/98
2-4. System Security and Restrictions
2-4. System Security and Restrictions

The UNIX and Oracle RDBMS user login functions determine the access capabilities for each user. A separate Oracle login is required for access to the CBS. A calculation set is dened by the following:
Set name Owner
For instance, two different users may have each created a calculation set (each with its own data) and saved the sets under the same name. Thus, there are two different sets that have the same name. This is possible since the owner of the sets is different. All created sets have read-only access to other users. The owner of the calculation set is the only one who is able to modify the set. Other users may open the set for viewing and copy the set. The user(s) can then modify the copy of the calculation set, if required.
9/98
2-5
U0-8801

This section explains the program structure of the Calculation Builder Subsystem. The following topics are covered:
Design philosophy (Section 3-2). Data storage (Section 3-3). Modes of operation (Section 3-4). Quality of results (Section 3-5).
9/98
3-1
U0-8801
3-2. Design Philosophy

For easier use, the CBS is broken up into two modules:
Main module Properties module
The Main module of the CBS is designed to manipulate entire sets. The Properties module is a group of editors that allow the user to modify individual aspects (such as input and output variables, comments and constants.) of a calculation set. (The individual editors of the Properties module are discussed further in Section 5.) Although each editor works with data that has its own specic format, the editors are designed with the same interface and functionality. Thus, the user needs to learn only one interface, making the overall program operation much easier to learn.
U0-8801
3-2
9/98
3-2.1. Calculation Builder Subsystem Main Module

When the CBS is started, the main window of the Calculation Builder Subsystem is displayed (Figure 3-1).
Figure 3-1. Calculation Builder Subsystem (CBS) Main Window
The main window is referred to as the Main module. It contains the following:
Five menu buttons Execution information and general information about the calculation set (in the top of the main window) Four scroll lists (in the bottom half of the main window) list the individual components that make up the calculation set.
From the Main module, the Properties modules can be accessed.
9/98
3-3
U0-8801
All commands are invoked from the menus associated with the buttons running across the top of the window. Any command that is grayed-out is unavailable at that particular moment. Table 3-1 lists the various menu options of the Main module.
Table 3-1. Main Module Menu Options
Button File
Options
Description The File button is used to load, save, and delete existing calculation sets and to enter new calculation sets.
Load (which offers 2 options): List Filter/Sort Save Save As New Delete
View
Filter/Sort Locate Clear List
The View button is used to modify components displayed in the scroll list.
Each of these menus offers 4 options: Calculated Variable Input Variables Output Variables Constants Properties
Calculate
Report
Calculated Variables Input Variables Output Variables Constants Comments Conditional Evaluation Execute Set Load Inputs Update Outputs Display Errors List Options
The Properties button allows the user to inspect and modify the components of the current calculation set.
The Calculate button allows the user to perform calculations and provides access to calculation functions. The Report button is used to print calculation sets.
U0-8801
3-4
9/98
3-2.2. Calculation Builder Subsystem Properties Module

The Properties module contains six editors (see Section 5 for further information regarding the six editors and their functions). These editors are invoked from the Properties button of the CBS Main module. The six editors are the following:
Calculated Variables Input Variables Output Variables Constants Comments Conditional Evaluation
The base window of each editor is divided in half. The top half is devoted to the common menu and a scroll list. The bottom half is devoted to entry of specic data. The Output Variables editor of the Properties Module (Figure 3-2) is shown as an example.
9/98
3-5
U0-8801
Figure 3-2. Properties Editor - Output Variables
U0-8801
3-6
9/98
All editor commands are invoked from the menus associated with the buttons running across the top of the Properties editor window. Table 3-2 lists the various menu options of each editor in the Properties module.
Table 3-2. Properties Module Editor Menu Options
Button View
Options
Description The View button is used to modify components displayed in the scroll list. The Insert button is used to add a new item to the scroll list.
Insert
Edit
Print
Filter/Sort Locate Clear List Before After Top Bottom Undo Copy Paste Delete Selected List Options
The Edit button is used to provide short-cuts when editing an item.
The Print button displays the Print menu.
9/98
3-7
U0-8801
3-3. Data Storage
3-3. Data Storage

The calculations created in the CBS are grouped, named, and stored in sets. The term set is synonymous with le. Similarly, the user can maintain a private collection of calculation sets and also view those sets of other users that have read privileges. (Refer to Section 2 for further information regarding public access of sets.) The calculation sets are stored in the Relational Database Management System (RDBMS).
3-3.1. Permanent Sets versus Working Sets

Calculation sets exist as either permanent sets or as working sets. Working sets are temporary sets that have not yet been saved as permanent sets. They are used in the off-line mode (see Section 3-4.1 for an explanation of the offline mode) to initially create a set and to modify and test data. Permanent sets are working sets that have been saved and are retained in the database. They are used in either the on-line or off-line mode. Working Sets Working sets are used for the following:
Initially creating a calculation set. Modifying an existing permanent set. Executing the set off-line with different input values.
The scope of working sets is temporary. They exist only while the user who created the set has the set loaded. Working sets are deleted when the user who created the set does either of the following:
Quits the Calculation Builder the session for the application. Loads another working set.
U0-8801
3-8
9/98
3-3. Data Storage
Permanent Sets Permanent sets can be viewed, modied, or copied. However, only the owner of a set may modify it. Other users may view or copy the set. Permanent sets are identied by the following:
Name Description Owner Execution mode (off-line or on-line)
Permanent sets are retained in the database until manually deleted. To delete a set, load the set as a working set. Select the Delete option of the File menu from the Main module. (Refer to Section 4 for information on the Delete option of the File menu.) Saving a Set as a Permanent Set A working set can be saved as a permanent set at any time by performing the following: 1. Create a working set. 2. Select the File menu on the Main module (refer to Section 4 for information on the File menu). 3. Select either the Save or Save As option from the File menu.
9/98
3-9
U0-8801
3-4. Modes of Operation

There is an execution mode associated with each calculation set. There are two modes of operation of the CBS: the off-line mode and the on-line mode. (The offline mode involves a user interface; whereas the on-line mode does not involve a user interface.) The off-line mode is used for development, and testing of sets. Once a set has been fully developed and tested, it can be placed in the on-line mode. The execution mode of a working set is always off-line; permanent sets may be executed in either on-line or off-line mode. (For additional information regarding working sets and permanent sets, refer to Section 3-3.1).
3-4.1. Off-line Mode

Data entered in the off-line mode does not have system-wide availability until the calculation set is placed in the on-line mode. Thus, calculations executed in the offline mode do not affect calculations running on-line. The off-line mode provides the following functions:
Access to historical data. Modication capabilities. Debugging capabilities. For further debugging in the off-line mode, there is an option to update output points on the highway. This allows graphics or other users of the output points to access current data.
Sets are typically run in the off-line mode while being developed and during testing. Calculation sets in the off-line mode involve the following:
Use historical WDPF data or user-specied values for inputs. Run only when invoked by a user. Display the values of the outputs. Do not broadcast their values on the WDPF Highway.
U0-8801
3-10
9/98
3-4.2. On-line Mode

In the on-line mode, a set is executed automatically in real time at periodic intervals scheduled by the user, using actual WDPF data. Sets are placed in the on-line mode after being fully developed and tested. The on-line mode provides access to the WDPF Highway. Calculation sets in the on-line mode involve the following:
Obtain their inputs from the WDPF Highway. Run without user intervention at predetermined scheduling intervals. Broadcast their outputs on the WDPF Highway.
When a set is placed on-line, it automatically begins execution at a user-supplied frequency. On-line sets retain the execution mode after rebooting and drop failures. They continue to run automatically when a failed drop has been restored to operation. On-line sets will continue to run until the owner changes its execution mode to offline. Placing a Set in the On-line Mode Once a set is fully debugged in the off-line mode, then the user can schedule a set to run on-line, using live WDPF data. To place a calculation set in the on-line mode, the user must perform a save with online scheduling dened for the set. (Refer to Section 6.)
9/98
3-11
U0-8801
3-5. Quality of Results

Each calculated variable has an associated quality variable that represents the quality (bad, poor, fair, and good) of the result. Quality variables are created automatically by the CBS for each user dened calculated variable. Quality variables have the same name as the associated calculated variable, but they are prexed with QC$. For example, the calculated variable C$HMNSTM has an associated quality variable QC$HMNSTM. The quality of a calculated variable can be generated automatically or manually. If the Propagate Quality box on the main window is checked (as shown below), quality statements are generated automatically by the CBS whenever a calculated variable is created or modied.
U0-8801
3-12
9/98
The quality of the calculated variable is assigned the worst quality of all the input variables referenced in the formula eld. These quality statements are not shown in the formula eld. If the Propagate Quality check box on the main window is not checked, the user must create quality statements manually for each calculated variable within the formula eld. This option must be chosen when specic quality statements are required. By default, the Propagate Quality check box is checked for each calculation set. The Quality override option allows the user to do the following:
Selectively override automatic quality generation for specied calculated variables. Manually generate quality statements for the selected variable(s).
Using this option, the user can have automatic quality generation for most of the calculated variables and have manually-generated quality for those calculated variables which require it. The Quality override option is available in the Calculated Variable editor of the Properties module (see Figure 3-3). Refer to Section 5 for additional information on the editors of the Properties module.
9/98
3-13
U0-8801
Figure 3-3. Quality Override Check Box (for Calculated Variables Option)
U0-8801
3-14
9/98

This section explains how the Calculation Builder Subsystem (CBS) Main module works and describes the various menu options associated with the module. For information on specic applications of the CBS, refer to Section 6. The following topics are covered in this section:
Accessing the Main module (Section 4-2). Using the File menu (Section 4-3). Using the View menu (Section 4-4). Using the Properties menu (Section 4-5). Using the Calculate menu (Section 4-6). Using the Report menu (Section 4-7).
9/98
4-1
U0-8801
4-2. Accessing the Main Module

When the CBS is started, the Main module is displayed automatically. (Refer to Section 2 for information on starting the CBS.) The Main module provides the following ve menu options:
File View Properties Calculate Report
U0-8801
4-2
9/98
The following illustrates the CBS Main window.
9/98
4-3
U0-8801
4-3. Using the File Menu

The File menu (Figure 4-1) allows the user to perform various functions related to le (permanent calculation sets) manipulations. The following options can be accessed from the File menu (see Section 4-2):
Load allows the user to load a permanent calculation set as the working (Section 4-3.1). Save/Save As allows the user to save the working calculation set as a permanent set (Section 4-3.2). New allows the user to clear existing working set data and to enter new data for a working calculation set (Section 4-3.3). Delete allows the user to delete the working calculation set and its corresponding permanent set (Section 4-3.4).
U0-8801
4-4
9/98
Figure 4-1. File Menu Window
4-3.1. Loading a Permanent Calculation Set as a Working Set

The Load option allows the user to load a permanent calculation set as a working set and provides access to the List and Filter/Sort options. (For information on creating calculation sets, refer to Section 6.) To load an existing permanent calculation set, perform the following steps: 1. Select the File menu. 2. Select the Load option.
9/98
4-5
U0-8801
At this point, another window (Figure 4-2) will appear offering two choices:
List Filter/Sort
Figure 4-2. File Menu Window (Load Options)
Using the List Option The List option allows the user to view a list of the available permanent sets. To view a list of the permanent calculation sets available, perform the following steps: 1. Select the File menu.
2. Select the Load option.
U0-8801
4-6
9/98
3. Select the List option. 4. The Calc:List/Load Set window will appear with a list of available permanent calculation sets (Figure 4-3). 5. Select the appropriate calculation set from the list in the Calc:List/Load Set window (or manually enter the Set Name and Owner). 6. Press Load on the Calc:List/Load Set window.
Figure 4-3. Example of Calculation List Window
9/98
4-7
U0-8801
Figure 4-4 represents the main window loaded with the calculation set data.
Figure 4-4. Example of Window with Loaded Set
U0-8801
4-8
9/98
Using the Filter/Sort Option The Filter/Sort option allows the user to select and limit the list of permanent calculation sets. To limit the list of permanent calculation sets, perform the following steps: 1. Select the File menu. 2. Select the Load option. 3. Select the Filter/Sort option. 4. The Filter/Sort window will appear (Figure 4-5). 5. Select the appropriate set name, description or owner. This function allows the user to sort and lter the permanent calculation sets by name, description or owner.
To lter the list, enter a string of characters in the text entry elds for Set Name, Description, or Owner (wild cards are permitted). To sort the list, select the box next to Set Name, Description and/or Owner with the desired priority of each item. (An item with a priority of 1 will be checked rst.) Press the Apply button to lter and/or sort. Press Reset to restore the previous lter/sort settings.
9/98
4-9
U0-8801
Figure 4-5. Filter/Sort Window
U0-8801
4-10
9/98
4-3.2. Saving a Working Calculation Set as Permanent Sets

Working calculation sets can be saved using either the Save or the Save As option from the File menu. To save the current working calculation set under the current set name, perform the following steps: 1. Select the File menu. 2. Select the Save option. To save the current working calculation set under a different set name, perform the following steps: 1. Select the File menu. 2. Select the Save As option. 3. A window is displayed (Figure 4-6) containing the Old Set Name, a prompt for the New Set Name, and a Save button. Enter a the new Set Name. 4. Press the Save button to write the calculation set to the RDBMS.
9/98
4-11
U0-8801
Figure 4-6. File Menu WIndow (Save As)
U0-8801
4-12
9/98
4-3.3. Clearing the Existing Working Set Data

The New option of the File menu can be used to clear existing working set data in order to add new calculation set data. To clear an existing working calculation set and add new calculation set data, perform the following steps: 1. Select the File menu. 2. Select the New option. 3. This removes the current working calculation set from memory and clears all of the scrolling lists. This does not remove a previously loaded calculation set from the RDBMS if the set is a permanent set. 4. Select any of the Properties editors to dene the properties of the new calculation sets:
Refer to Section 5 for information on the Properties module and its editors.
9/98
4-13
U0-8801
4-3.4. Deleting a Permanent/Working Calculation Set

Deleting Permanent Sets The Delete option of the File menu can be used to delete permanent calculation sets from the database. To delete a permanent calculation set, it must rst be loaded as a working set (as described in Section 4-3.1). To delete the permanent calculation set that is currently loaded as the working set, perform the following steps: 1. Select the File menu. 2. Select the Delete option. 3. A window will appear, asking for conrmation.
Press Conrm to remove the current calculation set from the RDBMS. Press Cancel to return to the main window.
Refer to Section 3 for additional details regarding permanent sets. Deleting Working Sets A working set is a set that is currently being displayed and manipulated by the user, and does not exist in the database. Thus, working sets are deleted whenever the user does any of the following:
Loads another calculation set. Quits the CBS application. Uses the New button.
Refer to Section 3 for additional details regarding working sets.
U0-8801
4-14
9/98
4-4. Using the View Menu

The View menu (Figure 4-7) allows the user to specify what data is shown in four scrolling lists, and the order of the data list. The following options can be accessed from the View menu:
Filter/Sort allows the user to lter or sort the items of the calculation set lists (Section 4-4.1). Locate allows the user to search for a specic entry in the scroll list. (Section 4-4.2). Clear List allows the user to clear entries in the scrolling list (Section 4-4.3).
These options are applicable to all four scrolling lists in the base window.
Figure 4-7. View Menu Window
9/98
4-15
U0-8801
After choosing one of the options from the View menu, the user is presented with a choice of lists (Figure 4-8):
Calculated Variables Input Variables Output Variables Constants
Figure 4-8. View Menu Window (showing available options list)
U0-8801
4-16
9/98
4-4.1. Filtering/Sorting Items of Calculation Set Lists

The Filter/Sort option allows the user to select and/or sort items of the calculation set lists. To lter or sort the items of the calculation set lists, perform the following steps: 1. Select the View menu. 2. Select the Filter/Sort button. 3. Select the appropriate list. Figure 4-9 provides an example of a Filter/Sort applied to the Input Variables list.
Figure 4-9. Filter/Sort Window (Input Variables)
9/98
4-17
U0-8801
General Information All of the Filter/Sort windows are divided in half. The upper half of the window is devoted to the lter function, and the lower half of the window is devoted to the sort function. To lter a scroll list, enter a pattern in one or more of the input elds to match against. Wild cards (*) are accepted in all of the input elds. Sorting may be performed independently or in conjunction with ltering. The bottom half of the window lists several sort choices, with an order and a priority for each. The priority determines which sort type is applied rst, and the order determines how the sort is done (in ascending or descending order). To assign an order to a sort type, click on the A (ascending) or D (descending). To assign a priority to a sort type, click on the box to the left of the desired type. The order in which the boxes are selected determines their priority (1 is assigned rst, 2 is assigned second, and so forth). Clicking on the box again removes that sort type from the sort and shifts all lower priority (higher number) sort types to the next higher priority (lower number). Press the Apply button to lter and/or sort. Press the Reset button to return to the main window.
4-4.2. Locating Entries in the Scrolling Lists

The Locate option allows the user to search for a specic entry in the scrolling list. To locate a specic entry in one of the scroll lists, perform the following steps: 1. Select the View menu. 2. Select the Locate button. 3. Select the appropriate list:
Calculated Variables Input Variables Output Variables Constants
4. A window corresponding to the list selected in Step 3 appears.
U0-8801
4-18
9/98
All windows associated with the Locate option are the same. Figure 4-10 provides an example of Locate applied to the Input Variables list.
Figure 4-10. Locate Window (Input Variables)
5. To begin the search, do the following:
Enter a name in the input eld. Press the Locate button.
The Locate function performs the search based on the name typed in the input eld. Wild cards are accepted. Wild cards will locate the rst name that matches.
9/98
4-19
U0-8801
4-4.3. Clearing Current Entries in the Scrolling List

The Clear List option allows the user to clear entries in the scrolling list. To clear all current entries in the scrolling list, perform the following steps: 1. Select the View menu. 2. Select the Clear List button. 3. Select the appropriate list.
The Clear List option removes the information from the scroll list only. It does not affect the information in the RDBMS.
U0-8801
4-20
9/98
4-5. Using the Properties Menu

The Properties menu provides access to the Properties module. The Properties module allows the user to add, edit, or delete items of a calculation set. There are two ways to access the Properties module. One way uses the Properties menu. This method invokes a Properties editor that has no entries in its scrolling list. Another way to access the Properties module uses the scrolling lists in the main window of the CBS Main module. This method invokes a Properties module that has entries in its scrolling list. (For information on accessing the Properties module using the scrolling lists from the Main module, refer to Section 5.) To access the Properties module using the Properties menu, perform the following steps: 1. Select the Properties button. 2. Select the desired editor from the Properties menu (see Figure 4-11):
3. The Properties screen for that editor will appear. The Calculation Builder Main module will remain open. If the Properties module is invoked this way, the editor will initially have no entries in its scrolling list (see Section 5 for an explanation of the Properties module).
9/98
4-21
U0-8801
Figure 4-11. Properties Menu Window
U0-8801
4-22
9/98
4-6. Using the Calculate Menu

The Calculate menu (Figure 4-12) allows the user to perform the calculations dened by the current calculation set and provides access to functions related to the calculation process. The following options are accessed from the Calculate menu:
Execute Set allows the user to perform calculations dened in the current calculation set (Section 4-6.1). Load Inputs allows the user to retrieve historical data for a past time period from the WEStation HSR (Section 4-6.2). Update Outputs allows the user to place output variables onto the highway for debugging other programs that use the calculated variables (Section 4-6.3).
9/98
4-23
U0-8801
Display Errors allows the user to display errors encountered during Execute Set option (Section 4-6.4).
Figure 4-12. Calculate Menu Window
4-6.1. Performing Calculations

The Execute Set option allows the user to perform calculations dened in the current calculation set. To perform the calculations, perform the following steps: 1. Select the Calculate menu. 2. Select the Execute Set option.
U0-8801
4-24
9/98
If the execution was successful, the results will be stored into the RDBMS, and the Calculation Builder windows will update to show the calculation results. If the execution was not successful, a message will appear telling the user to check the error list. (Refer to Section 4-6.4 for information regarding the display of errors.)
4-6.2. Loading Inputs

The Load Inputs option allows the user to retrieve historical data for a past time period from the WEStation HSR, and load them as values for the WDPF input variables of the calculation set. Note Input values may be an instantaneous, average, minimum or maximum when retrieved for the WEStation HSR. To load inputs from the HSR, perform the following steps: 1. Select the Calculate menu. 2. Select the Load Inputs option. 3. Specify the start and end time of the interval for the data retrieval using the Load Inputs menu (see Figure 4-13). 4. When the Load button is pressed, a wait message is displayed in the main window while the HSR processes the request. When the data retrieval is completed, a message appears in the main window. The Input Variable scrolling list is updated with the new values.
9/98
4-25
U0-8801
Figure 4-13. Calculate Menu Window (Load Inputs)
U0-8801
4-26
9/98
4-6.3. Updating Outputs

The Update Outputs option allows the user to place output variable points, values, and quality onto the highway for debugging other programs that use the calculated variables. To access the Update Outputs option, perform the following steps: 1. Select the Calculate menu. 2. Select the Update Outputs option.
4-6.4. Displaying Errors

The Display Errors option allows the user to display errors (such as missing parentheses or undened variables), which may be generated when a calculation set is executed. To display these errors, perform the following steps: 1. Select the Calculate menu. 2. Select the Display Errors option. 3. The Display Errors window (Figure 4-14) will appear. It will list the following:
All of the variables that have an error associated with them. The reason for the error.
9/98
4-27
U0-8801
Figure 4-14. Display Errors Window
U0-8801
4-28
9/98
4-7. Using the Report Menu
4-7. Using the Report Menu

The Report menu is used to print reports. To access the Report menu, perform the following steps (see Figure 4-15): 1. Select the Report button from the Main module. 2. The Calc:Report List window appears. 3. Choose the desired report in the scrolling list. 4. Press the Generate button to print the selected report.
Figure 4-15. Report Window (Report List)
9/98
4-29
U0-8801

This section explains how the six editors in the Properties module work and describes the various menu options associated with the module. For information on specic applications of the CBS, refer to Section 6. The following topics are covered:
Accessing the Properties module (Section 5-2). Editor overview (Section 5-3).
View menu (Section 5-4). Insert menu (Section 5-5). Edit menu (Section 5-6). Print menu (Section 5-7).
9/98
5-1
U0-8801
5-2. Accessing the Properties Module

There are two methods to access the Properties module. The rst method uses the Properties menu, which invokes a Properties editor that has no entries in its scrolling list. The second method uses scrolling lists in the main window of the CBS Main module. This method invokes a Properties module that has entries in its scrolling list.
5-2.1. Accessing the Properties Module Using the Properties Menu

The individual Properties screens of the Properties module can be accessed using the Properties menu from the Main module. The steps to access the Properties module using the Properties menu are as follows: 1. Select the Properties button from the Main module. 2. Select the desired editor from the Properties menu:
3. The Properties screen for that editor will appear with no entries in its scrolling list.
U0-8801
5-2
9/98
5-2.2. Accessing the Properties Module Using the Scrolling Lists

The Properties module can be accessed using the scrolling lists in the main window of the Main module (see Figure 5-1). The steps to access the Properties module using the scrolling lists are as follows: 1. Double click (with the mouse) to select the desired item (see Figure 5-1).
Figure 5-1. Accessing the Properties Module Using the Scrolling Lists
2. The Properties screen for that editor will appear (see Figure 5-2) 3. The selected item will appear on the Properties screen (shown in Figure 5-2).
9/98
5-3
U0-8801
Figure 5-2. Properties Module Access
U0-8801
5-4
9/98
5-3. Editor Overview

The six editors of the Properties module are the following:
All of the properties editors share a common design and a similar interface. The top half of the screen is devoted to the common menu. The bottom half of the screen is used to enter information specic to the type of variable being edited. In all cases, the input is checked for correctness, and an error message is displayed indicating the specic problem.
5-3.1. Calculated Variables

The values of calculated variables are determined by user-dened equations. The equations are entered in the bottom window, according to SQL syntax (see the PL/SQL Users Guide and Reference for further information regarding SQL syntax). The following denes some of the elds available from the Calculated Variables window (Figure 5-3):
Variable - name of the calculated variable. Description - text description of the variable. Units - units of the variable. Quality override - overrides automatic generation of a quality statement. If checked, automatic generation of a quality statement will not be performed, and the user must input a quality statement manually.
Formula - formula expression for the calculated variable.
9/98
5-5
U0-8801
Note If the value of any other calculated variable besides the one being dened is altered, the user must specify an update statement within the formula. For example, if the formula for the variable C$C1 causes C$C2 to be changed, an update statement of the form u(C$C2, C$C2, QC$C2) must be included to ensure that the value of C$C2 is propagated correctly. Explicit update statements are not required for formulas that only modify the calculated variable that is being dened.
Figure 5-3. Calculated Variables
U0-8801
5-6
9/98
5-3.2. Input Variables

The user can select a value type and determine from where the input variable is received using the Input Variables window (Figure 5-4). The following denes some of the elds available from the Input Variables window:
Variable - name of the input variable. Description - text description of the variable. Units - units of the variable. Value - current value of the input. Quality - current quality of the input. Valid Range (High, Low) - denes a valid operating range for the input variable, if entered. Use Substitute Value - if box is checked, the Substitute Value is used for the input variable even if the Primary Input or Alternate Input is valid. Substitute Value - is a typical value for the input and will be used only if both the Primary Input and Alternate Input are out of range or have bad quality. Primary Input (WDPF, CALC) - denes where the data for the input Variable comes from. This can be a WDPF Highway point or a calculated variable from another set. WDPF Point Name - name of the WDPF highway point from where this input is obtained when running in the on-line mode. Value Type: (AVG, MAX, MIN, INS) - processing type for the current Value of the input. Must select one of the following, using average, maximum, minimum, or instantaneous. The default is average.
9/98
5-7
U0-8801
Calculated Name (Set, Owner) - name of the calculated variable in another set that is to be used for the input. The set name and owner of the other set must be specied. Alternate Input (WDPF, CALC, NONE) - denes where the data for the input variable comes from if the Primary input is out of range or has bad quality.
Figure 5-4. Input Variables Window
U0-8801
5-8
9/98
5-3.3. Output Variables

Output variables specify WDPF output points that are originated from the calculation set. The following denes some of the elds available from the Output Variables window (Figure 5-5):
Variable - name of the variable to be output. This eld must be a valid input or calculated variable. Point Name - WDPF point name used to broadcast this output.
Figure 5-5. Output Variables Window
9/98
5-9
U0-8801
5-3.4. Constants
Constants are used to simplify the calculation process. Note that there is only one set of constants for each Calculation Builder System. The following denes some of the elds available from the Constants window (Figure 5-6):
Constant - name of the constant. Description - description of the constant. Units - units of the constant. Value - value of the constant.
Figure 5-6. Constants Window
U0-8801
5-10
9/98
5-3.5. Comments
Comments are used to document the changes made to a calculation set. The following denes the elds available from the Comments window (Figure 5-7):
Version - version number assigned by the user. Date/Time - date and time this comment was entered. Comments - comments associated with this version.
Figure 5-7. Comments
9/98
5-11
U0-8801
5-3.6. Conditional Evaluation

In the Conditional Evaluation window (Figure 5-8), the user can dene conditions that will apply to the selected calculation set. This window allows the user to specify an IF statement that must be true for a calculation set to be evaluated. For example, this could be used to skip a set of calculations if some plant equipment is out of service or below the minimum load level. The following denes the elds available from the Conditional Evaluation window:
IF - conditional statements to be executed before execution of the calculation set. If this statement evaluates to false, then the following will occur: The ELSE condition of this screen is evaluated. The calculation set is not executed.
ELSE - statements executed if the IF condition of this screen evaluates to false. These statements are then executed in lieu of the calculation set. The ELSE clause by default automatically sets all the calculated variables to zero with bad quality.
U0-8801
5-12
9/98
Figure 5-8. Conditional Evaluation Window
9/98
5-13
U0-8801

The View menu (Figure 5-9) allows the user to specify what data is shown and in what order. The View menu is the same for all six editors in the Properties module. The following options can be accessed from the View menu:
Filter/Sort (Section 5-4.1). Locate (Section 5-4.2). Clear List (Section 5-4.3).
U0-8801
5-14
9/98
Figure 5-9. View Menu Window
9/98
5-15
U0-8801
5-4.1. Using the Filter/Sort Option

There are ve different Filter/Sort windows. The ve Filter/Sort windows are shown here for reference (the number and meaning of some of the input elds vary for each editor).
Filter/Sort is described in more detail in Section 4.
Calculated Variables Figure 5-10 illustrates the Filter/Sort window for Calculated Variables.
Figure 5-10. Filter/Sort Window (Calculated Variables)
U0-8801
5-16
9/98
Input Variables Figure 5-11 illustrates the Filter/Sort window for Input Variables.
Figure 5-11. Filter/Sort Window (Input Variables)
9/98
5-17
U0-8801
Output Variables Figure 5-12 illustrates the Filter/Sort window for Output Variables.
Figure 5-12. Filter/Sort Window (Output Variables)
U0-8801
5-18
9/98
Constants Figure 5-13 illustrates the Filter/Sort window for Constants.
Figure 5-13. Filter/Sort Window (Constants)
9/98
5-19
U0-8801
Comments Figure 5-14 illustrates the Filter/Sort window for Comments.
Figure 5-14. Filter/Sort Window (Comments)
U0-8801
5-20
9/98
5-4.2. Using the Locate Option

The Locate option is the same in each editor. It is identical to the Locate option of the Main module. (For additional details, refer to the description of the Locate option of the Main module described in Section 4.)
5-4.3. Using the Clear List Option

The Clear List option allows the user to clear items from the scrolling list, without affecting the database. To clear all current entries in the scrolling list, perform the following steps: 1. Select the View menu. 2. Select the Clear List button. This removes the information from the scrolling list only and does not effect the information in the RDBMS.
9/98
5-21
U0-8801
5-5. Using the Insert Menu
5-5. Using the Insert Menu

The Insert menu allows the user to determine where an item will be inserted in the scrolling list. The options available from the Insert menu are the following:
Before After Top Bottom
To insert a new item, perform the following steps: 1. Press the Insert button on the base window. 2. Choose a location from the Insert menu: If there are no items in the list, then only Top or Bottom are valid option choices. When there are items in a list, an item must be selected to use the Before and After options. 3. The new item can be edited by entering information in the blank elds below the scrolling list. 4. Each editor requires that the name eld be lled before the new item can be added to the list. 5. The Input Variable editor requires the WDPF point or the external calculated point information. 6. Press the Apply button in the base window to insert the information into the list. - OR Press the Reset button to clear the entry elds.
U0-8801
5-22
9/98
5-6. Using the Edit Menu

The Edit menu allows the user to quickly and easily manipulate items on the scrolling lists. The following options can be accessed from the Edit menu:
Undo Copy Paste Delete
5-6.1. Undoing an Edit

To undo the last insert, perform the following steps: 1. Select the Edit menu. 2. Select the Undo option. Note Once the Apply button (on the base window) is pressed, the Insert operation cannot be undone.
5-6.2. Copying an Item from a Scrolling List

To copy an item from a scrolling list, perform the following steps: 1. Select the item. 2. Select the Edit menu. 3. Select the Copy option. The item is copied into memory and may be pasted back later.
9/98
5-23
U0-8801
5-6.3. Inserting an Item into a Scrolling List

To paste or insert an item that has been copied into memory (as described in Section 5-6.2) into a scrolling list, perform the following steps: Note The Paste option is the same as the Insert option. It allows the user to specify where to paste in the scrolling list (relative to the item selected). 1. Select an item. 2. Select the Edit menu. 3. Select the Paste option.
5-6.4. Deleting an Item From a Scrolling List

To delete an item from a scrolling list, perform the following steps: 1. Select the item. 2. Select the Edit menu. 3. Select the Delete option. A message will appear to conrm that the item is to be deleted.
U0-8801
5-24
9/98
5-7. Using the Print Menu

The Print menu can be accessed from the Properties editors. To access the Print menu, perform the following steps: 1. Access the Properties module by selecting the Properties button from the Main module. 2. Select the desired Properties editor:
Calculated Variables Input Variables Output Variables Constants Comments Note There is no Print menu associated with the Conditional Evaluation editor.
3. Press the Print button. 4. The Print menu (Figure 5-15) presents three options:
Selected prints the information for the currently selected item List prints all of the scroll list items in the current base window Options changes the default settings relating to printing.
9/98
5-25
U0-8801
Figure 5-15. Print Menu Window
U0-8801
5-26
9/98
5-7.1. Selecting Print Options

The Options menu of the Print menu from a Properties editor allows the user to select the destination of a print request. The destination can be set to a printer or to a le (see Figure 5-16).
Figure 5-16. Print Menu Window (Options)
9/98
5-27
U0-8801
Sending Print Requests to a Printer To send the data to a printer, perform the following steps: 1. Select Options from the Print menu of a Properties module editor. 2. Select the printer name from the printer pull-down menu, or type the desired name at the prompt for the printer name. 3. Press the Apply button to change the print defaults to the options selected. 4. Press the Reset button to leave the defaults unchanged or to clear the selected values and reset the default values. Sending Print Requests to a File To write the data to a le, perform the following steps: 1. Select Options from the Print menu of a Properties module editor. 2. Specify the directory name and the le name in the next two lines. 3. Press the Apply button to change the print defaults to the options selected. 4. Press the Reset button to leave the defaults unchanged or to clear the selected values and reset the default values.
U0-8801
5-28
9/98

This section will discuss the functions of the Calculation Builder Subsystem (CBS). The following topics are included:
Creating a calculation set (Section 6-2). Dening calculation set properties (Section 6-3). Viewing a calculation set (Section 6-4). Executing a set in the off-line mode (Section 6-5). Scheduling a set for on-line execution (Section 6-6). Printing reports (Section 6-7).
9/98
6-1
U0-8801
6-2. Creating a Calculation Set

A calculation set is created by either of the following two ways:
Copying an existing set (Section 6-2.1). Creating a new set (Section 6-2.2).
In both cases, the new set is a working set. It will remain as a working set until one of the following occurs:
The set is deleted. The user quits the application. The set is saved as a permanent set. Note Remember that the new set (whether copied from an existing set or created as a new set) is a working set. The set will not exist as a permanent set in the database until it is saved using either the File/ Save or File/Save As option from the Main module (see Section 3 for additional information on working sets and permanent sets).
6-2.1. Copying an Existing Set

To copy an existing set, perform the following steps: 1. Select the File menu from the Main module (refer to Section 4 for information on the File menu). 2. Select the Load option from the File menu (refer to Section 4 for information on the Load function and its List and Filter/Sort options). 3. A working set with the same name is created and is displayed on the main screen. Once loaded, the set can be modied using the editors of the Properties menu (refer to Section 5 for information on the Properties module and its editors).
U0-8801
6-2
9/98
The steps required to modify the set are almost exactly the same as those required to create a new set (see Section 6-2.2). There is only one difference. When modifying a set, properties may already exist for that set.
6-2.2. Creating a New Set

To create a new working set, perform the following steps: 1. Unload the current working set, if necessary. Note If the application was just started and there is no set currently loaded, this step is unnecessary. To unload the set,
Select the File menu from the Main module (refer to Section 4 for information on the File menu). Select the New option.
2. Select the Properties menu from the Main module (refer to Section 5 for information on the Properties menu and its editors). 3. Select the appropriate editor from the Properties menu:
4. A screen(s) corresponding to the editor(s) selected will appear. Any or all of these screens may be active at the same time.
9/98
6-3
U0-8801
5. Use these editors to do the following:
Create calculated variables, input variables, and output variables. Dene numerical constants for the calculations. Add comments to the calculation set. Dene a conditional evaluation expression to the calculation set.
6. Perform the following to save the set: Select the File menu from the Main module (refer to Section 4 for information on the File menu). Select the Save As option.
U0-8801
6-4
9/98
6-3. Dening Calculation Set Properties

A calculation set is dened by its properties. Calculation set properties are dened through the individual Properties screens of the Properties module (refer to Section 5 for information on accessing and using the Properties module). The functions of the individual Properties screens are as follows:
Calculated variables dene all of the calculation expressions for the set. Input variables dene inputs for the calculations either WDPF Highway points or previously calculated variables from other calculation sets. Output variables dene WDPF Highway points for broadcasting calculation results on the WDPF Highway. Constants dene symbolic names for numerical constants that can be referenced in the calculation expressions. Comments are used to document a calculation set. Conditional evaluation denes the conditions that must be true before a calculation set executes.
It is not necessary to dene all of these properties for each calculation set. If a particular property is not applicable to a calculation set, it may be left unspecied. Table 6-1 provides the naming conventions that are used for calculation sets through the Properties screens. These naming conventions cannot be overridden.
Table 6-1. Naming Conventions for Calculation Set Properties
Prex K$ I$ C$ QC$ Constants Input variables
Type of Calculation Set Properties
Calculated variables Quality of calculated variables.
9/98
6-5
U0-8801
6-3.1. Dening Calculation Expressions

The Calculated Variable window is used to dene calculations. To access the Calculated Variable window, refer to Section 5. Calculated variables are dened by the following:
Calculated variable name (prexed with C$). Description of the variable. Units of the calculated result.
A text edit eld is provided for dening the calculated expression that is evaluated for that variable. Any valid Structured Query Language (SQL) statement can be included in this eld, including calls to supplied library functions. Refer to Appendix A for a list and brief description of supplied library functions. A quality variable (prexed QC$) is generated automatically for each calculated variable. The quality variable is equal to the worst quality of any input variable referenced in the calculation expression and the calculated result itself. This automatic generation may be overridden by the user by checking the Quality override box and typing the desired quality statement in the calculation expression eld. The Quality override box must be checked, and the user must input the desired quality statement directly whenever the default quality rule (worst quality of any input referenced in the calculation expression) is not sufcient. This is necessary when the expression contains a conditional expression (such as, an IF statement) or other complex logic.
U0-8801
6-6
9/98
6-3.2. Dening Inputs

The Input Variables window (shown below) is used to dene input values used by the calculation expressions. (For information on accessing the Input Variables window, refer to Section 5.)
Figure 6-1. Input Variables Window (for Dening Calculation Expression)
These inputs can be obtained from the WDPF Highway points or from the calculated variables of the calculation sets. Input variables are dened by the following:
Input variable name (prexed I$). Description of the variable. Units of the variable.
9/98
6-7
U0-8801
Valid range for the variable. Source of the input. Post Processing (AVE, MAX, MIN)
The calculated Input Variable value and Quality are assigned subject to the following rules: 1. If the Use Substitute Value box is checked (see Figure 6-1), the substitute value eld (Sub. Value) is always used as the calculated Input Variable value, and it is always assigned a fair Quality. (If the substitute value eld is blank, the calculated Input Variable is assigned the value of zero, with fair Quality.) 2. If the Primary Input has good or fair Quality, and its value is within the Valid Range High and Low elds (or these elds are not specied), the value and Quality of the calculated Input Variable is set to the Primary Input value and Quality. If an Alternate Input is specied, and its Quality is good or fair, and its value is within the Valid Range High and Low elds (or these eld are not specied), the value and Quality of the calculated Input Variable is set to the Alternate Input variable value and Quality. Otherwise, the value of the calculated Input Variable is set to the substitute value eld and assigned a fair Quality.
6-3.3. Dening Outputs

The Output Variables window is used to dene the WDPF Highway points used to broadcast the calculation results. To access the Output Variables window, refer to Section 5. Output variables are dened by the following:
Source of the result to output. WDPF Highway point that will be used to broadcast the result.
Sources may be either input variables or calculated variables. If an input variable is used as the source, then the post-processed value and quality of the input is broadcast. If a calculated variable is used as the source, then the post-execution value and quality of that variable is broadcast.
U0-8801
6-8
9/98
6-3.4. Dening Numerical Constants

The Constants window is used to assign symbolic names to numeric constants. To access the Constants window, refer to Section 5. Constants are dened by the following:
Name (prexed K$). Description. Value. Units.
This symbolic name can then be used in calculation expressions. While all other properties of a set are private to that set, constants are public. Creating a constant will make it available for use by all calculation sets, even ones owned by other users. Similarly, deleting a constant deletes it from all sets. Caution Be extremely careful when deleting constants to ensure that they are not referenced by other calculation sets.
6-3.5. Dening Comments

The Comments window is used to document a calculation set. To access the Comments window, refer to Section 5. A comment is dened by the following:
Version. Timestamp. Text block.
As changes are made to a calculation set, this property can be used to assign a version number and describe the changes made.
9/98
6-9
U0-8801
6-3.6. Dening Conditional Evaluation Expressions

The Conditional Evaluation window is typically used to determine if the conditions are valid for the calculation set to run and, if not, to assign appropriate values to the output variables. The Conditional Evaluation window is used to dene the following:
An initial condition that must be true before the rest of the calculation set is executed. An else condition that is executed if the initial condition evaluates to false.
To access the Conditional Evaluation window, refer to Section 5. The syntax for these elds is identical to the calculation expression eld for calculated variables.
U0-8801
6-10
9/98
6-4. Viewing a Calculation Set
6-4. Viewing a Calculation Set

When a calculation set is loaded, its constants, input variables, calculated variables, and output variables appear on the Main window in the appropriately labeled scrolling list. These lists may be ltered and sorted using the View menu of the Main module (refer to Section 4 for information on ltering and sorting). Note Items are added to a calculation set (using the Properties windows. They do not automatically appear on the Main window scrolling lists, as this may conict with the previously selected lter conditions. To see these new additions, use the View menu of the Main module to relter the appropriate scrolling list.
9/98
6-11
U0-8801
6-5. Executing a Set in the Off-line Mode
6-5. Executing a Set in the Off-line Mode

A calculation set can be executed in the off-line mode in order to perform testing operations. The set is executed using the Execute Set option of the Calculate menu from the Main module (see Section 4). If errors are detected after compiling the calculation set, the Display Errors option of the Calculate menu can be used to locate the error (as described in Section 4). Once all compilation errors have been corrected, the set can be executed. Data for the input variables can be retrieved from the WEStation HSR for any desired time period in order to simulate past conditions. (Refer to Section 4 for information on loading inputs from the WEStation HSR.) In addition, the inputs can be set directly to any value. Then, the set can be executed using these inputs and the outputs examined. Also, the calculation expressions of the calculated variables can be changed (if desired) and re-executed. None of these actions will affect any of the on-line calculation sets currently executing.
U0-8801
6-12
9/98
6-6. Scheduling a Set for On-line Execution

When a set has been fully developed and tested, the user may change its mode to on-line. By default, a calculation set is in the off-line mode. An off-line set executes only when requested by a user. It does not access the WDPF Highway for input or output points.
6-6.1. Changing the Execution Mode to On-line

To change the execution mode of a loaded set to on-line, the perform the following steps: 1. Check the Execute Online box on the Main window (see Figure 6-2). 2. Enter (in minutes) the execution in the Interval entry eld (see Figure 6-2). 3. Specify whether or not the on-line set should execute on an interval boundary.
If the execute interval boundary box is not check, the on-line set will begin execution immediately after generation, and will execute at the specied execution interval. (For this example, the execution box is not checked in Figure 6-2.) If the execute interval boundary box is checked, execution will be delayed until the next execution boundary. For example, if the execution interval is 60 (one hour), the set will wait until the start of the next hour before execution. Subsequent executions will each begin on an hour boundary. Similarly, if the execution interval is 1440 (one day), execution will wait until the beginning of the next day, and then run at the start of each subsequent day.
9/98
6-13
U0-8801
Figure 6-2. CBS Main Window (On-line Execution)
4. Save the set as a permanent set (see Section 3 for information regarding permanent sets). This set is then executed automatically at every execution interval. Input variables are retrieved from the WDPF Highway, and output variables are broadcast on the WDPF Highway. Sets scheduled for on-line execution will restart automatically following reboots or failures of the drop.
U0-8801
6-14
9/98
6-6.2. Stopping an On-line Set from Executing

To stop an on-line set from executing, perform the following steps: 1. Load the set (refer to Section 4 for information on the Load option from the File menu). 2. Uncheck the Execution Online box. 3. Save the set again.
6-6.3. Changing the Execution Interval

To change the execution interval of a currently executing set, perform the following steps: 1. Load the set (refer to Section 4 for information on the Load option from the File menu). 2. Enter (in minutes) the execution in the Interval entry eld. 3. Save the set again. The currently executing set will be stopped, and restarted with the new execution interval.
9/98
6-15
U0-8801
6-7. Printing Reports
6-7. Printing Reports

Reports can be printed using the Report menu from the Main window and using the Print menu from the Properties module.
6-7.1. Printing Reports from the Main Module

Printed output describing a calculation set is available through the Report menu of the Main window. (Refer to Section 4 for information on the Main module and the Report menu.) The Report menu provides a list of standard reports (and a brief description of each) that can be invoked to obtain detailed printouts describing the calculation set.
6-7.2. Printing Reports from the Properties Module

There is a print function within each of the Properties screens. It can be used to generate a printout of a selected group of items. To access the Properties module, refer to Section 5.
U0-8801
6-16
9/98
Appendix A. Supplied Numerical Library Functions

A-1. Appendix Overview
This appendix lists the numerical functions that can be called within a formula for a calculated variable. Throughout, comment lines are indicated by two dashes ( ) at the beginning of a line.
A-2. HCLSP
A-2.1. Description
This function computes the specic enthalpy in the compressed liquid region given entropy and pressure.
A-2.2. Inputs
Specic entropy Pressure
A-2.3. Example
Calculate feedwater outlet enthalpy as compressed liquid function of feedwater outlet entropy (SFHOG) and feedwater pressure (PBFW). C$HFHOG := C.HCLSP(I$SFHOG, C$PBFW);
9/98
A-1
U0-8801
A-2. HCLSP
A-3. HCLTP
A-3.1. Description
This function computes the specic enthalpy in the compressed liquid region given temperature and pressure.
A-3.2. Inputs
Temperature Pressure
A-3.3. Example
Calculate feedwater outlet enthalpy as compressed liquid function of feedwater outlet temperature (TFHO5) and feedwater pressure (PBFW). C$HFHO5 := C.HCLTP(I$TFHO5, C$PBFW);
A-4. HISTPP
A-4.1. Description
This function computes the specic enthalpy of an isentropic drop from conditions t1 and p1, down to pressure p2. The conditions of t1 and p1 must be in the superheated region, and condition of p2 can be in either the superheated or wet region.
U0-8801
A-2
9/98
A-2. HCLSP
A-4.2. Inputs
Temperature, t1 Pressure, p1 Pressure, p2
A-4.3. Example
Compute boiler feed pump A turbine isentropic enthalpy as a function of supply steam temperature and pressure (TBTSTA, PBTSTA) and exhaust pressure (PBXABA). C$HBTSIA := C.HISTPP(I$TBTSTA, C$PBTSTA, C$PBXABA);
A-5. HSLP
A-5.1. Description
This function computes the specic enthalpy in the saturated liquid region given pressure.
A-5.2. Inputs
Pressure
A-5.3. Example
Compute enthalpy of the blowdown as a saturated liquid function of drum pressure (PDRUMA). C$HBLDWN := C.HSLP(C$PDRUMA);
9/98
A-3
U0-8801
A-2. HCLSP
A-6. HSLT
A-6.1. Description
This function computes the specic enthalpy in the saturated liquid region given temperature.
A-6.2. Inputs
Temperature
A-6.3. Example
Compute steam jet air ejector drain temperature as a saturated liquid function of drain temperature (TSJAED). C$HSJAED := C.HSLT(C$TSJAED);
A-7. HSSTP
A-7.1. Description
This function computes the specic enthalpy in the superheated steam region given temperature and pressure.
A-7.2. Inputs
U0-8801
A-4
9/98
A-2. HCLSP
A-7.3. Example
Calculate enthalpy of main steam at high pressure turbine throttle as a superheated steam function of the temperature (TMNSTM) and pressure (PMNABS). C$HMNSTM := C.HSSTP(I$TMNSTM, C$PMNABS);
A-8. HSVP
A-8.1. Description
This function computes the specic enthalpy in the saturated vapor region given pressure.
A-8.2. Inputs
Pressure
A-8.3. Example
Calculate the enthalpy of the dry saturated vapor at the low pressure turbine exhaust pressure (PCNABS). C$HCNVAC := C.HSVP(C$PCNABS);
A-9. HSWSP
A-9.1. Description
This function computes the specic enthalpy in the superheated or wet steam region given entropy and pressure.
9/98
A-5
U0-8801
A-10. PSLT
A-9.2. Inputs
Entropy Pressure
A-9.3. Example
Calculate the intermediate pressure turbine bowl enthalpy as a function of bowl entropy (SIPBWL) and pressure (PIPBWL). C$HIPBWL := C.HSWSP(C$SIPBWL, C$PIPBWL);
A-10. PSLT
A-10.1. Description
This function computes the pressure in the saturated liquid region given temperature.
A-10.2. Inputs
Temperature
A-10.3. Example
Calculate auxiliary condenser A expected back pressure as a saturated liquid function of expected saturation temperature (TCXCLNA). C$PCXCLNA := C.PSLT(C$TCXCLNA);
U0-8801
A-6
9/98
A-11. SCLHP
A-11. SCLHP
A-11.1. Description
This function computes the specic entropy in the compressed liquid region given enthalpy and pressure.
A-11.2. Inputs
Enthalpy Pressure
A-11.3. Example
Calculate feedwater outlet entropy as a compressed liquid function of feedwater outlet enthalpy (HFHO5) and feedwater pressure (PBFW). C$SFHO5 := C.SCLHP(I$HFHO5, C$PBFW);
A-12. SCLTP
A-12.1. Description
This function computes the specic enthalpy in the compressed liquid region given temperature and pressure.
A-12.2. Inputs
9/98
A-7
U0-8801
A-13. SSLP
A-12.3. Example
Calculate feedwater outlet entropy as a compressed liquid function of feedwater outlet temperature (TFHO5) and feedwater pressure (PBFW). C$SFHO5 := C.SCLTP(I$TFHO5, C$PBFW);
A-13. SSLP
A-13.1. Description
This function computes the specic entropy in the saturated liquid region given pressure.
A-13.2. Inputs
Pressure
A-13.3. Example
Calculate auxiliary condenser A entropy as a saturated liquid function of expected saturation pressure (PCXCLNA). C$SCXCLNA := C.SSLP(C$PCXCLNA);
A-14. SSLT
A-14.1. Description
This function computes the specic entropy in the saturated liquid region given temperature.
U0-8801
A-8
9/98
A-15. SSSTP
A-14.2. Inputs
Temperature
A-14.3. Example
Calculate auxiliary condenser A entropy as a saturated liquid function of expected saturation temperature (TCXCLNA). C$SCXCLNA := C.SSLT(C$TCXCLNA);
A-15. SSSTP
A-15.1. Description
This function computes the specic entropy in the superheated steam region given temperature and pressure.
A-15.2. Inputs
A-15.3. Example
Calculate the intermediate pressure turbine bowl entropy as a function of bowl temperature (TIPBWL) and pressure (PIPBWL). C$SIPBWL := C.SSSTP(C$TIPBWL, C$PIPBWL);
9/98
A-9
U0-8801
A-16. SSVP
A-16. SSVP
A-16.1. Description
This function computes the specic entropy in the saturated vapor region given pressure.
A-16.2. Inputs
Pressure
A-16.3. Example
Calculate the entropy of the dry saturated vapor at the low pressure turbine exhaust pressure (PCNABS). C$SCNVAC := C.SSVP(C$PCNABS);
A-17. SSWHP
A-17.1. Description
This function computes the specic entropy in the superheated steam region given enthalpy and pressure.
A-17.2. Inputs
Pressure Enthalpy
U0-8801
A-10
9/98
A-18. TCLHP
A-17.3. Example
Calculate the intermediate pressure turbine bowl entropy as a function of bowl enthalpy (HIPBWL) and pressure (PIPBWL). C$SIPBWL := C.SSWHP(C$HIPBWL, C$PIPBWL);
A-18. TCLHP
A-18.1. Description
This function computes the temperature in the compressed liquid region given enthalpy and pressure.
A-18.2. Inputs
Pressure Enthalpy
A-18.3. Example
Calculate feedwater outlet temperature as compressed liquid function of feedwater outlet enthalpy (HFHO5) and feedwater pressure (PBFW). C$TFHO5 := C.TCLHP(I$HFHO5, C$PBFW);
9/98
A-11
U0-8801
A-19. TCLSP
A-19. TCLSP
A-19.1. Description
This function computes the temperature in the compressed liquid region given entropy and pressure.
A-19.2. Inputs
Pressure Entropy
A-19.3. Example
Calculate feedwater outlet temperature as compressed liquid function of feedwater outlet entropy (SFHO5) and feedwater pressure (PBFW). C$TFHO5 := C.TCLSP(I$SFHO5, C$PBFW);
A-20. TSLP
A-20.1. Description
This function computes the temperature in the saturated liquid region given pressure.
A-20.2. Inputs
Pressure
U0-8801
A-12
9/98
A-21. TSWHP
A-20.3. Example
The saturation temperature of the steam entering the condenser is computed from the exhaust steam pressure (PCONDA). C$CNTCNVAC := C.TSLP(C$PCONDA);
A-21. TSWHP
A-21.1. Description
This function computes temperature in the superheated or wet steam region given enthalpy and pressure.
A-21.2. Inputs
Pressure Enthalpy
A-21.3. Example
Calculate the intermediate pressure turbine inlet temperature as a function of inlet enthalpy (HHRHIP) and pressure (PHRABS). C$THRHIP := C.TSWHP(C$HHRHIP, C$PHRABS);
A-22. TSWSP
A-22.1. Description
This function computes temperature in the superheated or wet steam region given entropy and pressure.
9/98
A-13
U0-8801
A-23. VCLTP
A-22.2. Inputs
Pressure Entropy
A-22.3. Example
Calculate the intermediate pressure turbine inlet temperature as a function of inlet entropy (SHRHIP) and pressure (PHRABS). C$THRHIP := C.TSWSP(C$SHRHIP, C$PHRABS);
A-23. VCLTP
A-23.1. Description
This function computes specic volume in the compressed liquid region given temperature and pressure.
A-23.2. Inputs
Pressure Temperature
A-23.3. Example
Calculate suction specic volume as compressed liquid function of deaerator outlet temperature (TFHO4) and suction pressure (PBFABA). C$VBFABA := C.VCLTP(I$TFHO4, C$PBFABA);
U0-8801
A-14
9/98
A-24. VSLT
A-24. VSLT
A-24.1. Description
This function computes specic volume in the saturated liquid region given pressure.
A-24.2. Inputs
Temperature
A-24.3. Example
Compute specic volume of circulating water as saturated liquid function of circulating water inlet temperature (TCWIN). C$VCWIN := C.VSLT(C$TCWIN);
A-25. VSSTP
A-25.1. Description
This function computes specic volume in the superheated steam region given temperature and pressure.
A-25.2. Inputs
Pressure Temperature
9/98
A-15
U0-8801
A-26. VSVP
A-25.3. Example
Calculate rated specic volume as superheated steam function of rated throttle temperature (TRATED) and pressure (PRTABS). C$VRATED := C.VSSTP(K$TRATED, C$PRTABS);
A-26. VSVP
A-26.1. Description
This function computes specic volume in the saturated vapor region given pressure.
A-26.2. Inputs
Pressure
A-26.3. Example
Calculate the saturated dry specic volume at exhaust pressure (PCNABS). C$VCNPRS := C.VSVP(C$PCNABS);
A-27. VSWHP
A-27.1. Description
This function computes specic volume in the superheated or wet steam region given enthalpy and pressure.
U0-8801
A-16
9/98
A-28. VSWSP
A-27.2. Inputs
Pressure Enthalpy
A-27.3. Example
Calculate rated specic volume as superheated steam function of rated throttle enthalpy (HRATED) and pressure (PRTABS). C$VRATED := C.VSWHP(K$HRATED, C$PRTABS);
A-28. VSWSP
A-28.1. Description
This function computes specic volume in the superheated or wet steam region given entropy and pressure.
A-28.2. Inputs
Pressure Entropy
A-28.3. Example
Calculate rated specic volume as superheated steam function of rated throttle entropy (SRATED) and pressure (PRTABS). C$VRATED := C.VSWSP(K$SRATED, C$PRTABS);
9/98
A-17
U0-8801
A-29. XSWHP
A-29. XSWHP
A-29.1. Description
This function computes steam quality in the superheated or wet steam region given enthalpy and pressure.
A-29.2. Inputs
Pressure Enthalpy
A-29.3. Example
Calculate the quality of the steam at the expected expansion line end point (HELEPE) and exhaust pressure (PCNABS). C$XELEPE := C.XSWHP(C$HELEPE, C$PCNABS);
A-30. XSWSP
A-30.1. Description
This function computes steam quality in the superheated or wet steam region given entropy and pressure.
A-30.2. Inputs
Pressure Entropy
U0-8801
A-18
9/98
A-31. HICTPP
A-30.3. Example
Calculate the quality of the steam at the low pressure turbine exhaust entropy (SLTREX) and exhaust pressure (PCNABS). C$XLTREX := C.XSWSP(C$SLTREX, C$PCNABS);
A-31. HICTPP
A-31.1. Description
This function computes specic enthalpy of an isentropic rise from conditions t1 and p1, up to pressure p2 in the compressed liquid region.
A-31.2. Inputs
Pressure, p1 Pressure, p2 Temperature, t1
A-31.3. Example
Calculate the boiler feed pump isentropic enthalpy from inlet conditions (TBFSCT, PBFSCA) and outlet condition (PBFW). C$HBFWTI := C.HICTPP(I$TBFSCT,C$PBFSCA,C$PBFW);
A-32. FIBNSRCH
A-32.1. Description
This function computes actual air density and volume using a Fibonacci Search technique.
9/98
A-19
U0-8801
A-33. GOLDSRCH
A-32.2. Inputs
Cooling tower hot water inlet temperature, tcwhot Cooling tower cold water outlet temperature, tcwcld Atmospheric pressure (in psia), patmos Search starting high temperature, thigh Search starting low temperature tlow Search length, tlnth Constant in L/G equation, lgconst Inlet air enthalpy, airenthin Code: Return density = -1.0 Return volume = 1.0
A-32.3. Example
Calculate actual density. C$TACTDENS := C.FIBNSRCH (C$TCWHOT, C$TCWCLD, C$PATMOS, C$THIGH, C$TLOW, C$TLNTH, C$LGCONST, C$AIRENTHIN, -1.0); Calculate actual volume. C$TACTVOL := C.FIBNSRCH (C$TCWTHOT, C$TCWCLD, C$PATMOS, C$THIGH, C$TLOW, C$TLNTH, C$LGCONST, C$AIRENTHIN, 1.0);
A-33. GOLDSRCH
A-33.1. Description
This function computes the estimated cooling tower outlet temperature using the Search by Golden Section.
U0-8801
A-20
9/98
A-34. INTRPAXS
A-33.2. Inputs
KaV/L for test temperature, ak Target KaV/L, aktgt Inlet temperature, t1 Search section length, dist Test temperature, ttst Search range, alnth Inlet temperature, at1 Outlet temperature, at2 Test temperature, at3 Slope of air enthalpy line (L/G), slope Air enthalpy at inlet wet bulb temperature, ewtblb
A-33.3. Example
The outlet temperature that ts the target KaV/L, inlet temperature, wet bulb temperature, and slope is calculated by function GOLDSRCH. C$TTCWEST := C.GOLDSRCH (C$AK,C$AKTGT, C$T1, C$DIST, C$TTST, C$ALNTH, C$AT1,C$AT2,C$AT3,C$SLOPE,C$EWTBLB);
A-34. INTRPAXS
A-34.1. Description
This function computes the percent correction for 1 percent auxiliary extraction ow from ASME PTC 6.1 curve using interpolation.
9/98
A-21
U0-8801
A-35. KAVL
A-34.2. Inputs
Flow index Pressure Flow
A-34.3. Example
Calculate the fractional correction for 1% steam coil air heater supply steam ow at ow index (2.0), supply steam pressure (PTRX11), and supply steam ow (WSCARG). C$PSCCOR := C.INTRPAXS(2.0, C$PTRX11, C$WSCARG);
A-35. KAVL
A-35.1. Description
This function computes KaV/L using Simpson's Rule.
A-35.2. Inputs
Inlet temperature, t1 Outlet temperature, t2 Slope of air enthalpy line (L/G), slope Air enthalpy at inlet wet bulb temperature, ewtblb
A-35.3. Example
Calculate the test value of KaV/L based on inlet temperature (TCWHOT), outlet temperature (TCWCLD), slope of the air enthalpy line (SLOPE), and air enthalpy (EWTBLB). C$ACTCALCAK := C.KAVL(C$TCWTWR, C$TCWCLD, C$SLOPE, C$EWTBLB);
U0-8801
A-22
9/98
A-36. REGFALS
A-36. REGFALS
A-36.1. Description
This function computes the corrected value of L/G based on outlet temperature using a successive approximation algorithm based on the Regula Falsi Principle.
A-36.2. Inputs
Test KaV/L, calcak Constant in base KaV/L equation, const1 Design value of KaV/L, current water ow, desak Design value of KaV/L, design water ow, odesak Design wet bulb temperature, denwb Design hot water inlet temperature, dtmpin Design cold water outlet temperature, dtmpot Inverse of exponent in characteristic equation, expnin
A-36.3. Example
Calculate the corrected value of L/G. C$TACTSLOPE := C.REGFALS (C$CALCAK, C$CONST1, C$DESAK, C$ODESAK, C$DENWB, K$DTMPIN, K$DTMPOT, C$EXPNIN);
A-37. ENTHAL
A-37.1. Description
This function computes the calculated gas enthalpy (Btu/lb).
9/98
A-23
U0-8801
A-37. ENTHAL
A-37.2. Inputs
Units code: English units = 1.0. SI or metric units = -1.0 Initial gas temperature (degrees Fahrenheit), tgi Gas turbine fuel air ratio (decimal value), fgr Supplementary ring fuel gas ratio (decimal), fsr Weight of injection moisture (lb/lb air), wmj Weight of ambient moisture (lb/lb air), wma Percent carbon in fuel, pcf Percent carbon dioxide in fuel, pdf Percent hydrogen in fuel, phf Percent carbon monoxide in fuel, pmf Percent nitrogen in fuel, pnf Percent oxygen in fuel, pof Percent sulfur in fuel, psf Percent sulfur dioxide in fuel, puf Percent noncombustibles in fuel, pnc Enthalpy of exhaust gas at 32 degrees Fahrenheit (0 degrees Celsius), hbase Enthalpy conversion factor (decimal value), hconv
A-37.3. Example
Compute the enthalpy of the stack gas leaving a heat recovery steam generator as a function of the weight of injection moisture (WMJ), fuel/air ratio (FGR), fuel element percentages (PCARB, PC02, PHYDR, PCO, PNITR, POXY, PSULF, PSO2, and PNC), weight of ambient moisture (WMA), and the temperature (TGI) of the gas leaving the heat recovery steam generator. C$H1HSTACK := C.ENTHAL(-1.0, C$TGI, C$FGR, 0.0, C$WMJ, C$WMA, C$PCARB, C$PCO2, C$PHYDR, C$PCO, C$PNITR, C$PSULF, C$PSO2, C$PNC, C$PNC, C$HBASE, 0.0);
U0-8801
A-24
9/98
A-38. CALC_AVG
A-38. CALC_AVG
A-38.1. Description
This function computes an average from a set of up to 18 inputs.
A-38.2. Inputs
Input, (p1 through p18) Number of inputs to average, nbr_samp
A-38.3. Example
Calculate the average exhaust gas temperature. C$C1TCTEX := C.CALC_AVG(I$C1TCTEX1, I$C1TCTEX2, I$C1TCTEX3, I$C1TCTEX4, I$C1TCTEX5, I$C1TCTEX6, I$C1TCTEX7, I$C1TCTEX8, I$C1TCTEX9, I$C1TCTEX10, I$C1TCTEX11, I$C1TCTEX12, I$C1TCTEX13, I$C1TCTEX14, I$C1TCTEX15, I$C1TCTEX16, I$C1TCTEX17, 0, 17);
A-39. WBDENSVOL
A-39.1. Description
This function computes the density and volume of a saturated mixture at wet bulb temperature and atmospheric pressure.
9/98
A-25
U0-8801
A-40. WBENTH
A-39.2. Inputs
Wet bulb temperature, twb Saturated liquid pressure at twb, ptest Atmospheric pressure (psia), patmos Code: Return density = -1.0 Return volume = 1.0
A-39.3. Example
Calculate design air volume at the design outlet wet bulb temperature (DESTWB). C$DESVOL := C.WBDENSVOL(C$DESTWB, C$PTEST, C$PATMOS, 1.0); Calculate the design air density at the design outlet wet bulb temperature (DESTWB). C$DESDENS := C.WBDENSVOL(C$DESTWB, C$PTEST, C$PATMOS, -1.0);
A-40. WBENTH
A-40.1. Description
This function computes the wet bulb temperature and partial pressure of moisture corresponding to total heat of enthalpy.
A-40.2. Inputs
Total heat, enth Circulating water inlet temperature, tcwin
U0-8801
A-26
9/98
A-41. HUMID
A-40.3. Example
Calculate design outlet wet bulb temperature corresponding to the design heat in the outlet air (TOTHDES) and design hot water inlet temperature (DTMPIN). C$TDESTWB := C.WBENTH(C$TOTHDES, K$DTMPIN);
A-41. HUMID
A-41.1. Description
This function computes the humidity ratio (in pounds of water per pounds of dry air) from wet and dry bulb temperatures and barometric pressure.
A-41.2. Inputs
Wet bulb temperature (degrees Fahrenheit), wblb Dry bulb temperature (degrees Fahrenheit), dblb Barometric pressure (in/Hg), baro
A-41.3. Example
Calculate the humidity ratio as a function of wet bulb temperature (TWTBLB), ambient temperature (TAMBNT) and barometric pressure (PBARO). C$RHUMID := C.HUMID(I$TWTBLB, I$TAMBNT, I$PBARO);
A-42. RELHUMID
A-42.1. Description
This function computes the relative humidity of moist air as a percentage from wet and dry bulb temperatures and barometric pressure.
9/98
A-27
U0-8801
A-43. RELHMDEW
A-42.2. Inputs
Wet bulb temperature (degrees Fahrenheit), wblb Dry bulb temperature (degrees Fahrenheit), dblb Barometric pressure (in/Hg), baro
A-42.3. Example
Calculate the relative humidity as a function of wet bulb temperature (TWTBLB), ambient temperature (TAMBNT) and barometric pressure (PBARO) C$RELHMD := C.RELHUMID(I$TWTBLB, I$TAMBNT, I$PBARO);
A-43. RELHMDEW
A-43.1. Description
This function computes the relative humidity of moist air as a percentage from dew point and dry bulb temperatures, and barometric pressure.
A-43.2. Inputs
Dew point temperature (degrees Fahrenheit), dewpt Dry bulb temperature (degrees Fahrenheit), dblb Barometric pressure (in/Hg), baro
A-43.3. Example
Calculate the relative humidity as a function of dew point temperature (TDWPNT), ambient temperature (TAMBNT), and barometric pressure (PBARO). C$RELHMD := C.RELHMDEW(I$TDWPNT, I$TAMBNT, I$PBARO);
U0-8801
A-28
9/98
A-44. WETBLB
A-44. WETBLB
A-44.1. Description
This function computes the wet bulb temperature from relative humidity, dry bulb temperature, and barometric pressure.
A-44.2. Inputs
Relative humidity, relhum Dry bulb temperature (degrees Fahrenheit), dblb Barometric pressure (in/Hg), baro
A-44.3. Example
Calculate wet bulb temperature as a function of ambient temperature (TAMBNT), barometric pressure (PBARO), and relative humidity (RELHMD). C$TTWTBLB := C.WETBLB(I$TAMBNT, I$PBARO, C$RELHMD);
9/98
A-29
U0-8801
Index C
Calculate menu 4-23 Display Errors option 4-27, 6-12 Execute Set option 4-24 Load Inputs option 4-25 Update Outputs option 4-27 Calculated Variables 6-5 dening 6-6 editor elds 5-5 Filter/Sort option 5-16 Calculation Builder Subsystem (CBS) applications 6-1 functions 1-1 Main module 3-2 modules 3-2 requirements 2-2 start-up 2-3 start-up options 2-4 calculation set 1-1 creating 6-2 dening 2-5 displaying errors 4-27 executing 4-24 executing in off-line mode 6-12 functions from Properties menu 6-5 loading inputs 4-25 naming conventions for Properties 6-5 permanent 3-8 viewing 6-11 working 3-8 Clear List option using 5-21 Comments 6-5 dening 6-9 editor elds 5-11 Filter/Sort option 5-20 Conditional Evaluation 6-5 editor elds 5-12 for dening expressions 6-10 Constants 6-5 dening 6-9 editor elds 5-10 Filter/Sort option 5-19 creating a calculation set by copying an existing set 6-2 using the New option 6-3
D
data storage 3-8 Display Errors option 6-12 See also Calculate menu
E
Edit (Properties) menu 3-7 Copy option 5-23 Delete option 5-24 Paste (insert) option 5-24 Undo option 5-23 ELSE statement 5-12 Engineering WEStation 2-3 execution interval 6-13 changing 6-15 See also modes of operation
F
File menu Delete option 4-14 Load option 4-5, 6-15 New option 4-13 Save As option 4-11 Save option 4-11 using 4-4 Filter/Sort option using 5-16 window information 4-18
I
IF statement 5-12 Input Variables 6-5 dening 6-7 editor elds 5-7 Filter/Sort option 5-17 Insert menu 3-7 using 5-22
L
Library Functions See Appendix A Load option See also File menu 6-15 Locate option using 5-21
9/98
Index-1
U0-8801
Index M
main module for Calculation Builder Subsystem (CBS) 3-3 accessing 4-2 modes of operation 3-10 changing to executing on-line 6-13 executing off-line 6-12 stopping on-line set execution 6-15
R
reference documents 1-3 Relational Database Management System (RDBMS) 1-1, 3-8 Report menu 4-29 printing reports 6-16
S
Scheduling on-line execution See modes of operation 6-13 starting up Calculation Builder Subsystem (CBS) from a command tool 2-3 from Engineering WEStation 2-3 from Operator WEStation 2-3 Supplied Numerical Library Functions See Appendix A system security/restrictions 2-5
N
naming conventions Calculation Set Properties 6-5 Numerical Library Functions See Appendix A
O
off-line mode 3-10 on-line mode 3-10 Operator WEStation 2-3 Options menu (for Print) 5-27 Output Variables 6-5 dening 6-8 editor elds 5-9 Filter/Sort option 5-18
V
View menu 3-7 Clear List option 4-20, 5-21 Filter/Sort option 4-17, 5-16 Locate option 4-18, 5-21 using 4-15
P
permanent set 3-8 deleting 4-14 ltering/sorting for loading 4-9 listing 4-6 loading as a working set 4-5 Print menu 3-7 Options menu 5-25 sending requests to a le 5-28 sending requests to a printer 5-28 using 5-25 Propagate Quality box 3-12 Properties menu 4-21 editors 5-5 Properties module editor accessing from main module 5-3 accessing from Properties menu 5-2 Properties module editors 3-5
W
WEScalc 1-1 wild cards 4-18 working set 3-8 clearing 4-13 deleting 4-14 saving as a permanent set 4-11
Q
quality 3-12, 4-27, 5-12 variable 6-6 Quality override option 3-13
U0-8801
Index-2
9/98

U0 8801

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

U0 8801

Uploaded by

Copyright:

Available Formats

WEScalc Calculation Builder Users Guide

Section Title Page

Section 3. Calculation Builder Subsystem Overview

Section 4. Using the Main Module Menus

Table of Contents, Contd

Section 4. Using the Main Module Menus, Contd

Section 5. Using the Properties Module Menus

Table of Contents, Contd

Section 6. CBS Applications

6-4. 6-5. 6-6.

Appendix A. Supplied Numerical Library Functions

Table of Contents, Contd

Appendix A. Supplied Numerical Library Functions, Contd

Table of Contents, Contd

Section 3. Calculation Builder Subsystem Overview

Section 4. Using the Main Module Menus

Section 5. Using the Properties Module Menus

Table of Contents, Contd

Section 5. Using the Properties Module Menus, Contd

Section 6. CBS Applications

Table of Contents, Contd

Section 3. Calculation Builder Subsystem Overview

Section 6. CBS Applications

1-2. Contents of this Document

1-2. Contents of this Document

1-2. Contents of this Document

1-3. Reference Documents

Document Number U0-8100 U0-8110 U0-8200 U0-8500

2-2. Operational Requirements

2-2. Operational Requirements

2-3.1. Start-up from Operator WEStation

2-3.2. Start-up from Engineering WEStation

2-3.3. Start-up from a Command Tool

To start-up the CBS, type the following at the prompt ($):

Parameter -u -p -a wdpf wdpf wdpf

Any valid font style

Species character font style.

2-4. System Security and Restrictions

2-4. System Security and Restrictions

Set name Owner

Section 3. Calculation Builder Subsystem Overview

3-2. Design Philosophy

3-2. Design Philosophy

Main module Properties module

3-2. Design Philosophy

3-2.1. Calculation Builder Subsystem Main Module

Figure 3-1. Calculation Builder Subsystem (CBS) Main Window

From the Main module, the Properties modules can be accessed.

3-2. Design Philosophy

Filter/Sort Locate Clear List

3-2. Design Philosophy

3-2.2. Calculation Builder Subsystem Properties Module

3-2. Design Philosophy

Figure 3-2. Properties Editor - Output Variables

3-2. Design Philosophy

The Edit button is used to provide short-cuts when editing an item.

The Print button displays the Print menu.

3-3. Data Storage

3-3. Data Storage

3-3.1. Permanent Sets versus Working Sets

3-3. Data Storage

Name Description Owner Execution mode (off-line or on-line)

3-4. Modes of Operation