tm-1801 aveva everything3d™ (1.1) foundations rev 2.0

7/17/2019 TM-1801 AVEVA Everything3D™ (1.1) Foundations Rev 2.0

http://slidepdf.com/reader/full/tm-1801-aveva-everything3d-11-foundations-rev-20 1/145

TM-1801

AVEVA Everything3D™ (1.1)

Foundations

TrainingGuide



AVEVA Everything3D™ (1.1)Foundations TM-1801

2 www.aveva.com© Copyright 2012 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.

This page is intentionally left blank.





Revision Log

Date Revision Description Author Reviewed Approved

01/03/2013 0.1 Issued for Review AVEVA E3D™ (1.1) NG

01/03/2013 0.2 Reviewed NG KB

05/03/2013 1.0 Issued for Training AVEVA E3D™ (1.1) NG KB PJH

20/01/2014 1.1 Issued for Review AVEVA E3D™ (1.1) CT

21/01/2014 1.2 Reviewed CT KB

21/01/2014 2.0 Issued for Training AVEVA E3D™(1.1) CT KB KB

Updates

Change highlighting will be employed for all revisions. W here new or changed information is presentedsection headings will be highlighted in Yellow.

Suggestion / Problems

If you have a suggestion about this manual or the system to which it refers please report it to AVEVATraining & Product Support at [email protected]

This manual provides documentation relating to products to which you may not have access or which maynot be licensed to you. For further information on which products are licensed to you please refer to your licence conditions.

Visit our website at http://www.aveva.com

Disclaimer

1.1 AVEVA does not warrant that the use of the AVEVA software will be uninterrupted, error-free or freefrom viruses.

1.2 AVEVA shall not be liable for: loss of profits; loss of business; depletion of goodwill and/or similar losses; loss of anticipated savings; loss of goods; loss of contract; loss of use; loss or corruption of data or information; any special, indirect, consequential or pure economic loss, costs, damages,charges or expenses which may be suffered by the user, including any loss suffered by the user resulting from the inaccuracy or invalidity of any data created by the AVEVA software, irrespective of

whether such losses are suffered directly or indirectly, or arise in contract, tort (including negligence)or otherwise.

1.3 AVEVA's total liability in contract, tort (including negligence), or otherwise, arising in connection withthe performance of the AVEVA software shall be limited to 100% of the licence fees paid in the year in which the user's claim is brought.

1.4 Clauses 1.1 to 1.3 shall apply to the fullest extent permissible at law.

1.5 In the event of any conflict between the above clauses and the analogous clauses in the softwarelicence under which the AVEVA software was purchased, the clauses in the software licence shalltake precedence.





Copyright

All intellectual property rights, including but not limited to, copyright in this manual and the associatedsoftware, (including source code, object code, and any data) belongs to or is validly licensed by AVEVASolutions Limited or its subsidiaries.

All rights are reserved to AVEVA Solutions Limited and its subsidiaries. The information contained in thisdocument is commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without the prior written permission of AVEVA Solutions Limited. Where such permission isgranted, it expressly requires that this Disclaimer and Copyright notice is prominently displayed at thebeginning of every copy that is made.

The manual and associated documentation may not be adapted, reproduced, or copied, in any material or electronic form, without the prior written permission of AVEVA Solutions Limited. The user may also notreverse engineer, decompile, copy, or adapt the associated software. Neither the whole, nor part of theproduct described in this publication may be incorporated into any third-party software, product, machine, or system without the prior written permission of AVEVA Solutions Limited, save as permitted by law. Any suchunauthorised action is strictly prohibited, and may give rise to civil liabilities and criminal prosecution.

The AVEVA products described in this guide are to be installed and operated strictly in accordance with theterms and conditions of the respective licence agreements, and in accordance with the relevant User Documentation. Unauthorised or unlicensed use of the product is strictly prohibited.

Copyright 2012 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved. AVEVAshall not be liable for any breach or infringement of a third party's intellectual property rights where suchbreach results from a user's modification of the AVEVA software or associated documentation.

The AVEVA Everything3D™ user interface is based on the Microsoft® Office Fluent™ user interface.

Trademark

AVEVA™, AVEVA Everything3D™, and AVEVA E3D™ are registered trademarks of AVEVA Group plc or

its subsidiaries. AVEVA product names are trademarks or registered trademarks of AVEVA SolutionsLimited or its subsidiaries. Unauthorised use of trademarks belonging to AVEVA Group plc or its subsidiariesis strictly forbidden.

Fluent is a trademark of Microsoft Corporation and the Fluent user interface is licensed from MicrosoftCorporation.

The Microsoft Office User Interface is subject to protection under U.S. and international intellectual propertylaws and is used by AVEVA Solutions Limited under license from Microsoft.

AVEVA product/software names are trademarks or registered trademarks of AVEVA Solutions Limited or itssubsidiaries, registered in the UK, Europe and other countries (worldwide).

The copyright, trademark rights, or other intellectual property rights in any other product or software, itsname or logo belongs to its respective owner.

AVEVA Solutions Limited, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom.



5

CONTENTS

www.aveva.com© Copyright 2012 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.

1 Introduction .............................................................................................................................................. 91.1 Aim ..................................................................................................................................................... 91.2 Objectives.......................................................................................................................................... 91.3 Prerequisites ..................................................................................................................................... 91.4 Course Structure............................................................................................................................... 9

1.5 Using this guide ................................................................................................................................ 9

2 AVEVA Everything3D™ Fundamentals ............................................................................................... 112.1 How AVEVA E3D is Structured...................................................................................................... 112.2 Model................................................................................................................................................ 11

2.2.1 Draw .......................................................................................................................................... 122.2.2 Isodraft ....................................................................................................................................... 132.2.3 Monitor....................................................................................................................................... 132.2.4 Spool.......................................................................................................................................... 13

2.3 AVEVA E3D Databases .................................................................................................................. 142.4 How data is stored in AVEVA E3D ................................................................................................ 15

2.4.1 World (WORL) ........................................................................................................................... 162.4.2 Site (SITE) ................................................................................................................................. 16

2.4.3 Zone (ZONE) ............................................................................................................................. 162.4.4 Equipment (EQUI) ..................................................................................................................... 162.4.5 Sub-Equipment (SUBE)............................................................................................................. 162.4.6 Primitives ................................................................................................................................... 172.4.7 Volume Model (VOLM) .............................................................................................................. 172.4.8 Sub-Volume Model (SVOLM) .................................................................................................... 172.4.9 Structure (STRU) ....................................................................................................................... 172.4.10 Framework (FRMW) .................................................................................................................. 172.4.11 Sub-Framework (SBFR) ............................................................................................................ 172.4.12 Structural Components .............................................................................................................. 172.4.13 Pipe (PIPE) ................................................................................................................................ 172.4.14 Branch (BRAN) .......................................................................................................................... 172.4.15 Piping Components ................................................................................................................... 18

2.4.16 Other Discipline Elements ......................................................................................................... 182.5 Element Names in AVEVA E3D ..................................................................................................... 182.6 Units ................................................................................................................................................. 192.7 Axes System.................................................................................................................................... 19

3 User Interface Basics............................................................................................................................. 213.1 Accessing the Model Environment ............................................................................................... 21

3.1.1 Login Form................................................................................................................................. 223.2 Default Screen Layout.................................................................................................................... 253.3 Using the Mouse ............................................................................................................................. 253.4 Using the AVEVA E3D User Interface........................................................................................... 26

3.4.1 User Interface Buttons............................................................................................................... 273.5 Forms ............................................................................................................................................... 28

3.5.1 Form Menus............................................................................................................................... 283.5.2 Form Inputs................................................................................................................................ 283.5.3 Alert Forms ................................................................................................................................ 283.5.4 Dockable Forms......................................................................................................................... 28

3.6 Messages Window.......................................................................................................................... 313.7 Command Window.......................................................................................................................... 32

3.7.1 Entering Command Syntax........................................................................................................ 323.7.2 Command Window Pop-up Menu.............................................................................................. 32

3.8 Navigating the Databases .............................................................................................................. 333.8.1 Model Explorer........................................................................................................................... 333.8.2 Navigation History - Backward and Forward Buttons................................................................ 37

3.9 Deleting Elements from the Databases ........................................................................................ 383.10 Save Work - Saving Changes to the Databases....................................................................... 39

3.11 Get Work - Updating Databases to Show Changes by Other Users ...................................... 393.12 Undo and Redo............................................................................................................................ 403.13 Exiting AVEVA E3D..................................................................................................................... 40





3.14 Help............................................................................................................................................... 40

Exercise 1....................................................................................................................................................... 42

4 Displaying Modelled Elements ............................................................................................................. 474.1 Building the Drawlist ...................................................................................................................... 47

4.1.1 Displaying the Drawlist .............................................................................................................. 47

4.1.2 Populating the Drawlist.............................................................................................................. 484.1.3 Using the Drawlist...................................................................................................................... 494.1.4 Hiding and Showing Elements................................................................................................... 51

4.2 Setting the View Limits................................................................................................................... 524.2.1 Using the View Control Tiles ..................................................................................................... 534.2.2 Using the 3D View Pop-up Menu .............................................................................................. 544.2.3 Using the Element Pop-up Menu............................................................................................... 54

4.3 Setting the View Direction ............................................................................................................. 554.3.1 Look ........................................................................................................................................... 554.3.2 Plan............................................................................................................................................ 554.3.3 Isometric .................................................................................................................................... 56

Exercise 2....................................................................................................................................................... 57

5 Working with 3D Views.......................................................................................................................... 595.1 Modes of Operation in 3D Views ................................................................................................... 595.2 Graphical Selections ...................................................................................................................... 59

5.2.1 Creating a Graphical Selection.................................................................................................. 595.2.2 De-selecting Elements from a Graphical Selection ................................................................... 61

5.3 Navigate to Element Button........................................................................................................... 615.4 Creating and Copying 3D Views.................................................................................................... 61

5.4.1 Creating an Empty View ............................................................................................................ 615.4.2 Copying a 3D View .................................................................................................................... 62

5.5 Displaying Multiple Views.............................................................................................................. 625.6 The View Settings Form ................................................................................................................. 635.7 View Projection ............................................................................................................................... 655.8 Zoom, Pan and Rotate .................................................................................................................... 66

5.8.1 Setting the Middle Mouse Button Options ................................................................................. 665.8.2 Zoom.......................................................................................................................................... 665.8.3 Pan ............................................................................................................................................ 675.8.4 Rotate ........................................................................................................................................ 675.8.5 Controlling Speed of Operation ................................................................................................. 67

5.9 Setting the Centre of View ............................................................................................................. 685.10 Clipping and Capping ................................................................................................................. 69

5.10.1 Capping ..................................................................................................................................... 715.11 Copy Image.................................................................................................................................. 715.12 Showing Tooltips on 3D View Elements................................................................................... 725.13 Animations................................................................................................................................... 725.14 Graphics Settings........................................................................................................................ 72

5.14.1 Graphics Settings - Colour Tab ................................................................................................. 72

5.14.2 Graphics Settings – Representation Tab .................................................................................. 735.14.3 Graphics Settings – Steelwork Tab ........................................................................................... 765.14.4 Graphics Settings - Cabling Tab................................................................................................ 775.14.5 Graphics Settings – Plines and Ppoints Tab ............................................................................. 77

Exercise 3....................................................................................................................................................... 79

6 Attributes, Positioning and Orientation............................................................................................... 856.1 Element Attributes.......................................................................................................................... 85

6.1.1 Pseudo Attributes ...................................................................................................................... 866.1.2 User Defined Attributes ............................................................................................................. 866.1.3 Querying Attributes.................................................................................................................... 876.1.4 Modifying Attributes ................................................................................................................... 89

6.2 Positioning ...................................................................................................................................... 89

6.2.1 The Positioning Control Form.................................................................................................... 906.2.2 Positioning Explicitly .................................................................................................................. 916.2.3 Positioning Relatively ................................................................................................................ 92





6.3 Orientation....................................................................................................................................... 936.3.1 Setting Orientation using Axes .................................................................................................. 936.3.2 Setting Orientation using Rotate................................................................................................ 94

Exercise 4....................................................................................................................................................... 96

7 General Utilities....................................................................................................................................101

7.1 Collections..................................................................................................................................... 1017.1.1 The Collections Form .............................................................................................................. 1017.1.2 System Collections .................................................................................................................. 1027.1.3 Shared Collections .................................................................................................................. 1027.1.4 My Collections ......................................................................................................................... 1047.1.5 Working with Collections ......................................................................................................... 1047.1.6 The Collections Grid................................................................................................................ 105

7.2 Search ............................................................................................................................................1087.2.1 More Search Tools .................................................................................................................. 110

7.3 Session Units ................................................................................................................................ 1127.4 Measuring...................................................................................................................................... 113

7.4.1 Measure Distance.................................................................................................................... 1137.4.2 Measure Angle......................................................................................................................... 114

7.5 Saving and Restoring Views........................................................................................................ 1167.5.1 Saving Views ........................................................................................................................... 1167.5.2 Restoring Saved Views ........................................................................................................... 1177.5.3 Deleting Saved Views.............................................................................................................. 117

7.6 Claimlists in Multiwrite Databases.............................................................................................. 118

Exercise 5..................................................................................................................................................... 120

8 Introduction to Model Editor............................................................................................................... 1238.1 Model Editor Mode........................................................................................................................ 1238.2 The Model Editor Handle.............................................................................................................. 1248.3 Overview of Basic Model Editor Operations.............................................................................. 124

8.3.1 Movement ................................................................................................................................ 1248.3.2 Rotation ................................................................................................................................... 125

8.3.3 Alignment................................................................................................................................. 1258.3.4 Model Editor Handle as a Frame of Reference....................................................................... 1258.3.5 Feedback ................................................................................................................................. 1258.3.6 Unconstrained Positioning....................................................................................................... 1268.3.7 Undo and Redo........................................................................................................................ 1268.3.8 Performance ............................................................................................................................ 126

8.4 Model Editor Settings ................................................................................................................... 1268.5 Positioning and Orientation using the Model Editor Handle.................................................... 127

8.5.1 Aligning the Graphical Selection with Features on other displayed items............................... 1278.5.2 Automatic Scrolling.................................................................................................................. 1278.5.3 Linear Handles......................................................................................................................... 1288.5.4 Planar Handles ........................................................................................................................ 1298.5.5 Rotation Handles ..................................................................................................................... 130

8.5.6 Dragging the Model Editor Handle Independently of the Graphical Selection ........................ 132

Exercise 6..................................................................................................................................................... 133

APPENDIX A – AVEVA Primitives.............................................................................................................. 139Box (BOX) ................................................................................................................................................. 139Cylinder (CYLI)......................................................................................................................................... 139Cone (CONE) ............................................................................................................................................140Snout (SNOU) ........................................................................................................................................... 140Pyramid (PYRA) ....................................................................................................................................... 141Circular Torus (CTOR)............................................................................................................................. 141Rectangular Torus (RTOR) ..................................................................................................................... 142Dish (DISH) ............................................................................................................................................... 142Sloped Cylinder (SLCY) .......................................................................................................................... 143

Extrusion (EXTR) ..................................................................................................................................... 143Solid of Revolution (REVO) .................................................................................................................... 144Nozzle (NOZZ) .......................................................................................................................................... 145




CHAPTER 1

1 Introduction

AVEVA Everything3D™ (AVEVA E3D™) is a complex program with different applications that enablediscipline designers to create a 3D model of a plant. These applications use common features within the

Model module that designers need to be familiar with before embarking on discipline specific applicationtraining.

1.1 Aim

The aim of this training module is to provide the basic knowledge of the common features that provide the‘foundations’ for the AVEVA Everything3D Model module.

1.2 Objectives

Explain the structure of AVEVA E3D.

Familiarise trainees with the basics of the User Interface.

Explain how to manipulate the 3D model.

Explain Element Attributes, Positioning and Orientation of Elements.

Introduce the Model Editor for graphical model manipulation.

1.3 Prerequisites

Keyboard Skills.

Familiarity with Microsoft Windows.

Knowledge of Plant Design.

1.4 Course Structure

Training will consist of oral and visual presentations, demonstrations and set exercises. Each workstationwill have a training project, populated with model objects. This will be used by the trainees to practice their methods, and complete the set exercises.

1.5 Using this guide

Certain text styles are used to indicate special situations throughout this document, here is a summary;

Menu pull downs and button press actions are indicated by bold dark turquoise text.

Information the user has to key-in will be in bold red text.

Where additional information is presented, or reference is made to other documentation the followingannotation will be used:

Additional information

Refer to other documentation

System prompts will be bold, italicised, and presented in inverted commas i.e. 'Choose function' .

Example files or inputs will be in the courier new font.




CHAPTER 2

2 AVEVA Everything3D™ Fundamentals

AVEVA Everything3D is a multi-discipline 3D modelling system that allows users to simulate a detailed, fullsize model of all the significant parts of a process plant.

2.1 How AVEVA E3D is Structured

AVEVA E3D is divided into modules to perform the various functions to produce a 3D Plant design model.

The modules and their functions are:

Model 3D modelling.

Draw 2D drawing Production.

Isodraft Isometric drawing production.

Monitor Changing User, MDB, and accessing inter DB Macros.

Spool Pipe spooling.

AVEVA E3D works in conjunction with two other products in the AVEVA Plant suite, AVEVA Administrationand AVEVA Catalogue. These products are also divided into modules to perform different functions, i.e.

AVEVA Administration

Admin Project and User administration.

Lexicon Creation of User Defined Attributes, User Defined Element Types, Status Definitions andDatabase Views.

AVEVA Catalogue

Paragon Catalogue and Specification construction.

Propcon Element and component properties.

Whilst AVEVA E3D must have read access to AVEVA Administration and AVEVA Catalogue databases, thistraining guide focuses on the foundations of AVEVA E3D only. The following sections give further details of the AVEVA E3D modules.

2.2 Model

Model is the graphically driven data input module for the 3D model in AVEVA E3D. In this module the plantmodel is built and the data stored in one or more databases. The databases contain a three-dimensionaldescription of all items in the plant. Component selection is provided through specifications that dictatewhich catalogue components can be used.

The main features are:

Creation of new model elements.

Modification of existing model elements.

Graphical manipulation of modelled elements.

Creation of reports, e.g. MTO, weight, Centre of Gravity, model status, etc.

Clash detection to find interferences between model elements.





The module has a number of disciplines to assist designers in building models efficiently. These disciplinesare:

General

Equipment

Piping

HVAC

Cabling System

Cable Trays

Structures

Supports

Design Templates.

2.2.1 Draw

Draw is used to create annotated and dimensioned arrangement and detail drawings from the 3D model andalso has extensive 2D drawing capabilities.

Annotation can be in the form of labels attached to model elements or 2D annotation such as drawing notes,drawing frames, tables, etc. Annotation attached to a model element on the drawing will move if the 3Dposition of the element changes.

Dimensions are projected distances between points in the 3D model and may be attached to modelelements. Dimensions attached to model elements are calculated automatically and are re-calculated when

the drawing is updated, thus reflecting the current model data.

The 3D model can be interrogated through the Draw module, however, the model cannot be changed fromthe it.

Example Draw Output





2.2.2 Isodraft

Isodraft produces dimensioned symbolic piping and HVAC isometrics for construction and erection purposesin various formats.

Isodraft functionality includes:

Full material lists.

Automatic spool identification.

Automatic splitting of complex drawings.

User-defined drawing sheets.

Example Isodraft Output

2.2.3 Monitor

Monitor allows basic querying of database information which normally can only be obtained using the Adminmodule.

Monitor can also be used to quickly change a password of the currently logged in user or completely switchto another user.

Depending on the user type, Monitor can be used to change access rights and defer databases.Batch processing and simple messaging can also be achieved.

If there is a problem with a project that inhibits another module from loading, then the software willautomatically load the Monitor, allowing simple diagnostics to be conducted via its command line interface.

2.2.4 Spool

Spool is used for pipework spooling. It enables the designer to split the pipework design into logical sections(spools) ready for fabrication. The spool data can be output as isometric drawings using Isodraft.





2.3 AVEVA E3D Databases

The heart of AVEVA E3D consists of a set of hierarchical databases that store the model data andreference data. The database system is called Dabacon and is exclusive to AVEVA. There are severaldifferent database types, structured specifically for plant design data storage and each type of databasestores different data.

Generally, multi-discipline projects are executed using discipline specific designers who will use theapplications in AVEVA E3D to construct the model components for their specific discipline. A project,therefore, may consist of a number of Design databases for each discipline.

When constructing the model, references are made to catalogue; property and User Defined data that isheld in different types of databases. As this data is common to all users of each discipline, each user willrefer to a common set of data for the project. These databases are called Reference databases.

In order that each user can see the required design components modelled by other users and refer to thecommon catalogue, property and user defined attribute data, the Design and Reference databases aregrouped together into a Multiple Database (MDB).

There may be several MDBs for a project, each defining specific groups of databases, for users withdifferent tasks to perform.

Databases can be of two types, i.e. Update or Multiwrite and an MDB may contain each type.

Update databases allow only one user at a time to work in the database, creating or modifying data heldwithin it. This set-up is easy to administer but on a large project will require a large number of databases. Inaddition, as only one user at a time can modify the data this may cause a bottleneck on busy projectschedules.

Simplified scenario using Update databases





Multiwrite databases allow any number of users to work in the database simultaneously, creating andmodifying data within it. In order to control the modification of the data, a ‘claim list’ concept is used to avoida ‘last saved’ scenario for element modification to occur. Claim lists are discussed in more detail later in theTraining Guide.

Simplified scenario using Multiwrite databases

2.4 How data is stored in AVEVA E3D

Each hierarchical database is a ‘tree’ like structure similar to the hierarchy of directories and sub-directoriesused to contain the files on a computer. The topmost data level in all databases is called the WORLD, below

which all other data exists.

The AVEVA E3D Design Database Hierarchy





Each identifiable item of data is known as an AVEVA E3D element. Each element has a number of

associated pieces of information that, together, completely define its properties. These are known asattributes.

In this hierarchical structure all elements are owned by other elements, with the exception of the WORLD.Elements that are owned by another element, e.g. a ZONE is owned by a SITE, are said to be members of

the owning element, i.e. the ZONE is a member of the SITE.

The vertical link between two elements on adjacent levels of the database hierarchy is defined as an owner-member relationship. The element on the upper level is the owner of those elements directly below it. Thelower level elements are members of their owning element, e.g. a SITE is the owner of a ZONE and theZONE is a member of a SITE.

Each element can have many members, but it can only have one owner. All elements are owned by another element with the exception of the WORLD.

Each element may only exist in its correct position in the hierarchy, e.g. a ZONE may not be directly ownedby the WORLD, it must be owned by a site.

Every element is identified within the database structure by an automatically allocated reference number and, optionally, by a user-specified name.

The following sections give descriptions of the main element types in a AVEVA E3D Design database. Mostof the element types are abbreviated, usually to the first four letters of the full name, when they aredisplayed in the user interface. The abbreviations are shown in parenthesis.

2.4.1 World (WORL)

When the database is first built, it is usually empty except for a single element named the WORLD. Eachdatabase has its own WORLD element as the first element in the hierarchy. The World cannot be deleted or re-named.

2.4.2 Site (SITE)

Below the WORLD, the second level of the hierarchy is SITE. A SITE may be considered as a significantcollection of plant, whose size is not necessarily determined by physical area, but by practicalconsiderations. It may, for example be the whole project, or one part of a large project. There can be asmany SITEs within an AVEVA E3D project as required for data organisation.

2.4.3 Zone (ZONE)

The next level below a SITE is a ZONE. As with a SITE, a ZONE is not necessarily used to define a physicalarea, it is more likely to store similar types of items for easy reference, such as a piping system in one

ZONE, related equipment in another, and so on. There can be as many ZONEs owned by a SITE asrequired for data organisation.

SITEs and ZONE elements are common to all disciplines. Below ZONE level the hierarchy is disciplinedependent, i.e. the elements depend on which discipline the user is modelling.

2.4.4 Equipment (EQUI)

Equipment items are built up in AVEVA E3D using elements known as primitives. Each piece of equipmentcan comprise any number of primitive shapes positioned in space to represent the equipment item. Theprimitives may be owned directly by the EQUI element or by a Sub-Equipment element.

2.4.5 Sub-Equipment (SUBE)

A SUBE is an optional element to sub-divide an EQUI. The SUBE can own primitive elements.





2.4.6 Primitives

Primitives are the basic building blocks of AVEVA E3D. They are used by other disciplines to createcatalogue components. There are many types of primitives; each with its own features which whencombined with other primitives can represent complex shapes.

Examples of primitives are nozzle (NOZZ), box (BOX), cylinder (CYLI), pyramid (PYRA), cone (CONE) anddish (DISH).

2.4.7 Volume Model (VOLM)

A VOLM is a ‘simplified’ version of an EQUI element. This allows volumes to be modelled without thembeing called Equipment items. A VOLM may directly own any primitive except a NOZZ.

2.4.8 Sub-Volume Model (SVOLM)

A SVOLM is an optional element, similar to a SUBE, to sub-divide a VOLM. A SVOLM may own anyprimitive except a NOZZ.

2.4.9 Structure (STRU)

STRU elements are administrative elements, i.e. they exist to own FRAMEWORK elements, and allow theplant structures to be sub-divided for ease of modelling and reporting.

2.4.10 Framework (FRMW)

FRMW elements are used to store structural components in the model. A complex structure can be dividedinto logical frameworks. Dividing the structure in this way allows structural modelling, and also reporting, tobe done more efficiently, e.g. by copying a complete FRMW.

2.4.11 Sub-Framework (SBFR)

A SBFR is an optional element that can own structural components. They are used to further sub-dividecomplex projects or for modelling sub-assemblies within a framework.

2.4.12 Structural Components

Linear structural profiles are represented in AVEVA E3D by Section (SCTN) elements, for straight profiles,and Generic Section (GENSEC) elements for curved profiles. Profile sizes are selected using a sectionspecification that references standard catalogue data for section sizes complying with various nationalstandards or company standards. Flat planar items, such as plates and grating, are represented by Panel(PANE) elements.

2.4.13 Pipe (PIPE)

Pipes may be considered to be like lines on a flow sheet. They may run between several end connectionpoints and are usually grouped by a common specification and process.

2.4.14 Branch (BRAN)

Branch elements are sections of a pipe, which have known start and finish points. In AVEVA E3D the startand finish points are called the Head and Tail. Heads and tails may be connected to Nozzles, Tees or other

Heads and Tails, depending on the configuration of the pipe, or left open ended.





2.4.15 Piping Components

A Branch may own a wide variety of components such as Gaskets (GASK), Flanges (FLAN), Elbow(ELBO), Tees (TEE), Valves (VALV), etc., which are all elements. These form the shape and geometry of

the Branch and ultimately the Pipe itself.

Piping components are selected using Piping Specifications that reference standard catalogue data. For example, each time a user wants to use a 100mm bore elbow, AVEVA E3D always accesses the data for itfrom the component catalogue. The data for these elements remains constant no matter how many 100mmbore elbows are used in the design.

2.4.16 Other Discipline Elements

The elements described above are for Equipment, Piping and Structural disciplines. Other disciplines havesimilar hierarchy elements which are described in detail in the relevant discipline training guide.

2.5 Element Names in AVEVA E3D

Any element in an AVEVA E3D database may be given an explicit name. Names enable the user to identifyelements and to produce meaningful reports from the database. Which elements are named is a matter of choice, however, in general ‘significant elements’, e.g. SITE, ZONE, EQUI, SUBE, PIPE, BRAN, STRU,FRMW, SBFR, etc. would be named. It is not usual for primitives to be named. The WORLD is named /* andcannot be renamed.

Element names in AVEVA E3D must comply with the following rules:

Element names begin with a forward slash, e.g. /MY_MODEL. Generally, most design items give theuser the opportunity to name them from the element creation form. The user does not have to enter theforward slash on such forms as it is added automatically when the Return (Enter ) key is pressed.

Element names must be unique across all databases in the MDB.

Element names are case sensitive, e.g. /P1001A, /P1001a, /p1001A and /p1001a are all valid, differentnames.

Element names must not contain spaces. Any character such as forward slash (/), Underscore (_),hyphen (-), asterisk (*), etc. may be used as separators.

Element names must be no longer than 50 characters.

If an element is not explicitly named it receives a system name, e.g. CYLI 2 of EQUI 1 of ZONE 2 of SITE /MY-MODEL.

Internally AVEVA E3D does not use names to identify elements but a unique database reference number so

that an element may be re-named at any time.

These reference numbers are never re-used if an element is deleted and are, therefore, remain uniquethroughout the life of the project. On some forms the reference number is used in place of the system nameand will look something like =23584/2152.





2.6 Units

Internally AVEVA E3D stores values in standard SI units, i.e. millimetres, kilogrammes, degrees centigrade,Pascal, etc.

However, the current session units may be set, where applicable, to various metric or imperial units for data

input and output. This does not change the database storage units. The database storage values areconverted to suit the current session units for input and output. The input and output display units may bechanged at any time during the session.

See section 7.3 for details of Session Units.

2.7 Axes System

AVEVA E3D uses the right hand rule to express the co-ordinatesystem and rotation:

In Model, the WORLD has a world co-ordinate system whoseorigin is at X 0, Y 0 and Z 0.

AVEVA E3D assigns cardinal directions to the X, Y and Z axes,i.e.

X is East

Y is North

Z is Up

Many elements in AVEVA E3D have position and rotation attributes. Such elements have their own axes

system, conforming to the right hand rule, and the position and orientation are expressed with respect totheir owner.

Refer to Chapter 6, Attributes, Positioning and Orientation, for information on the Position and Orientation attributes.




CHAPTER 3

3 User Interface Basics

This chapter describes the basics of the user interface including accessing the Model environment, the useof the mouse, menus, forms and toolbars and the Model Explorer.

3.1 Accessing the Model Environment

AVEVA E3D may be started by using the Start menu icon or the Desktop icon, providing both options wereselected when the product was installed.

Selecting Start > All Programs > AVEVA Plant from the task bar displays three further options: Design, Engineer and Manage

Selecting the Design option displays the Everything3D 1.1.0 shortcut.

Clicking the shortcut initialises AVEVA E3D.

or

On the desktop, clicking the shortcut initialises AVEVA E3D.

After clicking either of the shortcuts AVEVA E3D displays an initialisation image:

When initialisation is complete, AVEVA E3D displays the Login form.





3.1.1 Login Form

The blue tiles at the top of the form displaythe projects that are available to the user.These tiles scroll horizontally if there aremore projects available than fit on the

form.

The green tile on the left side of the formbelow the project tiles enables a user toenter search text and click the searchbutton on the right of the textbox to limitthe projects displayed.

The Show Masked Projects checkboxdisplays tiles that have been designated asmasked, usually reference projects.

Having selected a project by clicking theappropriate tile, project details aredisplayed to the right of the selectedproject.

The project search tile is replaced by aproject credentials tile, where User ,

Password and MDB are entered to gainaccess to the project.

Clicking the down arrow button on the rightside of the User textbox displays anoptions list of valid users for the project.

Having selected the required User, the correct Password mustbe entered.

The password is hidden with each character being representedby a dot.





If an incorrect password is entered an error message is displayed.

Clicking the Change Password button on the right of the

Password textbox changes the credentials display to enable theuser to change the currently selected users password.

Entering and confirming a new password and clicking the Changebutton changes the selected users password.

Clicking the Cancel button reverts back to the credentials displayand does not change the password.

Having entered a valid password an MDB must be selectedbefore entering AVEVA E3D.

Clicking the down arrow button on the right side of the MDBtextbox displays an options list of MDBs for the project.

Selecting an MDB completes the required credentials for projectentry.

AVEVA E3D databases can be marked with a ‘stamp’, generally at significant milestones in a project, which

records various information including the date.

The Login form enables a user to open the project to view the data at a previously defined stamp.

No changes may be made to the project in these circumstances.

Clicking the down arrow button on the right side of the Stamp textbox displays an option list of stamps which

can be used to open the project.

If no stamps are recorded, None will be displayed in the Stamp textbox. If stamps are available and one isselected, the name of the selected stamp is displayed.

If no stamp is selected, the project is opened using the last database session.

The creation and use of database stamps is outside the scope of this training guide.





Clicking the Show Project Options button on the right side of the Stamp options list displays a projectoptions tile on the right of the credentials tile.

The three options available are:

Open Read Only – this option opens the project in read only mode so that no changes can be made.

Restore 3D Views – this option restores 3D Views from the previous session of AVEVA E3D.

Restore Default Layout – this option restores the default screen layout.

The Show Project Options button is reversed and is now the Hide Project Options. Clicking the buttonhides the project options tile.

Having made all entries and selections, the user may now select the appropriate module tile.

The modules available are Model, Draw, Isodraft, Monitor and Spool. Spool may be accessed by clickingthe grey scrolling button on the right side which is displayed when the mouse is hovered over the tiles.

Clicking the required module tile initiates entry into the selected module. The Login form is closed and

replaced with a project entry image.

The silhouette plant image is animatedduring project entry and feedback is given onprogress, i.e. which parts of the product arebeing loaded.

Upon completion the module screen layoutis displayed. If it is the first entry it will be thedefault screen layout.





3.2 Default Screen Layout

The AVEVA E3D user interface is based on the Microsoft® Office Fluent™ user interface The defaultscreen layout for AVEVA E3D Model module is:

This default layout may be modified to suit individual preferences, e.g. additional forms may displayed in thelayout, forms may be moved and ‘docked’ and pinned/unpinned as required. Some of these features aredescribed later in this chapter.

After exiting AVEVA E3D or changing to a different module, a subsequent return to the Model module willrestore the screen layout as it was left in the previous session.

3.3 Using the Mouse

The mouse guides the graphics pointer around the screen and is also used to select or ‘pick’ items by usingthe mouse buttons. The buttons perform different tasks depending on the type of window, and the position of

the mouse pointer in the window. The appearance of the pointer will change according to the type of displayitem that is underneath it.

A three button mouse, preferably with a scroll wheel middle button, is required for AVEVA E3D.

There are two techniques used when operating the mouse buttons, Clicking and Dragging.

Clicking - the pointer is positioned over a specific point on the screen. Clicking and releasing a mousebutton ‘picks’ whatever is displayed at that point on the screen. This technique is generally used for selectingitems in a 3D View, operating gadgets on forms and for selecting lines in option lists.

Dragging - the pointer is positioned over a specific point on the screen, the mouse button is clicked andheld down whilst dragging the pointer to another position on the screen. To complete the operation the

button is released at the second position. This technique is mainly used for manipulating the model in 3dViews, moving forms around the screen and for operating sub-menus.





The functions of each of the three mouse buttons are described below:

Left Mouse Button - The left mouse button is the main button for selecting items. In a 3D View,clicking the left mouse button with the pointer over a model element selects the element. On a form, theeffect depends on the type of selections that are being made, e.g. buttons, radio buttons, check boxes,option lists, fold-up panels, etc.

Middle Mouse Button - The principal use of the middle mouse button in Model is to manipulate themodel in the 3D graphical view.

Right Mouse Button - Clicking the right mouse button displays context pop-up menus, whereavailable.

See Chapter 4, Displaying Modelled Elements, for details of using the mouse to manipulate the model in 3D Views.

3.4 Using the AVEVA E3D User Interface

The AVEVA E3D user interface is based on the Microsoft® Office Fluent™ user interface and consists of discipline interfaces that each contain a number of tabs. The disciplines available are as listed in section 2.2of this training guide.

The HOME tab of the GENERAL UI

The following tabs are present in all discipline interfaces:

PROJECT

HOME

3D VIEW

TOOLS

MANAGE

ADMIN

LASER.

Each tab is divided into named groups that contain buttons and other gadgets which activate the requiredfunctionality. The groups logically bring together similar functions or functions for similar tasks.

Discipline interfaces are accessed by the Discipline options list on theQuick Access Toolbar .

Selecting a discipline from the options list displays the selected disciplinesinterface.





EQUIPMENT discipline interface showing the EQUIPMENT tab

All discipline tabs have a Common group on the left hand side which is a duplicate of the same group onthe HOME tab. This group contains major functions which are common to all disciplines.

Each discipline interface has groups that contain specific functionality for that discipline as well as someother functions which may be duplicated on other discipline tabs.

The PIPING interface has two discipline tabs, PIPING and EQUIPMENT, as these two disciplines are oftenused together.

PIPING discipline interface showing the PIPING tab

The STRUCTURES interface has four discipline tabs, SECTIONS, PLATES, WALLS AND FLOORS andSTAIRS LADDERS HANDRAILS.

STRUCTURES discipline interface showing the SECTIONS tab

This training guide covers some of the basic functionality, however, the majority of functionality isdescribed in the relevant discipline training guide.

3.4.1 User Interface Buttons

The user interface has buttons in two sizes, large and small. The sizing is based on the frequency of useand the number of the buttons within the group.

Large buttons have captions below them whilst small buttons generally have captionsto their right hand side, however, some small buttons do not have captions.

All buttons have tooltips which are displayed when the cursor is hovered over the button.

Some buttons have additional functions below them in an options list. These buttons have a small downarrow associated with them. For large buttons this is located under the button whilst for small buttons it is onthe right hand side. Clicking the button displays the options list.





3.5 Forms

Much of the AVEVA E3D user interface is driven by forms which are invoked from the buttons on thediscipline interface or from other forms. Forms are used to display information or to enter or modify data.

Forms come in a variety of sizes and contain different input and modification devices, e.g. textboxes,

checkboxes, options lists, buttons, link labels, etc., which are commonly referred to as gadgets.

3.5.1 Form Menus

Some forms contain a menu across the top of the form.

3.5.2 Form Inputs

Most forms include at least one control button which is used to either:

Enter the command option represented by the current form setting.

Cancel any changes made to the form.

Close the form.

The Apply buttons enter the current form settings as command inputs.

The Cancel button cancels any changes made to the settings of the form or simply close the form.

Some forms contain more specific types of control buttons, which carry out particular command options, e.g.Add and Remove.

Buttons may contain text or an icon.

3.5.3 Alert Forms

Alert forms are used to display information such as errors, warnings, messages or confirmation requests.

Error, warning and information messages display a suitable statement and have a single OK button whilst aconfirmation message displays a confirmation question and have Yes and No buttons.

3.5.4 Dockable Forms

Some forms are dockable, i.e. they can be fixed in a particular place on the display. When dockable formsare initially displayed they will dock at their default position.

This position may be changed by dragging the form’s banner with the left mouse button. As the form ismoved, docking icons are displayed to aid the docking process.





When the form is dragged over one of the docking aids, the docking tool previews the docking position usinga shaded area of the display.

Once the required docking position has been achieved, releasing the left mouse button will dock the form inthe selected position.





If a dockable form is dragged over a previously docked form, additional docking aids for docking the newform over the previous form are displayed. The additional docking aids work in the same way as previouslydescribed.





If the central Tab button of the docking aids is used, the formbeing docked will form a tabbed form with the form(s) it is being

dragged over.

To separate the forms, the tabbed group must be undocked firstand then separated by dragging the tab away from the group.

Once a dockable form has been docked, it may also be pinned and unpinned, i.e. hidden or displayed:

Clicking the Pin button on theform header ‘hides’ the formunder the tab in the adjacentedge of the display.

Passing the cursor over thetab displays the form whichmay be used in the normalway.

Clicking the Pin buttonremoves the tab and displaysthe form.

If the screen layout has been modified, clicking the Default Windows Layout button in the Windows group

of the HOME tab will restore the screen to the previous layout in that session.

3.6 Messages Window

The Messages window is a dockable from which displays User and System messages.





The top left hand corner of the form has two tabs to toggle between User messages and System messages.

The User messages contain error, warning and information messages such as the Alert forms describedearlier, see section 3.5.3. The last message is always displayed at the top of the form and is also displayedin the status panel at the bottom of the window.

Right clicking in the User messages tab displays a pop-up menu whose optionsenable the message grid to be sorted, grouped, searched, printed, exported, copiedand cleared.

The System messages contain messages produced by the system such as load errors or module switcherrors.

Right clicking in the System messages tab displays a pop-up menu with Copy and Clear options.

On the right of the status panel there is a Messages button which toggles the display of the Messageswindow.

3.7 Command Window

The Command Window is a dockable form and is displayed by clicking the Command Window button in theWindows group of the HOME tab. The Command Window enables the user to directly interact with the

database(s) by entering valid command syntax to manipulate, create, modify and query any databaseelement.

3.7.1 Entering Command Syntax

After clicking in the Command Window with the left mouse button, valid command line syntax may beentered on to the active line. Command line syntax is executed by pressing the Return (Enter ) key.

Previously entered commands may be recalled to the active line by double-clicking the left mouse button on

the required line in the Command Window or by using the up and down arrow cursor keys to step throughprevious syntax entries until the appropriate line is found. The active line may be edited before executing thecommand(s). Command line syntax is not case sensitive, except for element names.

3.7.2 Command Window Pop-up Menu

Clicking the right mouse button in the Command Windowdisplays a pop-up menu with the following options:





Copy – this option allows a single highlighted line or multiple highlighted lines to be copied from theCommand Window to the clipboard.

Paste – this option enables single or multiple lines of text, which has been copied to the clipboard fromany source, to be submitted for processing in the Command Window. This option will execute each lineof the text as a separate command, as if they had been entered into the Command Window. The last

line will not be executed but becomes the active line and must be executed manually by pressing theReturn key.

Paste as Macro – this option first creates a temporary file containing the copied macro commands andexecutes this as a macro. This option enables macro syntax, such as error handling to be used. For alarge number of commands this option gives better performance, e.g. graphics will only be updated atthe end of the macro rather than after each command.

Font Size – this option has a sub-menu that allows the font size in the Command Window to be set toSmall, Medium or Large:

Clear – this option clears the Command Window of all text.

Care should be taken when using the Command Window as all commands entered act directly on the

database elements. Some operations available from the forms and menus cannot be replicated in theCommand Window.

3.8 Navigating the Databases

Being able to navigate around the databases and the database hierarchy is an essential part of successfullyworking with AVEVA E3D. The user interface provides Explorers to facilitate navigation.

3.8.1 Model Explorer

Model Explorer is part of the default screen layout. If it is closed it can be displayed by clicking the Model

button in the Navigate group of the HOME tab.

Model Explorer is a dockable form that provides a ‘tree view’ of thedatabase elements in the current MDB.

Each element’s type is shown, i.e. SITE, ZONE, PIPE, etc.,together with its name. Where elements have been explicitlynamed the name is displayed without the leading forward slash.Elements that have not been explicitly named, e.g. primitives, aredisplayed with their system generated name.

The tree can be expanded and collapsed by clicking the arrowicons adjacent to the database elements. The icons are only

displayed where the elements own other elements.

The tree may also be expanded and collapsed by doubleclicking on an element in the tree.

One element in the Model Explorer will always be highlighted. Thisis referred to as the Current Element, often abbreviated to CE informs, interfaces and documentation.

There can only be one Current Element at any one time and mostcommands act on the CE.

Functionality for commands to act on more than one element at a time is explained later in this training

guide.





Elements that have been created or modified in a Multiwritedatabase with an explicit claim, or elements that are explicitlyclaimed, are displayed in bold text in Model Explorer until they are

unclaimed.

Elements in Update databases are not displayed in bold text.

See Section 7.6 – Claimlists in Multiwrite Databases for further information on claim lists.

Search text, e.g. a partial name, may be entered into the textbox atthe top of the form and Model Explorer will find all named elementsin the current MDB that contains the text and displays it in anoptions list.

The user may then select a name from the options list and ModelExplorer will navigate to the element, making it the CE.

Search text is case sensitive.

3.8.1.1 Model Explorer Filtering

As the databases in the current MDB may contain many thousandsof elements, the Model Explorer has a filter that, when activated,restricts the display of elements for other disciplines.

For example, the current user may be a Piping Designer routing andmodelling pipes.

By right clicking in an empty area of Model Explorer to display theFilter menu and selecting the Piping option from the sub-menu,checkbox, the Piping elements are left unaffected, i.e. they stilldisplay all owned elements when expanded; however, other

discipline elements are restricted.





The Equipment elements only display the Nozzle (NOZZ) primitives that they own (if any), as the pipe mayneed to connect to these elements. All other primitives owned by the equipment are not displayed.

For Structural elements, no elements below the Framework (FRMW) level are displayed.

The other filter options, i.e. Equipment, Supports and Structural, function in a similar way, restricting thedisplayed elements of other disciplines. The filters cannot be extended or edited.

The current filter, if applied, is displayed in the Model Explorer title bar.

3.8.1.2 Model Explorer Pop-up Menu

Right clicking any element in the Model Explorer displays a pop-upmenu with the following options:

3D View - this option has a sub-menu and enables elements to bedisplayed or removed from the 3D View.

This functionality is explained in Chapter 4, Displaying Modelled Elements.

Attributes… – this option displays the Attribute form for theCurrent Element.

See Chapter 6 for details of querying and modifying attributes.

Rename – this option displays the rename form:

The element name may be modified by entering anew name in the Name textbox and clicking the

Apply button.

Navigating to another element to make it the currentelement and clicking the CE button enables the user to rename other elements without closing the form.

The options list functions are:

Only – renames only the CE.

Re-name all – renames the CE members, if any, that have derivativenames of the CE.

Un-name – un-names the CE so that its Name attribute is unset.

Delete – this option deletes the Current Element.

A confirmation message is displayed before deletion.

Clicking the Yes button deletes the CE from the database.

Clicking the No button aborts the deletion.

Add To Collections – this option adds the Current Element to the Current Collection.

Add Members to Collections – this options adds the CE members to a new collection named

Elements.

Refer to Chapter 7 General Utilities, for details of Collections.





New Explorer – this option displays a context sub-menu whose options are the element itself, theelement owner and any reference attributes the element has. Selecting one of the sub-menu optionscreates a new Explorer for the selected option.

Navigate To – this option enables navigation top linked schematic elements.

Copy – this option copies the Current Element to the clipboard.

Paste – this option copies a valid element from the clipboard to the current location in the ModelExplorer, providing it is within the same database, i.e. elements cannot be copied across databasesusing this functionality.

If the element is named, the pasted element is named Copy-of-nnnn, where nnnn is the name of theCurrent Element. Where more than one copy of a named element is pasted the second and subsequentelements will contain a sequential copy number, e.g. Copy-(2)-of-nnnn, Copy-(3)-of-nnnn, etc. If the

element is unnamed, the pasted element is allocated a system name.

It is possible to copy and paste an element in Model Explorer using drag & drop functionality.Holding down the Ctrl key and the left mouse button on the CE and moving the pointer, a line isdisplayed showing the potential location of the copy. Releasing the left mouse button creates acopy of the CE. The same naming conventions apply as described above.





3.8.1.3 Explorer Settings

Selecting Options > System > Explorer Settings from the PROJECT tab displays the Explorer Settingsform.

The form contains check boxes that toggle the following

settings:

Auto Collapse Tree – If selected, whenever theuser changes CE, any expanded node notcontaining the selected CE is automaticallycollapsed. This applies to all active explorers. Thisoption is disabled if Expand to CE is not selected.

Expand to CE – If selected, this optionautomatically expands the tree when the CEchanges ( if not already expanded).

Hide non-user System Data – If selected, thisoption hides all System Data elements in the MDB,e.g. Application Data World (APPLDW) andTemplate World (TPWL), to which the user doesnot have write access.

Show TUBI/ROD – If selected, this option displaysall TUBI and ROD elements in the Model Explorer.

TUBI and ROD elements are Piping and Cable Tray components respectively. These elements arediscussed in the appropriate discipline training guide.

The Draw Explorer section of the Explorer Settings form is outside the scope of this training guide.

3.8.2 Navigation History - Backward and Forward Buttons

The Navigate group on the HOME tab has two buttons that enable the user tonavigate quickly, either backwards or forwards through an historical list of recent elements that have been the current elements.

The list is persistent from session to session.

Hovering the pointer over the Back button displays a tooltip that contains thetext Back to <last element>, where <last element> is the element that was theCE before the current element.

Clicking the Back button navigates to the previous CE element.

Similarly, hovering the pointer over the Forward button displays a tooltip thatcontains the text Forward <next element> where <next element> is theelement that was the CE after the current element, if the current element hasbeen the CE previously.

Clicking the Forward button navigates to the next CE element.

Repeatedly clicking the Back or Forward button will step backwards or forwards through the list until the list

is exhausted.

Clicking the down arrow button adjacent to the Back or Forward button

displays the historical list of current elements.

If an element is selected from the list it is navigated to and becomes the CE.





3.9 Deleting Elements from the Databases

There are two main methods of deleting elements from the databases. It is important to note that deleting adatabase element will also delete all of the elements in the hierarchy owned by the element.

For example, if a SITE is deleted, all of the ZONEs owned by it will be deleted and any elements, such as

EQUI, STRU, PIPE, etc. owned by the ZONE will also be deleted.

In the Common group of the HOME tab, clicking the down arrow below the Deletebutton displays an options list of delete functions.

CE – this option deletes the current element and displays a confirmationmessage.

CE Members- this option displays the Delete Selection form whichdisplays all of the CE members.

Clicking the Delete All Members button displays a confirmationmessage:

Clicking the Yes button deletes all of the members of the CE butdoes not delete the CE.

Multiple selections can be made from the list using standardWindows Ctrl and Shift keys functionality and picking with the leftmouse button. The multiple selections are highlighted.

When the selection is complete, clicking the OK button displays a

confirmation message:

Clicking the Yes button deletes all of the selected members of theCE but does not delete the CE





Selection – this option deletes the current graphical selection and does not display a confirmation message.

See section 5.2 for information on graphical selections

Database elements may also be deleted using Model Explorer, see section 3.8.1.2.

3.10 Save Work - Saving Changes to the Databases

When changes are made to the design model during an AVEVA E3D session, the effects of the changes areapplied only to a copy of the design data until the databases are updated. There is no auto-save in AVEVAE3D and, therefore, the databases must be updated explicitly by the user. It is advisable to save workregularly to ensure that other users can access the most recent model changes in a multi-user environment.

Updating the databases to incorporate the current design changes may be achieved by:

Clicking the Save Work button on the Quick Access Toolbar .

Clicking the Save Work button on the PROJECT tab.

Using the standard W indows Ctrl +S keys functionality.

In all cases a confirmation message is displayed. Clicking the Yes buttonsaves the database changes.

3.11 Get Work - Updating Databases to Show Changes by Other Users

Model changes made by the user are shown immediately in the working copies of the databases. Designchanges made by other users during your current AVEVA E3D session will not be shown in your workingcopies unless they are updated explicitly.

Updating these databases may be achieved by:

Clicking the Get Work button on the Quick Access Toolbar .

Clicking the Get Work button on the PROJECT tab.

Pressing the Ctrl and G keys simultaneously.

All databases to which the user has read access will be updated by the Get Work operation, whereasthe Save Work operation affects only those databases to which the user has write access.





3.12 Undo and Redo

Undo and Redo buttons are available from the Quick Access Toolbar .

The standard Windows Ctrl + Z and Ctrl + Y keys functionality for undo and redo

may also be used.

It is important to understand that these buttons will only undo or redo database changes, unless in ModelEditor Mode, i.e. if a position or orientation of an element is modified or an element is added or deleted,these are database changes, whereas, changing the display colour of an element is not a database change.

There is no limit to the undo or redo within a Model session, however, any Save Work or Get Workcommands issued will clear the undo and redo stacks, i.e. it is not possible to undo beyond the last SaveWork.

Refer to Chapter 8, Introduction to Model Editor, for information on the use of Undo and Redo in Model Editor Mode.

3.13 Exiting AVEVA E3D

To exit an AVEVA E3D session click the Exit button from the PROJECT tab.

If changes have been made to the databases a Question alertmessage is displayed asking whether the changes are to be savedor not.

Clicking the Yes button saves the changes and exits AVEVA E3D,clicking the No button doesn’t save the changes and exits AVEVAE3D and clicking the Cancel button aborts the exit command.

Where no changes have been made to the databases a Confirmation alert isdisplayed.

Clicking the Yes button exits AVEVA E3D and clicking the No button abortsthe exit command.

3.14 Help

AVEVA E3D Help is accessed by clicking the Help> AVEVA Everything3D Help button from the

PROJECT tab to display the Help Viewer in aseparate window.

Help may also be accessed by clicking the Helpbutton in the top right hand corner of the AVEVAE3D window.





The Help Viewer enables the user to explore the AVEVA E3D documentation either via the logically groupeditems in the Contents tab, from an alphabetical index via the Index tab or search for key words via theSearch tab.

The page of the displayed User Documentation in the Help Viewer may be printed by clicking the Printbutton in the top right hand corner of the Help Viewer window.





Exercise 1

Entering AVEVA E3D

Double click the AVEVA Everything3D 1.1.0 desktopicon

or

Select Start > All Programs > AVEVA Plant > Design> AVEVA Everything3D 1.1.0 from the Start menu todisplay the AVEVA E3D Login form.

Click the TRA project tile to display the login credentialstile for the project.

Open the User options list and select the user A.EQUIPMAN.

The Trainer may supply different login details tothe following.





Enter A in the Password textbox.

Open the MDB options list and select A.EQUIPMENT(MDB for User A.EQUIPMENT)

Click the Model tile to enter AVEVA E3D.

The animated loading image is displayed whilst AVEVA E3D loads to display the default screen layout.





Displaying and Docking Forms

Many of the forms can be positioned, resized and docked on the screen as required. These positions will beremembered for the next time the user enters AVEVA E3D.

1. Click the arrow next to Design WORL * in Model Explorer to expand the top level explorer tree.

2. Click and hold with the left mouse button on the Model Explorer title bar and move the cursor toundock the form. Note the displayed docking icons. Dock Model Explorer in various positions.

3. Unpin and Pin Model Explorer.

4. On the HOME tab in the Common group click the Clashes button to display the Clashes form. Resizethe form by dragging the edges/corners as required and move it to a suitable location, noting that it isnot a dockable form, i.e. the docking icons are not displayed when it is moved. Close the form byclicking the Close button in the top right hand corner of the form.

5. Click the Messages button in the bottom right hand corner of the window to close the Messages form.

Accessing Discipline Interfaces

6. The default discipline in Model is General. Open the discipline options list on the Quick AccessToolbar and select EQUIPMENT.

7. Note the change to the discipline interface. The EQUIPMENT tab has been added and is selected.

8. Select other disciplines from the Quick Access Toolbar and note the changes in the disciplineinterfaces.

Setting Up Training Data

9. Ensure the EQUIPMENT discipline is selected and on the TOOLS tab in the Training group click the

Setup button to display the Training Setup form.

10. In Model Explorer, make sure that Design WORL * is the current element, i.e. it is highlighted in blue.Select the Foundations tab on the Training Setup form and then check the Add TRA SITE checkbox.Click the Apply button followed by the Close button.

11. Note that the Model Explorer updates to show the SITE element named TRASITE at the top of the

explorer and that the site has been added to the 3D View.





Navigating the Hierarchy

12. In Model Explorer expand the TRA.SITE element to display the ZONE elements owned by the SITE.

13. Expand the ZONE elements to display the members of each ZONE and note the element types that areowned by each ZONE.

14. Expand the different element types in the ZONE and note what type of elements they own.

15. Click on each of the PIPE elements in the ZONE to make each one the current element.

16. On the HOME tab, in the Navigate group, click the Previous button several times and note the CEchange each time the button is clicked. Click the Forward button and note the CE change.

17. Open the Previous button’s options list and select an entry from the list and note the CE change to theselected element. Open the Forward button’s options list and note the effect on the list.

18. In the textbox at the top of Model Explorer, enter p and note that only element names with a lower casep are displayed. Select one of the names and note that model explorer navigates to one of the elementsin the PIPE ZONE of the TRASITE element.

19. Right click in an empty part of Model Explorer to display the Filter pop-up menu and select Piping fromthe sub-menu.

20. Double left click the PIPE.ZONE, then pipe2, followed by pipe2-b1. Note that all of the pipecomponents are displayed.

21. Navigate to the EQUIP.ZONE, expand the zone hierarchy, then the hierarchy of PUMP1. Note that onlythe nozzle elements are displayed as they relate to piping.

22. Expand the STRUC.ZONE and the TANK2-STRU element. Note that no members are shown below theFRMW level as no elements relate to piping.

23. Use the Equipment and Structural filters and note the resulting display in the Model Explorer for

different element types.

24. Clear the Model Explorer filters.

Copying Elements with Model Explorer

25. Right click on TANK1 in Model Explorer to make it the CE and display the pop-up menu. Select theCopy option. Right click on TANK2 to display the pop-up menu again, this time selecting the Pasteoption. Note that a copy of TANK1 has been created and named Copy-of-TANK1, after the CE, i.e.TANK2.

26. Right click on PIPE.ZONE and select Paste from the pop-up menu. Note that a further copy of TANK1,named Copy-(2)-of-TANK1, has been created in the different ZONE.

27. Hold down the Ctrl key and click and hold down with the left mouse button on PUMP1 in the ModelExplorer. Drag the pointer down the explorer, still holding down the Ctrl key and the left mouse button,and note the displayed line. When the line is displayed below Copy-of-TANK1, simultaneously releasethe Ctrl key and the left mouse button. Note that a copy of PUMP1, named Copy-of-PUMP1 has beencreated at the selected position.

Deleting Elements

28. Make Copy-of-TANK1 the CE. On the HOME tab, in the Common group, click the Delete DatabaseElements button and click the Yes button on the subsequent confirmation message.

29. Right click on Copy-(2)-of-TANK1. Select Delete from the Model Explorer pop-up menu and click the Yes button on the subsequent confirmation message.

30. Delete the Copy-of-PUMP1 element using either method.





31. Click the Undo button on the Quick Access Toolbar . The last deletion is undone and the elementCopy-of-PUMP1 is restored to Model Explorer. Click the Redo button to delete the element again.

Multiple Model Explorers

32. Right click on the EQUIP.ZONE element to make it the CE and display the Model Explorer pop-upmenu. Select the New Explorer > /EQUIP.ZONE option. Note that a new Explorer, labelledEQUIP.ZONE Explorer(1) is created.

33. In the newly created explorer expand the EQUIP.ZONE then right click on PUMP1. From the pop-upmenu select the New Explorer > /PUMP1 option to create another explorer labelled PUMP1Explorer(2).

34. Left click TANK1 in the main Model Explorer and note that it highlights the element in that explorer andin the EQUIP.ZONE explorer. Left click on PUMP1 in Model Explorer and note that it is highlighted in allthree explorers.

35. Close the two additional explorers.

Saving Work

36. Click the Save Work button on the Quick Access Toolbar .




CHAPTER 4

4 Displaying Modelled Elements

This chapter describes how to view the required model elements; set the view limits and set the viewingdirection.

In order to view the model in a 3D View, the basic things to consider are:

Which elements are required to be viewed, i.e. Building the Drawlist.

Scaling the required elements to fit the 3D View, i.e. Setting the View Limits.

Which direction are the elements to be viewed from, i.e. Setting the View Direction.

4.1 Building the Drawlist

AVEVA E3D uses the concept of a Drawlist, that is, a list of database elements that are displayed in a 3D

View. All elements in the Drawlist must exist in the databases, i.e. they can be seen in Model Explorer.However, not all database elements need be in a Drawlist, thus making the Drawlist a very powerful tool for viewing the model.

Before any element can be displayed in a 3D View it must be added to a Drawlist. The Drawlist may consistof a single element, e.g. an EQUI element, a number of items,(e.g.an EQUI element and some PIPEelements, a complete SITE, or the whole model.

When elements are added to a Drawlist, any element that is a member of the added element, i.e. elementsowned by the added element, are also added to the Drawlist. Elements may be added or removed from aDrawlist at any time during a Model session.

4.1.1 Displaying the Drawlist

On the 3D VIEW tab, in the Contents group, clicking theDrawlist button displays the Drawlist for the current 3D View.

See section 5.5 for details of multiple 3D Views.

The Drawlist is a re-sizable and dockable form.

Before any element can be displayed in a 3D View it must be

added to a Drawlist. The Drawlist may consist of a singleelement, e.g. an EQUI element, a number of items,(e.g.anEQUI element and some PIPE elements, a complete SITE, or the whole model.

When elements are added to a Drawlist, any element that is amember of the added element, i.e. elements owned by theadded element, are also added to the Drawlist.

Elements may be added or removed from a Drawlist at anytime during a Model session.





4.1.2 Populating the Drawlist

Elements may be added and removed from the Drawlist in several ways, as described in the followingsections. If elements are added to the Drawlist, by any method, that are already present in the Drawlist, theyare not added again, i.e. there is only one occurrence in a Drawlist of a database element.

4.1.2.1 Drag & Drop from Model Explorer

Elements may be dragged from the Model Explorer and dropped into a 3D View. Clicking an element inModel Explorer and dragging it into a 3D View populates the Drawlist.

If the CE is a component or primitive the owning element is added to the 3D View. However, if the Ctrl key ispressed during the drag and drop operation, only the component or primitive will be added to the 3D View.

If the added elements are the first elements to be added to an empty Drawlist, the display zooms to thelimits of the elements. Subsequent additions to the Drawlist do not affect the limits of the display.

4.1.2.2 From the 3D VIEW Tab

The Contents group of the 3D VIEW tab contains three buttons to add and removeelements from the Drawlist.

Clicking the Add CE button adds the current element to the Drawlist and the 3D View.

Clicking the Remove CE button removes the current element from the Drawlist and the 3DView.

Clicking the Remove All button empties the Drawlist completely and the 3D View.

4.1.2.3 From Model Explorer

Clicking the CE in Mode Explorer with theright mouse button displays the ModelExplorer pop-up menu, as described earlier inthis training guide.

The 3D View option has a sub-menu that hasthe following options:

Add – this option adds the CE to the Drawlist and 3D View, together with all the elements it owns. If theCE is a primitive the owning element is also added to the 3D View.

Add Only – this option adds only the CE to the Drawlist and 3D View. If the CE is a primitive only theprimitive is added to the Drawlist and 3D View.

Add Connected – this option adds the CE and any elements connected to it to the Drawlist and 3DView.

How elements are connected varies depending on the discipline and is outside the scope of thistraining guide. Refer to specific discipline training guides for element connectivity.





Add Within Volume – this option adds the CE and any elements that are partially or wholly within a‘volume box’ whose size is derived from the extremities of the CE to the Drawlist and 3D View.

Remove – this option removes the CE from the Drawlist and 3D View, with all the elements it owns. If the CE is a primitive the owning element is also removed from the Drawlist and 3D View.

Remove Only – this option removes only the CE from the Drawlist and 3D View. If the CE is a primitiveonly the primitive is removed from the Drawlist and 3D View

Whichever method is used to populate the Drawlist, the form updates (refreshes) automatically providing the Track changes checkbox is checked. If it is not checked the Drawlist will not updatewith changes to the Drawlist until the checkbox is checked.

4.1.3 Using the Drawlist

The Drawlist has many features to help control the Drawlist for a 3D View and has three areas, as describedin the following sections.

4.1.3.1 Tabs

The top part of the form consists of three tabs, each of which has a grid.

The Drawlist tab displays all the elements currently in theDrawlist.

The Graphical Selection tab displays all elements in thecurrent graphical selection.

The Primitives tab displays the primitives of an elementselected from the Drawlist tab list. The tab header changes to

Primitives of /<nnnn>, where <nnnn> is the

name of the element, when an element is selected fromthe Drawlist tab. If more than one element is selected inthe Drawlist tab, the first primitives of the first elementselected will appear in the Primitives tab and the tab titleappropriately changed.

The grid in each tab have the same functionality. Each gridhas two columns showing the element Name, either anexplicit name or the system generated name, and theelement Type.

The grid entries may be grouped, sorted and filtered to suit the user’s requirements.

The grids have a right click pop-up menu which has the following options:

Multiple selections can be made from the grid.

Navigate To – this option navigates to the element, selected in the list, in the Model Explorer,effectively making it the current element. Where more than one element is selected this optionnavigates to the first one in the list.





Hide in 3D View – this option hides the selected element(s) in the 3D View. The elements are notremoved from the Drawlist, only removed from the 3D View graphics. The Show checkbox in theDisplay Settings frame of the Drawlist is unchecked.

Show in 3D View – this option shows the selected elements(s) in the 3D View if they have beenhidden. The Show checkbox in the Display Settings frame of the Drawlist is checked.

Remove from 3D View – this option removes the selected element(s) from the Drawlist and 3D View.

Add to Collections – this option adds the selected element(s) to the current collection.

See section 7.1 for details of the Collections form.

Export to Excel… – this options opens the Save Drawlist As browser, enabling the grid contents to besaved to a .xls file.

Print Preview… - this option opens the Print Preview form and displays a print preview of the grid.The grid contents may be printed from the form.

4.1.3.2 Display Settings

The Display Settings frame of the Drawlist enables singleelements or multiple elements selected in the tab grids tohave their visual properties in the 3D View modified.

When the display settings of a top level element in the Drawlist are modified, all lower level elementsowned by the element are also modified, however, individual primitives may have their display settingschanged from their owner’s colour by making a selection from the Primitives of /<nnnn> tab.

The Show checkbox enables an entry in the Drawlist to be displayed or hidden in a 3D View’s graphics. If unchecked, the Show checkbox hides the selected item(s) in the 3D View. Checking the checkbox displaysthe object in the 3D View, if previously hidden.

The Colour button caption shows the colour of the selected element(s) and displays its colour name. If morethan one element is selected the colour of the first element selected is shown, although the operation willchange the colour of all selected elements.

Clicking the Colour button displays the Colour form which displaysthe standard 16 AVEVA E3D colours. Any colour may be selectedfrom the palette by clicking the required colour button

Clicking the More… button displays a larger Colour form with 256available colours.

When a colour is selected the Colour button on the Drawlist form is updated. The selected elements in theDrawlist will be displayed in the selected colour.

The Edges checkbox toggles thehighlighting of the element’s edges inthe 3D View.

This setting is often used with semi-translucent elements to ensure aclearer view of the element(s).





The Translucency slider enables thetranslucency of elements to be modified.Setting the translucency of displayedelements allows other elements that areobscured in the display to be seen through

the semi- translucent element.

The number next to the slider label showsthe percentage of translucency for theselected item(s), i.e. 0% is a solid colour and 100% is completely transparent.

The percentage may be set by draggingthe slider or by clicking the left or rightarrow buttons at each end of the slider until the desired number is reached.

If more than one element is selected the

translucency of the first element selectedis shown, although the operation willchange the colour of all selected elements.

4.1.3.3 Options

The Options frame of the Drawlist contains three link labels

that have the following functions:

Select CE in List – this link label selects the CE, as shown in Model Explorer, in the selected tab gridand highlights the entry. If the CE is not in the selected tab list then a warning alert form is displayed.

Add CE to Drawlist – this link label adds the CE, as shown in Model Explorer, to the Drawlist. Thismay be a significant element, a component or a primitive.

Remove Selection – this link label removes the selected row(s) from the Drawlist. The other tabs areupdated automatically. This button is only enabled when one or more rows in any of the tab grids hasbeen selected.

4.1.4 Hiding and Showing Elements

In addition to the show and hide functionality available from the Drawlist, elements in the 3D View may behidden and displayed, but not removed from the Drawlist, in other ways.

Clicking the Hide Selected tile on the upper left side of a 3D View, hides the currentgraphical selection.

Right clicking on an element in the 3D View displays the Element pop-up menu.

Clicking the Hide option hides the current selection.

Refer to section 5,2 for information on graphical selections. The other options on this menu are described elsewhere in this training guide.





Hovering the pointer over the Hide Selected button displays three fly-out tiles.

Clicking the Show Last Hidden tile restores the last hidden element or graphicalselection to the 3D View. Clicking the tile again has no effect.

Clicking the Show All Hidden tile restores all hidden elements to the 3D View.

Clicking the Hidden List Form tile displays the Hidden Objects form.

The form displays a grid of all hidden elements. Single or multiple selections may be made from the grid and theselected items restored to the 3D View by either clicking theShow Objects button or right clicking in the grid and selectingthe Show option from the pop-up menu.

The Refresh button updates the grid of hidden elements.

When one of these tiles is clicked it becomes the default tile, i.e. it is displayed in the 3D View.

4.2 Setting the View Limits

In order to display items in the 3D View, whether it is a single item, a selection of items or an entire model,the elements have to be scaled to fit the view. Scaling of the items is performed automatically by AVEVAE3D once the limits of the items to be displayed are known. The limits of an item, or a selection of items, canbe envisaged of as a box completely encapsulating the item(s) to be viewed.

Limits of a single EQUI element Limits of several different element types

The following sections describe the ways in which the elements to be viewed can be scaled to fit a 3D View:





4.2.1 Using the View Control Tiles

The view limits may be set using the View Control tiles on the upper left side of a 3DView.

Clicking the Limits CE tile sets the view limits to the current element.

Clicking the Explicit tile displays Volume - Design form.

This form enables a limits box to be set from avolume which is specified by defining two diagonallyopposed corners of a 3D box.

The From and To co-ordinates may be specified

manually - by entering values in the text boxes

graphically – by selecting two elements

from the Select form menu which has thefollowing options:

CE – this option sets the limits box to the

extremities of the CE.

Owner – this option sets the limits box to theextremities of the owner of the CE.

Pick – this option sets the limits box to theextremities of an element picked in the 3D View.

Pick Owner – this option sets the limits box tothe extremities of the owner of an element pickedin the 3D View.

Clicking the Obstruction tile sets the view limits to the elements contained in theObstruction List. This list is primarily used for clash detection but may be used for this purpose.

Clash Detection and Obstruction Lists are outside the scope of this training guide.

Clicking the Clipbox tile sets the view limits to the same co-ordinates as the current

Clipbox, if defined.

See section 5.10 for information on Clipping.

Clicking the Zoom to Drawlist button sets the view limits and centres the view to thecontents of the Drawlist.

Clicking the Zoom to Selection button sets the view limits to the current graphicalselection. If there is no current graphical selection the CE is used as the selection.

Refer to 5.2 for information on graphical selections.





4.2.2 Using the 3D View Pop-up Menu

Right clicking in any blank area of a 3D View, i.e. the cursor is not over an element, displays the 3D View pop-up menu.

Selection – this option sets the view limits to the current

graphical selection or to the CE if there is no currentgraphical selection.

Identify Element… - this option enables an element tobe selected graphically from the 3D View. In this case,the selected element does not become the CE.

Entire Draw List – this option sets the view limits to theextremities of the entire Drawlist.

Walk To differs from Zoom To in that it removes itemsbetween the eye position and the target item that are not inthe immediate vicinity of the target item. Items in the

immediate vicinity of the target will continue to be displayed,so it may be necessary to remove items still obscuring thetarget item by removing them from the Drawlist. The other options on this menu are described elsewhere in thistraining guide.

4.2.3 Using the Element Pop-up Menu

Right clicking an element in the 3D View will display theelement pop-up menu.

The menu contains Zoom To and Walk To options thatuse the current graphical selection.

Refer to 5.2 for information on graphical selections.





4.3 Setting the View Direction

Although the model may be viewed form any direction, functions are provided for setting the viewingdirection to pre-defined and explicit directions.

The options are available from the Manipulate groupon 3D VIEW tab or from the 3D View pop-up menu.

4.3.1 Look

The Look options contains the six cardinal viewing directions and an explicit directionoption. Selecting one of the cardinal directions sets the viewing direction of the 3D Viewin that direction, i.e. selecting North views the model from the South, looking North.

Selecting the Direction option display the Look form which enablesany direction to be entered.

See section 6.3 for information on orientation syntax.

4.3.2 Plan

The Plan option contains four cardinal directions. Selecting a direction displays a planview of the model with the selected direction pointing up in the 3D View.





4.3.3 Isometric

The Isometric option contains four pre-set isometric view directions. Each directioncorresponds to North towards bottom right, top right, top left and bottom left of the 3DView.

The current viewing direction is displayed in the Status bar on a 3D View: A direction of n90d, i.e. North 90ºDown, is the default viewing direction and is the direction obtained when selecting Plan > North.

A direction of e45n35d, i.e. East 45º North 35º Down, is the direction obtained when selectingIsometric > Iso 3.





Exercise 2

Building the Draw List

1. In the 3D View, click the Remove All tile on the left side of the view to clear the 3D View and empty the

Drawlist.

2. On the 3D VIEW tab, in the Contents group, click the Drawlist button to display the Drawlist form.

3. Dock the Drawlist on the bottom of Model Explorer. Note that the Drawlist is empty as no componentshave been added to the 3D View. Make sure the Track Changes checkbox at the top left of theDrawlist form is checked.

4. In Model Explorer expand the TRA.SITE element to show the ZONE elements and expand theEQUIP.ZONE element. Highlight the equipment item TANK1 and drag and drop it into the 3D View.Note that the equipment element has been added to the 3D View and the view limits adjusted to theelement.

5. Make the equipment item PUMP1 in Model Explorer the CE and on the 3D VIEW tab, in the Contentsgroup, click the Add CE button add the equipment to the Drawlist and 3D View.

6. Right click the EQUIP.ZONE element in Model Explorer to display the pop-up menu and select 3D View> Add to add the ZONE to the Drawlist. Note that only the equipment element TANK2 has been addedto the Drawlist. As the other equipment items owned by the EQUI.ZONE were already in the Drawlist

only the remaining equipment item has been added.

7. TANK2 cannot be seen in the 3D View as the display limits were set around TANK1. Click the Zoom toDrawlist tile on the left side of the 3D View. The limits are now set to display all of the equipmentelements in the 3D View.

8. Right click on TANK1 in Model Explorer and select 3D View > Add Connected from the pop-up menu.This will add pipe1-b1 to the 3D View as the pipe is connected to the equipment item.

9. Right click on TANK2 in Model Explorer and select 3D View > Add Within Volume from the pop-upmenu. This adds pipe2-b1 and some of the section (SCTN) elements that make up the TANK2supports to the 3D View as they are within the volume of the equipment item.

10. Make the PIPE.ZONE element the CE and click the Add CE to Drawlist button on the Drawlist form toadd the remainder of the pipe branches to the 3D View.

11. Add the CIVIL.ZONE to the Drawlist using any method.

Setting the View Limits

12. Clear the Drawlist by selecting all of the entries in the Drawlist grid, right clicking in the grid to display

the Drawlist pop-up menu and select the Remove from Drawlist option.

13. Add the TRA.SITE to the Drawlist and remove the BASE element in the CIVIL.ZONE from the Drawlistby right clicking on it in the 3D View to make it the CE and display the element pop-up menu andselecting the Remove from 3D View option.

14. Right click in an empty area of the 3D View and select Walk To > Entire Draw List from the 3D Viewpop-up menu and note that the elements in the Drawlist now fill the 3D View.

15. Right click on TANK1 in the 3D View to make it the CE and display the element pop-up menu. Selectthe Walk To option from the menu and note that the equipment element now fills the 3D View.

16. Left click on any visible part of PUMP1 in the 3D View to make it the CE and left click the Zoom toSelection button on the left side of the 3D View. Note that the pump now fills the view.

17. Display the entire Drawlist again by right clicking anywhere in a blank area of the 3D View to display the3D View pop-up menu and select the Walk To > Entire Drawlist entry.





18. Navigate to TANK2 in Model Explorer to make it the CE and. click the Explicit tile from the left side of the 3D View to display the Volume form. Select the Select > CE option from the form menu and notethe volume box that is displayed around the extents of TANK2. Click the Apply button to set the viewvolume. The equipment item now fills the 3D View. Close the form to clear the volume box.

Setting the View Direction

19. Add the BASE element to the Drawlist and click the Zoom to Drawlist button to view the entireDrawlist contents.

20. Note the view direction in the status bar in the bottom left corner of the 3D View. It should read n 90 d,i.e. North 90º Down, a plan view with the North direction going up the 3D View.

21. On the 3D VIEW tab, in the Manipulate group, select Iso 3 from the Isometric button options list. Note

the change in the view direction on the status bar.

22. Right click anywhere in a blank area of the 3D View to display the 3D View pop-up menu. SelectIsometric > Iso 1, Iso 2 and Iso 4 in turn, noting the change to the 3D View and the view direction inthe status bar.

23. On the 3D VIEW tab, in the Manipulate group, select North from the Look button options list to displaythe southern elevation of the model. Note that the view direction has changed to n, i.e. North. Selectdifferent options from either the Look button options list or the Look sub-menu on the 3D View pop-upmenu, noting how the view changes.

24. On the 3D VIEW tab, in the Manipulate group, select North from the Plan button options list. Note thatthe view direction has changed to n 90 d, the default viewing direction. Select different options fromeither the Plan button options list or the Plan sub-menu on the 3D View pop-up menu, noting how theview changes.

25. Click the Save Work button on the Quick Access Toolbar .




CHAPTER 5

5 Working with 3D Views

The previous chapters have introduced the concept of the 3D View, described how to display modelelements and control the content, view limits and viewing direction of a 3D View.

This chapter describes additional functionality of 3D Views including modes of operation, graphicalselections, multiple, local and clone views, model manipulation, model representation, view clipping, coloursand graphical settings.

5.1 Modes of Operation in 3D Views

3D Views in Model may be used in one of three modes of operation:

Navigate Mode – this is the default mode. in this mode, 3D Views allow an element to be selectedsimply by clicking on it, which navigates to it in the database and makes it the CE.

Event Driven Graphics (EDG) Mode – in this mode, mouse pointer picks are used as part of an eventdriven graphics routine. The user is asked to perform a graphical pick on an element or a graphicalfeature in the displayed model. The prompt area contains an instruction which prompts the user toperform a graphical selection.

Model Editor Mode - in this mode one or more selected elements can be moved or rotated dynamicallyby dragging with the mouse pointer. The prompt area contains the prompt ‘Modify’.

Model Editor Mode cannot be entered whilst in EDG mode, and vice versa. Refer to Chapter 8 Introduction to Model Editor for information on operations in Model Editor Mode.

5.2 Graphical Selections

Visible items in a 3D View may be grouped together to form a graphical selection which are used in avariety of ways in AVEVA E3D.

Elements that form a graphical selection are highlighted with a solid green line around the extremities of theconstituent parts of the item(s).

5.2.1 Creating a Graphical Selection

A graphical selection may be created by:

Selecting elements individually.

Using a fence selection.

Using the element pop-up menu.

5.2.1.1 Selecting Elements Individually

Clicking on an element in the 3D View makes it the CE and creates a new graphical selection containing thatone item.

Holding down the Ctrl key and clicking on an unselected element will add it to the graphical selection.

5.2.1.2 Fence Selection

A graphical selection made be created using a fence selection with either the left or right mouse button.





A fence is obtained by clicking in an empty space in the 3D View, i.e. not with the cursor over an item, tospecify one corner of the fence rectangle and then holding down the mouse button and dragging the cursor to the opposite corner of the rectangle and releasing the mouse button.

The fence has two selection methods:

Wholly Within – this option selects elements that are entirely contained inside the rectangular boundary of the fence.

Wholly and Partially Within – this option selects elements that are both entirely contained inside therectangular boundary of the fence, and items that cross the boundary.

The selection options may be made from the Selection button options list in the Model Editor group of the3D VIEW tab or by a pop-up menu when a right button drag is used.

Dragging the fence with the left mouse button selects the items in thefence, depending on the current selection setting.

Dragging a fence with the right mouse button displays a pop-up menuwhen the mouse button is released.

The selection option may be selected from the pop-up menu, whichoverrides the current setting. The Cancel option aborts the fenceselection process.

Holding down the Ctrl key, while making a fence selection, adds theselected item(s) to the current graphical selection, if the selected item(s)are not already part of it.

5.2.1.3 Element Pop-up Menu

Right clicking on an element in a 3D View displays the element pop-up menu, however, depending on theelement type, the menu will have a Selection option with a context sensitive sub-menu. For example:

Right clicking on a pipe component will display the element pop-up menu with Selection option. The sub-menu has various options depending on the component clicked.

Right clicking on an ELBO element gives optionsfor selecting just the elbow, all elements connectedto it, the piping branch leg, the whole Branch or thewhole pipe.

Right clicking a SCTN element gives options for selecting all elements attached to the element, the

owning FRMW element or the Framework’s owningSTRU element.

Holding down the Ctrl key while making an element pop-up menu selection, adds the selected elements tothe graphical selection.





5.2.2 De-selecting Elements from a Graphical Selection

Elements may be de-selected from a graphical selection using similar techniques used for adding tographical selections.

Holding down the Ctrl key and clicking on an element that is part of the graphical selection de-selects it.

Holding down the Shift key while making a fence selection de-selects the fenced element(s) from thegraphical selection, if the selected element(s) are part of it.

Right clicking an element in the graphical selection and selecting De-selectCurrent removes that element from the graphical selection.

Selecting De-select All from the element pop-up menu clears the graphicalselection.

Left clicking in an empty part of the 3D View, i.e. when the cursor is notpointing at an element, also de-selects all elements in the graphicalselection.

5.3 Navigate to Element Button

In the Common group of the HOME tab the Navigate to Element button affects the waygraphical picking works in Navigate and EDG modes.

If the function is on, then in Navigate mode, selecting an equipment element will make the primitive under the cursor the CE, rather than the whole EQUI element, but does not create a graphical selection of theprimitive. It is not possible to create a graphical selection in Navigate mode with the Navigate to Elementfunction on.

Navigate to Element and Model Editor mode are mutually exclusive. Model Editor mode cannot beentered while the Navigate to Element is on, and the Model Editor button in the Common group is greyedout. Whilst in Model Editor mode, clicking the Navigate to Element button will exit Model Editor.

5.4 Creating and Copying 3D Views

AVEVA E3D provides the ability to view the model, or parts of the model, in multiple 3D Views. In practice;however, the number of useable views will probably be limited by the size of the monitor(s) in use.

AVEVA E3D has one, default 3D View, named 3D View(1) – Drawlist(1), which cannot be deleted or

renamed.

New 3D Views with the same or different Drawlists can be created and deleted and displayed

simultaneously. The content of the 3D Views can be linked or separate, depending on the associatedDrawlist and each view can be manipulated separately.

5.4.1 Creating an Empty View

On the 3D VIEW tab, in the New group, clicking the Empty View button creates a new 3D View with anempty Drawlist and displays the View Settings form where the new 3D View may be configured.

See section 5.6 for details of the View Settings form.

The new 3D View is named, by default, 3D View(x) – Drawlist(y) where x is the sequential number of the3D View and y is the sequential number of the Drawlist associated with the 3D View.

Only one 3D View can be current at any one time and is identified by the grey header to the 3D View. Allnon-current 3D Views have a blue header. A 3D View is made current by left clicking anywhere in the 3DView.





5.4.2 Copying a 3D View

On the 3D VIEW tab, in the New group, the Copy View button has an options listwith the following entries.

To a Separate View – this option creates a copy of the current 3D View and creates a new Drawlistpopulated with the same contents as the copied 3D View’s Drawlist. For example, copying 3D View(1) -Drawlist(1) to a separate view may create a 3D View named 3D View(2) – Drawlist(2).

To a Cloned View – this option creates a copy of the current 3D View and is associated with theDrawlist of the copied 3D View. For example, copying 3D View(3) - Drawlist(3) to a cloned view maycreate a 3D View named 3D View(4) – Drawlist(3).

To a Local View – this option creates a copy of the graphical selection in the current view and a new

Drawlist which is populated with the elements in the graphical selection. For example, copying 3DView(3) - Drawlist(3) with a graphical selection to a local view may create a 3D View named 3DView(4) – Drawlist(4) and the 3D View contents would be the graphical selection.

If this option is used to copy a 3D View that has no graphical selection defined, the new 3D View andDrawlist will be empty.

Each 3D View has a full set of view control buttons that apply only to that view. Each view also has itsown prompt area and Status bar.

5.5 Displaying Multiple Views

On the HOME tab, in the Windows group, the Windows Layout button has anoptions list with the entries:

Cascade – this options cascades all of the 3D Views such that all headers can be seen.

Close All – this options closes all of the 3D Views except 3D View(1) which cannot be closed. Awarning message is displayed.

Stack – this option stacks the 3D Views horizontally.

Side by Side – this option arranges the 3D Views side by side vertically.

The Windows Layout button option list also displays all 3D Views that are available with a check markagainst the current 3D View. A 3D View may be made current by clicking it in the option list. A checkmark is displayed against the new current 3D View.

Multiple views are not retained from session to session, only 3D View(1) is persistent.





5.6 The View Settings Form

On the 3D VIEW tab, in the Settings group, clicking Current View button displays the View Settings form.This form enables settings to be made for the current 3D View and is divided into several frames which areexplained in this section or other sections in this chapter.

Leaving the form open and making

another 3D View current updates theform to the current 3D View’s settings.

Title – the textbox displays the title of the current view whichdefaults to 3D View. A different title may be entered which willbe displayed on the 3D View header, for example: MyView(1) – Drawlist(2).

Projection – see section 5.7 for details of view projectionoptions.

Rotate – see section 5.8.4 for details of rotating the model.

Effects – these options enable the user to change theappearance of the graphics display in a 3D View. Thecheckboxes in this frame are toggles.

Unchecking the Shaded checkbox displays the elements inwire line. This may also be achieved by pressing the F8button.

Unchecking the Outlines checkbox removes outlines aroundthe elements in the 3D View.

Unchecking the Shadows checkbox removes the shadowsmade by the elements in the 3D View.

Checking the Outline Translucent elements checkboxdisplays a hard outline edge around translucent elements.

Shaded, Outlines andShadows checked

Shaded unchecked Outlines unchecked Shadows unchecked

Outline Translucentelements unchecked

Outline Translucentelements checked

Utilities –these options enable the user to display or hide the World Axes in the bottom left of the 3D View

and display rotation sliders on the bottom and right hand side of a 3D View, see section 5.8.4 for details of rotating the model.





Background – these options enable the user to set the colour and effect of the 3D View background.

Clicking the Colour button displays the 3D View Background Colour with 16 major colours.

Clicking the More… button displays a larger form with 256 colours thatmay be chosen.

Clicking a colour on either form sets it as the 3D View backgroundcolour.

By default the Graduated checkbox is checked, which gives a graduated effect to the 3D View background.Unchecking this checkbox removes the effect and makes the 3D View background a solid colour.

Graduated checked Graduated unchecked

Capping – these options enable the user to set the clipped element capping colour and toggle capping onand off. See section 5.10 for details of clipping and capping.

Lighting – these options enable the user to set the Brightness and Reflection for the 3D View graphicsusing a slider and a relative number between 0 and 1 for each setting. The default settings are 0.7 and 0.8respectively.

Brightness 0 Brightness 1





Reflection 0 Reflection 1

5.7 View Projection

Elements in a 3D View may be viewed in a parallel projection or in perspective.

Parallel Projection Perspective Projection

The view projection may be set from the View Settings form or toggled by pressing the F4 button. Thecurrent view projection is displayed in the Status area.

The majority of operations are normally carried out in parallel projection mode with perspective being reserved for creating realistic screen shots. However, all AVEVA E3D functionality will work in perspective mode.





5.8 Zoom, Pan and Rotate

A 3D View may be interactively manipulated by zooming, panning and rotating to achieve the desired viewof the displayed items. Each of these functions, once set, is used by dragging the cursor in the 3D View withthe middle mouse button.

5.8.1 Setting the Middle Mouse Button Options

The middle mouse button options may be set in the following ways:

3D VIEW tab

In the Manipulate group, the Middle Button button has an options list where themiddle mouse button function may be selected.

The highlighted option is current.

3D View Pop-up Menu

Right clicking in a blank area of a 3D View displays the 3D Viewpop-up menu. The Middle Button Drag option displays a sub-menu where the middle mouse button function may be selected.

The checkmark denotes the current option.

Function Keys

Pressing F2 sets the Zoom function.

Pressing F3 sets the Pan function.

Pressing F5 sets the Rotate function.

Zoom Rectangle mode is not available using the Function Keys.

The current setting of the middle mouse button drag mode is displayed on the status bar.

5.8.2 Zoom

With the middle mouse button function set to Zoom (Zoom In/Out from the 3D View pop-up menu), clickingand holding down the middle mouse button and dragging the cursor up the 3D View will zoom in anddragging the cursor down the screen will zoom out.

If the middle mouse button is set to Zoom Rectangle, clicking and holding down the middle mouse button inand moving the cursor to drag a rectangle will zoom to the extents of the rectangle when the button isreleased. The rectangle may be started from any corner.

No matter what function is set for the middle mouse button, scrolling the wheel forward will zoom in andscrolling the wheel backwards zooms out, however, it is much ‘coarser’ than zooming with the Zoomfunction.





5.8.3 Pan

Panning enables the contents of the 3D View to be moved across the view in any direction.

With the middle mouse button function set to Pan, clicking and holding down the middle mouse button andmoving the cursor in any direction in the 3D View will pan the view. The view will pan in the opposite

direction to the mouse movement and in direct correlation to the amount the cursor is moved.

The 3D View may also be effectively panned by ‘setting the centre of interest’. Positioning the cursor anywhere in the 3D View and clicking the middle mouse button will move the selected point to the centre of the view, thus effectively panning the view. Therefore, the view may be panned in any direction byselectively picking a point in the view and clicking the middle mouse button.

The view will pan by the distance between the picked point and the centre of the 3D View. Keeping thecursor in the same location and repeatedly clicking the middle mouse button will keep panning the view.Panning using this method works no matter what function is set for the middle mouse button.

5.8.4 Rotate

The contents of the 3D View may be rotated around a vertical or horizontal axis running through the centreof the view. The view may only be rotated around one axis at a time. The rotation may be achieved in twoways:

Using the middle mouse button - with the middle mouse button function set to Rotate, clicking andholding down the middle mouse button and moving the cursor left or right across the 3D View willrotate the view contents around the vertical axis. Moving the cursor up or down the view will rotate theview contents around the horizontal axis.

Using the 3D View Borders – checking the Show Borders checkbox on the View Settings formtoggles the display of rotation sliders at the bottom and right hand side of the 3D View. The rotationsliders may also be toggled by pressing the F9 function key.

The sliders are operated by dragging the orientation indicator with left mouse button. Dragging thebottom slider will rotate the contents of the 3D View around the vertical axis and dragging the right handslider will rotate the contents of the 3D View around the horizontal axis.

Using the concept of an eye and a target, AVEVA E3D has two modes for rotating in a 3D View:

About Model – this mode rotates the eye around the target. In actuality it appears as though the modelis rotating; however, it is the eye moving around the target.

About Eye – this mode rotates the target around the eye. This has a very different effect to that of About Model mode and the model can quickly disappear from the 3D View.

The rotation mode may be set from the View Settings form or toggled by pressing the F7 key. The current

rotation mode is displayed in the Status area.

5.8.5 Controlling Speed of Operation

The speed of manipulating the model with the middle mouse button drag options will largely depend on theamount of data being displayed and the speed of the hardware, particularly the graphics card, being used.However, the speed of zooming, panning, rotating and walking can be affected in the following ways:

Holding down the Ctrl key down while dragging will increase the speed of the operation.

Holding down the Shift key while dragging will decrease the speed of the operation.

The speed of the Zoom Rectangle function is not affected by the Ctrl or Shift keys.

The speed indication is displayed in the Status area whilst the relevant key remains pressed.





5.9 Setting the Centre of View

The centre of the 3D View plays a significant role when zooming or rotating the model, therefore the abilityto set the centre of view is important.

The centre of view may be set on a graphical selection, an identified element or

screen pick.

On the 3D VIEW tab, in the Manipulate group, the Centre of View button has anoptions list with the following entries.

Selection – this option centres the view on a graphical selection. If there is no current graphicalselection the CE is used.

Identify Element - this option centres the view on an identified element. The element is identified byleft clicking on it in the 3D View.

Identifying an element in this way does not make it the CE or create a graphical selection.

Screen Pick - this option allows a position to be identified in a 3D View. The position is picked by left

clicking anywhere in the view.

These options are also available from a sub-menu on the Set Centre of View option in the 3D View pop-upmenu.

The Centre on Selection tile on the left side of a 3D View centres the view on thegraphical selection.





5.10 Clipping and Capping

Clipping enables only those parts of the model which fall inside a clipping box or defined clipping planes tobe displayed.

On the 3D VIEW tab, the Clip and Cap group has three buttons, one to toggle clipping, oneto toggle capping and one to define the clip box or planes.

Clicking the Define button displays the Clipping Box form which has thefollowing options to define the clip box or planes.

Clip Box From CE – clicking this button defines a clip box from theextremities of the current element. The clip box is displayed andlabeled.

Clip Box From View Limits – clicking this button defines a clip boxfrom the limits of the 3D View.

Clip Box From Selected Element – clicking this button display theprompt ‘Pick Item to define clipbox’ : Picking any element in the3D View defines a clip box from the extremities of the pickedelement.

Clip Box From Selected Limits – clicking this button displays theprompt ‘Clipbox limits from (Snap) Snap’ and displays thePositioning Control form. The clip box is defined by picking twopoints as opposing corners of the clip box.

The prompt will change depending on the settings of the Positioning Control form. See section 6.2.1 for details of the Positioning Control form.

If a clipbox has previously been defined in the current session, it’s size, origin position and orientation areshown on the form. If a clip box has not been previously defined, a default clip box is defined at the origin.

The Size frame enables the clip box to be modified by entering X, Y and Z length values in the appropriatetextbox. The extents of the clip box may also be modified by entering a + ve or –ve value in the Extend by textbox.

The Position frame enables the position of the geometric centre of the clip box to be specified by enteringco-ordinates in the relevant textboxes or by clicking the Pick Position button and graphically picking aposition in the 3D View. Picking options are controlled by the Positioning Control form.

The Orientation frame enables the orientation of the clipbox to be specified by defining a plane through

which it passes using the two buttons or by editing the Y is and Z is text boxes.

Clicking the Apply button enables the defined clip box.





As an alternative to a clip box, up to six individual planes may be defined toclip the model. The clipping planes feature and the clipbox are mutuallyexclusive, i.e. enabling one has the effect of disabling the other andclearing any related forms and aid graphics.

Clicking the Six Plane Clipping… button on the Clipping Box formdisplays the Clipping Planes form and displays a confirmation message:

As a clip box has been defined by opening the Clipping Box form, even if it is the default clip box, the six clipping planes are set to each face of theclip box. Clicking the Yes button removes these clipping plane definitions.

The Define clipping plane options list is used to select which plane, 1 to6, is being defined and changes the Position and Direction information.

Clicking the Pick button enables a clipping plane to be aligned with an itemwhen picked in the 3D View. The Position and Direction fields areautomatically completed from the position and orientation of the pickeditem.

When the position and direction of the plane are defined it is automaticallyenabled. Clicking the Disable plane button disables the plane andactivated the Enable Plane button. Thus the plane can be enabled anddisabled.

If any manual modifications are made to the Position or Direction settings the Enable plane and Disableplane buttons are temporarily replaced by the Apply changes and Discard changes buttons. Once one of these buttons is selected the display reverts back to the Enable plane and Disable plane buttons.

When a plane is defined, a labelled graphics aid arrow is displayed at theorigin of the plane. The aid arrow is normal to the plane and points in theplane direction.

Clicking the Reverse button reverses the direction of the plane and updatethe displayed aid arrow and direction in the Direction textbox.

The location of the plane can be finely adjusted using the gadgets in the

Slide plane out or in frame.

The left and right arrow keys move the plane by increments of 50mm.

An explicit value may be entered in the text box. A +ve value will move theplane in the direction of the aid arrow, i.e. in, and a –ve value will move theplane in the opposite direction of the aid arrow, i.e. out.

Dragging the slider with the left mouse button moves the plane in theindicated direction, i.e. In or Out, by the value displayed in the textbox.

The Limits frame has the following buttons:

Derive 6 planes from grid lines… - clicking this button displays the Clip from Grid form that enablesthe clip plane to be derived from grid lines.





The form displays a list of available User Grid Systems from which the clipping

planes can be derived.

Selecting a grid system from the listchanges the entries in the Limits Fromand To frames to reflect the selected gridsystem.

Individual grid lines to delimit the clippedvolume can be selected from the optionslists or the nearest grid lines to twopicked positions can be automaticallyselected by clicking the Pick button inthe relevant frame.

Positive or negative offsets relative to thegrid lines can be entered into the +/-

textboxes.

Refer to TM-1802 AVEVA Everything3D™ Model Utilities for details of User Grid Systems.

Derive 6 planes from clip box… - this button uses the clipbox to define the six planes, e.g. followingClip CE and then manually adjusted.

Clear all clip planes… - this button displays a confirmation message for the removal of all clip planedata.

5.10.1 Capping

When the model is clipped, only the parts of the model inside the clip box or clipping planes are displayed.

Where items are intersected by the clip box or clipping planes plane, acoloured cap can be added to show that the items extend beyond thedisplayed region.

The capping colour is set from the View Settings form.

Capping is off by default.

5.11 Copy Image

On the 3D VIEW tab, in the Manipulate group, clicking the Copy Image button copies animage of the contents of the current view to the clipboard from where it can be pasted into

any document.

The button has an options list of the different resolutions available for the image.





5.12 Showing Tooltips on 3D View Elements

On the 3D VIEW tab, in the Aids group, the Show Tooltipsbutton toggles the display of tooltips for elements in the 3D View.

If toggled on, hovering the cursor over a model element displays

the tooltip after as short delay.

The tooltips are configurable and the content varies dependingon the element type.

Configuring tooltips is outside the scope of this training guide.

When Show Tooltips is toggled on, tooltips are also displayed when the cursor is hovered over an elementin Model Explorer .

5.13 Animations

On the PROJECT tab, clicking the Options > View > Animations button toggles the smooth zooming andpanning of 3D Views when the Zoom To and Walk To options are used.

The pan or zoom operation is animated to show the transition from the original view definition to the finalview definition. Animations only operate if AVEVA E3D determines that the hardware is capable of performing a smooth pan or zoom with the size of the model displayed in the 3D View.

5.14 Graphics Settings

On the 3D VIEW tab, in the Settings group, clicking the Graphics button displays the Graphics Settingsform. The form contains five tabs from which the majority of graphics settings can be made, including manythat have been described earlier. Each tab is described in the following sections.

5.14.1 Graphics Settings - Colour Tab

The General Colours frame enables colours used for specific purposes in 3D Views to be set.

Clicking the button adjacent to the purpose label displaysa colour form with buttons for 16 colours. As describedpreviously, clicking the More… on the colour form showsbuttons for 256 colours button.

Selecting a colour button changes the button colour onthe tab accordingly.

Each colour form has a title describing the purpose it issetting.





The purpose of each button is as follows:

CE – sets the colour of the current element in a 3D View. This colour overrides any other colour thatmay be set for the element.

Active – sets the colour of elements associated with the CE, e.g. if an equipment primitive is the CEthen all other primitives owned by that equipment will be displayed in the active colour.

Visible – sets the colour of all other elements in the 3D View other than the CE and those elementswith the active colour. This setting is only applied if Auto Colour rules are inactive.

Aids – sets the colour of the graphical aids used in AVEVA E3D.

Highlight – sets the highlight feedback colour, e.g. for highlighting elements to be deleted.

Tracing – sets the colour for pipes with a tracing specification.

The Auto Colours frame contains functions to control and define the auto colouring of elements in a 3DView.

Auto Colours are a set of rules that define the colour and other attributes of an elements, e.g. pipe systemsmay be displayed in different colours according to the fluid code or equipment in different plant areas bedisplayed in different colours.

Auto Colours are toggled on and off using the Auto Colour checkbox on the tab. The Dynamic AutoColour checkbox controls the re-evaluation of an elements colour if the attribute that the colour is dependenton is modified. If enabled the colour will be changed dynamically if the attribute is changed and if disabledthe colour will change when the element is next added to a Drawlist. Both of these settings are checked bydefault.

The Auto Colour Rules… link label displays the Auto Colour Rules form, from which Auto Colour rulesmay be created, deleted and modified.

5.14.2 Graphics Settings – Representation Tab

The representation of elements in a 3D View iscontrolled from the Representation tab.

The Representation Settings frame contains thefollowing controls:

The Tube and Centreline checkboxes control therepresentation of pipework in the 3D View.

If the Tube checkbox is enabled, pipework will bedisplayed as solid elements.

If the Tube checkbox is disabled and the Centrelinecheckbox enabled, the pipework is displayed ascentrelines, with components shown as a symbolicrepresentation defined in the catalogue.

If both Tube and Centreline checkboxes are enabled

both representations are displayed which can give anundesirable outcome.





Tube enabled Centreline enabled

The Holes Drawn checkbox controls how negative elements are displayed in the 3D Views. AVEVA E3D

does not fundamentally change the solid primitives from which items are created but modifies them withnegative primitives that ‘cut’ the solid primitives.

If the Holes Drawn checkbox is disabled, any negative elements are displayed as black lines in a shadedview. If the Holes Drawn checkbox is enabled, the negative primitives ‘cut’ the primitives to show the ‘holes’.This does not apply to holes in pipe flanges.

Holes Drawn disabled Holes Drawn enabled

The Flange Bolt Holes Drawn checkbox controls whether holes in piping flanges are displayed, providingthey have been set-up in the catalogue. This function works in the same was as Holes Drawn but isindependent from it.

Flange Bolt Holes Drawn disabled Flange Bolt Holes Drawn enabled

The Tracing checkbox controls the displayed colour of pipe elements that have a tracing specificationapplied. If the Tracing checkbox is enabled, the pipe elements with a tracing specification in the 3D View

will be displayed in the Tracing highlight colour specified on the Colour tab of the form.





The Anti-Alias checkbox and the Anti-Alias Level options list controls the ‘feathering’ of diagonal lines inthe 3D View. If the Anti-Alias checkbox is disabled, diagonal lines will appear ‘jagged’, however, if the Anti-Alias checkbox is enabled, diagonal lines will appear smoother.

The Anti-Alias Level options list has three levels of anti-aliasing that can be used, 2, 4 or 8. The higher thenumber the smoother the diagonal lines will be, however, this does have an overhead on the amount of

processing the graphics card has to perform.

The Insulation Visibility/Translucency options list controls the displayof insulation on pipes that have an insulation specification.

The default setting is Off , i.e. insulation is not shown. The insulationmay be shown as Solid colour, the pipe cannot be seen through theinsulation, however, the options list also has entries for showing theinsulation at different levels of translucency, i.e. the pipe can be seenthrough the insulation, from 12% through to 87%. The higher thepercentage the more translucent the insulation becomes.

Insulation Visibility/Translucency Off Insulation Visibility/Translucency 50%

The Obstruction Visibility/Translucency options list controls thedisplay of obstruction volumes where they have been defined.

The default setting is Off , i.e. obstruction volumes are not shown.Obstruction volumes may be shown as Solid colour, the element thatowns the obstruction volume cannot be seen through it, however, theoptions list also has entries for showing the obstruction volumes atdifferent levels of translucency, i.e. the element can be seen throughthe obstruction volume, from 12% through to 87%. The higher the

percentage the more translucent the obstruction volume becomes.

Obstruction Visibility/Translucency Off Obstruction Visibility/Translucency 50%

The Representation Rules… link label enables representation rules to be written and set. This functionality

is outside the scope of this training guide.

Refer to TM-1802 AVEVA Everything3D™

Model Utilities for details of Representation Rules in Model.





The Level frame on the tab shows the current display level for various item types in the model. The display

level may be set by entering a valid display level number in the appropriate textbox.

The AVEVA E3D default display level is 6 .

The Arc Tolerance value controls the representation of certain curves as polygon segments or faceting

planes. The smaller the arc tolerance, the smoother the curve drawn, however, on very large models thismay be an overhead on graphical performance.

Arc Tolerance 1mm Arc Tolerance 10mm

The value may be set by entering a number in the Arc Tolerance textbox. The default setting is 1mm

5.14.3 Graphics Settings – Steelwork Tab

The Steelwork tab controls the display of structuralprofiles and associated elements.

The Steelwork Settings frame contains the Profileand Insulation checkboxes which enable and disable

the display of profiles and insulation, if any has beendefined in the catalogue.

The Profile Obstruction Visibility/Translucencyoptions list works as previously described for generalobstruction visibility/translucency.

The Primary Nodes and Secondary Nodes framescontrol the display, size and colour of Primary andSecondary Nodes for structural profiles.

The Display checkboxes toggle the display of thenodes, the Size textboxes sets the size of the nodes

and the Colour buttons enable the colour of thedisplayed nodes to be set.

Refer to TM-1812 Everything3D™ Structural Modelling for details of Primary and Secondary Nodes.





5.14.4 Graphics Settings - Cabling Tab

The Cabling tab controls the display of cablewayvolumes, centreline representation, head/tail/routeattachments and cable nodes.

The Display checkboxes toggle the display of theattachments and nodes, the Size textboxes set thesize of the attachments and nodes and the Colour buttons enable the colour of the displayedattachments and nodes to be set.

Refer to TM-1815 AVEVA Everything3D

™

Cableway and Cable Modelling training guidefor details of Cabling attachment points and route nodes.

5.14.5 Graphics Settings – Plines and Ppoints Tab

The Plines & Ppoints tab controls the display of Plines on structural profiles and Ppoints on primitivesand piping, HVAC and cable tray components.

The Display checkboxes toggle the display of thePlines and Ppoints and the Pkey and Numberscheckboxes control the display of the Pline name or Ppoint number respectively.

The Length value determines the length of thedisplayed Plines or Ppoints.

Refer to TM-1812 AVEVA Everything3D™Structural Modelling training guide for details of Plines and TM-1811 AVEVA Everything3D™Equipment Modelling training guide for details of Ppoints on primitives.





The Graphics Settings form has buttons along the bottom of the form that are applicable to all tabs. Thebuttons have the following functions:

The Load button loads Graphics Settings from a previously saved file.

The Save button saves the current Graphics Settings to a file.

The Apply button applies the changes.

The Cancel button cancels any changes made and dismisses the form.





Exercise 3

Creating and Copying 3D Views

1. Clear the Drawlist and add the TRA.SITE element to the 3D View and set the view direction to Iso 3.

2. Select GENERAL from the Discipline options list on the Quick Access Toolbar to enter theGENERAL discipline. All of the features described work in an Model discipline.

3. On the 3D VIEW tab, in the New group, click the Empty View button to create a new, empty 3D View.The View Settings form is displayed. Note that the end of the main Window header bar and the title of the View Settings form reads [3D View (2) – Drawlist (2)], indicating that there are now two 3D Viewswith separate Drawlists.

4. On the HOME tab, in the Windows group, select Stack from the Windows Layout button options listto display both 3D Views.

5. On the View Settings form, which should still refer to [3D View (2) – Drawlist (2)], click the Colour

button in the Background frame to display the 3D View Background Colour form. Select any colour and close the form. Close the View Settings form.

6. Add the PIPE.ZONE element to 3D View (2) and set the view direction to North.

7. With 3D View (2) as the current view, on the 3D VIEW tab, in the New group, select To a SeparateView from the Copy View button options list to create a copy of the view and note that the new view isnamed [3D View (3) – Drawlist (3)]. Note that the view has the same contents and background colour as 3D View (2), however, it has a separate Drawlist. Stack the views to display all three views.

8. Make 3D View (2) the current view by clicking anywhere in the view. Change the viewing direction andremove element pipe1 from the 3D View by making it the CE and clicking the Remove CE tile in 3DView (2). Note that this has not affected the viewing direction or view contents of 3D View (3).

9. Close 3D View (2) by clicking the Close button in the top right corner of the view. On the HOME tab, inthe Windows group, select the Close All option from the Windows Layout button options list to close3D View (3). Click the OK button on the warning message and note that only 3D View (1) remains.

Expand the 3D View to fill the graphics area of the window.

10. Click on TANK1 in the 3D View to make it the CE and the graphical selection. On the 3D VIEW tab, inthe New group, select the To a Local View option from the Copy View button options list to create 3DView(2) – Drawlist (2) that contains only TANK1. Note that the new view has the same background

colour as used previously. This will persist for all newly created views until it is changed. Stack theviews to display both 3D Views.

11. Left click on TANK2 in the 3D View to make it the CE and the graphical selection. Hold down the Ctrlkey and left click on the pipe coming out of the bottom of TANK2 to add it to the graphical selection.

Note that the pipe is only highlighted up to the first elbow. Continue holding down the Ctrl key and clickpipe just past the elbow to add it to the graphical selection. Keep adding the pipe components up to theflange just before the tee to the pump, as shown:





12. On the 3D VIEW tab, in the New group, select the To a Local View option from the Copy View buttonoptions list to create 3D View(3) – Drawlist (3) that contains the graphical selection of TANK 2 and theselected pipe elements.

13. With 3D View (3) as the current view, select the To a Cloned View option from the Copy View buttonoptions list to create 3D View(4) – Drawlist (3).

14. On the HOME tab, in the Windows group, select the Side by Side option from the main menu to displayall four 3D Views. The layout should look similar to this:

Manipulating 3D Views

15. Delete 3D Views 2, 3 and 4 and maximise 3D View(1) by double clicking on its header. Remove theCIVILS.ZONE from the Drawlist and set the view direction to Iso3.

16. On the 3D VIEW tab, in the Manipulate group, select the Zoom Rectangle option from the MiddleButton button to set the middle mouse button function.

17. Drag a rectangle around TANK1 by clicking and holding the middle mouse button to the bottom left of the element and dragging the pointer to the top right of the element. The 3D View will zoom to the

rectangle limits.

18. On the 3D VIEW tab, in the Manipulate group, select the Zoom option from the Middle Button button.Click and hold down the middle mouse button and move the pointer down the screen to zoom out.Move the pointer up the screen to zoom in. Rotate the scroll wheel in each direction and note that thishas the same zoom effect, although the scroll wheel zoom is ‘coarser’.

19. Right click in a blank area of the 3D View to display the pop-up menu and select the Middle ButtonDrag > Pan option. Note the change from Zoom to Pan in the Status area at the bottom left of the 3DView. Click and hold down the middle mouse button and move the pointer around the screen, noting thepanning effect on the model.

20. Click the middle mouse button with the pointer away from the centre of the 3D View to set the centre of

interest, noting the panning effect of this action. Click the middle mouse button several times with thepointer in the same place to pan the view in the same direction. Click the Zoom to Drawlist tile to re-centre the displayed elements.





21. On the 3D VIEW tab, in the Manipulate group, select the Rotate option from the Middle Button button.Click and hold down the middle mouse button and move the pointer left and right across the screen torotate the displayed elements around a vertical axis in the centre of the view. Release the middlemouse button and repeat the action but this time move the pointer up and down the screen to rotate thedisplayed elements around a horizontal axis.

22. Press the F7 function key to set Eye in the status area and repeat the rotate actions noting thedifference from the Model setting. Press the F7 function key again to return to the Model setting.

23. Press the F9 function key to display the rotation sliders on the bottom and right-hand side of the 3DView. Click and hold the left mouse button on the bottom slider and move the slider left and right torotate the displayed elements around a vertical axis. Repeat the action with the right-hand slider,moving the pointer up and down to rotate the displayed elements around a horizontal axis. Press theF9 function key again to remove the sliders.

24. Click the Zoom to Drawlist tile and set the view direction to Iso 3. Click on TANK2 in the 3D View andclick the Centre on Selection tile on the left side of the 3D View. Note that the view adjusts to move

the equipment item at the centre of the view. Rotate the displayed elements, noting that the centre of rotation is TANK2.

25. On the HOME tab, in the Common group, click the Navigate to Element button to toggle it on. In theManipulate group, select the Identify Element option from the Centre of View button options list andselect any primitive on the PUMP1 equipment item. Rotate the model and note the rotation centre.

26. From the 3D View pop-up menu select Set Centre of View > Screen Pick… click anywhere in the 3DView. Note that the pointer location when the mouse button was clicked has moved to the centre of theview. Rotate the displayed elements.

27. On the HOME tab, in the Common group, click the Navigate to Element button to toggle it off .

Clipping

28. Make PUMP1 the CE and on the 3D VIEW tab, in the Clip and Cap group, click the Define button to

display the Clipping Box form. Uncheck the Clipping checkbox and click the Clip Box from CEbutton. A clip box is displayed around PUMP1. Check the Clipping checkbox and note that PUMP1 isthe only element displayed as all other elements have been clipped.

29. In the Clip and Cap group, click the Clipping button to unclip the 3D View. Click the button again toactivate the clipping again.

30. On the Clipping Box form enter the following values in the appropriate textboxes:

Xlength 1778

Ylength 1556

Zlength 3550

East 2711

North 7000

Up 3350

31. Click the Apply button on the Clipping Box form and note that the 3D View has been clipped toTANK2 and some small part of its support steelwork. Uncheck the Clipping checkbox.

32. Click the Six Plane Clipping… button on the Clipping Box form to display the Clipping Planes form.Click the Derive 6 planes from clipbox… button and click the Yes button on the confirmationmessage. Six independent clipping planes have now been derived. Clip Plane 1 is shown by default in

the 3D View and its Position and Direction information is displayed on the form.

33. Press the F8 function key to display the elements in wireline mode and note the displayed aid vector arrow which is normal to the clip plane. On the Clipping Planes form; select 6 from the Define





clipping plane options list. Note that the aid vector arrow is now shown for Clip Plane 6. Press the F8function button again toggle back to shaded mode.

34. On the Clipping Planes form, with Clip Plane 6 as the current clipping plane, in the Slide plane out or in frame, enter 500 in the Slide by text box and press the Return key, noting that Clip Plane 6 has sliddownwards by 500mm. Click the arrows either side of the Nudge out or in caption to change the clip

box dynamically.

35. On the 3D VIEW tab, in the Clip and Cap group, click the Capping button to display the capping of the

clipped element.

36. Select 1 from the Define clipping plane options list and enter E 45 N in the Direction textbox, pressthe Return key and click the Apply changes button. Note that Clip Plane 1 has changed direction andaffected the clipping. Left click and hold on the Out/In slider and move it to adjust Clip Plane 1.

37. Close the planes Clipping Planes form. Disable clipping using the Clipping button in the Clip and Capgroup.

Graphics Settings

38. Click the Zoom to Drawlist button and set the view direction to Iso3. On the 3D VIEW tab, in theSettings group, click the Graphics button to display the Graphics Settings form.

39. Click on the Colour tab to make it current and click the Navigate to Element button on the HOME tabto toggle it on. Zoom in to PUMP1 and left click on the cylinder that forms part of the pump motor. Notethat the cylinder is now coloured magenta, the default CE colour, however, the rest of the primitivesthat form the equipment are coloured royal blue, the default Active colour.

40. Click the CE colour button on the Graphics Settings form to display the Current Element Colour form. Click on the cyan button to set the colour and close the Current Element Colour form. Click theApply button on the Graphics Settings form and note that the cylinder is now coloured cyan.

41. Uncheck the Auto Colour checkbox on the Graphics Settings form to toggle the it off, and note that

the Dynamic Auto Colour checkbox is greyed out. Click the Visible colour button to display theVisible Element Colour form and select any colour. Close the form and then click the Apply button onthe Graphics Settings form. To make this change to the displayed elements they must be removedfrom the Drawlist and added back to it. Right click on the TRA.SITE in Model Explorer and select 3DView > Remove from the pop-up menu. Add back the PIPE.ZONE, EQUIP.ZONE and STRUC.ZONEseparately to the Drawlist and note that all elements are displayed in the new Visible colour.

42. Click the Auto Colour checkbox on the Graphics Settings form to toggle the setting on. Remove allelements from the Drawlist and add back the PIPE.ZONE, EQUIP.ZONE and STRUC.ZONE and notethat they all now use the Auto Colour Rules, i.e. each type of element, equipment, pipes and structuralcomponents, are different colours.

43. Click on the Representation tab to make it current. Check the Tube checkbox and check theCentreline checkbox. Click the Apply button and note the change in representation of the pipingelements, i.e. the only the pipe centrelines are drawn and valves have a ‘schematic’ representation.Changes the settings back and click the Apply button again to change the representation.

44. Uncheck the Holes Drawn checkbox to toggle it off and Click the Apply button. Zoom in to the top of one of the TANK2 support columns where the horizontal beams connect. Note the dashed black linesand circles that represent negative extrusion that cut-back the steel beams and make holes in thecolumns for bolted joints. Check the Holes drawn checkbox and click the Apply button. Note that theblack lines and circles representing the negatives have disappeared and that the negatives have ‘cut’the steelwork.

45. Zoom out from the column and zoom in on one of the valves in the model. Open the ObstructionVisibility/Translucency options list, select the 50% option and click the Apply button. Note that semi-translucent shapes have appeared around parts of the valve. Select the Off option from the

Obstruction Visibility/Translucency options list and click the Apply button to remove the obstructionvolumes from the display.





46. Check the Flange Bolt Holes Drawn checkbox and note that the bolt holes in pipe flanges are nowdisplayed.




CHAPTER 6

6 Attributes, Positioning and Orientation

6.1 Element Attributes

Every AVEVA E3D element has a fixed set of properties know as its attributes. Some attributes arecommon throughout the large range of elements, some are applicable to many elements and some areunique to one type of element.

For some element attributes, appropriate values are set by the creation or modification of the element whenmodelling, whilst others may be set or entered by the user via the User Interface.

For example, a cylinder primitive (CYLI) has the following attributes:

Attribute Description

RefNo The unique database reference number.

Name The explicit element name or system generated element name.

Type The type of element - may be displayed as the abbreviated name.

Lock Either set to True (locked) or False (unlocked). If locked, the element may not be

modified or deleted.

Owner The name of the elements owning element.

Purpose This attribute may be set if the element has a specific purpose.Position WRTOwner

The position of the elements origin with respect to its owner’s origin. All primitives havean origin. The values of the coordinates are expressed in the current session units.

OrientationWRT Owner

The orientation of the components axis system with respect to its owner’s axis system.

Level

AVEVA E3D can produce different representations of an item, depending on how it hasbeen modelled and the representation levels used. The Level attribute is expressed as arange of levels; however, only one display level (for certain element types) may bedisplayed at one time.

Obstruction

The Obstruction attribute is used to declare whether an element may be considered solidor not. Obstruction values may be set to 2 (Hard), 1 (Soft) or 0 (No obstruction).

This attribute is used in clash detection purposes.

Diameter The diameter of the cylinder in the current session units.





Attribute Description

Height The height of the cylinder in the current session units.

Tmrref Template repeat reference. This is an advanced attribute applicable to primitives used

with a repeat function in templates.

RepCount Repeat Count. This is an advanced attribute applicable to primitives used with a repeatfunction in templates.

Only the Diameter and Height attributes describe the geometry of the cylinder. Other primitives will havespecific attributes that describe their geometry.

6.1.1 Pseudo Attributes

In addition to the standard set of attributes that all AVEVA E3D elements have, they also have a set of ‘derived’ attributes known as Pseudo Attributes. The number of pseudo attributes varies depending on the

element type. Pseudo attributes may be queried and used in expressions, say in reports, in the same way asfixed attributes. Examples of pseudo attributes are:

Brweight – Branch weight (in kg).

Clle – centreline length (of branch).

Gcof – Gross centre of gravity (position).

Ncof – Nett centre of gravity (position).

Gwei - Gross weight.

Nwei – Nett weight.

Cutl – cut length (of structural profile).

Tctl – true cut length (of structural profile).

6.1.2 User Defined Attributes

In addition to the standard element attributes and pseudo attributes, AVEVA E3D enables additional User Defined Attributes (UDA) to be assigned to one or more elements. The Lexicon module in the AVEVAAdministration product is used to create, modify and assign a UDA.

A UDA is just like any other attribute but may be specific to the company or the particular project. The settingof the UDA is normally made manually by the user, although it may have a default value.

UDAs are prefixed by a colon which differentiates them from standard attributes. For example:

:Manufacturer - User Defined Attribute

Height - Standard Attribute





6.1.3 Querying Attributes

When working with AVEVA E3D there are numerous occasions when one or more attributes of a databaseelement are required to be known, whether it be a standard attribute, a pseudo attribute or a UDA. Attributesmay be queried and modified from the Attributes form.

In the Common group of the discipline tabs or the HOME tab,clicking the Attributes button displays the Attributes form for the current element.

The form may also be displayed by selecting the Attributes…option from the Model Explorer pop-up menu.

The Attributes from is a re-sizeable and dockable form thatdisplays, by default, the standard attribute data and any UDAsfor the current element in a grid.

The Track CE checkbox toggles the updating of the formwhen a different element becomes the current element.

A Filter button is also displayed at the top right of the form.This allows users to see if any filters have been applied to theattributes displayed.

Right clicking in the grid displays the Attributes from pop-up menu. Some of theoptions are greyed out depending on the attribute the cursor was on when theright click was made.

The pop-up menu has the following options:

Navigate To – this option is enabled when the attribute has a reference thatcan be navigated to, i.e. Owner, Spref, Pspec, etc.

Set Attribute Value to CE – this option enables an attribute value to be setto another element in Model Explorer.

WRT Element – this option enables certain attributes, e.g. Position andOrientation, to be set with respect to (WRT) other, pre-determinedelements. By default, any elements that have Position and Orientationattributes are set to be with respect to their Owner.

This option has a sub-menu that displays the available elements that theWRT attributes can be set to. The contents of the sub-menu vary dependingon the element displayed in the Attributes form.

The WRT setting affects all attributes that have a WRT setting.

Display P-Points – this option toggles the inclusion of Ppoint data in the grid for elements that ownPpoints.

Track CE – this option toggles Track CE checkbox on and off. The checkmark is displayed when on.

Categorised/Alphabetical – this option displays the grid in categorised mode or alphabetical mode.The system defines the category that each attribute belongs to.





Expand Nodes – this option expands all nodes, i.e. any attributes or categories with the icon next tothem.

Collapse Nodes – this option collapses all nodes, i.e. any attributes or categories with the icon nextto them.

Modify Category Filters – this option displays a form that enables categories of attributes to bedisplayed or hidden. This applies in both Categorised and Alphabetical mode.

The form is also displayed by clicking the Filter button at the top right of theAttributes form.

The form displays the categories of attributes and is element typedependent.

The attributes displayed in the grid may be controlled by checking ore

unchecking the required categories.

Manage Category Filters… – this option displays the Manage Category Filters by Element Type formand is used to control how category filters are implemented.

Display Standard Attributes – this option toggles the display of standard AVEVA E3D elementattributes on and off.

Display UDAs – this option toggles the display of User Defined Attributes on and off.

Display Pseudo Attributes – this option toggles the display of Pseudo Attributes on and off.

Columns – this option has a sub-menu the enables the attribute’s Description and/or Data Type to beadded as columns in the grid.

Settings – this option has a sub-menu that enables the display of attributes whose value is Nulref, i.e.

null reference, and/or is unset, to be supressed.

Export to Excel – this option displays the Save As browser that enables the grid to be saved as an

.xls file.

Print Preview – this option opens the standard Windows Print Preview form, enabling the grid to beprinted.





6.1.4 Modifying Attributes

Standard attributes and UDAs may be modified from theAttributes form.

Some attributes, generally those set by the system and allpseudo attributes, cannot be modified and are shaded grey inthe Value column.

Double clicking in a modifiable attributes Value column entryhighlights the attribute value or parts of the value so it can bemodified using standard Windows techniques.

If the modification is successful, i.e. a valid entry has beenmade, the value cell is highlighted in cyan.

If the modification is unsuccessful then the value cell ishighlighted in red.

Attributes may also be modified using the Command Window, however, this is not recommended for inexperienced AVEVA E3D users.

6.2 Positioning

Many AVEVA E3D elements have a Position attribute, e.g. SITE, ZONE, EQUI, SUBE, STRU, PANE,SCTN, Primitives, etc.

Positions in AVEVA E3D are expressed in terms of 3D co-ordinates, i.e. X, Y and Z. As AVEVA E3D assignscardinal directions to these three axes, i.e. X is East, Y is North and Z is Up, positions are often expressed interms E, N, U rather than X,Y,Z.

On the PROJECT tab, selecting Options > Systems > Coordinates enables a choice of ENU or XYZ to bemade for the display of co-ordinates on forms or aid graphics.

The Position attribute gives the elements position with respect to its owner, however, where the elementsowner does not have a Position attribute, the position is given with respect to its owner’s owner. For

example, a PANE element is owned by a FRMW, however, a FRMW does not have a Position attribute;therefore, the PANE’s position is given with respect to the FRMW’s owner, a STRU, which does have aPosition attribute.

Forms that create or modify elements often enable the position to be expressed with respect to other elements although the Position attribute always gives the value with respect to its owner, no matter how itwas derived. In other cases forms only allow positions to be expressed with respect to their owner or theWorld.





6.2.1 The Positioning Control Form

In EDG mode, positions may be picked using other elements in the 3D View. Whenever this is applicable thePositioning Control form is activated.

The form is divided into three parts. The left part controls the Pick Type,the middle part controls the Pick Method and the right part has explicitpositioning and working plane options.

6.2.1.1 Pick Type

The Pick Type options are:

Element - picking is restricted to elements.

Ppoint - picking is restricted to Ppoints or panel vertices.

Pline - picking is restricted to structural Plines

Graphics – enables edge, surface and corner picks on any graphical element.

Aid - picking is restricted to 3D Aid Constructs, including User Grid Systems.

Screen – enables a pick anywhere in the 3D View which identifies two co-ordinates, the third co-ordinate being taken from the current Working Plane or normal to the view direction if there is noactive Working Plane.

Laser – picking is restricted to Laser data points.

Any – uses any appropriate pick type.

6.2.1.2 Pick MethodSnap - selects the snap point nearest to the cursor pick point. Snap points vary for different elements.

Mid-Point - derives the mid-point between two snap points along a linear item.

Intersect – derives the intersection of two picked lines from any directional elements. The elements

do not have to be co-planar.

Cursor - places the derived point exactly where the cursor picks on the element.

Distance - applies the offset value entered in the textbox. For example a +ve value of 500derives a point 500 mm from the nearest snap point, measured towards the cursor position, whereas, a –ve value of 500 derives a point 500 mm from the nearest snap point,

measured away from the cursor position.

The two additional buttons on the Positioning Control form are:

Working Plane – this button activates the working Plane if one has been derived.

Explicit Position – this button displays the Explicit Position form allowing explicit co-ordinates to beentered.





6.2.2 Positioning Explicitly

On the discipline tabs or the HOME tab, in the Common group,clicking the Position Explicitly button displays the Explicit Positionform.

An explicit position is defined by entering the required co-ordinates inthe East/West, North/South and Up/Down textboxes. The optionbuttons are used to set the appropriate direction in each case. If required, the Lock checkboxes may be used to fix the current co-ordinate along any axis.

The WRT (with respect to) textbox can be used to identify an elementwhose coordinate system is to be used for the Position data.

The Datum options list allows identification of the specific point on theelement to which the position is to apply and vary depending on theelement being positioned.

The Select form menu options change the focus of the form, i.e. if a new CE isselected in Model Explorer , selecting the CE or Owner option displays the position of

the CE or its owner, respectively, on the form.

The Pick and Pick Owner options prompts for an item to be picked and the selecteditem or its owner’s position, respectively, is displayed on the form.

Picking a position with the Positioning Control form in conjunction with the Explicit Position formopen automatically populates the coordinate textboxes.

When the form is opened or a new element selected, a ‘bounding box’ is placed around the extremities of the element to be moved, whether it is displayed or not. On entering new co-ordinates the bounding box is

moved to the new location as a preview of the change to be made. An axes aid is also displayed at theDatum point showing the cardinal directions.

Clicking the Apply button on the form moves the element to the specified location. Clicking the Cancelbutton removes the bounding box and dismisses the form.





6.2.3 Positioning Relatively

Elements may be positioned relatively, i.e. from their current position by a specified direction and distance.

On the discipline tabs or the HOME tab, in the Common group, clickingthe Position Relatively By button displays the Position By form.

The offsets from the current position are defined by entering therequired distances in the East/West, North/South and Up/Downtextboxes, using the option buttons to set the appropriate direction ineach case.

If required, the Lock checkboxes may be used to fix the current positionalong any axis. The default offsets 0mm, 0mm, 0mm which representsthe current position of the element.

The WRT (with respect to) textbox can be used to identify an elementwhose co-ordinate system is to be used for the Position data.

A different element or elements may be selected for relative positioning by using the Element options list,which has the following entries:

CE – this option uses the CE as the element to move.

Pick – this option allows elements to be selected from the 3D View. With this option theApply button must be clicked before picking the elements. Once all elements are picked,pressing the Esc key moves the elements.

Collection – this option uses the elements in the current collection. All elements in the currentcollection are re-positioned.

Refer to section 7.1 for details of Collections.

Selection - this option uses the elements in the graphical selection, if one exists. All elements in thegraphical selection are re-positioned.

When the form is first opened, or a new selection made, an axes aid showing the cardinal directions isplaced at the elements current position. When offsets are entered in the relevant textboxes, aid linesshow the offsets, true distance and the new position.

Clicking the Apply button on the form moves the element(s) by the specified offsets. The aids are stilldisplayed showing the new position if the Apply button was to be clicked again. Clicking the Cancelbutton removes the aids and dismisses the form.

In addition to these methods of positioning elements, other functionality to move, drag and perform planar moves affect an elements position is available. Similarly, the Model Editor enables elements

to be moved graphically.





6.3 Orientation

Many AVEVA E3D elements have an Orientation attribute, e.g. SITE, ZONE, EQUI, SUBE, STRU, PANE,Primitives, etc.

Orientation in AVEVA E3D is expressed in terms of axes direction, e.g. Y is N and Z is U, meaning that the

element’s Y axis is pointing North and the elements Z axis is pointing Up. Only two axes need to be statedas the third axis direction is know because it conforms to the right hand rule, i.e. in this case X is E.

Axis directions do not have to follow Cardinal directions, they can include one or more angles and directions,e.g. Y is N 45 E, meaning that the Y direction is North 45º East or Y is N 45 E 30 U, meaning that the Ydirection is North 45º East 30º Up. Both valid directions and any direction can be expressed in AVEVA E3Dusing this syntax.

Elements that have a rotation attribute have, essentially, their own axis system which is known as the frameof reference.

For example, the Z axis for a cylinder (CYLI) primitive is along the length of the cylinder. If the Z axis is Upwith respect to its owner, the cylinder is orientated in an ‘upright’ position. In order to place the cylinder horizontally, say with its Z axis pointing in an East/West direction, the orientation of the cylinder would needto be expressed as Y is N and Z is E (and X is D)

As with positioning, orientation is given with respect to its owner and the same rules apply for owningelements that do not have an orientation attribute.

6.3.1 Setting Orientation using Axes

On the discipline tabs, in the Common group, selecting Orientate from the Rotate aboutAxis button options list displays the Orientate form which enables elements that have anOrientation attribute to be re-orientated by modifying its axes directions.

The form displays, by default, the current X and Y axesdirections, the third axes being automatically derived. The topaxis option list contains X and Y and the bottom axis option listcontains Y and Z. It is, therefore possible to set the requiredaxes using these option lists. If one option list is changed, theother option list and the displayed third axis are updated.

The direction of the selected two axes may be modified byentering a valid direction in the appropriate textbox.

As soon as the Return key is pressed after entering a value,the other two axes are updated.

On opening the form or a new element selected, a ‘bounding box’ is placed around the extremities of theelement and an axes aid placed at the elements origin, whether the element is displayed or not. On enteringa new direction for one of the axis, the bounding box is re-orientated to the new orientation.

Clicking the Apply button re-orientates the element but retains the bounding box and axes aid. Clicking theCancel button removes the aids and dismisses the form.





6.3.2 Setting Orientation using Rotate

Elements may be rotated in AVEVA E3D by using a rotation axis, the position and direction of which are setby the user.

Refer to Chapter 8, Introduction to Model Editor, for details of graphical rotation of elements.

On the discipline tabs, in the Common group, clicking the Rotate about Axis button options list displays theRotate form.

When the form is displayed, a Rotation Axis aid is placed at theorigin of the CE. The aid shows the default direction of the axis andcardinal angle labels show the direction of positive rotation.

The origin of the Rotation Axis may be re-positioned using the Rotate form menus.

The Cursor form menu contains the following options:

Element – this option prompts the user to pick an element in the graphic view. TheRotation Axis is placed at the origin of the picked element.

Design Point – this option prompts for the selection of a Point, i.e. a Ppoint.

Pline – this option prompts for the selection of a Pline on a SCTN or GENSEC.

Edge – this option prompts for the selection of a PANE edge.

Defaults… - this option displays the Cursor Defaults form.

This form enables the way cursor picks are interpreted when a positionis picked in a graphical view.

The Pick Options frame has options to specify how a pick along a

linear item is to be interpreted as a position. The options are:

Snap – (default) the position will be at whichever end of the item isnearest to the cursor. The textbox next to this option is not applicablein the current context.

Proportional – a proportion, between 0 and 1, is entered in theadjacent textbox. The derived position will be at this proportion of theitem’s length from the end nearest to the cursor.

Distance – a distance is entered in the adjacent textbox. The derived position will be at this distancefrom the end nearest to the cursor towards the cursor position. A negative distance will give a positionbeyond the end.

Exact - the position will be exactly at the picked point.





The Pick Qualifier frame has option to specify how many picks will be used to identify the position, andhow a single position is to be constructed from multiple picks. The choices are:

Single pick - the position will be as determined by the Pick Options setting for a single pick.

Mid-point of two picks - each of two picks will be interpreted as determined by the Pick Optionssetting and then the mid-point of the two will be constructed to give the final position.

Centroid of multi-picks - each of two or more picks will be interpreted as determined by the PickOptions setting and then the centroid of the points will be constructed to give the final position.Pressing the Esc key terminates the picking.

Any modified cursor defaults will remain in force for all subsequent picking operations until they arereset.

The Intersection form menu options enable a position to be defined by picking two directional items usingthe cursor in a graphical view.

The derived position will be at the intersection of the two items or, if

they do not actually intersect, at a point on the first picked itemwhich corresponds to the projection of the second item onto thefirst.

The menu and sub-menu options enable any combination of the following types of directional item:

Element - this option prompts the user to pick any element which has its principal axis pointing throughor towards the required position.

Design Point - this option prompts the user to pick any design point, which is aligned through or towards the required position.

Pline - this option prompts the user to pick any Pline which is aligned through or towards the required

position.

Edge - this option prompts the user to pick any PANE edge which is aligned through or towards therequired position.

If the Rotation axis position is set using one of the methods described above, the Rotate form automaticallyupdates the co-ordinate information. The co-ordinates may be edited or set manually by entering values inthe appropriate axis textbox.

Having positioned the Rotation Axis, its direction may be set by entering a direction in the Directiontextbox. If necessary, the WRT (with respect to) textbox may be used to identify the element whose axissystem is to be used as the reference.

The required rotation angle is entered in the Angle textbox. The entry may be positive or negativedepending on the rotation direction required.

A different element may be selected for rotation position by using the pull-down at the top of the form.

CE – this option uses the CE as the element to move.

Collection – this option uses the elements in the current collection. All elements in thecurrent collection are re-positioned.

Pick – this option allows elements to be selected from the 3D View. With this option the Apply buttonmust be clicked before picking the elements. Once all elements are picked, pressing the Esc keymoves the elements.

Clicking the Apply button on the Rotate form rotates the selected element(s). Clicking the Apply buttonagain will rotate the element(s) again.





Exercise 4

Setting Up the Exercise

Clear the Drawlist, then click Training Setup button in the Training group on the TOOLS tab to display the

Training Setup form.

Select the Foundations tab, then click the Delete TRA.SITE and add MESS Site checkbox.

Click the Apply button and close the form.

Select the EQUIPMENT discipline from the Quick Access Toolbar .

Empty the Drawlist and add back TANK 1.

Set the viewing direction to Iso 3.

The SITE TRA.SITE has been deleted and the SITE TRA.SITE.MESS added to the databases anddisplayed in the 3D View. The SITE has been modified to introduce some design errors which may begrouped into three categories:

Size errors - some primitives have one of their size attributes incorrectly set. The task is to identifywhich attribute is wrong and correct its value.

Positional errors - equipment items are incorrectly positioned or primitives are incorrectly positioned

within the equipment. The task is to correctly position the equipment and the primitives.

Orientation errors - equipment items or primitives within an equipment are incorrectly orientated. Thetask is to correctly orientate equipment and primitives. Note: All equipment and primitives should beorientated on an orthogonal axis.

TRA.MESS.SITE showing Design Errors





The following is a list of the Design errors for each piece of Equipment:

TANK1

The equipment Orientation should be Y is North and Z is Up with respect to the World.

CYLI1 – the Position should be at Up 1500mm with respect to its owner.

BOX1 – the Ylength attribute should be 2850mm.

TANK2

CONE1 – the Dtop attribute should be 1500mm.

CYLI1 – the East position should be 2600mm with respect to the World.

PYRA2 – the North position should be 0mm with respect to its owner.

PYRA1 – the Up position should be the same as Pyramid 2.

NOZZ TANK2-N2 – the nozzle must be re-orientated by 90º.

PUMP1

The equipment Up position should be 350mm with respect to the World.

The drive shaft cylinder, CYLI1, must be re-orientated by 90º.

DISH2- must be connected to the motor cylinder.

TANK1 Corrections

1. Make TANK1 the CE

2. In the Common tab, select Orientate from the Rotate about Axis button options list to display theOrientate form. Note that the wrt textbox shows /*, i.e. the orientation is expressed with respect to (wrt)the World (/*). Change the Y setting from E 45 N to N and press the Return key. Note that the boundingbox rotates. Also note that X changes to E and Z changes to U, i.e. the orientation of the equipment isnow Y is N and Z is U. Click the Apply button to rotate the equipment and then the Cancel button.

3. Expand the TANK1 element in Model Explorer and make CYLI1 the CE. In the Common tab click thePosition Explicitly button to display the Explicit Position form. Note that the position is expressedwith respect to the World. Enter owner in the wrt textbox and press the Return key. Note that the wrttextbox has changed to /TANK1, i.e. the owner of the cylinder, and the co-ordinates have changed toexpress the position with respect to the equipment. Enter 1500 in the Up text box and press the Returnkey. Note that the bounding box has changed position to the new location. Click the Apply button to re-position the cylinder and then click the Cancel button.

4. Right click BOX1 of TANK1 in Model Explorer and select Attributes... from the pop-up menu to displaythe Attributes form. Note that the Ylength attribute value is currently 6000mm. Double click on the Ylength value cell to edit it, enter 2850 and press the Return key. Note that the Ylength value hasbeen updated and the cell is highlighted cyan. The Ylength of BOX1 is now the correct length.

Tank 2 Corrections

5. Make CONE1 of TANK2 the CE. On the Attributes form, change the Dtop value of 4000mm to thecorrect value of 1500. The cone has now changed to its correct shape.

6. Make CYLI1 of TANK2 the CE. In the Common tab click the Position Explicitly button to display theExplicit Position form. Note that the position is expressed with respect to /TANK1. Enter world in the

WRT textbox and press the Return key. The coordinates will change to be with respect to the World.Enter a value of 2600 in the East textbox and press the Return key. Note that the bounding box haschanged position to the new location. Click the Apply button to re-position the cylinder but do not closethe form.





7. Make PYRA2 of TANK2 the CE. On the Explicit Position form, select CE from the Select form menu.Note that the position is expressed with respect to the World. Enter /TANK2 in the WRT textbox andpress the Return key. Note that the co-ordinates change to be expressed with respect to TANK2. Enter 0 in the North text box and press the Return key. Click the Apply button to re-position the pyramid andthen click the Cancel button.

8. With PYRA2 still as the CE, note that the Position Z value is 625mm, i.e. Up 625. Make PYRA1 of TANK2 to make it the CE. Modify the Position attribute to be E 0mm N 0mm U 625mm.

9. Make NOZZ TANK2-n2 the CE. In the Common group, click the Rotate about Axis button to displaythe Rotate form. Select Cursor > Element from the form menu and graphically pick the nozzle. Notethat the rotation axis is displayed at the origin of the nozzle and the rotation axis origin co-ordinates anddirection, with respect to itself, are displayed on the Rotate form.

10. Change the Rotation Axis direction to Up by entering U in the textbox and pressing the Return key.Note that the graphical aid is now pointing in the Up direction and the 0/90/180/270 text aids areshowing the direction of positive rotation. Enter a value of -90 in the Angle textbox and press theReturn key. Click the Apply button to rotate the nozzle. Note that the nozzle has rotated to the correctposition, i.e. it now mates with the flange on the connecting pipe. Click the Cancel button to close theform.

PUMP1 Corrections

11. Make PUMP1 the CE. In the Common group, click the Position Explicitly button to display theExplicit Position form. The co-ordinates of the pump origin are expressed with respect to the World.Enter a value of 350 in the Up textbox and press the Return key. Note that the bounding box haschanged position to the new location. Click the Apply button to re-position the pump and then click theCancel button to close the form.

12. Zoom in to the pump. Make CYLI PUMP1-CYL2 the CE in Model Explorer. In the Common group, clickthe Rotate about Axis button to display the Rotate form. Select Cursor > Design Point from the form

menu. Click and hold down the left mouse button on the CYLI and note that the element is outlined inred and three ‘dots’ are displayed, one at each end and one in the centre of the cylinder. These are the

cylinder’s Ppoints.

13. Move the pointer over the central ‘dot’ and note that the pointer display changes as it is moved over the‘dot’ and the Ppoints identity is displayed in the prompt area at the bottom of the screen. When thepointer has changed, release the left mouse button to display the rotation axis at the centre of thecylinder. Enter S in the Direction textbox and press the Return key to change the rotation axisdirection. The Angle textbox should still have -90 displayed. If not, enter a value of 90 in the Angletextbox. Click the Apply button to rotate the cylinder and then click the Cancel button to close the form.

14. Zoom out and locate DISH PUMP1-DISH2 and make it the CE in Model Explorer. The dish needs to beplaced at the end of CYLI PUMP1-CYL5 of the pump to complete the representation of the pumpmotor. Manipulate the displayed elements such that PUMP1-DISH2 and PUMP1-CYL5 can both be

viewed as closely as possible.

15. In the Common group, Click the Position Relatively By button to display the Position By form. ThePositioning Control form is also displayed. On the Positioning Control form select Ppoint as thepick type and Snap as the pick method. Click and hold down the left mouse button on PUMP1-DISH2and move the pointer over the centre of the flat face of the dish to highlight a Ppoint. When the pointer display changes, release the mouse button. Note that a Measure Distance Star t text aid is displayed atthe Ppoint location. Click and hold down the left mouse button on CYLI PUMP1-CYL5 and move thepointer over the centre of the cylinder face closest to the dish to highlight a Ppoint. When the pointer display changes, release the mouse button. Note that a New Position text aid is displayed at thePpoint location and an aid line, showing the measured distance is displayed from the dish Ppoint to thecylinder Ppoint. Also note that measured value has been placed in the relevant text box on the PositionBy from, i.e. West 4567. Click the Apply button on the Position By form to re-position DISH PUMP1-DISH2. Click the Cancel button to close the form.





The corrected model elements should now look like this:




CHAPTER 7

7 General Utilities

This chapter describes various general utilities that are useful when working with AVEVA E3D.

Other utilities, i.e. User Grid Systems, Mass Properties and Standard Model Library are detailed inTM-1802 AVEVA Everything3D™ Model Utilities training guide.

7.1 Collections

Collections are collections of elements that exist in the project databases. A collection can be used toperform an action on all of the elements in the list, either from the Collections form or from other forms, e.g.

Position By and Rotate.

Collections also enable the user to view data in a grid format which can have additional columns displayedand may be sorted, filtered, printed or exported to Excel.

Collections are persistent between sessions and disciplines and some collections are persistent betweenmodules, enabling a collection generated, for example, in Model to be used in Draw. Shared collections maybe accessed by all project users.

7.1.1 The Collections Form

The Collections form is displayed by clicking the Collections button in the Common group or on theHOME tab in the Search group.

The Collections form consists of two parts. The upper partdisplays the available collections under three categories whichdisplay their contents as a tree structure.

The lower part of the form displays the contents of a selectedcollection in a grid.





7.1.2 System Collections

System Collections consist of the Drawlist, the Claimlist andthe Current Selection, i.e. the graphical selection.

System Collections are generated automatically and update

dynamically, e.g. if an element is added or removed from theDrawlist, a new graphical selection created or a new elementclaimed or unclaimed, the collection contents update immediately.

Expanding the System Collections displays the three availablecollections. Clicking on one of the collections displays its contents,if any, in the grid.

Right clicking in the grid displays a context sensitive pop-up menu:

The options available depend on the collection and element type.The 3D View option has a sub-menu which has the samefunctions as the Model Explorer pop-up menu for adding or removing elements from the Drawlist.

The Navigate To option navigates to the element in the ModelExplorer and makes it the CE.

7.1.3 Shared Collections

Shared Collections are stored in Group Set (GPSET) elements owned by Group World (GPWL) elementsand are persistent across modules.

Right clicking on Shared Collections displays a pop-up menuwith one active option. The New option has a sub-menu which

enables a new category to be created.

Clicking the New Category option creates a GPWL namedNew_Shared_Category<n>, where <n> is a sequentialnumber.

The new category is displayed in the Shared Collections.

Right clicking on the newly created category displays as pop-up menu with three active options.

The New option has a sub-menu which enables another newcategory to be created or a new collection to be created.

Clicking the New Collection option creates a new GPSETnamed New_Shared_Collection<n>, where <n> is asequential number.

The new collection is displayed below the category in SharedCollections.





Clicking the Delete option deletes the category.

Clicking the Rename option enables the category name to be edited to a more descriptive name.

Right clicking on a collection displays a pop-up menu which

enables the user to add or remove the contents of the collectionto/from the 3D View, create a New Collection, Rename acollection or Delete a collection.

The Add CE To Collection option adds the current element tothe collection and displays the element in the grid below.

The Add CE Members to Collection adds the members of thecurrent element, if any, to the collection and displays them inthe grid below.

Elements may be added to the collection by dragging anddropping from the Model Explorer into the grid or over collectionname.

Clicking the Edit Scope Selection option in the SharedCollections pop-up menu displays the ExpressionEditor form.

This enables an expression to be associated with ashared collection to dynamically update the contents of the collection.

For example, For example if the expression was set asALL PIPE, the collection would be automatically

populated with all of the PIPE elements contained withinthe MDB. Other example expressions are:

ALL PIPE WITH PSPEC EQ /A3B - would add all pipes inthe MDB of the Spec A3B.

ALL PIPE WITH PSPEC EQ /A3B AND BORE GT 80mm- would add pipes with spec A3B and a bore greater than80mm.

Once the expression is entered, clicking the Evaluatebutton populates the Results list with all elements that

meet the criteria in the MDB.

Clicking the OK button adds the results to the collectionfor which the expression has been set.

If elements that comply with the expression are added or deleted to the scope covered by the expression then thecollection contents will be dynamically updated.

The expression can be removed from the collection byopening the Expression Editor form, deleting theexpression and clicking the OK button.

The contents of the collection created by the expressionare deleted from the collection.





Collections may contain a mixture of elements added via anexpression, which are dynamically updated, and elements that

have been added by manual methods.

In the Collections form grid, elements added manually aredisplayed in normal text whilst items added via the expression aredisplayed in italic text.

7.1.4 My Collections

My Collections are similar to Shared Collections except that they

are not stored in the database and cannot be viewed by other users.

My Collections are persistent across sessions and modules for the user who created them.

My Collections have the same functionality on right click menusto that described previously for Shared Collections except that ascope selection expression cannot be applied to a collection.

My Collections are also used to display Search Results, see section 7.2 for details.

7.1.5 Working with Collections

Elements may be copied from any collection using the grid rightclick menu and pasted into any other collection with exception of System Collections.

Similarly, elements may be cut from any collection with theexception of System Collections.

Double clicking on any collection name makes it the CurrentCollection which is indicated by a blue asterisks displayed next

to the collection name.

Clicking the Show Current Collection link label restricts the list of collections displayed in the upper part of the form to the currentcollection.

This is reciprocated with a Show All Collections link label.





On the Model Explorer pop-up menu the Add To Collectionsoption adds the element to the Current Collection.

The Add Members to Collections options creates an newcollection under My Collections named Elements and adds themembers of the element to the collection.

Whilst elements can be dragged and dropped from ModelExplorer into existing collections, as described previously,dragging an element into the My Collections area, in between or below any existing collections, display a red line.

Dropping the element at this position creates a new collectionnamed New Collection<n>.

This function is only available in My Collections.

Entering a valid command in the textbox in the upper part of theform and clicking the Action button applies the command to allelements in the list.

7.1.6 The Collections Grid

Right clicking in the column header area of a collections griddisplays the Collections Grid pop-up menu.

The menu is context sensitive and certain options are not availablefor certain collections. For example, Clear Grid is not available for

System Collections.

The Collections Grid pop-up menu has the following options:





Column Setup – this option displays the Column Setup form which enables columns to be added to or deleted from the results grid and the columns to be re-ordered.

Clicking the Add Column link label displays anew line in the column grid.

Any valid attribute or expression may be entered into the Expression column. An options list displaysall standard attributes and UDAs. If the grid contains mixed element types then the options list containsa union of all attributes.

Column header text may be entered in the Heading textbox and the Visible checkbox determines if thecolumn will be displayed or hidden in the grid.

The Add Standard Attributes link label adds all of the standard attributes and UDAs for the elementsin the collection. If there are mixed element types then a union of all attributes is added. If the collectionis empty only LOCK and OWNER attributes are added.

The Delete Selected Columns link label deletes columns selected in the Column Setup grid.

The up and down arrow buttons at the top right hand side of the form enable selected columns to berepositioned in the grid. Clicking the OK button after completing the column setup changes theCollections form grid immediately.

Clear Grid – this option clears removes all the elements in the grid.

Sort – this option toggles column sorting. If enabled, columns may be sorted alpha-numerically, either ascending or descending, by clicking on the column header. An arrow is displayed in the columnheader to show that is sorted and the direction of the sort. Only one column may be sorted at a time.

Column Summaries - this option toggles column summaries. If enabled, columns that contain numeric

data that have units may be summarised and a Units button and Summary button are displayed in thecolumn header. Columns that contain numeric data that have no units only have the Summary button.

Clicking the Units button displays an options list of available units.

Selecting a different unit from the default displays the data in the column asthe selected unit and changes the column header text.





Clicking the Summary button displays the Select Summaries form.

One or more summary types may be selected byclicking the appropriate checkboxes and thesummaries are displayed at the bottom of the

column.

Grid cells where the element has no value for theattribute are filled in red.

Grouping – this option toggles group sorting. If enabled, the Grid sort area is displayed above thecolumn headers. One or more column headers may be dragged into this area to group the grid data by.

Multi Select Filter – this option sets the method of displaying filter options. One or more grid columns

can be filtered by a selectable filter.

With the Multi Select Filter on, clicking the downarrow button in the filter textbox displays a filter menu.

Selecting the Text Filters option displays asubmenu with filter options.

Selecting one of these options displays aCustomer Filter form where the user canconstruct advanced filters.

With the Multi Select Filter off, clicking the Filter button on the filter textbox displays a menu of available filters.

Having made a selection, the appropriate filter value may be entered in the textbox.

Suppress Unset – this option toggles the suppression of unset attribute values. If this option enabledattribute values that are set to unset are not displayed.

Suppress Nulref – this option toggles the suppression of attributes with a null reference. If this optionis enabled attribute values that have a null reference (Nulref ) are not displayed.

Find and Replace – This option displays the Find and Replace form.

Refresh Grid – this option refreshes the grid.

Quick Report – this option displays the Quick Report form which enables a report to be generated inReport Designer.





Refer to TM-1803 AVEVA Everything3D™ Reporting training guide for details of Quick Reportsand Report Designer.

Export to Excel – this option displays the Save As form which enables the contents of the grid to besaved as a .xls file at a selected location.

Print Preview – this option displays the Print Preview form which enables the table contents to beprinted.

7.1.6.1 Editing Attributes in the Grid

Collection grid entries may be edited to change the value of modifiable standard attributes and UDAs.

Double clicking in a grid cell of a modifiable attribute opens the cell for editing.

Successful edits are highlighted in cyan whilstunsuccessful edits are highlighted in red.

If a cell contains a value and an unsuccessfuledit is made, the value returns to its previoussetting.

Values may be copied from one cell using the right click menu Copy options when editing the cell or byusing Ctrl + C key standard functionality.

A copied values may be pasted into single cells using the right click menu Paste option when editing thecell or by using Ctrl + V key standard functionality.

A copied value may be pasted into multiple cells by selecting the required target cells and using Ctrl + Vfunctionality. The right click menu paste option is not available.

Care should be taken when bulk editing attributes using collections grid as unexpected results may beobtained.

7.2 Search

The Search utility enables the databases to be searched for specific items. The scope of the search may bedefined and the items may be identified by different criteria including name, type, attributes or anycombination of these.

In the Common group, clicking the Search buttondisplays the Search form.

The Search button is also available from the Searchgroup on the HOME tab.

The form is displayed in a ‘basic search’ mode whichhas the following functions:

The items to be searched for may be specified by names that contain a specific string, one or more elementtypes or a combination of both.

A string may be entered in the Name Contains textbox. The string may be of any length and contain anypermissible name character. The names are case sensitive.

An element type must be entered in the Element Types textbox. By default [ALL] is displayed which willfind all element types for the search.





One or more item types may be entered in the Element Types textbox. If more than one item type isentered they must be separated by a space, comma or semi-colon, e.g. EQUI PIPE, NOZZ; TEE. Theentries may be any valid element type and are not case sensitive.

The Scope options list sets the ’ceiling’ for the search, i.e. an element or collection which willbe searched for the specified elements.

Selecting Current Element will display the CE in the adjacent textbox and updates automatically if a newCE is selected.

The Element option enables an element name, with the leading forward slash, to be entered into thetextbox. The entry does not change if a new CE is selected.

The Current Collection option searches the current collection for the specified elements.

Having made appropriate entries, clicking the Search buttoninitiates the search.

The time taken to complete the search will depend on theamount of data in the scope and the number of elements beingsearched for.

The results of the search are displayed in a collection namedSearch Results under My Collections.

Search Results is the same as any other My Collection, refer to section 7.1.4, and all collections functionality applies to it.

If the same search or a new search is subsequently run, theexisting Search Results collection will be overwritten by thenew search unless the collection is renamed.





7.2.1 More Search Tools

Clicking the More Search Tools link label displays theform in ‘advanced search’ mode. This enables thesearch scope to be refined, attribute and free filters to

be applied and searches to be managed.

The form opens by default with the Search Scope fold-up panel open.

The In Volume checkbox enables the search to bespecified within a volume rather than using an elementor collection for the ‘ceiling’ of the search.

There are two methods to define the limits of the searchvolume if the checkbox is checked.

The Of Element option enables an element name to beentered in the combo box. Making an element the CE in

Model Explorer and clicking the CE button displays thecurrent element name in the combo box.

Previously selected elements in the current session areavailable in the combo box and the list may be clearedby selecting the Clear History option.

The Explicit Volume option enables a volume to beexplicitly specified by entering Lower and Upper co-

ordinates for opposite corners of a volume box.

The Wholly Within and Wholly & Partially radiobuttons function, as described previously for Fence

Selection in section 5.2.1.2, and applies to bothvolumetric search options.

The Modified checkbox restricts the elements beingsearched for to those modified in the current session.

7.2.1.1 Attribute Filters

Attribute Filters provide a method of filtering thesearch criteria by specifying restrictions to one or moreattributes.

Expanding the Attribute Filters fold-up panel enables afilter to be added by clicking the Add Filter link label.

By default the new attribute filter is NAME, however,clicking in the Attribute cell enables a valid attribute or UDA to be entered.

Opening the options list in the Attribute cell displays an all standard attributes and UDAs.

If more than one element type is being searched for the options list contains a union of allstandard attributes and UDAs.





Opening the options list in the Operator cell displays the filter options that may be used.

After selecting a filter the filter value may be entered in the Value cell.

More than one filter can be applied.

Filters may be deleted by selecting them in the left hand column and clicking the DeleteFilter link label.

7.2.1.2 Free Filter

A Free Filter enables any valid PML 1 expression to beused as a filter.

Expanding the Free Filter fold-up panel displays atextbox where the free filter is entered.

PML 1 expressions such as HBOR EQ 50mm, PSPEC NE /A3B or DRNS NE U OR DRNS NE D may beused. The filter may be removed by deleting the expression from the text box.

7.2.1.3 Managed Searches

The Managed Searches fold-up panel enablesregularly used or complex searches to be saved for later use.

Expanding the Managed Searches fold-up panelenables a search to be saved based on the currentsearch criteria.

Clicking the Create “Saved Search” Based on Current SearchCriteria link label displays the Create Saved Search form.

Entering a suitable name in the Name textbox activates the OK buttonand clicking the button saves the search, including element type andscope definition.

After searches have been saved they may be selectedfrom the options list. Clicking the Search button runsthe current saved search.

When saved searches have been defined the DeleteSelected Saved Search link label becomes active and

clicking it deletes the current saved search.





7.3 Session Units

Session Units enable the user to display the output of values on forms and input values in forms in a unitother than the system units. For example, AVEVA E3D works internally in millimetres, however, distanceand bore input and display units can be modified to suit the user during a session.

Attribute values are stored in databases in the system units and are converted on input and output to thecurrent session units.

On the PROJECT tab, selecting Options >Systems > Units displays the Session Units form.

The left pane of the form displays a list of theavailable unit types that can be modified and their current setting.

Clicking on a unit type in this list displays a list of theavailable session units in the pane to the right. Thecurrent unit is denoted by the notation > unit <.

Clicking one of the other available units and thenclicking the Set <unit type> Unit button, where<unit type> is the selected type, makes the selectedunit the current session unit for that type andupdates the left pane list.

By default, Distance units are metric whilst other unit types have a mixture of metric and Imperial units torelevant to industry practice. For example, Bore has Millimetres and Inch available. Some unit types, e.g.Current, Voltage and Impedance have only one unit available.

Imperial distance units can be made the default by including a UNIT element in a Catalogue database.

The Save / Restore frame enables the current session units to be set to current project defaults and savedand restored by clicking appropriate button.





7.4 Measuring

AVEVA E3D provides utilities for measuring linear distances and angles for elements displayed in a 3Dview.

On the discipline tabs, in the Common group, the Measure Distance button has an options

list the enables distances and angles to be measured.

Both measuring utilities are used in conjunction with the Positioning Control form.

7.4.1 Measure Distance

Clicking the Measure Distance button displays the Measure Distanceform and activates the Positioning Control form.

The Units frame enables the user to specify the units the measureddistance will be displayed in. The Unit Type options list has threeentries, Default, Metric and Imperial.

Selecting Default displays the distance values in the current sessionunits whilst selecting Metric or Imperial activates the Display Unitsoptions list.

If Metric is selected the user can choose from Millimetres,Centimetres and Metres for the display units.

If Imperial is selected the user can choose from Inches, Feet & Inchesand Feet (decimal feet) for the display units.

The prompt ‘Measure distance start (Snap) Snap:’ will be displayed inthe prompt area of the 3D view.

The prompt will change depending on the pick method setting onthe Positioning Control form, e.g. ‘Measure distance start (Mid-Point) Snap:’

Picking the first measure point displays an aid text Measure distancestart at the selected point and the prompt changes to ‘Measuredistance end (Snap) Snap:’

Picking the second measure pointdisplays the ‘true’ distance and the X,Y and Z components with aid linesand text in the 3D View.

These values are also displayed onthe Measure Distance form with theaddition of the direction between thefirst measure point and secondmeasure point.





The direction and offsets are expressed, by default, with respect to the World co-ordinate system. They maybe expressed in terms of another frame of reference by entering a named element, CE, Owner or dbreference no. in the wrt textbox on the Measure Distance form.

Once a measure distance task is performed, the form will remain active, enabling other distances to bemeasured, until the form is closed.

7.4.1.1 Using Graphics Picks

The graphics in the 3D view may also be used to derive points for measuring. Selecting pick type Graphicson the Positioning Control toolbar enables the graphics to be used with any of the pick methods.

Clicking and holding the left mouse button over an element in the 3D view highlights the edges of theelement and displays a graphics cursor. Moving the cursor over the element(s) changes the cursor shapedepending on what is ‘below’ the cursor at the time, for example a surface, a corner or an edge.

Surface Corner Edge

7.4.2 Measure Angle

Selecting the Angle entry from the Measure Distance button options listdisplays the Measure Angle form and activates the Positioning Control

form.

The prompt ‘Measure angle root of angle (Snap) Snap:’ is displayed.

The prompt will change depending on the pick method setting on thePositioning Control form.

The root of angle is the centre point of the angle.

Picking the root of angle point displays an aid text Measure angle rootof angle at the selected point and the prompt changes to ‘Measureangle first point (Snap) Snap:’





Picking the first measure point displays an aid text Measure angle firstpoint at the selected point and the prompt changes to ‘Measure angle

second point (Snap) Snap:’

Picking the second measure pointdisplays the angle with aid lines andtext in the 3D View.

These values are also displayed onthe Measure Angle form with theaddition of the directions between theroot of angle point and the f irstmeasure point and second measurepoint.

The measured angle is expressed, bydefault, with respect to the Worldcoordinate system. The measuredangle may be expressed in terms of another frame of reference by enteringa named element, CE, Owner or dbreference no. in the wrt textbox on theMeasure Angle form.





7.5 Saving and Restoring Views

Views may be saved and restored by clicking the Save & Restore View button in the Manipulate group of the 3D VIEW tab to display the Save & Restore View form.

7.5.1 Saving Views

The Current Directory frame displays the path anddirectory where the stored views will be saved.

Clicking the Select Directory button to the left displays theBrowse for Folder form were a directory may be found bybrowsing.

Entering a suitable name in the New View textbox in theSave Current View frame and clicking the Save CurrentView button to the right of the textbox saves the currentview in the specified location.

The saved view is displayed in the Saved Views frame andthe save time and date displayed below.

The saved view name is also displayed in the View optionslist in the Saved Views frame.

The view is saved as three files that are stored in thespecified directory. The three files contain the viewingenvironment, Drawlist information and a view image.

The files are named using the format module-project-

MDB-<file type>-view name.

If another view is saved with the same name aconfirmation message is displayed.





7.5.2 Restoring Saved Views

Restoring saved views may be achieved in three ways using the buttons on the Save & Restore View form.

Restore View – if there are existing elements in the current 3D view, the Drawlist is emptied and theDrawlist contents and view settings from the selected saved view are restored.

Add to Drawlist - The Drawlist content of the selected saved view is added to the Drawlist of thecurrent view. The view settings, i.e. direction, scale, etc., are not changed to the saved view settings.

Replace Drawlist - The Drawlist content of the selected saved view replaces the Drawlist of thecurrent view. The view settings, i.e. direction, scale, etc., are not changed to the saved view settings.

7.5.3 Deleting Saved Views

Saved views may be deleted using the buttons on the Save & Restore View form:

Delete Saved View – this option deletes the saved view named in the Save Name option list. Aconfirmation message is displayed:

Delete All Saved Views- this option deletes all saved views. A confirmation message is displayed:





7.6 Claimlists in Multiwrite Databases

Where Multiwrite databases are used, the modification of elements in the databases is controlled by the useof Claimlists which, essentially, stops an element being owned by more than one user at a time and avoidsconflicting data being written to the databases by sequential saves from different users.

Multiwrite databases have a claim mode that is set when the database is created:

If the claim mode is Explicit the element must be claimed before it can be worked on.

If the claim mode is Implicit when a user starts to modify an element it is automatically claimed. In this modean element may also be claimed explicitly.

On the MANAGE tab, in the Active group,clicking the Claimlists button displays theMultiwrite Claim Lists form.

The Claim List options list has two entries:

Active Claimlist – this is the users Claimlist.Lists of all the significant elements claimed bythe user are displayed in the list.

Others Claimlist – the list displays allsignificant elements claimed by all other usersin the MDB, except those in the ActiveClaimlist.

The name of each user is displayed alongside the significant elements and the names are added to theClaim List options list so that an individual user Claim List may also be selected.

Elements are claimed and unclaimed using the form menu options.

The Control menu has the following option:

Update - Updates the list. The list is automatically updated when it is displayed andthe Active Claimlist is updated when elements are claimed using the form,

however, in other cases the list may not show all claimed elements unless thisoption is used.

The Claim menu has the following options:

CE - claims the CE and all the elements below it.

CE Members - claims the members of the CE and all the members below it,but not the CE.

CE only - claims the CE only and not any hierarchy below it.

CE Members only - claims each member of the CE only and not the hierarchy below.

Pick - enables items to be claimed by graphically picking them in a 3D View.

Current Collection – claims the contents of the current collection.





The Unclaim menu has the same options as the Claim menu except that theoptions unclaim instead of claim. The menu also has the following additional

options:

All - unclaims all the elements in the Active Claimlist.

Selected - unclaims all the elements selected in the elements list

The Unclaim menu is only active when there are members in the ActiveClaimlist.

The Colour menu has the follwing options:

Highlight… - displays the Claimlist Colours form. Selecting acolour highlights the elements in the Claimlist in that colour in all3D Views.

Only elements already in the Drawlist are highlighted, elementsare not automatically added to the Drawlist. Different colours maybe used for each Claimlist.

Unhighlight - displays a sub-menu that unhighlights the CE, allElements in the selected Claimlist or All elements in the 3DViews.

The Databases menu has the following options:

MDB - displays all of the claimed elements in the databases inthe MDB.

DBs - the sub-menu displays all databases in the MDB. Selectinga database from the sub-menu list displays all claimed elementsin that database.

Elements must be unclaimed before other users can access them. Other users must do a Get Work beforethey can see the changes. Elements that have been claimed and modified cannot be unclaimed until a SaveWork is performed.

Exiting AVEVA E3D will unclaim all elements.





Exercise 5


Clear the Drawlist, then click Training Setup button in the Training group on the TOOLS tab to display the


Select the Foundations tab, then click the Delete TRA and MESS Sites checkbox.

Click the Apply button.

Whist in the Training Setup form navigate to the Switch User tab.

Enter Current User Password A

Enter New User Name A.STEELMAN

Enter New User Password A

Click the Switch User button then Yes button on the resulting save work confirmation message. Close the


Select the EQUIPMENT discipline from the Quick Access Toolbar .

Collections

1. Empty the Drawlist and add the following SITEs to the 3D view:

SITE-EQUIPMENT-AREA01

SITE-CIVIL-AREA01

SITE-PIPING-AREA01

SITE-ELECTRICAL-AREA01

SITE-STRUCTURAL-AREA01

2. Set the view direction to Iso3 and click the Zoom to Drawlist tile.





3. In the Common group, click the Collections button to display the Collections form. Expand SystemCollections and click on the Drawlist entry to populate the collections grid with the Drawlist contents.Click on the Type column header to sort the grid in ascending order by element type.

4. Multi select the first six BRAN elements in the grid, i.e. all 100-B-1 branches Right click in the grid andselect 3D View > Remove from the pop-up menu. Note that the pipe branches have been removed

from the grid and from the 3D View. Add the entire SITE-PIPING-AREA01 back to the Drawlist andnote that the six branch elements have been added back to the grid.

5. Minimise System Collections and expand Shared Collections on the Collections form. Note thatthere are two categories in this section. Right click on Shared Collections and select New > NewCategory from the pop-up menu to create a new category named New Shared Category 1. Right clickon the new category, select Rename from the pop-up menu and enter Area01 Equipment to renamethe category.

6. Right click on the Area01 Equipment category and select New > New Collection from the pop-upmenu to create a new collection named New Shared Collection 1. Rename the new collection to AllProcess and Electrical Equipment.

7. Navigate to ZONE-ELECTRICAL-AREA01 below SITE-ELECTRICAL-AREA01 in Model Explorer to

make it the CE. Right click on collection All Process and Electrical Equipment and select Add CEMembers To Collection from the pop-up menu. Note that the Electrical equipment elements havebeen add to the collection grid.

8. Right click on the collection again and select Edit Scope Selection from the pop-up menu to displaythe Expression Editor form. Enter ALL EQUI WITH OWNER EQ /ZONE-EQUIPMENT-AREA01 in theExpression textbox and click the Evaluate button. Note that all of the process equipment elements inthe ZONE have been added to the form list.

9. Click the OK button on the Expression Editor form and note that the process equipment element havebeen added to the collection and that they are displayed in italics, indicating they have been added by aScope Selection rule.

10. Multi-select the process equipment elements from the grid and remove them from the 3D View usingthe grid pop-up menu. Reselect some of the process equipment elements in the grid and add themback to the 3D View using the grid pop-up menu. Add the remaining process equipment elements to the3D View using the same method.

11. Create a new shared collection named All Sections and add all SCTN elements from ZONE-STRUCTURAL-AREA01 to the collection using a Scope Selection expression of ALL SCTN WITHZONE EQ /ZONE-STRUCTURAL-AREA01.

12. Click the Name column in the grid to sort the SCTN names so that the element named C3 is at the topof the grid. Note that most SCTN elements have system names. Multi-select all explicitly namedelements, i.e. C3 to K7 inclusive, right click in the grid and select Copy from the pop-up menu.

13. Right click on My Collections in the Collections form and create a new collection, leaving the name asthe default. Right click on the new collection and select Paste from the pop-up menu to paste theselected SCTN elements into the collection grid.

14. Right click on a column header and select Column Setup from the pop-up menu to display the ColumnSetup form. Click the Add Column link label to create a new column entry and enter MATREF in theExpression cell and Material in the Heading cell.

15. Click the Add Column link label again to create a new column and enter CUTL in the Expressioncolumn and Cut Length in the Heading column. Create one more column using NWEI and NettWeight in the Expression and Heading columns respectively. Click the OK button on the ColumnSetup form and note that the columns have been added to the grid.

16. Double click in the Material cell of the first row of the grid to enable editing. Enter GR275 in the cell andclick out of the cell. Note that the cell value has been changed and is highlighted in cyan. Double clickin the same cell again and then right click and select Copy from the pop-up menu. Double click in thenext Material cell in the grid to enable editing and then right click and select Paste from the pop-menu.





17. Multi select the remaining rows and press Ctrl + V to change the material reference for the other elements.

18. Click the Units button in the Cut Length column header and select different units from the pop-up menu.

19. Open the Column Setup form again, multi-select the three added columns and select Delete SelectedColumns link label and click OK to Close the Collections form.

Search

20. In the Common group, click the Search button to display the Search form. Make SITE-PIPING-AREA01 the CE in Model Explorer and select Current Element from the options list on the Searchform. Enter BRAN in the Element Type textbox and click the Search button. The Collections form isdisplayed with a new collection named Search Results.

21. On the Search Results collection add two new columns using BRWEI (Branch Weight) and CLLE(Branch Centreline Length) as the expressions. Now close the Column Setup form by clicking OK.

22. On the Search form select the More Search Tools link label and expand the Attribute Filters fold-uppanel, click the Add Filter link label to create a new filter. Enter HBOR in the Attribute column, select

Greater than from the Operator column and enter 50mm in the Value column. Minimise the AttributeFilters fold-up panel. Click the Search button to replace the existing Search Results collection. Note

the values in the weight and centreline columns.

23. Right click in a Search Results collection column header and select Quick Report from the pop-upmenu to display the Quick Report form. Select A4-Portrait from the Layout Templates list and whenthe template is shown, click the Open button. Click the Yes button on the subsequent questionmessage to display a report preview in the Quick Report Designer window. Close the window.

24. Minimise the Search Scope fold-up panel and expand the Managed Searches fold-up panel. Clickthe Create “Saved Search” Based on Current Search Criteria link label to display the Create SavedSearch form. Enter BRAN with Hbor gt 50mm in the Name textbox and click the OK button. Note thatthe named is displayed in the options list.

25. Create a new search and save it under an appropriate name. Select the BRAN with Hbor gt 50mmfrom the options list and click the Search button. Note that the search has been executed as before.Close the Search form.

Click Training Setup button in the Training group on the TOOLS tab to display the Training Setup form.

Enter Current User Password A

Enter New User Name A.EQUIPMAN

Enter New User Password A

Click the Switch User button then Yes button on the resulting save work confirmation message. Finallyclose the Training Setup form.




CHAPTER 8

8 Introduction to Model Editor

This chapter introduces the use of the Model Editor for the graphical re-positioning and re-orientation of selected elements.

8.1 Model Editor Mode

Model Editor is a mode of operation in Model that enables selected elements to be re-positioned and re-orientated graphically using the mouse pointer.

Model Editor may also be used to edit Equipment elements and manipulate Piping components. TheseModel Editor functions are outside the scope of this training guide and are explained in the relevant training guides.

Model Editor mode can be invoked by double clicking on an element in a 3D View. This also has the effectof making the clicked element the CE and a graphical selection.

Once in Model Editor mode, clicking on the background of a 3D View removes the Model Editor handle fromthe element but remains in Model Editor mode enabling another element to be picked to display the ModelEditor handle on.

Double clicking on the background of a 3D View toggles Model Editor off .

Model Editor mode may also be toggled on or off by clicking the Model Editor button in the Common groupof the discipline interface. If Model Editor mode is toggled on in this way and there is a graphical selection,the Model Editor handle is displayed on the CE. If there is no graphical selection, picking an element in the3D View displays the Model Editor handle on the picked element.

When in Model Editor mode, the prompt reads ‘Modify:’.

Model Editor mode may be used to manipulate graphicalselections, consisting of either a single item or groups of items.





8.2 The Model Editor Handle

The Model Editor handle is a collection of individual graphical manipulation handlesgrouped together.

The Model Editor handle can be used to dragthe entire graphical selection to a new positionor rotate the entire graphical selection throughan angle about a selected axis.

This combination of direct graphical manipulation handles offers the ability to move selected itemsconstrained in a direction or in a plane, or rotate the selection about an axis.

8.3 Overview of Basic Model Editor Operations

The following section gives an overview of basic Model Editor operations. Details of each operation aregiven later in this training guide.

8.3.1 Movement

A graphical selection is moved using Linear or Planar handles on the Model Editor handle. Dragging aLinear or Planar handle with the mouse pointer moves the current graphical selection. The movement ismade in steps, the size of which is controlled by the Linear Increment. This allows the graphical selection tobe positioned accurately in relation to its original position.

The graphical selection can be moved until it is aligned with another item in the display by using the handlesor by dragging with Feature Highlighting mode switched on.

8.3.1.1 Linear Movement

The Model Editor handle has three Linear handlescorresponding to the cardinal axes, X, Y and Z.

Clicking and dragging one of the three Linear handlesconstrains the movement of the graphical selection to be inthe direction of the selected Linear handle.

8.3.1.2 Planar Movement

The Model Editor handle has three Planar handles corresponding tothe planes made by the cardinal axes, XY, XZ and YZ.

Clicking and dragging one of the three Planar handles constrains themovement of the graphical selection to be in the plane of the two axes

of selected Planar handle.





8.3.2 Rotation

The graphical selection is rotated using a Rotation handle. The selection rotates in angular steps as it isdragged with the mouse pointer, the amount of rotation is controlled by the Rotation Increment. This allows

the graphical selection to be rotated accurately from its original orientation.

The graphical selection can be rotated until an axis of the Locator Handle is aligned with another item in thedisplay by using Locator Handles or by dragging with Feature Highlighting switched on.

The Model Editor handle has three Rotation handlescorresponding to the cardinal axes, X, Y and Z.

Clicking and dragging one of the three Rotationhandles constrains the rotation of the selection to beabout the axis corresponding to the selected Rotationhandle.

8.3.3 Alignment

The graphical selection can be moved or rotated until it aligns witha point, Ppoint, Pline, or an edge in the model.

The target points and lines are called Features. The origin of theModel Editor handle is the reference datum for aligning thegraphical selection.

Feature Highlighting must be on for this option to be available,refer to section 8.4.

8.3.4 Model Editor Handle as a Frame of Reference

The Model Editor handle can be moved or rotated independently of the graphical selection. This allows adatum to be set for movement and alignment operations, or to set an axis of rotation about which thegraphical selection can be rotated.

8.3.5 Feedback

The Model Editor handle changes shape to show movement or rotation constraints. The Linear and Planar handles also change direction depending on which way the handle is being dragged.

Movement and rotation feedback for freehand operations is displayed both in the 3D View and on the statusbar. This allows both world position and displacement from the starting position to be shown.

The distance values are output in the current session units and style. If feature alignment is in use, feedbackis given on features as the mouse pointer passes over them, and graphical feedback is provided to helpachieve the correct alignment in the 3D model.





8.3.6 Unconstrained Positioning

The Model Editor handle provides functions for positioning the graphical selection constrained in a givendirection or in a plane. However, it is sometimes necessary to specify a new position without any constraintsapplied to movement of the graphical selection.

An unconstrained position can be specified by entering World co-ordinates into a form, by typing a 3D offsetfrom the current Model Editor handle position, or by snapping to a Point feature. These functions areprovided from a right click pop-up menu on the Locator Handle.

8.3.7 Undo and Redo

Undo and Redo functions in Model Editor mode allow stepping backwards or forwards through one or moremovement or rotation operations. Undo and Redo operate on a sequence of direct graphical manipulationoperations in the Model Editor.

Undo/Redo operations can also take place outside of Model Editor Mode. If the Undo operation involvesmoving into or out of Model Editing mode, then the switch into that mode happens automatically. Theselection set and handle appropriate to the editing operation that was being used will be restored.

8.3.8 Performance

The speed of interactive selection and dragging operations is dependent on both the specification of thehardware being used, and on the complexity of the model displayed in the 3D View. Generally, it isadvisable to minimise the size and complexity of the displayed model in order to obtain good interactivefeedback from the system.

Performance tips when using Model Editor:

Display only those elements that are necessary for the modification being performed. As the graphicalselection is dragged on the screen the display is continuously redrawn.

Avoid using large graphical selections. It may be better to make bulk moves in small groups.

Avoid drawing the model with high levels of detail. For example, do not display the model with holesdrawn; do not use a fine arc tolerance.

Avoid displaying the model with Ppoints switched on.

8.4 Model Editor Settings

The Model Editor handle colour maybe changed by selecting Options >Model Editor > Handle Colour fromthe PROJECT tab and selecting a

colour from the displayed options.

Feature Highlighting is toggled on and off by checking or unchecking the Feature Highlighting checkboxin the Model Editor group on the 3D VIEW tab.

Alternatively, pressing the F key whilst in Model Editor mode toggles Feature Highlighting on and off.





On the 3D VIEW tab, in the Model Editor group, clicking the Increments button displays the SetIncrements form.

The Linear increment determines the incremental steps when thegraphical selection is dragged using the Linear or Planar handles.

The Fine linear increment determines the fine incremental stepswhen using the up and down cursor arrow keys

The Angular increment determines the incremental steps when thegraphical selection is rotated using the Rotation handles.

When dragging the graphical selection with Model Editor, the element(s) that are being dragged can berepresented in the 3D View in three different ways.

On the 3D VIEW tab, in the Model Editor group, the Drag Image button options list hasthree options that give the following results.

Solid Translucent Wireline

8.5 Positioning and Orientation using the Model Editor Handle

The Model Editor handle provides three ways to move or rotate a graphical selection:

Dragging the Linear, Planar or Rotation handles freehand with the mouse pointer.

Aligning with points, Ppoints, Plines or straight lines (edges) on other displayed items.

Typing in offset distance or angular displacement values.

8.5.1 Aligning the Graphical Selection with Features on other displayed items

When aligning a graphical selection with other plant items in the displayed model, Feature Identification

mode is entered, i.e. the mouse pointer is sensitive to finding features on the Model graphics.

Features are points, straight lines (edges), Ppoints or Plines. Points are located at vertices on the model,such as the corner of a box, and at the mid-point of lines. Lines are straight edges on the model (Design Aidgraphics cannot be used as a feature).

8.5.2 Automatic Scrolling

If the target location for a drag operation is outside of the 3D View, the mouse pointer can be moved to anedge of the view, where the view will pan automatically up, down, left or right according to the 3D view edgethat the mouse pointer hits. The mouse pointer must move in order for the panning to continue. This maynecessitate the user making a small movement of the pointer near to the view edge to keep the pan

operation going.

This technique for panning the view is appropriate for locating a target position that is just out of view.





8.5.3 Linear Handles

The Linear handle allows the movement of the graphical selection to be constrained in the direction of thelinear handle axis. The size of each step of the movement is defined by the current Linear increment.

To initiate a linear drag, click and hold the left mouse button over

one of the linear movement handles. With the left button still held,moving the mouse drags the graphical selection constrained in theselected direction.

As the mouse moves over a linear handle, the pointer symbolchanges to the linear drag pointer and the other handles fade.

8.5.3.1 Moving one Movement Increment at a Time

If the movement increment is small relative to the magnification of the 3D View, it can be difficult to move themouse freehand to a precise displacement from the Model Editor handle's original position.

Finer control over positioning can be achieved by dragging with a Linear handle so that it is close to the

required position then, while continuing to hold down the mouse button, press the plus (+) or minus (-) keyon the numeric keypad. This moves the graphical selection by one Linear increment in the direction of thelinear handle if + is pressed, or in the opposite direction if - is pressed.

8.5.3.2 Linear Handle Feedback

When moving a selection in a constrained direction, theModel Editor handles changes to a single Linear handleto show the direction of movement.

The current World position of the Model Editor handle isdisplayed on the status bar, and an offset distance from

the original position of the handle is displayed on the 3DView.

8.5.3.3 Linear Handle Pop-up Menu

Right clicking on a linear drag handle displays a pop-up menu with thefollowing options:

Enter Value… - this option displays the Move Selection form:

Only the textbox corresponding to the selected axis is activated so that avalue may be entered.

A +ve value will move the graphical selection in the positive axis directionand a –ve value will move the graphical selection in the negative axisdirection.

Clicking the Preview button shows the effect of the entered value and clicking the OK button moves thegraphical selection.





Align with Feature… - this option allows the graphical selection to be positioned in relation to another object on the screen but forces the graphical selection to move along the selected axis. Linear drag canalign with a point feature or a line feature.

Snap to Point… - this option allows the graphical selection to be moved to a Point feature. The graphicalselection is not constrained to move along the direction of the Linear handle.

Move Handle – this option has a sub-menu that enables the Locator handle to be moved independently of the graphical selection, thus changing the datum for the next operation on the graphical selection.

The Enter Value…, Align with Feature… and Snap to Point… sub-menu optionsfunction in the same way as described for moving the graphical selection exceptthey move the entire Model Editor handle.

Cancel – this option cancels the current Model Editor operation.

8.5.4 Planar Handles

Each of the planar movement handles constrains the drag operation such that the graphical selection movesonly in the plane of the selected handle. The handle moves in steps determined by the current MovementIncrement setting.

To initiate a planar drag, click and hold the left mouse button over oneof the Planar handles. With the left button still held, moving the mousedrags the graphical selection constrained in the selected plane.

As the mouse moves over a Linear handle, the pointer symbol changesto the planar drag pointer and the other handles fade.

8.5.4.1 Planar Handle Feedback

A triangle is displayed on the current constraintplane, between the original position of the handleand the current position.

The relative movement distances are shown on thesides of the triangle.

The current World position of the Model Editor handle is displayed on the status bar.

8.5.4.2 Planar Handle Pop-up Menu

Right clicking on a planar drag handle displays a pop-up menu. The options areas described for Linear handle pop-up menu with the exception that the MoveSelection form has two active textboxes corresponding to the selected plane.





8.5.5 Rotation Handles

The rotation handles allows the graphical selection to be rotated around the relevant axis using the currentAngular Increment to control the angular step size.

To initiate a rotational drag, click and hold the left mouse buttonover one of the Rotation handles. With the left button still held,moving the mouse rotates the graphical selection around theselected axis.

As the mouse moves over a Rotation handle, the pointer symbol changes to the rotation drag pointer and the other handles fade. A full circle is displayed showing the rotationplane.

8.5.5.1 Rotation Handle Feedback

The angular movement from the originalorientation is shown as the Rotation handleis rotated.

The angular displacement is also shown inthe status bar.

8.5.5.2 Rotation Handle Pop-up Menu

Right clicking on a rotation handle displays a pop-up menu with the followingoptions:

Enter Value… - this option displays the Rotate Selection About X/Y/Z form:

The Enter value textbox enables a value, in degrees, to be entered torotate the graphical selection around the specified axis.

A +ve value rotates the graphical selection in the positive rotationdirection and a –ve value rotates the graphical selection in the negativerotation direction.

Clicking the Preview button shows the effect of the entered value and clicking the OK button rotates thegraphical selection.





Orient to Point… - this option allows the graphical selection to be orientated in relation to another object onthe screen but forces the graphical selection to rotate only around the selected axis. Rotational drag canalign with a point feature or a line feature.

Align with Direction… - this option allows the graphical selection to be rotated to align with the direction of a plane through a selected feature.





Align with… - this option displays the Enter Direction for X/Y/Z Axis form:

Any valid direction for the specified axis may be entered in the standarddirection format.

The axis selected depends on the relative position of the rotational dragcursor symbol when the right click is made on the Rotation handle, i.e. if it is closer to the X axis the then the direction is specified.

Clicking the Preview button shows the effect of the entered value and clicking the OK button rotates thegraphical selection.

Rotate handle – this option has a sub-menu that enables the Locator Handle to be rotated independently of the graphical selection, thus changing the frame of reference for the next operation on the graphicalselection.

The Enter Value…, Orient to Point…, Align with Direction… and Align with…sub-menu options function in the same way as described for moving the graphical

selection except they rotate the entire Model Editor handle.

The To World option aligns the Model Editor handle with the World co-ordinatesystem, without rotating the graphical selection. The Model Editor handle Y axispoints North, and the Z axis points Up.

Cancel – this option cancels the current Model Editor operation.

8.5.6 Dragging the Model Editor Handle Independently of the Graphical Selection

A Model Editor handle can be moved independently of the graphical selection from the pop-up menus, asdescribe previously, allowing a datum position to be set for subsequent move operations, or an axis of

rotation to be set for subsequent rotation operations.

The Model Editor handle may be also be dragged independently of the graphical selection. Selecting alinear, planar or rotation handle by clicking and holding with the left mouse button down, and then pressingthe H key on the keyboard, detaches the Model Editor handle from the graphical selection.

The H key can be used to toggle between moving the Model Editor handle on its own, and moving thegraphical selection with the Model Editor handle.





Exercise 6


This exercise corrects the errors on the SITE TRA.MESS.SITE, as carried out in Exercise 4, except that

position and orientation errors will be corrected using the Model Editor.

Clear the Drawlist, then click Training Setup button in the Training group on the TOOLS tab to display theTraining Setup form.

Select the Foundations tab, then click the Delete TRA.SITE and add MESS Site checkbox.

Click the Apply button and close the form.

Empty the Drawlist and add back TANK 1.

Set the viewing direction to Iso 3.

TANK1 Corrections

1. Double click TANK 1 to enter Model Editor mode anddisplay the Model Editor handle at the origin of theequipment.

2. Left click and hold on the Rotation handle that rotates theequipment around the Z axis and move the handle until thefeedback information reads 45 and N (or 45 and E,

depending on which end of the rotation handle wasselected).

3. Release the left mouse button. The equipment is nowcorrectly orientated.





4. Double click on the TANK1 cylinder to make it the CE anddisplay the Model Editor handle at its origin. Note that all of the other elements in 3D View are displayed semi-translucent.

5. Turn on Feature Highlighting by pressing the F key.

6. Right click on the Z Linear handle and select Move Handle >Align with Feature… from the pop-up menu. Locate the

Ppoint at the bottom of the cylinder by moving the pointer,using the left mouse button, over the cylinder until the Ppointis displayed and the Through Ppoint Feature text is shown.

7. Click the left mouse button to place the Model Editor handleat the bottom centre of the cylinder.

8. Right click on the Z Linear handle and select Snap toPoint… from the pop-up menu. The bottom of the cylinder needs to be located on the top surface of the box that formsthe base of the tank.

9. Move the pointer over the centre of the base box until the topsurface Ppoint is located and the cylinder snaps to the point.Click the Ppoint to re-position the cylinder.

10. Click in an empty part of the 3D View background to exitModel Editor mode.

11. Finish the corrections by modifying the Ylength attribute of BOX1 of TANK1 to 2850, using the Modify Attributes form.





TANK2 Corrections

12. Modify the Dtop attribute of CONE1 of TANK2 to 1500 using the Modify Attributes form as describedpreviously.

13. Double click on the TANK2 cylinder to make it the CE anddisplay the Model Editor handle at its origin.

14. Make CYLI1 the CE, right click the Z Linear handle on thecylinder and select Move Handle > Align with Feature…from the pop-up menu. Locate the Ppoint at the bottom of the cylinder by moving the pointer, using the left mousebutton, over the cylinder until the Ppoint is displayed and theThrough Ppoint text is shown.

15. Click the left mouse button to place the Model Editor handleat the bottom centre of the cylinder.

16. Right click the X Linear handle and select Snap to Point…from the pop-up menu. Locate the Ppoint at the top centre of the cone and left click it to move the cylinder to this location.

17. Double click on PYRA2 to make it the CE and display theModel Editor handle. Right click on the Model Editor handleand select Move Handle > Align with Feature… from thepop-up menu. Move the handle to Ppoint 2, i.e. the centralbottom face of the pyramid.

18. Right click on the XY Planar handle and select Align withFeature… from the pop-up menu. The bottom of thepyramid needs to be aligned in the XY plane to the centre of the cylinder.

19. Move the pointer over the Ppoint on the top of the cylinder and note that the pyramid is aligned with this cylinder but themovement is constrained in the XY plane. Left click thePpoint to re-position the pyramid.





20. Double click on PYRA1 to make it the CE and display theModel Editor handle. The bottom face of the pyramid needsto be aligned with the bottom face of PYRA2.

21. Right click the Z Linear handle and select Move Handle >Align with Feature… from the pop-up menu. Move thehandle to Ppoint 2, i.e. the central bottom face of thepyramid.

22. Right click the Z Linear handle again and select Align withFeature… from the pop-up menu. Move the pointer over abottom edge of PYRA2 to highlight a Through Linear Edgefeature and left click to re-position the pyramid.

23. Double click on NOZZ TANK2-N2 to make it the CE anddisplay the Model Editor handle. The nozzle needs to berotated around its flange face so that it faces East, i.e. a 90ºrotation.

24. Right click on the Z axis Rotation handle and select Enter Value… form the pop-up menu to display the RotateSelection about Z form. Enter 90 in the textbox and clickthe Preview button. The nozzle does not rotate to thecorrect orientation, enter -90 in the textbox and click thePreview button again. The nozzle is in the correctorientation, click the OK button.

25. Right click the on any equipment primitive and select ExitEquipment Editor form the pop-up menu.

26. Click in an empty part of the 3D View background to exitModel Editor mode.





Pump 1 Corrections

27. Double click on PUMP1 to make it the CE and display theModel Editor handle at its origin.

28. Right click on the Z Linear handle and select Move Handle> Snap to Point… from the pop-up menu. Move thepointer over the face of the suction nozzle of the pump tofind the P0 and then left click on it to move the handle.

29. Right click on the Z Linear handle and select Align withFeature… from the pop-up menu.

30. Move the pointer over the flange on the pipe that thesuction nozzle is meant to connect to until P1 is identified

and the Through Ppoint text is displayed. Left click on thefeature to re-position the pump.

31. Double click on CYLI1 of PUMP1, the drive shaft cylinder,to make it the CE and move the Model Editor handle to itsorigin.

32. Right click on the Y axis Rotation handle and rotate thecylinder through 90° using any method.

33. Locate DISH2 of PUMP1 and left click on it to make it theCE and move the Model Editor handle to its origin.

34. Right click the Z Linear handle and select Snap to Point…from the pop-up menu. Move the pointer over the end of CYLI1 until P2 is located. Left click on the Ppoint to re-position the dish.

35. Double click in an empty area of the 3D View to exit ModelEditor mode.





36. The corrections are now complete.



139

APPENDIX A

www.aveva.com© Copyright 1974 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.

APPENDIX A – AVEVA Primitives

Key dimensions for a range of common primitives are outlined in the pages that follow. Some P-Points have

been omitted for clarity.

Box (BOX)

Specific geometric attributes:Xlength Length parallel to X axisYlength Length parallel to Y axisZlength Length parallel to Z axis

Cylinder (CYLI)

Specific geometric attributes:Diameter Diameter of cylinder Height Length parallel to Z axis





Cone (CONE)

Specific geometric attributes:Dtop Diameter at top of coneDbottom Diameter at bottom of coneHeight Length parallel to Z axis

Snout (SNOU)

Specific geometric attributes:Dtop Diameter at top of snoutDbottom Diameter at bottom of snoutXoffset Offset of centre of top from centre of bottom on X axisYoffest Offset of centre of top from centre of bottom on Y axisHeight Length parallel to Z axis

Only an Xoffset is show in this example, however, both Yoffset and Xoffset may be set.





Pyramid (PYRA)

Specific geometric attributes:Xbottom Length of bottom of pyramid parallel to X axisYbottom Length of bottom of pyramid parallel to Y axisXtop Length of top of pyramid parallel to X axisYtop Length of top of pyramid parallel to Y axisHeight Length parallel to Z axis

Xoffset Offset of centre of top from centre of bottom on X axisYoffset Offset of centre of top from centre of bottom on Y axis

Only a Yoffset is show in this example, however, both Yoffset and Xoffset may be set.

Circular Torus (CTOR)

Specific geometric attributes:Rinside Inside radius in XY planeRoutside Outside radius in XY plane Angle Subtended angle (maximum 180°)





Rectangular Torus (RTOR)

Specific geometric attributes:Rinside Inside radius in XY planeRoutside Outside radius in XY planeHeight Length parallel to Z axis Angle Subtended angle (maximum 180°)

Dish (DISH)

Specific geometric attributes:Diameter Diameter of dish in XY plane.Height Height of dish parallel to Z axisRadius Knuckle radius

If the knuckle radius is 0 then the dish is represented as a segment of a sphere. If the knuckle radius isgreater than 0 then the dish is represented as a partial ellipsoid, generally used to represent atorispherical end to a vessel.





Sloped Cylinder (SLCY)

Specific geometric attributes:Diameter Diameter of sloped cylinder Height Length in Z axis from bottom centre to top centreXtshear Inclination of top of cylinder in the XZ axis (in degrees)Ytshear Inclination of top of cylinder in the YZ axis (in degrees)Xbshear Inclination of bottom of cylinder in the XZ axis (in degrees)Ybshear Inclination of top of cylinder in the YZ axis (in degrees)

Only an Xtshear and Ybshear are shown in this example, however, Xtshear, Ytshear, Xbshear and Ybshear may be set in any combination to obtain the required results. The values for these attributesmay be +ve or –ve.

Extrusion (EXTR)

Specific geometric attributes:Height Height of extrusion in Z axis

An extrusion is a 2D shape, defined by a series of vertices at each change in direction, extruded through a height. The primitive consists of three element types, i.e. EXTR, LOOP and VERTs.





Solid of Revolution (REVO)

Specific geometric attributes: Angle Rotation angle around X axis (selected rotation line)

A solid of revolution is a 2D shape, defined by a series of vertices at each change in direction, rotated through a specified angle around a specified rotation axis. The primitive consists of three element types, i.e. REVO, LOOP and VERTs.




Nozzle (NOZZ)

Although a nozzle is classed as a primitive, it is unlike the other primitives in that its geometry is determinedin Paragon as part of a catalogue component. Nozzles of different types and geometry may be constructedin Paragon to suit the requirements of the Piping Specification.

The specific nozzle type is referenced from Paragon using the Specification Reference (Spref) attribute.

Specific geometric attributes:Height Height between nozzle face and end, i.e. from P1 to P2.

tm-1801 aveva everything3d™ (1.1) foundations rev 2.0

Documents