Professional Documents
Culture Documents
Overview
Conventions
What's New?
Getting Started
Setting Up Your Session
Defining the Hull Form
Setting Up Your Grid
Creating Molded Forms
Creating a Compartment
Creating Boundaries
Saving Documents
User Tasks
Browsing Project Data
Wrapping Surfaces
About Wrapping Surfaces
Preparing Imported Surfaces
Creating Hull Forms
Creating Deckhouses
Creating Complex Hull Forms
Modifying Wrapping Surfaces
Replacing Wrapping Surfaces
Calculating General Hull Characteristics and Form Coefficients
Molded Forms
About Molded Forms
Creating Simple Molded Forms
Creating Multiple Molded Forms
Creating External Molded Forms
Modifying Molded Forms
Compartments
About Compartments
Creating Compartments
Modifying Compartments
Splitting Compartments
Modifying Compartment User Type
Creating Complex Compartments
Boundaries
Creating Boundaries
Modifying Boundary User Type
Openings
Structure Preliminary Layout Version 5 Release 14 Page 2
Creating Openings
Deleting Openings
Exporting Data in IDF Format
Generating Offset Data
Object Relationships
Creating Reports
Defining the Report Format
Generating a Report
Producing Lines Drawings
Creating Plane Systems
Managing Your Project
Working with a Cache System
Managing Ship Project Data
Managing Project Resources
Using the PRM Command
Checking a PRM File for Errors
Understanding Project Resource Management
About the Feature Dictionary
About Object Naming Rules
Structure Preliminary Layout Package in Knowledge Expert
Interoperability
Working with ENOVIA LCA
Optimal CATIA PLM Usability
Recommended Methodology
Multiple Design Options, Querying for Compartments
Penetration Management
Querying for Penetrations
Create a Cutout Sketch
Adding an Object to a Penetration
Penetration Management Setup
Working with SmarTeam
Workbench Description
Structure Preliminary Layout Toolbar
Structure Grid Set Toolbar
Specification Tree
Customizing
Design
Drafting
Offset Data
Customizing Standard Views
Glossary
Index
Structure Preliminary Layout Version 5 Release 14 Page 3
Overview
Welcome to the Structure Preliminary Layout User's Guide. This guide is intended for users who need
to become quickly familiar with the Structure Preliminary Layout Version 5 product.
Version 5 Structure Preliminary Layout allows you to model the early definition of hull forms,
major ship zones and main structures. It offers an easy-to-use and easy-to-learn graphic interface.
The overall ship design project goes through a number of different phases from conceptual design
through functional and detail design to extraction of deliverables. This product addresses initial
design requirements for the shipbuilding industry. It focuses on internal arrangement and definition,
including major bulkheads and decks, on subdivision into compartments of simple and complex
shapes, and lets you compute data used in hydrostatic analyses. Other outputs include lines
drawings, project data in IDF format and offset data in XML format. This early definition of the ship
will then be further refined during the functional and detail design phases.
Structure Preliminary Layout Version 5 Release 14 Page 4
As a scalable product, Structure Preliminary Layout can be used with other Version 5 products such
as Generative Drafting 2 (GRD) and Generative Shape Design 2 (GSD).
windows, standard and view toolbars. We therefore recommend that you read the Infrastructure
User's Guide that describes generic capabilities common to all Version 5 products.
You may also like to read the following complementary product guides, for which the appropriate
license is required:
To get the most out of this guide, we suggest you start reading and performing the step-by-step
tutorial Getting Started. This tutorial will let you get acquainted with the product.
Once you have finished, you should move on to the user task section of this guide. This steps you
through basic procedures and includes useful tips for getting the most out of the product.
This guide contains an Interoperability section which briefly introduces how to work with ENOVIA LCA
and SmarTeam in conjunction with Structure Preliminary Layout.
The workbench description, which describes Structure Preliminary Layout-dedicated toolbar, and the
Customizing section, which explains how to customize your personal environment, will also certainly
prove useful. A glossary of terms specific to Structure Preliminary Layout has also been included in
this guide.
Navigating in the Split View mode is recommended. This mode offers a framed layout allowing direct
access from the table of contents to the information.
Conventions
Certain conventions are used in CATIA, ENOVIA & DELMIA documentation to help you recognize and
understand important concepts and specifications.
Graphic Conventions
The three categories of graphic conventions used are as follows:
a target of a task
the prerequisites
a tip
a warning
information
basic concepts
methodology
reference information
Site Map
What's New?
Overview
Getting Started
Basic Tasks
Workbench Description
Customizing
Reference
Methodology
Glossary
Structure Preliminary Layout Version 5 Release 14 Page 8
Index
Text Conventions
The following text conventions are used:
● The titles of CATIA, ENOVIA and DELMIA documents appear in this manner throughout the text.
● File -> New identifies the commands to be used.
● Enhancements are identified by a blue-colored background on the text.
Use this
mouse button... Whenever you read...
● Drag
● Move
What's New?
New Functionality
Splitting compartments
You can now split existing compartments by molded forms
Improved performance
A new import option can significantly reduce the size of CATParts
Penetration management
In an ENOVIA environment, you can now manage the process of creating openings through
bulkheads, etc.
Object relationships
You can view relationships between objects
Enhanced Functionality
Creating openings
You can now create openings from any catalog of opening shapes, rather than from a
dedicated Structure Preliminary Layout catalog
Managing project resources
You can now check the PRM file for certain errors
Interoperability with ENOVIA V5 VPM - Document Chooser integration and support of DLNames
You can now customize the document environment (Tools -> Options -> General ->
Document tab) in order to select documents or paths using various interfaces (folder,
DLName, ENOVIA V5, etc.)
Structure Preliminary Layout Version 5 Release 14 Page 10
Getting Started
This tutorial will guide you step-by-step through your first Structure Preliminary Layout session,
allowing you to get acquainted with the product.
You will need a Version 5 session and should be familiar with basic concepts such as document
windows, standard and view toolbars.
You should be able to complete this tutorial in about 30 minutes.
1.Select Equipment & Systems -> Structure Preliminary Layout from the Start menu.
The Structure Preliminary Layout workbench is loaded and an empty CATProduct document is
opened.
Structure Preliminary Layout Version 5 Release 14 Page 12
2.To ensure associativity between items you create and the entities selected to create them, set
the following option:
● Select Tools -> Options from the menu bar
● Select Infrastructure -> Part Infrastructure in the left-hand box of the Options dialog
box
● Click the General tab
● Select Keep link with selected objects and Create external references as shown
elements.
3.To define default colors for molded forms, compartments and boundaries:
● Select the Equipment & Systems category
● Select Structure Preliminary Layout, then select the Design tab
● Set molded form color to purple.
● Set bounded zone color to yellow.
● Set boundary color to red.
4.To improve performance, click to clear the Keep External Reference in SPL Objects option in the
same tab page.
The feature is added to the specification tree. You are ready to import the hull form surface.
3. Open the HullForm.CATPart containing the surface to be used for the hull form.
The sample CATPart is located in the samples folder. It is opened in a separate document.
You will now associate the imported surface to the wrapping surface feature.
8. Right-click the wrapping surface feature and select Edit wrapping surface from the contextual menu:
Structure Preliminary Layout Version 5 Release 14 Page 15
Note: Set as default is set to Yes. This means that the wrapping surface is a default surface and will be automatically
proposed when performing other operations, such as creating molded forms.
Note: It is recommended that one CATPart contain the set of reference planes in one ship
direction only.
1.
Activate the project and select the Plane System command.
A new part is added to the specification tree and the Plane System dialog box appears.
2. Create the cross plane
system:
● Click the yz plane of the
new part just added to
define the direction.
The center of the plane is
automatically taken as its
origin.
● Enter a spacing of 14 000
mm to define the distance
between planes
● Enter 4 in the Number of
planes after origin field to
create four planes before
and four planes after the
origin
● Click OK to create the
cross plane system.
3. Repeat to create a deck plane system comprising four planes 5500 mm apart, two on
either side of the origin (XY plane).
Structure Preliminary Layout Version 5 Release 14 Page 17
Structure Preliminary Layout Version 5 Release 14 Page 18
The reference element gives the basic shape to your molded form. You will now select the limiting elements to which the
molded form will be trimmed.
● Click OK.
The preview shows that the bulkhead will be created inside the ship. This is what we want.
4. Select the topmost deck plane to trim the bulkhead to this plane.
The Molded Form Definition dialog box expands and the orientation is visualized in the geometry area.
Orientation is correct.
Structure Preliminary Layout Version 5 Release 14 Page 20
You will now define a set of bulkheads based on the one you have just created.
9. Select the bulkhead you have just created as the reference molded form.
10. Drag (using the left mouse button) to select parallel cross planes in the geometry area using a bounding outline.
Creating a Compartment
This task shows you how to create a compartment for the engine room.
Note: Limits listed in the dialog box are the naming conventions specified in the ship project. If
you remember, you kept the default naming conventions.
2. Click Change... opposite Object class to change the class.
The Class Browser opens and accesses the feature dictionary defining object classes.
Structure Preliminary Layout Version 5 Release 14 Page 23
3.
Click the Expand tree icon in the Class Browser to view available classes.
Structure Preliminary Layout Version 5 Release 14 Page 24
You may like to display the geometry in wireframe mode to make selections easier.
A vector appears showing the orientation of the surface. The molded form and orientation are
given in the dialog box.
5. If necessary, click the orientation vector to correct the orientation.
The system realizes that the starboard and portside limits correspond to the same surface and
indicates this in the Merge columns opposite these limits.
Creating Boundaries
This task shows you how to automatically create the boundaries of the compartment just
defined.
1. Edit the compartment you just created: right-click the compartment feature in the
specification tree and select Edit Compartment from the contextual menu.
3. Expand the compartment item in the specification tree to view created boundaries.
Structure Preliminary Layout Version 5 Release 14 Page 27
Saving Documents
This task contains recommendations on saving your documents.
Ways in which documents are saved are explained in the Infrastructure User's Guide -
Creating, Opening and Saving Documents. You must read that documentation because
the various methods are not explained here. This task simply suggests the methodology you
should follow in specific circumstances.
1. If you are saving a document to a local machine or network drive it is recommended that
you use the "Save Management" command initially. The Propagate Directory command
(which is in the Save Management dialog box) should not be used routinely. It is meant
to be used in specific circumstances, such as when you want to place all the contents of a
document in one directory before sending it to another location.
2. If you are saving a document to another site or network you should use the "Send To"
command. In this case, you should be careful about the links for documents such as
resolved parts folder or line ID. These links could change to reflect the local network drive
to which the documents have been sent. You should make sure they point to the original
location - using the Reset button in the Save Management dialog box is one way of doing
this.
3. You should check the active document before you execute the Save command . The root
product must be the active document if you want to save everything under it.
Structure Preliminary Layout Version 5 Release 14 Page 29
User Tasks
The tasks you will perform in the Structure Preliminary Layout workbench are related to the
general definition of the ship, including hull shape, main decks and bulkheads as well as
general layout.
Resources & Default Settings
● Don't forget to set your options correctly before starting to work (Tools -> Options...,
Equipment & Systems, Structure Preliminary Layout).
● Before you begin, customize standard views to shipbuilding conventions.
Doing so:
You can browse project data using the Edit Project command.
This task shows you how to browse project data.
The dialog box expands showing adopted conventions for main ship directions (Coordinate System tab) and hull form orientations
(Hull Form tab).
Ship directions are defined with respect to the coordinate system of the document.
Bounding Box
You may need to click the Fit All In command to visualize the
bounding box.
When you create the wrapping surface, the bounding box is automatically re-dimensioned to include the hull form. If features are
created outside the bounding box, consult to the administrator.
Wrapping Surfaces
About wrapping surfaces
Prepare imported surfaces: open the surface, then use Generative Shape Design to orient,
analyze and perform necessary operations
Create hull forms: add the wrapping surface feature, import the surface and associate the
surface to the feature
Create deckhouses: create the deckhouse from scratch using Generative Shape Design, then
associate it to the wrapping surface feature
Use basic wrapping surfaces for complex hull forms: split the imported surface using
Generative Shape Design then associate split surfaces to the wrapping surface feature
Modify wrapping surfaces: edit the wrapping surface feature and change specifications in the
dialog box that appears.
Replace wrapping surfaces: import the replacement surface, switch to Generative Shape
Design and use the Replace contextual menu command.
Calculate general hull characteristics and form coefficients: edit the wrapping surface
feature, select the Form Coefficients tab, specify the draft location and click Calculations.
Structure Preliminary Layout Version 5 Release 14 Page 33
Wrapping surfaces are used to define the hull forms (internal and external) and deckhouse. In the case of hull forms,
surfaces are usually imported, whereas for deckhouses they are created from scratch.
The wrapping surface can be a single surface or can be made of several surfaces to take into account special cases such
as illustrated below.
Note: Shell expansion tools in Structure Functional Design work on hull form halves (portside and starboard wrapping
surfaces) or a section of the hull form and not the complete hull form. The transom must be considered a bulkhead and
not an integral part of the hull.
You can manage wrapping surface type via the feature dictionary or directly in the Structure Preliminary Layout
workbench via the Type attribute.
To do so via the Type attribute:
● Right-click the wrapping surface feature in the
specification tree and select the Properties
command.
The Properties dialog box appears.
● Click the Conceptual Structure tab.
● Enter the type, deckhouse for example.
● Click OK in the Properties dialog box.
Object naming rules based on type can also be defined to identify objects in your document.
Bounding Box
When you create the wrapping surface, the bounding box defining overall project dimensions is automatically re-
dimensioned to include the hull form and deckhouse. The bounding box is managed by the administrator as a project
resource.
To visualize the bounding box, browse the project data using the Edit Project command.
Structure Preliminary Layout Version 5 Release 14 Page 34
Publishing
Wrapping surfaces you define are automatically published. This is identified by a Publication entry in the specification
tree with one publication feature for each wrapping surface published. If several basic wrapping surfaces are defined, the
complete wrapping surface is the result of merging all constituent wrapping surfaces.
Molded forms and compartments you create will reference the published surfaces (identified by their publication name)
and not the underlying surfaces. This lets you replace the hull form or deckhouse at any time without affecting any
downstream work.
Do not change publication names of surfaces referenced by molded forms and compartments: links between the two will
be lost.
Structure Preliminary Layout Version 5 Release 14 Page 35
You can import IGES files, idf type and CATPart documents.
This task shows you how to open, then position and optimize surfaces.
4. Click Open.
You are now ready to position and optimize your surface. This is done in the Generative Shape Design
workbench.
When you create elements, there are no links to the entities used to create them.
7. Orient the surface using Translate, Rotate, Symmetry and Scaling commands (Insert -> Operations).
You can now analyze your surface and perform necessary operations to obtain a coherent surface.
Structure Preliminary Layout Version 5 Release 14 Page 36
8. Analyze your surface using Analysis commands (Insert -> Analysis) to determine whether healing, joining,
etc. is necessary.
9. Perform necessary operations, for example, healing to fill gaps between surfaces (Heal command), joining to
join surfaces (Join command).
These commands are found in the Insert menu (Insert -> Operations) or in the Operations toolbar.
For more information on these tasks, see the appropriate sections in the Generative Shape Design User's
Guide.
You are now ready to import your surface into Structure Preliminary Layout to create a wrapping surface.
Structure Preliminary Layout Version 5 Release 14 Page 37
Deckhouses are generally not imported surfaces, but are created from scratch.
The Class Browser opens and accesses the feature dictionary defining object classes. A
sample dictionary is supplied with the product.
Structure Preliminary Layout Version 5 Release 14 Page 38
3.
Click the Expand tree
The selected class is identified in the Wrapping Surface Class Definition dialog box.
Structure Preliminary Layout Version 5 Release 14 Page 39
5. Click OK in the Wrapping Surface Class Definition dialog box to define the wrapping
surface feature:
You can import IGES files, IDF type and CATPart documents. Surfaces must first be
prepared, i.e. properly positioned and optimized.
Note: The bounding box is automatically re-dimensioned to accommodate the hull form.
Structure Preliminary Layout Version 5 Release 14 Page 41
If you need to create more than one wrapping surface, import the surface into Structure
Preliminary Layout then split it into the number of required basic wrapping surfaces before
associating basic surfaces to the wrapping surface feature.
In this way, you keep the associativity between the imported surface and the basic
wrapping surfaces. This allows easy replacement of the imported surface: you simply need
to replay the split features.
9. If necessary, update your document.
Associating the Surface to the Wrapping Surface Feature
Wrapping surfaces are identified by their publication names in the Molded Form and
Compartment commands. You can change publication names when you create surfaces
but must not do so after they are referenced by molded forms or compartments.
Structure Preliminary Layout Version 5 Release 14 Page 42
13. Check wrapping surface orientation and if incorrect, click the orientation vector in the
geometry area or select Switch Orientation Name in the dialog box.
Creating Deckhouses
Wrapping surfaces for deckhouses are generally created from scratch. This is done using the Generative Shape Design workbench
directly in the Structure Preliminary Layout document.
This task shows you how to create wrapping surfaces from scratch.
2. Click Change... opposite Object class to change the wrapping surface class.
The Class Browser opens and accesses the feature dictionary defining object classes. A sample dictionary is supplied with the
product.
Structure Preliminary Layout Version 5 Release 14 Page 44
3.
Click the Expand tree icon in the Class Browser to view
available classes.
The selected class is identified in the Wrapping Surface Class Definition dialog box.
5. Click OK in the Wrapping Surface Class Definition dialog box to define the wrapping surface feature:
7. Create a surface.
Use existing features in the document to position your surface correctly first time.
B. Extrude two profiles (Extrude command) Trim ( ) extruded surfaces to obtain resulting surface:
For more information on creating surfaces, see the appropriate section in the Generative Shape Design User's Guide.
Publication Name
Wrapping surfaces are identified by their publication names in the Molded Form and Compartment commands. You can change
publication names when you create surfaces but must not do so after they are referenced by molded forms or compartments.
Structure Preliminary Layout Version 5 Release 14 Page 46
10. Define the default setting for the selected surface:
● Yes: considers the surface as a default surface. This surface is automatically proposed when performing other operations, such
as creating molded forms.
● No: the selected surface is not considered a default surface.
Double-click the surface in the dialog box to change Set as Default to No.
11. Check wrapping surface orientation and if incorrect, click the orientation vector in the geometry area or select Switch orientation
name in the dialog box.
To do so, split the imported surface in the Structure Preliminary Layout document. This keeps the associativity
between the imported surface and the component surfaces you create, and allows easy replacement of the imported
surface - you simply need to replay the split features.
When you have done this, associate all split surfaces to the wrapping surface feature.
This task shows you how to split hull forms and create basic wrapping surfaces.
1. Double-click Wrapping Surface Geometry in the specification tree to change to the Generative Shape Design
workbench.
How reference planes intersect the imported surface is important: only one intersection must be made.
Examples below show ways to split the complex imported surface using two reference planes. Two separate
surfaces are created. A basic wrapping surface is then defined for each surface.
If several basic wrapping surfaces are created, the complete wrapping surface (the result of merging basic
wrapping surfaces) is identified by the name given in Name field. You can change this name before you publish
wrapping surfaces but not after. If the wrapping surface corresponds to only one surface, it is identified by its
publication name.
Publication Name
Wrapping surfaces are identified by their publication names in the Molded Form and Compartment commands. You
can change publication names when you create surfaces but must not do so after they are referenced by molded
forms or compartments.
5. Define the default setting for component surfaces:
● Yes: considers the surface as a default surface. This surface is automatically proposed when performing other
operations, such as creating molded forms.
● No: the surface is not considered a default surface.
Double-click the surface in the dialog box to change Set as Default to No.
The Wrapping Surface Definition dialog box appears showing wrapping surface
specifications.
You can:
● Change wrapping surface orientation
● Remove and/or add basic wrapping surfaces
● Change the Set as default setting for basic wrapping surfaces.
2. To change wrapping surface orientation, click Switch Orientation Name or click one of
the orientation vectors in the geometry area.
5. To change the Set as default setting, double-click the surface whose setting you want
to change.
● Yes: considers the surface as a default surface. This surface is automatically
proposed when performing other operations, such as creating molded forms.
● No: the surface is not considered a default surface.
1. Import the surface you want to use to replace an existing wrapping surface:
● Copy the surface
● Paste it at reference part level or directly under the Wrapping Surface Geometry
using the Paste Special... command, As Result option.
3. Select the surface you want to replace (Surface.1) then click Replace.
Note: If you worked on the original surface using the Generative Shape Design
workbench, using for example scaling or applying symmetry, then a dialog box appears
asking which surface (the original surface or the worked surface) you want to replace.
4. Select the surface you imported (Surface.2) that will replace the existing surface.
Structure Preliminary Layout Version 5 Release 14 Page 53
The surface has been replaced and the wrapping surface feature rebuilt.
If you created other preliminary layout entities that reference the wrapping surface, you
will have to update your document to rebuild these features. Entities requiring an
update are highlighted in the document and identified as such in the specification tree.
Structure Preliminary Layout Version 5 Release 14 Page 54
3. Specify the location of the draft: enter a value in the Draft box.
Main characteristics
Displacement
Wetted surface
Form coefficients
Cb Block coefficient
Cp Prismatic coefficient
Molded Forms
About molded forms
Create simple molded forms: Define the class, select the reference element then the limits and
adjust to create on right side
Create multiple molded forms: Select the reference molded form then all reference planes at
which to create molded forms
Create external molded forms: Define the class, create the geometry using Generative Shape
Design then associate the geometry to the feature
Modify molded forms: Edit the molded form (contextual menu) and modify specifications as
desired
Structure Preliminary Layout Version 5 Release 14 Page 57
Structure Preliminary Layout provides tools letting you create simple molded forms based on
a reference plane and bounded by the hull form, planes or other molded forms as well as
multiple molded forms based on the selection of a set of reference planes.
Reference planes are created in a new part using the Generative Shape Design workbench.
For more complex molded forms, an external molded form command lets you can associate
your own geometry created using Generative Shape Design to a molded form.
Molded forms have an orientation represented by a combination of two vectors. The default
orientation for decks is top/bottom, for example.
Publishing
Molded forms you define are automatically published. This is identified by a Publication entry
in the specification tree. If your molded forms contain openings, two publication features are
published, one for the surface without the opening and the other for the surface with the
opening.
Structure Preliminary Layout Version 5 Release 14 Page 58
2. Click Change... opposite Object class to change the molded form class.
The Class Browser opens and accesses the feature dictionary defining object classes. A sample dictionary is supplied with the
product.
Structure Preliminary Layout Version 5 Release 14 Page 59
3.
Click the Expand tree icon to expand the object class tree
The reference element is always a GSD plane. The two underlying sketches giving the basic shape of your molded form.
Reference planes must be created in a new part. Do not use existing part axis system planes.
You can edit the underlying sketches to modify your molded form.
6. If desired, specify an offset distance to offset the molded form from the reference plane.
Limits can be the hull form, other molded forms or GSD planes.
If you select the hull form:
Click OK in the dialog box when done to select all basic wrapping surfaces listed in the Selected box.
Define your list of default surfaces in the Selected box and check Keep as default and surfaces will be set as default surfaces in
the Wrapping Surface command.
Selected limits are listed as limiting elements in the Molded Form Definition dialog box.
8. If necessary, click Other side in the dialog box to extend the molded form in the direction opposite that shown in the preview.
The molded form is extended in the same direction as the orientation vector of the surface to which it is trimmed. The Other side
option lets you change direction.
In the case of the hull form, the system 'knows' that you want to
create molded forms inside the hull form.
Double-click the wrapping surface in the Molded Form Definition Definition dialog box to redisplay the Basic Wrapping Surface
Selection dialog box and, for example, change component basic surfaces or take the entire hull form into consideration.
10. Once you are satisfied with your molded form, check Molded form orientation in the dialog box:
The Molded Form Definition dialog box expands and orientation is visualized in the geometry area.
11. If necessary, select the correct combination in the dialog box, and correct orientation in the geometry area.
12. Click OK when done.
Have created a simple molded form which will serve as the reference as well as a set of
reference planes.
1. Click the
Multiple Molded
Form icon.
The Multiple
Molded Form
Definition
dialog box
appears.
2. Select the
reference
molded form.
● Any
openings in
the
reference
molded
form are
also copied.
● Multiple
molded
forms will
inherit the
same
feature
dictionary
attribute
values as
the
reference
Structure Preliminary Layout Version 5 Release 14 Page 63
molded
form.
3. Select all the reference planes at which you want to create molded forms.
Selected planes are listed in alphabetical order in the dialog box. You can browse
through the list to check you have all the right planes.
Planes must be parallel to the reference molded form plane.
Use the bounding outline (left mouse button and drag) to select more than one plane.
Only parallel planes within the bounding outline are taken into account.
Reference planes must be created in a new part. Do not use existing part axis system
planes.
A progress bar in the dialog box lets you monitor the calculation.
Molded forms are created and published at all selected planes. They are defined in the
same way, except for the reference element and any offset, as the reference molded
form.
To offset molded forms created in this way from their reference planes, individually edit
the molded form.
2. Click Change... opposite Object class to change the molded form class.
The Class Browser opens and accesses the feature dictionary defining object classes.
A sample dictionary is supplied with the product.
Structure Preliminary Layout Version 5 Release 14 Page 65
3.
Click the Expand tree icon in
The class is identified in the External Molded Form Definition dialog box.
5. Click OK.
Or,
● Import a surface.
7. Edit the molded form feature: right-click the feature in the specification tree and
select Edit External Molded Form from the contextual menu.
The External Molded Form Definition dialog box expands and the orientation is
visualized in the geometry area.
10. If necessary, select the correct combination in the dialog box, and correct orientation
in the geometry area.
11. Click OK when done.
Structure Preliminary Layout Version 5 Release 14 Page 67
Activate the Products selection command to select the molded form in the geometry area.
Structure Preliminary Layout Version 5 Release 14 Page 68
Molded forms are defined by two underlying sketches that give them their basic shape.
If the reference element is a transverse bulkhead:
● the normal to this element is X
● the guide curve lies along the Y-axis
● the profile curve lies along the Z-axis.
You can also edit sketches when you first create the molded form.
Structure Preliminary Layout Version 5 Release 14 Page 69
3. Click the sketcher icon opposite the curve you want to modify, for example opposite Guide:
You can also change the reference element as well as remove, replace and add limiting elements. In
our example, we have added a limiting element.
6. To change the reference element:
● Click in the Reference element field
● Select a new reference element.
10. To add or change the offset distance from the reference plane, simply enter a value or edit the value in
the Offset field.
11. Click OK when done.
Structure Preliminary Layout Version 5 Release 14 Page 72
Compartments
About compartments
Modify compartments: Edit the compartment (contextual menu) and select the specification to change
Split compartments: Select the compartment you want to split then a molded form
Modify compartment user type: Select the compartment, then select the new type in the Change User Type dialog box
About Compartments
Compartments are volumes in the ship bounded by horizontal and vertical molded forms
and/or wrapping surfaces representing structural decks and bulkheads. They are used to
organize the space within a ship into functional volumes. Typical examples are void,
habitable, machinery/equipment.
Two commands are available depending on the type of geometry you want to manage:
The system computes compartment volume, total area and center coordinates. To visualize
values, simply edit the compartment and select the Result tab.
Creating Compartments
This task shows you how to divide the ship into compartments.
The Class Browser opens and accesses the feature dictionary defining object classes. A sample dictionary is supplied with
the product.
Structure Preliminary Layout Version 5 Release 14 Page 75
3.
Click the Expand tree icon in the Class Browser to view
available classes.
Limits identified in the Compartment Definition dialog box are those defined for the project.
Structure Preliminary Layout Version 5 Release 14 Page 76
7. Select the molded form or wrapping surface corresponding to the portside limit and check surface orientation.
8. Repeat to select surfaces corresponding to other limits in the order given in the dialog box.
If the same surface is selected as more than one limit, this is recognized by the system. The wording Merged is indicated
in the Merge column opposite limits corresponding to this surface.
To create compartments with less than six faces, limits having the same molded form or wrapping surface are merged.
There are several ways you can do this:
A. You can simply select surfaces corresponding to the various limits in the order shown in the dialog box, selecting the
surface that corresponds to more than one limit more than once.
B. You can inform the system which limits will correspond to only one surface first by double-clicking limits in the dialog
box, then selecting the corresponding surface.
C. You can select the surface, click the limit again in the dialog box to indicate that this limit is to be merged, then select
other limits that also have this surface as limit.
The wording Merged is indicated in the Merge column opposite limits corresponding to the same surface. The same
surface is identified in the Molded Form column for each merged limit.
The zone is previewed in the color defined in the settings for the type selected (Tools -> Options, Equipment &
Systems -> Structure Preliminary Layout -> Design).
Structure Preliminary Layout Version 5 Release 14 Page 78
Modifying Compartments
This task shows you how to replace selected limits of compartments.
3. Click Remove.
4. Select the new limit in the
geometry area:
Splitting Compartments
This task shows you how to split a larger compartment by a molded form and create new
compartments.
Important: The molded form must completely traverse the compartment. Otherwise,
a message informs you that the selected molded form cannot split the compartment
correctly.
4. Click Preview to view the results then OK when done.
The compartment is split by the molded form (highlighted below) and new
compartments are created.
Structure Preliminary Layout Version 5 Release 14 Page 83
When you first create a compartment it is given a broad user type "compartment". You can change this to
more accurately represent the type of compartment, based on its intended use.
You can create your own types using the Feature Dictionary, as explained in a different section.
1. With your document open, select the compartment (in the specifications tree) whose user type you
want to change and then click the Change Compartment User Type button . The Change User Type
dialog box displays, with the selected compartment listed.
2. Click the button next to the New Type field. The Class Browser displays. Expand "Compartment" to view
all the types available to you.
Structure Preliminary Layout Version 5 Release 14 Page 84
Note: the name of the compartment changes based on the object naming scheme.
Structure Preliminary Layout Version 5 Release 14 Page 85
The Class Browser opens and accesses the feature dictionary defining object classes. A
sample dictionary is supplied with the product.
Structure Preliminary Layout Version 5 Release 14 Page 86
3.
Click the Expand tree icon in the Class Browser to view available classes, then select
The selected class is identified in the Complex Compartment Definition dialog box.
4. Select the existing compartments you want to combine.
Compartments are highlighted in the geometry area and added to the list in the dialog box.
By default, compartments are merged.
Structure Preliminary Layout Version 5 Release 14 Page 87
When creating complex compartments, you can merge or subtract existing compartments,
combining your operations in any order.
● To subtract a compartment, select the appropriate line in the dialog box and click
Subtract.
● To insert a compartment, select the line below which you want to insert the zone, click
Insert then select the compartment in the geometry area or specification tree.
● Remove and Replace options let you delete a compartment from or replace one in the
definition of the complex compartment respectively.
5. Click Preview to preview the complex compartment.
Boundaries
Create boundaries: Edit the compartment and click Extract Boundaries
Modify boundary user type: Select boundaries, then select new user type in Change User Type
dialog box
Structure Preliminary Layout Version 5 Release 14 Page 90
Creating Boundaries
This task shows you how to create boundaries for compartments.
● Automatically
● Using the Boundary icon. This is useful in cases where the wall of a compartment needs
to be split into more than one boundary to accommodate for example, two
compartments on the other side.
Make sure options are set correctly. Tools - Options - Infrastructure - Part Infrastructure and
check Keep Link With Selected Object and Create External References as Shown Elements.
When you first create a boundary it is given a broad user type "boundary". You can change this to more
accurately represent the type of boundary, based on its intended use.
You can create your own types using the Feature Dictionary, as explained in a different section.
1. With your document open, select the boundaries (in the specifications tree) whose user type you want
to change and then click the Change Boundary User Type button . The Change User Type dialog
box displays, with the selected boundaries listed.
2. Click the button next to the New Type field. The Class Browser displays. Expand "Boundary" to view all
the types available to you.
4. The type you selected displays in the User Type dialog box. Click Apply or OK. Also, the name of the
boundary changes based on the object naming scheme.
Structure Preliminary Layout Version 5 Release 14 Page 95
Openings
This section discusses ways of creating and managing openings.
Creating Openings
Deleting Openings
Structure Preliminary Layout Version 5 Release 14 Page 96
Openings
This task shows you how to define openings for molded forms.
● Using a sketch
● From a catalog.
From a Catalog
All catalogs of sketched shapes are now supported. A sample catalog for different opening shapes is provided with the
product. This catalog is a project resource and as such is managed by the system administrator.
Structure Preliminary Layout Version 5 Release 14 Page 97
Removing Openings
You can delete openings from the opening or molded form contextual menu:
● Using the opening contextual menu lets you remove the selected opening from all molded forms in which it exists.
● Using the molded form contextual menu lets you remove all openings from the selected molded form.
Deleting Openings
There are two ways in which you can delete openings.
1. Using the opening contextual menu: this process shows you all the molded forms in which the selected
opening exists, and lets you pick which one you want to delete.
2. Using the molded form contextual menu: this process shows you all the openings in the selected molded
form.
1. With your document open, right click on the opening in the specifications tree, select the opening in the drop
down menu and then select Remove Opening.
The Opening dialog box displays, listing the molded forms in which the opening exists.
Structure Preliminary Layout Version 5 Release 14 Page 100
2. Select the opening you want to delete and click Remove then OK.
Activate the Products selection command to select the molded form in the geometry area.
An Opening dialog box appears listing all openings associated with the selected molded form.
Structure Preliminary Layout Version 5 Release 14 Page 101
3. Click OK to confirm.
If you delete openings directly in the specification tree, you must still use this command to update the
associated molded form.
Structure Preliminary Layout Version 5 Release 14 Page 102
IDF format is an industry-standard datafile. The IDF file generated is based on sections, i.e. sets of
curves and points.
Have created compartments.
The IDF Export dialog box is displayed. By default, the root product name appears in the Name field.
3. Select a compartment:
Naming Conventions
Joining Compartments
4. Define the set of reference planes corresponding to IDF sections for the current component:
Select planes perpendicular to the X-axis. Any planes selected not in this axis are ignored.
The length of your hull must be oriented along the X-axis.
● Click Reset Sections to remove all planes associated with the current component and define your
sections again.
● Select a component in the dialog box then click Delete Component to remove it from the export
definition.
You may want to set this value to that recommended by the CAD software application into which you
will import the IDF file.
Discontinuity Gap
The system computes sections on both sides of the specified gap where discontinuity is perceived.
Sections can be viewed in the IDF Resulting View.
You may want to set this value to that recommended by the CAD software application into which you
will import the IDF file.
● Maximum points for each section are calculated and the IDF Export dialog box updated.
● Pan, rotate and zoom viewing tools are available in this dialog box.
Structure Preliminary Layout Version 5 Release 14 Page 105
Definition data in the dialog box is saved in your settings files so you can create other compartments
and add then to your data for exporting, for example.
8. Close the Resulting View and make any adjustments to export data necessary in the IDF Export
dialog box.
9. Click Apply again if necessary to preview results.
10. Click and select the folder in which you want to save in the IDF file.
By default, the IDF file has the same name as the root product.
11. Click OK to export data to the IDF file.
Discontinuity in Sections
You can also apply different stylesheets and generate offset data in other formats, for
example HTML or CSV. To do so, you must first customize your settings (Tools -> Options -
> Equipment & Systems -> Structure Preliminary Layout -> Offset Data).
Have a wrapping surface and appropriate sets of frame, waterline and buttock planes as well
as any control curves needed.
4. Click the Frame planes field and select frame planes of interest.
5. Click the Waterline planes field and select waterline planes of interest.
6. Click the Buttock planes field and select buttock planes of interest.
7. Click the Control curves field and select any special control lines.
Structure Preliminary Layout Version 5 Release 14 Page 108
Multi-selection capabilities are available when selecting frame, waterline and buttock
planes.
9. Check Start browser to have your browser open automatically showing the offset
results.
The XML file containing offset data is generated and, if you checked Start browser,
your browser displays the corresponding page.
Structure Preliminary Layout Version 5 Release 14 Page 109
Object Relationships
This feature aids the designer in identifying and viewing generic relationships between objects, and is
particularly useful for viewing relationships between objects coming from different applications.
The tab pages available and the relationships shown in each tab page are controlled by the object selected (the
current object).
This tasks shows you how to use the Object Relationships command.
To reduce unnecessary computer processing time when viewing object relations in the Interference tab you will
need to make some changes in the Tools -> Options settings.
Go to Tools -> Options, select Digital Mockup, DMU Space Analysis then click the DMU Clash - Detailed
Computation tab. Change the settings if necessary for Level of Detail, Clash Result and Numeric Result to
match those shown below.
Note: The DMU Space Analysis product must be installed to access DMU Clash option pages.
Structure Preliminary Layout Version 5 Release 14 Page 110
In the example, below, the assembly tree expands at the Product level to show the related preliminary
design objects.
The Assembly tab displays up to three levels: parent, current object and children.
In the preview pane, you can zoom and rotate the image just like in the geometry area. The Reframe Main
Window button updates the geometry area with the preview viewpoint.
Structure Preliminary Layout Version 5 Release 14 Page 111
The various tabs will become active only when the selected object supports that kind of relationship, for
example, if it is a type of object that can have limits.
In the example below, a deck has been selected to view Limits. In the Visualize column, toggle the Y/N to
show or hide an object in the preview pane.
Structure Preliminary Layout Version 5 Release 14 Page 112
An object can be selected from the geometry area, the specifications tree, or from the assembly tree or via
the preview pane in the dialog box.
3.Click the Interference tab to display objects that clash (intersect) with the current object. You can filter the
list by selecting All Type, Contact or Clash.
Note: Only basic geometric objects, not assemblies, can be analyzed for interferences.
Select the Hide connected objects check box to hide objects with known connections (i.e. listed in the
Connections tab) and not display them in the Interference tab list.
4.Click the Connections tab to display connected objects.
Take some time to experiment with the several combinations of tab selection, object type and filter
selections and observe the available information.
5.Click Close when done.
Structure Preliminary Layout Version 5 Release 14 Page 113
Creating Reports
You can generate reports that get the values of properties of objects in your documents. To
do so, you must first define the report format which identifies which properties you are
interested in. This report format is then used to generate reports.
2. Define the report format identifying which properties you are interested in.
Use Edit -> Search to select the objects for which you want to obtain a report.
For more information on searching using the General, Favorites and Advanced
modes, see the Infrastructure User's Guide.
The 'Or' option in the Advanced mode is particularly useful for combining search
criteria to select objects.
3. Generate your report based on the report format you defined.
Important: Select the Currently Selected Objects option in the Generate a report
dialog box.
Examples from the Piping workbench are used here. Substitute the appropriate resource or
directory when working in another workbench.
Before you generate a report you need to define its format. This means deciding which
properties you are interested in. This report format is kept in a file which you can use to
generate reports from other documents.
It is recommended that you use queries, as explained below, if you will be modifying a
document and running a report on it repeatedly. If you do not use a query the report may not
update after you modify a document.
To use this function you must first make sure of a setting. Click Tools - Options - General -
Parameters and Measure and click on the Language tab. Under Language check Load
extended language libraries. Either check All Packages, or uncheck this option and load
the packages you will be using.
1. Click Tools - Report - Define. The Report Definition dialog box displays.
Structure Preliminary Layout Version 5 Release 14 Page 116
You can toggle between Yes and No for the Column headings Sort, GroupBy and Sum. A
blank means No. To toggle click beneath the column heading. In the example above, for
the attribute Name, Sort is No, Group By is Yes and Sum is No.
2. The report name field is informative. You can use the button next to it to open an existing
report. You will need to enter a report name and location when you click the Save As
button. Enter a report title - you can enter anything but you must have a title.
4. Click on the down arrow and select the dictionary related to your program. In this case the
EquipLayout package has been selected. See Using Knowledgeware Packages for more
information.
5. Select the type of object. The list of attributes you will see in Step 6 will depend on the
type you select here. However, when you generate a report you will get values for all
objects in the document that have the attributes included in your report format. If you
want to limit the objects for which you get a report you must create a query (Step 8).
6. Select an attribute in the Attribute field and click the Add button. The attribute will be
added in the window. Add as many attributes as you want to.
7. Select Yes or No for the column headings.
● Sort: You only Sort by one of the attributes - if you select Name the report will sort in
alphabetical order.
● GroupBy: If you select Yes for one of the attributes, the report will group objects by
that attribute.
● Sum: For dimensional attributes like length. If you select Yes the report will sum up
the attribute you selected. For 3D applications it can compute dimensions like length
from the document. You must select the correct option in the Generate a Report dialog
box - you may need to select the objects and choose the 'currently selected objects'
option. For 2D applications attributes must have values defined.
● Quantity: If you select the Quantity checkbox and the Group By column heading, a
Quantity field will be added to the report. It will display a number, which shows how
many parts that attribute is common to. For instance, if you group by class name and
select the quantity checkbox, the report will show how many objects with the same
class name exist in your document.
8. You can further refine your report by using the Edit - Search function to define a query.
This will allow you to generate a report on a narrower selection of check valve, say, of a
certain size, instead of all check valves in your document. The queries you create will be
available for selection when you click the arrow in the Query Name field above. Detailed
instructions on using the Search function can be found in the Infrastructure User Guide
under Basic Tasks - Selecting Objects. Briefly, click Edit - Search to bring up the Search
dialog box. Select the Advanced tab, then select a workbench, type of object and attribute
you are interested in. Clicking the Add to Favorites button brings up the Create a Favorite
Query dialog box, where you can name the query and save it.
Structure Preliminary Layout Version 5 Release 14 Page 118
Generating a Report
This task explains how to generate a report listing values of selected properties. Before you do this you need
to define the report format.
Examples from the Piping Design workbench are used here. Substitute the appropriate resource or directory
when working in another workbench.
1. Click Tools - Report - Generate. The Generate Report dialog box displays.
2. Click the Open button and select the format you want to use for your report, in this case NewReport.
3. If you had defined a query in your report format then check Objects From Predefined Query.
4. If you select one or more objects in the document then check the option Currently Selected Objects.
5. Check All Objects in Document if you want a report on all objects in your document.
6. Click OK and select a format, such as HTML, when you are prompted. The report will be generated. It shows
values for all properties defined in your report format for all objects in the document that have them. Where
an object does not have a property the report displays asterisks.
Structure Preliminary Layout Version 5 Release 14 Page 119
7. Click Insert in Doc if you want to display these values in your document. To generate the report from a
schematic and insert it in a schematic, click on the Insert in Doc button and click anywhere in your
drawing. To generate the report from a 3-D document and insert it in a drafting document, click on the
Insert in Doc button and select the sheet or view in the specifications tree. Do not select a point in the
sheet. The XY Coord dialog box will pop up - enter the location where you want to insert the report. The
data will be placed at the location. It can be moved to another location later by click and drag.
8. Click Save As to save the report. Specify a file name and location.
Structure Preliminary Layout Version 5 Release 14 Page 120
3.In the Structure Preliminary Layout document, select all 3D geometry and any planes to be used to
generate drawings before entering the Drafting workbench.
Body Plans
To completely close the body plan, you must create a boundary using the Boundary command in
the Generative Shape Design workbench:
● Activate the wrapping surface
● Change to the Generative Shape
Design workbench
● Click the Boundary icon
● Select the wrapping surface.
Structure Preliminary Layout Version 5 Release 14 Page 121
6.Return to the 3D document and select a plane of a 3D part or a plane surface to define the projection
plane and the drawing view.
For more information on drafting capabilities, see the Drafting User's Guide.
Structure Preliminary Layout Version 5 Release 14 Page 123
In structure applications, you can, for example, define reference planes in each ship direction
to assist you place structural elements. You must define one plane system for each direction.
This task shows you how to create a regular asymmetric, a irregular asymmetric and a semi-
regular plane system.
● In the Generative Shape Design workbench, this icon is to be found in the Tools toolbar.
You can also select Insert -> Advanced Replication Tools -> Plane System...
● In the Structure Preliminary Layout workbench, this icon is to be found in the Structure
Grid Set toolbar. Having selected this command, you also need to select an entry in the
specification tree under which you want to create a new CATPart to locate your plane
system before proceeding. If you want to use an existing CATPart, then select that CATPart
in the tree.
● For Structure Functional Design, switch to the Generative Shape Design workbench.
● Regular symmetric
● Regular asymmetric
● Semi-regular
● Irregular symmetric
● Irregular asymmetric.
Symmetric plane systems are created in similar fashion to asymmetric plane systems. The
difference being that they have the same number of planes on either side of the origin.
If you select a plane, the center of the plane is automatically taken as the origin of the plane
system and an arrow appears showing the direction.
Or,
If you selected a plane and want to change the origin, click the Origin field and select a
point.
● Use the Reverse button in the dialog box or select the arrow in the geometry area to invert
the direction.
● The contextual menus in Direction and Origin fields let you create appropriate geometry
directly without having to exit the current command.
4. Optionally, check Allow secondary subset to group a number of planes in the primary
Note: The plane at the origin always belongs to the primary subset.
Select the subset in the specification tree to visualize all planes in this set in the geometry
area.
6. Click OK when done to create a plane system along the specified direction.
positive_or_negative_absolute_distance_from_origin<TAB>subset_prefix
where <TAB> denotes a TAB character
-4800 WEB
-4200 FRM
-3600 FRM
-3000 FRM
-2400 WEB
Structure Preliminary Layout Version 5 Release 14 Page 127
...
0 FRM
...
2300 WEB
2700 WEB
Notes:
It defines a plane system in one ship direction only but can contain as many subsets as
desired.
If you select a plane, the center of the plane is automatically taken as the origin of the plane
system and an arrow appears showing the direction.
Or,
If you selected a plane and want to change the origin, click the Origin field and select a
point.
● Use the Reverse button in the dialog box or select the arrow in the geometry area to invert
the direction.
● The contextual menus in Direction and Origin fields let you create appropriate geometry
directly without having to exit the current command.
5. Click Browse... and navigate to the file containing the plane system definition.
6. Click OK when done to create a plane system along the specified direction.
If you select a plane, the center of the plane is automatically taken as the origin of the plane
system and an arrow appears showing the direction.
Or,
If you selected a plane and want to change the origin, click the Origin field and select a
point.
● Use the Reverse button in the dialog box or select the arrow in the geometry area to invert
the direction.
● The contextual menus in Direction and Origin fields let you create appropriate geometry
directly without having to exit the current command.
● Specify the distance between two planes in your first group in the Spacing field.
● Enter the number of the last plane having the specified spacing in the End field.
● Click Add to confirm your first group.
The first group is identified in the list view control and the Start field incremented to display the
number of the first plane in your second group.
● Repeat to specify the spacing and the number of the last plane to be created with this
spacing, then click Add.
● Continue until satisfied.
Note: If the current spacing is the same as the spacing of the previous group, any new planes
are added to the previous group.
Structure Preliminary Layout Version 5 Release 14 Page 131
6. Optionally, check Allow secondary subset to group a number of planes in the primary
The plane system is updated. Changing the number of planes in any one group does not affect
the number of planes in other groups.
Note: Click in the list view control to cancel unwanted modifications that have not been
confirmed using Modify.
Removing Groups
Structure Preliminary Layout Version 5 Release 14 Page 132
7. Click OK when done to create a plane system along the specified direction.
Structure Preliminary Layout Version 5 Release 14 Page 133
This means that documents will be loaded in visualization mode, however, when editing
structural items such as stiffeners, shapes or molded forms, the item is automatically switched
to design mode. Any entities used to define the item you want to edit are also switched to
design mode. Any new structures are created in design mode in the document.
The cache system is managed via the Cache Management tab in the Options dialog box (Tools
-> Options -> Infrastructure -> Product Structure).
For more information see Customizing Cache Settings in the Customizing section of the
Infrastructure User's Guide.
Structure Preliminary Layout Version 5 Release 14 Page 135
1. Enter the Structure Preliminary Layout workbench (Start -> Equipment & Systems -
> Structure Preliminary Layout).
2. Add the Structure Preliminary Layout level to the specification tree:
● Right-click the root product and select Components -> New Component from the
contextual menu
● In the Part Number dialog box that appears, enter Structure Preliminary Layout,
then click OK.
Structure Preliminary Layout Version 5 Release 14 Page 136
3. Create a wrapping surface under Structure Preliminary Layout using the Wrapping
Surface command.
Note: It is recommended that one CATPart contain the set of reference planes in one
ship direction only.
5. Right-click and select Components -> New Component from the contextual menu to
create other levels as follows:
● Decks
● Transversal_Blk
● Longitudinal_Blk
● Unspecified_Blk
● Preliminary_Openings
● Basis_Bounded_Zones
● Composite_Bounded_Zones
6. You are now ready to start you preliminary design.
You can also add the Structure Functional Design level to the specification tree and
apply the same approach when managing functional design data.
Structure Preliminary Layout Version 5 Release 14 Page 137
A sample project resource management file is provided with this application and by default, the application will start with this file.
The following Structure Preliminary Layout-related resources are managed in this file.
Project Resources
● Feature dictionary managing object classes
● ID sequence number directory: contains the last sequence number that was generated for an object.
● Parts catalog.
● Project bounding box: defines overall project dimensions. Default dimensions (mm) are:
X+ 122000
X- -10000
Y+ 15200
Y- -15200
Z+ 21100
Z- -6500
The center of the box is positioned at the center of the document. Note that when the user creates the wrapping
surface, the bounding box is automatically re-dimensioned to include the hull form.
● Openings catalog:
● If there is more than one project at your site, then a project resource management file is made for each project. You can
select another project using the PRM command (Tools -> Project Management -> Select/Browse...).
● For more information on resources and how the resource management file is organized, see Understanding Project Resource
Management.
● To check required and optional resources in the PRM file for errors, see Checking a PRM File for Errors.
Structure Preliminary Layout Version 5 Release 14 Page 138
1.
From the appropriate CATIA workbench, launch the project resource management (PRM) command by
Note that when the dialog box opens the last project that you used is selected.
The Select tab lists all the XML projects setup found in the directory defined by the environment
variable CATDisciplinePath. This list begins with a CNEXT project which contains only the applications
Select the Browse tab. Once a project and a discipline have been selected, the dialog box lists all the
applications defined for the chosen discipline, the description of the selected application, and the list of
resources of that application. The list of resources displayed is always that for all applications shown in
the Applications column.
You should also note that the applications displayed include the applications under that particular
discipline, and any applications that are at the project level, which means above the discipline in the
PRM hierarchy. In the example below, the Piping discipline displays Piping Design and PID, which are
part of that discipline. It also displays the Equipment, Hanger Design and Penetration Management
applications, because some of their resources have been placed at the project level. The reason for
placing them at the project level is that most disciplines make use of these applications.
Structure Preliminary Layout Version 5 Release 14 Page 139
When the Project Resource Management dialog box first displays, as explained in Step 1, it may contain a
third tab - XML Parsing Error. This indicates that there is an XML syntax error in the file that corresponds
to the Project you have chosen.
Click the XML Parsing Error tab to display the error, as shown in the image below.
Structure Preliminary Layout Version 5 Release 14 Page 140
You will need to correct the PRM file to get rid of the error.
Errors in defining resources in the PRM file are explained in Checking a PRM File for Errors.
Structure Preliminary Layout Version 5 Release 14 Page 141
This tool will only check required and optional resources in the PRM file for errors. Required resources are those that the
application needs, such as catalogs. Optional resources are those without which the application can still be used, and example is
the ID sequencing number. There are other resources in the PRM file that are not checked at all - these are resources that add
functionality to the application. Examples of these are flags that are set through the PRM file - these cannot be checked for
errors because there is no way of telling what the user has set them to.
See Using the PRM Command for information about syntax errors in the PRM file.
The environment variable CATDisciplinePath should be defined to point to the directory where your PRM files are stored.
1. Click Tools - Project Management - Validation in the menubar to bring up the Project Management Validation dialog box. The
image below shows part of it without any selections having been made. The active project, discipline and application will be
selected by default when the dialog box opens.
2. Select a Project, Discipline and Application as necessary. If you select ALL in the Discipline and Application fields then the
entire project resource management file will be checked (required and optional resources only).
3. Click Apply after you have made your selection. The dialog box will display the resources that have errors. The errors are
explained below.
● If there are no errors then a message will state that all required - or optional - resources are okay, in the Status column.
● Select a resource to see more information about the error in the Selected Resource field below.
● Click on the column headings to sort by that heading.
● A Y in the Required column shows if a resource is required. No entry means it is an optional resource.
Structure Preliminary Layout Version 5 Release 14 Page 142
4. The errors are explained below. Also see the PRM task for more information.
● Resource definition has incorrect type: The value of the 'Type' field in the resource's PRM entry is incorrect. The Type field
refers to file type. See the PRM task for more information.
● Resource not found in the project management xml file: There is no entry for the resource in the PRM file.
● Resource Data not found: The file or directory corresponding to the resource cannot be found at the location defined in
the PRM file.
● Access specified for location for resource is not correct: Some entries have a field called 'Access'. This refers to the
permissions set for the file corresponding to the resource. One common error is that some files need to have access set to
RW (read-write) and not R (read only).
5. You can save the report. Click the Export button and enter a file name and location in the Save dialog box that displays. The
file must be saved in .htm format.
Structure Preliminary Layout Version 5 Release 14 Page 143
The project resource management (PRM) file identifies resources (such as line list catalogs, user dictionaries,
etc.) to the application. Specifically, the PRM file identifies each resource and its location (directory path). The
PRM file also organizes the resources by discipline and application, associating resources to specific applications.
Therefore, you get the correct resource, equipment catalog for instance, for the resource you are working in.
It's hierarchical structure allows you to share resources, so that you do not have to place duplicate copies of the
same resource in several directories.
The PRM file is also used for certain other purposes, such as setting flags. These are explained below.
A sample file is provided with this application, and it is best to make a copy of it and edit it. The default location
is ...intel_a\startup\EquipmentAnd Systems\ProjectData and the file is named Project.xml.
The application will function even if the user does not enter information particular to his site, but nothing can be
saved. Therefore, the first task an administrator needs to do is enter information relevant to his site or project.
1.If there is more than one project at your site you will need to make a project resource management file for
each project. You can name the file anything you want to and change its location too (see below). However,
you must set the variable in the Environment Editor. You do this by opening the Environment Editor dialog box
and entering against the line CATDisciplinePath the directory in which your project resource management
files are:
If you have more than one project resource management file then by default the application will start with the
file named Project.xml, if there is such a file, or the last file used. If you wish to select another resource
management file you must open it by clicking Tools - Project Management. Go to the Select tab and select
the file and discipline you need. This dialog box shows each resource available to you, unless the value of
"Visible" (see below) against a resource or application is set to No.
2.The resource management file is organized into several sections to make it easier to manage and utilize
resources. The image below shows its hierarchical structure, with an exception, which is explained below.
"Other disciplines" refers to other disciplines like Tubing, or AEC V4 to V5 Migration Discipline, that are placed
at the same level. They are not shown in this image for reasons of space.
Structure Preliminary Layout Version 5 Release 14 Page 144
The Project box refers to the project for which the PRM file has been created, and will frequently be identified
by the file name. In this case it is Project.xml.
When you look at the Project.xml file you will see that the resource listings begin with project resources.
Any resources you place under the heading Project Resources can be used by all applications that are included
in the file. In the sample file you will see items like zones, feature dictionary and application-generated object
names in this section. All disciplines and applications shown under project resources will be able to access the
resources identified under the heading project resources.
The next level is the discipline level. All resources placed under a discipline, such as Piping, can be used by
all the applications which are listed under it. In the example above, Piping Diagrams, Piping Design and
Equipment applications are shown under the Piping Discipline. Resources such as various catalogs and report
definitions are listed at the discipline level and can be accessed by all applications that belong to that
discipline.
The next level of resource management is the application itself. Any resource referred to at this level can only
be used by that application. Resources like catalogs, files that contain connector attributes and resolved parts
directories are listed at this level.
Equipment Arrangement and Hanger Design have been placed under several disciplines. These applications
are considered multi-discipline because their resources are used by all disciplines. When you are working in
these disciplines you may need Equipment or Hanger resources. However, in different disciplines you may not
use the same resources from Equipment Arrangement or Hanger Design and this structuring allows you to
place different different resources under each discipline. For instance, under the Piping Discipline, Equipment
Arrangement may have a different catalog (with Piping related equipment only) than under the HVAC
Discipline.
Equipment and Hanger applications have also been placed at the project resource level, primarily to allow
sharing of resources, under the headings "Equipment Application Resources" and "Hanger Design Application
Resources."
Structure Preliminary Layout Version 5 Release 14 Page 145
To explain: If you are working in Piping Design you are in the Piping Discipline. You select the discipline by
clicking Tools - Project Management, or simply by opening an application, which will activate the correct
discipline. For this to happen your PRM file must be set up correctly.
Now, while in the piping workbench, you want to place equipment in your document, and you launch
Equipment Arrangement. When you do so you will only have access to equipment resources that are identified
in the PRM file under the piping discipline, for instance the "piping equipment catalog," containing piping
related equipment. But let us assume that in your project you have certain types of equipment that are used
by all disciplines. You can create a catalog that contains all this common equipment and identify it under
"Equipment Application Resources" at the project level (it should not be identified under discipline also). When
you do this you will have access to this catalog when you open Equipment Arrangement under any discipline.
Some applications have the entry "Visible = yes". If you set the value to No then this application cannot be
used and will not be visible in the Tools - Project Management dialog box.
3. A resource entry looks like this:
</Resource>
● You should not change the Resource Name, even if you replace a resource with a different one.
● You can change the Description if you want to - this is a brief explanation of the resource.
● The Type field refers to file type. If the Type field says Catia, it refers to a file type unique to Catia, such
as .catalog. The type Misc is used for resources which are of a type not unique to Catia and must be
opened in another way. The type Path is similar, except that in the Location field only the directory in
which the resource is located is named.
● If your resources do not reside in Enovia, enter File in the Driver field. Define the Location field as
follows: As shown in the resource example above, the location entry is relative - it is relative to the entry
you made in the Environment Editor as shown in Step 1. The entry in the location field will be added to the
entry you had in the Environment Editor and it is in that location that the application will look for the
resource. Which is why it is preferable to enter absolute paths - including the drive letter - in the location
field.
● If your resources are Enovia-based, enter EnoviaV5 in the Driver field. For Enovia-based resources, all
you need to enter in the Location field is the file name of the resource without the file extension. For
instance, the catalog PipingParts.catalog would be entered as PipingParts.
● The Location field is sometimes used to enter a value for a flag or behavior, such as 0 or 1, or True and
False.
● Some resources have the entry "Visible = yes". If you set the value to No then this resource cannot be
used and will not be visible in the Tools - Project Management dialog box.
● Some resources have the entry Access="RW" or "R". These refers to file permissions: read-write or
read.
When you change from using file-based resources to Enovia-based resources: You must go through the PRM
file and change the "Driver" and "Location" entries as noted above. This must be done for all resources that
have been placed in the Enovia database.
Structure Preliminary Layout Version 5 Release 14 Page 146
4.The Project Resources listed in the sample Project.xml file are described in following sections, beginning
with the resources referred to under Project Resources:
● ID schema resources: The "location" lists the directory where the rules for naming objects are stored.
Use the default location provided in the sample file. You need to have this for every application you use. In
addition, there is an entry for "MultiDisciplineIDSchema." This location is used for objects -such as zones -
that are used by all disciplines.
● User dictionary resources: In the location field enter the name of the CATfct file for each application.
You do not need to enter the location. The CATfct file is used to store all the classes and attributes created
by you. The default names for CATfct files in each application are included in the sample project.xml file
and you should use these names unless you have created a different CATfct file, or changed the default
name. There is also a MultiDisciplineUserDictionary - this CATfct file can be referred to by all applications.
● Zones catalog: The zones that you create need to be stored in a catalog accessible to all users, because
they are shared. The default location is CATMldZone.catalog. Even though zones are only created in
schematic applications, other applications may use them when documents are moved from schematic to
3D. Enter a different name or location if you change them.
● Discrete values: Many attributes have discrete values and this directory is used to store them.
● Schematic driven flag: This is a flag that needs to be set for schematic driven routing and parts
placement. If the value of "Location" is set to 0 then individual users can check or uncheck an option that
allows schematic driven 3D design. If the value is set to 1 then the option "schematic driven" is always
selected and users cannot uncheck it.
● Delete Part On Run: This entry is used to control whether all parts on a run will be deleted when you
delete the run. If you enter the value of "Location" as 1 then the parts will be deleted. If you enter the
value 0 then the parts will not be deleted when you delete the run.
● Graphic representations: When you create graphic representations for a part you need a file in which to
store the categories (single, double, etc.). That file is created within an application, as you will see later.
There is also a file under Project Resources because the categories must be available to all applications. If
you add a new category you must include it in this file too. Enter a new location and file name if you want
to change them.
● Penetration openings catalog: The profiles of the holes you may want to make through walls and
partitions to pass pipes and ducts are noted in this catalog. If you make a new profile you must enter it
here too. Enter a new location and file name if you want to change them.
● ID Sequence Number directory: The IDSequenceNumbers directory contains the last sequence number
that was generated for an object. You should specify a location for it.
● Importer CATfcts: This lists the location of your CATfct files, and is used when migrating V4 models to
V5. If you change the location of the CATfct files you must enter the new location in the "Location" field.
You do not need to do anything if you continue to use the default location.
● Reference Grid System: Location of the CATPart that contains the reference grid definition used by
applications. You need to modify this entry if you change the location of the CATPart or rename it.
● Discipline super class: This is a text file that lists the object classes that will be visible in a class browser
when you are in the Equipment Arrangement workbench. You can have files at project, discipline and
application level. The filter will only work with a user-generated PRM file.
● Computed attributes: This entry shows the location of the ComputedAttributes.txt file. The computed
attributes contained in this file will display in the Properties dialog box. You can change the location of this
file, and update the PRM file accordingly. You can also change the entries in the file.
● Unique reference part number options & partially resolved reference part number options: These
two entries define how a placed part will be named. 'Unique reference' parts are those that have at least
one property (or all properties) that can have infinite values. An HVAC duct is an example. 'Partially
resolved' parts are those in which the values of all properties are defined by a design table. Valves are an
example. In this entry, if you enter 1 in the Location field then the name of the placed part will be derived
from the design table. If you enter 2 then the name will be derived from the object naming rules.
Structure Preliminary Layout Version 5 Release 14 Page 147
5.The next level, as explained above, is the Discipline level. Resources placed under the Discipline category
can be used by all the applications in that discipline.
The sample Project.xml file places the following resources at the Discipline level. Each entry names the file and
gives its default location. If you intend to use different resources, which is likely, then you must enter the new
file name and location, as appropriate. The following resources are referenced, but not all disciplines will have
all of these resources.
● Specifications catalog
● Insulation specifications catalog
● Material specifications catalog
● Standards catalog
● Design rules: You need to use the default location and file name
● Parts catalog name and location: contains parametric parts
● Piping lines shared catalog: The file where shared piping lines are stored and its location.
● Sample data directory: This is the location where the reports you run will be stored.
● Report definitions directory: The formats (definitions) you create for running reports are stored in this
directory.
6.In addition to resources placed at the Project and Discipline levels, resources are also placed at the
application level and are only available to the application under which they are placed. 2-D applications
have all or most of the following resources.
● Component catalog: The parts catalog.
● Shared instrument lines catalog.
● Annotation catalog.
● Sample data directory: When you create graphic representations for a part you need a file in which to
store the categories (open, closed, etc.). If you add a new category you must include it in this file too.
Enter a new location and file name if you want to change them.
● Design rules for Equipment Arrangement: This is used when assigning a part type to a 2D part.
● The parts catalog for Equipment Arrangement: This is used when assigning a part type to a 2D part.
● Graphic representations file: When you create graphic representations for a part you need a file in which to
store the categories (single, double, etc.). If you add a new category you must include it in this file too.
Enter a new location and file name if you want to change them.
● Connector attributes file: This file lists the attributes that will be inherited (from the part) by a connector
when you are placing it on a part. If you want to make changes to the attributes you want a connector to
inherit you must do it in this file. Do not change the name or location of this file.
● Resolved parts: When you place a parametric part in a document it assumes specific dimensions. Once a
part has specific dimensions it is placed in the Resolved Parts catalog. The location of the default Resolved
Parts catalog is listed here.
● Design rules: You need to use the default location and file name.
● Parts catalog name and location: contains parametric parts
● Sample data directory: This is the location where the reports you run will be stored.
● Report definitions directory: The formats (definitions) you create for running reports are stored in this
directory.
● Graphic Replacement True View Catalog: This is the catalog in which the 2-D equivalents of 3-D endstyles
are stored. See Drawing Production for more information.
● Growth Factor: Some applications allow you to reserve space in some parts for future growth. You can, for
instance, reserve space in a conduit for future growth. The space saved for future growth will be equal to
Structure Preliminary Layout Version 5 Release 14 Page 148
the value you enter in the "Location" field. If you enter 0.2 it means that 20 percent of the space in a
conduit will be reserved for future growth and you will only be allowed to use 80 percent of the space in it.
7.The AEC Migration Discipline refers to a product that enables you to migrate V4 models to V5. It has Piping
Design, Piping and Instrumentation Diagrams, Equipment Arrangement, Tubing Design and HVAC Design
resources under it.
Most resources have been described above and do not need further explanation. Enter the location and file
names if they are different from those in the sample Project.xml file.
In addition, under the heading AEC V4 V5 Migration there are several options you should know about. They
are explained below.
AEC V4 V5 Migration
There are several options that you need to set to True or False. The first several are about migrating data to
Piping and Instrumentation Diagrams, Piping Design, Equipment Arrangement, Tubing Design and HVAC
Design and Structures. If a V4 model has data of all these types, but you have set two of them to False, then
you will only receive V5 data relating to the applications set to True. If you want data of all types to be
migrated then you must set all the options to True.
● Create runs without parts: If set to True a run will be migrated without the parts.
● ImportPipingLine (or other type of line): If set to True a line will be created in the V5 Piping Line catalog if
it does not exist. When set to False, the migration process will stop if the line does not exist in V5.
● Mapping Table: You need to enter the location and name of the migration mapping table if you change the
default name or location.
● MigratedPIDNoShowSheetFormat: The sheet format (also known as title block) will not be visible if the
value of "Location" is set to False.
● MigrateXXXWithMissingLines: If set to True the sheet will be migrated even if some Lines cannot be. If set
to False the migration process will stop if missing lines are encountered.
● MigratedXXXSheetSize: Enter the size in the Location field: Letter, Legal, A0, ISO/A1, ISO/A2, ISO/A3,
ISO/A4, ISO/A, ANSI/B, ANSI/C, ANSI/D, ANSI/E, ANSI/F, ANSI).
● MigrateEquipmentWithMissingGeometry: If set to True, Equipment with missing geometry will be migrated.
If set to false, such equipment will not be migrated.
● MigrateObjectWithMissingAttributes: If set to True, objects will be migrated even if some of the attributes
do not exist in V5.. If set to False, the objects will not be migrated if some of the attributes do not exist in
V5.
8.In addition to some of the resources explained above, the Structure Discipline includes the following
resources or entries:
● Sections catalog: If you change the default location of the AISC_BigScale catalog then enter the location in
this entry. The location should include the directory AISC in which the catalog should reside, so that the
path reads: ......AISC\AISC_BigScale.catalog.
● Structure sections path: This is the location of the directory where resolved structure sections are located
before they are extruded for placement in a document.
● Structure Thickness List: This is the location of the thickness list sample file, which contains the list of
thicknesses that can be applied to a plate.
● Structure openings catalog: Location of the openings parts catalog.
● Structure materials catalog: Location of the structure materials catalog.
● Structure detail design: Location of the catalog that contains user defined features.
● Naming section characteristics: Location of the NLS file that lists names of sections whose names should
not be changed. This is for internal use. Do not change anything in this entry.
● Structure Functional Connections Catalog: Location of the Structure Functional Connections Catalog. This
Structure Preliminary Layout Version 5 Release 14 Page 149
Note: In the application, these object classes are managed via the class browser.
The feature dictionary file has the extension CATfct. To view the sample feature dictionary:
1.Open the CATStrPreliminaryLayoutSample.CATfct file.
The Classes View displays all the classes available in the document, i.e. the predefined classes included in the
application.
Structure Preliminary Layout Version 5 Release 14 Page 151
Existing attributes or properties are displayed in the Inherited attributes and Local attributes boxes. Inherited
attributes are those inherited from the super class to which this class belongs. Local attributes are properties added
to the class itself.
The following table lists the object classes and corresponding attributes provided in the sample dictionary.
Wrapping Surface ● Type
Molded Form ● BulkheadIntegrity
● FrameLocation
● InsulationTreatments
● PaintSchedule
● SurfaceTreatments
● Tightness
Bounded Zone or Compartment ● FunctionNumber
● HVACCategory
● Location
● PaintThickness
Attributes or properties assigned to object classes can be browsed via the Properties dialog box (right-click feature in
specification tree and select Properties from the contextual menu).
You can add sub-classes and attributes to the sample dictionary, or if you want, you can create a new feature
dictionary. You may, for example, want to create several sub-classes under wrapping surface in the sample
dictionary for deckhouses, internal and external wrapping surfaces.
The feature dictionary (CATfct file) must be kept in the default location. If you change its name or create a new
dictionary, you must make the corresponding change in the project resource management file.
You can also define or modify the object naming rules of objects integrated into the feature dictionary in the Feature
Dictionary Editor workbench.
For more information, see Using the Feature Dictionary Editor in the Infrastructure User's Guide.
Structure Preliminary Layout Version 5 Release 14 Page 152
You may want to modify these rules to suit your own requirements:
● For objects integrated into the feature dictionary, use the Define/Modify ID Schema
command in the Feature Dictionary Editor application.
● For all other objects, you must edit XML files directly.
By default, sample XML files are located in the install_folder under
startup/EquipmentAndSystems/StructurePreliminaryLayout/DataDictionary.
Modifying or defining object naming rules is typically performed by an administrator.
For more information, see Modifying the Object Naming Rules in the Infrastructure User's
Guide.
Structure Preliminary Layout Version 5 Release 14 Page 153
All other objects listed in the browser derive from the above main objects, for example Deck
derives from CATSPLMoldedForm. These objects or sub-classes are managed in the sample
feature dictionary.
For information on object attributes and methods, see Structure Preliminary Layout in the
Reference Information section of the Knowledge Expert User's Guide.
Structure Preliminary Layout Version 5 Release 14 Page 154
Interoperability
Working with ENOVIA LCA
Working with SmarTeam
Structure Preliminary Layout Version 5 Release 14 Page 155
ENOVIA LCA offers two different storage modes: Workpackage (Document kept - Publications
Exposed) and Explode (Document not kept). Workpackages let you organize data efficiently
in easily manageable units. They also facilitate concurrent engineering.
In Structure Preliminary Layout (SPL), data is saved corrected in both modes, however,
Explode mode is the recommended mode since this mode lets you manage Structure
Preliminary Layout objects individually in ENOVIA. All Structure Preliminary commands are
thus available at all times.
Structure Functional Design (SFD) has been configured to work in the Workpackage mode.
The Structure Functional Design workbench is set up such that the user cannot create
functional objects without first creating a panel system. When first entering the workbench,
all other commands are therefore unavailable. The panel system has been defined as an
ENOVIA LCA workpackage.
Ship Structure Detail Design (SDD) has been configured to work in the Workpackage mode.
In Ship Structure Functional Design, the block scheme and paneling system have been
defined as ENOVIA LCA workpackages.
The safe save mode means that certain commands (Automatic Connection, Manual
Connection, Connection Body and Mitering) are unavailable (i.e. grayed). You cannot make
connections or miter cuts between two different workpackages.
Recommendation: Open the paneling system in a new window and create connections within
the same workpackage.
Structure Preliminary Layout Version 5 Release 14 Page 157
Recommended Methodology
The recommended methodology for working with ENOVIA LCA is:
● Create a product in ENOVIA
● Work on your design in CATIA, whether from scratch or modifying an existing design
● Save your CATIA data in ENOVIA.
● In the Product Structure workbench of CATIA V5, click the Connect to Enovia LCA icon to establish the connection
between CATIA V5 and ENOVIA LCA.
1. In the ENOVIA home page, open the Engineering Life Cycle folder and double-click the Product Classes folder.
2. In the Product Class browser, click the New Product Class Root icon in the topmost toolbar.
3. Enter a meaningful name for your product class root in the Product Class ID field and then click Add.
4. Right-click the product class root you have just created and select New -> Product from the contextual menu.
5. Enter a meaningful name for your product in the Product ID field and then click Add.
6. Don't forget to click the Save icon in the topmost toolbar to save the structure in ENOVIA.
Structure Preliminary Layout Version 5 Release 14 Page 158
This is what you see in CATIA: the ENOVIA product is mapped to the CATIA document root.
Note: You also need to send any existing workpackages you need from ENOVIA. If you send a workpackage, the product is
also sent - you do not need to send both.
1. In the Product Structure workbench of CATIA V5, click the Save Data in ENOVIA LCA Server... icon in the
Structure Preliminary Layout Version 5 Release 14 Page 159
The Save in ENOVIA V5 dialog box appears showing objects to be saved and set to the correct save mode and save
options.
A Save in ENOVIA V5 progress bar lets you monitor the progress of the operation.
In ENOVIA LCA:
● The Structure Functional Design panel system, and Ship Structure Detail Design block scheme and paneling
system are each saved as one document.
● All Structure Preliminary Layout items created under the CATIA root and any new components are saved in Explode
mode; new products are saved in Workpackage mode.
No doubt you will need to refresh the ENOVIA product structure to view the data you have just saved.
For more information, see the CATIA / ENOVIA Interoperability User's Guide and the appropriate ENOVIA LCA guide.
Structure Preliminary Layout Version 5 Release 14 Page 161
Managing multiple design options corresponds to the ENOVIA LCA capability of managing part
versions. The recommended methodology to do so is:
The ENOVIA LCA Search Tree enables you to query the ENOVIA LCA database for
compartments by type.
For more information, see Manage Searches in the ENOVIA LifeCycle Applications Engineering
LifeCycle guide.
Structure Preliminary Layout Version 5 Release 14 Page 162
Penetration Management
This section discusses penetration management, which refers to the process of routing a pipe or a
duct - as an example - through a structure. If you are working with a ship, for instance, you may
need to create penetrations through bulkheads, move objects, or reroute your pipe or duct, in order
to do so.
Note: The penetration management function works with the ENOVIA environment only - and you
must be in the ENOVIA product structure.
You must take certain setup steps before using this function. See Penetration Management Setup to
learn how to set up the function.
2. The object you selected will appear in the Selected object to query field. The
Penetration Management dialog box lists the penetrations associated with the object you
have selected and the current status. To retrieve geometry that has not been loaded from
ENOVIA, select the penetrations you want to query, then click the Load Geometry button
3. To create a cutout sketch you will select one or more penetrations from the list. This
process is explained in Creating a Cutout Sketch.
Structure Preliminary Layout Version 5 Release 14 Page 165
The sketch may be created using penetration design rules, by selecting from a list of cutout
shapes, or by creating the cutout manually. When creating a cutout using design rules, the
cutout shape and clearance are defined by penetration cutout rules and the penetration
shapes catalog.
1. Select the penetration from the Penetration Management dialog box. The related objects
highlight in your document, and will be used in calculating the penetration location.
2.
Click the Create Cutout Sketch button and the Create Cutout Sketch box will
display. Select the Rules tab is you want to use the design rules to create a cutout sketch.
Structure Preliminary Layout Version 5 Release 14 Page 166
The Create Cutout Sketch dialog box displays the shape and size for the proposed sketch,
as computed by the design rules. Click OK if you accept it.
3. If, instead, you want to select a sketch from a catalog, then select the Standard Catalog
4. If you want to create a sketch then select the Manual Sketch tab. The Sketcher will open.
Create your sketch and click the Exit Workbench button. The sketch will be placed.
5. The Place on Side buttons allow you to place the cutout sketch on one side or the other of
By adding an object to a penetration you are associating the cutout sketch you created earlier
to the penetration record. Before you take this step you must save the document in ENOVIA.
1. With your document open click the Penetration Management button and query the
penetrations. The Penetration Management dialog box will open listing the active
penetrations. Select the penetration for which you want to add an object.
2.
Click the Add Object to Penetration button . The Add Objects to Penetration dialog
box opens displaying the Penetration ID you selected.
3. Select the cutout sketch(es) in your document, or from the specifications tree, that you
want to add to the penetration and click OK. The objects are added.
4. Click OK to close the Penetration Management dialog box.
Structure Preliminary Layout Version 5 Release 14 Page 169
If the Penetration Management Tools toolbar is not displayed then click View - Toolbars and
select it.
Penetration management refers to the process of routing a pipe or a duct - as an example -
through a structure. If you are working with a ship, for instance, you may need to create
penetrations through bulkheads, move objects, or reroute your pipe or duct, in order to do so.
The penetration management function works within the ENOVIA environment only - you must
be in the ENOVIA Product Structure.
1. Modify the project resource management (PRM) file to reflect the location/names of your
resource files. The penetration function uses three PRM resources. The names are:
PenetrationCutoutRules, PenetrationOpeningsCatalog, and
PenetrationShapesCatalog. Sample rules and catalog are provided with this application.
The location is ...intel_a\startup\components\PenetrationCatalog. See
Understanding Project Resource Management for more information about the PRM file.
2. The outlines of openings are dependent on the shapes defined in the Penetration Shapes
catalog. You cannot define an outline in the design rules that does not have a
corresponding shape in the catalog. Shapes defined in the sample catalog are: oblong,
round, rectangular, square and rectangular radius corner. You can change the values of
the parameters of the shapes in the catalog, and you can add new shapes to it. You can
remove, replace or rename the sample shapes.
Each shape is a parametric part created with the Part Design product, and is stored in the
same directory as the catalog. The oblong shape document, for instance, is
OblongShape.CATPart. See Part Design documentation for information about using that
product.
To add a shape you must create it with Part Design and store it in the catalog using
standard catalog building procedures. See Creating a Catalog and associated tasks in the
Catalog section to learn more about creating and modifying catalogs. These are standard
parametric parts and there are no special requirements for building them. When building
new shapes you should note that the description name you use in the catalog is the name
that will display when you are creating a cutout sketch.
Structure Preliminary Layout Version 5 Release 14 Page 170
3. Most penetration cutout designing will be done using the design rules, although you have
the capability of manually defining cutouts, as explained later in this section. The rules
work with the shapes in the catalog to determine the final size of the opening. You can add
various parameters to the rules using Knowledgeware. However, the function of the
sample rules supplied with this application is mainly to determine the shape of the outline,
based on the shapes available in the catalog; and calculate the size of the opening. The
cutout size is calculated from the sizes of the objects involved in the penetration, with the
addition of required clearances.
4. Design rules can be modified, and new ones created, using Knowledgeware. However,
there are certain points you must incorporate in a design rule for it to work correctly with
this function. The following information is meant for an administrator, or whoever is
creating the design rule. You can see examples in the sample rule, which is reproduced
below. A penetration cutout rule should:
● Create a variable (defCutout) to hold the DefinePenetrationCutoutShape object, which
will communicate the cutout definition to the penetration management command.
● Calculate the size of the cutout, using attributes of the penetrating and penetrated
objects.
● The NewDefinePenetrationCutoutShape function creates the temporary object that
holds the cutout definition. The penetrating object (p1) and penetrated object (p2) are
specified.
● The ShapeName attribute selects the parametric part that defines the shape.
● The SkewTolerance attribute sets the allowed SkewTolerance for the penetration.
● The SetAttributeDimension function (or another SetAttributeXXX function) specifies a
parameter name in the parametric part, and its value. This function is used repeatedly
to set each parameter of the parametric part.
Documents are managed in projects in SmarTeam. You must therefore create a SmarTeam
project.
To ensure seamless integration, you must have both a CATIA and SmarTeam session
running.
2. Still in CATIA, select Connect from the SmarTeam menu to establish your CATIA -
SmarTeam connection.
Workbench Description
The Structure Preliminary Layout Version 5 application window looks like this:
See Openings
Specification Tree
Icons displayed in the specification tree and specific to Structure Preliminary Layout workbench
identify:
Wrapping surface
Molded form
Opening
Bounded zone
Composite volume
Structure Preliminary Layout Version 5 Release 14 Page 177
Customizing
Before you start your first session, you can customize the way you work to suit your habits.
This type of customization is stored in permanent setting files: these settings will not be lost if
you end your session.
❍ The Design tab lets you set default colors for main items.
❍ The Offset Data tab lets you manage the output formats for your offset data.
Two other settings, Keep link with selected object and Create external references
as shown elements, are also needed to ensure associativity between the items you
create and entities selected to create them, and to ensure better management of the
import mechanism, respectively.
4. Select Infrastructure -> Part Infrastructure -> General, then select Keep link
Design Settings
The Design tab contains two categories of options: Default colors and Import option.
Default Colors
Use the color chooser to define the default color for molded forms, bounded zones
(compartments) and boundaries.
Import Option
Selecting this option stores external references (surfaces and planes) used to create molded forms
and compartments in associated CATParts.
Click to clear this option to improve performance by significantly reducing data size.
If cleared, external references are not stored in the CATPart. When editing, necessary geometry is
loaded in transparent fashion.
By default, this option is selected.
Structure Preliminary Layout Version 5 Release 14 Page 179
Drafting
The Drafting tab contains five categories of options letting you customize your lines drawings:
● Geometry to display
● Waterlines view
● Waterline position
● Body plan
● Midship position
Geometry to Display
Select the option defining how the shape of the ship is shown on lines drawings: Wireframe only or
Surface only, or Both.
Waterlines View
Select the option defining the view looking at the ship from above: Symmetrical or Asymmetrical
depending on whether or not the ship is symmetrical about the centerline. This generates a half-
breadth or full-breadth view respectively.
Waterline Position
If this option is selected, the waterline is located at the selected reference plane in the 3D document.
If this option is selected, the waterline is located along the Z direction at the absolute coordinate
entered in the Absolute Z coordinate box.
Body Plan
Select the option defining the view showing the shapes of the frame lines: Symmetrical or
Asymmetrical depending on whether or not the ship is symmetrical about the centerline.
The generated view is made of two parts. If the ship is symmetrical, only one side of the ship is
shown (usually the portside) and the right-hand part looks aft at the forward portside of the ship,
while the left-hand part looks forward at the after half of the portside. If the ship is asymmetrical,
both sides of the ship are shown.
To generate this drawing, you need to define the midship position (see below).
Midship Position
If this option is selected, the midship is located at the selected reference plane in the 3D document.
If this option is selected, the midship is located along the X direction at the absolute coordinate
entered in the Absolute X coordinate box.
For the options in this tab page to be taken into account, you need to select Project 3D
wireframe, Project 3D points and Apply 3D specifications located in Mechanical Design -
> Drafting -> View -> Geometry generation/Dress-up frame.
By default, Project 3D wireframe and Project 3D points check boxes are cleared, and
the Apply 3D specifications check box is selected.
Structure Preliminary Layout Version 5 Release 14 Page 183
Offset Data
The Offset Data tab contains one category of options to manage output formats, for example HTML
pages or CSV files, for your offset data: Global.
Global
Use New, Edit or Delete to add new stylesheets, and edit or delete existing ones.
Sample stylesheets (OffsetDataAsHTML.xls and OffsetDataAsCSV.xls) for two formats, HTML and CSV
respectively, are provided. By default, they are located in the installation folder under
OS/startup/EquipmentAndSystems/StructurePreliminaryLayout/StyleSheet.
Select this check box to take all stylesheets into account and choose the format of your output data
when interactively generating your offset data.
By default, this check box is cleared and only XML files will be generated.
Structure Preliminary Layout Version 5 Release 14 Page 184
For more information on customizing standard views, see Creating a multi-view: standard view customization in the Infrastructure
User's Guide.
This task shows how to customize default standard views to shipbuilding conventions.
Note: You only need to customize two views, the iso and top view.
1. Click the Named Views icon in the View toolbar or select Named Views... from the View menu.
2. In the Named Views dialog box that appears, select the view you want to customize, for example *iso, then select Properties.
Note: The view direction and orientation are saved in the CATSettings directory.
Structure Preliminary Layout Version 5 Release 14 Page 185
5. Click OK in the Views & Layout dialog box and Repeat for the top view.
Structure Preliminary Layout Version 5 Release 14 Page 186
Browse the standard views in the View toolbar to check your customization.
Structure Preliminary Layout Version 5 Release 14 Page 187
Glossary
B
basic wrapping surface A component of a complete wrapping surface in cases where the hull form
cannot be defined by a single surface.
boundary A surface fixing the limit of a compartment and representing walls, ceilings
and floors. Formed by the intersection of a compartment and a molded
form.
bounding box A bounding box defines the overall dimensions of a project. The center of
the box is positioned at the center of the document. To visualize the
bounding box, browse project data.
C
compartment A volume in a ship bounded by horizontal and vertical molded forms
and/or wrapping surfaces representing structural decks and bulkheads.
Compartments are used to organize the space within a ship into functional
volumes. Typical examples are void, habitable, machinery/equipment.
complex compartment A region in a ship grouping two or more compartments.
coordinate system System identifying the main
directions of the ship that
lets you properly locate and
orient structural parts.
Defines a right-handed
system of orthogonal axes.
Structure Preliminary Layout Version 5 Release 14 Page 188
D
deck A molded form. Decks are horizontal partitions that subdivide the interior
of a ship into compartments. Part of a ship corresponding to the floor of a
building.
deckhouse A wrapping surface. A decked-over structure above the upper deck.
Generally created from scratch.
F
feature dictionary The document in which object classes are managed.
H
hull form A wrapping surface of no thickness. A watertight envelope representing
the hull of the ship. The hull form serves as the limit for structural parts.
M
molded form Surface used to divide the ship into main volumetric regions or
compartments. Typical molded forms are transverse and longitudinal
bulkheads, and decks. The default type is molded form.
O
opening Holes in molded forms creating using the sketcher or taken from a catalog.
orientation Ship coordinate system and hull form orientations are managed by the
administrator as a project resource. When you create wrapping surfaces
and molded forms, you are asked to confirm surface orientation
(represented by a combination of two named vectors). These orientations
let you properly position items.
● hull: inboard/outboard
● deck: top/bottom
● transverse bulkhead: fore/aft
● longitudinal bulkhead: portside/starboard
Orientation also defines a sense for the thickness of the item and is used
Structure Preliminary Layout Version 5 Release 14 Page 189
P
A class of ships. It is managed as a project resource and is identified by a
project
name.
R
reference plane A GSD plane used as a reference or limiting element when creating molded
forms. Must be created in a new part using Generative Shape Design. A
set of reference planes can be defined in all three ship directions.
W
wrapping surface Refers to styling surfaces and hullforms. Also used to define the
deckhouse. Usually an imported surface. Has two orientations (inside,
outside).
X
XML XML (Extensible Markup Language) is a standard format that can be used
as a simple way to exchange data.
Results and how results are presented are two separate entities, so you
can customize your own style sheet to present the results the way you
want without impacting the results themselves.
XML makes documents smarter and more portable. You can, for example,
publish the results to a web browser or to your company database. XML
processors letting you generate HTML pages corresponding to the XML file
and style sheet are available on the market.
Structure Preliminary Layout Version 5 Release 14 Page 190
Index
A
about
compartment
feature dictionary
molded form
project resources
wrapping surface
B
basic wrapping surface
boundary
bounding box
browse
project data
project resources
bulkhead
C
command
boundary
compartment
Structure Preliminary Layout Version 5 Release 14 Page 191
complex compartment
edit project
IDF export
molded form
Object Relationships
Offset data
opening
Plane System
project management
wrapping surface
compartment
about
complex
creating
feature dictionary
modifying
splitting
complex compartment
coordinate system
creating
boundaries
compartment
complex compartment
deckhouse
hull form
Structure Preliminary Layout Version 5 Release 14 Page 192
opening
reports
wrapping surface
customizing
design settings
lines drawings
offset data
standard views
D
deck
deckhouse
deleting openings
design settings
documents
saving
drawings
customizing
lines
E
ENOVIA LCA integration
penetration management
recommended methodology
workpackage
Structure Preliminary Layout Version 5 Release 14 Page 193
F
feature dictionary
form coefficients
G
general hull characteristics
generating
offset data
reports
H
hull form
complex
creating
hydrostatic data
naming conventions
hydrostatic data
I
IDF format
imported surface
ENOVIA LCA
Structure Preliminary Layout Version 5 Release 14 Page 194
SmarTeam
K
knowledge expert
L
lines drawings
customizing settings
M
managing
project resources
compartment
molded form
splitting a compartment
wrapping surface
molded form
about
creating openings
external
feature dictionary
modifying
multiple
Structure Preliminary Layout Version 5 Release 14 Page 195
removing openings
simple
N
naming conventions
hull form
naming rules
O
object naming rules
generating
opening
creating
deleting
Options settings
orientation
P
penetration management
penetrations
add object
associate
query for
setup
Structure Preliminary Layout Version 5 Release 14 Page 196
project
bounding box
browsing
creating reports
exporting data
managing data
project resources
Access field
checking errors
file
Location field
selecting project
Type field
Visible
Q
query for penetrations
R
reference plane
removing openings
report
define a query
define format
Structure Preliminary Layout Version 5 Release 14 Page 197
format
generate
insert in drawing
query recommended
S
save documents
SmarTeam integration
T
Tools Options - Structure Preliminary Layout
Design
Drafting
Offset Data
type, change
V
viewing
object relationships
W
workpackage
wrapping surface
about
creating
Structure Preliminary Layout Version 5 Release 14 Page 198
deckhouse
feature dictionary
hull form
hydrostatic data
modifying
replacing
X
XML