Sunteți pe pagina 1din 306

PDS Eden Interface

Reference Guide - Volume 2:Equipment

Document Number DPDS3-PB-200041A DPDS3-PB-200041B

Version PDS 7.3 PDS 8.0 SE

Date October 2004 November 2005

Pages 1-306 Cover/Notice

Copyright
Copyright 1984-2005 Intergraph Corporation. All Rights Reserved. Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement; contains confidential and proprietary information of Intergraph and/or third parties which is protected by copyright law, trade secret law, and international treaty, and may not be provided or otherwise made available without proper authorization.

Restricted Rights Legend


Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) of the Contractor Rights in Technical Data clause at DFARS 252.2277013, subparagraph (b) of the Rights in Computer Software or Computer Software Documentation clause at DFARS 252.227-7014, subparagraphs (b)(1) and (2) of the License clause at DFARS 252.227-7015, or subparagraphs (c) (1) and (2) of Commercial Computer Software---Restricted Rights at 48 CFR 52.227-19, as applicable. Unpublished---rights reserved under the copyright laws of the United States. Intergraph Corporation Huntsville, Alabama 35894-0001

Warranties and Liabilities


All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase contract, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties. Intergraph believes the information in this publication is accurate as of its publication date. The information and the software discussed in this document are subject to change without notice and are subject to applicable technical product descriptions. Intergraph Corporation is not responsible for any error that may appear in this document. The software discussed in this document is furnished under a license and may be used or copied only in accordance with the terms of this license. No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied by Intergraph or its affiliated companies. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.

Trademarks
Intergraph, the Intergraph logo, SmartSketch, FrameWorks, SmartPlant, INtools, MARIAN, and PDS are registered trademarks of Intergraph Corporation. Microsoft and Windows are registered trademarks of Microsoft Corporation. MicroStation is a registered trademark of Bentley Systems, Inc. ISOGEN is a registered trademark of Alias Limited. Other brands and product names are trademarks of their respective owners.

_ _______________
If You Need Assistance
Intergraph Online
Our web site brings you fast, convenient, up-to-the-minute information about Intergraphs products, services, and direction. Our web address is: http://www.intergraph.com.

If You Need Assistance

Support
For the lasest Support Services information, use a World Wide Web browser to connect to http://www.intergraph.com/ppo/services/support.asp. If you are outside of the United States, please call your local Intergraph office. The most upto-date list of international offices and distributors is available on the web at http://www.intergraph.com.

Intergraph Directory
The following numbers are only valid in the United States unless otherwise indicated. If you are outside the United States, please call your local Intergraph office.

Intergraph General Information


All countries 1-256-730-2000

Training Registration
1-800-766-7701 (U.S. Only) 1-256-730-5400 (Outside the U.S.)

Mailing Address
Intergraph Process, Power & Offshore 300 Intergraph Way Madison, Alabama 35758 U.S.A. You can also reach us by electronic mail at info@intergraph.com.

_ _______________
Documentation Contacts
We are constantly working on updates and improvements to the documents and other educational media. If you have any suggestions on where we can improve the documentation or where you think more information is needed, let us know. You can reach us by: Mail Intergraph Process, Power & Offshore Documentation Manager 300 Intergraph Way Madison, AL 35758

_ _______________
Table of Contents
If You Need Assistance ........................................................................................................ Intergraph Directory ............................................................................................................. General Conventions .................................................................................................................... Keyboard Conventions ......................................................................................................... Terminology ......................................................................................................................... 1. The Eden Basics ........................................................................................................................... Equipment Symbol Processor ...................................................................................................... Tutorial Definition Table ............................................................................................................. Forms Interface ............................................................................................................................ 2. Eden Language Structure ............................................................................................................. Beginning Statements .................................................................................................................. Ending Statements ....................................................................................................................... Begin ..................................................................................................................................... Begin EQP Category ............................................................................................................. Variables ...................................................................................................................................... Common Keywords ..................................................................................................................... Comments .................................................................................................................................... Operators ...................................................................................................................................... Expressions .................................................................................................................................. Functions ...................................................................................................................................... Primitives ..................................................................................................................................... Convert NPD to Subunits ..................................................................................................... Define Active Orientation ..................................................................................................... Draw Cone ............................................................................................................................ Draw Cylinder ...................................................................................................................... Draw Eccentric Cone ............................................................................................................ Draw Projected Rectangle .................................................................................................... Draw Projected Triangle ....................................................................................................... Draw Semi-Ellipsoid ............................................................................................................ Draw Sphere ......................................................................................................................... Draw Torus ........................................................................................................................... Abort ..................................................................................................................................... Convert Unit ......................................................................................................................... Define Active Point .............................................................................................................. Define Datum Point .............................................................................................................. Define Library .......................................................................................................................

Table of Contents

3 3 11 12 13 15 16 20 25 27 28 28 29 31 33 39 41 42 44 47 48 48 49 51 52 53 54 56 58 59 60 62 63 64 65 66

_ _______________
PDS Eden for Equipment - April 2002 Define Nozzle ....................................................................................................................... Define Orientation By Points ................................................................................................ Define Placepoint .................................................................................................................. Define Point .......................................................................................................................... Display Message ................................................................................................................... Display Tutorial .................................................................................................................... Draw Arc ............................................................................................................................... Draw Complex Surface ......................................................................................................... Draw Con Prism ................................................................................................................... Draw Curve ........................................................................................................................... Draw Ecc Prism .................................................................................................................... Draw Ecc Transitional Element ............................................................................................ Draw Ellipse ......................................................................................................................... Draw Line ............................................................................................................................. Draw Line String .................................................................................................................. Draw Proj Hexagon .............................................................................................................. Draw Proj Octagon ............................................................................................................... Draw Proj Shape ................................................................................................................... Draw Rectangular Torus ....................................................................................................... Draw Revolved Shape .......................................................................................................... Draw Shape ........................................................................................................................... Draw Transitional Element ................................................................................................... Get Arc Points ....................................................................................................................... Get Arc Size .......................................................................................................................... Get Date ................................................................................................................................ Get EQP Category ................................................................................................................ Get Line Size ........................................................................................................................ Get Point ............................................................................................................................... Move Along Arc ................................................................................................................... Move Along Axis ................................................................................................................. Move Along Line .................................................................................................................. Move By Distance ................................................................................................................ Move Data ............................................................................................................................ Move To Placepoint .............................................................................................................. Place COG ............................................................................................................................ Position Cursor ..................................................................................................................... Put Field ................................................................................................................................ Read Table ............................................................................................................................ Retrieve Nozzle Parameters .................................................................................................. Rotate Orientation ................................................................................................................. Start Complex Shape ............................................................................................................ Stop Complex Shape ............................................................................................................. Store Orientation ................................................................................................................... Store Nozzle Parameters ....................................................................................................... User Function ........................................................................................................................ User Function FLAT_OVAL_PRISM .......................................................................... User Function FLAT_OVAL_TOR .............................................................................. User Function FLAT_OVAL_SEG_TOR1 ................................................................... User Function FLAT_OVAL_SEG_TOR2 ................................................................... 68 70 71 72 73 74 76 77 80 81 82 84 85 86 87 88 90 92 93 94 96 97 98 99 100 101 102 103 105 106 107 108 109 110 111 113 114 115 117 119 120 121 122 123 124 125 126 127 128

_ _______________
User Function ROUND_SEG_TOR1 ............................................................................ User Function ROUND_SEG_TOR2 ............................................................................ User Function RECT_SEG_TOR .................................................................................. User Function RECT_FLAT_OVAL ............................................................................ User Function ROUND_RECT ..................................................................................... 3. Creating a New Equipment Component ...................................................................................... Setup for Equipment .................................................................................................................... Default Project Control Data ....................................................................................................... Extracting Sample Modules ......................................................................................................... Editing Modules ........................................................................................................................... Compiling New Modules ............................................................................................................. Revising Modules ........................................................................................................................ Basic Use of Forms ...................................................................................................................... Input Fields .................................................................................................................................. System-Defined Field Numbers ................................................................................................... Application Commands ............................................................................................................... User-Defined Application Commands .................................................................................. Additional Features of the Form Interface ................................................................................... 4. 5. Defining Symbols ........................................................................................................................ Eden Debugger ............................................................................................................................. Invoking the Debugger ................................................................................................................ Exiting the Debugger ................................................................................................................... Concurrent Display ...................................................................................................................... Debugger Commands ................................................................................................................... Switch Modes (ON and OF) ................................................................................................. Set Line Break (B) ................................................................................................................ Call Tutorial (C) ................................................................................................................... Deposit Global (DG) ............................................................................................................. Deposit Local (DL) ............................................................................................................... Examine Local Variables (EL) ............................................................................................. Examine Global Variables (EG) ........................................................................................... Appendix A: Appendix B: B.1 B.2 Codelist (CL330) ........................................................................................................ Equipment Data Definition .........................................................................................

Table of Contents

129 130 131 132 133 135 135 137 139 140 141 142 143 144 145 146 147 149 151 155 156 157 158 159 160 161 162 163 164 165 166 171 175 176 177 179

Equipment Group Database Table ............................................................................................. Equipment Nozzle Database Table ............................................................................................ EQP Eden Program Examples ....................................................................................

Appendix C:

_ _______________
PDS Eden for Equipment - April 2002 Example 1 (Use of loops): .................................................................................................... Example 2 (Use of arrays and loops): ................................................................................... Example 3 (Placing nozzles): ............................................................................................... Example 4 (Use of character string variables): ..................................................................... Example 5 (Graphic selection commands): .......................................................................... Example 6: ............................................................................................................................ Example 7: ............................................................................................................................ Example 8: ............................................................................................................................ Example 9: ............................................................................................................................ Appendix D: D.1 D.2 D.3 D.4 D.5 D.6 D.7 D.8 D.9 D.10 D.11 D.12 D.13 D.14 D.15 D.16 D.17 D.18 D.19 D.20 D.21 D.22 D.23 D.24 D.25 D.26 D.27 D.28 D.29 D.30 D.31 D.32 D.33 D.34 D.35 D.36 D.37 D.38 Delivered Parametrics ................................................................................................ 179 180 180 181 181 181 182 183 183 189 191 194 196 199 202 204 206 208 210 212 214 216 218 220 222 225 227 229 231 234 237 240 243 246 248 251 253 255 257 259 262 264 266 268 269 269 270 270

Circular Platform (A001) .......................................................................................................... Miscellaneous Platform (A003) ................................................................................................ Holes for Platforms (A015) ....................................................................................................... Holes for Miscellaneous Platforms (A016) ............................................................................... Thru Ladder A (A021) .............................................................................................................. Thru Ladder Details (A029) ...................................................................................................... Side Ladder A (A031) ............................................................................................................... Side Ladder Details (A039) ....................................................................................................... Stairs A (A041) ......................................................................................................................... Handrail A (A051) .................................................................................................................. Davit A (A061) ........................................................................................................................ Davit B (A063) ........................................................................................................................ Define (E200) .......................................................................................................................... Define Weights (E201) ............................................................................................................ Complex Vertical Cylindrical Equipment, Skirt (E205) ......................................................... Simple Vertical Cylindrical Equipment, Skirt (E210) ............................................................ Simple Vertical Cylindrical Equipment, Legs (E215) ............................................................ Spherical Equipment (E230) ................................................................................................... Complex Horizontal Cylindrical Equipment (E240) .............................................................. Simple Horizontal Cylindrical Equipment (E245) .................................................................. Horizontal Shell and Tube Exchanger (E305) ........................................................................ Kettle Exchanger (E307) ......................................................................................................... Vertical Shell and Tube Exchanger (E310) ............................................................................. Exchanger Ends (E319) ........................................................................................................... Double Pipe Exchanger (E320) ............................................................................................... Plate Exchanger (E325) ........................................................................................................... Air Cooler (E330) .................................................................................................................... Induced Draft Air Cooler Bay (E332) ..................................................................................... Forced Draft Air Cooler Bay (E334) ....................................................................................... Horizontal Rotating Equipment and Driver (E405) ................................................................ Vertical Rotating Equipment and Driver (E410) .................................................................... E1 Ends (E905) ....................................................................................................................... E2 Ends (E906) ....................................................................................................................... E3 Ends (E907) ....................................................................................................................... Complex Vertical Cylindrical Equipment (N205) .................................................................. Simple Vertical Cylindrical Equipment (N210) ...................................................................... Simple Vertical Cylindrical Equipment (N215) ...................................................................... Spherical Equipment (N230) ...................................................................................................

_ _______________
D.39 D.40 D.41 D.42 D.43 D.44 D.45 D.46 D.47 D.48 D.49 D.50 D.51 D.52 D.53 D.54 D.55 D.56 D.57 Complex Horizontal Cylindrical Equipment (N240) .............................................................. Simple Horizontal Cylindrical Equipment (N245) ................................................................. Horizontal Shell and Tube Exchanger (N305) ........................................................................ Kettle Exchanger (N307) ......................................................................................................... Vertical Shell and Tube Exchanger (N310) ............................................................................ Double Pipe Exchanger (N320) .............................................................................................. Plate Exchanger (N325) .......................................................................................................... Air Cooler (N330) ................................................................................................................... Horizontal Rotating Equipment and Driver (N405) ................................................................ Vertical Rotating Equipment and Driver (N410) .................................................................... Gear Cover (U850) .................................................................................................................. Round Torus Miter (U860) ..................................................................................................... Rectangular Torus Miter (U861) ............................................................................................. Vertical Oval Torus Miter (U862) ........................................................................................... Flat Oval Torus Miter (U863) ................................................................................................. Flat Oval Prism (U870) ........................................................................................................... Flat Oval Torus (U880) ........................................................................................................... Rectangular 90 Cone Torus with Offset (U881) ..................................................................... User Projected Shape (USRPRJ) .............................................................................................

Table of Contents

271 271 272 272 273 273 274 274 275 275 276 278 280 282 284 286 288 290 292 293 301

Glossary ............................................................................................................................................... Index ....................................................................................................................................................

_ _______________
PDS Eden for Equipment - April 2002

10

_ _______________
General Conventions
This document contains many visual cues to help you understand the meaning of certain words or phrases. The use of different fonts for different types of information allows you to scan the document for key concepts or commands. Symbols help abbreviate and identify commonly used words, phrases, or groups of related information.

Table of Contents

Typefaces
Italic Indicates a system response, which is an explanation of what the software is doing. For example, The text is placed in the viewing plane. Bold Indicates a command name, parameter name, or dialog box title. Command paths are shown using an arrow between command names. For example, Choose File > Open to load a new file. Sans serif Indicates a system prompt or message, which requires an action be taken by the user. For example, Select first segment of alignment Bold Typewriter Indicates what you should literally type in. For example, Key in original.dat to load the ASCII file. Normal Typewriter Indicates an actual file or directory name. For example, The ASCII report is stored in the layout.rpt file.

11

_ _______________
PDS Eden for Equipment - April 2002

Symbols
This document uses the following symbols to represent mouse buttons and to identify special information: <C> <D> <R> <T> Command button Data button (usually the left mouse button) Reset/reject button (usually the right mouse button) Tentative button (usually the center mouse button) Note Important supplemental information.

Warning Critical information that could cause the loss of data if not followed.

Technical tip or information provides information on what the software is doing or how it processes information. Map or path shows you how to get to a specific command or form.

More information indicates there is additional or related information.

Need a hint used with activities and labs, provides a tip or hint for doing the exercises.

Keyboard Conventions
The following list outlines the abbreviations this document uses for keyboard keys and describes how to use them in combination. You can make some menu selections through the use of keyboard accelerators, which map menu selections to key combinations. ALT CTRL DEL ENTER ESC CTRL+z ESC,k Alternate key Control key Delete key Enter key Escape key To hold down the Control key and press Z. To press the Escape key, then K.

12

_ _______________
Terminology
Click To use a mouse or key combination to pick an item that begins an action. For example, Click Apply to save the changes. Select To mark an item by highlighting it with key combinations or by picking it with your cursor. Selecting does not initiate an action. After selecting an item, you click the action you want to affect the item. For example, Select the file original.dat from the list box, then click Delete to remove it from the directory. In addition, you would select items to define parameters, such as selecting toggle buttons. This also applies to selecting graphic elements from the design file. For example, Select the line string to define the graphic template. Tentative-select To place a tentative point on an existing graphic element in a design file. If you are using the CLIX operating system, you tentative-select by double-clicking with a mouse or pressing <T> on a hand-held cursor. If you are using the Windows NT operating system, you tentative-select by pressing a left-button, right-button chord. To select and execute a command by clicking the mouse or hand-held cursor button twice in rapid succession. This term implies that you are clicking the data button (<D>) as part of a menu or dialog box action. For example, Double-click on the file original.dat to load it into the new surface. Drag To press and hold the data button (<D>) while moving the mouse or hand-held cursor. To key a character string into a text box. To type in data and press ENTER to enter the data and execute the default action. In a dialog box, pressing TAB after keying in data will enter the data and move the cursor to the next field.

Table of Contents

Double-click

Type Key in

13

_ _______________
PDS Eden for Equipment - April 2002

14

_ _______________
1. The Eden Basics
Eden is a high-level symbol definition language modeled on the FORTRAN programming language. It allows you to design your own symbols for equipment, piping, instrumentation, and specialty items. The Eden language syntax is not case sensitive. You can write code with whatever case conventions make it easiest for you to read. While you do not need a programming background to write Eden programs, any programming experience is highly recommended. Most of the symbol definition functions are built into Edens command structure. This high-level command structure makes it easier to share code among several different symbol definitions. Eden is flexible enough to allow you to design codes specific to your companys needs, yet offers predefined subroutines, called primitives, which carry out functions often repeated within symbol definitions. For example, the following primitive draws a cone with a length of X units, a diameter at the active point (first end) of Y units and a diameter at the opposite end of Z units: Call Draw_Cone (X, Y, Z) The output produced will look similar to the following graphic:

The Eden Basics

1.Basics

You can call up to five nested subroutines within a program.

15

_ _______________
PDS Eden for Equipment - April 2002

Equipment Symbol Processor


The symbol processor is the Eden code that defines an equipment component. It calls all the subroutines or modules that activate forms, check input data, assign placement points, and place graphics. The first line of an Eden module defines the module name. The following statement is used in the Eden modules to indicate a symbol processor module: Symbol_Processor MODULE NAME The module name should be entered using UPPER CASE characters. For example: Symbol_Processor APUMP The following example symbol processor defines a horizontal pump:
SYMBOL_PROCESSOR E405 ! #TYPE =Pumps,All equip #DESC =Hor Rot Equip & Driver ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! E405 : Horizontal Rotating Equipment and Driver ! ! APPLICATION COMMAND ! 4075 - HELP (SPECIFIC) ! 4074 - HELP (GENERAL) ! 4073 - DEFINE ! 4072 - DEFINE CG ! 4051 - RETURN (from help menu) ! 4052 - UPDATE DATE ! ! SYSTEM DEFINED COMMAND USED ! 4001 - EXIT ! 4002 - ACCEPT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! INT2 accepted LOCATION pointzero [3] ! pointzero = POINT_0 Dimension [100] = 0.0 accepted = 0 tutname = E405 Cstring [29] = E405 Call Get_Date( Cstring [38] ) ! Do While ( accepted .EQ. 0 ) Call Display_Tutorial ( tutname ) Call Put_Field( Cstring [29], 19 )

16

_ _______________
If( LAST_INP_TYPE .EQ. USER_KEYIN ) then If( LAST_INP_NUM .GE. 2 .AND. LAST_INP_NUM .LE. 18 ) then Call User_Function ( E405_CHECK ) accepted = Dimension [100] Else accepted = 0 Endif Else If( LAST_INP_TYPE .EQ. APPLICATION_CMD ) then if( LAST_INP_NUM .eq. 4075)then Call Display_Tutorial ( H405 ) accepted = 0 else if( LAST_INP_NUM .eq. 4074)then Call Display_Tutorial ( H200A ) accepted = 0 else If( LAST_INP_NUM .eq. 4073)then Call User_Function (E200) accepted = 0 Else If( LAST_INP_NUM .eq. 4072)then Call User_Function (E201) accepted = 0 Else If( LAST_INP_NUM .eq. 4052 )then Call Get_Date( Cstring [1] ) accepted = 0 Else accepted =1 Endif Endif Endif Endif endif else accepted = 1 Endif Endif Enddo ! ! define PLACE POINTS and DATUM POINTS Call Define_Active_Orientation ( NORTH, UP ) Call Define_Placepoint ( PP1, POINT_0 ) Call Define_Datum_Point ( DP [1], POINT_0) offset = Dimension [4] + Dimension [11] Call Move_Along_Axis ( - offset, SECONDARY ) Call Define_Placepoint ( PP2, POINT_0 ) Call Define_Datum_Point ( DP [2], POINT_0) ! Draw base plate base_length = Dimension [1] base_width = Dimension [2] + Dimension [3] base_thickness = Dimension [4] offset_base = 0.5 * Dimension [1] + Dimension [5] offset_norm_base = 0.5 * base_width - Dimension [3]

Equipment Symbol Processor

1.Basics

17

_ _______________
PDS Eden for Equipment - April 2002
Call Move_To_Placepoint (PP2) Call Move_Along_Axis ( offset_base, PRIMARY ) Call Move_Along_Axis ( offset_norm_base, NORMAL ) Call Rotate_Orientation ( 90.0, NORMAL ) If( base_length .gt. 0.0 .and. base_width .gt. 0.0 .and. base_thickness .gt. 0.0 ) then Call Draw_Proj_Rectangle ( base_length, base_width, base_thickness ) Else Call Abort (0) Endif ! Draw driver driver_length = Dimension [6] + Dimension [7] driver_width = Dimension [8] + Dimension [9] driver_thickness = Dimension [10] + Dimension [11] vert_offset_driver = - Dimension [11] horiz_offset_driver = 0.5 * driver_length - Dimension [6] norm_offset_driver = 0.5 * driver_width - Dimension [9] Call Move_To_Placepoint (PP1) Call Move_Along_Axis ( vert_offset_driver, SECONDARY ) Call Move_Along_Axis ( horiz_offset_driver, PRIMARY ) Call Move_Along_Axis ( norm_offset_driver, NORMAL ) Call Rotate_Orientation ( 90.0, NORMAL ) If( driver_length .gt. 0.0 .and. driver_width .gt. 0.0 .and. driver_thickness .gt. 0.0 ) then Call Draw_Proj_Rectangle ( driver_length, driver_width, driver_thickness ) Endif ! Draw shaft Call Move_To_Placepoint (PP1) Call Move_Along_Axis ( Dimension [7], PRIMARY ) If( Dimension [12] .gt. 0.0 .and. Dimension [13] .gt. 0.0 ) then Call Draw_Cylinder ( Dimension [12], Dimension [13] ) Endif ! Draw housing house_length = Dimension [14] house_width = Dimension [15] + Dimension [16] house_thickness = Dimension [17] vert_offset_house = - Dimension [11] horiz_offset_house = 0.5 * house_length + Dimension [12] + Dimension [7] norm_offset_house = 0.5 * house_width - Dimension [16] Call Move_To_Placepoint (PP1) Call Move_Along_Axis ( vert_offset_house, SECONDARY ) Call Move_Along_Axis ( horiz_offset_house, PRIMARY ) Call Move_Along_Axis ( norm_offset_house, NORMAL ) Call Rotate_Orientation ( 90.0, NORMAL ) If( house_length .gt. 0.0 .and. house_width .gt. 0.0 .and. house_thickness .gt. 0.0 ) then Call Draw_Proj_Rectangle ( house_length, house_width, house_thickness ) Endif ! define CGs Call Move_To_Placepoint ( PP1 ) Call Place_Cog (DRY, Dimension [71], Dimension [72], Dimension [73]) Call Place_Cog (OPERATING_1, Dimension [74], Dimension [75], Dimension [76]) Call Place_Cog (OPERATING_2, Dimension [77], Dimension [78], Dimension [79])

18

_ _______________
Call Move_To_Placepoint ( PP2 ) STOP END

Equipment Symbol Processor

1.Basics

19

_ _______________
PDS Eden for Equipment - April 2002

Tutorial Definition Table


You can create or modify tutorial definition tables using an ASCII editor. The first line in a tutorial definition table defines the tutorial name. This entry must begin in column 1. Each input field in a tutorial must have a corresponding row in a tutorial definition table. Each row includes seven entries: field number, data type, global variable, nozzle number, input attribute, default string, and field name. 1. 2. field number datatype the tutorial field number defining the form (gadget number). the data type of the field. This entry is a number whose values include: 1 = linear dimension 2 = angular dimension 3 = integer (no units) 4 = length for NOZ_LENGTH1 5 = length for NOZ_LENGTH2 6 = length for NOZ_RADIUS 7 = equipment entity database attribute 8 = nozzle entity database attribute 9 = field to receive values for CSTRING_x variables 3. number a table data entry which the system interprets differently for each data type: For data types 1, 2, and 3, number is a value that can range from 1 to 100 defining the global variable DIMENSION_n, which holds the fields input. For example, if number is set to 10 in the table, then any input into the field is placed by the software into DIMENSION_10. The symbol can then refer to DIMENSION_10 and use it in any of its calculations. For data types 4, 5, and 6, this field is ignored. For more information on the Equipment Modeling DDL, refer to Appendix C, Equipment Data Definition. For data types 7 and 8, number defines the attribute number in the appropriate database entity to which the field inserts input. These numbers provide the link to the database. Use the following numbers for the respective attribute:
equip_group ( datatype = 7 ) 1 2 3 4 5 6 , , , , , , equip_no equip_descr_1 equip_descr_2 tutorial_no equip_class dry_weight , , , , , , character(30) character(40) character(40) character(6) character(2) double

20

_ _______________
7 8 9 10 11 12 , , , , , , oper_weight_1 oper_weight_2 insulation_thk construction_stat equipment_division approval_status , , , , , , double double double short short short , standard note 130 , standard note 69 , standard note 35 equip_nozzle ( datatype = 8 ) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 , , , , , , , , , , , , , , , , , , , , , , , , nozzle_no , character(10) equip_index , integer nominal_piping_dia , short rating , character(8) preparation , short , standard note 330 piping_mater_class , character(16) unit_no , character(12) fluid_code , short , standard note 125 unit_code , character(2) line_sequence_no , character(6) heat_tracing_reqmt , short , standard note 200 heat_tracing_media , short , standard note 210 insulation_purpose , short , standard note 220 insulation_thk , double table_suffix , short , standard note 576 service , character(20) schedule_thickness , character(8) nor_therm_growth_X , double nor_therm_growth_Y , double nor_therm_growth_Z , double alt_therm_growth_X , double alt_therm_growth_Y , double alt_therm_growth_Z , double construction_stat , short , standard note 130

Tutorial Definition Table

1.Basics

For example, if the data type is 7 and number is 1, then any input to this field is put in the equipment entity, attribute number 1 (or equipment name) field of the record that is written to the database when the component is placed. Refer to the model database DDL for a complete description of each attribute in both the equipment and nozzle entities. For data type 9, number specifies the CSTRING variable to receive the value. 4. nozzle a number that identifies the nozzle with which a field will be associated. This field is only needed for data types 4, 5, 6, and 8. Each nozzle in a parametric symbol must be assigned a unique number. (Refer to the DEFINE_NOZZLE and the RETRIEVE_NOZZLE_PARAMETERS primitives.) This number is the same as the RETRIEVE_NOZZLE_PARAMETERS primitive. Each nozzle in a parametric requires a set of fields for defining the nozzle size, rating, facing, tag, possibly length, and possibly other database attributes. The nozzle number allows the software to distinguish one nozzle tag input field or one nozzle size input field from another.

21

_ _______________
PDS Eden for Equipment - April 2002 5. attributes an entry that describes the input field itself. The available values for this item include: 123user input is optional. user input is required. user input is optional but causes return to the symbol. This type of field has also been called a terminated key-in field. Refer to the DISPLAY_TUTORIAL primitive for more information on how to handle these fields from the symbol. user input is required but causes return to the symbol. This is also a terminated key-in field.

4-

Example: A tutorial has a field for which the attribute entry in the tutorial definition table contains the number two. You are not allowed to select the ACCEPT field to exit from the tutorial until you have provided a valid input for the field. 6. default an entry allowing you to define a default for a particular tutorial input field. The entry can take on several forms. All of the expressions outlined below must be surrounded by single quotes in the tutorial definition table. The default types include: "XXX-" A literal string used for defaulting character string input fields. The double quote must be included as a delimiter. Example: "101-C" Use the current value of tutorial field number xxx as the default for this field. Note that user-defined field numbers can range from 1 to 200. (System-defined fields range from 201 to 256 and may not appear in default expressions.) Example: F23 Use the contents of DIMENSION_xxx as the default for this field. There is no practical limit on the number of tutorials that a symbol can activate. Therefore, any calculations that were made before the symbol definition activated the current tutorial can provide defaults for that tutorial. Example: D23 Use the contents of CSTRING_xx as the default for this field. Decimal constant with or without a decimal point. All distances are assumed to be in English subunits (inches). If the default is a metric constant, then the constant should be given a suffix of M. Example: 125M

Fxxx-

Dxxx-

Cxx- xx.x-

22

_ _______________
expr-

Tutorial Definition Table

Combine any of the above three default types to form a valid arithmetic expression. Valid operators are +, -, *, /, and . Use parentheses to alter order of evaluation. An expression is not evaluated until all fields are defined. Example: (F1+F2)/2+30. This expression is not computed until both fields 1 and 2 are defined.

1.Basics

Default expressions are currently limited to 20 characters in length. Example: 101-C - default for an equipment item name field Example: F1/2+10 - use the first input to field 1 divided by 2 plus 10 inches as the default. 7. name defines an alphanumeric name for the field which will be used in future software releases for reporting and alphanumeric placement of parametrics. The field name can be a maximum of 10 characters in length.

The gadget numbers 1-10 (Column 1 - Field) in the tutorial definition table correspond to gadget numbers 951-960 on the form. 1 = 951 2 = 952 3 = 953 4 = 954 5 = 955 6 = 956 7 = 957 8 = 958 9 = 959 10 = 960 Gadget numbers 11, 12, 13 ... remain 11, 12, 13 ...

Example
The following example tutorial definition table displays a piece of equipment with 7 dimensional inputs (rows 1-7), 4 nozzles (rows 11-26), and 3 fields for equipment entity database attributes (rows 8-10).
EXCHNG 1, 2, 3, 4, 5, 6, 7, 1, 1, 1, 1, 1, 1, 1, 1, 2, 3, 4, 5, 6, 7, , , , , , , , 1, 1, 1, 1, 1, 1, 1, 30, , F2, , , , , DIA NOZ1 NOZ2 NOZ3 SUPP1 SUPP2 PROJ

23

_ _______________
PDS Eden for Equipment - April 2002
8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 7, 7, 7, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 1, 2, 5, 1, 3, 4, 5, 1, 3, 4, 5, 1, 3, 4, 5, 1, 3, 4, 5, , , , 20, 20, 20, 20, 19, 19, 19, 19, 18, 18, 18, 18, 17, 17, 17, 17, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, , , "C", , , , 21, , F12, F13, 21, , , , 21, , F20, F21, 21, EQPNAM DESCR CLASS TAG1 SIZE1 RATING1 FACING1 TAG2 SIZE2 RATING2 FACING2 TAG3 SIZE3 RATING3 FACING3 TAG4 SIZE4 RATING4 FACING4

In the tutorial above, the default value for field 1 on the tutorial is 30 inches. Since the default value for field 3 is F2, your first input to field 2 is displayed in field 3 by the system. Since the second column is equal to 1 for fields 1 through 7, they are all linear dimension inputs. Your input into these fields is placed in variables DIMENSION_1 through DIMENSION_7. Field 8 collects your equipment ID (equipment entity, attribute number 1). In general, it is easier to place the symbol if the equipment ID field is put directly on each tutorial. There is a set of four fields on the tutorial for each nozzle defined in the parametric (tag, size, rating, end prep). This is the minimum number of fields that can be present to allow complete definition of a nozzle. If you do not define the nozzle tag for a particular nozzle, then that nozzle will not be placed. Nozzle tag numbers cannot be defaulted.

Since there is no field on the tutorial that explicitly collects individual nozzle lengths, the symbol logic must calculate them. Each nozzle has a default end prep of 21 (nozzle entity, attribute number 5). This is a code-listed attribute in the database. The value 21 is the codelist value for a raised face. The default expression can also be entered as "RFFE", which is the codelist text for raised face end prep.

24

_ _______________
Forms Interface
Forms in equipment modeling serve to collect input via key-in fields or command buttons. They also provide feedback information to the user through message fields. Input fields and application commands have unique identification numbers. These numbers are used with the tutorial definition table (TDF) to communicate to the software the use for each field or command. The data entered through the forms serves as the input that defines the values of the global variables used by the symbol processor. When a new equipment item is defined through Eden, a form has to be created to define the components parameters. DBAccess is used to build forms.

Forms Interface

1.Basics

25

_ _______________
PDS Eden for Equipment - April 2002

26

_ _______________
2. Eden Language Structure
You do not need to know FORTRAN to use the Eden language. Eden is similar to the FORTRAN programming language. Therefore, the general rules for evaluating expressions in Eden are identical to those in FORTRAN.

Eden Language Structure

Eden definitions are usually simpler than FORTRAN programs. To use Eden, you must be able to visualize the symbol (in 3D) that you want to develop.

2.Structure

The Eden language structure incorporates: Statements Beginning Ending Variables Local Global Keywords Operators Arithmetic Relational Logical Expressions Functions Primitives (or Subroutines)

27

_ _______________
PDS Eden for Equipment - April 2002

Beginning Statements
Beginning statements define the types of modules being entered. Names within the single quotes must be all upper case. SP - Symbol_Processor 6CHAR UF - User_Function_Definition 28CHAR

Examples
Symbol_Processor A001 User_Function_Definition A001_CHECK

Ending Statements
Ending statements mark the end of the module in which the system has been processing. Ending statements in the symbol and subsymbol processor include: Stop End Ending statements in the user functions include: Return End

28

_ _______________
Begin
The Begin primitive allows you to generate graphics for 2D shadow, envelopes, various light steel categories, and holes.

Begin

Syntax
Call Begin <category>

Options
category keyword specifying the graphics category you want to place. Allowable category keywords for each class of graphics include: Regular equipment graphics EQUIPMENT This is executed at the beginning of symbol execution. It is needed if you have placed some other category and want to resume equipment graphics.

2.Structure

Interference envelope graphics ENVELOPE_MAINTENANCE_HARD ENVELOPE_MAINTENANCE_SOFT ENVELOPE_ACCESS_HARD ENVELOPE_ACCESS_SOFT ENVELOPE_SAFETY_HARD ENVELOPE_SAFETY_SOFT ENVELOPE_CONSTRUCTION_HARD ENVELOPE_CONSTRUCTION_SOFT 2D footprint graphics SHADOW Light steel graphics LADDER PLATFORM HANDRAIL MISCELLANEOUS

29

_ _______________
PDS Eden for Equipment - April 2002 Holes HOLE NOHOLE The keywords HOLE and NOHOLE are different from other keywords in that they do not represent a separate category of graphics. You can include Begin(HOLE) within another Begin category. A Begin(HOLE) remains in effect across other Begin calls until a Begin(NOHOLE) is reached. Hole graphics are given the level and symbology of holes.

Surface Type SOLID SURFACE The keywords SOLID and SURFACE set the active surface type of subsequent graphics. The default is SOLID. This results in capped surfaces. With the SURFACE keyword, you can place uncapped shapes such as open-ended cylinders.

Except for nozzles and placepoints, all graphics assume the level and symbology of the last executed Begin statement. Placepoints always belong to the equipment/parametric cell. If your symbol executes no EQUIPMENT category graphics, an otherwise empty parametric equipment cell is created for housing the placepoints. A Begin statement can repeat itself any number of times. After execution, it becomes the active category for subsequent element placement calls. A (non-EQUIPMENT) Begin statement must be followed by at least one call to generate graphic elements; otherwise that Begin statement will have no effect on symbol graphics.

30

_ _______________
Begin EQP Category
Syntax
Begin_EQP_Category (subcategory)

Begin EQP Category

The Begin EQP Category primitive allows you to create graphics for various EQUIPMENT subcategories each having its own level and symbol.

Options
subcategory is a character string indicating the subcategory. There are presently 20 subcategories available. A valid subcategory must be one that has been defined via the Project Administrator Module. Alternatively, you can use one of the following: EQP_CATEGORY_1, EQP_CATEGORY_2, .. .. .. EQP_CATEGORY_20 The argument is checked only when you place the symbol and not during compilation.

2.Structure

Restrictions
You can use this call only within the Begin (EQUIPMENT) call. Also, you cannot make this call when Draw Complex Surface or Start Complex Shape is in progress. By default, the Begin (EQUIPMENT) and Begin EQP Category (EQP_CATEGORY_1) calls are active when a symbol executes.

Example
The following example is a valid code fragment:
Call Begin (ENVELOPE_MAINTENANCE_HARD) .. .. Call Begin (EQUIPMENT) Call Begin_EQP_Category (PUMPS) Call Draw_Complex_Surface (4, 0) .. .. Call Begin (HOLE) .. ! place envelope graphics ! to set category next ! PUMPS must be a valid ! category for project ! pump graphics ! HOLE is allowed anywhere

31

_ _______________
PDS Eden for Equipment - April 2002
.. Call Draw_Complex_Surface (-99, 0) ! end pump

The following example is not a valid code fragment:


Call Begin (LADDER) Call Begin_EQP_Category (PUMPS) .. .. ! Begin (EQUIPMENT) not active

This example is not a valid code fragment.


Call Draw_Complex_Surface (4, 0) Call Begin_EQP_Category (PUMPS) ! cannot change within surface

32

_ _______________
Variables
Variables in Eden can be either local or global. They can contain either numeric or alphanumeric data. Internally, numeric data is stored as REAL*8 (double precision). If a different data type is required in the context of an expression, then the conversion is performed at the time the expression is evaluated. Variable names can be either upper or lower case. Symbols tend to be easier to read when you use all lower case for local symbols and all upper case for global symbols or vice versa.

Variables

Examples:
2.Structure
When converting a floating point number to an integer, the fractional part of the floating point number is truncated. A variable used in a logical expression evaluates to TRUE when the value of the variable is 1 and 0 when the logical value is FALSE. Variables that hold values representing distances are assumed to be in subunits. A variable containing the value 25 represents 25 inches in an English unit design file and 25 millimeters in a metric unit design file. Be careful when using hard coded numbers or when using the system_of_units keyword.

Local Variables
Local variables are user defined and declared in the symbol definition. You can refer to a local variable only when you are in the same module as the local variable. Local variable names are formed using alphanumeric (a-z), numeric (1-9), and special (_ and $) characters. They must begin with an alphanumeric character and must be less than or equal to 31 characters in length. The Eden compiler does not verify the spelling of local variables within call statements. It assumes a null value for the misspelled variable at component placement time. The Eden language refers to constants as local variables. Both character strings and numeric constants are valid; however, character string constants must be surrounded by single quotes. In most cases, character strings and constants are case sensitive. Thus, a and A are interpreted differently.

Examples:
diameter shell_thickness projection_1 25 13.25 A TEXT STRING radius [2]

33

_ _______________
PDS Eden for Equipment - April 2002 Only in Pipe Support and Equipment Modeling can you declare local variable types. The variable types default to either CHARACTER or REAL depending on the context. To override this default, you can use a local variable type declaration statement anywhere before the variable(s) is (are) actually referenced. Variable types INT2, R8, and LOCATION are recognized by the compiler.

Example:
In the following example, variables a, B, and C are declared as type short integers. They hold values ranging from -32767 to 32767. Int2 a Int2 B, C

Example:
In the example below, variable d is declared as a type REAL, capable of holding decimal fractional values. This is the usual default type for numeric variables. However, explicit typing to this category may be necessary to declare local arrays. R8 d As a recommendation, all declaration statements should be placed at the very beginning of the symbol code and not interspersed among statements to be executed during symbol placement. This improves program readability. Also in Pipe Support and Equipment Modeling, referencing a variable using subscripts is extremely useful when coding repetitive statements such as the body of a loop. Prior to use, variables must appear in a type declaration in which its subscript or index range is also specified.

Example:
In the example below, D is an array of 5 short integer variables stored contiguously. The individual elements are referenced as D[1], D[2], D[3], D[4], and D[5]. You can also use a variable or an arithmetic expression for indexing, such as D[i] where i is a value between 1 and 5, or D [i+1] where i is a value between 1 and 4. INT2typed variables are particularly useful in DO loops and array indexing where integral numbers are necessary and roundoffs must be avoided. They are also stored much more efficiently than REAL variables. Int2 D[5], EF[6]

Example:
Below, LENGTHS is an array of 10 REAL variables. They are referenced as LENGTHS [1] ... LENGTHS [10] R8 LENGTHS [10]

34

_ _______________
Example:
In the following example, PT is declared as a buffer with four locations. Location PT [12] where PT [1], PT [4], PT [7] PT [10] are x-coordinates PT [2], PT [5], PT [8] PT [11] are y-coordinates PT [3], PT [6], PT [9] PT [12] are z-coordinates

Variables

2.Structure

These variables provide alternate locations for the point values that you do not want to store in POINT_1 ... POINT_24... POINT [125]. You will also find them useful in accessing individual components of a location. (Refer to the REPLACEMENT STATEMENT section.) Location PT [12] An array-formatted variable may also be referenced without the index. In this case, the first element of the array is accessed. For example, PT and PT [1] are functionally the same in the above example. Currently, only single expression subscripts (that is; single dimensioned arrays) are possible.

Global Variables Common to Piping, Equipment, and Pipe Support Modeling


Global variables are system-defined names allowing you to refer to them at any subroutine level. More specifically, you can use them for passing values between subroutine levels or for communicating input values to the symbol. The following list shows the global variables common to all Eden applications. Refer to the application-specific section for detailed information concerning specific global variables. Global variables are system-defined. You cannot declare global or subscripted global variables.

Input_n

(Input_1 through Input_20) An array with up to 20 variables used to define the input parameters for table lookups. (Input_11 through Input_20 are specifically designed for user function arguments in equipment and pipe support modeling.) (Output_1 through Output_20) An array with up to 20 variables where the results of the table lookup are stored. (Output_11 through Output_20 are specifically designed for user function return arguments in equipment and pipe support modeling.) (Dimension_1 through Dimension_100 for equipment and pipe supports, Dimension_1 through Dimension_20 for piping) General purpose variables used for communicating input to the symbol logic. You can also use these variables for passing values between subroutines or simply for local storage. (Dimension_20 is for angle; Dimension_1 through Dimension_19 is for linear piping.) Variable containing the current item pressure rating value.

Output_n

Dimension_n

Pr_Rating_n

35

_ _______________
PDS Eden for Equipment - April 2002 Nom_Pipe_D_n Variable containing the current item nominal pipe diameter. This variable contains the nominal diameter in coded units. A special primitive is provided to help you convert from coded units to subunits. Variable containing the current item end preparation generic type (BLT, MAL, FEM). This is a read-only variable. Variable containing the current item end preparation termination type (21, 22, and 23 will fall into Term_Type_1=20). This is a read-only variable. Variable containing the current item standard type value. This is a read-only variable and is a function of TABLE_SUFFIX. Gen_Type_n

Term_Type_n

Standard_Type

Global Variables Common to Equipment and Pipe Support Modeling


The following list contains global variables common to Equipment and Pipe Support Modeling. For more information on global variables, refer to the System-defined Subroutines section and the Eden User Interface section. Point_n Point [n] (Point_1 - Point_24) Names representing points that have been defined or saved for later use in a symbol definition. The n in [n] can be between 0 and 125. Variable that contains an identifier for the active library of dimension tables. This is a read-only variable. (Cstring_1 through Cstring_40) Names representing global character variables. Each name can contain a maximum of 50 characters. Refer to the Dsplay_Tutorial primitive in the Eden Primitives section. Contains the nominal piping diameter system of units defined for the model file. You can test this variable against the keywords ENGLISH and METRIC. This is a read-only variable.

Act_Lib

Cstring_n

Last_Inp_Type Last_Inp_Num NPD_Unit_Type

Global Variables (EQP Specific)


The following list contains global variables specific to Equipment Modeling. For more information on global variables, refer to the System-defined Subroutines section and the Eden User Interface section. PP_Location_n (PP_Location_1 - PP_Location_10) Names representing the point locations that have been defined as place points in the course of a symbol definition.

36

_ _______________
End_Prep Noz_Length1 Variable containing the current nozzle end preparation value. Variable containing the current nozzle length value. This variable applies to type 2 and 3 nozzle only. For type 3, the length is from the end of the nozzle connected to the vessel to the centerline of the bend. Variable containing the current second nozzle length value. This variable applies to type 3 nozzles only and measures the length from the face of the nozzle to the centerline of the bend. Variable containing the current nozzle bend radius. Applies to type 3 nozzles only. Variable containing the current nozzle table suffix value. (PP_Primary_1 through PP_Primary_10) Names representing orientation of primary axes for place points defined during symbol placement. (PP_Secondary_1 through PP_Secondary_10) Names representing orientation of secondary axes for place points defined during symbol placement. (PP_Normal_1 through PP_Normal_10) Names representing orientation of normal axes for place points defined during symbol placement.

Variables

Noz_Length2

Noz_Radius

2.Structure

Table_Suffix PP_Primary_n

PP_Secondary_n

PP_Normal_n

Subscripted Global Variables


In Equipment and Pipe Support Modeling, a global variable can contain an index value as part of the variable name even though the index value is not a variable. This is known as subscripted global variables. For example, Dimension_10 and Point_3 are global variables whose index values are 10 and 3, respectively. You can reference the same location using subscripted global variables, which contain an index either as a variable or as an expression. For example, Dimension [10] and Point [3] are subscripted global variables whose index values are 10 and 3, respectively. They are equivalent to Dimension_10 and Point_3. Subscripted global variables are useful when using loops. Below is a list comparing the two methods of accessing global variables with indexes: Subscripted Global Variable (variable index) cstring [1] ... cstring [40] dimension [1] ... dimension [100] dp [1] ... dp [30] Global Variable with non-variable index cstring_1 ... cstring_40 dimension_1 ...dimension_100 dp1 ... dp30

37

_ _______________
PDS Eden for Equipment - April 2002 inputs [1] ... inputs [20] outputs [1] ... outputs [20] pp [1] ... pp [10] point [0] ... point [125] (point [0] ... point [24] pp_primary [1] ... pp_primary [10] pp_secondary [1] ... pp_secondary [10] pp_normal [1] ... pp_normal [10] pp_location [1] ... pp_location [10] input_1 ... input_20 output_1 ... output_20 pp1 ... pp10

point_0 ... point_24) pp_primary_1 ...pp_primary_10 pp_secondary_1 ...pp_secondary_10 pp_normal_1 ... pp_normal_10 pp_location_1 ...pp_location_10

A global variable referenced without a subscript causes the first element to be accessed. Thus, Point and Point [0], Dimension and Dimension_1 are functionally equivalent.

38

_ _______________
Common Keywords
Eden uses keywords for labeling specific values or groups of values. All keywords except TRUE and FALSE can appear as arguments in system-defined primitives (or subroutines). Keywords can be upper or lower case. For consistency, this reference guide displays keywords in upper case. TRUE FALSE MALE FEMALE BOLTED PRIMARY SECONDARY NORMAL ENGLISH METRIC ACTIVE_POINT POINT_0 Logical true. Used in logical expressions. Logical false. Used in logical expressions. Keywords for generic end preparation.

Common Keywords

2.Structure

Keywords used to identify or refer to individual refresh tee axes.

Names used to define the units of a constant used in the symbol definition.

Name representing the location of the active point in the local coordinate system defined by the symbol. These names can be used interchangeably. Keywords used to define directions in the local coordinate system defined by the symbol definition.

EAST WEST NORTH SOUTH UP DOWN PP1 - PP10

Names representing symbol place point locations and orientations. A maximum of 10 place points can be defined for 1 symbol. Names representing equipment datum point locations and orientations. Module type of all equipment modeling Eden definitions. It is used in the first statement of a symbol definition. Names representing the different libraries that can be made active in a symbol definition. Terminates module execution normally. If it encounters either a RETURN or STOP in a user function, the system returns control to the calling module.

DP1 - DP30 SYMBOL_PROCESSOR

ENG_COMM_LIB EQP_TABLES RETURN STOP

39

_ _______________
PDS Eden for Equipment - April 2002 END Must be the last line in the symbol source code. If execution reaches the END statement, an implicit STOP is executed. There are other keywords primarily used in specific subroutine calls. These keywords can be found in the subsections that describe their associated primitives. Keywords APPLICATION_CMD and USER_KEYIN are described under the DISPLAY_TUTORIAL primitive. Keywords such as PT_BORE and COG_TYPE are explained under the GET_POINT and PLACE_COG primitives respectively.

TYPE Statement
TYPE statements allow you to assign up to 150 labels or types to a symbol. The syntax for the TYPE statement is:
#TYPE = Type 1, Type 2, Type 3, ... , Type n

where Type 1 ... Type n Labels representing types under which the symbol will be classified.

Using each type, you can later inquire on the symbol. (Refer to the PDS Equipment Modeling (PD_EQP) Reference Guide for information on Parametric Help.) A type label can be up to 28 characters long. The compiler automatically left justifies each type and converts it to upper case. You can enter any number of complete type labels that fit in a line. Multiple TYPE statements are allowed. A TYPE statement can appear anywhere in the source code; however, the # character must appear in column 1.

Example:
The following TYPE statement appears in the code for a multi-diameter vertical vessel supported on skirt. #TYPE = tower, vertical vessel, drum, reactor

DESCRIPTION Statement
The DESCRIPTION statement assigns a descriptive phrase of up to 40 characters to the symbol. This description appears next to the symbol name when you inquire on the symbol library from the PDS Equipment Task. (See the PDS Equipment Modeling (PD_EQP) Reference Guide for information on Parametric Help.) The syntax for the DESCRIPTION statement is:
#DESC = This is a description

A DESCRIPTION statement can appear anywhere in the symbol code. The description string is placed left justified by the compiler. When more than one DESCRIPTION statement appears, only the last statement is used. The # character must appear in column one.

40

_ _______________
Comments
Example:
Call define_placepoint (PP1, POINT_1) ! POINT_1 is used to ! define place point 1

Comments

When you place an exclamation point (!) anywhere in an Equipment Modeling source line, the remainder of that line is treated as a comment.

2.Structure

41

_ _______________
PDS Eden for Equipment - April 2002

Operators
Operators are used in conjunction with variables to form expressions. As in FORTRAN, operators can be anyone of three types: 1. 2. 3. Arithmetic Relational Logical

Arithmetic Operators
Arithmetic operators are used to form arithmetic expressions. These operators follow the mathematical conventions. Valid arithmetic operators include: + * / ** // || addition subtraction multiplication division exponentiation concatenation using _ concatenation without using _

The first five operators (+, -, *, /, **) can only be used with numeric local and global variables. The concatenation operators (// , || ) can be used with both numeric and string variables. The concatenation operator // is used primarily to form table names. It joins two variables together with an underbar (_) character. The result is a text string.

Example:
ABC // DEF

produces
ABC_DEF

When using the concatenation operation, real numbers are converted to integers (that is, truncated), then converted to character strings and finally joined together with the underbar character. The concatenation operation is generally used to form messages and character field outputs.

42

_ _______________
Relational Operators
.EQ. .NE. .GE. .GT. .LE. .LT. equal to not equal to greater than or equal to greater than less than or equal to less than

Operators

Relational operators are used to form relational expressions that test the value of an Eden expression or establish conditions under which a group of Eden statements can be executed. Valid relational operators include:

2.Structure

Periods must appear before and after the expression.

Relational operators can be used on both numeric and character string variables. However, mixing the two types of operands for a given operation produces computing errors. In character relational expressions, less than means precedes in the ASCII collating sequence, and greater than means follows in the ASCII collating sequence.
ABCD .LT. ACCD

If two strings in a relational expression are not the same length, the shorter one is padded on the right with spaces until the lengths are equal.
PQRSTU .EQ. PQR

Logical Operators
Logical operators are used to combine relational expressions into more complex logical expressions. Valid logical operators include: .OR. .AND. logical or logical and

Periods must appear before and after the expression.

43

_ _______________
PDS Eden for Equipment - April 2002

Expressions
Expressions are variables, constants, and operators combined to make statements. The format of most Eden expressions is the same as in FORTRAN. Valid expressions include: Replacement Call Do while Indexed Do If - then - else simple arithmetic replacement executes primitives or subroutines execute loop execute loop conditional execution

For every IF statement, there must be an ENDIF statement to end the expression. You can nest up to five If-then-else expressions within an Eden module. For the Replacement, Do while, and If-then-else expressions, you can use parentheses to alter the precedence of calculation.

Replacement Statements
Replacement statements are used to set variables or perform calculations. The following list illustrates the various Replacement statements: thickness = 25. vessel_od = DIMENSION_1 test = test + 1 tutor_name = EXCH1 table_name = BLT // GEN_TYPE // PR_RATING // 5 dim_a = (dim_b + dim_c) * 2. + dim_d In Equipment and Pipe Support Modeling, all three components of a point (or location variable) can be replaced by another point value with one assignment statement.

Example:
In the following example, PT is declared as a buffer of three points. The second statement saves pt [4], pt [5], pt [6] into global location Point_5. In the third statement, the location value stored in point [2] is saved in a PT buffer, the x-coordinate being assigned to pt [7], y to pt [8], and so forth. Likewise, in the last statement, the POINT_3 components are replaced by those of Point_4 in one aggregate operation. Location pt [9] . . point [5] = pt [4] . . pt [7] = point_2 . . point_3 = point [4]

44

_ _______________
Call Statement
Call statements are used to execute system primitives. The syntax for the Call statement is:
call "primitive" or "subroutine" (argument 1, argument 2, ...)

Expressions

Example:
Call Place_Cylinder_With_Capped_Ends (diameter, length) Call Define_Placepoint (PP1)

2.Structure

Do While Statement
The Do While statement is used to form indefinite loops. The condition of a Do While statement must equal a logical value (either true or false). The body of the Do While statement will be repeatedly executed as long as the logical expression remains true.

Example:
The following Do While loop places four cylinders end to end. The pretested loop condition fails on the fifth try (if i equals 4), and control transfers to the message display routine. i=0 do while (i .LT. 4) i=i+1 Call Draw_Cylinder_With_Capped_Ends (diam, leng) enddo Call Display_Message (Out of loop now)

Indexed Do Statement
The Indexed Do statement allows you to form loops that execute a specified number of times. This number is determined by an initial, a terminal, and an incremental parameter of a control variable. The syntax for the Indexed Do statement is:
do V = v1, v2, v3 . . . enddo

where

45

_ _______________
PDS Eden for Equipment - April 2002 V v1 v2 v3 is a control variable (non-string type) are constants or variables that evaluate to the initial, terminal, and incremental parameters respectively. v3 is optional. If v3 is omitted, the system assumes that the incremental parameter is one. V3 cannot be negative.

Example:
In this example, I is set to 1. The body of the loop is then executed. I increments by 2 each time the cycle is complete, and the value 3 is checked against the terminator 20. The iteration continues as long as I is less than or equal to 20. When the iteration is greater than 20, the loop ends.
do I = 1, 20, 2 . . . enddo

If - then - else Statement


If - then - else statements are used when a group of statements is to be conditionally executed. The Eden syntax is the same as FORTRAN syntax.
if (condition) then . . . else . . . endif

Example:
if (DIMENSION_1 .gt. 24.) then thk = thk + .125 else thk = thk + .250 endif

An If statement of the form if (condition) is not valid. In Eden, all If statements must be of the form If (condition) then. The else statement is optional.

46

_ _______________
Functions
Eden provides several functions for performing common mathematical operations. These functions can be used within replacement statements. The following functions must contain the parentheses.

Functions

DSQRT () square root DABS () absolute value DSINR () sine of an angle in radians DCOSR () cosine of an angle in radians DTANR () tangent of angle in radians DSIND () sine of an angle in degrees DCOSD () cosine of an angle in degrees DTAND () tangent of an angle in degrees DASINR () arcsine returned in radians DACOSR () arccosine returned in radians DATANR () arctangent returned in radians DASIND () arcsine returned in degrees DACOSD () arccosine returned in degrees DATAND () arctangent returned in degrees

2.Structure

Example:
The following list illustrates a few possible Eden functions: length = hypot * DSIND (30.) side = DTANR (pi/2) + 32. hypot = DSQRT (a**2 + b**2) angle = DATAND (side1/side2)

47

_ _______________
PDS Eden for Equipment - April 2002

Primitives
Primitives are system-defined routines that perform specific functions for symbol definition.

Convert NPD to Subunits


The Convert NPD to Subunits primitive converts the coded input value and returns its Real*8 equivalent. This primitive is often used for converting the nominal piping diameter that is stored in the database. Metric files base the diameter in millimeters. Imperial files store the nominal piping diameter as NPD 1/32 + 5000. Thus, 1 inch NPD is 5000 + 32 * 1 = 5032 20 inch NPD is 5000 + 32 * 20 = 5640 For Eden symbols in Piping that use imperial and metric files, hard coding the dimensions is not recommended. A dimension entered as 5 inches and placed in an Imperial file is interpreted as 5 inches. However, the same value placed in a Metric file is interpreted as 5 millimeters. Instead of hard coding, load the dimensions in a table to allow the piping software to convert the dimensions to the correct values. This primitive does not perform unit conversions. If American standard pipe sizes are being used in a Metric file, this primitive will return the NPD in inches.

Syntax
Call Convert_NPD_To_Subunits (coded_input, npd)

Options
coded_input The nominal pipe diameter in internal or coded units. This variable must be the keyword Nom_Pipe_D_n. The nominal piping diameter in subunits.

npd

Examples
In this example, the Real*8 equivalence of the coded NPD in Nom_Pipe_D_1 is returned in Pipe_Dia_1.
Call Convert_NPD_To_Subunits (Nom_Pipe_D_1, pipe_dia_1)

All NPDs used internally in the software are in encoded form. Most table lookups based on NPDs require the input to be in encoded form. However, if a nozzle size is needed in a calculation, it must be converted from internal units to subunits.

48

_ _______________
Define Active Orientation
The Define Active Orientation primitive allows you to define the active orientation by specifying the directions of the primary and secondary axes. The orientation is defined in the local coordinate system by the symbol. This definition has no bearing on the design file coordinate system. In Piping, this primitive defines the current flow centerline and a direction that is normal to the flow centerline in terms of the connect point orientation (defined by the symbols connect point geometry) in order to place graphic shapes.

Define Active Orientation

2.Structure

Specific keywords are available for specifying either the primary axis or the secondary axis of the connect points orientation.

Syntax
Call Define_Active_Orientation (primary, secondary)

Options
primary secondary Variable that defines the flow centerline or primary direction. Variable that defines the line perpendicular to the flow centerline or secondary direction.

Valid keywords for the primary and secondary variables include: EAST WEST NORTH SOUTH UP DOWN PP_PRIMARY_n PP_SECONDARY_n PP_NORMAL_n PRIMARY SECONDARY NORMAL

For the Equipment Modeling keywords, you must define n using the Define Placepoint primitive before using any of the PP keywords. If the initial active orientation for a symbol definition has the primary pointing east and the secondary pointing north, the normal axis of the active orientation would be up. (Normal axis can be found using the right-hand rule.)

49

_ _______________
PDS Eden for Equipment - April 2002

Example:
In the following example, the primary orientation is set to point west, and the secondary orientation is set to point down:
Call Define_Active_Orientation (WEST,DOWN)

50

_ _______________
Draw Cone

Draw Cone

The Draw Cone primitive places a cone where the first end is at the current active point and the second end is at a location computed by the system given the input length along the primary axis. You must define the diameters of each end of the cone with separate variables.

2.Structure

Syntax
Call Draw_Cone (length, diameter_1, diameter_2)

Options
length diameter_1 diameter_2 The length of the cone (A) which can be positive or negative. The diameter of the cone (B) at the active point. The diameter of the cone (C) at the end opposite the active point.

Examples
SYMBOL_PROCESSOR CCONE tutnam = CCONE Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_3 Call Define_Placepoint (PP1, Point_0) Call Draw_Cone (A, B, C) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

! length of cone ! diameter at active pt ! diameter at opposite end

51

_ _______________
PDS Eden for Equipment - April 2002

Draw Cylinder
The Draw Cylinder primitive places a cylinder where the first end is at the current active point and the second end is at a location computed by the system along the primary axis. You must specify the diameter and the length of the cylinder. The active point will be moved to the opposite end.

Syntax
Call Draw_Cylinder (length, diameter)

Options
length diameter The length (A) of the cylinder. The diameter (B) of the cylinder.

Examples
SYMBOL_PROCESSOR CYLIND tutnam = CYLIND Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 Call Define_Placepoint (PP1, Point_0) Call Draw_Cylinder (A, B) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

! length ! diameter

If cyl_len is positive, a cylinder of the specified length is drawn. If cyl_len is zero, nothing happens. If cyl_len is negative, the active point is moved the specified negative distance, but the cylinder is not drawn.

52

_ _______________
Draw Eccentric Cone
The Draw Eccentric Cone primitive allows you to place an eccentric truncated cone. The first end is at the current active point. The second end is at a location the system computes by moving from the current active point along the current flow centerline by the length of the cone and along the secondary axis by the negative of the eccentric offset. You must specify the eccentric offset and the diameters of both ends of the eccentric cone.

Draw Eccentric Cone

2.Structure

Syntax
Call Draw_Eccentric_Cone (length, eccentric_offset, diameter_1, diameter_2)

Options
length eccentric_offset Cone length (A). Eccentric cone offset. This is the center-to-center distance between cone endpoints as measured positive going against the secondary. Diameter (B) at active point. Diameter (C) at the opposite end.

diameter_1 diameter_2

Examples
SYMBOL_PROCESSOR ECONE tutnam = ECONE Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_3 offset = (C - B) * 0.5 Call Define_Placepoint (PP1, Point_0) Call Draw_Eccentric_Cone (A, offset, B, C) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

! ! ! !

length diameter at active pt diameter at opposite end offset

53

_ _______________
PDS Eden for Equipment - April 2002

Draw Projected Rectangle


The Draw Projected Rectangle primitive allows you to place a component with a rectangular cross section. The current active point must be moved to the center of the rectangle, and the primary axis must point in the direction of the projection. The secondary axis orients the side of length1.

You must specify the projected height, projected width, and projected length dimensions.

Syntax
Call Draw_Proj_Rectangle (length1, length2, projection)

Options
length1 Length of the rectangle side (C) parallel to the secondary axis of the active orientation. Length of the rectangle side (B) parallel to the normal axis of the active orientation. Length of the projection (A).

length2

projection

Restrictions
The active point must be located at the center of geometric shape of the rectangle. The refresh tee must point inward (the direction of projection).

Examples
SYMBOL_PROCESSOR RECTNG tutnam = RECTNG Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_3

! length of projection ! length of side parallel to normal ! length of side parallel to secondary

54

_ _______________
Call Call Call Call stop end Define_Placepoint (PP1, POINT_0) Draw_Proj_Rectangle (C, B, A) Define_Active_Orientation (WEST, NORTH) Define_Placepoint (PP2, POINT_0)

Draw Projected Rectangle

2.Structure

55

_ _______________
PDS Eden for Equipment - April 2002

Draw Projected Triangle


The Draw Projected Triangle primitive allows you to place a component that has an isosceles triangular cross-section. The current active point must be moved to the center of the cross-section. The primary axis points in the direction of the projection, and the secondary axis points to the base of the triangle. You must specify the side length, base length, and projected length dimensions.

Syntax
Call Draw_Proj_Triangle (project_side_length, project_base_length, project_length)

Options
project_side_length project_base_length project_length Length of the side (A) of the triangle. Length of the base (B) of the triangle. Length of the projection (C).

Restrictions
The active point must be located at the center of geometric shape of the triangle. The refresh tee must point inward. Make sure that dimension A is greater than 1/2 of dimension B, otherwise errors will result.

Examples
SYMBOL_PROCESSOR TRIANG tutnam = TRIANG Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_3

! length a side ! length of base ! length of projection

56

_ _______________
angle = DIMENSION_4 if (B .GT. 0) then DIMENSION_4 = 0 endif if (angle .GT. 0 .AND. B .EQ. 0) then angle = angle * 0.5 B = 2.0 * (A * DSIND(angle)) endif Call Define_Placepoint (PP1, Point_0) Call Draw_Proj_Triangle (A, B, C) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

Draw Projected Triangle

2.Structure

57

_ _______________
PDS Eden for Equipment - April 2002

Draw Semi-Ellipsoid
The Draw Semi-Ellipsoid primitive allows you to place a semi-ellipsoid, where the center is at the current active point. You must specify the diameter of the major axis and the radius of the minor axis. The system does not update to a new active orientation after placement of the semi ellipsoid.

Syntax
Call Draw_Semi_Ellipsoid (major_axis_diameter, minor_axis_radius)

Options
major_axis_diameter minor_axis_radius Variable defining the major axis diameter (A). Variable defining the minor axis radius (B).

Examples
SYMBOL_PROCESSOR SELLIP tutnam = SELLIP Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 Call Define_Placepoint (PP1, Point_0) Call Draw_Semi_Ellipsoid (A, B) stop end

! major axis diameter ! minor axis radius

58

_ _______________
Draw Sphere
The Draw Sphere primitive allows you to place a sphere where the center of the sphere is at the current active point. You must specify the radius, and the radius must be greater than or equal to () 1/64 inches. The refresh tee and orientation will not change after placement.

Draw Sphere

2.Structure

Syntax
Call Draw_Sphere (radius)

Options
radius Variable (A) defining the sphere radius.

Examples
A = F_to_C_Dim_1*0.5 Call Draw_Sphere (A) ! defining sphere radius

59

_ _______________
PDS Eden for Equipment - April 2002

Draw Torus
The Draw Torus primitive allows you to place a torus from the current flow centerline to the current direction of the secondary axis using the bend radius, bend angle, and diameter you specify. This call changes the active orientation.

The torus diameter must be greater than or equal to () 1/32 inches, and the bend radius diameter must be greater than or equal to () 1/32 inches and greater than (>) 1/2 the torus diameter.

Syntax
Call Draw_Torus (radius, angle, diameter)

Options
radius The bend radius of the torus (B) as measured from the origin of the torus to its centerline. The bend angle of the torus (C). The diameter of the torus (A).

angle diameter

Examples
SYMBOL_PROCESSOR CTORUS tutnam = CTORUS Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 if (DIMENSION_3 .eq. 0) then DIMENSION_3 = 90 endif C = DIMENSION_3 Call Define_Placepoint (PP1, Point_0) Call Draw_Torus (B, C, A) Call Rotate_Orientation (-180., SECONDARY)

! torus diameter ! torus bend radius

! bend angle

60

_ _______________
Call Define_Placepoint (PP2, POINT_0) stop end

Draw Torus

2.Structure

61

_ _______________
PDS Eden for Equipment - April 2002

Abort
The Abort primitive allows you to terminate symbol execution without having to place graphics. It is similar to the QUIT option available on symbol tutorials. When the system encounters an Abort call, it displays a message indicating that the symbol execution has aborted.

Syntax
Call Abort (0)

62

_ _______________
Convert Unit
The Convert Unit primitive is used to convert distance in a given system of units to the design file system of units. Both lengths are expressed in subunits.

Convert Unit

Syntax
Call Convert_Unit (length1, unit type, outlength)

Options
length1 unit type Is the input length in subunits. Is the input as ENGLISH (for inches) or METRIC (for mm) to indicate the units in which length1 is expressed. Is the output after converting length1 to design file system of units.

2.Structure

outlength

Example
In the following example, a length of 10 inches is input. length2 receives the value 10 if the unit type is set to English or 254 if the unit type is set to Metric.
Call Convert_Unit (10, ENGLISH, length2)

63

_ _______________
PDS Eden for Equipment - April 2002

Define Active Point


The Define Active Point primitive functions similarly to the Define Active Orientation primitive, but also defines the active point in the symbols local coordinate system.

Syntax
Call Define_Active_Point (point)

Options
point Is a keyword specifying a previously defined point. Valid values for point include: local point variables global point variables PP_LOCATION_q (q = 1 - 10)

Restrictions
The initial position of the active point must be located at the symbols local coordinate system origin. Before using POINT_n, you must define it by calling Define Point. Before using PP_LOCATION_q, you must define it by calling Define Placepoint.

Example
Call Define_Active_Point (POINT_3) Call Define_Active_Point (PP_LOCATION_1)

64

_ _______________
Define Datum Point
The Define Datum Point primitive allows you to define and place up to 30 datum points per symbol. The orientation of the datum point is controlled by the active orientation at the time of the call.

Define Datum Point

Syntax
Call Define_Datum_Point (dp, point)

Options
dp Is a keyword specifying the datum point number. Valid values include: 1 ... 30 point Is a keyword specifying the datum point location. Valid values include: ACTIVE_POINT local point variable global point variable PP_LOCATION [1] ... PP_LOCATION [10]

2.Structure

Example
In the following example, the call defines dp [1]. Its location is given by point_2.
Call Define_Datum_Point (dp [1], point_2 )

In the Add and Modify & Copy commands, this call will not replace or add to existing datum points for the equipment. In the Modify mode, it will replace existing datum points only if they are still associated with the symbol being modified. (Refer to the PDS Equipment Modeling (PD_EQP) Reference Guide for more information.) In either case, if nonparametric datum points already exist for the piece of equipment, Define Datum Point calls will have no effect.

65

_ _______________
PDS Eden for Equipment - April 2002

Define Library
The Define Library primitive allows you to activate an alternate physical data library.

Syntax
Call Define_Library (library_no)

Options
library_no Is a keyword, variable, or expression whose numeric value specifies which library is to be opened next. Valid values and their symbolic keywords include: 1 - ENG_COMM_LIB 3 - EQP_TABLES ACT_LIB The piping physical data library. The equipment physical data library. Keyword that allows you to see which commodity library is currently open. ACT_LIB is a readonly variable and can only be set by the system following a successful Define_Library call. When a symbol is first called up, the system automatically opens the correct commodity library depending on the nozzle diameter system of units for the file and then sets ACT_LIB to 1 (ENG_COMM_LIB). Therefore, at the beginning of symbol execution, you can always expect the default piping physical data library to be open. Subsequently, with the Define_Library primitive, you can change the active library.

Example
In the following example, the active library number (1 or 3) is saved, and the English commodity library is temporarily opened. When the library is no longer needed, the previously active library is restored.
save_library = ACT_LIB Call Define_Library (ENG_COMM_LIB) . . . Call Define_Library (save_library)

OR

66

_ _______________
save_library = ACT_LIB Call Define_Library (1) . . . Call Define_Library (save_library)

Define Library

2.Structure

67

_ _______________
PDS Eden for Equipment - April 2002

Define Nozzle
The Define Nozzle primitive places a nozzle at the current active point using the current active orientation. Before calling this primitive, you must call Retrieve Nozzle Parameters and set the necessary global variable assignments, such as Noz_Length1, Noz_Length2, or Noz_Radius.

Syntax
Call Define_Nozzle (noz_type, noz_num, noz_end)

Options
Noz_type A character variable or constant defining the nozzle type. Valid values include: NOZ1 for type 1 nozzles. Consists of a basic flange.

No user input is required. The nozzle length is set by the flange thickness table. 2 NOZ2 for type 2 nozzles. Consists of a flange as well as a neck.

The length is user-defined. A = Noz_Length1 3 NOZ3 for type 3 nozzles. Commonly referred to as a goose neck nozzle.

Two lengths and the bend radius are user-defined. A = Noz_Length1 B = Noz_Length2 C = Noz_Radius

68

_ _______________
Noz_num A nozzle number that uniquely identifies the nozzle within the parametric symbol. The nozzle number must NOT be used for more than one nozzle within a parametric symbol definition. Currently, this number can take on a value of 1 to 20, inclusively. Therefore, a single parametric can not have more than 20 nozzles. A variable or constant with a value of 1 or 2 that defines the end of the nozzle placed at the active point. A value of 1 specifies the end connected to the equipment item. A value of 2 specifies the end connected to piping. Noz_end

Define Nozzle

The primary axis of the active orientation is used to orient both type 1 and type 2 nozzles. The primary and secondary axes are used to orient type 3 nozzles.

2.Structure

Example
SYMBOL_PROCESSOR NOZ1 tutnam = NOZ1 Call Display_Tutorial (tutnam) nozend = DIMENSION_100 nozsum = 20 Call Retreive_Nozzle_Parameters (nozsum) Call Define_Nozzle (NOZ1, noznum, nozend) stop end

You must call Retrieve Nozzle Parameters before Define Nozzle.

69

_ _______________
PDS Eden for Equipment - April 2002

Define Orientation By Points


The Define Orientation By Points primitive allows you to redefine the active orientation using three known points.

Syntax
Call Define_Orientation_By_Points (PT1, PT2, PT3)

Options
pt1 The active primary direction is computed using pt1 as the start point. Global or local point. The active primary direction is computed using pt2 as the end point. Global or local point. The active secondary direction is computed using pt3 as the end point. The start point is the intersection between the primary vector from pt1 and its perpendicular from pt3. Global or local point.

pt2

pt3

In case one or more of these points are coincident, the active orientation is unchanged.

Example
In the following example, the call orients the active primary along the line from POINT_1 to POINT_2, and the active secondary towards POINT_3 along a perpendicular of the primary:
Call Define_Orientation_By_Points (point [1], point [2], point [3])

70

_ _______________
Define Placepoint
The Define Placepoint primitive allows you to define the symbol placepoint. Every symbol must have at least one place point.

Define Placepoint

Syntax
Call Define_Placepoint (pp, point)

Options
pp A keyword defining the placepoint number. Valid values for pp include: PP1 - PP10 Up to 10 placepoints can be defined for a symbol. point Keyword defining the place point location. Valid values for point include: ACTIVE_POINT local point variables global point variables pp_location_1 - pp_location_10

2.Structure

Example
In this example, place point number 1 is defined.
Call Define_Placepoint (PP1, POINT_0)

At symbol placement time, the symbol place point is aligned with the current design file active point. The place points primary axis is aligned with the design file active orientation primary axis. Therefore, the symbols local coordinate system is transformed to that defined by the refresh tee.

71

_ _______________
PDS Eden for Equipment - April 2002

Define Point
The Define Point primitive allows you to save a point or to calculate a new point based on a reference point and a delta x, y, and z.

Syntax
Call Define_Point (point, ref_point, delta_x, delta_y, delta_z, flag)

Options
point A keyword specifying the saved or calculated point storage location. Local or global point variables are valid values. A keyword specifying the point to be saved or the point from which the new point is to be calculated. Valid values for ref_point include: local point variable global point variable pp_location_1 - pp_location_10 delta_x The delta in the x or east direction of the symbol coordinate system from the reference point. The delta in the y or north direction of the symbol coordinate system from the reference point. The delta in the z or up direction of the symbol coordinate system from the reference point. [optional] If supplied, the deltas are interpreted as offsets along the active primary, secondary, and normal respectively.

ref_point

delta_y

delta_z

flag

Examples
In this example, the current active point is saved in POINT_1. You can make POINT_1 the active point again simply by calling Define Active Point.
Call Define_Point (POINT_1, ACTIVE_POINT, 0, 0, 0)

In this example, a new point is calculated from POINT_1. The result is saved in POINT_2.
delx dely delz Call = 24. = 24. = 24. define_point (POINT_2, POINT_1, delx, dely, delz)

72

_ _______________
Display Message
The Display Message primitive allows you to display a message in a tutorial field or MicroStation ER field.

Display Message

Syntax
Call Display_Message (message, fldno)

Options
2.Structure
message A variable or expression. If necessary, the message can be converted to displayable characters for output. You can specify a message up to 50 characters in length; however, only the first 40 characters will be displayed. A field number on the active tutorial. Possible values are 0 - 255. If 0, the message is displayed in the MicroStation ER field. [optional] This argument defaults to 0 if omitted. Tutorial fields defined (via TDF) to contain data for symbol generation should not receive input through this call.

fldno

Example
dia = -10.0 . . . Call Display_Message (Cone dia is negative: || dia, 0 )

The actual message displayed in the ER field will read:

Cone dia is negative: -10.0

73

_ _______________
PDS Eden for Equipment - April 2002

Display Tutorial
The Display Tutorial primitive allows you to activate a tutorial and specify an optional tutorial definition file name.

Syntax
Call Display_Tutorial (tutnam, tdfnam)

Options
tutnam tdfnam Name of the form (1 - 6 characters) to be activated. [optional] The tutorial file name (1 - 6 characters). If omitted, the TDF name defaults to the tutorial name itself. This argument allows you to activate the same tutorial with different TDF names and hence different global variables for each activation. The same TDF name can be used with different tutorials.

Example
This call activates a tutorial named TEST.
Call Display_Tutorial (TEST)

There is a limit of 10 forms that can be activate. It is also possible to activate the same form several times per symbol execution. However, if a TDF name is used with several forms in the modify mode, only the first such form will display existing data.

Interacting with Tutorials


Terminated fields allow the symbol code some control over operator interaction when a tutorial is active. Refer to the Creating the Tutorial Definition Table section for creating these fields. When you select a terminated application command or key-in field, the control returns to the symbol code, which can test specific global variables identifying the field number and its type. The global variable LAST_INP_TYPE has the type of the most recent terminated field selected. It can be tested against the following keywords for field types: APPLICATION_CMD USER_KEYIN application command field user key-in field

The global variable LAST_INP_NUM contains the number of the last terminated field selected.

74

_ _______________
Example
Three possible operator actions can result in control returning to the symbol code for the example below. The first test is against a terminated application field selection. If positive, the data in DIMENSION [LAST_INP_NUM] is accessed and output to field 90.

Display Tutorial

The second test is for the selection of a terminated key-in field. The contents of CSTRING [LAST_INP_NUM] is output to field 100. The receiving variable for the keyed-in text is stored as per TDF. The symbol waits for further operator input by calling Display Tutorial. The tutorial does not redisplay since it is already active.

2.Structure

If both tests fail, you must select ACCEPT (the control variable will be set to TRUE), forcing exit from the loop.
ACCEPTED = FALSE do while (.not. ACCEPTED) Call Display_Tutorial (TEST) if (LAST_INP_TYPE .eq. APPLICATION_CMD) then Call Put_Field (dimension [LAST_INP_NUM], 90) else if (LAST_INP_TYPE .eq. USER_KEYIN) then Call Put_Field (cstring [LAST_INP_NUM],100) else ACCEPTED = TRUE endif endif enddo

! application cmd ! ... field

! get out of loop

75

_ _______________
PDS Eden for Equipment - April 2002

Draw Arc
The Draw Arc primitive allows you to place an arc. An arc may be considered a continuous segment of an ellipse whose axes are known.

Syntax
Call Draw_Arc (semimajor, semiminor, start_angle, sweep_angle)

Options
semimajor Supplies the length of the semimajor axis and is oriented by the local primary. Supplies the length of the semiminor axis and is oriented by the local secondary. Specifies the start point of the arc segment. The value range is -360.0 to 360.0. Larger or smaller values are reduced to this range, remaindering by 360.0. Positive angles are measured by rotating the primary into the secondary counterclockwise in a right-handed system. specifies the span of the arc segment. The value range is -360.0 to 360.0. Larger or smaller values are reduced to this range, remaindering by 360.0. Rotational sense is counterclockwise, righthanded, from start_angle. The parent ellipse is completely known given the active primary, secondary and the axis lengths. The two angles merely fix the arcs angular position and not the distance of any of its points from the foci.

semiminor

start_angle

sweep_angle

Example
This call places an elliptical arc with major and minor axes of 40 and 20 units respectively. The primary axis is rotated from a 90 degree position through a right angle to produce the arc.
Call Draw_Arc (20, 10, 90, 90)

If you are placing a non-circular arc with start or sweep angles that are NOT a multiple of 90 degrees, MicroStation computes these angles differently. To convert your angle to the input argument, use the following formula: tan(microstation_angle) = (semimajor/semiminor) tan(your_angle)

76

_ _______________
Draw Complex Surface
Syntax
Call Draw_Complex_Surface (argument_1, argument_2)

Draw Complex Surface

The Draw Complex Surface primitive allows you to build projected and revolved shapes one element at a time. Familiarity with the structure of 3D MicroStation shapes is required to use this primitive effectively.

The call can be made in three modes:

2.Structure

1. 2. 3.

Start surface Change class or symbology of elements being placed End surface

Each argument has a different interpretation for each mode.

Start Surface
Used to start the surface. Syntax
Call Draw_Complex_Surface (no_of_ele, surface_type)

Options no_of_ele surface_type The number of elements per face. The MicroStation surface type to build. Typical surface types include: 0 - surface of projection 8 - surface of revolution

Change Class/Symbology
Used to change the class/symbology of elements being placed within the surface. A negative symbol must be placed in front of the first argument. Syntax
Call Draw_Complex_Surface (_element_class, symbology)

77

_ _______________
PDS Eden for Equipment - April 2002 Options element_class The class of elements to be placed. Typical classes include: primary elements (class = 0, the default) rule elements (class = 4) symbology The symbology of elements to be placed. This is an INTEGER (I*4 or 4 bytes) word. The upper word (2 bytes) is set to: 0 - allows defaults to apply 1 - apply line code only 2 - apply line weight only 4 - apply color only Sum the above values to send in combinations. For example, (3) code and weight to apply is the result of adding (1) apply line code only and (2) apply line weight only. Using this process, you can enter numbers 0-7 (default to all of the above). The lower word supplies the symbology (line code, line weight, color) as per MicroStation format.

Complete Surface
Used to complete the surface. Syntax
Call Draw_Complex_Surface (-99, 0)

Example
This example shows the creation of a flat-oval projected shape. The opening Draw Complex Surface specifies that each face is composed of 4 elements and that this is a surface of projection.

78

_ _______________

Draw Complex Surface

2.Structure

The code for placing a flat-oval face is shown (2 arcs and 2 lines). The second call to Draw Complex Surface specifies that rule lines (class=4) will be placed. The minus sign before the class argument is needed by the system to identify ongoing calls. The final call terminates surface construction.
Call Call Call Call Call Call Call Call Call Call Call Call Call Call Call Call Draw_Complex_Surface (4, 0) Draw_Arc (radius, radius, -90, 180) Draw_Line (point_1, point_2) Draw_Arc (radius, radius, 90, 180) Draw_Line (point_3, point_4) Draw_Complex_Surface (4, 0) Draw_Arc (radius, radius, -90, 180) Draw_Line (point_5, point_6) Draw_Arc (radius, radius, 90, 180) Draw_Line (point_7, point_8) Draw_Complex_Surface (-4, 0) Draw_Line (point_1, point_5) Draw_Line (point_2, point_6) Draw_Line (point_3, point_7) Draw_Line (point_4, point_8) Draw_Complex_Surface (-99, 0) ! start projected;

! surface 2

! ! ! ! ! !

start rule lines place a rule line place a rule line place a rule line place a rule line wrap it up

79

_ _______________
PDS Eden for Equipment - April 2002

Draw Con Prism


The Draw Con Prism primitive places a concentric prism by a point in the center of either rectangular end. The active orientation primary axis is used to orient the direction of projection. The secondary axis orients a side of each end.

Syntax
Call Draw_Con_Prism (length_sec, length_norm, length_proj, length2_sec, length2_norm)

Options
length_sec length_norm length_proj length2_sec length2_nor The length of rectangular base along secondary. The length of rectangular base along normal. The length of projection. The length of rectangular top along secondary. The length of rectangular top along normal.

Example
SYMBOL_PROCESSOR RPRISM tutnam = RPRISM Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_3 D = DIMENSION_4 proj = DIMENSION_5 Call Define_Placepoint (PP1,POINT_0) Call Draw_Con_Prism (A, B, proj, C, D) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

! ! ! ! !

length length length length length

of of of of of

A B C D E

80

_ _______________
Draw Curve
The Draw Curve primitive allows you to place a curve string.

Draw Curve

Syntax
Call Draw_Curve (no_vertex, point_buffer)

Options
2.Structure
no_vertex point_buffer The number of vertices from 1 - 90. The location of the 1st vertex. The other vertices are sequentially stored in the buffer. Use global or local point buffers.

Example
In this example, the call places a stream curve of 20 points in POINT [24] .. POINT [43].
Call Draw_Curve (20, point_24)

This primitive is not supported by the equipment task but is available in the HVAC task.

81

_ _______________
PDS Eden for Equipment - April 2002

Draw Ecc Prism


The Draw Ecc Prism primitive places an eccentric prism by a point in the center of either rectangular end. The active orientation primary axis orients the direction of projection. The secondary axis orients a side of each end as well as the offset direction.

Syntax
Call Draw_Ecc_Prism (length_sec, length_norm, length_proj, length2_sec, length2_norm, offset)

Options
length_sec length_norm length_proj length2_sec length2_norm offset The length of rectangular base along secondary. The length of rectangular base along normal. The length of projection. The length of rectangular top along secondary. The length of rectangular top along normal. The center-to-center distance between base end and top end measured (positive) against the secondary.

Example
SYMBOL_PROCESSOR EPRISM tutnam = EPRISM Call Display_tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_4 D = DIMENSION_5 E = DIMENSION_3 offset = (A - C) / 2.0 Call Define_Placepoint (PP1, POINT_0) Call Draw_Ecc_Prism (A, B, E, C, D, offset) Call Define_Active_Orientation (WEST, NORTH)

! ! ! ! ! !

length length length length length offset

of of of of of

A B C D E

82

_ _______________
Call Define_Placepoint (PP2, POINT_0) stop end

Draw Ecc Prism

2.Structure

83

_ _______________
PDS Eden for Equipment - April 2002

Draw Ecc Transitional Element


The Draw Ecc Transitional Element primitive allows you to place an eccentric transitional element by a point in the center of either the rectangular or circular face. The active orientation primary axis orients the direction of projection. The secondary axis orients a side of the rectangular base and the direction of offset.

Syntax
Call Draw_Ecc_Transitional_Element (length_sec, length_norm, length_proj, length_radius, offset)

Options
length_sec length_norm length_proj length_radius offset The length of rectangular base along secondary. The length of rectangular base along normal. The length of projection. The radius of circular face. The center-to-center distance between the rectangular end and the circular end as measured positive going against the active secondary.

Example
SYMBOL_PROCESSOR ETRANS tutnam = ETRANS Call Display_tutorial (tutnam) A = DIMENSION_1 ! length B = DIMENSION_2 ! length C = DIMENSION_3 ! length D = DIMENSION_4 / 2.0 ! length offset = (A - D) / 2.0 ! offset Call Define_Placepoint (PP1, POINT_0) Call Draw_Ecc_Transitional_Element (A, B, C, D, offset) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

of of of of

A B C D

84

_ _______________
Draw Ellipse
The Draw Ellipse primitive allows you to place an ellipse. The major and minor axes are oriented by the local primary and secondary axes respectively.

Draw Ellipse

2.Structure

Syntax
Call Draw_Ellipse (semimajor_len, semiminor_len)

Options
semimajor_len semiminor_len Half the length of the major axis. Half the length of the minor axis.

Example
This call places an ellipse whose major and minor axes are 40 and 20 units long. The major axis points DOWN.
Call Define_Active_Orientation ( DOWN, WEST ) Call Draw_Ellipse (20.0, 10.0)

85

_ _______________
PDS Eden for Equipment - April 2002

Draw Line
The Draw Line primitive allows you to place a line.

Syntax
Call Draw_Line (start_pt, end_pt)

Options
start_pt end_pt The location of first vertex. Use global or local point. The location of second vertex. Use global or local point.

Example
In this example, the call places a line from POINT_10 to POINT_20.
Call Draw_Line (point_10, point 20)

86

_ _______________
Draw Line String
The Draw Line String primitive allows you to place a line string.

Draw Line String

2.Structure

Syntax
Call Draw_Line_String (no_vertex, point_buffer)

Syntax
no_vertex point_buffer Supplies the number of vertices from 1 - 90. The location of the first vertex. The other vertices are sequentially stored in the buffer. Use global or local point buffers.

Example
In this example, the call places a line string of 20 vertices, which are found in POINT[24] ... POINT [43].
Call Draw_Line_String (20, point [24] )

87

_ _______________
PDS Eden for Equipment - April 2002

Draw Proj Hexagon


The Draw Proj Hexagon primitive allows you to place a projected hexagon by a point in the center of a face. The active orientation primary axis orients the direction of projection. The secondary axis orients a flat of the hexagonal solid.

Syntax
Call Draw_Proj_Hexagon (side_length, proj)

Options
side_length proj Side B is the side length. Side A is the length of the projection.

Example
SYMBOL_PROCESSOR HEXAGON tutnam = HEXAGON Call Display_Tutorial (tutnam) A = DIMENSION_1 D_in = DIMENSION_2 D_out = DIMENSION_3 D_side = DIMENSION_4 if (D_side .GT. 0) then DIMENSION_2 = 0 DIMENSION_3 = 0 endif if (D_side .LE. 0) then if (D_in .GT. 0) then DIMENSION_3 = 0 D_side = D_in * DTAND(30.0) endif endif if (D_side .LE. 0) then

! length of A ! ! !

88

_ _______________
if (D_out .GT. 0) then D_side = D_out / 2 DIMENSION_2 = 0 endif endif Call Define_Placepoint (PP1, POINT_0) Call Draw_Proj_Hexagon (D_side, A) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end

Draw Proj Hexagon

2.Structure

89

_ _______________
PDS Eden for Equipment - April 2002

Draw Proj Octagon


The Draw Proj Octagon primitive places a projected octagon by a point in the center of a face. The active orientation primary axis orients the direction of the projection. The secondary axis orients a flat side of the octagonal solid.

Syntax
Call Draw_Proj_Octagon (side_length, proj)

Options
side_length proj Side B is the side length. Side A is the length of the projection.

Example
SYMBOL_PROCESSOR OCTGON tutnam = OCTGON Call Display_Tutorial (tutnam) A = DIMENSION_1 D_in = DIMENSION_2 D_out = DIMENSION_3 D_side = DIMENSION_4 if (D_side .GT. 0) then DIMENSION_2 = 0 DIMENSION_3 = 0 endif if (D_side .LE. 0) then if (D_in .GT. 0) then DIMENSION_3 = 0 D_side = D_in * DTAND(22.5) endif endif if (D_side .LE. 0) then

! length of A ! ! !

90

_ _______________
if (D_out .GT. 0) then D_side = D_out * DSIND (22.5) DIMENSION_2 = 0 endif endif Call Define_Placepoint (PP1, POINT_0) Call Draw_Proj_Octagon (D_side, A) Call Define_Active_Orientation (WEST, NORTH) Call Define_Placepoint (PP2, POINT_0) stop end Call Draw_Proj_Octagon (12, 12)

Draw Proj Octagon

2.Structure

91

_ _______________
PDS Eden for Equipment - April 2002

Draw Proj Shape


The Draw Proj Shape primitive allows you to place an arbitrary (planar) shape and project it by a given distance. The active primary orients the direction of projection.

Syntax
Call Draw_Proj_Shape (no_pnt, proj_len, pnt_buffer)

Options
no_pnt proj_len pnt_buffer The number of vertices from 1 - 24. The length (A) of the projection. [optional] If supplied, points to the location of the first vertex. If omitted, the vertices are assumed to be in the global POINT array with vertex 1 in point_1, vertex 2 in point_2, and so forth. Local or global point arrays.

Examples
The length of the shape to be placed is 10.0 units. The 5 vertices are in POINT [101] ... POINT [105].
Call Draw_Proj_Shape ( 5, 10.0, point [101])

The projected shapes vertices are found in POINT_1 ... POINT_5. After placement, the active point is updated from the face by which it was placed to the opposite face.
Call Draw_Proj_Shape ( 5, 10.0 )

92

_ _______________
Draw Rectangular Torus
The Draw Rectangular Torus primitive places a rectangular torus by a point in the center of either rectangular end. The active orientation primary axis orients the direction of projection. The secondary axis points toward the origin of the torus.

Draw Rectangular Torus

2.Structure

Syntax
Call Draw_Rectangular_Torus (bend_radius, sweep_angle, length_sec, length_norm)

Options
bend_radius sweep_angle The length from torus origin to center of either end. The angle formed between two radii joining the center of each end to the origin. The length of rectangular end along secondary. The length of rectangular end along normal.

length_sec length_norm

Example
SYMBOL_PROCESSOR RTORUS tutnam = RTORUS Call Display_Tutorial (tutnam) A = DIMENSION_1 B = DIMENSION_2 C = DIMENSION_3 D = DIMENSION_4 Call Define_Placepoint (PP1, POINT_0) Call Draw_Rectangular_Torus (C, D, A, B) Call Rotate_Orientation (-180.,SECONDARY) Call Define_Placepoint (PP2, POINT_0) stop end

! ! ! !

length of A length of B length of C Sweep angle of D

93

_ _______________
PDS Eden for Equipment - April 2002

Draw Revolved Shape


The Draw Revolved Shape primitive allows you to create a MicroStation surface of revolution by rotating an arc, line string, or shape. The axis of rotation is the primary axis passing through the symbol active point. Rotation is counter-clockwise.

Syntax
Call Draw_Revolved_Shape (generator_type, total_stroke_angle, no_of_steps point_buffer, argument_5, argument_6)

Options
generator_type A keyword specifying the element type being revolved. Keywords include: EL_LINESTR EL_SHAPE EL_ARC total_stroke_angle no_of_steps for line string for planar shape for arc

Specifies the overall angle of revolution in degrees from -360 to +360. Specifies the number of sections to create for the revolved shape. For example, if you specify a value of 2, there will be one intermediate instance of the generator element which will split the revolved shape into two sections. Must be at least 1. An array of points used to define the rotating element. If you are rotating a shape or line string, this array supplies the vertices of the element. If you are rotating an arc, this array must contain three points to define the arc. The first point is the arc origin. The second point defines the length and direction of the primary axis as measured from the arc origin. The third point defines the arc secondary, also relative to the arc origin.

point_buffer

argument_5

For line string or shape: the number of points in point_buffer. For arc: start angle of the arc (angle made between primary axis and the start of the arc segment).

argument_6

For line string or shape: a flag to indicate how edge lines should be placed. Specify a 1 if edge lines are to appear from all vertices. Specify a 0 if edge lines are placed from the two end vertices only. for arc: is the sweep angle of the arc segment. (For arcs, only two edge lines are placed, one from each end point of the arc).

94

_ _______________
Example
straight_flange = 24 dia = 120 dish_depth = dia/4 Call Draw_Cylinder (straight_flange, dia) point_1 = point_0 Call Move_Along_Axis (dia/2, SECONDARY) point_2 = point_0 point_0 = point_1 Call Move_Along_Axis (dish_depth, PRIMARY) point_3 = point_0 total_sweep = 360 arc_sweep = 90 ! save arc center

Draw Revolved Shape

In this example, a 2:1 semi-elliptical head is placed. The straight section is 24 inches, and the vessel diameter is 120 inches. Only two instances of the arc will appear one at 0 degrees, and another at 180 degrees (intermediate).

2.Structure

! point for arc primary ! for next move_along ! define arc secondary ! quadrant arc rotating

Call Draw_Revolved_Shape (EL_ARC, total_sweep, 2, POINT_1, 0, arc_sweep)

If you are rotating an arc, refer to the Draw Arc section for proper specifications of start and sweep angles.

95

_ _______________
PDS Eden for Equipment - April 2002

Draw Shape
The Draw Shape primitive is a 2D call allowing you to place a planar closed shape.

Syntax
Call Draw_Shape (no_vertex, point_buffer)

Options
no_vertex point_buffer Supplies the number of vertices from 1 - 90. The location of the first vertex. The other vertices are found in succeeding locations. The system adds the last vertex to coincide with the first vertex and close the shape. Use global or local point buffers.

Example
In this example, the call places a shape of 20 vertices in POINT [24] ... POINT [43].
Call Draw_Shape (20, point [24])

96

_ _______________
Draw Transitional Element
The Draw Transitional Element primitive allows you to place a right transitional element with a point in the center of either the rectangular or circular face. The active orientation primary axis orients the projection direction. The secondary axis orients a side of the rectangular base.

Draw Transitional Element

Syntax
Call Draw_Transitional_Element (length_sec, length_norm, length_proj, length_radius)

2.Structure

Options
length_sec length_norm length_proj length_radius The length of rectangular base along secondary. The length of rectangular base along normal. The length of projection. The radius of circular face.

Example
In this example, a transitional element with a base measuring 24 x 16 and a height of 30 subunits is placed along the active primary axis. The circular top is drawn with a radius of 6 subunits. After placement, the active point is updated from the face by which the shape was placed to the opposite end.
Call Draw_Transitional_Element (24, 16, 30, 6)

97

_ _______________
PDS Eden for Equipment - April 2002

Get Arc Points


The Get Arc Points primitive allows you to access the data for the arc last identified in a Get Point call. The system ignores the secondary length of the arc, assuming it to be identical to the primary. This call is specifically geared to facilitate hand-railing placement.

Syntax
Call Get_Arc_Points (arc_definition)

Options
arc_definition An output buffer of 4 points (global or local point buffer). The 4 points returned are (in order): center, one end point, an intermediate point, and the other end point of the arc. They allow the system to reconstruct the circular arc on arc-related calls where this definition must be input. The call will work properly as long as the identified arc is circular. The points are converted to the symbol (local) coordinate system before return.

98

_ _______________
Get Arc Size
The Get Arc Size primitive returns the circumferential distance between two points on an arc.

Get Arc Size

Syntax
Call Get_Arc_Size (arc_definition, from_pt, to_pt, length)

Options
2.Structure
arc_definition An input buffer of four points identifying a circular arc in local coordinates. The subroutine uses this argument to find the angular position or sweep of the arc segment about the center (first point). The center of the arc is then used with the FROM_PT argument to find trace radius. An input identifying the starting point of measurement. It is also used to compute the radius of the circular arc. Global or local point. An input identifying the end point of measurement. This point only establishes an ANGULAR position on the arc determined from the first two arguments. Thus, it may or may not be on the arc itself. Global or local point. The output variable containing the peripheral separation between FROM_PT and TO_PT. The result is accurate as long as both FROM_PT and TO_PT are within the sweep angle of the arc in ARC_DEFINITION. However, if a point is off the curve, the system will route the connection so as to include the arcs end nearer the off-point.

from_pt

to_pt

length

Example
In this example, the Get Point call forces a snap only to an arc. On return, the arc data is obtained with the second call. The length of the arc is then computed by sending the third call (the start point (point [3]), the end point (point [5]), and the arc itself).
int2 . . Call Call Call ret_pt_type, ret_ele_type

Get_Point (PT_SNAP, point [1], ret_pt_type, ret_ele_type, EL_ARC) Get_Arc_Points (point [2]) Get_Arc_Size (point [2], point [3], point [5], length)

99

_ _______________
PDS Eden for Equipment - April 2002

Get Date
The Get Date primitive allows you to retrieve the current system date into a character variable.

Syntax
Call Get_Date (date_string)

Options
date_string The character variable receiving system date in the form: dd-mmm-yyyy

Example
Call Get_Date (cstring_1)

After this call, cstring_1 appears as:

"22-JAN-1989"

100

_ _______________
Get EQP Category
The Get EQP Category primitive allows you to obtain a valid label for a given category number.

Get EQP Category

Syntax
Call Get_EQP_Category (catno, category, ret_code)

Options
2.Structure
catno category ret_code (input) A number between 1-20. (output) The category label for the given subcategory number. (output) 0 - if catno is valid 1 - if catno is invalid

Within this primitive, you can select from a displayed list of valid EQUIPMENT subcategories.

Example
In this example, the code fragment obtains all available (20) category labels.
do i = 1, 20 Call Get_EQP_Category (i, cstring [i], irc) if (irc .ne. 0) then cstring [i] = ! blank out sub-category name end if end do

101

_ _______________
PDS Eden for Equipment - April 2002

Get Line Size


The Get Line Size primitive returns the straight line distance between two points.

Syntax
Call Get_Line_Size (from_pt, to_pt, size)

Options
from_pt to_pt size The start point of measurement. Use global or local point. The endpoint of measurement. Use global or local point. The output variable containing the distance. This argument is always positive.

Example
In the following example, the code fragment computes the distance between point_1 and point_2 through the previous Get Point calls:
. . Call Get_Point (pt_snap, point [1]) Call Get_Point (pt_snap, point [2]) Call Get_Line_Size (point [1], point [2], distance) . .

102

_ _______________
Get Point
The Get Point primitive allows you to get a point from the operator in addition to an identified element.

Get Point

Syntax
Call Get_Point (pnt_types, ret_pnt, ret_pnt_type, ret_ele_type, ele_types)

Options
2.Structure
pnt_types An INT2 variable mask dictating the types of input you can select. You can combine the following keywords to yield the INT2 result: PT_RESET PT_BORE PT_SNAP PT_PREC PT_EQPID Return by selecting RESET (no point returned). Boresight location point. Snap point. Key-in precision point. Allows you to key-in the equipment name. The system returns its first datum point location, if it exists. Otherwise, it returns the place point of the first item placed for that equipment in the design file. Allows you to key in a NOZZLE ID. The system returns the location of its first connect point. A 2-view data button. Contains the result obtained by adding all the above point types. Any point type can be removed from this mask by subtraction. When forming the mask, remember to use a keyword only once whether adding or subtracting. ret_pnt A global or local point variable containing (on return) the operator-selected point. The design file coordinate system (global) point is transformed to the local coordinate system by using the point and axes of alignment between the two systems. Therefore, the orientation and location of the symbol placepoint must be established prior to this call. Also, the alignment parameters (placepoint location, orientation, global active point, global active orientation) must not be changed between Get Point calls. This can result in returned points not maintaining proper relativity. Use global or local point buffer. An INT2 output variable that contains the type of the returned point. This variable can be tested against the above keywords. It is optional only if subsequent arguments are omitted.

PT_NOZID

PT_3DB PT_ALL

ret_pnt_type

103

_ _______________
PDS Eden for Equipment - April 2002 ret_ele_type An INT2 output variable that contains the coded TYPE of the MicroStation element identified by a SNAP (see the PDS Equipment Modeling (PD_EQP) Reference Guide). It is optional only if subsequent arguments are omitted. It can be tested against these keywords to identify the type code: EL_LINE EL_LINESTR EL_SHAPE EL_ELLIPSE EL_ARC EL_PTSTR EL_CONE ele_types line element line string shape ellipse arc point string cone

An INT2 mask obtained by combining (adding) a number of element type codes just listed. It dictates the types the operator can possibly identify. This variable is optional. If left off, all element types are allowed. EL_ALL contains the combination of all the above type codes. One or more types can be removed from the mask by subtraction. When forming the mask, remember to use a keyword only once whether adding or subtracting.

Example
The following code segment enables the symbol to obtain an arc or a line from the operator using snap or precision key-in:
int2 retpttype, reteletype . . Call Display_Message (Identify arc or Call Get_Point (pt_snap+pt_prec, point reteletype, el_arc+el_line) if (retpttype .eq. pt_snap) then if (reteletype .eq. EL_ARC) then . . else ! . . endif else ! . . endif

line) [101], retpttype, ! is it a snap point? ! an arc was snapped to

it must be EL_LINE

it must be precision

104

_ _______________
Move Along Arc
The Move Along Arc primitive returns a destination point (after traversing a specified distance along a given arc) from a given point.

Move Along Arc

Syntax
Call Move_Along_Arc (arc_definition, from_pt, to_pt, travel dist, out_pt)

Options
arc_definition An input buffer of four points identifying a circular arc in local coordinates. The subroutine uses it to find the angular position or sweep of the arc segment about the center (first point). The center of the arc and the from_pt are used to find the trace radius. An input to identify the measuring start point. It is also used to compute the radius of the circular arc. Global or local point. An input to identify the measuring end point. This point only establishes an angular position on the arc determined from the first two arguments. Therefore, it may or may not be on the arc itself. Global or local point. An input to specify the peripheral traversal distance from from_pt to to_pt. An output location containing the destination point. The direction of travel if either from_pt or to_pt is off. The curve is given by the connecting segment from from_pt to to_pt through the arcs end nearer the off-point.

2.Structure

from_pt

to_pt

travel_dist out_pt

Example
In the following example, the Get Point call forces the operator to snap only to an arc. On return, the arc definition is obtained in point_2 ... point_5. The length of the arc is then computed by sending the third call the center (point [2]), start (point [3]), the end (point [5]), and the arc itself. Finally, the middle point (point [10]) on the arc is calculated by moving along the arc from start (point [3]) toward the end (point [5]). The distance traveled is one-half the arcs size.
int2 ret_pt_type, ret_ele_type . . Call Get_Point (pt_snap, point [1], ret_pt_type, ret_ele_type, el_arc) Call Get_Arc_Point (point [2]) Call Get_Arc_Size (point [2], point [3], point [5], length) Call Move_Along_Arc (point [2 ], point [3], point [5], length/2, point [10]) ! find the middle

105

_ _______________
PDS Eden for Equipment - April 2002

Move Along Axis


The Move Along Axis primitive is similar to the Move By Distance primitive except that Move Along Axis allows you to move the active point a specified distance along any specified axis of the active orientation.

Syntax
Call Move_Along_Axis (distance, axis)

Options
distance axis Variable or constant that defines the distance by which the active point should be moved. Keyword defining the axis along which the active point should be moved. Valid values for axis include: PRIMARY SECONDARY NORMAL EAST WEST NORTH SOUTH UP DOWN

Example
In this example, the active point is moved 24 subunits in the east direction.
Call Define_Active_Orientation (NORTH, EAST) Call Move_Along_Axis (24., SECONDARY)

106

_ _______________
Move Along Line
The Move Along Line primitive returns a destination point given the direction of travel, a starting point, and a distance of travel.

Move Along Line

Syntax
Call Move_Along_Line (from_line_end, to_line_end, from_pt, distance, to_pt)

Options
from_line_end to_line_end The starting input point for computing the direction of travel. Global or local point. The ending input point for computing direction of travel. Global or local point. FROM_LINE_END and TO_LINE_END merely determine the direction and not the actual path of travel.

2.Structure

from_pt distance to_pt

The input point from which the travel begins. Global or local point buffer. The input variable containing the distance of travel. The output location variable containing the destination point. Use global or local point buffer.

Example
In the following example, the code fragment finds the midpoint of the line segment obtained with two Get Point calls.
. . Call Get_Point (pt_snap, point Call Get_Point (pt_snap, point Call Get_Line_Size (point [1], distance = distance/2 Call Move_Along_Line (point_1, . .

[1]) [2]) point [2], distance) point [2], point [1], distance, point[3])

107

_ _______________
PDS Eden for Equipment - April 2002

Move By Distance
The Move By Distance primitive allows you to move the active point along the primary axis of the active orientation.

Syntax
Call Move_By_Distance (distance)

Options
distance Variable or constant that dictates how far along the primary the active point should be moved. Negative values can be used.

Example
In the following example, the active point is moved 24 subunits in the up direction:
Call Define_Active_Orientation (UP, WEST) Call Move_By_Distance (24.)

In this example, the active point is moved by the distance defined by the variable dimension_a.
Call Move_By_Distance (dimension_a)

108

_ _______________
Move Data
The Move Data primitive writes contents of a variable or expression into another variable.

Move Data

Syntax
Call Move_Data (source_item, destination_item)

Options
2.Structure
source_item destination_item A variable or expression from which data will be moved without conversion. Variable into which data will be moved. Length of data moved is length of the shorter item. If destination_item is a character variable, each source_item byte must be ASCII (32 or more) before it is transferred. Otherwise, characters up to but excluding the first non-ASCII byte make up the destination_item.

This routine is mainly useful for the Read Table primitive where INPUT/OUTPUT contains CHARACTER fields. The following code segment shows how to access such data:
input_1 = 20 Call Move_Data (col3_key, INPUT_2) Call Read_Table (TABLE_SO_AND_SO, INPUT, OUTPUT Call Move_Data (OUTPUT_4, CSTRING_1) ! ! ! ! ! ! INPUT_2 is ASCII field Read table output_4 from table is ... ASCII. Move it into ... global ASCII ... variable CSTRING_1

109

_ _______________
PDS Eden for Equipment - April 2002

Move To Placepoint
The Move To Placepoint primitive allows you to restore both the active point and orientation to that of a previously defined place point.

Syntax
Call Move_To_Placepoint (pp)

Options
pp A keyword specifying the previously defined place point. Valid values include: PP1 - PP10

Example
In this example, place point 2 is defined with an orientation of primary pointing east and secondary pointing north. The call Move To Placepoint sets the active point at the location of placepoint 2 and restores the active orientation to east and north.
Call Define_Active_Orientation (EAST, NORTH) Call Define_Placepoint (PP2, POINT_0) . . . Call Move_To_Placepoint (PP2)

110

_ _______________
Place COG
The Place COG primitive allows you to place the center of gravity (COG) for a piece of equipment. There can be at most two centers of gravity per piece of equipment, each designated by a different keyword. The call is ignored if no datum points are being placed for the piece of equipment since the location of the COG is relative to the first datum point. Define Datum Point for dp1 must be executed before or after this call. Graphics are not created for COGs. Only numeric offsets are stored with the datum point to indicate the location.

Place COG

Syntax
Call Place_Cog (cog_type, offset_x, offset_y, offset_z)

2.Structure

Option
cog_type Keyword specifying the type of center of gravity you want to place. If a cog type already exists, it is replaced with the new definition. The following keywords are accepted: DRY OPERATING_1 OPERATING_2 LIFTING offset_x offset_y Distance specifying the easting of the COG in the local coordinate system of the first datum point. Distance specifying the northing of the COG in the local coordinate system of the first datum point. Distance specifying the elevation of the COG in the local coordinate system of the first datum point.

offset_z

Example
In the following example, the code locates the dry cog for the equipment with easting, northing, and elevation at 10.0, 20.0, and 30.0 units from pnt[1] in the coordinate system of datum point 1:
location pnt[6] pnt [1] = 1 pnt [2] = 2 pnt [3] = 3 Call Define_Active_Orientation (WEST, NORTH) Call Define_Datum_Point (dp [1], pnt [1]) Call Place_Cog (DRY, 10.0, 20.0, 30.0)

Since the location and orientation of the first datum point is known, we see that in symbol local coordinates, the COG is at:

111

_ _______________
PDS Eden for Equipment - April 2002 10.0 - 1 = 9.0 20.0 + 2 = 22.0 30.0 - 3 =27.0 WESTING NORTHING DOWN

112

_ _______________
Position Cursor
The Position Cursor primitive allows you to position the cursor at an input field on the active symbol tutorial.

Position Cursor

Syntax
Call Position_Cursor (fieldno)

Options
2.Structure
fieldno A key-in field number on the active tutorial.

113

_ _______________
PDS Eden for Equipment - April 2002

Put Field
The Put Field primitive allows you to display a value in a tutorial field. It works similarly to default expressions. After the value is evaluated, it must correspond to the numeric/character data type defined for the field.

Syntax
Call Put_Field (value, fldno, ret_code)

Options
value A variable or expression that evaluates to the value to be input to the field. Character fields must receive character data, and numeric fields must receive numeric data. No data conversion between the two types is performed, and such type mismatch causes errors. A field number on the active tutorial. Possible values are 1 - 200 (since only these fields are defined via TDF). Default computations are also performed if necessary as a result of fldno being defined. [optional] A numeric variable to receive completion status of the call. If successful, a 0 is returned. Expect negative values if the call completes unsuccessfully. Such abnormal return may be possible due to: Nonexistent field numbers. Incompatible type conversion. No tutorial being active. Errors in computing defaults will be acknowledged only through system messages in the ER field. By omitting it, you can ensure that the symbol execution is aborted if the call fails to successfully complete. In the case of computing defaults, the call successfully returns.

fldno

ret_code

Example
In the following example, the call puts out 10 in field #2 of the active tutorial. If DIMENSION_2 corresponds to field #2, it also receives a value of 10.0.
Call Put_Field (10, 2)

114

_ _______________
Read Table
The Read Table primitive allows you to read values from a table for use in your symbol definition. This process is called a table lookup. Refer to Reference Data Manager (PD_DATA) Reference Guide for information on the valid naming formats for tables and the valid units that can be used in tables.

Read Table

Syntax
Call Read_Table (table_name, INPUT, OUTPUT, return_code)

2.Structure

Options
table_name INPUT Name of the table to be read. This argument can be a string variable or constant. The global variable name INPUT. Table input parameters must be defined prior to calling Read Table. The number and type of values needed in INPUT_1...INPUT_10 array depends on the number and type of input columns defined for the table. An INPUT_X parameter may be a number or a character string up to eight characters. Assigning numerical data to INPUT elements is not a problem. Character data, however, must be treated differently since INPUT is a REAL array. Characters cannot be assigned to its variables. You must use the Move Data primitive. Refer to the Move_Data primitive for sample usage. Global variable name OUTPUT. The table values read are stored in OUTPUT. You must know the table structure in order to know where each output from the table is stored. An OUTPUT_X field can be numeric or alphanumeric (up to eight characters) depending on the table structure. Refer to the Move Data primitive for accessing character data once it is retreived in an OUTPUT_X variable. [optional] The output argument allowing symbol execution to continue if the call fails to read a table. If supplied, the values returned include: 0 - table read successfully 3 - table not in table library / library not attached 6 - invalid inputs for table look-up.

OUTPUT

return_code

Example
In this example, a table is read obtaining a flange diameter and thickness. The table name is derived from character constants, the flange generic end prep, and the flange pressure rating. The table input is the flange nominal pipe size. The flange diameter is taken from global variable OUTPUT_1, while the flange thickness is taken from global variable OUTPUT_2.
INPUT_1 = Nom_Pipe_D table = BLT // GEN_TYPE // PR_RATING // 5 Call Read_Table (table, INPUT, OUTPUT) flange_diam = OUTPUT_1 flange_thk = OUTPUT_2

115

_ _______________
PDS Eden for Equipment - April 2002 In this example, a table is read obtaining the outside diameter of a pipe given the nominal pipe diameter.
INPUT_1 = Nom_Pipe_D Call Read_Table (MAL_300_5, INPUT, OUTPUT) pipe_od = OUTPUT_3

116

_ _______________
Retrieve Nozzle Parameters
The Retrieve Nozzle Parameters primitive allows you to make all parameters for a specified nozzle the active parameters.

Retrieve Nozzle Parameters

Syntax
Call Retrieve_Nozzle_Parameters (noznum)

Options
noznum The number that identifies the nozzle whose parameters are to be made active.

2.Structure

After a call to Retrieve Nozzle Parameters, the following global variables are defined with values for the nozzle identified by noznum: END_PREP - the nozzles end preparation PR_RATING - the nozzles pressure rating NOM_PIPE_D - the nozzles nominal pipe size NOZ_LENGTH1 - the nozzles length (for type 2 and 3 only) NOZ_LENGTH2 - the nozzles 2nd length (for type 3 only) NOZ_RADIUS - the nozzles bend radius (for type 3 only) GEN_TYPE - the nozzles generic end prep TERM_TYPE - the nozzles termination type TABLE_SUFFIX - the current nozzle table suffix STD_TYPE - the current nozzle standard type The method by which you can set these variables for each nozzle is discussed in the User Interface section. Once set, they can be activated in the symbol by calling Retrieve Nozzle Parameters.

Example
In this example, the nozzle parameters for nozzle number 3 are activated. Nozzle number 3 is then placed.
Call Retrieve_Nozzle_Parameters (3) Call Define_Nozzle (NOZ2, 3, 1)

In this example, any value you put in the global variable NOZ_LENGTH1 is overridden by the symbol. In this case, the nozzle projection or length is set to the vessel diameter plus 10 subunits.
Call Retrieve_Nozzle_Parameters (5) NOZ_LENGTH1 = vessel_dia + 10. Call Define_Nozzle (NOZ2, 5, 1)

117

_ _______________
PDS Eden for Equipment - April 2002 Only NOZ_LENGTH1, NOZ_LENGTH2, NOZ_RADIUS, and TABLE_SUFFIX can be calculated as in this example. All other nozzle parameters must be specified by input fields on a tutorial. NOZ_LENGTH1, NOZ_LENGTH2, NOZ_RADIUS, and TABLE_SUFFIX must be set after the call to Retrieve_Nozzle_Parameters. If one of these values is set before the call, it will be lost when the call is made.

118

_ _______________
Rotate Orientation
The Rotate Orientation primitive allows you to rotate the active local orientation relative to itself. The coordinate system is rotated about the designated axial direction through the specified angle according to the right-hand rule. When you call this primitive, you change the local symbol orientation without affecting the design file coordinate system.

Rotate Orientation

Syntax
Call Rotate_Orientation (angle, axis)

2.Structure

Options
angle axis Variable or constant that dictates the amount of rotation. Keyword that defines the local axial direction about which to rotate. Valid keywords include: PRIMARY SECONDARY NORMAL EAST WEST NORTH SOUTH UP DOWN

Example
After the last statement is executed, the new primary is oriented down.
Call Define_Active_Orientation (EAST, NORTH) . . . . Call Rotate_Orientation (90, SECONDARY)

119

_ _______________
PDS Eden for Equipment - April 2002

Start Complex Shape


The Start Complex Shape primitive informs the system that linear elements (line, linestring, arc) to be placed subsequently are to be accumulated by the system and grouped as a complex shape. The elements must maintain a continuous flowline when they are sequentially traced through their vertices or end points. (This is a requirement for MicroStation complex shape elements.) The 0 only supplies a nonempty argument list.

Syntax
Call Start_Complex_Shape (0)

Example
call START_COMPLEX_SHAPE (0) Call Move_To_Placepoint (PP1) Call Define_Active_Orientation (NORTH,EAST) call draw_line (point [1], point [2]) call rotate_orientation (end_angle, normal) call draw_line (point [2], point [3]) Call Move_To_Placepoint (PP1) Call Define_Active_Orientation (NORTH,EAST) call draw_line (point [3], point [4]) call rotate_orientation (start_angle, normal) call draw_arc (inner_dia, inner_dia, 0.0, angle_sweep)! call STOP_COMPLEX_SHAPE (0)

Call Stop_Complex_Shape must be called to notify the system that the last element in the complex shape has been defined. One complex shape can remain in effect for each BEGIN call category, and the system keeps track of all such complex shapes. A default Stop Complex Shape is executed by the system following the element placed last inside a BEGIN category. Any number of complex shapes can be created in a category with pairwise start/stop calls.

120

_ _______________
Stop Complex Shape
The Stop Complex Shape primitive informs the system that the complex shape under progress is complete.

Stop Complex Shape

One complex shape can remain in effect for each BEGIN call category, and the system keeps track of all such complex shapes. A default Stop Complex Shape is executed by the system following the element placed last inside a BEGIN category. Any number of complex shapes can be created in a category with pairwise start/stop calls.

Syntax
2.Structure
Call Stop_Complex_Shape (0)

Example
call START_COMPLEX_SHAPE (0) Call Move_To_Placepoint (PP1) Call Define_Active_Orientation (NORTH,EAST) call draw_line (point [1], point [2]) call rotate_orientation (end_angle, normal) call draw_line (point [2], point [3]) Call Move_To_Placepoint (PP1) Call Define_Active_Orientation (NORTH,EAST) call draw_line (point [3], point [4]) call rotate_orientation (start_angle, normal) call draw_arc (inner_dia, inner_dia, 0.0, angle_sweep)! call STOP_COMPLEX_SHAPE (0)

121

_ _______________
PDS Eden for Equipment - April 2002

Store Orientation
The Store Orientation primitive allows you to store and recall orientations.

Syntax
Call Store_Orientation (save_retrieve_flag, orientation_no)

Options
save_retrieve_flag The value indicating whether active orientation is: being stored (=2) recalled (=1) orientation_no The orientation location number. Valid values include: 1 - 10 local orientation location (known to the current symbol or user function only). global orientation location (known to all main symbol and user function calls).

11 - 20

Example
In this example, the call saves the active orientation into local orientation buffer 8. Later, the active orientation can be restored to its original value:
Call Store_Orientation (2, 8) . . . Call Store_Orientation (1, 8)

122

_ _______________
Store Nozzle Parameters
The Store Nozzle Parameters primitive allows you to make the active nozzle parameters the parameters for a specified nozzle. Before using this primitive, call the Define_Nozzle primitive to allow you to make modifications at a later time.

Store Nozzle Parameters

Syntax
Call Store_Nozzle_Parameters (NOZNUM)

2.Structure

Options
noznum The number that identifies the nozzle whose parameters are to be initialized from the active parameters.

Example
In the following example, the code allows you to modify the NOZ_LENGTH1 of nozzle number 3. (Refer to the Retrieve_Nozzle_Parameters primitive for more information on nozzle global variables affected by this primitive.)
Call Retrieve_Nozzle_Parameters (3) NOZ_LENGTH1=NOZ_LENGTH/2.0 Call Store_Nozzle_Parameters (3)

123

_ _______________
PDS Eden for Equipment - April 2002

User Function
The User Function primitive allows you to call another Eden module compiled as a user function. The User Function module is similar to a SYMBOL_PROCESSOR module, except the first statement reads: User_Function_Definition MODULE-NAME where module-name is a character string (1 to 20 characters) identifying the module being compiled. The User_Function call causes the system to retrieve and execute the module from the Eden library. Please note the following conventions: 1. The set of local variables in the calling module is completely separate from that in the called module. Variables named the same between two modules do not share data or conflict with one another. Data sharing can be done through the global variables as they are used in common. Calls can be nested to any depth with a user function calling itself or other user functions.

2. 3.

Syntax
Call User_Function (module-name, argument1, argument2,....argument9)

Options
module_name arguement1 . arguement9 . The name of user function to execute. The numeric values to pass to the called user function. These are optional arguments and can be omitted from the right end. Values are passed via global variables INPUT_11 through INPUT_19. These are loaded from the optional arguments. Unused variables are zeroed out. INPUT_20 contains the number of optional arguments supplied. OUTPUT_11 through OUTPUT_20 are zeroed out when a user function is called. They can also be used to pass results. The modules are delivered with the Eden Interface allowing you to build certain common shapes not directly supported by any Eden primitive. These functions make use of the Draw Complex Surface primitive to create solid shapes by placing arcs and line strings individually. You can call these user functions much like any other Eden primitive by including arguments in the User_Function statement. You can obtain the source file name for a particular user function by adding the extension .UF to the function name.

124

_ _______________
User Function FLAT_OVAL_PRISM
The FLAT_OVAL_PRISM user function allows you to place a flat oval prism with faces parallel but offset from each other along both the secondary and normal axes.

User Function FLAT_OVAL_PRISM

2.Structure

It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection and the normal of both faces. The active secondary axis orients the flat sides of the faces.

Syntax
Call User_Function (FLAT_OVAL_PRISM, projlen, length1, depth1, length2, depth2, offset1, offset2, update_flg)

Options
projlen length1 depth1 length2 depth2 offset1 offset2 update_flg Length of projection. Flat segment length of first face. Depth of first face. Flat side length of second face. Depth of second face. Offset of second face from the first face along the secondary axis. Offset of second face from the first face along the normal axis. 0: 1: Dont update active point and orientation upon exit (default). Update active point and orientation to the opposite face upon exit.

125

_ _______________
PDS Eden for Equipment - April 2002

User Function FLAT_OVAL_TOR


The user function FLAT_OVAL_TOR allows you to place a flat oval torus.

It is placed by a point in the middle of the starting face. The active primary axis is the normal of the starting face. The active secondary axis points to the center of rotation, and the active normal axis is the axis of rotation.

Syntax
Call User_Function (FLAT_OVAL_TOR, bend_radius, sweep_angle, length, depth, face_angle, update_flg)

Options
bend_radius sweep_angle length depth face_angle Distance from center of starting face to the center of rotation. Revolved angle. Flat segment length of face. Depth of face. Angle between the flat side of the starting face and the secondary axis. (For a torus rotated about an axis parallel to the flat sides, this is 90 degrees. For a torus rotated about an axis parallel to the curved sides, this is 0 degrees.) 0: 1: Dont update active point and orientation upon exit (default). Update active point and orientation to the opposite face upon exit.

update_flg

126

_ _______________
User Function FLAT_OVAL_SEG_TOR1
The FLAT_OVAL_SEG_TOR1 user function allows you to place a segmented flat oval torus.

User Function FLAT_OVAL_SEG_TOR1

2.Structure

It is placed by a point in the middle of the starting face. The active primary axis orients the direction of projection of the first segment and is normal to the first face of the first segment. The active secondary axis points to the center of rotation. Rotation occurs around the flat sides using the active normal as the axis of rotation.

Syntax
Call User_Function (FLAT_OVAL_SEG_TOR1, bend_radius, seg_angle, num_seg, length, depth, update_flg)

Options
bend_radius seg_angle Length from center of rotation to middle of starting face (>0). Angle between segments (between 0 and 180 degrees as measured between two cross-sections). Number of segments (between 2 and 30 inclusive). Flat segment length of face. Depth of face (half of this depth must be well within the bend_radius). 0: 1: Dont update active point or orientation upon exit (default). Update active point and orientation to the last face upon exit.

num_seg length depth update_flg

127

_ _______________
PDS Eden for Equipment - April 2002

User Function FLAT_OVAL_SEG_TOR2


The FLAT_OVAL_SEG_TOR2 user function allows you to place a segmented flat oval torus.

It is placed by a point in the middle of the starting face. The active primary axis orients the direction of projection of the first segment and is normal to the first face of the first segment. The active secondary points to the center of rotation. Rotation occurs around the curved sides using the active normal as the axis of rotation.

Syntax
Call User_Function (FLAT_OVAL_SEG_TOR1, bend_radius, seg_angle, num_seg, length, depth, update_flg)

Options
bend_radius seg_angle Length from center of rotation to middle of starting face (>0). Angle between segments (between 0 and 180 degrees as measured between two cross-sections). Number of segments (between 2 and 30 inclusive). Flat segment length of face. Depth of face (half of this depth must be well within the bend_radius). 0: 1: Dont update active point or orientation upon exit (default). Update active point and orientation to the last face upon exit.

num_seg length depth update_flg

128

_ _______________
User Function ROUND_SEG_TOR1
The user function ROUND_SEG_TOR1 allows you to place a segmented round torus.

User Function ROUND_SEG_TOR1

2.Structure

It is placed by a point in the middle of the starting face. The active primary axis orients the direction of projection of the first segment and is normal to the first face of the first segment. The active secondary points towards the center of rotation, and the active normal defines the axis of rotation. Cylinders are used to represent the segments.

Syntax
Call User_Function (ROUND_SEG_TOR1, bend_radius, seg_angle, num_seg, radius, update_flg)

Options
bend_radius seg_angle Length between center of rotation and center of starting face (>0). Angle between segments (between 0 and 180 degrees as measured between two cross-sections). Number of segments (at least 2). Cross-sectional radius of any segment (this value must be well within the bend_radius). 0: 1: Dont update active point or orientation upon exit (default). Update active point and orientation to the last face upon exit.

num_seg radius

update_flg

HLINE in certain views may not work cleanly around the junction of segments placed with this user function. User function ROUND_SEG_TOR2, however, works correctly with HLINE even though it is more expensive in terms of design file space.

129

_ _______________
PDS Eden for Equipment - April 2002

User Function ROUND_SEG_TOR2


The user function ROUND_SEG_TOR2 allows you to place a segmented round torus.

It is placed by a point in the middle of the starting face. The active primary axis orients the direction of projection of the first segment and is normal to the first face of the first segment. The active secondary points towards the center of rotation, and the active normal defines the axis of rotation. Projected shapes are used to represent the segments.

Syntax
Call User_Function (ROUND_SEG_TOR2, bend_radius, seg_angle, num_seg, radius, update_flg)

Options
bend_radius seg_angle Length between the center of rotation and the center of starting face (>0). Angle between segments (between 0 and 180 degrees as measured between two cross-sections). Number of segments. Cross-sectional radius of any segment. (This value is well within the bend_radius.) 0: 1: Dont update active point or orientation upon exit (default). Update active point and orientation to the last face upon exit.

num_seg radius

update_flg

130

_ _______________
User Function RECT_SEG_TOR
The user function RECT_SEG_TOR allows you to place a segmented rectangular torus.

User Function RECT_SEG_TOR

2.Structure

It is placed by a point in the middle of the starting face. The active primary axis orients the direction of projection of the first segment, and the normal of the first face of the first segment. The active secondary axis points to the center of rotation. The active normal defines the axis of rotation.

Syntax
Call User_Function (RECT_SEG_TOR, bend_radius, seg_angle, num_seg, length1, length2, update_flg)

Options
bend_radius seg_angle Distance between center of rotation and center of first face (>0). Angle between segments (between 0 and 180 as measured between crosssections). Number of segments (at least 2; at most 30). Length of face along the secondary axis. Length of face along the normal axis. 0: 1: Dont update active point and orientation upon exit (default). Update active point and orientation to the last face upon exit.

num_seg length1 length2 update_flg

131

_ _______________
PDS Eden for Equipment - April 2002

User Function RECT_FLAT_OVAL


The user function RECT_FLAT_OVAL allows you to place a rectangular to flat oval transitional element with faces parallel but offset from each other along both the secondary and normal axes.

It is placed by a point in the middle of the rectangular face. The active primary axis orients the direction of projection and the normal of each face. The active secondary orients the flat sides of the flat oval shape.

Syntax
Call User_Function (RECT_FLAT_OVAL, projlen, length1, depth1, length2, depth2, offset1, offset2, update_flg)

Options
projlen length1 depth1 length2 depth2 offset1 offset2 update_flg Length of projection. Length of rectangular face along the secondary axis. Depth of rectangular face along the normal axis. Flat segment length of flat oval face along the secondary axis. Depth of flat oval face along the normal axis. Offset of flat oval face from rectangular face along the secondary axis. Offset of flat oval face from rectangular face along the normal axis. 0: 1: Dont update active point or orientation upon exit (default). Update active point and orientation to the flat oval face upon exit.

132

_ _______________
User Function ROUND_RECT
The user function ROUND_RECT allows you to place a round to rectangular transitional element with faces parallel but offset from each other along both the active secondary and normal axes.

User Function ROUND_RECT

2.Structure

It is placed by a point in the middle of the round face. The active primary axis orients the direction of projection and the normal of each face. The active secondary axis orients a flat side of the rectangular face.

Syntax
Call User_Function (ROUND_RECT, projlen, radius, width, depth, offset1, offset2, update_flg)

Options
projlen radius width depth offset1 offset2 update_flg Length of projection. Radius of round face. Width of rectangular face along the secondary axis. Depth of rectangular face along the normal axis. Offset of rectangular face from round face along the secondary axis. Offset of rectangular face from round face along the normal axis. 0: 1: Dont update active point and orientation upon exit (default). Update active point and orientation to the rectangular face upon exit.

133

_ _______________
PDS Eden for Equipment - April 2002

134

_ _______________
3. Creating a New Equipment Component

Creating a New Equipment Component

Setup for Equipment


Before a new equipment component can be defined through Eden, the following items must be performed: 1. 2. Log in to the server where the PDS project resides. Create a directory for the equipment symbol definition files, for example: c:\projects\custom\eqpsym 3. Create a directory for the tutorial definition files (TDF), for example: c:\projects\custom\tdf

3.New

4.

Create a directory for the graphic libraries, for example, c:\projects\custom\libs

5.

Copy the standard delivered equipment libraries into the created library directory, for example: copy c:\win32app\ingr\pdeqp\*.l* c:\projects\proj1\libs\.

6.

Access the Reference Database Defaults form, and define the node name and path to the directories previously defined. Start the PD_Shell main form. Select the project and select the Reference Data Manager option. Select the Default Project Control Data option. Key in the path and node name for the created directories. Equipment Eden Path: Equipment Eden node: TDF Table Path: TDF Table node: c:\projects\custom\eqpsym\ <server name> c:\projects\custom\tdf\ <server name>

135

_ _______________
PDS Eden for Equipment - April 2002 7. Access the Database Library File Manager form, and define the node name and directory path for the graphic data and table libraries. When testing new libraries in a live project, it is recommended to enter them as Not Approved. From the main PDS form, select the Equipment Modeling option. Select the Database Library File Manager option. Make sure that the node name and directory paths for all libraries are pointing to the right location. Also make sure that the library specifications are correct. For a U.S. standards project, the following specifications could be used: Graphic Commodity Lib Tutorial Definition Lib zi_eqpms.lib zi_tutlib.lib

The network address and directory paths for the previous two should be the ones specified in the sections above. Piping Physical Data Lib Piping Standard Note Lib Piping Job Spec Table us_pcdim.l std_note.l us_pjstb.l

The network address and directory paths for the previous three can be the locations defined for the project through the Reference Data Manager option. Cell Lib Forms Dir. c:\win32app\ingr\pdeqp\dat\equip.cel c:\win32app\ingr\pdeqp\<blank>

The network address for the previous two should be a server to which all workstations running PDS can mount. To revise an entry, follow these step: Identify the library to be checked. Place the cursor at the beginning of the key-in field of the entry to correct. Delete to the right of the cursor. Key in the correct value and press the return key. Accept the form when all the data for that single library is correct.

136

_ _______________
Default Project Control Data
This form allows you to define the default location for common reference files used by the project (such as neutral files, report files, and library files). You can change these file locations during the operation of the applicable managers. This form is accessed through reference data manager, not PD_EQP.

Default Project Control Data

3.New

Operating Sequence
1. Select the field to be defined, and key in the location of the source files and the associated node name. Piping Eden Path / Node Eden Table Path / Node The default location for the Eden source files. The default location of the Dimension Table and Spec Table source files. The default location for the neutral files to be used to load the Specification/Material Reference Database. The default location for the Piping Assembly Language source files. The default location for the Standard Note (code list) source files.

Piping Spec Path / Node

Assembly Path / Node Standard Note Library

137

_ _______________
PDS Eden for Equipment - April 2002 Equipment Eden Path / Node TDF Table Path / Node Model Builder Path / Node 2. The default location for the Equipment Eden source files. The default location for the Equipment table definition files. The default location for the model builder language source files. Select the Confirm ( ) button to accept any changes to the Project Control Data.

138

_ _______________
Extracting Sample Modules
When defining a new component, the first step is to have a sketch of the graphic symbol that will be used to represent that component. Since the equipment modeling software has various items from basic shapes to complex components available for placement, the Eden modules for existing equipment can be extracted and used as models to define new components. To extract the Eden modules for existing equipment, the items symbol processor name has to be known. To retrieve the symbol processor name (also referred to as the components Eden number) follow these steps: 1. 2. Turn to Appendix E, Parametrics of this document. Find the equipment parametric that would require the least number of modifications to make it appear as the graphics that will represent the new item. The Eden number appears listed between parenthesis next to the equipment parametric title (for example, through Ladder A (A021)).

Extracting Sample Modules

3.

Once the Eden number is known, you can extract the symbol processor for the existing item. To extract the Eden module for the symbol processor, follow these steps:

3.New

4. 5. 6. 7. 8.

Select the Equipment Modeling option from the main PDS form. Select the Graphic Library Manager option. Select the Eden Data Management option. Select the Extract option. Identify the symbol processor from the form, and select Confirm ( ). The system places the extracted modules in the symbols directory, eqpsym (or equivalent), previously created during setup.

To create a new components Tutorial Definition File (TDF), turn to the example in this documents first chapter or extract a sample TDF by following these steps: 1. 2. 3. 4. 5. Select the Equipment Modeling option from the main PDS form. Select the Graphic Library Manager option. Select the Tutorial Definition Data Management option. Select the Extract option. Identify the TDF from the form, and select Confirm ( ). The system places the extracted tables in the tdf directory created during setup.

139

_ _______________
PDS Eden for Equipment - April 2002

Editing Modules
After the Eden modules and TDF tables for existing components have been extracted, they can be used as models or modified as needed to make them generate a new component. It is recommended that the TDF and the form be created concurrently so that the symbol processor can be written to match the TDF and the form. Refer to the end of this chapter for information about form creation. To write user input into the database tables of equipment, the TDF table should include an entry for each attribute. Refer to the Equipment Eden Basics chapter to review the details about the TDF file.

140

_ _______________
Compiling New Modules
To compile newly created Eden modules they should be loaded to the existing graphic commodity library. New modules are compiled as they are loaded. If everything is correct in the code and compilation is completed, the new modules are incorporated into the graphic commodity library. Follow these steps to load and compile new Eden modules: 1. 2. 3. 4. 5. Select the Equipment Modeling option from the main PDS form. Select the Graphic Library Manager option. Select the Eden Data Management option. Select the Add/Replace option. Identify the symbol processors file name from the form. (For the system to be able to display new modules, their file name should have the .eqp extension.) Select the Add/Replace Selected Files option.

Compiling New Modules

6.

3.New

The system compiles and loads the new Eden module 7. If compilation errors occur, take note of the error messages, fix the symbol processors file, and then repeat the preceding steps.

To load a new components Tutorial Definition File (TDF), follow these steps: 1. 2. 3. 4. 5. Select the Equipment Modeling option from the main PDS form. Select the Graphic Library Manager option. Select the Tutorial Definition Data Management option. Select the Add/Replace option. Identify the TDF from the form. (For the system to be able to display new TDF files, their file name should have the .tdf extension.) Select the Add/Replace Selected Files option. The system loads the new TDF.

6.

141

_ _______________
PDS Eden for Equipment - April 2002

Revising Modules
After the Eden modules of a new component have been defined, place the new component in the equipment modeling environment to verify that it places correctly. Should the component not place correctly, follow these steps to revise the incorrect Eden module: 1. 2. 3. 4. 5. 6. Select the Equipment Modeling option from the main PDS form. Select the Graphic Library Manager option. Select the Eden Data Management option Select the Revise option. Identify the symbol processors file name from the form. Select the Revise Selected File option. The system brings the file up on the screen. 7. 8. 9. Proceed to make the needed changes. Then save the file, and exit the editor. Use the Add/Replace option to reload and compile the file just edited. Return to the equipment modeling environment, and test placing the new component.

To revise a new components Tutorial Definition File (TDF), follow these steps: 1. 2. 3. 4. 5. Select the Equipment Modeling option from the main PDS form. Select the Graphic Library Manager option. Select the Tutorial Definition Data Management option. Select the Revise option. Identify the TDF from the form, and select Confirm ( ). The system displays the file. 6. 7. Make the needed changes. Then save the file, and exit the editor. Return to the equipment modeling environment, and test placing the new component.

142

_ _______________
Basic Use of Forms
The DBACCESS product is used to create the forms needed to interact with the operator. When a new equipment item is defined through Eden some form customization may be required to make the new item accessible to the users. The fastest way to generate a new form or add a new option within an existing form is to copy and edit a standard delivered form. The following general procedure can serve as a guideline when creating a form that is to be linked to a new equipment item. Refer to the DBACCESS documentation for detailed information on using this product. 1. Create a working directory for modifying forms. This should be done on a workstation that has PDS loaded, or that has access to the server where PDS products are loaded For example, c:\name\forms 2. Copy a form used to place an existing component to the new forms directory. (Notice that the name of the form is the same as the components Eden number plus the .fb extension.) copy c:\win32app\ingr\pdeqp\forms\A001 3. forms\.

Basic Use of Forms

3.New

From the forms directory, access the DBACCESS interface. If you are familiar with the procedures used in piping and equipment modeling for identifying, accepting, and rejecting a selection using the mouse, you will find it easy to follow the prompts provided for each of the DBACCESS commands.

143

_ _______________
PDS Eden for Equipment - April 2002

Input Fields
Input fields can be used to collect several types of input: Dimensional input Angular input Integer input Nozzle dimensions Nozzle database attributes Equipment database attributes Character data input. The system assigns a unique field number to each input field. The tutorial definition table relays to the Equipment Modeling product what input type corresponds to a particular field number.

144

_ _______________
System-Defined Field Numbers
Field numbers 201 through 256 are reserved for system use. At present, nine of these reserved numbers have been defined: 201 Collects the place point by which a parametric is to be placed. If a field numbered 201 is placed on a tutorial, you can key in the place point number.

System-Defined Field Numbers

202 203 204

Collect and display the current active point. If fields with these numbers are placed on the tutorial, when the tutorial is activated, the active point (x, y, and z respectively) is displayed. You can also key in a new value for the active point into these fields. When a new active point is established by any other means, this display is automatically updated. Collect the delta (x, y, and z respectively) from the current active point.

205 206 207 208

Defines the angle from site north to equipment 0 degrees. For vertical equipment, the angle between site north and equipment 0 degrees is measured with respect to the secondary axis of the orientation tee. The primary axis of the orientation tee always points up.

3.New

For horizontal equipment, the angle between site north and equipment 0 degrees is measured with respect to the primary axis of the orientation tee. The secondary axis of the orientation tee always points up. 209 Defines the slope in terms of subunits per master unit of travel. The orientation tee is sloped from the horizontal with regard to sign. (An input of :6 in an English file would be interpreted as 6 inches per foot of travel and displayed in the tutorial as 6 in/ft.)

System-defined fields must be present in the tutorial definition table when they are present in a tutorial. You need only input the field number for these entries. All other columns in the table can be left blank or null. For example:

Example
201, , , , , , or 201,0,0,0,0,,

145

_ _______________
PDS Eden for Equipment - April 2002

Application Commands
Equipment tutorials can contain application commands as well as input fields. The two most important application commands that appear on every tutorial are ACCEPT and EXIT. ACCEPT EXIT Allows you to accept the data you keyed into the tutorial. Allows you to exit a tutorial with or without saving any modifications.

There are two types of application commands: user-defined and system-defined. System-defined application command numbers are predefined. User-defined application command numbers are calculated.

146

_ _______________
User-Defined Application Commands
User-defined application command numbers are used only for moving the keyboard cursor to a specific input field. This is accomplished by using an application command number of 3000 plus the number of the input field. For example, the application command number needed to move the cursor to field 5 on the form would be 3005. A user-defined application command is usually placed physically on top of the input field to which it applies. Thus, if you want to move the cursor to a specific input field, you need only select that field with a <D>, and the cursor will move to that particular field. You can also select the field from the sketch on the form. There is no restriction on using a given application command number in more than one place on the form. It is possible to have one command on top of the input field and another located in some other area on the form.

User-Defined Application Commands

System-Defined Application Commands


The system-defined application command numbers are outlined as follows: command number 4001 4002 4011 4012 4013 4014 4015 4016 4017 4018 4019 4020 4021 4022 4023 4024 4025 4026 4031 4032 4033

description

3.New

EXIT from tutorial ACCEPT tutorial inputs Place by place point 1 Place by place point 2 Place by place point 3 Place by place point 4 Place by place point 5 Place by place point 6 Place by place point 7 Place by place point 8 Place by place point 9 Place by place point 10 Orient active axis EAST Orient active axis NORTH Orient active axis UP Orient active axis WEST Orient active axis SOUTH Orient active axis DOWN Change axis of rotation Swap orientation Invert axis

COMMAND numbers 4021 through 4033 duplicate functions that are already on the Equipment Modeling command menu. They are provided here strictly for convenience. The commands on the menu are still active when a form is active.

147

_ _______________
PDS Eden for Equipment - April 2002 4051 to 4999 Application commands in this range have been set aside for terminated application command fields. If you select such a box with the data button, control returns to the symbol, which then decides how to handle the input. The information needed for the symbol as to the type and number of last input is saved by the system in global variables before return takes place. Refer to the DISPLAY_TUTORIAL primitive for more information.

148

_ _______________
Additional Features of the Form Interface
While a symbol placement form is active you can adjust the active point by: Snapping to an existing graphic. Selecting a Precision Point command. Boresite locating a key point. or you can adjust the active orientation by: Boresite locating a key point. Pressing <R> to rotate the active axis by 90 degrees. Selecting a Refresh Manipulation command. All MicroStation 32 and PDS commands that manipulate views can be selected. However, before continuing with form selections after view manipulations, you must first press <R> to exit the view command. Refer to the PDS Equipment Modeling (PD_EQP) Reference Guide for more information on placing equipment.

Additional Features of the Form Interface

3.New

149

_ _______________
PDS Eden for Equipment - April 2002

150

_ _______________
4. Defining Symbols
The previous sections explained the tools that you need to completely define an equipment symbol. This section outlines the basic steps you need to follow using these tools to prepare a complete symbol definition. The definition of a simple horizontal drum will be developed to illustrate the concepts. Basic Steps: 1. Determine what the component will look like and what primitive graphics elements you want to use to create it. For example, you want to define a drum that is composed of a cylinder, 2 semi-elliptical heads, and 2 projected rectangles to represent the saddle type supports. Determine what dimensional inputs should be required for placing a symbol based on availability. A symbol cannot be efficiently placed if, in order to provide inputs for a symbol, you perform hand calculations based on numbers from drawings. For the horizontal drum, you need the drum diameter, the tan-tan length of the drum, the support locations relative to a tangent line, and the support projection and thickness. Assume that the drum heads are 2:1 semi-elliptical and that the support width is .866 of the drum diameter. 3. Determine where place points are needed for the symbol and reasonable orientations for them. Again, consider the documents the symbol user is working from. Place points should be located on the equipment in places that can be located on a drawing that orients the equipment on the plot.

Defining Symbols

2.

On the drum, one reasonable place point location is at one of the tangent lines on the centerline. The place point orientation should be pointing inside the drum so that when the symbol is placed, the refresh tee primary will indicate the direction the symbol will be placed. In addition, the place point secondary axis should be oriented in the down direction so that the refresh tee secondary can be used to orient the supports.

4.Symbols

Another reasonable place point location on the drum is at the bottom center of one of the supports. At this place point, the primary points into the support, and the secondary orients the direction that the drum will be placed by pointing it at the other support. 4. Assign global variables to the input. This step allows design of the tutorial for the symbol. Variables should be assigned as follows: DIMENSION_1 DIMENSION_2 DIMENSION_3 DIMENSION_4 DIMENSION 5 - drum tan-tan length - drum diameter - tangent line to center of first support - center of first support to center of second support - support projection from drum centerline

151

_ _______________
PDS Eden for Equipment - April 2002 DIMENSION_6 5. Develop the symbol code. For the drum, the following code is needed: SYMBOL_PROCESSOR HDRUM tutnam = HDRUM call DISPLAY_TUTORIAL (tutnam) tantan= DIMENSION_1 diameter = DIMENSION_2 support_1 = DIMENSION_3 support_2 = DIMENSION_4 supp_proj = DIMENSION_5 supp_thk = DIMENSION_6 dish_depth = diameter /4 supp_wdth = diameter * .866 call DEFINE_ACTIVE_ORIENTATION (WEST, DOWN) call DRAW_SEMI_ELLIPSOID (diameter, dish_depth) call DEFINE_ACTIVE_ORIENTATION (EAST, DOWN) call DEFINE_PLACEPOINT (PP1, ACTIVE_POINT) call DRAW_CYLINDER (tantan, diameter) call DRAW_SEMI_ELLIPSOID (diameter, dish_depth) call MOVE_TO_PLACEPOINT (PP1) call MOVE_BY_DISTANCE (support_1) call DEFINE_ACTIVE_ORIENTATION (DOWN, SOUTH) call DEFINE_POINT (POINT_1, ACTIVE_POINT, 0., 0., 0.) call DRAW_PROJ_RECTANGLE (supp_wdth, supp_thk, supp_proj) call DEFINE_ACTIVE_ORIENTATION (UP, EAST) call DEFINE_PLACEPOINT (PP2) call DEFINE_ACTIVE_POINT (POINT_1) call DEFINE_ACTIVE_ORIENTATION (EAST, DOWN) call MOVE_BY_DISTANCE (support_2) call DEFINE_ACTIVE_ORIENTATION (DOWN, SOUTH) call DRAW_PROJ_RECTANGLE (supp_wdth, supp_thk, supp_proj) STOP END Explanation: In the above example, the SYMBOL_PROCESSOR statement and the STOP and END statements of the symbol definition are required. The drums orientation along the east-west axis of the symbol coordinate system is arbitrary. It can just as easily be oriented along the north-south axis. - thickness of support saddle

152

_ _______________
6. 7. 8. Compile the symbol. Create the form. Create the tutorial definition table. For the drum, the following table might be used: 1, 2, 3, 4, 5, 6, 7, 1, 1, 1, 1, 1, 1, 8, 1, 2, 3, 4, 5, 6, 1, , , , , , , , 2, 2, 2, 2, 2, 2, 2, , , F1/5, F1-F3, F2/2+10, 6, , LENGTH DIAMETER SUPP_1 SUPP_2 SUPP_PRJ SUPP_THK EQPNAME

Defining Symbols

Building the drum is similar to building the same piece of equipment using primitives in graphics. First, locate the active point. Then set the active orientation. Finally, place the primitive. Movement of the refresh tee after placement of the primitive is analogous to movement of the active point after placement of graphics in the Eden definition.

Insert the tutorial definition table into the tutorial definition library. 9. Test and debug the symbol. Three tutorials, provided and serviced by the system, can be of use during debugging. DEBUG1 You can display this tutorial several times in a single symbol allowing you to monitor variables DIMENSION_1 through DIMENSION_100 while a symbol is executing. This tutorial will also allow you to change values that are assigned to these variables. Allows you to monitor and change all of the variables associated with nozzles. You can also display this tutorial several times. Allows you to monitor the active point, active orientation, and all of the point buffers.

DEBUG2

4.Symbols

DEBUG3

To activate the debug tutorials, place the following call in your symbol definition: Call DISPLAY_TUTORIAL (DEBUGn) where n = 1, 2, or 3. If you want to debug the symbol interactively, call up the symbolic Eden Debugger when the symbol executes.

153

_ _______________
PDS Eden for Equipment - April 2002

154

_ _______________
5. Eden Debugger
Debugging Eden symbols can be time-consuming depending on the length and complexity of the symbol. Sometimes it is necessary to study symbol execution source line by source line to track down a bug. This can involve examining the contents of critical variables undergoing modification. One way of locating a bug is by inserting temporary tracer calls in the DISPLAY_MESSAGE primitives. This allows you to display a variable and the location of the diagnostic. However, this method of debugging is disruptive, time-consuming, and can introduce more bugs into your symbol code.

Eden Debugger

The Eden Debugger is part of the current Equipment Modeling software and can assist you in testing symbols efficiently and thoroughly. When using the Debugger, you can step through the symbol as it executes, examine or modify variables directly, and choose the source line number to execute next. All this can be done without modifying your original source code.

5.Debugger

155

_ _______________
PDS Eden for Equipment - April 2002

Invoking the Debugger


You can activate the Debugger in the Start, Add, Modify, or Modify & Copy commands at the symbol name prompt or any time the symbol tutorial is active. To activate the Debugger, key in: ON DEBUG If you key in ON DEBUG at the symbol name prompt and after a symbol name is accepted, the Debugger displays the source of the module and then prompts for the next input. If you key in ON DEBUG when the tutorial is active, the Debugger takes control after you return from the tutorial to the symbol. An arrow positioned by a source line indicates which line is to be executed next. When the symbol form is active, you must key in the command from the MicroStation key-in field and not from a tutorial field.

156

_ _______________
Exiting the Debugger
You can use the key-in OF DEBUG (off debug) to stop the debugger. This must be keyed in in the MicroStation Command Window.

Exiting the Debugger

5.Debugger

157

_ _______________
PDS Eden for Equipment - April 2002

Concurrent Display
Graphics resulting from symbol execution are not visible until you execute a Return/Stop/End statement. During debugging, it is sometimes useful to relate each DRAW call to the resulting graphics. For this reason, the concurrent display feature is provided. To display the graphics at the time of the CALL to a DRAW or PLACE routine, turn ON both the DEBUG and DISP mode. You can place the displayed graphics in the design file by keying in OF DISP just before the symbol code returns and the Eden buffer processing begins.

158

_ _______________
Debugger Commands
The Debugger is not case sensitive except for the Call Tutorial command. Embedded blanks are compressed out from any input line before the line is interpreted. The Debugger currently supports the following functions: Set Line Break (B) Call Tutorial (C) Deposit into Local Variable (DL) Deposit into Global Variable (DG) Examine Local Variables (EL) Examine Global Variables (EG) Examine Breaks (EB) Examine Symbol Name (ES) Move to Specific Source Line or Continue (Go) Access On-line Help (H) Step through Source Code (S) Step into User Function (SI) Switch the Prompt Terminal (P) Switch Modes (ON and OF) Examine Specific Source File Segments (Type)

Debugger Commands

5.Debugger

159

_ _______________
PDS Eden for Equipment - April 2002

Switch Modes (ON and OF)


Switch statements begin with ON or OF commands. The ON command allows you to turn on the Debugger and the File Displayer mode of graphics placement.

Syntax
ON ON OF OF DEBUG DISP DEBUG DISP

Options
DEBUG DISP Invokes the Debugger. Allows only symbol execution graphics to be displayed (via FILE DISPLAYER) and to not be actually placed in the design file.

The switch commands are accepted: In the Start and Add command when the system prompts you for the primitive/parametric name. At the MicroStation key-in field when a symbol tutorial is active. At a Debugger prompt.

160

_ _______________
Set Line Break (B)
The Set Line Break command allows you to interrup processing at a specified line. You can set up to 10 breaks per module. To examine the breaks set in the current module, key in E breaks or E b.

Set Line Break (B)

Syntax
B lineno

Options
lineno A valid line number in the executing module. When the execution reaches the lineno, the debugger stops processing and prompts you for the next command.

Example
The following example allows the Debugger to break at line 5.
b 5

To cancel this break, key in b -5.

5.Debugger

161

_ _______________
PDS Eden for Equipment - April 2002

Call Tutorial (C)


You must exit these tutorials before the Debugger reprompts.

Syntax
C DEBUGx

Options
x 1 2 3 Examines/modifies global variables DIMENSION_1..DIMENSION_100. Examines/modifies nozzle attributes. Examines/modifies active_point, active_orientation, and POINT_1 ...POINT_24. The tutorial name must be in upper case.

162

_ _______________
Deposit Global (DG)
The Deposit Global command allows you to modify values of global DIMENSION variables.

Deposit Global (DG)

Syntax
DG dimension_# = value

Options
dimension_# A global variable 1 ... 100.

Example
In the following example, the system places a value of 10.0 into DIMENSION_5;
DG 5 = 10.0

5.Debugger

163

_ _______________
PDS Eden for Equipment - April 2002

Deposit Local (DL)


The Deposit Local command allows you to modify the values of local variables. Only numeric type local variables can be modified.

Syntax
DL variable = value

Options
variable The name of a local variable in the module.

Example
In the following example, the real-typed variable in the symbol called RADIUS
DL RADIUS = 20.0

164

_ _______________
Examine Local Variables (EL)
Syntax
EL var1:var2

Examine Local Variables (EL)

Options
var1 var2 Alphanumeric character strings defining a valid lexical range of identifiers. The Debugger responds by listing the values of variables whose names are bracketed by var1 and var2.

Examples
In the following example, the command keyin displays all the local variables whose names start with A through Z:
EL A:Z

To examine a single variable, you can drop the semicolon and var2. In the following example, the system examines only the variable radius:
EL radius

The Debugger can display the entire array of 10 elements. In the following example, values is declared as R8 values [10]:
EL values

In some cases, a local array may start from an element other than 1. The syntax establishes var1 as the name of the local array and var2 as the subscript from which to examine the array. In the following example, the Debugger allows you to examine lengths [4] ... lengths [10] of the array declared as R8 lengths [10]:
EL lengths:4

5.Debugger

165

_ _______________
PDS Eden for Equipment - April 2002

Examine Global Variables (EG)


The Examine Global Variables command allows you to review the global variables DIMENSION, POINT, CSTRING, PP, INPUT, and OUTPUT via the Debugger.

Syntax for DIMENSION


Eg dimension_#1:dimension_#2

-OREg dimension_#

Options
dimension_# dimension_#1 dimension_#2 numbers from 1 through 100

Example
The following example displays the contents of DIMENSION_1 ... DIMENSION_5.
EG 1:5

Syntax for POINT


EG PT x

Options
x Number from 1 through 125.

Example
In the following example, the system displays the value of POINT [120] in subunits. The system also displays the coordinate system (6-point star) at POINT [x] location in design file coordinates.
EG pt 120

166

_ _______________
Syntax for CSTRING
EG CSTR x

Examine Global Variables (EG)

Options
x Number between 1 and 40.

The string length in CSTRING_X is indicated by the space between the two double quotes ("").

Example
After executing the key-in CSTRING [2] = This is an example, you can examine cstring_2 by keying in EG cstr 2. The system displays: CSTRING_2: "This is an example". The lengths of strings stored in CSTRING variables are important for proper functioning of string operations such .EQ., .LE., .GT. and so forth.

Syntax for PP
Eg PP x

Options
x A number between 0 and 10.

The value for the particular placepoint is displayed in local coordinates while the refresh tee is shown at the placepoints location in design file coordinates. When x is 0 (Eg pp0), the symbol active point and active orientation are displayed.

Syntax for INPUT and OUTPUT


EG input EG output

5.Debugger

Examine Symbol Name (ES)


The Examine Symbol Name command allows you to display the symbol name or its source file. The system displays the full source file and module name.

167

_ _______________
PDS Eden for Equipment - April 2002

Syntax
E Source E s

Examine Source File Segments (TYPE)


The TYPE command allows you to examine various segments of the source file.

Syntax
T from_line# : to_line#

Options
from_line# to_line# Source line number from which the viewed segment starts. Line number ending the viewed segment.

Examples
The following example displays a window of source lines containing line#.
T line#

The following commands display a source file segment containing only the current line.
T Type

Displays a source file segment scroll bar containing the current line.

Move to Specific Source Line or Continue (Go)


The Go command allows you to direct the DEBUGGER to a particular source line. The DEBUGGER goes directly to line# and displays a window of source lines around line#. The DEBUGGER prompts you for more input. This format of the Go command allows you to override the normal control flow and execute the source statements selectively. The Go command also allows the DEBUGGER to start executing from a current source line until it encounters a break. Keying in Go and pressing a carriage return will break you out of the source code.

168

_ _______________
Syntax
G line#

Examine Global Variables (EG)

or
Go line#

Options
line# Valid executable source line number between 1 and 1500.

Step through Source Code (S)


This command allows you to execute a number of statements in the usual order before the Debugger prompts you again.

Syntax
S #_of_lines

Options
#_of_lines Number of lines you want to execute before being reprompted. If #_of_lines is 1, the #_of_lines parameter can be omitted.

Step into User Function (SI)


The Step into User Function command allows you to step into a user function module. The command is executed when the current-line arrow points to a "call USER_FUNCTION (abcd)" statement. The screen is refreshed with source lines from the newly activated module. All commands are interpreted in the new context until a return/stop/end statement is executed. The DEBUGGER then returns to the calling module as does the control.

5.Debugger

Syntax
SI

169

_ _______________
PDS Eden for Equipment - April 2002

Switch the Prompt Terminal (P)


The Debugger accepts input from the form. The current Start, Add, Modify, or Modify & Copy commands can be canceled during a Debugger prompt only when the prompt terminal is MicroStation.

Syntax
P

170

_ _______________
Appendix A:

Codelist (CL330)

Appendix A Codelist (CL330)


Codelists
Use 2-199 for bolted types 300-399 for male types and 400-599 for female types. Refer to the Reference Data Manager (PD_DATA) Reference Guide for more information. 1 2 [Blank] FE

[Flanged end]

Use 11-15 for ends without integral gaskets and 16-19 for ends with integral gaskets. 10 11 16 FFTP FFFE FFFEWG Flat-face Flanged Termination tyPe (11-19) Flat-Face Flanged End Raised-Face Flanged End With integral Gasket

Use 21-25 for ends without integral gaskets and 26-29 for ends with integral gaskets. 20 21 26 RFTP RFFE RFFEWG Raised-face Flanged Termination tyPe Raised-Face Flanged End Raised-Face Flanged End With integral Gasket

Use 31-35 for ends without integral gaskets and 36-39 for ends with integral gaskets. 30 31 RJFTP RJFE RJT-face Flanged Termination tyPe (31-39) RJT-face Flanged End

Use 41-45 for ends without integral gaskets and 46-49 for ends with integral gaskets. 40 41 42 43 44 TMFTP STFE LTFE SMFE LMFE Tongue/Male-face Flanged Termination tyPe (41-49) Small-tongue-face Flanged End Large-tongue-face Flanged End Small-Male-face Flanged End Large-Male-face Flanged End

Use 51-55 for ends without integral gaskets and 56-59 for ends with integral gaskets. 50 51 52 53 54 GFFTP SGFE LGFE SFFE LFFE Groove/Female-face Flanged Termination tyPe Small-Groove-face Flanged End Large-Groove-face flanged End Small-Female-face Flanged End Large-Female-face Flanged End

Use 61-65 for lap-flanged ends without integral gaskets and 66-69 for lap-flanged ends with integral gaskets. 60 61 FFLFTP FFLFE Flat-Face Lap-flanged Termination tyPe Flat-Face Lap-Flanged End

Use 71-75 for lap-flanged ends without integral gaskets and 76-79 for lap-flanged ends with integral gaskets.

171

_ _______________
PDS Eden for Equipment - April 2002 70 71 RFLFTP PFLFE Raised-Face Lap-Flanged Termination tyPe Raised-Face Lap-Flanged End Use 81-85 for lap-flanged ends without integral gaskets and 86-89 for lap-flanged ends with integral gaskets. 80 81 RJFLFTP RJLFE RTJ-Face Lap-Flanged Termination tyPe RTJ-Face Lap-Flanged end

Use 91-95 for lap-flanged ends without integral gaskets and 96-99 for lap-flanged ends with integral gaskets. 90 91 92 93 94 TMFLFTP STLFE LTLFE SMLFE LMLFE Tongue/Male-Face Lap-Flanged Termination tyPe (91-99) Small-Tongue-Face Lap-Flanged End Large-Tongue-Face Lap-Flanged End Small-Male-Face Lap-Flanged End Large-Male-Face Lap-Flanged End

Use 101-105 for lap-flanged ends without integral gaskets and 106-109 for lap-flanged ends with integral gaskets. 100 101 102 103 104 GFFLFTP SGLFE LGLFE SFLFE LFLFE Groove/Female-Face Lap-Flanged Termination Type (101-109) Small-Groove-Face Lap-Flanged End Large-Groove-Face Lap-Flanged End Small-Female-Face Lap-Flanged End Large-Female-Face Lap-Flanged End

Use 111-115 for ends without integral gaskets and 116-119 for ends with integral gaskets. 110 111 116 FFTBTP FFTBE FFTBEWG Flat-Face Thru-Bolted Termination tyPe (111-119) Flat-Face Thru-Bolted End Flat-Face Thru-Bolted End With integral gasket

Use 121-125 for ends without integral gaskets and 126-129 for ends with integral gaskets. 120 121 126 RFTBTP RFTBE RFTBEWG Raised-Face Thru-Bolted Termination tyPe (121-129) Raised-Face Thru-Bolted End Raised-Face Thru-Bolted End With integral Gasket

Use 131-135 for ends without integral gaskets and 136-139 for ends with integralgasket. 130 131 RJTBTP RJTBE RTJ-face Thru-Bolted Termination tyPe (131-139) RTJ-face Thru-Bolted End

Use 141-145 for ends without integral gaskets and 146-149 for ends with integral gaskets. 140 146 MRJTBTP MRJTBEWG Male RTJ-face thru-Bolted Termination tyPe (141-149) Male RTJ-face thru-Bolted End With integral Gasket

Use 151-155 for ends without integral gaskets and 156-159 for ends with integral gaskets. 150 151 156 FFTBCSTP FFTBCSE FFTBCSEWG Flat-Face Thru-Bolted-with-Cap-Screws Termination tyPe (151-159) Flat-Face Thru-Bolted-with-Cap-Screws End Flat-Face Thru-Bolted-with-Cap-Screws End With integral Gasket

172

_ _______________
Appendix A: Use 161-165 for ends without integral gaskets and 166-169 for ends with integral gaskets. 160 161 166 RFTBCSTP RFTBCSE RFTBCSEWG Raised-Face Thru-Bolted-with-Cap-Screws Termination tyPe (161169) Raised-Face Thru-Bolted-with-Cap-Screws End Raised-Face Thru-Bolted-with-Cap-Screws End With integral Gasket

Codelist (CL330)

Codelists

Use 171-175 for ends without integral gaskets and 176-179 for ends with integral gaskets. 170 171 RJTBCSTP RJTBCSE RTJ-face Thru-Bolted-with-Cap-Screws Termination tyPe (171-179) RTJ-face Thru-Bolted-with-Cap-Screws Ends

Use 181-185 for ends without integral gaskets and 186-189 for ends with integral gaskets. 180 181 186 190 191 300 301 311 321 331 341 351 361 371 381 391 393 395 400 401 420 421 440 441 460 461 480 481 FFFTBTP FFFTBE FFFTBEWG MJTP MJE MTP BE TBE MFE MTE MGE MQCE MFRE MHE SPE PE 3"FFPE 6"FFPE STP SE SWTP SWE FTTP FTE FGTP FGE FQCTP FQCE Flat-Full-Face Thru-Bolted Termination tyPe (181-189) Flat-Full-Face Thru-Bolted End Flat-Full-Face Thru-Bolted End With integral Gasket Mechanical Joint Termination tyPe (190-199) Mechanical Joint End Male Termination tyPe Beveled End Tapered and Beveled End Male Flared End Male Threaded End Male Grooved End Male Quick Connect Point Male FerRule End Male Hose End SPigot End Plain End (391-399) 3" Field Fit Plain End 6" Field Fit Plain End Socket Termination tyPe (401-409) Socket End SocketWelded Termination tyPe (421-429) Socket End Female Threaded Termination tyPe (441-449) Female Threaded End Female Grooved Termination tyPe (461-469) Female Grooved End Female Quick Connect Termination tyPe (481-489) Female Quick Connect End

173

_ _______________
PDS Eden for Equipment - April 2002 500 501 520 521 540 541 590 591 600 601 650 651 FFRTP FFRE FHTP FHE BLTP BLE HTP HCE NTP NE UDTP UD Female FerRule Termination tyPe (501-509) Female FerRule End Female Hose Termination tyPe (521-529) Female Hose End BeLl End Termination tyPe (541-549) BeLl End Hole end Termination tyPe (581-599) Circular Hole End Null Termination tyPe (600-605) Null End User Defined Termination tyPe (651-659) User Defined end

When a UD preparation end is detected by the system in the piping materials class, it prompts you to define the actual CP preparation. The value you input is used for initial component placement as well as for subsequent re-creations of the piping system.

174

_ _______________
Appendix B:

Equipment Data Definition

Appendix B Equipment Data Definition


The database containing the equipment data definition information is located in c:\win32app\ingr\pdeqp\ddl\eqp.ddl. Each piece of equipment in an equipment model is linked to a database record that contains nongraphic information about that piece of equipment. You can supply the nongraphic information before placing the item in the model or at placement time via input fields on the placement form. Each database (or database partition) is composed of a set of database tables which represent categories of data. A database table is a defined set of attributes that describe an item. An attribute is a single type of information to be stored about an item. Each attribute has a name which describes the piece of information to be stored. The actual information stored in the database is referred to as the attribute value. This value is a fixed data type: numeric, alphanumeric or code-listed. Numeric data types can be either real (decimal) or integer. These attributes are used for quantitative values such as pressure or temperature. Alphanumeric data types (characters) are used for textual information such as equipment item names or descriptions. Code-listed data types are special integer values which help standardize and speed up data entry. A code list is a set of acceptable values for a particular attribute which can be referred to by an index number. By using the code list, you can enter the code-listed value instead of keying in all the characters each time a category is specified. A code listed attribute is an attribute whose value is defined using one of the selections from a particular code-list set. The name of an equipment item is the most important nongraphic piece of data in the database concerning that equipment item. The equipment name is used by piping modelers to refer to a piece of equipment while routing pipe. The name must be defined before an equipment item can be placed in the model. In addition to the database record for the equipment item, there is also a database record for each nozzle on the equipment item. These records store essential data about the nozzles needed by PD_Design.

DDL

175

_ _______________
PDS Eden for Equipment - April 2002

B.1

Equipment Group Database Table


The list of attributes for the equipment database table is displayed below. This list contains the attribute number, the attribute name, field description and, when necessary, the code-list number.
# equip_group table number = 21 , number of columns = 13 1 2 3 4 5 6 7 8 9 10 11 12 13 , , , , , , , , , , , , , equip_indx_no equip_no equip_descr_1 equip_descr_2 tutorial_no equip_class dry_weight oper_weight_1 oper_weight_2 insulation_thk construction_stat equipment_division approval_status , , , , , , , , , , , , , integer character(30) character(40) character(40) character(6) character(2) double double double double short , standard note 130 short , standard note 69 short , standard note 35

If any of the double values are left undefined, -32768 is assigned as a value.

176

_ _______________
Appendix B:

Equipment Nozzle Database Table

B.2

Equipment Nozzle Database Table


The list of attributes for the nozzle database table is displayed below. This list contains the attribute number, the attribute name, field description and, when necessary, the code-list number.
# equip_nozzle table number = 22, number of columns = 25 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 , , , , , , , , , nozzle_indx_no , integer nozzle_no , character(10) equip_index , integer nominal_piping_dia , short rating , character(8) preparation , short , standard note 330 piping_mater_class , character(16) unit_no , character(12) fluid_code , short , standard note 125 , unit_code , character(2) , line_sequence_no , character(6) , heat_tracing_reqmt , short , standard note 200 , heat_tracing_media , short , standard note 210 , insulation_purpose , short , standard note 220 , insulation_thk , double , table_suffix , short , standard note 576 , service , character(20) , schedule_thickness , character(8) , nor_therm_growth_X , double , nor_therm_growth_Y , double , nor_therm_growth_Z , double , alt_therm_growth_X , double , alt_therm_growth_Y , double , alt_therm_growth_Z , double , construction_stat , short , standard note 130

DDL

If any of the double values are left undefined, -32768 is assigned as a value.

177

_ _______________
PDS Eden for Equipment - April 2002

178

_ _______________
Appendix C:

EQP Eden Program Examples

Appendix C EQP Eden Program Examples


Example 1 (Use of loops):
This example demonstrates passing arguments to a User_Function using global variables and also reading equipment tables with character inputs.
! ! ! ! ! ! ! ! ! ==================================================================== USER_FUNCTION_DEFINITION PMPTBL

==================================================================== SUBROUTINE TO RETRIEVE NEMA MOTOR DIMENSIONS FROM A TABLE BASED UPON NEMA MOTOR FRAME NUMBER. THE TABLE, NAMED NEMA_MOTOR_DATA, IS HELD IN THE "EQUIPMENT TABLES" LIBRARY. INPUTSCSTRING [1] - NEMA MOTOR FRAME NUMBER DIMENSION_89 - INPUT FIELD NUMBER TO REPOSITION CURSOR IF ERROR DIMENSION_90 - ERROR MESSAGE FIELD NUMBER DIMENSION_91 - RETURN CODE (0=GOOD, NOT 0=BAD) DIMENSION_61 THRU DIMENSION_67 - TABLE OUTPUTS THE NEMA MOTOR FRAME NUMBER IS A CHARACTER STRING, FOR EXAMPLE: "140T". IT WOULD BE ASSIGNED TO INPUT_1 USING THE MOVE_DATA CALL.

Examples

! ! ! ! ! ! ! OUTPUTS-

NOTE:

! ==================================================================== ! msg_field = DIMENSION_90 input_field = DIMENSION_89 CALL MOVE_DATA (CSTRING_1, INPUTS [1]) if (INPUTS [1] .ne. ) then !not blank. Good sav_lib = ACT_LIB call DEFINE_LIBRARY (EQP_TABLES) !open new lib !symbol quits if open error call READ_TABLE (NEMA_MOTOR_DATA, INPUT, OUTPUT) do i = 1, 6 !move table outputs DIMENSION [60+i] = OUTPUTS [i] !into global vars enddo call DEFINE_LIBRARY (save_lib) !reopen commod lib so that !nozzles will place. else call DISPLAY_MESSAGE (Invalid motor frame number, msg_field) call MOVE_CURSOR (input_field) DIMENSION(91) = -2

179

_ _______________
PDS Eden for Equipment - April 2002
endif end

Example 2 (Use of arrays and loops):


A) Initializing variables.
DIMENSION_1 = 10 DIMENSION_2 = 10 . . . DIMENSION_10 = 10

B) Initializing variables using a Do loop.


do i = 1, 10 DIMENSION[i] = 10 enddo

Example 3 (Placing nozzles):


A) Placing nozzles.
location = DIMENSION_23 theta = DIMENSION_24 call DEFINE_ACTIVE_ORIENTATION (EAST, NORTH) call MOVE_TO_PLACEPOINT (PP1) call MOVE_ALONG_AXIS (PRIMARY, location) call DEFINE_ACTIVE_ORIENTATION (UP, EAST) call ROTATE_ORIENTATION (theta, NORMAL) call RETRIEVE_NOZZLE_PARAMETERS (20) call DEFINE_NOZZLE (NOZ2, 20, 1) . . .

B) Placing nozzles using an array and Do loop.


R8 theta(20) LOCATION pnts(60) . . . do i = 1, 20 pntnum = 3*i - 2 call DEFINE_ACTIVE_POINT (pnts(pntnum)) call DEFINE_ACTIVE_ORIENTATION (UP, EAST) call ROTATE_ORIENTATION (theta(i), SECONDARY) call RETRIEVE_NOZZLE_PARAMETERS (i) if (NOM_PIPE_D .ne. 0) then call DEFINE_NOZZLE (NOZ2, i, 1) endif enddo

180

_ _______________
Appendix C:

EQP Eden Program Examples

Example 4 (Use of character string variables):


! ! do while (.TRUE.) call DISPLAY_TUTORIAL (INPUTS) pump_type = CSTRING[1] type 9 if (pump_type .eq. SS .or. pump_type call USER_FUNCTION (SIDESIDE) stop endif if (pump_type .eq. TT .or. pump_type call USER_FUNCTION (TOPTOP) stop endif if (pump_type .eq. TE .or. pump_type call USER_FUNCTION (TOPEND) end call DISPLAY_MESSAGE (BAD PUMP TYPE: call DISPLAY_MESSAGE (VALID TYPES ARE enddo

!input field is data .eq. ss) then

.eq. tt) then

.eq. te) then

|| pump_type, 2) SS, TT AND TE , 3)

Example 5 (Graphic selection commands):


notdone = TRUE do while (notdone) call DISPLAY_TUTORIAL (UPICK) if (LAST_INP_TYPE .eq. APPLICATION_CMD) then appnum = LAST_INP_NUM - 4050

Examples

! 4051-4075 for fields

if (appnum .eq. 1) then call USER_FUNCTION (AET) stop endif if (appnum .eq. 2) then call USER_FUNCTION (AES) stop endif if (appnum .eq. 3) then call USER_FUNCTION (AEU) endif call DISPLAY_MESSAGE (OPTION HAS NOT BEEN IMPLEMENTED YET) else notdone = FALSE endif enddo

Example 6:
This example illustrates how a terminated key-in is used. To get a user input, perform some calculations using the input, and then display the results as default values in the tutorial.

181

_ _______________
PDS Eden for Equipment - April 2002
notdone = TRUE do while (notdone) call DISPLAY_TUTORIAL (ATUT) if (LAST_INP_TYPE .eq. USER_KEYIN) then field_no = LAST_INP_NUM if (field_no .eq. 3) then length = DIMENSION [23] size = length /100. angle = DASIND (size) call PUT_FIELD (angle, 4, retcode) if (field_no .eq. 5) then count = DIMENSION[45] height = count * 10. call PUT_FIELD (height, 6, retcode) endif else notdone = FALSE endif enddo . . . ! ! ! ! input to terminated ... keyin field fld attrib is 3 or 4 keyin was to field 3

! show default in tut endif

!show default on tutor

Example 7:
This example shows the Eden logic for the case when a tutorial selection results in a value being displayed in a tutorial field.
done = 0 do while (done .eq. 0) call DISPLAY_TUTORIAL (GETME) if (LAST_INP_TYPE .eq. APPLICATION_CMD) then optnum = LAST_INP_NUM - 4050 if (optnum .eq. 1) then call DISPLAY_MESSAGE (***, 190) endif if (optnum .eq. 2) then call DISPLAY_MESSAGE (***, 191) endif if (optnum .eq. 3) then call DISPLAY_MESSAGE (***, 192) endif else done = 1 endif enddo . . .

182

_ _______________
Appendix C:

EQP Eden Program Examples

Example 8:
This example shows how a tutorial selection can result in the display of a new tutorial. After the ACCEPT box on the new tutorial is selected, the initiating tutorial is redisplayed. The symbol is:
el_finito = FALSE do while (.not. el_finito) call DISPLAY_TUTORIAL (TUTONO) if (LAST_INP_TYPE .eq. APPLICATION_CMD) then cmdno = LAST_INP_NUM - 4050 if (cmdno .eq. 1) then call DISPLAY_TUTORIAL (TUTDOS) endif else el_finito = TRUE endif enddo

Example 9:
The tutorial below is used to collect input for a Simple Horizontal Vessel.

Examples

A010 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 1, 1, 1, 1, 1, 1, 1, 1, 9, 7, 1, 2, 3, 4, 5, 6, 7, 8, 9, 1, 1, , , , , , , , , , , , 4, 4, 2, 2, 2, 2, 2, 2, 2, 3, 1, , , , , , , , , , , , LENGTH DIAMETER OFFSET SUP_1_2 SUP_DIAM SUP_HGHT DSH_DPTH SUP_WIDTH THICKNESS TANK_STD EQPNAM

183

_ _______________
PDS Eden for Equipment - April 2002
202, 1, 203, 1, 204, 1, , , , , , , 1, 1, 1, , , ,

The following tutorial is used to define the vessel center-of-gravity for the Simple Horizontal Vessel.

A011 1, 2, 3, 1, 1, 1, 10, 11, 12, , , , 1, 1, 1, , OFFSET_PRI , OFFSET_SEC , OFFSET_NOR

The following code is the Symbol Processor for HTANK. It illustrates several useful Eden features in creating the tutorials previously mentioned such as handling terminated fields, declaring local point arrays for location data, and placing 2D complex shapes for generating shadows. To familiarize yourself with the logic, you will find it useful to step through the source code aided by the Debugger. The symbol (and the User Function) should be extracted from the delivered text library, recompiled, and then inserted into the object library. The recompilation process allows the Debugger to locate the source file on your system when the symbol HTANK is called up.

184

_ _______________
Appendix C:
SYMBOL_PROCESSOR HTANK ! Simple Horizontal Tank int2 location accepted = 0 finished = 0 Do while ( finished .eq. 0 ) Do while ( accepted .eq. 0) Call Display_Tutorial ( HTANK, A010 ) if ( LAST_INP_TYPE .eq. APPLICATION_CMD ) then if ( LAST_INP_NUM .le. 4075 .and. LAST_INP_NUM .ge. 4073 ) then if ( LAST_INP_NUM .eq. 4075 ) then cstring[1]= A else if ( LAST_INP_NUM .eq. 4074 ) then cstring[l]= B else cstring[1]= C endif endif Call User_Function ( STD_TANK ) ! Defines dimensions 1-8 else if ( LAST_INP_NUM .eq. 4072 ) then Call Display_Tutorial ( TNKCOG, A011) endif endif else if ( LAST_INP_TYPE .eq. USER_KEYIN ) then if ( LAST_INP_NUM .eq. 1 ) then dimension_3 = dimension_l / 5 dimension_4 = dimension_1 * 3 / 5 Call Put_Field ( dimension_3, 3 ) Call Put_Field ( dimension_4, 4 ) else if ( LAST_INP_NUM .eq. 2 ) then dimension_8 = dimension_2* .866 dimension_7 = dimension_2/4 INPUT_1 = dimension_1 sav_lib = ACT_LIB Call Define_Library ( EQP_TABLES ) Call Read_Table ( THK_DIAM_READINGS, INPUT, OUTPUT ) dimension_5 = OUTPUT_1 dimension_6 = OUTPUT_2 Call Define_Library ( sav_lib ) do i = 5, 8 Call Put_Field ( dimension[i], i ) enddo else if ( LAST_INP_NUM .eq. 10 ) then Call User_Function ( STD TANK) endif endif endif endif endif accepted, finished, i shd_pnt[12]

EQP Eden Program Examples

Examples

185

_ _______________
PDS Eden for Equipment - April 2002
if ( LAST_INP_TYPE .ne. APPLICATION_CMD .and. LAST_INP_TYPE .ne. USER_KEYIN ) then accepted = 1 endif enddo cylinder_length cylinder_diameter suppport_offset supportl_support2 support_width1 base_center dish_depth support_width2 insulation_thick = = = = = = = = = dimension_1 dimension_2 dimension_3 dimension_4 dimension_5 dimension_6 dimension_7 dimension_8 dimension_9

env_diameter = cylinder_diameter + 2.0*insulation_thick env_length = cylinder_lenght + 2*dish_depth + 2.0*insulation_thick finished = 1 if ( cylinder_length .lt. ( support_offset + supportl_support2 )) then Call Display_Message ( Supports will be outside tank body, 90 ) finished = 0 endif if ( dish_depth .lt. 0 ) then Call Display_Message ( Dish depth is to small || dish_depth, 90 ) finished = 0 endif if ( finished .eq. l ) then Call Define_Active_Orientation ( EAST, UP ) Call Define_Placepoint ( PP1, POINT_0 ) Call Call Call Call Call Call Call Call Begin ( EQUIPMENT ) Draw_Cylinder_With_Capped_Ends ( cylinder_length, cylinder_diameter ) Define_Placepoint ( PP2, POINT_0 ) Draw_Semi_Ellipsoid ( cylinder_diameter, dish_depth ) Move_To_Placepoint ( PP1 ) Define_Active_Orientation ( WEST, DOWN ) Draw_Semi_Ellipsoid ( cylinder_diameter, dish_depth ) Move_to_Placepoint ( PP1 )

if ( env_length .ne. 0 .and. env_diameter .ne. 0 ) then Call Begin ( ENVELOPE_SAFETY_HARD ) Call Move_Along_Axis ( ( dish_depth + insulation_thick ), WEST ) Call Draw_Cylinder_With_Capped_Ends ( env_length, env_diameter ) Call Move_to_placepoint ( PP1 ) endif Call Call Call Call Call Call Begin ( EQUIPMENT Move_Along_Axis ( Move_Along_Axis ( Define_Placepoint Move_Along_Axis ( Define_Placepoint ) base_center, DOWN ) support_offset, EAST ) ( PP3, POINT_0 ) supportl_support2, East ) ( PP4, POINT_0 )

do i = 3, 4 Call Move_To_Placepoint ( PP[i] ) Call Define_Active_Orientation ( UP, WEST ) Call Draw_Proj_Rectangle ( support_widthl, support_width2, base_center ) enddo

186

_ _______________
Appendix C:
Call Move_To_Placepoint ( PP1) Call Define_Datum_Point ( DP[1], POINT_0 ) Call Place_COG ( LIFTING, dimension[10], dimension[11], dimension[12] ) Call BEGIN ( SHADOW ) Call Start_Complex_Shape(0) Call Move_To_Placepoint ( PP1 ) Call Move_Along_Axis ( base_center, DOWN ) Call Define_Active_Orientation ( SOUTH, WEST ) Call Draw_Arc ( cylinder_diameter/2, dish_depth, 0, 180 ) Call Call Call Call Call Call Call Call Call Call Call Move_to_Placepoint ( PP1 ) Move_Along_Axis ( base_center, DOWN ) Define_Point ( shd_pnt[1], POINT_0, 0, -cylinder_diameter/2, 0 ) Define_Point ( shd_pnt[4], shd_pnt[1], 0, cylinder_diameter, 0 ) Define_Point ( shd_pnt[7], shd_pnt[4], cylinder_length, 0, 0 ) Define_Point ( shd_pnt[10], shd_pnt[7], 0, -cylinder_diameter, 0 ) Draw_Line ( shd_pnt[4], shd_pnt[7] ) Move_To_Placepoint ( PP2 ) Move_Along_Axis ( base_center, DOWN ) Define_Active_Orientation ( NORTH, EAST ) Draw_Arc ( cylinder_diameter/2, dish_depth, 0, 180 )

EQP Eden Program Examples

Call Draw_Line ( shd_pnt[l0], shd_pnt[1] )

Examples

Call Stop_Complex_Shape(0) endif enddo END

187

_ _______________
PDS Eden for Equipment - April 2002 The following code is the User Function routine for computing dimensions.
! The following code is the User Function routine for computing dimensions. User_Function_Definition STD_TANK ! Defines parameters dimension[l]-[9] and Tutorial Fields l-9 int2 i

if ( cstring[l] .ge. A .and. cstring[l] .le. C ) then Call Put_Field ( cstring[l], 10 ) if ( cstring[1] .eq. A ) then Call Convert_Unit ( 144.0, ENGLISH, dimension_1 ) Call Convert_Unit ( 60.0, ENGLISH, dimension_2 ) dimension_9 = 0 else if ( cstring[1] .eq. B ) then Call Call Call else if ( Convert_Unit ( 192.0, ENGLISH, dimension_1 ) Convert_Unit ( 120.0, ENGLISH, dimension_2 ) Convert_Unit ( 12.0, ENGLISH, dimension_9 ) cstring[1] .eq. C ) then

Call Convert_Unit ( 480.0, ENGLISH, dimension_1 ) Call Convert_Unit ( 180.0, ENGLISH, dimension_2 ) Call Convert_Unit ( 6.0, ENGLISH, dimension_9 ) endif endif endif dimension_3 = dimension_1/5 dimension_4 = dimension_1*3/5 dimension_5 = dimension_1/8 dimension_6 = dimension_2/2 + dimension_2/4 + dimension_9 dimension_7 = dimension_2/4 dimension_8 = dimension_2*.866 do i = 1, 9 Call Put_Field ( dimension[i], i ) enddo else Call Display_Message ( "||cstring[1]||" || is not a valid standard, 90 ) endif END

188

_ _______________
Appendix D:

Delivered Parametrics

Appendix D Delivered Parametrics


The following parametrics are delivered with the PDS Equipment Modeling product. A001 A003 A015 A016 A021 A029 A031 A039 A041 A051 A061 A063 E200 E201 E205 E210 E215 E230 E240 E245 E305 E307 E310 E319 E320 E325 E330 E332 E334 E405 E410 E905 E906 E907 N205 N210 N215 N230 N240 N245 N305 N307 N310 N320 N325 Circular Platform Miscellaneous Platform Holes for Circular Platforms Holes for Miscellaneous Platforms Thru Ladder A Thru Ladder Details Side Ladder A Side Ladder Details Stairs A Handrail A Davit A Davit B Define Option Define Weights Complex Vertical Cylindrical Equipment Simple Vertical Cylindrical Equipment, Skirt Simple Vertical Cylindrical Equipment, Legs Spherical Equipment Complex Horizontal Cylindrical Equipment Simple Horizontal Cylindrical Equipment Horizontal S & T Exchanger Kettle Exchanger Vertical S & T Exchanger Exchanger Ends Double Pipe Exchanger Plate Exchanger Air Cooler Induced Draft Air Cooler Bay Forced Draft Cooler Bay Horizontal Rotating Equipment and Driver Vertical Rotating Equipment and Driver E1 Ends E2 Ends E3 Ends Complex Vertical Cylindrical Equipment Simple Vertical Cylindrical Equipment, Skirt Simple Vertical Cylindrical Equipment, Legs Sphere Complex Horizontal Cylindrical Equipment Simple Horizontal Cylindrical Equipment Horizontal S & T Exchanger Kettle Exchanger Vertical S & T Exchanger Double Pipe Exchanger Plate Exchanger

Parametrics

189

_ _______________
PDS Eden for Equipment - April 2002 N330 N405 N410 U850 U860 U861 U862 U863 U870 U880 U881 USRPRJ Air Cooler Horizontal Rotating Equipment and Driver Vertical Rotating Equipment and Driver Gear cover Round Torus Miter Rectangular Torus Miter Vertical Oval Torus Miter Flat Oval Torus Miter Flat Oval Prism Flat Oval Torus Rectangular 90 Cone Torus with offset User Projected Shape

The following pages display each parametric identified by its title and Eden code. For some parametrics, special instructions or important information accompany the graphic. The nozzle parametrics, N205 - N410, are included in this appendix, but Appendix D contains more information on nozzles.

190

_ _______________
Appendix D:

Circular Platform (A001)

D.1

Circular Platform (A001)

The sweep defines the platform location (left [L] or right [R]) in relation to the ladder as looking from the top view. For SEGMENT 1, the platform edge next to the ladder is parallel to the radial line located at angle P1. All other edges are radial. Select the Define Holes option to define the various shape penetrations on the platform surface using the Handrail A (A015) form.

A001 Notes Specific to Form A001, Circular Platform


SWEEP defines whether the platform is located to the right (R) or to the left (L) of the ladder, as viewed from the top. For segment 1, the platform edge next to the ladder is parallel to the radial line located at angle P1. All other platforms edges are radial. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 TDF No _ __ 1 2 3 TDF Name _____ ITEM COMP DET Field Length _ _____ 12 12 12 Field Type _ ____ 7 9 9 Var No/ Att No ______ 1 2 3 Nozzle Seq No _ _____ 0 0 0 Exit Code _ ____ 1 1 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no ; ;

Parametrics

954 955 956

4 5 6

P1 P2 P3

11 11 9

2 1 1

1 2 3

0 0 0

1 3 3

; ; ;

191

_ _______________
PDS Eden for Equipment - April 2002
957 7 SWEEP 1 9 4 0 3 ; SEGMENT 1 959 960 11 12 9 10 11 12 OPT1 P15 P16 P17 1 13 13 11 9 1 1 2 5 15 16 17 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 2 13 14 15 16 13 14 15 16 OPT2 P25 P26 P27 1 13 13 11 9 1 1 2 6 25 26 27 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 3 17 18 19 20 17 18 19 20 OPT3 P35 P36 P37 1 13 13 11 9 1 1 2 7 35 36 37 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 4 21 22 23 24 21 22 23 24 OPT4 P45 P46 P47 1 13 13 11 9 1 1 2 8 45 46 47 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 5 25 26 27 28 25 26 27 28 OPT5 P55 P56 P57 1 13 13 11 9 1 1 2 9 55 56 57 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 6 29 30 31 32 29 30 31 32 OPT6 P65 P66 P67 1 13 13 11 9 1 1 2 10 65 66 67 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 7 33 34 35 36 33 34 35 36 OPT7 P75 P76 P77 1 13 13 11 9 1 1 2 11 75 76 77 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

SEGMENT 8 37 38 39 40 37 38 39 40 OPT8 P85 P86 P87 1 13 13 11 9 1 1 2 12 85 86 87 0 0 0 0 3 3 3 3 "A" ;Option ; ; ;

192

_ _______________
Appendix D:
SEGMENT 9 41 42 43 44 41 42 43 44 OPT9 P95 P96 P97 1 13 13 11 9 1 1 2 6 95 96 97 0 0 0 0 3 3 3 3 "A" ;Option ; ; ; 45 45 DATE 11 9 14 0 1 C38 ;Date

Circular Platform (A001)

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


A001 _ ____ a001.eqp a001_ck.uf trapez.uf a001.tdf A001.fb A015 _ ____ a015a016.uf a015a016_ck.uf a015.tdf A015.fb General place hole routine _______________________ pl_holes.uf

Parametrics

193

_ _______________
PDS Eden for Equipment - April 2002

D.2

Miscellaneous Platform (A003)

To form a skewed corner as indicated by the dashed lines, enter the two parameters (P#) that make up the right angle corner (solid lines) in P11 and P12 respectively. For example, for a Type E platform enter the values for P1 and P8 in P11 and P12 to create the skewed corner. Select the Define Holes option to define the various shape penetrations on the platform surface using the Handrail A (A016) form.

A003 Notes Specific to Form A003, Misc Platforms


To allow access to the platform via a skewed ladder, enter in fields P11 and P12 the parameters that define the skewed corner. For example, enter parameters "P1" and "P6" to define a skewed corner for a type B platform. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 TDF No _ __ 1 2 3 TDF Name _____ ITEM COMP TYPE Field Length _ _____ 12 12 1 Field Type _ ____ 7 9 9 Var No/ Att No ______ 1 2 3 Nozzle Seq No _ _____ 0 0 0 Exit Code _ ____ 1 1 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ;

956 957 958

6 7 8

P1 P2 P3

14 14 14

1 1 1

1 2 3

0 0 0

3 3 3

; ; ;

194

_ _______________
Appendix D:
959 960 11 12 13 14 15 16 17 9 10 11 12 13 14 15 16 17 P4 P5 P6 P7 P8 P9 P10 P11 P12 14 14 14 14 14 11 9 2 2 1 1 1 1 1 2 1 9 9 4 5 6 7 8 9 10 4 5 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 ; ; ; ; ; ; ;

Miscellaneous Platform (A003)

;First leg of skewed corner ;Second leg of skewed corner

18

18

DATE

11

C38

;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


A003 _ ____ a003.eqp a003_ck.uf a003_type_e.uf a003.tdf A003.fb A016 _ ____ a015a016.uf a015a016_ck.uf a016.tdf A016.fb General place hole routine _______________________ pl_holes.uf

Parametrics

195

_ _______________
PDS Eden for Equipment - April 2002

D.3

Holes for Platforms (A015)

In the OPT field, key in C for circular hole or R for rectangular hole. Option E, elliptical hole, is not implemented at this time.

All holes must appear either partially or completely within the platform.

A015 Notes Specific to Form A015, Holes for Circular Platforms


Enter "C" for circular, "E" for elliptical or "R" for rectangular hole. Option "E" is not currently available. The user must ensure that the holes are partially or completely within the platform. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ HOLE 1 951 952 953 954 955 956 TDF No _ __ 1 2 3 4 5 6 TDF Name _____ OPT1 P18 P19 P20 P21 P22 Field Length _ _____ 1 11 13 11 13 13 Field Type _ ____ 9 2 1 2 1 1 Var No/ Att No ______ 21 18 19 20 21 22 Nozzle Seq No _ _____ 0 0 0 0 0 0 Exit Code _ ____ 3 1 3 1 3 3 Default Value _____ "C" T2210 Att No ______ Explanatory Remarks ___________________ ;Option ; ; ; ; ;

196

_ _______________
Appendix D:
HOLE 2 957 958 959 960 11 12 7 8 9 10 11 12 OPT2 P28 P29 P30 P31 P32 1 11 13 11 13 13 9 2 1 2 1 1 22 28 29 30 31 32 0 0 0 0 0 0 3 1 3 1 3 3 "C" ;Option ; ; ; ; ;

Holes for Platforms (A015)

HOLE 3 13 14 15 16 17 18 13 14 15 16 17 18 OPT3 P38 P39 P40 P41 P42 1 11 13 11 13 13 9 2 1 2 1 1 23 38 39 40 41 42 0 0 0 0 0 0 3 1 3 1 3 3 "C" ;Option ; ; ; ; ;

HOLE 4 19 20 21 22 23 24 19 20 21 22 23 24 OPT4 P48 P49 P50 P51 P52 1 11 13 11 13 13 9 2 1 2 1 1 24 48 49 50 51 52 0 0 0 0 0 0 3 1 3 1 3 3 "C" ;Option ; ; ; ; ;

HOLE 5 25 26 27 28 29 30 25 26 27 28 29 30 OPT5 P58 P59 P60 P61 P62 1 11 13 11 13 13 9 2 1 2 1 1 25 58 59 60 61 62 0 0 0 0 0 0 3 1 3 1 3 3 "C" ;Option ; ; ; ; ;

Parametrics

HOLE 6 31 32 33 34 35 36 31 32 33 34 35 36 OPT6 P68 P69 P70 P71 P72 1 11 13 11 13 13 9 2 1 2 1 1 26 68 69 70 71 72 0 0 0 0 0 0 3 1 3 1 3 3 "C" ;Option ; ; ; ; ;

37 38

37 38

ITEM DATE

12 11

7 9

1 27

0 0

1 1

C38 -

;Equipment group no ;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

197

_ _______________
PDS Eden for Equipment - April 2002 Following is a list of form elements and their associated files:
A015 _ ____ a015a016.uf a015a016_ck.uf a015.tdf A015.fb

198

_ _______________
Appendix D:

Holes for Miscellaneous Platforms (A016)

D.4

Holes for Miscellaneous Platforms (A016)

In the OPT field, key in C for circular hole or R for rectangular hole. Option E, elliptical hole, is not implemented at this time.

All holes must appear either partially or completely within the platform.

Parametrics

A016 Notes Specific to Form A016, Holes for Misc Platforms


Enter "C" for circular, "E" for elliptical or "R" for rectangular hole. Option "E" is not currently available. The user must ensure that the holes are partially or completely within the platform. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ HOLE 1 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ OPT1 P18 P19 P20 Field Length _ _____ 1 14 14 11 Field Type _ ____ 9 1 1 2 Var No/ Att No ______ 21 18 19 20 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 3 1 1 1 Default Value _____ "C" T2210 Att No ______ Explanatory Remarks ___________________ ;Option ; ; ;

199

_ _______________
PDS Eden for Equipment - April 2002
955 956 5 6 P21 P22 13 13 1 1 21 22 0 0 3 3 ; ; HOLE 2 957 958 959 960 11 12 7 8 9 10 11 12 OPT2 P28 P29 P30 P31 P32 1 14 14 11 13 13 9 1 1 2 1 1 22 28 29 30 31 32 0 0 0 0 0 0 3 1 1 1 3 3 "C" ;Option ; ; ; ; ;

HOLE 3 13 14 15 16 17 18 13 14 15 16 17 18 OPT3 P38 P39 P40 P41 P42 1 14 14 11 13 13 9 1 1 2 1 1 23 38 39 40 41 42 0 0 0 0 0 0 3 1 1 1 3 3 "C" ;Option ; ; ; ; ;

HOLE 4 19 20 21 22 23 24 19 20 21 22 23 24 OPT4 P48 P49 P50 P51 P52 1 14 14 11 13 13 9 1 1 2 1 1 24 48 49 50 51 52 0 0 0 0 0 0 3 1 1 1 3 3 "C" ;Option ; ; ; ; ;

HOLE 5 25 26 27 28 29 30 25 26 27 28 29 30 OPT5 P58 P59 P60 P61 P62 1 14 14 11 13 13 9 1 1 2 1 1 25 58 59 60 61 62 0 0 0 0 0 0 3 1 1 1 3 3 "C" ;Option ; ; ; ; ;

HOLE 6 31 32 33 34 35 36 31 32 33 34 35 36 OPT6 P68 P69 P70 P71 P72 1 14 14 11 13 13 9 1 1 2 1 1 26 68 69 70 71 72 0 0 0 0 0 0 3 1 1 1 3 3 "C" ;Option ; ; ; ; ;

37 38

37 38

ITEM DATE

12 11

7 9

1 27

0 0

1 1

C38 -

;Equipment group no ;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

200

_ _______________
Appendix D: Following is a list of form elements and their associated files:
A016 _ ____ a015a016.uf a015a016_ck.uf a016.tdf A016.fb

Holes for Miscellaneous Platforms (A016)

Parametrics

201

_ _______________
PDS Eden for Equipment - April 2002

D.5

Thru Ladder A (A021)

The OPTION field defines a cage (C), no cage (N) or hoop (H) ladder. If you enter H, only the lower hoop is displayed. An interference envelope representing a cage is generated regardless of whether or not you specify a cage. To define ladder and cage details, select the Define Details option using the Thru Ladder Details (A029) form.

A021 Notes Specific to Form A021, Thru Ladder A


OPTION defines whether cage (C), no cage (N), or hoop (H) option applies. For H, only the lower hoop is displayed. Use the DEFINE DETAILS command to define ladder and cage details. An interference envelope representing the cage is generated regardless of whether there is a cage or not. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ ITEM COMP DET OPTION Field Length _ _____ 12 12 12 1 Field Type _ ____ 7 9 9 9 Var No/ Att No ______ 1 2 3 4 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 1 1 1 3 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ; ;Option

202

_ _______________
Appendix D:
955 956 957 958 959 960 5 6 7 8 9 10 P1 P2 P3 P4 P5 P6 9 14 14 9 11 14 2 1 1 1 2 1 1 2 3 4 5 6 0 0 0 0 0 0 3 3 3 3 1 3 0.0 2.0 ; ; ; ; ; ;

Thru Ladder A (A021)

11

11

DATE

11

C38

;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


A021 _ ____ a021.eqp a021_ck.uf a021.tdf A021.fb

Parametrics

203

_ _______________
PDS Eden for Equipment - April 2002

D.6

Thru Ladder Details (A029)

When you select the Define Details option on the Thru Ladder A (A021) form, the Details form appears. Select the ACCEPT option to accept the current modification and return to the Thru Ladder A form. Select the EXIT option to ignore the current modifications and return to the parametric main menu.

A029 Notes Specific to Form A029, Thru Ladder Dtls


The following values are hardcoded: The rails as 3" X 3/8" bars. The rungs as 3/4" diameter cylinders. The hoop bars as 3" X 1/4" bars. The vertical bars as 1-1/4" X 1/4" bars. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 957 958 959 960 11 TDF No _ __ 7 8 9 10 11 TDF Name _____ P20 P21 P22 P23 P24 Field Length _ _____ 12 12 12 12 12 Field Type _ ____ 1 1 1 1 1 Var No/ Att No ______ 20 21 22 23 24 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 3 3 3 3 3 Default Value _____ 18.75 12.0 42.0 90.0 48.0 T2210 Att No ______ Explanatory Remarks ___________________ ; ; ; ; ;

204

_ _______________
Appendix D:
12 13 14 15 16 12 13 14 15 16 P25 P26 P27 P28 P29 12 12 12 9 9 1 1 1 2 1 25 26 27 28 29 0 0 0 0 0 3 3 3 3 3 13.5 13.5 17.5 40.0 7.0 ; ; ; ; ; 17 17 DATE 11 9 10 0 1 C38 ;Date

Thru Ladder Details (A029)

Following is a list of form elements and their associated files:


A029 _ ____ a029.eqp a029_ck.uf a029.tdf A029.fb

Parametrics

205

_ _______________
PDS Eden for Equipment - April 2002

D.7

Side Ladder A (A031)

The OPTION field defines a cage (C), no cage (N) or hoop (H) ladder. If you enter H, only the lower hoop is displayed. An interference envelope representing a cage is generated regardless of whether or not you specify a cage. To define ladder and cage details, select the Define Details option using the Side Ladder Details (A039) form.

A031 Notes Specific to Form A031, Side Ladder A


Refer to paragraph A031 for comments. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ ITEM COMP DET OPTION Field Length _ _____ 12 12 12 1 Field Type _ ____ 7 9 9 9 Var No/ Att No ______ 1 2 3 4 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 1 1 1 3 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ; ;Option

955 956 957 958 959 960

5 6 7 8 9 10

P1 P2 P3 P4 P5 P6

9 14 14 9 11 14

2 1 1 1 2 1

1 2 3 4 5 6

0 0 0 0 0 0

3 3 3 3 1 3

0.0 2.0

; ; ; ; ; ;

206

_ _______________
Appendix D:
11 11 DATE 11 9 5 0 1 C38 ;Date 202 203 204 208 202 203 204 208 X Y EL ANG 18 18 16 11 1 1 1 2 0 0 0 0 0 0 0 0 1 1 1 1 ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Side Ladder A (A031)

Following is a list of form elements and their associated files:


A031 _ ____ a031.eqp a031_ck.uf a031.tdf A031.fb

Parametrics

207

_ _______________
PDS Eden for Equipment - April 2002

D.8

Side Ladder Details (A039)

When you select the Define Details option on the Side Ladder A (A031) form, the Details form appears. Select the ACCEPT option to accept the current modification and return to the Side Ladder A form. Select the EXIT option to ignore the current modifications and return to the parametric main menu.

A039 Notes Specific to Form A039, Side Ladder Dtls


The following values are hardcoded: The rails as 3" X 3/8" bars. The rungs as 3/4" diameter cylinders. The hoop bars as 3" X 1/4" bars. The vertical bars as 1-1/4" X 1/4" bars. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 957 958 959 960 11 TDF No _ __ 7 8 9 10 11 TDF Name _____ P20 P21 P22 P23 P24 Field Length _ _____ 12 12 1 9 12 Field Type _ ____ 1 1 3 1 1 Var No/ Att No ______ 20 21 22 23 24 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 3 3 3 3 3 Default Value _____ 18.75 12.0 6 2.0 90.0 T2210 Att No ______ Explanatory Remarks ___________________ ; ; ; ; ;

208

_ _______________
Appendix D:
12 13 14 15 16 17 12 13 14 15 16 17 P25 P26 P27 P28 P29 P30 12 12 12 12 9 9 1 1 1 1 2 1 25 26 27 28 29 30 0 0 0 0 0 0 3 3 3 3 3 3 48.0 13.5 13.5 17.5 40.0 7.0 ; ; ; ; ; ;

Side Ladder Details (A039)

18

18

DATE

11

10

C38

;Date

Following is a list of form elements and their associated files:


A039 _ ____ a039.uf a039_ck.uf a039.tdf A039.fb

Parametrics

209

_ _______________
PDS Eden for Equipment - April 2002

D.9

Stairs A (A041)

If you input a value for P10, the system places the top rail. If you input a value for P11, the system places the middle rail. If you input a value for P12 and P13, the corresponding posts and rails are hardcoded and placed as 21/2 inch outside diameter cylinders.

A041 Notes Specific to Form A041, Stairs A


Top rail is placed if P10 has a value other than blank. Mid rail is placed if P11 has a value other than blank. Posts are placed if P12 and P13 have a value other than blank. The posts and rails are hardcoded as 21/2" OD cylinders. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 TDF No _ __ 1 2 3 TDF Name _____ ITEM COMP DET Field Length _ _____ 12 12 12 Field Type _ ____ 7 9 9 Var No/ Att No ______ 1 2 3 Nozzle Seq No _ _____ 0 0 0 Exit Code _ ____ 1 1 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ;

210

_ _______________
Appendix D:
959 960 11 12 13 14 15 16 17 18 19 20 21 22 23 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 P1 P2 P3 P4 P5 P6 P7 P8 P9 P10 P11 P12 P13 P14 P15 9 9 13 13 3 9 9 12 10 12 12 12 12 12 9 1 1 1 1 3 1 1 1 1 1 1 1 1 1 1 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 30.0 -0.75 34.0 17.0 8.0 2.25 ; ; ; ; ;No of risers ; ; ; ; ; ; ; ; ; Stringer depth ; Stringer flange width

Stairs A (A041)

24

24

DATE

11

C38

;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


A041 _ ____ a041.eqp a041_ck.uf a041.tdf A041.fb

Parametrics

211

_ _______________
PDS Eden for Equipment - April 2002

D.10

Handrail A (A051)

The primary axis of the place point must point up and normal to the platform surface. The secondary axis may point in any direction. The top and middle rails are placed as 2-1/2 inch outside diameter cylinders at the center of the trajectory as specified using the Select Points option. Posts are placed as 2-1/2 inch outside diameter cylinders. A post is placed at the begin point and another at the end point. Subsequent posts are then placed a specified distance (P3) from each intermediate (D1) point. Additional posts are placed in equal spacing so that the maximum distance between posts does not exceed P4. Modification of the handrail definition after placement requires you to delete and redefine the handrail. To identify the handrail connect points, select the Select Point option. Then, place a data point at the designated connect points. For accurate connect points, verify that the Keypoint Snap Lock is OFF and the Project Snap Lock is ON.

212

_ _______________
Appendix D:

Handrail A (A051)

A051 Notes Specific to Form A051, Handrail A


The primary axis of the PP must point up and normal to the platform surface. The secondary axis may point in any direction. Use the SELECT POINTS command to identify points for placement of the handrail. Top rails and mid rails are placed as 2-1/2 inch OD cylinders, at the center of the trajectory described with the SELECT POINTS command. Posts are placed as 2-1/2 inch OD cylinders. One post is placed at the beginning and end points. A post is also placed a distance P3 from each intermediate <Di> point. Additional posts are placed in equal spacing so that the maximum distance between posts does not exceed P4. Modification of the handrail definition after placement requires that the handrail be deleted and redefined. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 TDF No _ __ 1 2 3 TDF Name _____ ITEM COMP DET Field Length _ _____ 12 12 12 Field Type _ ____ 7 9 9 Var No/ Att No ______ 1 2 3 Nozzle Seq No _ _____ 0 0 0 Exit Code _ ____ 1 1 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ;

956 957 958 959

6 7 8 9

P1 P2 P3 P4

12 12 12 13

1 1 1 1

2 3 4 5

0 0 0 0

3 3 3 3

42.0 24.0 12.0 72.0

; ; ; ;

960

10

DATE

11

C38

;Date

Parametrics

202 203 204

202 203 204

X Y EL

18 18 16

1 1 1

0 0 0

0 0 0

1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP

Following is a list of form elements and their associated files:


A051 _ ____ a051.eqp a051_ck.uf a051.tdf A051.fb

213

_ _______________
PDS Eden for Equipment - April 2002

D.11

Davit A (A061)

A061 Notes Specific to Form A061, Davit A


A blank in the OD2 field omits the brace. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ ITEM COMP DET CAP UNITCAP Field Length _ _____ 12 12 12 5 4 Field Type _ ____ 7 9 9 3 9 Var No/ Att No ______ 1 2 3 1 4 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 1 1 1 3 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ; ;Capacity ;Unit of capacity

956 957

6 7

OD1 OD2

12 12

1 1

2 3

0 0

3 3

;Member 1 OD ;Member 2 OD

958 959 960 11

8 9 10 11

P1 P2 P3 P4

13 13 13 13

1 1 1 1

4 5 6 7

0 0 0 0

3 3 3 3

; ; ; ;

12

12

DATE

11

C38

;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

214

_ _______________
Appendix D: Following is a list of form elements and their associated files:
A061 _ ____ a061.eqp a061_ck.uf a061.tdf A061.fb

Davit A (A061)

Parametrics

215

_ _______________
PDS Eden for Equipment - April 2002

D.12

Davit B (A063)

A063 Notes Specific to Form A063, Davit B


A blank in the OD3 field omits the brace. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ ITEM COMP DET CAP UNITCAP Field Length _ _____ 12 12 12 5 4 Field Type _ ____ 7 9 9 3 9 Var No/ Att No ______ 1 2 3 1 4 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 1 1 1 3 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equipment group no ; ; ;Capacity ;Unit of capacity

956 957 958

6 7 8

OD1 OD2 OD3

12 12 12

1 1 1

2 3 4

0 0 0

3 3 3

;Member 1 OD ;Member 2 OD ;Member 3 OD

959 960 11

9 10 11

P1 P2 P3

13 13 13

1 1 1

5 6 7

0 0 0

3 3 3

; ; ;

12

12

DATE

11

C38

;Date

202 203 204 208

202 203 204 208

X Y EL ANG

18 18 16 11

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

216

_ _______________
Appendix D: Following is a list of form elements and their associated files:
A063 _ ____ a063.eqp a063_ck.uf a063.tdf A063.fb

Davit B (A063)

Parametrics

217

_ _______________
PDS Eden for Equipment - April 2002

D.13

Define (E200)

This form appears when you select the Define option while in one of the following forms. E205 E210 E215 E230 E240 E245 E305 E307 E310 E320 E325 E330 E405 E410

Once you complete modifications, select the ACCEPT option to return to previous parametric form. Selecting the EXIT option ignores the current modifications and returns you to the parametric main menu.

E200 Notes Specific to Form E200, Define


This form is used to define the attributes in the equipment group entity. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 TDF No _ __ 1 2 3 TDF Name _____ DESC1 DESC2 INSTHK Field Length _ _____ 37 37 9 Field Type _ ____ 7 7 7 Var No/ Att No ______ 2 3 9 Nozzle Seq No _ _____ 0 0 0 Exit Code _ ____ 1 1 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Description 1 ;Description 2 ;Insulation thk

954

DATE

11

11

C38

;Date

218

_ _______________
Appendix D: Following is a list of form elements and their associated files:
E200 _ ____ e200.uf e200.tdf E200.fb

Define (E200)

Parametrics

219

_ _______________
PDS Eden for Equipment - April 2002

D.14

Define Weights (E201)

This form appears when you select the Define Weights option in a parametric form. E205 E210 E215 E230 E240 E245 E305 E307 E310 E320 E325 E330 E405 E410

Once you complete modifications, select the ACCEPT option to return to previous parametric form. Selecting the EXIT option ignores the current modifications and returns you to the parametric main menu.

E201 Notes Specific to Form E201, Define Weights


This form is used to define the weight attributes in the equipment group entity along with the locations of the center of gravity (CG) for each type of weight. Weights considered are dry and operating. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ DRY 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ DRYWT DRYOFFPRIM DRYOFFSEC DRYOFFNORM Field Length _ _____ 8 15 15 15 Field Type _ ____ 7 1 1 1 Var No/ Att No ______ 6 71 72 73 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 1 1 1 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Empty weight ;Offset along PRIMARY ;Offset along SECONDARY ;Offset along NORMAL

220

_ _______________
Appendix D:
OPERATING 1 955 956 957 958 5 6 7 8 OP1WT OP1OFFPRIM OP1OFFSEC OP1OFFNORM 8 15 15 15 7 1 1 1 7 74 75 76 0 0 0 0 1 1 1 1 ;Operating 1 weight ;Offset along NORMAL OPERATING 2 959 960 11 12 9 10 11 12 OP2WT OP2OFFPRIM OP2OFFSEC OP2OFFNORM 8 15 15 15 7 1 1 1 8 77 78 79 0 0 0 0 1 1 1 1 ;Operating 2 weight

Define Weights (E201)

;Offset along PRIMARY ;Offset along SECONDARY

;Offset along PRIMARY ;Offset along SECONDARY ;Offset along NORMAL

13

13

DATE

11

12

C38

;Date

Following is a list of form elements and their associated files:


E201 _ ____ e201.uf e201.tdf E201.fb

Parametrics

221

_ _______________
PDS Eden for Equipment - April 2002

D.15

Complex Vertical Cylindrical Equipment, Skirt (E205)

To define the ends of this form, key in 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS in the input fields E1, E2 or E3. The appropriate End form ( E906 or E907) appears. Negative values define an inverted end. You must define a minimum of one shell section. Four shell sections is the maximum that can be defined. For each section, you must specify both length and diameter. Shell graphics (P1-E3) contain thickness. Support graphics (P13-DP) do not contain thickness. Skirt or ring supports can be located with respect to DP2, DP3 or DP4. P16 must have a negative value to locate the support below the data point. If P13, P14 and P15 are not defined, the support is not placed. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weights of the parametric using the Define Weights (E201) form. When in an input field, entering a value of zero eliminates that section of the parametric.

222

_ _______________
Appendix D:

Complex Vertical Cylindrical Equipment, Skirt (E205)

E205 Notes Specific to Form E205, Complex Vert Cyl Equip


A minimum of one and a maximum of four shell sections may be defined. For a section, both its length and diameter must be specified. Shell graphics have the thickness added. Support graphics do not have the thickness added. For E1, E2, and E3, define the applicable of 2T01, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC, or TORS. Use a negative sign to define an inverted end. If additional details are required, the system will provide access to a secondary form. If revision of details is desired, re-entry of the applicable end type is required. Either skirt or ring supports may be defined. If P13, P14, or P15 is not defined, the support will be omitted. The support may be located with respect to PP2, PP3, or PP4. P16 must have a negative value to locate the support below the PP. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 957 958 959 960 11 12 13 14 15 16 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 P1 E1 P2 P3 P4 P5 P6 P7 P8 P9 E2 P10 P11 P12 E3 9 5 14 14 14 14 14 14 14 14 5 14 14 14 5 1 9 1 1 1 1 1 1 1 1 9 1 1 1 9 1 1 2 3 4 5 6 7 8 9 2 10 11 12 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 "2T01" "NONE" "NONE" ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;

Parametrics

SUPPORT 17 18 19 20 17 18 19 20 P13 P14 P15 P16 14 14 14 15 1 1 1 1 13 14 15 16 0 0 0 0 3 3 3 3 ; ; ; ;Distance from PP to btm of support 21 21 PP 1 3 17 0 3 2 ;PP for support

223

_ _______________
PDS Eden for Equipment - April 2002
22 23 22 23 TUTNO DATE 4 11 7 9 4 4 0 0 1 1 "E205" C38 ;Form no ;Date 201 202 203 204 208 201 202 203 204 208 PP X Y EL ANG 1 18 18 16 11 1 1 1 1 2 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 ; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


E205 _ ____ e205.eqp e205_ck.uf e205.tdf E205.fb End E1 _ ______ e905.uf e905_ck.uf e905.tdf E905.fb End E2 _ ______ e906.uf e906_ck.uf e906.tdf E906.fb End E3 _ ______ e907.uf e907_ck.uf e907.tdf E907.fb General place head routine _ ______________________ pl_head.uf pl_dome.uf pl_torisph.uf pl_toricon.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

224

_ _______________
Appendix D:

Simple Vertical Cylindrical Equipment, Skirt (E210)

D.16

Simple Vertical Cylindrical Equipment, Skirt (E210)

To define the ends of this form, key in 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS in the input fields E1 or E2. The appropriate End form ( E906) appears. Negative values define an inverted end. Shell graphics (P1-E2) contain thickness. Support graphics (P4-DP) do not contain thickness. Skirt or ring supports can be located with respect to DP2, DP3 or DP7. P16 must have a negative value to locate the support below the data point. If P4, P5 are P6 are not defined, the support is not placed. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

Parametrics

E210 Notes Specific to Form E210, Simple Vert Cyl Equip, Skirt
Shell graphics have the thickness added. Support graphics do not have the thickness added. For E1 and E2, define the applicable of 2T01, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC, or TORS. Use a negative sign to define an inverted end. If additional details are required, the system will provide access to a secondary form. If revision of details is desired, re-entry of the applicable end type is required.

225

_ _______________
PDS Eden for Equipment - April 2002 Either skirt or ring supports may be defined. If P4, P5, or P6 is not defined, the support will be omitted. The support may be located with respect to PP2 or PP3. P7 must have a negative value to locate the support below the PP. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 2 3 4 5 6 P1 E1 P2 P3 E2 9 5 14 14 5 1 9 1 1 9 1 1 2 3 2 0 0 0 0 0 3 3 3 3 3 "2T01" "2T01" ; ; ; ; ;

SUPPORT 957 958 959 960 7 8 9 10 P4 P5 P6 P7 14 14 14 14 1 1 1 1 4 5 6 7 0 0 0 0 3 3 3 3 ; ; ; ;Distance from PP to btm of support 11 11 PP 1 3 8 0 3 2 ;PP for support

12 13

12 13

TUTNO DATE

4 11

7 9

4 3

0 0

1 1

"E210" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


E210 _ ____ e210.eqp e210_ck.uf e210.tdf E210.fb End E1 _ ______ e905.uf e905_ck.uf e905.tdf E905.fb End E2 _ ______ e906.uf e906_ck.uf e906.tdf E906.fb General place head routine _ ______________________ pl_head.uf pl_dome.uf pl_torisph.uf pl_toricon.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

226

_ _______________
Appendix D:

Simple Vertical Cylindrical Equipment, Legs (E215)

D.17

Simple Vertical Cylindrical Equipment, Legs (E215)

To define the ends of this form, key in 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS in the input fields E1 or E2. The appropriate End form ( E906) appears. Negative values define an inverted end. Shell graphics (P1-E2) contain thickness. Support graphics (P4-DP) do not contain thickness. Leg or lug supports can be located with respect to DP2 or DP3. P9 must have a negative value to locate the support below the data point. If P5, P6, P7 and P8 are not defined, the support is not placed. P5 specifies the number of supports (supports will be equally spaced). Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

Parametrics

E215 Notes Specific to Form E215, Simple Vert Cyl Equip, Legs
Shell graphics have the thickness added. Support graphics do not have the thickness added. For E1 and E2, define the applicable of 2T01, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC, or TORS. Use a negative sign to define an inverted end. If additional details are required, the system will provide access to a secondary form. If revision of details is desired, re-entry of the applicable end type is required.

227

_ _______________
PDS Eden for Equipment - April 2002 Either leg or lug supports may be defined. Use P5 to specify number of supports; supports will be equally spaced. If P5, P6, P7, or P8 is not defined, the support will be omitted. The support may be located with respect to PP2 or PP3. P9 must have a negative value to locate the support below the PP. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 2 3 4 5 6 P1 E1 P2 P3 E2 9 5 14 14 5 1 9 1 1 9 1 1 2 3 2 0 0 0 0 0 3 3 3 3 3 "2T01" "2T01" ; ; ; ; ;

SUPPORTS 957 958 959 960 11 12 7 8 9 10 11 12 P4 P5 P6 P7 P8 P9 11 2 13 12 12 14 2 3 1 1 1 1 4 5 6 7 8 9 0 0 0 0 0 0 3 3 3 3 3 3 ; ; ; ; ; ;Distance from PP to btm of support 13 13 PP 1 3 10 0 3 2 ;PP for support

14 15

14 15

TUTNO DATE

4 11

7 9

4 3

0 0

1 1

"E215" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


E215 _ ____ e215.eqp e215_ck.uf e215.tdf E215.fb End E1 _ ______ e905.uf e905_ck.uf e905.tdf E905.fb End E2 _ ______ e906.uf e906_ck.uf e906.tdf E906.fb General place head routine _ ______________________ pl_head.uf pl_dome.uf pl_torisph.uf pl_toricon.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

228

_ _______________
Appendix D:

Spherical Equipment (E230)

D.18

Spherical Equipment (E230)

Shell graphics (P1-P2) contain thickness. Support graphics (P3-P9) do not contain thickness. P4 specifies the number of supports (supports will be equally spaced). If P4, P6 and P9 are not defined, the supports will not be placed. When defining cylindrical legs, leave P7 blank.

Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

Parametrics

E230 Notes Specific to Form E230, Spherical Equip


Shell graphics have the thickness added. Support graphics do not have the thickness added. Use P4 to specify number of supports; supports will be equally spaced. If P4, P6, or P9 is not defined, the support will be omitted. For cylindrical legs, leave P7 blank. Characteristics of the parameters that apply to this form are as follows:

229

_ _______________
PDS Eden for Equipment - April 2002
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no SHELL 952 953 2 3 P1 P2 9 14 1 1 1 2 0 0 3 3 ; ;

SUPPORTS 954 955 956 957 958 959 960 4 5 6 7 8 9 10 P3 P4 P5 P6 P7 P8 P9 11 2 14 12 12 14 14 2 3 1 1 1 1 1 3 4 5 6 7 8 9 0 0 0 0 0 0 0 3 3 3 3 3 3 3 ; ; ; ; ; ; ;

11 12

11 12

TUTNO DATE

4 11

7 9

4 1

0 0

1 1

"E230" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


E230 _ ____ e230.eqp e230_ck.uf e230.tdf E230.fb Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

230

_ _______________
Appendix D:

Complex Horizontal Cylindrical Equipment (E240)

D.19

Complex Horizontal Cylindrical Equipment (E240)

To define the ends of this form, key in 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS in the input fields E1, E2 or E3. The appropriate End form ( E906 or E907 ) appears. Negative values define an inverted end. Shell graphics (P1-P7) contain thickness. Support graphics (P8-SLPE) do not contain thickness. If P4, P5 and P6 is not defined, the boot is not placed.

Parametrics

If P9, P10 and P11 are not defined, the corresponding support(s) and stiffening ring(s) are not placed. If P12 is not defined, all supports and their stiffening rings are not placed. If P8 and P13 are not defined, all supports are not placed. If P14 is not defined, all stiffening rings are not placed. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot around the selected place point for sloped equipment. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

231

_ _______________
PDS Eden for Equipment - April 2002

E240 Notes Specific to Form E240, Complex Hor Cyl Equip


Shell and boot graphics have the thickness added. Support graphics do not have the thickness added. If P4, P5, or P6 is not defined, the boot will be omitted. For E1, E2, and E3, define the applicable of 2T01, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC, or TORS. Use a negative sign to define an inverted end. If additional details are required, the system will provide access to a secondary form. If revision of details is desired, re-entry of the applicable end type is required. If P9, P10 and/or P11 are not defined, the corresponding support(s) and stiffening ring(s) will be omitted. If P12 is not defined, all supports and their stiffening rings will be omitted. If P8 or P13 is not defined, all supports will be omitted. If P14 is not defined, all stiffening rings will be omitted. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot about the selected PP for sloped equipment. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 957 958 959 960 11 2 3 4 5 6 7 8 9 10 11 P1 E1 P2 P3 E2 P4 P5 P6 E3 P7 9 5 14 13 5 14 13 13 5 11 1 9 1 1 9 1 1 1 9 2 1 1 2 3 2 4 5 6 3 7 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 "2T01" "2T01" "NONE" ; ; ; ; ; ; ; ; ; ;

SUPPORTS 12 13 14 15 16 17 18 12 13 14 15 16 17 18 P8 P9 P10 P11 P12 P13 P14 13 13 14 14 12 13 13 1 1 1 1 1 1 1 8 9 10 11 12 13 14 0 0 0 0 0 0 0 3 3 3 3 3 3 3 ; ; ; ; ; ; ;

232

_ _______________
Appendix D:
19 19 ANCH 1 3 15 0 3 ;Anchor end 20 21 20 21 TUTNO DATE 4 11 7 9 4 4 0 0 1 1 "E240" C38 ;Form no ;Date 201 202 203 204 208 209 201 202 203 204 208 209 PP X Y EL ANG SLOPE 1 18 18 16 11 13 1 1 1 1 2 1 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 ; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N ;Slope

Complex Horizontal Cylindrical Equipment (E240)

Following is a list of form elements and their associated files:


E240 _ ____ e240.eqp e240_ck.uf e240_el.uf e240.tdf E240.fb End E1 _ ______ e905.uf e905_ck.uf e905.tdf E905.fb End E2 _ ______ e906.uf e906_ck.uf e906.tdf E906.fb End E3 _ ______ e907.uf e907_ck.uf e907.tdf E907.fb General place head routine _ ______________________ pl_head.uf pl_dome.uf pl_torisph.uf pl_toricon.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

Parametrics

233

_ _______________
PDS Eden for Equipment - April 2002

D.20

Simple Horizontal Cylindrical Equipment (E245)

To define the ends of this form, key in 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, torc or Tors in the input fields E1 or E2. The appropriate End form ( E906 ) appears. Negative values define an inverted end. Shell graphics (P1-E2) contain thickness. Support graphics (P4-SLPE) do not contain thickness. If P5 and P6 are not defined, the corresponding support is not placed. If P4, P7 and P8 are not defined, all supports are not placed. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot around the selected place point for sloped equipment. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

234

_ _______________
Appendix D:

Simple Horizontal Cylindrical Equipment (E245)

E245 Notes Specific to Form E245, Simple Hor Cyl Equip


Shell graphics have the thickness added. Support graphics do not have the thickness added. For E1, and E2, define the applicable of 2T01, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC, or TORS. Use a negative sign to define an inverted end. If additional details are required, the system will provide access to a secondary form. If revision of details is desired, re-entry of the applicable end type is required. If P5 or P6 is not defined, the corresponding supports will be omitted. If P4, P7, or P8 is not defined, all supports will be omitted. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot about the selected PP for sloped equipment. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 2 3 4 5 6 P1 E1 P2 P3 E2 9 5 14 13 5 1 9 1 1 9 1 1 2 3 2 0 0 0 0 0 3 3 3 3 3 "2T01" "2T01" ; ; ; ; ;

SUPPORTS

Parametrics

957 958 959 960 11 12

7 8 9 10 11 12

P4 P5 P6 P7 P8 ANCH

13 13 14 12 13 1

1 1 1 1 1 3

4 5 6 7 8 9

0 0 0 0 0 0

3 3 3 3 3 3

; ; ; ; ; ;Anchor end

13 14

13 14

TUTNO DATE

4 11

7 9

4 3

0 0

1 1

"E245" C38 -

;Form no ;Date

201 202 203 204 208 209

201 202 203 204 208 209

PP X Y EL ANG SLOPE

1 18 18 16 11 13

1 1 1 1 2 1

0 0 0 0 0 0

0 0 0 0 0 0

1 1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N ;Slope

235

_ _______________
PDS Eden for Equipment - April 2002 Following is a list of form elements and their associated files:
E245 _ ____ e245.eqp e245_ck.uf e245.tdf E245.fb End E1 _ ______ e905.uf e905_ck.uf e905.tdf E905.fb End E2 _ ______ e906.uf e906_ck.uf e906.tdf E906.fb General place head routine _ ______________________ pl_head.uf pl_dome.uf pl_torisph.uf pl_toricon.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

236

_ _______________
Appendix D:

Horizontal Shell and Tube Exchanger (E305)

D.21

Horizontal Shell and Tube Exchanger (E305)

If P7 and P8 are not defined, the expansion joint is not placed. P10 defines the bundle pulling area. The default is the value for P1. If P11 and P12 are not defined, the corresponding bottom support is not placed. If P15 and P19 are not defined, the corresponding bottom or top supports are not placed.

Parametrics

If P16 is not defined, all supports are not placed. If P17 and P18 are not defined, the corresponding top support is not placed. The ANCH field defines which support will be anchored. The SLPE defines the rise per foot around the selected place point for sloped equipment. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form. Select the Define Channel option to define the ends for the exchanger using the Exchanger Ends (E319) form.

237

_ _______________
PDS Eden for Equipment - April 2002

E305 Notes Specific to Form E305, Hor S&T Exchanger


Use the DEFINE CHANNEL command to define the exchanger ends. If P7 or P8 is not defined, the expansion joint will be omitted. Use P10 to define the bundle pulling area. It defaults to P1. If P11 or P12 is not defined, the corresponding bottom support will be omitted. If P15 or P19 is not defined, the corresponding bottom or top supports will be omitted. If P16 is not defined, all supports will be omitted. If P17 or P18 is not defined, the corresponding top support will be omitted. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot about the selected PP for sloped equipment. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 957 958 959 960 11 2 3 4 5 6 7 8 9 10 11 P1 P2 P3 P4 P5 P6 P7 P8 P9 P10 13 13 9 13 9 9 13 12 13 13 1 1 1 1 1 1 1 1 1 1 1 2 3 4 5 6 7 8 9 10 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 F2 ; ; ; ; ; ; ; ; ; ;

SUPPORTS 12 13 14 15 16 17 18 19 20 21 12 13 14 15 16 17 18 19 20 21 P11 P12 P13 P14 P15 P16 P17 P18 P19 ANCH 13 13 12 12 13 13 13 13 13 1 1 1 1 1 1 1 1 1 1 3 11 12 13 14 15 16 17 18 19 20 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 ; ; ; ; ; ; ; ; ; ;Anchor support

22

22

TUTNO

"E305"

;Form no

238

_ _______________
Appendix D:
23 23 DATE 11 9 1 0 1 C38 ;Date 201 202 203 204 208 209 201 202 203 204 208 209 PP X Y EL ANG SLOPE 1 18 18 16 11 13 1 1 1 1 2 1 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 ; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N ;Slope

Horizontal Shell and Tube Exchanger (E305)

Following is a list of form elements and their associated files:


E305 _ ____ e305.eqp e305_ck.uf e305.tdf E305.fb E319 _ ____ e319.uf e319_ck.uf e319.tdf E319.fb General place channel routine __________________________ pl_channel.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

Parametrics

239

_ _______________
PDS Eden for Equipment - April 2002

D.22

Kettle Exchanger (E307)

To define the ends of this form, key in 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS in the input fields E1 or E2. The appropriate End form ( E906) appears. P9 defines the bundle pulling area. If P10, P11, P12 and P13 are not defined, the corresponding support is not placed. If P14 and P15 are not defined, all supports are not placed. The ANCH field defines which support will be anchored. The SLPE defines the rise per foot around the selected place point for sloped equipment. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form. Select the Define Channel option to define the ends for the exchanger using the Exchanger Ends (E319) form.

240

_ _______________
Appendix D:

Kettle Exchanger (E307)

E307 Notes Specific to Form E307, Kettle Exchanger


Use the DEFINE CHANNEL command to define the exchanger ends. For E1, define the applicable of 2T01, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC, or TORS. Use a negative sign to define an inverted end. If additional details are required, the system will provide access to a secondary form. If revision of details is desired, re-entry of the applicable end type is required. Use P9 to define the bundle pulling area. If P10, P11, P12, or P13 is not defined, the corresponding support will be omitted. If P14 or P15 is not defined, all supports will be omitted. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot about the selected PP for sloped equipment. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 957 958 959 960 11 2 3 4 5 6 7 8 9 10 11 P1 P2 P3 P4 P5 P6 P7 P8 P9 E1 13 13 13 13 13 9 13 9 13 5 1 1 1 1 1 1 1 1 1 9 1 2 3 4 5 6 7 8 9 1 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 "2T01" ; ; ; ; ;

Parametrics

; ; ; ; ;

SUPPORTS 12 13 14 15 16 17 18 12 13 14 15 16 17 18 P10 P11 P12 P13 P14 P15 ANCH 13 13 12 12 13 13 1 1 1 1 1 1 1 3 10 11 12 13 14 15 16 0 0 0 0 0 0 0 3 3 3 3 3 3 3 ; ; ; ; ; ; ;Anchor support

19 20

19 20

TUTNO DATE

4 11

7 9

4 4

0 0

1 1

"E307" C38 -

;Form no ;Date

241

_ _______________
PDS Eden for Equipment - April 2002
201 202 203 204 208 209 201 202 203 204 208 209 PP X Y EL ANG SLOPE 1 18 18 16 11 13 1 1 1 1 2 1 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 ; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N ;Slope

Following is a list of form elements and their associated files:


E307 _ ____ e307.eqp e307_ck.uf e307.tdf E307.fb End E1 _ ______ e905.uf e905_ck.uf e905.tdf E905.fb General place head routine _ ______________________ pl_head.uf pl_dome.uf pl_torisph.uf pl_toricon.uf E319 _ ____ e319e307.uf e319e307_ck.uf e319.tdf E319.fb General place channel routine __________________________ pl_channel.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

242

_ _______________
Appendix D:

Vertical Shell and Tube Exchanger (E310)

D.23

Vertical Shell and Tube Exchanger (E310)

If P7 and P8 are not defined, the extension joint is not placed. P10 defines the bundle pulling area. The default is the value for P1. For a skirt or ring support, do not enter a value for P12. If P13 and P15 are not defined, the support is not placed. P14 must have a negative value to locate the support below data point one (DP)1. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E210) form. Select the Define Channel option to define the ends for the exchanger using the Exchanger Ends (E319) form.

Parametrics

E310 Notes Specific to Form E310, Vert S&T Exchanger


Use the DEFINE CHANNEL command to define the exchanger ends. If P7 or P8 is not defined, the expansion joint will be omitted.

243

_ _______________
PDS Eden for Equipment - April 2002 Use P10 to define the bundle pulling area. It defaults to P1. Either skirt, ring, or lug supports may be defined, as follows: To define a skirt or ring, do not define a value for P12. If P13 or P15 is not defined, the support will be omitted. P14 must have a negative value to locate the support below PP1. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

SHELL 952 953 954 955 956 957 958 959 960 11 2 3 4 5 6 7 8 9 10 11 P1 P2 P3 P4 P5 P6 P7 P8 P9 P10 14 13 9 13 9 9 13 12 13 14 1 1 1 1 1 1 1 1 1 1 1 2 3 4 5 6 7 8 9 10 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 F2 ; ; ; ; ; ; ; ; ; ;

SUPPORTS 12 13 14 15 16 17 18 12 13 14 15 16 17 18 P11 P12 P13 P14 P15 P16 P17 11 1 13 15 13 13 12 2 3 1 1 1 1 1 11 12 13 14 15 16 17 0 0 0 0 0 0 0 3 3 3 3 3 3 3 ; ; ; ; ; ; ;

19 20

19 20

TUTNO DATE

4 11

7 9

4 1

0 0

1 1

"E310" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

244

_ _______________
Appendix D: Following is a list of form elements and their associated files:
E310 _ ____ e310.eqp e310_ck.uf e310.tdf E310.fb E319 _ ____ e319.uf e319_ck.uf e319.tdf E319.fb General place channel routine __________________________ pl_channel.uf Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

Vertical Shell and Tube Exchanger (E310)

Parametrics

245

_ _______________
PDS Eden for Equipment - April 2002

D.24

Exchanger Ends (E319)

To enter this form, you must select the Define Channel option in an Exchanger form ( E305, E310 ). To accept the current modifications and return to the exchanger form, select the ACCEPT option. Select the EXIT option to ignore the current modifications and return to the parametric main menu. Enter the applicable code (found under each graphic) in the TYPE field. P30 defines the front shell flange on the shell side of the exchanger. P32 defines the channel inlet location. P40 defines the rear shell flange on the shell side of the exchanger. For exchanger ends B, M, S, T, U and W2, the system hardcodes the end to a 2TO1 end.

E319 Notes Specific to Form E319, Exchanger Ends


In the TYPE field, define the code that applies. P30 defines the front shell flange on the shell side of the exchanger. P32 defines the location of the channel inlet.

246

_ _______________
Appendix D: P40 defines the rear shell flange on the shell side of the exchanger. For exchanger ends B, M, S, T, U, and W2 the system hardcodes the end to a "+2T01" end. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ FRONT END 951 952 953 954 955 956 957 TDF No _ __ 1 2 3 4 5 6 7 TDF Name _____ FETYPE P30 P31 P32 P33 P34 P35 Field Length _ _____ 1 13 9 12 12 9 9 Field Type _ ____ 9 1 1 1 1 1 1 Var No/ Att No ______ 2 30 31 32 33 34 35 Nozzle Seq No _ _____ 0 0 0 0 0 0 0 Exit Code _ ____ 3 3 3 3 3 3 3 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Front end type ; ; ; ; ; ;

Exchanger Ends (E319)

REAR END 958 959 960 11 12 13 8 9 10 11 12 13 RETYPE P40 P41 P42 P43 P44 2 13 9 12 13 9 9 1 1 1 1 1 3 40 41 42 43 44 0 0 0 0 0 0 3 3 3 3 3 3 ;Rear end type ; ; ; ; ;

14

14

DATE

11

10

C38

;Date

Following is a list of form elements and their associated files:


E319 _ ____ e319.uf e319_ck.uf e319.tdf E319.fb General place channel routine __________________________ pl_channel.uf

Parametrics

247

_ _______________
PDS Eden for Equipment - April 2002

D.25

Double Pipe Exchanger (E320)

P4 is a nominal pipe diameter dimension. Actual outside diameter is used for graphic display. P8 defines the bundle pulling area. The default is the value of P1 + P2. If P9 and P10 are not defined, the corresponding support is not placed. If P12 is not defined, all supports are not placed. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot around the selected place point for sloped equipment. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

E320 Notes Specific to Form E320, Dbl Pipe Exchanger


P4 is a nominal pipe diameter dimension. Actual OD is used for graphic display. Use P8 to define the bundle pulling area. It defaults to P1 + P2.

248

_ _______________
Appendix D: If P9 or P10 is not defined, the corresponding support will be omitted. If P12 is not defined, all supports will be omitted. The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot about the selected PP for sloped equipment. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

Double Pipe Exchanger (E320)

SHELL 952 953 954 955 956 957 958 959 2 3 4 5 6 7 8 9 P1 P2 P3 P4 P5 P6 P7 P8 13 12 12 9 12 12 12 13 1 1 1 1 1 1 1 1 1 2 3 4 5 6 7 8 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 F2+F3 ; ; ; ; ; ; ; ;

SUPPORTS 960 11 12 13 14 15 10 11 12 13 14 15 P9 P10 P11 P12 P13 ANCH 13 13 12 9 12 1 1 1 1 1 1 3 9 10 11 12 13 14 0 0 0 0 0 0 3 3 3 3 3 3 ; ; ; ; ; ;

Parametrics

16 17

16 17

TUTNO DATE

4 11

7 9

4 1

0 0

1 1

"E320" C38 -

;Form no ;Date

201 202 203 204 208 209

201 202 203 204 208 209

PP X Y EL ANG SLOPE

1 18 18 16 11 13

1 1 1 1 2 1

0 0 0 0 0 0

0 0 0 0 0 0

1 1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N ;Slope

249

_ _______________
PDS Eden for Equipment - April 2002 Following is a list of form elements and their associated files:
E320 _ ____ e320.eqp e320_ck.uf e320.tdf E320.fb Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

250

_ _______________
Appendix D:

Plate Exchanger (E325)

D.26

Plate Exchanger (E325)

The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot around the selected place point for sloped equipment. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

Parametrics

E325 Notes Specific to Form E325, Plate Exchanger


The ANCH field defines which support will be anchored. The SLPE field defines the rise per foot about the selected PP for sloped equipment. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

EXCHANGER 952 953 954 2 3 4 P1 P2 P3 13 13 9 1 1 1 1 2 3 0 0 0 3 3 3 ; ; ;

251

_ _______________
PDS Eden for Equipment - April 2002
955 956 957 958 959 960 11 12 13 14 15 16 17 5 6 7 8 9 10 11 12 13 14 15 16 17 P4 P5 P6 P7 P8 P9 P10 P11 P12 P13 P14 P15 ANCH 13 13 13 13 13 9 13 9 12 13 9 12 1 1 1 1 1 1 1 1 1 1 1 1 1 3 4 5 6 7 8 9 10 11 12 13 14 15 16 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 3 3 3 ; ; ; ; ; ; ; ; ; ; ; ; ;

18 19

18 19

TUTNO DATE

4 11

7 9

4 1

0 0

1 1

"E325" C38 -

;Form no ;Date

201 202 203 204 208 209

201 202 203 204 208 209

PP X Y EL ANG SLOPE

1 18 18 16 11 13

1 1 1 1 2 1

0 0 0 0 0 0

0 0 0 0 0 0

1 1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N ;Slope

Following is a list of form elements and their associated files:


E325 _ ____ e325.eqp e325_ck.uf e325.tdf E325.fb Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

252

_ _______________
Appendix D:

Air Cooler (E330)

D.27

Air Cooler (E330)

To select the appropriate Air Cooler Bay, you must key in either I or F in the TYPE field. Type I (induced draft) brings up the Induced Draft Air Cooler Bay form (E332). Type F (forced draft) brings up the Forced Draft Air Cooler Bay form (E334). The BAYS field defines the number of units that apply. Data points (DP) are assumed to be located at mid-height and mid-width of inlet headers. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

Parametrics

E330 Notes Specific to Form E330, Air Cooler


In the TYPE field, define whether an induced (I) or a forced draft (F) air cooler applies. A secondary form will be accessed to allow definition of details. All air coolers must be identical. If revision of details is desired, re-entry of the applicable type is required. In the BAYS field, define the number of units that apply. DPs are assumed to be located at mid-height and mid-width of inlet headers. Characteristics of the parameters that apply to this form are as follows:

253

_ _______________
PDS Eden for Equipment - April 2002
Form Gadget Label _____ 951 952 953 TDF No _ __ 1 2 3 TDF Name _____ ITEM TYPE BAYS Field Length _ _____ 12 1 1 Field Type _ ____ 7 9 3 Var No/ Att No ______ 1 1 1 Nozzle Seq No _ _____ 0 0 0 Exit Code _ ____ 1 3 3 Default Value _____ 1 T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no ; ; 954 955 956 4 5 6 P1 P2 P3 12 12 12 1 1 1 2 3 4 0 0 0 3 3 3 ; ; ;

957 958

7 8

TUTNO DATE

4 11

7 9

4 2

0 0

1 1

"E330" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


E330 _ ____ e330.eqp e330_ck.uf e330.tdf E330.fb E332 _ ____ e332e334.uf e332e334_ck.uf e332.tdf E332.fb E334 _ ____ e334.tdf E334.fb Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

254

_ _______________
Appendix D:

Induced Draft Air Cooler Bay (E332)

D.28

Induced Draft Air Cooler Bay (E332)

To enter this form, you must key in I in the Air Cooler form (E330). To accept the current modifications and return to the Air Cooler form, select the ACCEPT option. Select the EXIT option to ignore the current modifications and return to the parametric main menu. Data points (DP) are assumed to be located at mid-height and mid-width of inlet headers. P30 defines the number of fans that apply in one unit. Fans are spaced by the distance specified in P32. If P34 is not defined, fans are not placed.

Parametrics

E332 Notes Specific to Form E332, Induced Draft Air Cooler Bay
DPs are assumed to be located at mid-height and mid-width of inlet header. P30 defines the number of fans that apply in one unit. Fans are spaced by a distance P32. If P34 is not defined, fans will be omitted. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ P21 P22 P23 P24 Field Length _ _____ 13 13 13 13 Field Type _ ____ 1 1 1 1 Var No/ Att No ______ 21 22 23 24 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 3 3 3 3 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ; ; ; ;

255

_ _______________
PDS Eden for Equipment - April 2002
955 956 957 958 959 960 11 12 13 14 5 6 7 8 9 10 11 12 13 14 P25 P26 P27 P28 P29 P30 P31 P32 P33 P34 13 12 12 12 12 1 13 13 13 12 1 1 1 1 1 3 1 1 1 1 25 26 27 28 29 30 31 32 33 34 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 ; ; ; ; ; ; ; ; ; ;

15

15

DATE

11

10

C38

;Date

Following is a list of form elements and their associated files:


E332 _ ____ e332e334.uf e332e334_ck.uf e332.tdf E332.fb

256

_ _______________
Appendix D:

Forced Draft Air Cooler Bay (E334)

D.29

Forced Draft Air Cooler Bay (E334)

To enter this form, you must key in F in the Air Cooler form (E330). To accept the current modifications and return to the Air Cooler form, select the ACCEPT option. Select the EXIT option to ignore the current modifications and return to the parametric main menu. Data points (DP) are assumed to be located at mid-height and mid-width of inlet headers. P30 defines the number of fans that apply in one unit. Fan are spaced by the distance specified in P32. If P34 is not defined, fans are not placed.

Parametrics

E334 Notes Specific to Form E334, Forced Draft Air Cooler Bay
See paragraph E332 for notes. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 956 957 958 TDF No _ __ 1 2 3 4 5 6 7 8 TDF Name _____ P21 P22 P23 P24 P25 P26 P27 P28 Field Length _ _____ 13 13 13 13 13 12 12 12 Field Type _ ____ 1 1 1 1 1 1 1 1 Var No/ Att No ______ 21 22 23 24 25 26 27 28 Nozzle Seq No _ _____ 0 0 0 0 0 0 0 0 Exit Code _ ____ 3 3 3 3 3 3 3 3 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ; ; ; ; ; ; ; ;

257

_ _______________
PDS Eden for Equipment - April 2002
959 960 11 12 13 14 9 10 11 12 13 14 P29 P30 P31 P32 P33 P34 12 1 13 13 13 12 1 3 1 1 1 1 29 30 31 32 33 34 0 0 0 0 0 0 3 3 3 3 3 3 ; ; ; ; ; ;

15

15

DATE

11

10

C38

;Date

Following is a list of form elements and their associated files:


E334 _ ____ e332e334.uf e332e334_ck.uf e334.tdf E334.fb

258

_ _______________
Appendix D:

Horizontal Rotating Equipment and Driver (E405)

D.30

Horizontal Rotating Equipment and Driver (E405)

Values of P1, P2, P3 and P4 must be positive values greater than zero. Values for the other fields are optional. P5 must be specified as a negative value. The following rules must be followed: -P5 + P7 + P12 +P14 must be less than or equal to P1. P8 must be less than or equal to P2. P9 must be less than or equal to P3. P15 must be less than or equal to P2. P16 must be less than or equal to P3. P17 must be greater than P11 + P13 / 2.

Parametrics

Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

259

_ _______________
PDS Eden for Equipment - April 2002

E405 Notes Specific to Form E405, Hor Rot Equip & Driver
Values of P1, P2, P3, and P4 must be nonzero positive values. Values for other fields are optional. P5 must be specified as a negative value. Following rules must be observed: P5 + P7 + P12 + P14 must be less than or equal to P1 P8 must be less than or equal to P2 P9 must be less than or equal to P3 P15 must be less than or equal to P2 P16 must be less than or equal to P3 P17 must be greater than P11 + P13/2 The following comments apply, but do not include in the help form: P13/2 must be less than P8 P13/2 must be less than P9 P13/2 must be less than P10 P13/2 must be less than P11 P13/2 must be less than P15 P13/2 must be less than P16 Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no

BASE 952 953 954 955 956 2 3 4 5 6 P1 P2 P3 P4 P5 13 13 13 12 14 1 1 1 1 1 1 2 3 4 5 0 0 0 0 0 3 3 3 3 3 ; ; ; ; ;

ROTATING EQUIP 957 958 959 7 8 9 P6 P7 P8 13 13 13 1 1 1 6 7 8 0 0 0 3 3 3 ; ; ;

260

_ _______________
Appendix D:
960 11 12 10 11 12 P9 P10 P11 13 13 13 1 1 1 9 10 11 0 0 0 3 3 3 ; ; ; DRIVER 13 14 15 16 17 18 13 14 15 16 17 18 P12 P13 P14 P15 P16 P17 13 12 13 13 13 13 1 1 1 1 1 1 12 13 14 15 16 17 0 0 0 0 0 0 3 3 3 3 3 3 ; ; ; ; ; ;

Horizontal Rotating Equipment and Driver (E405)

19 20

19 20

TUTNO DATE

4 11

7 9

4 1

0 0

1 1

"E405" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:


E405 _ ____ e405.eqp e405_ck.uf e405.tdf E405.fb Define _ _____ e200.uf e200.tdf E200.fb Define Weights _____________ e201.uf e201.tdf E201.fb

Parametrics

261

_ _______________
PDS Eden for Equipment - April 2002

D.31

Vertical Rotating Equipment and Driver (E410)

Values of P1, P2, P3 and P4 must be positive values greater than zero. Values for the other fields are optional. P9 defines the pulling area. Select the Define option to establish user specific definitions and insulation thickness using the Define (E200) form. Select the Define Weights option to establish the empty and operational weight of the parametric using the Define Weights (E201) form.

E410 Notes Specific to Form E410, Vert Rot Equip & Driver
Values of P1, P2, and P3 must be nonzero positive values. Values for other fields are optional. Use P9 to define the pulling area. The following comments apply, but do not include in the help form: If P5 is specified, value of P5 must be less than or equal to value of P3. If P8 is specified, value of P8 must be greater than or equal to value of P3.

262

_ _______________
Appendix D: Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 TDF No _ __ 1 TDF Name _____ ITEM Field Length _ _____ 12 Field Type _ ____ 7 Var No/ Att No ______ 1 Nozzle Seq No _ _____ 0 Exit Code _ ____ 1 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Equip group no PUMP 952 953 954 955 956 2 3 4 5 6 P1 P2 P3 P4 P5 13 13 13 13 12 1 1 1 1 1 1 2 3 4 5 0 0 0 0 0 3 3 3 3 3 ; ; ; ; ;

Vertical Rotating Equipment and Driver (E410)

DRIVER 957 958 959 960 7 8 9 10 P6 P7 P8 P9 13 13 13 13 1 1 1 1 6 7 8 9 0 0 0 0 3 3 3 3 ; ; ; ;

11 12

11 12

TUTNO DATE

4 11

7 9

4 1

0 0

1 1

"E410" C38 -

;Form no ;Date

201 202 203 204 208

201 202 203 204 208

PP X Y EL ANG

1 18 18 16 11

1 1 1 1 2

0 0 0 0 0

0 0 0 0 0

1 1 1 1 1

; ;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Following is a list of form elements and their associated files:

Parametrics

E410 _ ____ e410.eqp e410_ck.uf e410.tdf E410.fb

Define _ _____ e200.uf e200.tdf E200.fb

Define Weights _____________ e201.uf e201.tdf E201.fb

263

_ _______________
PDS Eden for Equipment - April 2002

D.32

E1 Ends (E905)

Valid for the E1 prompt ( E205 or E240 ) include: 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS. 2TO1, CAP, F&D, FLAT, HEMI and NONE ends are depicted using data retrieved by the system (Form E905 is not displayed). CONE, DOME, FLGD, TORC and TORS ends are depicted from data defined in this form (Form E905 is displayed and must be defined).

E905 Notes Specific to Form E905, E1 Ends


2T01, CAP, F&D, FLAT, HEMI, and NONE ends are depicted using data derived by the system. CONE, DOME, FLGD, TORC, and TORS ends are depicted from data defined in this form. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ TYPE P50 P51 P52 DATE Field Length _ _____ 5 14 13 13 11 Field Type _ ____ 9 1 1 1 9 Var No/ Att No ______ 31 50 51 52 34 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 3 3 3 3 1 Default Value _____ C1 C38 T2210 Att No ______ Explanatory Remarks ___________________ ;Head type ; ; ; ;Date

264

_ _______________
Appendix D: Following is a list of form elements and their associated files:
E905 _ ____ e905.uf e905_ck.uf e905.tdf E905.fb

E1 Ends (E905)

Parametrics

265

_ _______________
PDS Eden for Equipment - April 2002

D.33

E2 Ends (E906)

Valid values for the E2 prompt ( E240 ) include: 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS. 2TO1, CAP, F&D, FLAT, HEMI and NONE ends are depicted using data retrieved by the system (Form E906 is not displayed). CONE, DOME, FLGD, TORC and TORS ends are depicted from data defined in this form (Form E906 is displayed and must be defined).

E906 Notes Specific to Form E906, E2 Ends


Refer to paragraph E905 for comments. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ TYPE P55 P56 P57 Field Length _ _____ 5 14 13 13 Field Type _ ____ 9 1 1 1 Var No/ Att No ______ 32 55 56 57 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 3 3 3 3 Default Value _____ C2 T2210 Att No ______ Explanatory Remarks ___________________ ;Head type ; ; ;

955

DATE

11

35

C38

;Date

266

_ _______________
Appendix D: Following is a list of form elements and their associated files:
E906 _ ____ e906.uf e906_ck.uf e906.tdf E906.fb

E2 Ends (E906)

Parametrics

267

_ _______________
PDS Eden for Equipment - April 2002

D.34

E3 Ends (E907)

Valid values for the E3 prompt ( E205 or E240 ) include: 2TO1, CAP, CONE, DOME, F&D, FLAT, FLGD, HEMI, NONE, TORC or TORS. 2TO1, CAP, F&D, FLAT, HEMI and NONE ends are depicted using data retrieved by the system (Form E907 is not displayed). CONE, DOME, FLGD, TORC and TORS ends are depicted from data defined in this form (Form E907 is displayed and must be defined).

E907 Notes Specific to Form E907, E3 Ends


Refer to paragraph E905 for comments. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ TYPE P60 P61 P62 Field Length _ _____ 5 14 13 13 Field Type _ ____ 9 1 1 1 Var No/ Att No ______ 33 60 61 62 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 3 3 3 3 Default Value _____ C3 T2210 Att No ______ Explanatory Remarks ___________________ ;Head type ; ; ;

955

DATE

11

36

C38

;Date

Following is a list of form elements and their associated files:


E907 _ ____ e907.uf e907_ck.uf e907.tdf E907.fb

268

_ _______________
Appendix D:

E3 Ends (E907)

D.35

Complex Vertical Cylindrical Equipment (N205)

The nozzle parametrics, N205 - N410, are included in this appendix, but Appendix D contains more information on nozzles.

D.36

Simple Vertical Cylindrical Equipment (N210)

Parametrics

269

_ _______________
PDS Eden for Equipment - April 2002

D.37

Simple Vertical Cylindrical Equipment (N215)

D.38

Spherical Equipment (N230)

270

_ _______________
Appendix D:

Complex Horizontal Cylindrical Equipment (N240)

D.39

Complex Horizontal Cylindrical Equipment (N240)

D.40

Simple Horizontal Cylindrical Equipment (N245)

Parametrics

271

_ _______________
PDS Eden for Equipment - April 2002

D.41

Horizontal Shell and Tube Exchanger (N305)

D.42

Kettle Exchanger (N307)

272

_ _______________
Appendix D:

Vertical Shell and Tube Exchanger (N310)

D.43

Vertical Shell and Tube Exchanger (N310)

D.44

Double Pipe Exchanger (N320)

Parametrics

273

_ _______________
PDS Eden for Equipment - April 2002

D.45

Plate Exchanger (N325)

D.46

Air Cooler (N330)

274

_ _______________
Appendix D:

Horizontal Rotating Equipment and Driver (N405)

D.47

Horizontal Rotating Equipment and Driver (N405)

D.48

Vertical Rotating Equipment and Driver (N410)

Parametrics

275

_ _______________
PDS Eden for Equipment - April 2002

D.49

Gear Cover (U850)

U850 Notes Specific to Form U850, Gear Cover


This form is used to define a flat oval projected with face parallel to each other. It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection. The active secondary axis orients the flat sides of the faces. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ A B C D Field Length _ _____ 16 16 16 16 Field Type _ ____ 1 1 1 1 Var No/ Att No ______ 1 2 3 4 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 2 2 2 2 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Distance ;Diameter1 ;Diameter2 ;Projection

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

276

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U850 _ ____ u850.eqp u850.uf u850.tdf U850.fb

Gear Cover (U850)

Parametrics

277

_ _______________
PDS Eden for Equipment - April 2002

D.50

Round Torus Miter (U860)

U860 Notes Specific to Form U860, Circular Miter


This form is used to define a segmented round torus. It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection of the first segment. The active secondary axis points to the center of rotation. Maximum number of miter sections per miter is 30. Maximum bend angle per miter is 180 degrees. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 TDF No _ __ 1 2 3 4 TDF Name _____ A B C D Field Length _ _____ 16 16 16 16 Field Type _ ____ 1 2 3 1 Var No/ Att No ______ 1 2 3 4 Nozzle Seq No _ _____ 0 0 0 0 Exit Code _ ____ 2 2 2 2 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Bend radius ;Bend angle ;No of miter sections ;Cyl diameter

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

278

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U860 _ ____ u860.eqp u860.uf u860.tdf U860.fb

Round Torus Miter (U860)

Parametrics

279

_ _______________
PDS Eden for Equipment - April 2002

D.51

Rectangular Torus Miter (U861)

U861 Notes Specific to Form U861, Rectangular Miter


This form is used to define a segmented rectangular torus. It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection of the first segment. The active secondary axis points to the center of rotation. Maximum number of miter sections per miter is 30. Maximum bend angle per miter is 180 degrees. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ A B C D E Field Length _ _____ 16 16 16 16 16 Field Type _ ____ 1 2 3 1 1 Var No/ Att No ______ 1 2 3 4 5 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 2 2 2 2 2 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Bend radius ;Bend angle ;No of miter sections ;Rect depth ;Rect width

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

280

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U861 _ ____ u861.eqp u861.uf u861.tdf U861.fb

Rectangular Torus Miter (U861)

Parametrics

281

_ _______________
PDS Eden for Equipment - April 2002

D.52

Vertical Oval Torus Miter (U862)

U862 Notes Specific to Form U862, Vertical Oval Miter


This form is used to define a segmented flat oval torus. It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection of the first segment. The active secondary axis points to the center of rotation. Maximum number of miter sections per miter is 30. Maximum bend angle per miter is 180 degrees. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ A B C D E Field Length _ _____ 16 16 16 16 16 Field Type _ ____ 1 2 3 1 1 Var No/ Att No ______ 1 2 3 4 5 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 2 2 2 2 2 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Bend radius ;Bend angle ;No of miter sections ;Oval depth ;Oval width

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

282

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U862 _ ____ u862.eqp u862.uf u862.tdf U862.fb

Vertical Oval Torus Miter (U862)

Parametrics

283

_ _______________
PDS Eden for Equipment - April 2002

D.53

Flat Oval Torus Miter (U863)

U863 Notes Specific to Form U863, Horizontal Oval Miter


This form is used to define a segmented horizontal flat oval torus. It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection of the first segment. The active secondary axis points to the center of rotation. Maximum number of miter sections per miter is 30. Maximum bend angle per miter is 180 degrees. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ A B C D E Field Length _ _____ 16 16 16 16 16 Field Type _ ____ 1 2 3 1 1 Var No/ Att No ______ 1 2 3 4 5 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 2 2 2 2 2 Default Value _____ T2210 Att No ______ Explanatory Remarks ___________________ ;Bend radius ;Bend angle ;No of miter sections ;Oval depth ;Oval width

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

284

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U863 _ ____ u863.eqp u863.uf u863.tdf U863.fb

Flat Oval Torus Miter (U863)

Parametrics

285

_ _______________
PDS Eden for Equipment - April 2002

D.54

Flat Oval Prism (U870)

U870 Notes Specific to Form U870, Oval to Oval Prism


This form is used to define a flat oval prism projected with face parallel but offset along both secondary and normal axis to each other. It is placed by a point in the middle of the first face. The active primary axis orients the direction of projection. The active secondary axis orients the flat sides of the faces. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 956 957 TDF No _ __ 1 2 3 4 5 6 7 TDF Name _____ A B C D E F G Field Length _ _____ 16 16 16 16 16 16 16 Field Type _ ____ 1 1 1 1 1 1 1 Var No/ Att No ______ 1 2 3 4 5 6 7 Nozzle Seq No _ _____ 0 0 0 0 0 0 0 Exit Code _ ____ 2 2 2 2 2 2 2 Default Value _____ 0 0 T2210 Att No ______ Explanatory Remarks ___________________ ;Prism height ;Oval width1 ;Oval depth1 ;Oval width2 ;Oval depth2 ;Oval offset1 ;Oval offset2

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

286

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U870 _ ____ u870.eqp u870.uf u870.tdf U870.fb

Flat Oval Prism (U870)

Parametrics

287

_ _______________
PDS Eden for Equipment - April 2002

D.55

Flat Oval Torus (U880)

U880 Notes Specific to Form U880, Oval Torus


This form is used to define a flat oval torus. It is placed by a point in the middle of the first face. The active primary axis is the normal of the starting face. The active secondary axis points to the center of rotation. A value of 0 for Parameter E (oval rotation) places the oval face vertical. A value of 90 for Parameter E (oval rotation) places the oval face horizontal. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 TDF No _ __ 1 2 3 4 5 TDF Name _____ A B C D E Field Length _ _____ 16 16 16 16 16 Field Type _ ____ 1 2 1 1 2 Var No/ Att No ______ 1 2 3 4 5 Nozzle Seq No _ _____ 0 0 0 0 0 Exit Code _ ____ 2 2 2 2 2 Default Value _____ 0 T2210 Att No ______ Explanatory Remarks ___________________ ;Bend radius ;Bend angle ;Oval width ;Oval depth ;Oval rotation

202 203 204 208

202 203 204 208

X Y EL ANG

16 16 16 16

1 1 1 2

0 0 0 0

0 0 0 0

1 1 1 1

;Site EW coord of PP ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

288

_ _______________
Appendix D: Following is a list of form elements and their associated files:
U880 _ ____ u880.eqp u880.uf u880.tdf U880.fb

Flat Oval Torus (U880)

Parametrics

289

_ _______________
PDS Eden for Equipment - April 2002

D.56

Rectangular 90 Cone Torus with Offset (U881)

U881 Notes Specific to Form U881, Rectangular to Rectangular Torus


This form is used to define a rectangular torus, with or without an offset. It is placed by a point in the middle of the first face. The active primary axis is the normal of the starting face. The active secondary axis points to the center of rotation. Characteristics of the parameters that apply to this form are as follows:
Form Gadget Label _____ 951 952 953 954 955 956 957 958 TDF No _ __ 1 2 3 4 5 6 7 8 TDF Name _____ A B C D E F G H Field Length _ _____ 16 16 16 16 16 16 16 16 Field Type _ ____ 1 1 1 1 1 1 1 1 Var No/ Att No ______ 1 2 3 4 5 6 7 8 Nozzle Seq No _ _____ 0 0 0 0 0 0 0 0 Exit Code _ ____ 2 2 2 2 2 2 2 2 Default Value _____ 0 0 0 T2210 Att No ______ Explanatory Remarks ___________________ ;Bend radius ;Rect width1 ;Rect depth1 ;Rect width2 ;Rect depth2 ;Rect offfset1 ;Rect offset2 ;Rect offset3

202

202

16

;Site <EW coord of PP

290

_ _______________
Appendix D:
203 204 208 203 204 208 Y EL ANG 16 16 16 1 1 2 0 0 0 0 0 0 1 1 1 ;Site NS coord of PP ;Site elev of PP ;Ang site N equip N

Rectangular 90 Cone Torus with Offset (U881)

Following is a list of form elements and their associated files:


U881 _ ____ u881.eqp u881.uf u881.tdf U881.fb

Parametrics

291

_ _______________
PDS Eden for Equipment - April 2002

D.57

User Projected Shape (USRPRJ)

292

_ _______________
Glossary
AA code AABB code AABBCC code An alphanumeric code used to identify a group of elements. An alphanumeric code which defines the class of an item. an alphanumeric code which represents a specific item type within a given class. This value is also referred to as the Item Name. Operator used to form arithmetic expressions. see piping assembly A property or characteristic of an entity. A column in an entity table. Eden statements that define the types of modules being entered. bill of materials Eden statement used to execute system primitives (or subroutines). A set of acceptable values for a particular attribute (column) which can be referred to by an index number or selected from a form. For example, the code list set for the fluid code attribute allows you to select from a set of standard entries (such as P for process or MMA for methyl alcohol). Files which define the values for all codelists having universal applicability within PDS. an attribute linked to a specific entry in a code list set. These attribute values can be referenced by entering the associated code list number. A file which contains the standard color settings to be used for a design file or set of design files. An attribute of a table. A group of columns defines a table. Text inserted into Eden code which is ignored by the system. Comments can be used to describe the code and to provide instructions to the user.

Glossary

arithmetic operator assembly attribute beginning statements BOM call statement code list

code list sets

code-listed attribute

color table

column comment

Glossary

commodity code

a user-defined code that provides an index to the material descriptions in the Material Data Tables of the Specification/Material Database. a standard component found in a manufacturers catalog (off-the-shelf component). a graphic symbol representing a commodity item, specialty item, instrument, or pipe support. Gate valves, elbows and expansion joints are examples of piping components.

commodity item

component

293

_ _______________
PDS Eden for Equipment - April 2002 database A collection of comprehensive informational files having predetermined structure and organization that can then be communicated, interpreted, or processed by a specific program. The part of the database that is made of rows and columns and contains information about the project and design elements. a database which contains the non-graphic design data for a project. Each model represents a partition of the database. see physical data table Eden statement used to form indefinite loops. The condition of a Do While statement must equal a logical value (either true or false). The body of the Do While statement will be repeatedly executed as long as the logical expression remains true. a high-level parametric language (similar to FORTRAN) which uses information from the Piping Job Specification and Design Database to access parametric and dimensional data, and place parametric symbols. the source code used to define and place parametric symbols in the model. Eden modules are contained in the Graphic Commodity Library. Eden statements that mark the end of the module in which the system has been processing. An object (project, drawing, element, etc.) of interest about which information is stored; a relational database table. Variables, constants, and operators combined to form statements. An area of a table used to display information or receive input. An interface or screen menu designed with the I/FORMS product or with the DM/DBA product. Because many of the screen menus in the application software on CLIX workstations are built with I/FORMS, you must have the FORMS_S product on your workstation. There is no such requirement for Windows NT. a file that determines the contents and format of a report. It defines all the needed criteria for creating the actual report, including which database attributes are reported. The name of the entire path or directory hierarchy to a file, including the file name. See also relative path name. Graphic Commodity Library Physical data module containing information common to more than one symbol. Generic physical data modules are called by specific physical data modules. database table

design database

dimension table Do While statement

Eden

Eden module

ending statements

entity

expression field form

format file

full path name

GCL generic physical data module

294

_ _______________
Geometric industry standard a code-listed attribute which identifies the source of the data (industry standard such as ANSI, ISO, or DIN, or company standard) from which the specific geometry of a commodity item is deduced. System-defined names that can be referred to at any subroutine level. a data library which contains the parametric symbol definitions (Eden modules) required to place piping and instrument components in a 3-D model. Eden statement that allows a group of statements to be conditionally executed. Eden statement which allows loops that execute a specified number of times. global variable Graphic Commodity Library

Glossary

If - then - else statement

Indexed Do statement

instrument

an item used to perform a process measurement, process indication, or control function. Instruments can be defined in the Piping Job Specification or defined interactively while working in the model. Eden code used to define the interference envelope for a component, to be used in interference detection to show clashes in the model. name used to access the Piping Job Specification. Refer to AABBCC code. Eden label for specific values or groups of values. Keywords can appear as arguments in system-defined primitives (or subroutines). a library which defines the types of labels and the label formats used in PDS 3D. Variable that is declared in the symbol definition, and which can only be referred to in the same Eden module as the variable itself. Operator used to combine relational expressions into more complex logical expressions. a library which contains the long bill-of-material descriptions for all piping commodities. model code

interference parametric shape definition item name keyword

Label Description Library

local variable

logical operator

Long Material Description Library MC model model code

Glossary

a 3-D design volume. name used to reference the parametric definition of a component. The model code is also referred to as the new item name. Eden code used to define the symbol graphics to be placed in the model.

model parametric shape definition module

a specialized application within PDS such as the Piping Designer or Equipment Modeling task.

295

_ _______________
PDS Eden for Equipment - April 2002 monument MTO network the origin point for a coordinate system or design volume. material take-off An interconnection of host computers and workstations that enables them to share data and control. The term network can mean the devices that connect the system, or it can mean the connected system. an ASCII file which can be used to load data into a library, database, or design file. nominal piping diameter a compiled library which contains reference data which can be accessed by the task. For example, the Material Description Library. operator code Symbol or string used in conjunction with variables to form expressions. operator type Piping Assembly Language Eden code used to describe the graphics symbol placed for a component in the model. Parametric shape definitions are divided into two basic types: model parametric shapes and interference envelopes. a subset of the database. Each model represents a partition of the database. Piping and Instrumentation Diagram The sequence of directories leading to a file. See also full path name and relative path name. Plant Design System a user-defined component. Specialty items can be defined in the Piping Job Specification database or defined interactively while working in a model. A set of code which gathers data to use in placing graphics for commodity items. a table which contains the physical data such as dimensions, weights, and surface area required for component placement, interference checking, stress analysis, and MTO reporting. These tables can be stored in different physical data libraries segregated by geometric industry standard (practice). a group of associated components that can be placed as a logical group (such as a valve with mating flanges) using Piping Assembly Language syntax.

neutral file

NPD object library

OC operator OT PAL parametric shape definition

partition P&ID path name

PDS piping specialty

physical data definition

physical data table

piping assembly

296

_ _______________
Piping Assembly Library Piping Job Specification non-graphics data which provides selection criteria for piping commodity items, engineered items, and instruments. a classification of components by service or specification. For example, a 150 pound carbon steel specification. Piping Job Specification A group of facilities and equipment used to perform one or more material processing functions within a given geographical area. One company may have many plants located in many different geographical locations. Piping Materials Class System-defined Eden routines that perform specific functions for symbol definition. A term used for the convenient grouping of either all or part of the facilities and equipment that constitute a plant. At a given time, the items that constitute the plant can be included in one or more projects. An alphanumeric code used to refer to a specific project. a database used to define all the information related to managing a project including design area definitions, interference management data, and revision management data. Reference Database Piping Materials Class

Glossary

a library which contains the piping assembly definitions which define the parameters necessary to place a piping assembly automatically in the model.

PJS plant

PMC primitive

project

project number project control database

RDB Reference Database

A collection of reference data containing information relative to industry design codes, vendors catalog data, job specifications, commodity libraries, graphics symbology, label descriptions, report formats and other information of a similar manner. A database management system that uses SQL, the Structured Query Language, to implement and query data in relational tables.

Relational DataBase Management System RDBMS Relational Interface System relational operator

A generic relational database interface that isolates the differences in specific vendors relational database management systems. Operator used to form relational expressions that test the value of an Eden expression or establish conditions under which a group of Eden statements can be executed. The sequence of directories leading from the current directory to a particular file. See also path name and absolute path name.

Glossary

relative path name

297

_ _______________
PDS Eden for Equipment - April 2002 replacement statement report format file RIS row Eden statements used to set variables or perform calculations. see format file Relational Interface System. A unit of related information in a table. One collection of column values for a table. An RIS schema identifies a unique database/user combination existing in a commercial database system. a set of values used to scan a database or object library. default data used in the creation of new projects/models/drawings. a library which contains the short bill-of-material descriptions for all piping commodity items and the description addenda for taps. A grouping of three-dimensional world data corresponding to schematic data from one or more units. The relation-ship of site with plant and project is identical to that between unit with plant and project. symbol name the uncompiled version of a language file or other data table. Source files are usually contained in text libraries. See also neutral file. a library which contains the Piping Job Specification tables and other special tables which contain nonphysical data. an piping specialty or instrument. a library which contains the bill-of-material descriptions for engineered items, instruments, and pipe supports. Physical data module that determines the dimensions and other physical properties for a specific component. a set of acceptable responses defined in the Standard Note Library. See also code-list. library which contains the text for code-listed attributes and standard notes. All attributes identified as code-listed are stored in the database as integer data. A set of code used to produce graphics for a subcomponent on a commodity item. The controlling function or logic used to produce the graphics for a commodity item.

schema

search criteria seed data Short Material Description Library site

SN source file

Spec Table Library

specialty item Specialty Material Description Library specific physical data module standard note

Standard Note Library

sub-symbol processor

symbol processor

298

_ _______________
task A specialized PDS function such as the Piping and Instrumentation Diagrams (P&ID) task or the Piping Designer task. Working database in which the actual engineering or design effort is performed. A separate task database exists for each PDS task. Task Database task database TDB text library

Glossary

a library which contains a set of ASCII files. The PDS 3D software enables you to extract source files from a text library. To switch; to change between two alternatives. Text table containing data used in placing graphics for equipment. an element used to store active parameters and customization data in a model or drawing. Most of the customization data defined with the Project Data Manager is stored in a type 63 element. A grouping of those parts of the schematic and individual worlds of a plant that together perform a given process function. An expression whose value can change. Used as a placeholder for information in Eden code. Variables can be either global or local in Eden code.

toggle tutorial definition table type 63 element

unit

variable

Glossary

299

_ _______________
PDS Eden for Equipment - April 2002

300

_ _______________
Index
A a commands 146 abort 62 additional features 149 air cooler e330 253 n330 274 alphanumeric data types 175 application commands 146 system-defined 147 user-defined 147 arithmetic operators 42 B begin 29 EQP category 31 beginning statements 28 C call statement 45 tutorial (C) 162 circular platform (a001) 191 code listed data types 175 codelist (CL330) 171 commands debugger 159 comments 41 complex horizontal cylindrical equipment e240 231 n240 271 vertical cylindrical equipment, skirt e205 222 n205 269 concurrent display 158 convert NPD to subunits 48 unit 63 D data types alphanumeric 175 code listed 175

Index

Index

data (continued) types (continued) numeric 175 database records 175 table equipment group 176 nozzle 177 davit a (a061) 214 b (a063) 216 debugger 155 call tutorial (C) 162 commands 159 concurrent display 158 deposit global (DG) 163 deposit local (DL) 164 examine global variables (EG) 166 local variables (EL) 165 symbol name (ES) 167 exiting 157 invoking 156 move to specific source line or continue (Go) 168 set line break (B) 161 step into user function (SI) 169 through source code (S) 169 switch modes (ON and OF) 160 prompt terminal (P) 170 default project control data 137 define active orientation 49 point 64 datum point 65 (e200) 218 library 66 nozzle 68 orientation by points 70 placepoint 71 point 72 weights (e201) 220

301

_ _______________
PDS Eden for Equipment - April 2002 delivered parametrics 189 deposit global (DG) 163 local (DL) 164 description statement 40 display message 73 tutorial 74 do while statement 45 double pipe exchanger e320 248 n320 273 draft air cooler bay forced 257 induced 255 draw arc 76 complex surface 77 con prism 80 cone 51 curve 81 cylinder 52 ecc prism 82 transitional element 84 eccentric cone 53 ellipse 85 line 86 string 87 proj hexagon 88 octagon 90 shape 92 projected rectangle 54 triangle 56 rectangular torus 93 revolved shape 94 semi ellipsoid 58 shape 96 sphere 59 torus 60 transitional element 97 E E1 ends (e905) 264 E2 ends (e906) 266 E3 ends (e907) 268 Eden basics 15 debugger 155 Eden (continued) language structure 27 beginning statements 28 comments 41 ending statements 28 expressions 44 functions 47 keywords 39 operators 42 replacement statements 44 variables 33 ending statements 28 ends 264, 266, 268 E1 264 E2 266 E3 268 EQP Eden program examples 179 equipment data definition 175 group database table 176 item name 175 nozzle database table 177 examine global variables (EG) 166 local variables (EL) 165 symbol name (ES) 167 examples EQP Eden program 179 exchanger ends (e319) 246 exiting the debugger 157 expressions 44 call 45 do while 45 if - then - else 46 indexed do 45 replacement statements 44 F field numbers system-defined 145 flat oval prism 286 flat oval torus 288 flat oval torus miter 284 flat_oval_prism 125 flat_oval_seg_tor1 127 flat_oval_seg_tor2 128 flat_oval_tor 126 forced draft air cooler bay (e334) 257 form interface additional features 149

302

_ _______________
functions 47 G gear cover 276 get arc points 98 size 99 date 100 EQP category 101 line size 102 point 103 global variables 35, 36 equipment and pipe support 36 subscripted 37 H handrail a (a051) 212 holes for miscellaneous platforms (a016) 199 for platforms (a015) 196 horizontal cylindrical equipment complex 231 simple 234 rotating equipment and driver e405 259 n405 275 shell and tube exchanger e305 237 n305 272 I i fields 144 if - then - else statement 46 indexed do statement 45 induced draft air cooler bay (e332) 255 input fields 144 angular 144 character data input 144 dimensional 144 equipment database attributes 144 integer 144 nozzle database attributes 144 nozzle dimensions 144 interacting terminated fields 74 invoking the debugger 156 K kettle exchanger e307 240 kettle exchanger (continued) n307 272 keywords common 39 L local variables 33 logical operators 43 M miscellaneous platform (a003) 194 move along arc 105 axis 106 line 107 by distance 108 data 109 to placepoint 110 specific source line or continue (Go) 168 N numeric data types 175 O operators 42 arithmetic 42 logical 43 relational 43 P parametric flat oval prism 286 flat oval torus 288 flat oval torus miter 284 gear cover 276 rectangular 90 Cone Torus 290 rectangular torus miter 280 round torus miter 278 vertical oval torus miter 282 parametrics air cooler (e330) 253 circular platform (a001) 191 complex horizontal cylindrical equipment (e240) 231 vertical cylindrical equipment, skirt (e205) 222 davit a (a061) 214

Index

Index

303

_ _______________
PDS Eden for Equipment - April 2002 parametrics (continued) davit (continued) b (a063) 216 define e200 218 weights (e201) 220 double pipe exchanger (e320) 248 E1 ends (e905) 264 E2 ends (e906) 266 E3 ends (e907) 268 exchanger ends (e319) 246 forced draft air cooler bay (e334) 257 handrail a (a051) 212 holes for miscellaneous platforms (a016) 199 platforms (a015) 196 horizontal rotating equipment and driver (e405) 259 shell and tube exchanger (e305) 237 induced draft air cooler bay (e332) 255 kettle exchanger (e307) 240 miscellaneous platform (a003) 194 plate exchanger (e325) 251 side ladder a (a031) 206 details (a039) 208 simple horizontal cylindrical equipment (e245) 234 vertical cylindrical equipment legs (e215) 227 skirt (e210) 225 spherical equipment (e230) 229 stairs a (a041) 210 thru ladder a (a021) 202 details (a029) 204 vertical rotating equipment and driver (e410) 262 shell and tube exchanger (e310) 243 place COG 111 plate exchanger e325 251 n325 274 position cursor 113 primitives 48 convert NPD to subunits 48 define active orientation 49 draw cone 51 cylinder 52 primitives (continued) draw (continued) eccentric cone 53 projected rectangle 54 projected triangle 56 semi ellipsoid 58 sphere 59 torus 60 equipment modeling abort 62 begin 29 begin EQP category 31 convert unit 63 define active point 64 datum point 65 library 66 nozzle 68 orientation by points 70 placepoint 71 point 72 display message 73 tutorial 74 draw arc 76 complex surface 77 con prism 80 curve 81 ecc prism 82 transitional element 84 ellipse 85 line 86 string 87 proj hexagon 88 octagon 90 shape 92 rectangular torus 93 revolved shape 94 shape 96 transitional element 97 flat_oval_prism 125 flat_oval_seg_tor1 127 flat_oval_seg_tor2 128 flat_oval_tor 126 get arc points 98 size 99

304

_ _______________
primitives (continued) equipment modeling (continued) get (continued) date 100 EQP category 101 line size 102 point 103 move along arc 105 axis 106 line 107 by distance 108 data 109 to placepoint 110 place COG 111 position cursor 113 put field 114 read table 115 rect_flat_oval 132 rect_seg_tor 131 retrieve nozzle parameters 117 rotate orientation 119 round_rect 133 round_seg_tor1 129 round_seg_tor2 130 start complex shape 120 stop complex shape 121 store nozzle parameters 123 orientation 122 user function 124 user projected shape 292 program examples EQP 179 put field 114 R read table 115 rectangular 90 Cone Torus 290 rectangular torus miter 280 rect_flat_oval 132 rect_seg_tor 131 reference database management data default project control data 137 relational operators 43 replacement statements 44 retrieve nozzle parameters 117 rotate orientation 119 rotating equipment and driver horizontal 259 vertical 262 round torus miter 278 round_rect 133 round_seg_tor1 129 round_seg_tor2 130 S set line break (B) 161 shell and tube exchanger horizontal 237 vertical 243 side ladder a (a031) 206 ladder details (a039) 208 simple horizontal cylindrical equipment (e245) 234 cylindrical equipment (n245) 271 vertical cylindrical equipment, legs (e215) 227 cylindrical equipment, legs (n215) 270 cylindrical equipment, skirt (e210) 225 cylindrical equipment, skirt (n210) 269 spherical equipment e230 229 n230 270 stairs a (a041) 210 start complex shape 120 statements beginning 28 call 45 do while 45 ending 28 if - then - else 46 indexed do 45 replacement 44 step into user function (SI) 169 through source code (S) 169 stop complex shape 121 store nozzle parameters 123 orientation 122 structure Eden 27 subscripted global variables 37 switch modes (ON and OF) 160 prompt terminal (P) 170

Index

Index

305

_ _______________
PDS Eden for Equipment - April 2002 system-defined application commands 147 field numbers 145 T tables tutorial definition 20 terminated fields interacting 74 thru ladder a (a021) 202 details (a029) 204 tutorial definition table 20 type statement 40 typefaces 11 U user function 124 flat_oval_prism 125 flat_oval_seg_tor1 127 flat_oval_seg_tor2 128 flat_oval_tor 126 rect_flat_oval 132 rect_seg_tor 131 round_rect 133 round_seg_tor1 129 round_seg_tor2 130 user projected shape 292 user-defined application commands 147 V variables 33 global 35 local 33 vertical cylindrical equipment complex 222 simple 225, 227 rotating equipment and driver e410 262 n410 275 shell and tube exchanger e310 243 n310 273 vertical oval torus miter 282

306

S-ar putea să vă placă și