Patran 2022.2 Reference Manual Part 1 Basic Functions
Patran 2022.2 Reference Manual Part 1 Basic Functions
Reference Manual
Part 1: Basic Functions
Americas Europe, Middle East, Africa
5161 California Ave. Suite 200 Am Moosfeld 13
University Research Park, Irvine, CA 92617 81829 Munich, Germany
Telephone:(714) 540-8900 Telephone: (49) 89 431 98 70
Toll Free Number: 1 855 672 7638 Email: europe@mscsoftware.com
Email: americas.contact@mscsoftware.com
Japan Asia-Pacific
Shinjuku First West 8F 100 Beach Road
23-7 Nishi Shinjuku #16-05 Shaw Tower
1-Chome, Shinjuku-Ku Singapore 189702
Tokyo 160-0023, JAPAN Telephone: 65-6272-0082
Telephone: (81) (3)-6911-1200 Email: APAC.Contact@mscsoftware.com
Email: MSCJ.Market@mscsoftware.com
Worldwide Web
www.mscsoftware.com
Support
https://simcompanion.hexagon.com/
Disclaimer
This documentation, as well as the software described in it, is furnished under license and may be used only in accordance with the
terms of such license.
Hexagon reserves the right to make changes in specifications and other information contained in this document without prior notice.
The concepts, methods, and examples presented in this text are for illustrative and educational purposes only, and are not intended
to be exhaustive or to apply to any particular engineering problem or design. Hexagon assumes no liability or responsibility to any
person or company for direct or indirect damages resulting from the use of any information contained herein.
User Documentation: Copyright 2022 Hexagon AB and/or its subsidiaries. All Rights Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any reproduction or distribution of this
document, in whole or in part, without the prior written consent of Hexagon is prohibited.
This software may contain certain third-party software that is protected by copyright and licensed from Hexagon suppliers. Additional
terms and conditions and/or notices may apply for certain third party software. Such additional third party software terms and
conditions and/or notices may be set forth in documentation and/or at http://www.mscsoftware.com/thirdpartysoftware (or successor
website designated by Hexagon from time to time).
The Hexagon logo, Hexagon, MSC Software logo, MSC, MSC Nastran, Marc, Patran, Dytran, and Laminate Modeler are trademarks
or registered trademarks of Hexagon AB and/or its subsidiaries in the United States and/or other countries.
NASTRAN is a registered trademark of NASA. PAM-CRASH is a trademark or registered trademark of ESI Group. SAMCEF is a
trademark or registered trademark of Samtech SA. LS-DYNA is a trademark or registered trademark of Livermore Software
Technology Corporation. ANSYS is a registered trademark of SAS IP, Inc., a wholly owned subsidiary of ANSYS Inc. ACIS is a
registered trademark of Spatial Technology, Inc. ABAQUS, and CATIA are registered trademark of Dassault Systemes, SA. FLEXlm
and FlexNet Publisher are trademarks or registered trademarks of Flexera Software. PostScript is a registered trademark of Adobe
Systems, Inc. PTC and Pro/ENGINEER are trademarks or registered trademarks of Parametric Technology Corporation or its
subsidiaries in the United States and/or other countries. Unigraphics, Parasolid and I-DEAS are registered trademarks of Siemens
Product Lifecycle Management, Inc. All other brand names, product names or trademarks belong to their respective owners.
P3:V2022.2:Z:BASC:Z:DC-REF-PDF
Documentation Feedback
At Hexagon, we strive to produce the highest quality documentation and welcome your feedback. If you have comments
or suggestions about our documentation, please write to us at documentation-feedback@mscsoftware.com.
Please include the following information with your feedback:
Document name
Release/Version number
Chapter/Section name
Topic title (for Online Help)
Brief description of the content (for example, incomplete/incorrect information, grammatical errors, information
that requires clarification or more details and so on.)
Your suggestions for correcting/improving documentation
You may also provide your feedback about Hexagon documentation by taking a short 5-minute survey at:
http://msc-documentation.questionpro.com.
Note: The above mentioned e-mail address is only for providing documentation specific feedback. If you have
any technical problems, issues, or queries, please contact Technical Support.
Contents
Patran Reference Manual
Contents
1 Introduction to Patran
Introducing Patran . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Patran Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Using Patran for Engineering Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
HTML Based Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Patran Workspace
Modeling Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
The Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Menu Bar Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
The Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
System Tool Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Mouse Function Tool Palette. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Viewing Tool Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Display Tool Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Model Orientation Tool Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Labeling and Sizing Tool Palettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
The Applications Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Application Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Command Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6 Viewports
Viewport Concepts and Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Viewport Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Viewport Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Viewport Display Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Viewports and Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Contents vii
8 Viewing a Model
View Concepts and Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Current View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Named Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Model Space. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Screen Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Viewing Coordinate System Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Fitting a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
View Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Perspective Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
View Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
The Viewing Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Viewing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Fit View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
Select Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
Select Corners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
Managing the Parameters of Perspective Viewing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
9 Display Control
Display Concepts and Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Global and Local Display Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Display Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Rendering Styles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Finite Element Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Erasing and Plotting Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Shrinking Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
viii Patran Reference Manual
Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Coordinate Frames. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Named Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Spectrums . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Color Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Light Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
The Display Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Display Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
10 Preferences
Preferences Concepts and Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Analysis Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Model Tolerance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Warning Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Hardware Rendering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Representing Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Model Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
The Preferences Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Preferences Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Mapping Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
11 Tools
The Tools Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Tools Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Laminate Modeler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Random Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Analysis Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
Mass Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Beam Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
Named Regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
Model Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Properties Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
Load Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
Model Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
Element Quick Create. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Property Data Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
Mass Property Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
Contents ix
Contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
Load cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742
Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744
Analyses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747
Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748
Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
13 Random Analysis
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
Features of MSC Random. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
Advantage over Utility version of MSC Random. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
Architecture of MSC Random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754
Basic Random Analysis Theory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755
Theory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
Cross-Power Spectral Density and Cross-Correlation Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758
Cumulative Root Mean Square (CRMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Coherence Function or Schwarz's Inequality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Numerical Integration Using Log-Log Approximation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Von Mises Stress in Random Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Random Analysis Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
Process Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
Frequency Response Analysis Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762
Frequency Response Analysis Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764
Random Analysis Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764
Using MSC Random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765
Output Files:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765
Example 1: Cylinder subjected to base PSDF input.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767
Required Steps to Perform Random Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768
FEM Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769
Frequency Response Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780
Frequency Response Analysis Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781
Random Analysis – XY Plot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788
Random Analysis – RMS Stress Fringe Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
Example 2: Table - Subjected to Simultaneous Random Excitation in Three Directions . . . . . . . . . . . . . 810
Random Input Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811
Example 3: Plate - Subjected to Pressure and Point Load with Cross Spectrum Input . . . . . . . . . . . . . . 823
Frequency Response Analysis Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824
Contents xi
References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Appendix A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Frequency Response Setup Using Patran Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845
Frequency Response Setup - Patran Interface(Contd) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845
Frequency Response Setup - Patran Interface(Contd) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848
A File Formats
The Neutral System Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858
The Neutral File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858
Neutral File Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858
Neutral File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 860
Session File/Journal File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896
IGES File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 898
PATRAN 2.5 Results Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 901
Displacement or Force Results Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 901
Nodal Results Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 904
Element Results Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906
Beam Results Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907
PATRAN 2.5 Results Template Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 908
B Printing Options
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912
Device-dependent Hardcopy File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912
Additional Information for Printers/Plotters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912
If Your Plot Does Not Turn Out as Expected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913
Hardware Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913
Supported Hardware for Patran Hardcopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 914
C Mass Properties
Summary of Mass Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916
D List Processor
Understanding the List Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 920
xii Patran Reference Manual
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 920
Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 921
Finite Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944
Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948
955
Chapter 1: Introduction to Patran
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
1 Introduction to Patran
Introducing Patran
Patran is an open software system, used primarily in mechanical engineering analysis. It is comprised of the
following components:
Analysis Modules
Integrated analysis capabilities for structural, thermal, fatigue, and other types of mechanical analysis.
Analysis Preferences
Linkage to commercial analysis solvers and proprietary in-house codes, all functions, definitions, properties,
and code forms adapted to solvers.
MSC.Mvision
Integrated materials database.
Online Help/Documentation
Topical and context-sensitive help for all interactive features, functions, and applications, hypertext links
throughout the online system for instant information retrieval.
Chapter 1: Introduction to Patran 3
Patran Framework
Patran Framework
The open architecture of Patran calls for a number of special features to help you acquire input data, manage
models, and export analysis models and results. Among the most significant of these are:
CAD interfaces
File and group definitions
Viewport and display options
Patran Command Language (PCL) development
User Customization capabilities
Some of these features are activated through menu keywords, icons, and application windows. Others, such
as PCL development, utilize some more advanced programming know-how.
Groups
A group is a collection of selected geometric or finite element entities brought together to simplify working
with a number of entities simultaneously. Groups can be created and dissolved, displayed or hidden,
transformed (e.g., rotated, mirrored), and have entities added or removed.
A special benefit of groups is evident in the design of symmetrical parts or assemblies. As an example, if in
the design of the front suspension system of an automobile the entities of the left front suspension assembly
are identified as a group, then the identical right front suspension assembly can be modeled by a simple mirror
transformation. Both groups can then be used in a complete vibration analysis to predict dynamic response,
stress, and fatigue life of the suspension components.
4 Patran Reference Manual
Patran Framework
Viewports
A viewport is a named graphics window through which you look at a model.You may utilize a number of
viewports to visualize different phases of the project. For example, in one viewport you can show the entire
geometric model, in another you can magnify a small detail. Additional viewports may contain a finite
element model or annotated result displays.
Viewports are especially useful for presenting “before” and “after” pictures simultaneously. For example,
following a thermoelastic stress analysis you may choose to post three viewports to the screen, the first to show
the geometric model, the second the meshed model with applied thermal loads, and the third to display a
plot of the resulting stresses.
You can control how the model appears in a view, its orientation, scale, rendering style, the presence of labels,
the position and intensity of the light source, and other display features.
User Customization
PCL enables you to automate repetitive tasks, establish individualized startup configurations, and create new
menus, icons, and forms. With PCL, you can readily integrate proprietary analysis codes developed at your
site into the Patran environment with the following results:
New analysis code names, as well as code-specific properties and functional assignments, will appear
on appropriate forms.
Finite element models created in an Patran database can be extracted and transferred to a proprietary
program for analysis. Conversely, finite element models and analysis results created with an in-house
program can be loaded directly into the Patran database.
Database templates can be customized to suit individual requirements.
Mouse communication. Click on menu keywords, icons, and buttons to identify selections. Pick and
manipulate objects in viewports; resize, reposition, and iconify (make into an icon) viewports; copy
and paste text.
Keyboard communication. Use shortcuts to open menus and to accelerate keyword selections, edit
history list commands, enter special comments and commands on the command line.
Help>... 5
Using Patran for Engineering Analysis
Geometry
Patran provides a complete set of tools to build, modify, and parameterize geometric entities of a model. In
addition, Patran can operate directly on geometry you created in various CAD systems or imported via IGES
geometry files.
Functional Assignments
Functional assignments is a collective term for applied loads, boundary conditions, element properties, and
material properties. These can be applied either to the finite element model or directly to the geometric
model. The advantage of being able to associate functional assignments, for example loads, with a geometric
model is that you can experiment with any number of meshing configurations without the need to reapply
loads each time you change the mesh.
Analysis
Patran provides flexibility and tight integration with a number of finite element analysis codes.
Postprocessing
Postprocessing capabilities include visualization of the deformed model, various color plot displays, X-Y curve
outputs, and results animation. Numerical results data can be combined, scaled, and sorted by time step,
frequency, temperature or spatial location. For example, you can request the display of the resulting von Mises
stresses between 15,000 psi and 30,000 psi at 154 Hz in the second mode of vibration. The Insight
application condenses raw numerical data into extensive sophisticated graphical tools and displays for
complete accurate interpretation of results.
Help>...
Parameter Description
Contents and Index Opens a new Browser window and displays the entire contents of the
Help system.
PCL Accesses all PCL Help with a separate contents list and index.
On Help Provides additional details on using Patran Help and navigating the
contents.
Technical Support Directs you in obtaining the technical support you might need.
What’s New in Patran Reports the key highlights and describes all the new features for Patran.
About Patran Contains the version and legal notices for the Patran product software.
via WWW Links you to the corporate website for information on key topics.
Context-Sensitive Help
To quickly access Help on any topic (form) from within Patran, simply press the F1 key. The appropriate
Help topic will appear in a new Browser window on your screen.
Help>... 7
8 Help>...
Chapter 2: Patran Workspace
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuideReference Manual
2 Patran Workspace
Modeling Window 10
The Menu Bar 11
The Tool Bar 13
The Applications Bar 19
Command Window 20
10 Reference Manual
Modeling Window
Modeling Window
The Patran workspace, or modeling window, is the area of the screen where you interactively perform all
Patran operations. The modeling window consists of two major sections, the Patran Main Form and the
graphics viewport.
The Command Window, Application Panel, Model Browser and Classic Menu Bar are dockable entities.
These can be opened or closed by right clicking on the empty space of ribbon bar and then selecting the
object(s) to open or close.
Graphics Viewport
The graphics viewport is a window where the geometric model, finite element model, and finite element
analysis results are displayed.
Origin Marker
File
The File menu provides access to the many different files used in Patran. File manipulation functionalities
include database management, import and export processes, session file handling, hardcopy creation, and
session exiting.
Group
The Group menu enables you to create named groups of selected geometric or finite element entities with
common characteristics. Grouping makes it possible to visually differentiate sets of entities from one another,
as well as to perform various tasks on a number of like entities at the same time. With the Group menu you
can also modify, transform, or dissolve groups.
Viewport
A viewport is a named graphics window through which you look at a model. You may define any number of
independent views of different extent and location and each may contain the model, or a portion of the
model, in a specific position and display size. The Viewport menu serves to create, modify, and delete
viewports.
Viewing
The Viewing menu manages the position, orientation, and sizing of the view of a model in selected viewports.
Display
The Display menu commands control visualization features such as colors, labels, and highlights of model
entities in viewports.
Preferences
The Preferences menu sets the global parameters for a model’s definition and appearance.
Tools
The Tools menu provides access to Patran’s special functions (e.g. Mass Properties) as well as to optional
analysis modules that are available on your system.
Help
The Help menu retrieves online documentation for all Patran features and provides various operational tips,
such as keyboard shortcuts, mouse functions, as well as tutorial assistance.
Utilities
The Utilities menu provides easy access to various utilities available in Patran. The Utilities menu is available
by default on Patran startup form but a database must be opened before accessing any utility from it.
Chapter 2: Patran Workspace 13
The Tool Bar
File>New Brings up the New Database form where you can define a new model.
File>Open Brings up the Open Database form where you pick an existing
database.
File>Save Saves the database with its current name and location.
Copy to Copies the image in the current viewport onto the clipboard
Clipboard
14 Reference Manual
The Tool Bar
Undo Reverses the last command that added, modified, or deleted entities.
During a plot:
The graphic imaging process will suspend immediately, leaving a
partially displayed image. To restart the plot operation, press the
“Refresh Graphics” icon.
During meshing:
All completely meshed regions will remain intact. The last geometric
region whose meshing was interrupted will not be meshed.
Reset Removes fringe plots, titles, highlighting, and deformed shape plots.
Graphics
Note: This button acts on all posted viewports if the Display mode
is set to Entity Type. However, if the display is in Group
mode, only the groups posted in the current window will be
affected.
Heart Beat Color-coded indicator that shows the current status of Patran.
Fit View--resizes the view so that all model entities fit inside the viewport window.
Model Center-- sets the rotation center to the centroid of entities in the view.
Element Shrink-- Toggles the display of Element Shrink between ON and OFF.
Point (0D) Element Marker On/Off--toggles the display of Point (0D) elements.
Front View--Rotations: X = 0, Y = 0, Z = 0
Application Buttons
Parameter Description
Geometry Creates and manipulates geometric entities.
Elements Creates and manipulates nodes, elements, and meshes.
Loads/BCs Creates and manipulates loads and boundary conditions.
20 Reference Manual
Command Window
Parameter Description
Materials Defines and modifies material properties, associates materials with a model.
Properties Specifies element properties for a finite element model.
Load Cases Creates and modifies load cases for a model.
Fields Defines and modifies variations in element and material properties and LBCs.
Analysis Sets analysis parameters, submits the analysis, and reads the output files.
Results Processes result files and specifies result data display characteristics.
XY Plot Manages the appearance of XY windows and the XY plot displays of analysis
results.
Command Window
The Command Window displays the history list, a sequential recording of commands used while building the
model. It may also contain error messages and comments.
The Command Line allows you to enter command text manually. Additionally, the command line displays
system messages and accommodates history commands for editing.
The Command Window can be opened or closed by right clicking on the empty space of ribbon bar and then
selecting the Command Window option.
The term widget is a programmers’ jargon; it refers to all buttons, switches, listboxes, spreadsheets, etc.
displayed in forms, as well as to the forms themselves. Patran is so designed that the term widget should
not appear except where it is unavoidable, such as when custom interfaces or environments are created.
Apply Button
Implements all inputs and selections you specified in a form. The slight difference between the text of the
two buttons-- in the second one the word is offset by dashes--indicates a difference in their functions. When you
see the “-Apply-” button used in a form it means that:
This action is reversible--you can use Undo (System Tool Palette, 13) to reverse the operation.
this action activates a commit--saves the results of all actions performed (including the current one)
since the last time the database was saved.
Conversely, if a form contains an “Apply” button without the dashes, the action of that application cannot
be undone and it does not commit previous actions to the database. After either Apply action, the form stays
open for further inputs.
Auto Execute
When the Auto Execute switch is ON, the Apply button is executed automatically when all required
parameters are entered on the input form.
Auto Execute is useful if immediate results are desirable. However, if you want to be more cautious and
double check all inputs before executing a command, turn this function OFF by clicking in the box.
Cancel Button
Closes a form and voids all inputs and changes you made just before canceling.
24 Patran Reference Manual
Forms, Widgets, and Buttons
Coordinate Frame
Allows you to enter the name of the coordinate frame in which the coordinate input is interpreted (for more
information on coordinate frames see Coordinate Frame (p. 24) in the Patran Reference Manual).
Databox
Databox label
Many forms contain databoxes that accomodate a list of input data. The label identifies the type of data that
will be accepted in a particular databox. A blinking insertion bar in the data field indicates that the focus is in
the databox and it is ready to receive input. If the input involves entities on the screen, you can pick the
appropriate entities and the system will enter their name and ID number. Alternatively, you may type or paste
the required input data into the data field.
Default Values
Application forms often contain default values and settings. The types of defaults are:
fixed (global)-- automatically set for a new database
variable-- created during model construction
When you access a form for the first time, it will show the global default values. If you enter new defaults or
create new settings and invoke Apply, these will appear as defaults the next time you open the form.
Steps to modify a fixed default environment:
1. Open a new database.
2. Change all default settings as desired: colors, viewports, groups, analysis preference, named views, etc.
3. Save the database under some name (e.g., “my_template”). Make note of the path of this new file
so that you can find it next time.
To apply the new default environment in a new database:
1. In the New Database form, select Change Template...
2. In the Change Template form, change the default path, if necessary, to wherever
“my_template.db” resides. Use the filter to locate it and select it from the database list.
3. Enter a new database name and pick OK. The new database will open in the “my_template.db”
environment.
Chapter 3: Entering and Retrieving Data 25
Forms, Widgets, and Buttons
Filter
A filter is used in applications where a list of selectable components may be longer than the number of items
that can be displayed in a listbox. With the filter you can isolate a single item or a group of several items that
comprise a subset of the list. For example, you may have defined a number of load cases, one of them named
Heavy. To access this load case (for example, to modify it), you don’t need to scroll through a long list to find
its name in the listbox, instead, type heavy (entries are not case sensitive), press the Filter button, and this
load case will be selected.
You can use the following wildcard symbols:
* (any character string)
? (a single character)
If, in the above example three of the load cases are named Heavy100, heavy300, and heavy500, you can enter
h* and now the displayed list will be the subset that consists of the load cases whose name begins with the
letter h.
Filter ON/OFF: A new Filter ON/OFF toggle button has been added above the existing list filter to some
forms in the following sections:
Group
Load Cases
Analysis -> Subcases
Loads/BCs
Materials
Properties.
It switches the filter ON or OFF to change between a filtered list and the complete list.
Particularly, in the large models where the listbox contains several items and you need to switch between the
filtered list and complete list, the Filter ON/OFF toggle makes the task easier.
By default, the filter is ON.
OK Button
The OK button performs almost exactly as the Apply button, except that it also closes the form.
26 Patran Reference Manual
Forms, Widgets, and Buttons
Output ID List
Output ID lists display the default ID number that will be assigned to the next entity of a given type.
However, you may enter any other number if you wish. If the number you specify is higher than the default,
numbering will begin at this new number. If you enter a lower number, you will be warned that these entities
exist and will be asked for permission to overwrite. You can specify any numbering sequence, for example you
can choose 44 68 77 and 92 for the next four entities. Spaces are used as delimiters.
Reset Button
When you press this button, anything you changed in a form will return to its previous value.
Scroll Bar
Scroll bars appear below or at the right side of listboxes. They are used when the contents of the box are too
long or too wide to appear in their entirety.
Switch Button
Option 1
Option 2
Option 3
With the switch buttons you can select one option in a short list of options. The options are mutually
exclusive.
Chapter 3: Entering and Retrieving Data 27
Forms, Widgets, and Buttons
Toggle Button
Lights
A Toggle button is a switch that allows you to turn a particular option or selection ON or OFF. The label
identifies the option (e.g., Lights). The toggle switch operates in a press on/press off manner.
Spreadsheets
Tabular Data Input Spreadsheets
This type of spreadsheet is used to input data into a one-, two-, or three-dimensional table.
Note: Spreadsheets display at a default maximum size. If a larger size is required, look for a local
Options... menu to increase the setting.
28 Patran Reference Manual
Forms, Widgets, and Buttons
3. The contents of the entire row in which the cell is located will be displayed in the list box and data
input box.
4. Select the item you want to modify (or delete).
5. Click Apply.
Selecting Entities
Most Geometry and Finite Element applications require that you select one or more entities displayed on the
screen. For example, if you want to create a mesh seed, the required selection is one or more curves, or edges
of a solid or a surface. Accordingly, the Select databox in the Elements Application form will indicate that a
list of curves must be the input to complete this action.
If the insertion bar is not already blinking, you must click inside the blank form field before you can select
the entities.
Screen Picking
When you pick entities with the cursor, you can select them individually or pick several entities at the same
time. After selection has been completed, the system will write the names and ID numbers of the selected
entities into the databox that initiated the picking.
Some of the settings of screen picking, such as highlighting, criteria of entity inclusion in picked areas, and
the format of a Select Menu, are established in the Preferences >Picking menu (see Preferences>Picking, 444).
Polygon Picking
The enclosure is in the shape of a polygon. Click the polygon icon in the Select Menu (see Preferences>Picking,
444) pick the start point of the polygon (A), then drag the cursor and pick the next point to set a new vertex
of the polygon (B). As the lines of the polygon are formed, continue clicking new vertices (C,D,E...) until
you consider the polygon complete. Double-click at the last vertex (or return to the starting point) to
complete the polygon.
Another way of initiating the polygon pick is using the Ctrl key instead of picking the polygon icon. Press
and hold down this key while you click the left mouse button at a start point and all consecutive points of
the polygon. Double click to close the polygon.
A B
E D
Cycle Picking
Entity picks, whether single or multiple, may inadvertently catch entities you did not intend to select,
especially if several entities are close to one another. The system will make it easier to pick the correct entity
from a number of possible choices, provided that the auto execute feature is turned off. A form will be
displayed with the names of all possible selections. You can cycle through all choices until you pick the desired
entity.
Chapter 3: Entering and Retrieving Data 31
Selecting Entities
Select Menu
When you invoke a command that requires entity selection (e.g. Delete), the system will display a Select
Menu. A Select Menu consists of two sets of icons, the first set is common to all select operations, the second
set consists of icons specific to either geometry or FEM entity selections. A typical Select Menu is shown
below; the explanation of the Select icons will follow.
32 Patran Reference Manual
Selecting Entities
Polygon pick
Picking Icons
Entity Highlighting OFF/ON
(Post-Processing)
Checked
34 Patran Reference Manual
Selecting Entities
Geometry FEM
Curves Nodes
Points and vertices of geometry Elements
Solids Edges of shell and solid elements
Surfaces Faces of solid elements
Faces of solids
Edges of surfaces and solids
Note: When Visible Entity Picking is selected, the Rectangle/Polygon Picking (Multiple), 445 mode will
pick any portion of the entity enclosed by the rectangle. The Enclose entire entity and Enclose
centroid modes are ignored.
Picking Icons
When you pick an entity, its name is entered in the select databox. By default, if you follow with another
entity pick, the previous selection will be canceled and the second selection will replace the first. This is called
Replace Pick. However, with the Add Pick icon option, further selections do not replace existing ones but are
added to the selection list. Lastly, the Reject Pick option allows you to remove a previously selected entity
from the entity list in the Select databox.
Chapter 3: Entering and Retrieving Data 35
Selecting Entities
Replace Pick--replaces a selected entity with the next entity you picked (default)
Reject Pick--removes a selected entity from the list of entities already picked
“Any” Icon
This icon helps you control the entity picks in all select menus. If the action is associated with several unlike
entities, the icon will indicate that any geometric or finite element entity (but not both) is selectable. For
example to delete a solid, a curve, and two points, in the Geometry application you select Delete>Any and
the “Any” icon will consider all geometric entities relative to the enclosure you create.
If, however, you want to restrict the action to entities of a certain type only, you can specify the entity type
for your selection (for example Delete>Solid) and the “Any” selection will refer only to the selected entity type
(in this example to any solid). Assuming that the same four entities (solid, a curve, and two points) are in the
enclosure, just as before, this time only the solid will be deleted and the others will remain untouched.
Go to Root Menu Icon This icon will return you to the Select menu where you started
the action.
Go to Previous Menu The role of this icon is similar to the Go to Root Menu icon,
Icon except that it returns you to a previously selected menu in a
multi-level definition. (the previously selected Select Menu
may or may not be the root menu).
The numbers on the three Principal Axis Icons icons refer to principal axes 1, 2 and 3. Depending on your
selection of a coordinate frame, these are:
X, Y, and Z axes in a cartesian coordinate frame
Radius, Theta, and Z definitions in a cylindrical coordinate frame
Radius, Phi, and Theta definitions in a spherical coordinate frame
Selects the default coordinate frame and enters it in the Select databox.
Specifies a vector whose base is at the global origin and tip at an arbitrary point. Displays the
Point select icons to select this point.
Specifies a vector whose base and tip are both arbitrary points. Displays the Point select icons
to select both points.
Selecting Points
The following icons enable you to select a point whether it is an existing entity or just a position in space.
Selects a point on a curve closest to an off- Selects any X, Y screen position. The Z-
curve point. value will be zero.
Selecting Curves
You will see these icons when you create new curves or when you need to select existing ones.
Selects an edge of a surface or solid. Creates a curve using an existing curve and
two points on the curve.
Selecting Solids
With these icons you can select solid geometry.
Selecting Surfaces
These icons are displayed for creating a surface or for selecting an existing surface.
Selecting Nodes
This icon appears whenever you need to pick a node.
Selects nodes
Chapter 3: Entering and Retrieving Data 39
The List Processor
Selecting Elements
These icons are displayed whenever you are selecting elements or parts of elements.
The Advanced List Dialog is fully resizable and offers the following useful features:
The searched text is cleared through a circled cross button, which only appears if any search text is
present in the ‘Search…’ field.
The ‘Search…’ field also remembers the last 21 searches exclusively for each List Box, which is seen
in an auto drop-down list when tying in the search field, as shown in the following figure:
44 Patran Reference Manual
Advanced List Dialog (ALD)
The checked state of any item in the ALD represents the selection state of the respective item in its
parent List Box.
One can also explicitly check/uncheck the desired item(s) by selecting and pressing the Spacebar key
on the keyboard.
On clicking OK in the ALD, only the checked items are selected in the parent List Box.
On clicking Cancel in the ALD leaves the original selection in the parent List Box unchanged.
A count of both check and total available items is shown at the bottom of the ALD and updates
dynamically for quick reference.
Tool Buttons
A set of tool buttons is provided at the top of each ALD which offer various functionalities as explained below:
- Sort Ascending
- Sort Descending.
- Show ALL
- Invert Checked Items: This option inverts the check state of items. This option applies to all
the visible items only i.e. if the items are already shortlisted by any searched text in the ‘Search…’
field, the ‘Invert Checked Items’ option inverts the check state of shortlisted items only.
- Clear ALL Checked Items: This option clears the check state (toggles OFF) of ALL the
available items in the list. For clearing the check state of only shortlisted items (as a result of searched
text), one can select all shortlisted items through ‘Ctrl+A’ keys (or through mouse drag selection)
and press the Spacebar key in the keyboard.
Chapter 3: Entering and Retrieving Data 47
Advanced List Dialog (ALD)
Limitations:
The currently selected items in ALD (Advanced List Dialog) may not be visible clearly if the user
switches to ‘High Contrast’ theme on the Linux platform.
48 Patran Reference Manual
Advanced Select Data Box Dialog (ASD)
The Main and Temporary Editing Areas can be internally resized using a handle just above and below the
‘Less …’ button as shown in the following image:
50 Patran Reference Manual
Advanced Select Data Box Dialog (ASD)
The search can be further advanced to the next ID/Range using the ‘--->’ button placed just next to
the ‘Search …’ field or using an ‘Enter’ key on the keyboard.
The searched text can be cleared through a circled cross button which only appears if there exists any
text in the ‘Search…’ field.
The search history of the last 21 text searches is maintained and is exclusive to each ASD.
Text Editing
The user can perform normal text editing operations (Undo/Redo/Cut/Copy/Paste/Delete/Select All) inside
‘Main Editing Area’ (as well as in ‘Temporary Editing Area’) in the same way as that in any other text editor
tool. Also, apart from the keyboard, these operations can be accessed through the Right Mouse Button
(RMB) Menu as shown in the following image:
52 Patran Reference Manual
Advanced Select Data Box Dialog (ASD)
Undo/Redo can be performed in both Main and Temporary Editing areas after text editing/picking.
In both the Main and Temporary Editing areas of ASD, text can be zoomed in/out through 'Ctrl + Mouse
Wheel'.
Note: As the ‘Main Editing Area’ becomes read-only on exposing the ‘Temporary Editing
Area’ through the ‘More …’ button, the features like Expand, Collapse,
Import/Export, Highlight, and Picking work only for the ‘Temporary Editing Area’.
In the 'ASD Settings' dialog user can specify the desired color for any of the supported entity types. And these
Entities' Colors are globally applied for ALL available ASDs in Patran and are preserved across all sessions of
Patran.
Similarly, the selected IDs sequence can be collapsed to a valid range (if and only if there exist a common
difference between consecutive IDs) using the ‘Collapse’ button as shown in the following image:
54 Patran Reference Manual
Advanced Select Data Box Dialog (ASD)
Note: While performing Expand/Collapse make sure that the selection does not start/end at
the middle of any Entity ID text or word.
The users are allowed to select multiple Groups in the 'Select Group(s)' section and all their associated entities
are shown in the bottom section with a new line separator. On pressing the 'Add' button in the 'Select Entities
from Groups' dialog, the entities from all the selected Groups get added to the active editing area
(Main/Temporary) of parent ASD with an Undo/Redo support.
56 Patran Reference Manual
Advanced Select Data Box Dialog (ASD)
Also, the picklist in ‘Main Editing Area’ can be directly replaced with the picklist in ‘Temporary Editing Area’
using a ‘=’ (REPLACE) button in the toolbar.
PCL Customization
ASD becomes automatically accessible from inside ‘Select Data Box’ if implemented in any custom PCL
code. There is no need for any modification in custom PCL code for accessing ASD.
Chapter 3: Entering and Retrieving Data 57
Advanced Select Data Box Dialog (ASD)
Notes: After launching ASD, the associated parent SDB becomes read-only and
reflects in orange color to show the association with currently opened ASD.
As each ASD is associated with its parent SDB, ASD hides when its parent
SDB (or UI form of parent SDB) hides.
Limitations:
Expand, Collapse and Search features in ASD currently support only the direct representation of IDs
Range (e.g. 30:100 and 30:300:10). The other Range representations (e.g. 3:#, 30T300B10,
1:121:5.6, etc.) will be supported in future releases.
ASD supports List Boolean Operations only for the type of entities which are supported in 'Tools >
List > Boolean' functionality.
On Linux OS, it is required to explicitly suffix the file name with the '.txt' extension while exporting
the data from ASD.
58 Patran Reference Manual
Advanced Select Data Box Dialog (ASD)
Chapter 4: Working with Files
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
Patran Database
This file contains the data that define your geometric and finite element model, as well as all analysis results.
Databases are binary files that are automatically assigned a.db file name extension (e.g., test.db). This
extension must remain with the file name.
Session File
A session file is a log of all database related commands and corresponding comments executed during a work
session. A single session file may contain commands that were used for more than one database. Session files
are given a .ses.xx filename extension, where xx is a number that shows the position of this session file in
the sequential order of session files (e.g., test.ses.01= the first session file). Hexagon
recommends that you maintain the.ses extension, although this is not a strict requirement.
Journal File
A journal file contains all database related commands executed while creating a specific model. A journal file
spans all sessions required to complete a model. Journal files are assigned a .jou extension (e.g.,
test.db.jou).
Hardcopy File
A hardcopy file is a generic file named patran.hrd that is used as an intermediate step to creating an output
file for specific print drivers, such as CGM.
IGES File
IGES (Initial Graphics Exchange Specification) files are ANSI standard formatted files that make it possible
to exchange data among most commercial CAD systems.
Patran supports a fixed line length ASCII file format, where the entire file is partitioned into lines of 80
characters in length, beginning with the first character in the file.
Startup Files
Patran relies on a set of required and optional external text files during the startup of a new session, as follows:
The settings.pcl file, 61 is used to define a default environment for the Patran session. The environment includes
hardcopy parameter settings and operation of Patran’s 3D driver.
The p3prolog.pcl and p3epilog.pcl Files, 66 are used to customize and automate PCL capabilities within Patran,
and to provide a way for customized forms and widgets to be created.
Startup Session Files, 66. There are a number of ways to customize automatic execution of user defined session
files, or to specify the file name of a new session file to be written to by Patran with its startup session file
feature.
For more information on these user defined customization files for Patran, continue onto the following
sections.
XDB Only
XDB and Print
OP2 Only
OP2 and Print
Print Only
None
They are also read as environment variables. These hardcopy environment variables may be modified
using the Linux setenv command or the Windows set command.
The following is a table of all hardcopy variables defined in Patran. Further explanation of the variable values
can be found in File>Print, 214:
These commands should only be placed in p3epilog.pcl. These commands select the initial files and
option modes. If these lines are not present, there is no default play file, “patran.ses” will be the default record
file (unless overridden later) and both options default to FALSE.
Similarly, specific element types can be removed from the standard Patran element library in the template
database, and the removed element types would not appear for users that reference the modified
template.db file during the creation of the new database.
Refer to the Patran Reference Manual for more information on configuring the template.db file.
Menu Conventions
A menu key word with ellipses (...) attached to it will call up an additional form in which you enter further
data.
If a menu key word is followed by an expression containing the abbreviation Ctrl, this item can also be
accessed by an accelerated keyboard shortcut. For example, for File>New, the menu shows Ctrl N. This
means that, if desired, you can activate this command by pressing the Ctrl (Control) key and the designated
letter key (N) simultaneously instead of clicking File and then the New keyword.
The File menu functionalities are described below in the order in which they appear in the menu.
Chapter 4: Working with Files 69
The File Menu
Parameter Description
New... Displays the New Database dialog box in which you enter the name of a
new model. The form presents the default template.db template file; if
desired, you can specify another previously defined and saved template
file.
You may customize the template.db file to ensure that all databases will
reference certain specific definitions in the following areas:
Materials--if your site has a set of materials that is more extensive than
the standard set, you can add this material information to the new
template database.
Elements--if you don’t want certain element types appearing when a
new database is created, you can exclude those from the standard
Patran element library in the new template database.
Application preferences--you can eliminate from the new template
database those applications and modules that your site is not licensed
to run.
Set Working Directory to Database Location
If this toggle is ON, the working directory will be changed to be the
same directory where the opened database exists. All files subsequently
written, such as analysis input decks, are written to the working
directory. If this toggle is OFF, then the possibility exists that the
working directory could be different than the directory where the
open database exists. Thus analysis input decks will not be written to
the directory where the database exists, but to the currently set
working directory.
For more information on configuring the template.db file, please refer
to the Patran Installation and Operations Guide.
70 Patran Reference Manual
The File Menu
Parameter Description
Open... Displays the Open Database dialog box in which you can select the name
of an existing Patran database.
Parameter Description
Open Recent... Allows you to select from a list of recently accessed database files. The
number of files visible is controlled by settings.pcl file environment
variable:
pref_env_set_integer("max_num_recent_files",num_files)
If present in the settings.pcl file, the toggles and/or databox will be set to
the values found. When the File/Open, File/New or File/Open Recent
forms are closed, the values of these toggles and databox are written to
settings.pcl if this file is present and can be written to (not read only).
Close Closes an open database without exiting Patran. Saves all changes made to
the database during the current session.
72 Patran Reference Manual
The File Menu
Parameter Description
Save Although Patran updates an open database after each operation, the last
update step is not saved to disk, it remains in memory only. The Save
command ensures that the most recent update is included when the
current state of the database is committed to disk.
Save a Copy... Opens the Save a Copy form that enables you to save a copy of your
database under a new name.
Utilities
Reclaim... Reclaims unused space allocated to the current database. Note that when
you reclaim database space the file’s Undo history will be deleted.
Revert... Returns a database to the state in which it existed when it was first opened
(provided that the Revert Operation has been enabled; see
Preferences>Global, 436). Changes made during the current session will be
lost.
Rebuild... Executes a selected journal file (see Journal File, 60) to re-create an Patran
database. The rebuilt database remains open and allows you to continue
to work on the model. This command is useful when the original database
is either lost or not accessible (e.g., the database is archived or resides on a
different computer platform).
Import... Enables you to bring in model or results data created outside of the current
database. Model data may be in Patran database format, Patran 2.5 neutral
file format, MSC Nastran input file format, CAD format, or Standard
Data Exchange format. Import recognizes the following CAD formats:
CATIA
Pro/ENGINEER
Unigraphics-NX
SolidWorks
Parasolid
ACIS
Import results from a PATRAN 2.5 Results file (Element, Nodal or
Displacement Results file).
Importing Results
Import recognizes the following Standard Data Exchange formats:
Parameter Description
Export... Translates an open Patran database into an IGES file, STEP AP203 and
AP209, Parasolid xmt, or a Patran neutral file, based on the entire model,
specific entity types, or Patran groups.
SimXpert This menu item appears if you have a valid installation of SimXpert on
your local system and the environment variable MSC_SX_HOME is set
pointing to the installation directory of SimXpert. Selecting this option
will launch SimXpert. If you wish to export a current model to
SimXpert, this can be done in the Analysis application with the
Action/Object/Method set to Analyze/Entire Model/Load SimXpert in
the MSC Nastran preference.
SimManager Publishes and retrieves Patran databases and other related analysis files
directly from within Patran with the SimManager client. Once logged on,
the user may publish and retrieve as well test connection and access the
Web Client. The server settings need to be set in order for the
SimManager client to communicate with the server. The following
variables need to be set:
SM_RICH_CLIENT_IC_HOST <host_name>
SM_RICH_CLIENT_IC_PORT <port number>
SM_RICH_CLIENT_IC_PROTOCOL <http or https>
SM_RICH_CLIENT_IC_WEBCONTEXT SimManager
RC_ROOT
JDK_PATH
APPS
ACTION_LOC
JARS_PATH
CLASSPATH
SCA_SYSTEM
SCA_RESOURCE_DIR
SCA_SERVICE_CATALOG
SCA_JAVA_COMP_PATH
SCA_JVM_CONFIG
Parameter Description
Record... Creates a new file with a user-defined file name and records all database
related commands executed during the current Patran session from the
time this file was opened. The default patran.ses session file will be
generated as well.
Print... Sends the image of one or all viewports and/or XY plot windows to a
designated printer or creates a hardcopy file in order to print or plot at a
later time. Certain printing options are functions of the available printers
and print drivers.
Images... Creates graphical outputs of model displays in a variety of popular
graphics file formats, including interactive Internet-ready animations.
Report... Creates a printable text file that contains Patran model summary
information, node and element attributes, properties and results.
Quit Closes an open database, saves any changes made, and ends the active
session.
File Commands
The File Menu commands activate dialog boxes in which you interact with Patran. Although the commands
are specific to the file-related action you want to perform, dialog box entries that deal with file names and
types are common to several commands.
Look In
This text field displays the location where Patran starts looking for the various folders in which it can create
and manipulate databases, session files, and reports. The subordinate folders and existing database names are
also listed. If you don’t remember where your files are located, move up and down the hierarchy of all folders
with the Windows icons, the Windows Explorer, or use Start>Find>Files or Folders on your Desktop to
select the correct path for your database search.
File Name
Enter a new name or select a name from the displayed list. This text field, as well as the Files of Type field, also
shows the default extension automatically assigned to different kinds of files (e.g., *.db, for database file). If
you enter a name that already exists, you will be asked whether you would like to delete the existing database
and create a new one.
Naming Conventions
Although Patran does not impose any limitations on file names, certain restrictions do exist, mainly due to
the naming requirements of various CAD systems and translators, as well as analysis codes. Therefore, it is
best to avoid spaces and other special characters from file names. Also, be aware, that some analysis programs
limit the number of characters allowed in a file name and may truncate a longer name to the allowable length.
Chapter 4: Working with Files 75
File Commands
Files of Type
This text field shows the file type appropriate for the selected action, as well as the automatically assigned file
name extension.
76 File>New
Creating a New File
The File>New command sequence activates the New Database dialog box.
In addition to the file name inputs that are required, two optional data entries are:
Change Template Button/Template Database Name
Modify Preferences checkbox
Parameters Description
Change Template If you press this button the Database Template dialog box will display all
saved template database names. Select the template you want to use. For
more about templates, see New..., 69.
Modify Preferences Turn this toggle on (4) and the New Model Preferences form will be
presented right after the new database is created. In this form you can
specify a tolerance value (see Global Model Tolerance, 437), the analysis code
you intend to use, and the type of analysis you want to perform on the
model.
File>New 77
Creating a New File
Changing a Template
The Database Template allows you to select a a previously defined and saved template file that will be used as
the source when a new database is created.
Modifying Preferences
The New Model Preference form allows you to select those preferences that must be set at the beginning of
the modeling process to avoid invalid input and irreversible results.
78 File>New
Creating a New File
Parameter Description
Tolerance Tolerance specifies the maximum distance within which two like entities
(e.g., points), are said to be coincident. Tolerance is a global parameter,
that is, it affects the entire modeling process.
File>New 79
Creating a New File
Parameter Description
Entity coincidences and congruences:
Parameter Description
Analysis Code Select the program you intend to use for the finite element analysis.
Analysis Type Select the type of analysis you will perform on the model.
Your selection of an analysis code, as well as the analysis type, will affect
all aspects of the finite element modeling process, since analysis codes
have their own unique definitions for element types, MPC types, and all
other FEM entities and properties.
If you decide to change the analysis code or the analysis type preference
during the modeling process, you may lose the data that apply only to the
previous preference settings. Therefore, to keep analysis-specific data
from being lost, it is best to specify the analysis code and the analysis type
at the beginning of the modeling session.
Analysis Code and Analysis Type can also be defined in the Patran Main
Form’s Preferences menu.
File>Open 81
Opening an Existing File
The File>Open command sequence activates the Open Database dialog box. Make sure you are displaying
the appropriate folder in which the database resides, then select the name of the database you want to open.
82 File>Save a Copy
Saving a Copy of a Database
Use this command to save a copy of your database under a different name.
Parameter Description
Save Journal File Copy Also If you turn this toggle on (4), the journal file associated with the database
will also copy to the new database. Note that the copied journal file will
still refer to the name of the original database; you must edit the name to
refer to the copied database.
Look in: If you want to save the copy to a different folder, select the new folder.
File Name Enter a new name for the copied database.
File>Reclaim 83
Freeing up Unused Disk Space
The Reclaim utility frees unused disk space allocated to the currently open database. Normally you may not
need to use this feature, since the Reclaim process is executed automatically when you save or close a database
that contains a significant amount of free space, provided that the following two conditions are met:
The database can be reduced by an estimated one megabyte or more.
The current database fragmentation is more than 5% of the size of the total database.
Important: When you reclaim database space, the file’s Undo history is deleted. However, once the reclaim
process is complete, the Undo capability will be reestablished after the next committed action
and the database will again maintain Undo states.
When you request to reclaim database space, you will receive the following a message:
Whether you proceed with the reclaim utility or not will depend on what is more valuable, the amount of
database space you can recover or retaining the Undo history of your file.
84 File>Revert
Reverting to the Original Database
This utility erases all changes made during the current session and returns a database to the state in which it
existed when it was first opened.
The Revert utility is not automatically active. To make it available, you must do the following:
1. Select the Preferences menu in the Main Form.
2. Pick the keyword Global.
3. Click on the toggle in the selection box (4) Enable Revert Operation. This action will take effect
when you next open this database.
4. Close the database.
5. Open the file; revert will be available in the database. Proceed creating entities.
6. If you want to return to the original state of the database, click File>Utilities>Revert.
7. The following message will appear:
With this utility, you can rebuild a model created in Patran using a journal file. The journal file contains a
history of all user activity required to create the database, even if it spanned several separate modeling sessions.
Because it is a sequential text file of PCL instructions, it can be edited using a text editor.
This utility is available only if there is no open Patran file. When you invoke File>Utilities>Rebuild, the
Rebuild Database dialog box will display the list of journal files contained in the last-used folder (you can
search through other folders as well).
Select the journal file to run. Once a journal file is read and executed, the database will be completely restored.
86 File>Import
Importing Models and Results
With the File>Import command you can bring in model or results data created outside of the current
database. If the imported object is specified as Model, the Import dialog box buttons and text boxes are related
to model import choices. Imported model files may come from a number of different sources, therefore
model data may be in Patran database format, Patran 2.5 neutral file format, MSC Nastran input file format,
or in one of several CAD formats.
Parameter Description
Look in: Shows the drive or folder where the search starts for the incoming
database. The text field below displays the folders and files where you may
locate this database.
File name Select the name of the file you want to import.
Files of type Indicates the valid file type and assigned file name extension, unique to
the selected source of the imported file.
Source Identifies the software application used to create the imported model.
File>Import 87
Importing Models and Results
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Options Although this item is dependent on the source file origin, it generally
leads to a spreadsheet or a form that displays application-specific
information about imported entities.
Equivalence Options Allows you to select methods and conditions for merging coincident
nodes.
Preview Patran Database Displays a list of the number of entities and their ID specifications in the
database targeted for import.
Spreadsheet Headings
Default Offset
Indicates the amount by which the ID numbers of the incoming entities of the corresponding type will be
incremented in the current database. A large offset makes it easier to group IDs for imported submodels and
organize the database. The Default Offset is the product of the Increment and the Submodel number.
Increment
An arbitrary offset increment you assign.
Submodel
The number of successful imports; this number is incremented after each subsequent import. If desired, it
can also be overridden by any arbitrary number.
Default Prefix
Indicates an alphanumeric prefix applied to incoming entity names. It may be used to organize the database
based on each imported submodel. The Default Prefix is a concatenation of the Prefix and the Submodel
number.
Prefix
An arbitrary prefix that must start with a letter. The default, SM_, stands for submodel.
Submodel
The Submodel number, incremented after each successful import.
Insert a prefix in front of the incoming entity’s name and import it with that name.
Try to combine the two entities into one. If the two cannot be combined because of conflicting
properties, issue a warning and resort to the option above.
In some cases, the merge operation is not actually merging incoming and existing data. For example, if a
material is already present in the receiving database and a material with the same name and properties exists
in the imported database, the material definition in the primary database is retained, and that from the
secondary database is discarded.
Groups, however, are not likely to have identical properties. If the incoming database contains a group with
the same name as one that exists in the receiving database, the entities from the imported database will be
added to the group in the primary database. A new group is created to contain all entities from the imported
database. This group is given the name specified by the entity prefix.
Parameter Description
Entities to Merge Upon In these cells you specify the entities you want to merge if a duplicate
Duplication name is encountered. If you do not click the merge toggle (or if the merge
attempt fails), a prefix will be inserted in front of the name and a new
entity will be created to hold the data.
For those entities with a “Compare Names” toggle, click the ones that
must have duplicate names to merge. If this toggle is ON, the entities in
the primary and secondary databases must have the same name and the
same data to merge.
If the toggle is OFF, the entities in the receiving and imported databases
need only have duplicate data to merge. If a duplicate name does exist in
the primary database, the imported entity will merge with it. If a
duplicate name does not exist, the imported entity will merge with the
first alphanumeric entity found with duplicate data.
File>Import 91
Importing Models and Results
Parameter Description
Real Number Equality This criteria is used to determine whether two real properties (scalar or
Criteria vector components) are close enough in value to be assumed equal.
Significant Digits To determine near-equality, compare digits of the two numbers in
normalized exponential form, from left to right (discarding leading
zeroes) up to the specified number of significant digits. For example, for
Significant Digits = 3, the following are considered equal:
0.234516E+08 0.234925E+08
But, the following are not:
0.233925E+08 0.234925E+08
Spreadsheet Cells
The cells in the spreadsheet identify the imported entities and specify certain characteristics.
Import Column
In the Import column you select which entities of a given type are to be imported from the external database
(All, None or a List). Group membership provides additional control of entities. For entities that can be
placed in groups, if All or a List of groups is specified only those entities that are in the selected groups will
be imported. If None is specified for groups, group membership is not a consideration.
For example, if you select All for Elements, and All for groups, and if Element 100 is not in any group,
Element 100 will not be imported. However, if you pick All for Elements, and None for groups, Element 100,
which is not in any group, will be imported.
Parameter Description
Entities to Import With each listed entity type, you can choose to import all entities of a
give type, none of them, or those specified in an input list. If you set the
switch to Input, you enable the List databox and may input a list
manually.
<entity> List Enter the desired list of entities. This label will vary according to the
entity type you selected (e.g., Curve List).
Preview Database. . . Displays the Patran Database Preview form that shows the entities, and
their corresponding ID numbers, as contained in the import database.
ID Offset Column
File>Import 93
Importing Models and Results
This column indicates the number by which the IDs of the incoming entities are to be incremented relative
to the entities of the corresponding type that exist in the current database.
Offset Options
If you select an ID Offset cell, a second dialog box will provide a set of options.
Parameter Description
Offset Option Pick one of the following:
This column shows the prefix that is to be applied to incoming entity names. If the merge toggle for the
corresponding entity type is ON, a prefix is applied only if the name duplicates the name of another entity
in the current database and the merge operation failed due to conflicting data. See Duplicate Entity Merge Options,
89 for more details.
94 File>Import
Importing Models and Results
Parameter Description
Prefix Option Pick one of the following:
Equivalence Options
Equivalencing is a process in finite element modeling whereby all coincident nodes are reduced to a single
node. Two nodes are coincident if they are within a predetermined tolerance distance from each other (the
number of significant digits for the equivalence tolerance is set in the Import Options form, see Significant
Digits, 91). The change brought about when nodes are equivalenced is propagated throughout all other FEM
definitions, (element connectivity definitions, MPC equations, loads and boundary conditions), geometry
definitions, and groups.
ID Numbers
By default, the highest coincident node ID at a location in the secondary model will equivalence to the
highest coincident node ID in the primary model.
If a secondary LBC is identical to a primary LBC--the secondary LBC will be equivalenced to the
primary LBC and will no longer exist in the merged model. The application region of the resultant
LBC in the merged model will cover both the primary and secondary application regions.
If a secondary LBC is not identical to any primary LBC--the secondary LBC will be embedded into
the merged model, its name will be prefixed if the same name is found among the primary LBCs,
and its application region and coordinate frame will be updated to the new IDs.
Parameter Description
Equivalence Nodes/Geometry Specify whether nodes and/or geometry are to be equivalenced as they are
imported (both are ON by default). Only items that are common
between the current database (primary model) and the import database
(secondary model) are considered for equivalencing. If duplicate items
are found within either model but none of those are duplicated in the
other model, no action will be taken. In other words, only inter-model
equivalencing is performed, as opposed to inner-model equivalencing.
Tolerance Method Tolerance method applies to nodal equivalencing only.
98 File>Import
Importing Models and Results
Parameter Description
Tolerance Source You can accept the tolerance value defined either in the current database
or in the import database, or you may choose to specify a new value.
Equivalence DFEM This toggle controls whether discrete FEM fields are combined when
Loads/BCs/Props loads and boundary conditions or properties are merged. Two discrete
FEM fields referenced by duplicate LBCs or Properties (one in the
Combine DFEM Fields
current model and another in the import) will be combined into one
discrete FEM field. If this toggle is ON (default), further items pertaining
to LBC equivalencing options are enabled.
DFEM Boundary Specify how boundary conditions are merged within a DFEM field. By
Conditions default, the boundary conditions in the primary model override the
incoming secondary model values. Optionally, the secondary values can
be added to the existing primary values.
DFEM Vector Loads Specify how vector loads are merged within a DFEM field. By default,
the loads in the primary model override the incoming secondary model
values. Optionally, the secondary values can be added to the existing
primary values.
DFEM Scalar Loads Specify how scalar loads are merged within a DFEM Field. By default, the
loads in the primary model override the incoming secondary model
values. Optionally, the secondary values can be either added to the
existing primary values or merged with them.
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Neutral Options Brings up the Neutral Import Options form that enables you to select the
types of entities targeted for import.
Parameter Description
Define Offsets... Select this button if the likelihood of entity ID duplication exists (e.g.,
when several neutral files are imported). It will activate the Entity Label
Offset Definition form in which you can specify offsets to avoid
conflicting IDs.
Assigning Offsets
Same for all entity types:
click on Offset, type the offset in the Input Offset Value data, press Enter, or
pick Automatic Offset to let the system assign offset automatically.
Unique value to each entity type:
click on an entity, type the offset in the Input Offset Value data field, press Enter, or
select Automatic Offset.
File>Import 103
Importing Models and Results
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
MSC Nastran Options Brings up the Entity Selection form that enables you to select the types
of entities targeted for import.
Parameter Description
Define Offsets... Select this button if the likelihood of entity ID duplication
exists (e.g., when several MSC Nastran files are imported).
It will activate the Entity Label Offset Definition form in
which you can specify offsets to avoid conflicting IDs.
Create Prop. & Matl. Groups Select this button to create groups based on property sets
and materials.
Retrieve Names From Comments By selecting this button, Patran to attempt to figure out the
names of properties and materials from the comments in
the input deck. The only comments that Patran recognizes
at this time are those comments made by Patran.
Assigning Offsets
Same for all entity types:
click on Offset, type the offset in the Input Offset Value data, press Enter, or
pick Automatic Offset to let the system assign offset automatically
Unique value to each entity type:
click on an entity, type the offset in the Input Offset Value data field, press Enter, or
select Automatic Offset.
106 File>Import
Importing Models and Results
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Express Options Brings up the Express Import Options form where you can select the type
and attributes of entities targeted for import.
Parameter Description
Import Preferences Activates the Import Preferences dialog box in which you can specify how
certain geometric entities will be represented in the Patran database.
Entity Types Identifies the classes of geometric entities from which you can select.
Geometry Types Specifies the various kinds of entities available within the entity class you
selected (for example, if the Entity Type you selected was Solid, the
Geometry Type may be Solid of Revolution)
108 File>Import
Importing Models and Results
Parameter Description
Entity Colors Provides a color filter to further differentiate entities selected for import.
Entity Layers
All Layers If ON, all entities are import candidates, regardless of layer assignment.
Layer Numbers Turn All Layers OFF and identify the layers on which the imported
entities reside.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Preview Express File... Allows you to display the contents of the import file to inspect prior to
actually bringing it into your database.
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the EXPRESS file with _Ln
appended. For example, if the EXPRESS file name is test.model and
there are two layers 1,2, then the two groups will be named: test_L1 and
test_L2. See Create Groups from Layers, 118 for additional information.
Parameter Description
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented
in the database (simply trimmed or general trimmed).
Solid Representation Solids may appear in boundary representation (B-rep Solids) or as a
collection of constituent surfaces. The Parameterized Solid option allows
B-rep solids, whose faces are biparametric surfaces, to be automatically
converted to triparametric solids.
Enable Tolerance Prompt If OFF (default), global model tolerance is calculated based on the
expected maximum model size (see Global Model Tolerance, 437), without
prompting for a response.
Enable Geometry Tracking If ON, a geometry tracking log file will be created to describe geometric
attributes of imported geometry.
Import Action
Import Geometry Executes geometry import.
Calculate Model Tolerance Processes the file to help determine the best tolerance for geometry
import.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the class of the imported geometric entities (e.g., Curve) whose
members will be added to the group.
Group Geometry Types Highlights the entities that belong the class selected above. Pick one,
several, or all to add to the group.
Group Entity Color Filter imported entities by color. For example, having selected Curve
before, click Red and only red-colored curves will be imported.
File>Import 111
Importing Models and Results
Parameter Description
Group Entity Layers All--select all entities regardless of layer assignments
Layer numbers--Toggle All Layers OFF and enter the layer
number(s) where the imported entities reside in the CAD database
Show Express Groups Display the Patran groups that have been defined for imported entities.
Delete Express Groups Delete Patran groups defined for imported geometry.
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
IGES Options Brings up the IGES Import Options form that enables you to specify the
types and attributes of entities targeted for import.
Parameter Description
Entity Types Identifies the geometric or finite element entities you can import.
Entity Attributes
Curve on Surface Stipulate your preference as to how trimming curves should be represented
Preferences on trimmed surfaces:
Parameter Description
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when a
Unigraphics-NX file is imported. This file will be assigned a.xmt_txt file
name extension.
Load Database File This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Allow Duplicate CAD If this toggle is ON, it allows duplicate CAD model to be imported.
Model
Parameter Description
Color Definition Entity IGES entities may refer to an IGES Color Definition Entity (Type 314)
that defines the color of entities.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the class of the imported geometric entities (e.g., Composite Curve)
whose members will be added to the group.
Group Entity Color Filter entities by color. For example, having selected Composite Curve,
click Red to import only red-colored composite curves.
Group Entity Layers All--select all entities regardless of layer assignments
Layer numbers--Toggle All Layers off and enter layer numbers where
the entities targeted for import reside in the CAD database.
Show IGES Groups View all groups defined for imported IGES entities.
Delete IGES Groups Delete groups defined for imported IGES entities.
Options Form
You can select translation parameters for import or export on this form.
120 File>Import
Importing Models and Results
Parameter Description
Direct Way If checked, translator component will be using an API exposed by
translator, which save the data directly into parasolid.
Heal Importing model geometry from a less precise system can sometimes
produce errors that can lead to invalid models. Such geometry is clearly
undesirable.
If checked, the healing functionality fixes it by adjusting the data to
Parasolid’s default precision. Parasolid contains a range of functionality
for the user to create Parasolid entities from imported data.
Healing must be performed carefully, however, too much heal and the
gross changes in shape that occur will corrupt the original design intent
of the model.
Translate Hidden If checked, Patran will import all hidden entities in native model.
Parameter Description
Geometry Import Icons Select the block icon (Linux only) to import CATIA geometry.
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
CATIA Options Brings up the CATIA Import Options form that enables you to select the
type and attributes of entities targeted for import.
Import to Parasolid If ON, CATIA V4 models are imported in a Parasolid geometry format.
CATIA V5 and CATIA V6 models will always be imported in Parasolid
format and CATXPRES models will not be imported in Parasolid
format.
File Type Specifies the type of the imported input file. This may be a CATIA V4
model file (.Model extension), a CATIA V5 part file (.CATPart
extension), a CATIA V5 product file (.CATProduct extension), a CATIA
V6 part file (.3DXML extension) or a CATXPRES output file (.cat
extension).
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
File>Import 123
Importing Models and Results
Parameter Description
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
Import NoShow Entities If on, CATIA V4 entities that are classified as “NoShow” will be
imported.
Import Attributes If ON, attributes attached to the geometry will be imported. Turning
Import Attributes OFF will improve import performance.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in CATIA V4 to import geometry from.
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the CATIA file with _Ln
appended. For example, if the CATIA file name is test.model and there
are two layers 1,2, then the two groups will be named: test_L1 and
test_L2. See Create Groups from Layers, 118 for additional information.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Parameter Description
Select Options... Brings up the Options Form, where you can select translation parameters for
import.
Sew Sheet Bodies
Patran Sew Instructs Patran to sew together sheet bodies using Patran Sewing
software.
Verify Boundary The Verify Boundary command is similar to the
Verify/Surface/Boundary command in Patran.
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when a
CATIA file is imported. This file will be assigned a.xmt_txt file name
extension.
Load Database File This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Allow Duplicate CAD Model If this toggle is ON, it allows duplicate CAD model to be imported.
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
126 File>Import
Importing Models and Results
Parameter Description
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
Import Attributes If this toggle is ON (the default), attributes attached to the geometry,
including layer attributes, will be imported. Turning Import Attributes
OFF improves import performance.
Attribute Name Types Patran will create a string attribute and attach it to geometry associated
with a CATIA V5 publication, feature name, or publication and Feature
Name by selecting "Publication", "Feature Name", or both.
If you unselect both "Publication" and "Feature Name", no attributes
will be created. If you select both, the CATIA V5 Tree structure will be
imported as Hierarchical groups. An example is shown below.
Example Scenario 1:
P1.CATPart with a Part ID of P1 containing two entities;
A feature named Loft.1 with a published name PUB_EDGE,
A feature named SURFACE_FEATURE.
Selecting “Feature Name” option will result in:
attribute syntax: Part_ID;feature_name
The geometry associated with the feature “Loft.1” will have an attribute with the string "P1;Loft.1" and
the geometry associated with the feature “SURFACE_FEATURE” will have an attribute with the string:
"P1;SURFACE_FEATURE".
Selecting “Publication” option will result in:
attribute syntax: Part_ID;publication_name
The geometry associated with the publication “PUB_EDGE” will have an attribute with the string
"P1;PUB_EDGE".
Selecting both “Feature Name” and “Publication” will result in:
attribute syntax: Part_ID;publication_name;feature_name
The geometry associated with the feature “Loft.1” will have an attribute with the string
"P1;PUB_EDGE;Loft.1" and the geometry associated with the feature “SURFACE_FEATURE” will
have an attribute with the string "P1;SURFACE_FEATURE".
File>Import 127
Importing Models and Results
Parameter Description
Example Scenario 2:
A CATProduct file with a product id of BLISKPROD contains a subproduct file with an instance name
of BLISKSUBPROD.1 and a CATPart file with an instance name of DAM3.1 that contains two entities,
A feature named Blisk.1 with a published name BLISK_ONE,
A feature named Blisk.2 with a published name BLISK_TWO.
Selecting “Feature Name” option will result in:
attribute syntax:
Product_ID\SubProduct_Instance_Name\Part_Instance_Name;feature
_name
The geometry associated with the features “Blisk.1” and “Blisk.2” respectively will have an attribute with
the string:
"BLISKPROD\BLISKSUBPROD.1\DAM3.1;Blisk.1"
"BLISKPROD\BLISKSUBPROD.1\DAM3.1;Blisk.2"
Selecting “Publication” option will result in:
attribute syntax:
Product_ID\SubProduct_Instance_Name\Part_Instance_Name;publica
tion_name
The geometry associated with the publications “BLISK_ONE” and “BLISK_TWO” respectively will have
an attribute with the string:
"BLISKPROD\BLISKSUBPROD.1\DAM3.1;BLISK_ONE"
"BLISKPROD\BLISKSUBPROD.1\DAM3.1;BLISK_TWO"
Selecting both “Feature Name” and “Publication” will result in:
attribute syntax:
Product_ID\SubProduct_Instance_Name\Part_Instance_Name;publica
tion_name;feature_name
The geometry associated with the features “Blisk.1” and “Blisk.2” and publications “BLISK_ONE” and
“BLISK_TWO” respectively will have an attribute with the string:
"BLISKPROD\BLISKSUBPROD.1\DAM3.1;BLISK_ONE;Blisk.1"
"BLISKPROD\BLISKSUBPROD.1\DAM3.1;BLISK_TWO;Blisk.2"
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in CATIA V5 CATPart or CATProduct to import
geometry from.
128 File>Import
Importing Models and Results
Parameter Description
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the CATIA file with _Ln
appended. For example, if the CATIA file name is test.CATPart and
there are two layers 1,2, then the two groups will be named: test_L1 and
test_L2. See Create Groups from Layers, 118 for additional information.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities. The Import to Group Hierarchy toggle needs to be on
if CATIA V5 tree structures are to be imported. This is ON by default.
See the next section.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Parameter Description
Load Database File This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Allow Duplicate CAD Model If this toggle is ON, it allows duplicate CAD model to be imported.
In order to retrieve these attributes from the Patran database, there are two functions that may be used:
ps_get_body_string_attribute, 39 and ps_get_string_attribute (p. 40) in the PCL Reference Manual. For examples of
how these functions are utilized please see, ps_get_body_string_attribute, 16 and ps_get_string_attribute (p. 17) in
the PCL Reference Manual Examples.
Once the CATIA V5 file is imported the tree is accessible as Patran heirarchical groups. For display purposes,
these groups can be turned on and off (posted and unposted).
File>Import 131
Importing Models and Results
.
132 File>Import
Importing Models and Results
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is Parameterized Solid. If you change
to B-rep Solid, solid is formed from a group of topologically congruent
surfaces that define a completely closed volume.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. General trimmed surface
can have any number of outer edges and any number of inner edges
which describe holes or cutouts. These outer and inner edges are defined
by a closed loop of chained curves. You can change the trimmed surface
type to simply trimmed. A simply trimmed surface can only have four
outer edges. It cannot have any inner edges, or holes or cutouts.
Import Attributes The default is OFF. If this toggle is ON, attributes attached to the
geometry, including layer attributes, will be imported. Keeping Import
Attributes OFF improves import performance.
Attribute Name Types Patran will create a string attribute and attach it to geometry associated
with a CATIA V6 feature name, by selecting "Feature Name".
If you unselect "Feature Name", no attributes will be created. This
behavior is similar to the CATIA V5 import attributes.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in CATIA V6 3DXML to import geometry from.
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the CATIA file with _Ln
appended. For example, if the CATIA file name is test.CATPart and
there are two layers 1,2, then the two groups will be named: test_L1 and
test_L2. See Create Groups from Layers, 118 for additional information.
134 File>Import
Importing Models and Results
Parameter Description
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities. The Import to Group Hierarchy toggle needs to be on
if CATIA V6 tree structures are to be imported. This is ON by default.
See the next section.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
An example of importing the tree structure of a CATIA V6 part or assembly file is as follows:
Once the CATIA V6 file is imported the tree is accessible as Patran hierarchical groups. For display purposes,
these groups can be turned on and off (posted and unposted).
136 File>Import
Importing Models and Results
Note: If you have a license for Catia V5 access, you do not need an additional license for
Catia V6 support.
File>Import 137
Importing Models and Results
An example of imported CATIA V6 part or assembly file in review mode is as shown below:
138 File>Import
Importing Models and Results
Note: In case of Review mode, Patran creates intermediate *.stl file to import tessellation
data due to this import process may take more time to complete than the usual.
File>Import 139
Importing Models and Results
Parameter Description
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database (simply trimmed or general trimmed).
Solid Representation Solids may appear in boundary representation (B-rep Solids) or as a
collection of constituent surfaces. The Parameterized Solid option allows
B-rep solids, whose faces are biparametric surfaces, to be automatically
converted to triparametric solids.
Enable Tolerance Prompt If OFF (default), global model tolerance is calculated based on the
expected maximum model size (see Global Model Tolerance, 437), without
prompting for a response.
Enable Geometry Tracking If ON, a geometry tracking log file will be created to describe geometric
attributes of imported geometry.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the type of imported geometric entities that will be added to the
group.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in CATIA V4 to import geometry from.
Show Groups View all groups defined for imported CATIA entities.
Delete Groups Delete groups defined for imported CATIA geometry.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the type of imported geometric entities that will be added to the
group.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in CATIA V5 to import geometry from.
Show Groups View all groups defined for imported CATIA entities.
Delete Groups Delete groups defined for imported CATIA geometry.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the type of imported geometric entities that will be added to the
group.
Group Entity Layers All--select all entities regardless of layer assignments
Layer numbers--toggle All Layers off and enter the layer(s) where the
imported entities reside in the CAD database
Import to Group Hierarchy ON by default. Necessary when importing the CATIA tree structure.
Only valid for CATIA V5.
Show Groups View all groups defined for imported CATIA entities.
Delete Groups Delete groups defined for imported CATIA geometry.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the type of imported geometric entities that will be added to the
group.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in CATIA V6 to import geometry from.
Import to Group Hierarchy ON by default. Necessary when importing the CATIA tree structure.
Only valid for CATIA V5 and CATIA V6.
Show Groups View all groups defined for imported CATIA entities.
Delete Groups Delete groups defined for imported CATIA geometry.
144 File>Import
Importing Models and Results
Parameter Description
Geometry Import Icons Select the block icon to import Pro/ENGINEER geometry. To import a
mesh, see Importing Direct Mesh from a Pro/ENGINEER Model, 153.
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Pro/ENGINEER Options Activates the Pro/ENGINEER Import Options form that enables you to
select the type and attributes of entities targeted for import.
Import to Parasolid If ON, Pro/ENGINEER models are imported in a Parasolid geometry
format.
File Type Select the type of Pro/ENGINEER file you are importing.
File>Import 145
Importing Models and Results
Parameter Description
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Parameter Description
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when a
Pro/ENGINEER file is imported. This file will be assigned a .xmt_txt file
name extension.
Parameter Description
Import Preferences Activates a dialog box in which you can specify how certain geometric
entities will be represented in the Patran database.
Entity Types Identifies the classes of geometric entities from which you can select.
Material Import details:
Two values will be extracted from each part (if a material reference is
available):
Parameter Description
These parameters will be written to the .geo file as a record
“PTC_Material” with these values:
PTC_MATERIAL
4
Part Name
Material Name
Elastic Modulus
Poisson Ratio
Mass Density
Thermal Expansion Coeff
Reference Temperature
Thermal Conductivity
When a part is assigned a material name, but there is no material data or
user parameter (“PART_SPECIFICATION_NO”) assigned, the
resulting record in the .geo file would be:
PTC_MATERIAL
2
Part Name
Material Name
In addition, each solid will be associated with the proper material
property via the creation of an element property record.
This will result in the creation of two Patran entities:
Material property - w/ name, and associated data (see below)
Element property - referencing material and associated solids(s)
The material property will be created with two different options:
1. If a non-null value is found for the user defined parameter
"PART_SPECIFICATION_NO", an "Externally Defined"
material will be created, with the following attributes:
• Name=material name associated with the Pro/E part
• Description="Material info extracted from Pro/Engineer on
date-time-stamp – [MATERIAL=material-name-here] and
[PART_SPECIFICATION_NO=part-spec-here]."
150 File>Import
Importing Models and Results
Parameter Description
2. In all other situations (the user defined parameter
"PART_SPECIFICATION_NO" is not found, or is a null
value), an isotropic material will be created, with the following
attributes:
• Name=material name associated with the Pro/E part
Description="Material info extracted from Pro/Engineer on
date/timestamp [MATERIAL=material-name-here]."
• Elastic Modulus (material word_id=2)=- young_modulus;
• Poisson's Ratio (material word_id=5)=- poisson_ratio;
• Density (material word_id=16)= - mass_density;
• Thermal Expansion Coeff (material word_id=24)= -
therm_exp_coef;
• Reference Temperature (material word_id=1)=-
therm_exp_ref_temp;
• Thermal Conductivity (material word_id=17) =-
therm_conductivity;
No modification or extension to the Patran database is required to
support this implementation.
Note: the Description will be created “on-the-fly” by the
sgm_ptc_access_v5 PCL function when the GEO file is read into Patran.
The element property will be created with the following options:
Property Name = derived from Pro/E part name (similar to group
naming convention)
Material Name = material name associated with the Pro/E part
Application Region: Solid ID for corresponding Pro/E solid as
created in Patran
Element type and property option IDs are preference dependent.
Default values for Hexagon’s standard preferences are summarized in
the following table:
Formulation Option 1 1 1 1 1 1
ID
Laminate Option ID 20 15 15 15 20 7
DOF N N N N N N
Surface Types: Lists the kinds of surfaces available for selection if the Entity Type you
picked is Solid or Surface.
Model Access Options These options are coupled with the File Type selection (in the Import
dialog box), to determine whether an intermediate file (.geo) will be
created and saved, and whether or not the Pro/ENGINEER database will
be loaded directly into the Patran database.
Save Geometry File (.geo)--create an intermediate (.geo) file
Load Database-- import data into Patran
Create Groups from Parts--if ON, a group will be created for:
each part in an assembly
each part that is not a component of an assembly
each .geo file created from an assembly--one group is created for each
component part
each .geo file created from a single part--one group is created for the
part.
152 File>Import
Importing Models and Results
Surface Types Lists the kinds of surfaces available for selection if the Entity Type you
picked is Solid or Surface.
Model Access Options These options are coupled with the File Type selection (in the Import
dialog box), to determine whether an intermediate file (.geo) will be
created and saved, and whether or not the Pro/ENGINEER database will
be loaded directly into the Patran database.
Save Geometry File (.geo)--create an intermediate (.geo) file
Load Database-- import data into Patran
Create Groups from Parts--if ON, a group will be created for:
each part in an assembly
each part that is not a component of an assembly
each .geo file created from an assembly--one group is created
for each component part
each .geo file created from a single part--one group is created
for the part.
run Pro/ENGINEER
create the intermediate .geo file
load the geometry into the Patran database
delete the .geo file.
Part Save Geometry File Apply these two selections together to:
(.geo)
run Pro/ENGINEER
Load Database create the intermediate .geo file
load the geometry into the Patran database
save the .geo file.
Part Save Geometry File Apply these two selections together to:
(.geo)
run Pro/ENGINEER
create the intermediate .geo file
save the .geo file.
not load the geometry
Primitive Geometry Save Geometry File Apply these two selections together to:
(.geo)
not run Pro/ENGINEER (the .geo file has
Load Database already been created)
load the geometry from the .geo file into
Create Groups from Parts
the Patran database
if an Assembly, create groups from parts
save the .geo file.
Parameter Description
Geometry Import Icons Selecting the mesh icon runs Direct Mesh on a Pro/ENGINEER model
to create and import a mesh.
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Direct Mesh Options Brings up the Direct Mesh Options form that enables you to select the
type and topology of the mesh.
Parameter Description
Mesh Type Specifies the type of mesh that Direct Mesh creates; Tri, Tet, or Tri and
Tet.
Element Size Specifies the element size either by instructing Patran to calculate the
element size or by defining the Maximum/Minimum element size. If you
define a Maximum, the minimum will be calculated as 10% of the
maximum. This value may be overridden.
Element Topology Defines the topology of the elements created during the meshing process.
Mesh Offsets Enables you to define offset values if multiple meshes are being imported.
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Unigraphics-NX Options Brings up the Unigraphics-NX Import Options form that enables you to
select the type and attributes of entities targeted for import.
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
158 File>Import
Importing Models and Results
Parameter Description
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
Import NoShow Entities If on, Unigraphics-NX entities that are classified as “NoShow” will be
imported.
Import Attributes If ON, attributes attached to the geometry will be imported. Turning
Import Attributes OFF will improve import performance.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in Unigraphics-NX to import geometry from.
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the Unigraphics-NX file with _Ln
appended. For example, if the Unigraphics-NX file name is test.model
and there are two layers 1,2, then the two groups will be named: test_L1
and test_L2. See Create Groups from Layers, 118 for additional information.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Parameter Description
Patran Sew Instructs Patran to sew together sheet bodies using Patran Sewing
software.
Verify Boundary The Verify Boundary command is similar to the
Verify/Surface/Boundary command in Patran.
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when a
Unigraphics-NX file is imported. This file will be assigned a.xmt_txt file
name extension.
Load Database File This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Allow Duplicate CAD Model If this toggle is ON, it allows duplicate CAD model to be imported.
160 File>Import
Importing Models and Results
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
SolidWorks Options Brings up the SolidWorks Import Options form that enables you to
select the type and attributes of entities targeted for import.
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
162 File>Import
Importing Models and Results
Parameter Description
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
Import NoShow Entities If on, SolidWorks entities that are classified as “NoShow” will be
imported.
Import Attributes If ON, attributes attached to the geometry will be imported. Turning
Import Attributes OFF will improve import performance.
Entity Layers
All Layers If on, all geometry will be imported regardless of whether or not the
geometry is on layers.
Layer numbers Specify which layers in SolidWorks to import geometry from.
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the SolidWorks file with _Ln
appended. For example, if the SolidWorks file name is test.model and
there are two layers 1,2, then the two groups will be named: test_L1 and
test_L2. See Create Groups from Layers, 118 for additional information.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Parameter Description
Patran Sew Instructs Patran to sew together sheet bodies using Patran Sewing
software.
Verify Boundary The Verify Boundary command is similar to the
Verify/Surface/Boundary command in Patran.
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when a
SolidWorks file is imported. This file will be assigned a.xmt_txt file name
extension.
Load Database File This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Allow Duplicate CAD Model If this toggle is ON, it allows duplicate CAD model to be imported.
Parameter Description
File Name The name of the Parasolid transmit file to import. In order to avoid the
transmit file from being deleted after import, do not use “-ps0001” as
part of the file name. For example, test-ps0001.x_t will be deleted after
it is imported. (-ps0001 is a string concatenated onto the input file name
for internal purposes.)
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
Parasolid xmt Options Activates the Parasolid xmt Import Options form that enables you to
select the type and attributes of entities targeted for import.
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
166 File>Import
Importing Models and Results
Parameter Description
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
Entity Layers
All Layers If ON, all entities are import candidates, regardless of layer assignment.
Layer Numbers Turn All Layers OFF and enter the layers on which the entities reside.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Parameter Description
Verify Boundary The Verify Boundary command is similar to the
Verify/Surface/Boundary command in Patran.
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
ACIS Options Activates the ACIS Import Options form that enables you to select the
type and attributes of entities targeted for import.
See the current Patran Release Guide for currently supported version of the ACIS® Geometric Modeler and
Parasolid®. A summary of features and limitations follows.
File>Import 169
Importing Models and Results
Parameter Description
Import Geometry The default, Import Geometry will import the geometry after the Apply
button is selected on the import form. The secondary toggle, Import
Preview will run the translator and provide a summary of geometry and
layer information without importing the geometry.
Entity Types Identifies the type of geometric entities from which you can select.
File>Import 171
Importing Models and Results
Parameter Description
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
All Layers If ON, all entities are import candidates, regardless of layer assignment.
Group Classification Displays a dialog box in which you specify group assignments for
imported entities.
Model Units Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, meters, millimeters or custom
value units.
The default model units override value is the Patran geometry preference
value for "Geometry Scale Factor" which is 39.370079 (Inches).
Then when opening a new database to import geometry into from a CAD
System, it will use this value as the default model units for the imported
geometry.
Create Groups from Layers Select the “Create Groups from Layers” button. A sub-menu appears. If
the “Create Groups from Layers” toggle is ON (Default), a Patran Group
is created for each Layer and all geometry on a layer is added to a Patran
Group. The group name(s) will be defined by the “Group Name Prefix”
provided by the user or if the user did not provide a “Group Name Prefix”
the group name(s) will be the prefix of the ACIS file with _Ln appended.
For example, if the ACIS file name is test.sat and there are two layers 1,2,
then the two groups will be named: test_L1 and test_L2. See Create Groups
from Layers, 118 for additional information.
Select Options... Brings up the Options Form, where you can select translation parameters for
import.
Sew Sheet Bodies
Patran Sew If Patran Sew is ON, Sheet Bodies will be equivalenced or sewn together
using Patran Sewing software.
172 File>Import
Importing Models and Results
Parameter Description
Verify Boundary The Verify Boundary command is similar to the Verify/Surface/Boundary
command in Patran.
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when the
ACIS file is imported. This file will be assigned an .xmt_txt file name
extension.
Load Database File This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Allow Duplicate CAD Model If this toggle is ON, it allows duplicate CAD model to be imported.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the type of imported geometric entities to add to the group.
Group EntityLayers All--selects all entities regardless of layer assignments·
Layer numbers--Toggle All Layers OFF and enter the layer(s)
where the imported entities reside in the ACIS file.
Show Groups Display all groups defined for imported ACIS entities.
Delete Groups Delete groups defined for imported ACIS entities.
Benefits
The ability to design, simulate and collaborate on a product model in an extended enterprise of many
companies and engineering disciplines requires a standard for describing both geometry data (AP203, AP209,
???and AP214???). The STEP standards supported by Patran provide the following extended
import/export/archiving benefits:
Support for Solids (B-rep) export. Previously, only IGES export of geometry was available, which
does not support solids
Support for SDRC geometry import (including solids) via STEP. Previously, only IGES import of
geometry was available.
174 File>Import
Importing Models and Results
Licensing
STEP AP203 requires an Patran STEP AP203 Access license. STEP AP209 requires an Patran STEP AP209
Access license. STEP AP214 requires an Patran STEP AP214 Access license. For more information, contact
your Hexagon account representative.
In the Import dialog box, select STEP as the source of the imported database.
File>Import 175
Importing Models and Results
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
STEP Options Brings up the STEP AP203/AP214 or AP209 Import Options form that
enables you to select the type and attributes of entities targeted for
import. Note that the same form is used to specify either STEP AP203
or AP214 options but that a different form is used to specify AP209
options.
Import to Parasolid Converts STEP geometry into Parasolid geometry format.
File Type Specifies the type of the imported input file. This may be a STEP 203 or
214 file or a STEP 209 file.
Important: STEP composite surface entity has no suitable entity in Patran, so it is not supported.
STEP currently does not support Patran Composite Trimmed Surfaces.
Not all AP203 and AP209 data model entities are supported. The following sections define the scope of both
AP data schemas’ coverage provided in this release.
Entities Features
Geometry Geometry data comprising Curves, Surfaces and Solids are exported,
imported, from geometrically bounded surface shape representations and/or
advanced-Brep shape representations. Assemblies are also supported.
Association of Geometry data to Configuration Management data is
maintained when exported. AP209 translation supports all of the AP203
geometry types.
Configuration Control Support for Configuration Management data conforming to agreed upon
Data STEP minimum subset.
FEM/FEA Data Nodes Support for import and export of nodes in the global coordinate system.
Elements Support for the following Element types:
Volume Elements:
Hexahedral elements:
HEX8, HEX9, HEX20, HEX21, HEX26, HEX27, HEX32&HEX64
Pentahedral elements:
WEDGE6, WEDGE15 & WEDGE24
Tetrahedral elements:
TET4,TET10&TET16
Surface Elements:
Quadrilateral elements:
QUAD4,QUAD5,QUAD8, QUAD9,QUAD12&QUAD16
Triangular elements:
TRI3,TRI4,TRI6&TRI9
Curve Elements:
BAR2,BAR3&BAR4
Materials Support for Isotropic, Orthotropic and Anisotropic Materials with linear
constituent model.
Regions Support for the element properties:
Surface Elements:
Membrane Stiffness, Bending Stiffness, Coupling Stiffness, Shear Stiffness
and Thickness.
Curve Elements:
Cross sectional area, Second Moment of Inertia, Torsional and Warping
Constant and Non-structural Mass.
Entities Features
Loads and Boundary Point Loads: At Nodal positions.
Conditions (LBCs) and Pressure Loads: Element Uniform and Element Varying Pressure Loads are
MPCs supported for loads applied on faces of Volume Elements and Surface
Elements.
Distributed Loads: Element Uniform and Element Varying Distributed
Loads are supported for loads applied on Curve Elements.
Single Point Constraints: Nodal Displacements.
Multi Point Constraints: Only Explicit MPCs are supported.
LBCs: Associated with at least one Load Case are only exported.
Load Cases Load Cases which have at least one of the supported LBCs are exported.
Output Requests Support for Multiple Jobs.
Support is available for only those Load Cases associated with a single result
Subcase.
Parameter Description
Entity Types Identifies the type of geometric entities from which you can select.
Geometry Preference Identifies the surface type (solid or trimmed surface) to be created during
the import operation.
Solid Type Specifies how solids will be represented in the database -- either as B-rep
or Parameterized Solids. The default is B-rep Solid. If you change to
Parameterized Solid, all 5 or 6 sided B-rep solids will be converted into
parameterized solids during import.
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database. The default is general trimmed. You can change the trimmed
surface type to simply trimmed.
184 File>Import
Importing Models and Results
Parameter Description
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Model Units
Select Options... Brings up the Options Form, where you can select translation parameters for
import.
Sew Sheet Bodies
Patran Sew Instructs Patran to sew together sheet bodies using Patran Sewing
software.
Verify Boundary The Verify Boundary command is similar to the Verify/Surface/Boundary
command in Patran.
Equivalence Edge Vertices If this toggle is ON, topological vertices will be equivalenced during
import.
Save Transmit File If this toggle is ON, the parasolid transmit file will be saved when a STEP
file is imported. This file will be assigned a .xmt_txt file name extension.
Load CC1 Data If ON, loads Configuration Control Data (Class 1).
Parameter Description
Entity Types Identifies the type of geometric entities from which you can select.
All Layers If ON, all entities are import candidates, regardless of layer assignment.
Layer Numbers Turns All Layers off. Enter the layers where the entities you want to
import reside.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Scale Factor Brings up a dialog box in which you can override the model units during
import. The settings now include: inches, millimeters or custom value
units.
186 File>Import
Importing Models and Results
Parameter Description
Load Database This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Load CCI Data If ON, loads Configuration Control Data (Class 1).
Parameter Description
Import Preferences Activates a dialog box in which you can specify how certain geometric
entities will be represented in the Patran database.
Entity Types Identifies the type of geometric entities from which you can select.
All Layers If ON, all entities are import candidates, regardless of layer assignment.
Layer Numbers Turns All Layers off. Enter the layers where the entities you want to
import reside.
Group Classification... Brings up a dialog box in which you specify group assignments for
imported entities.
Load Database This toggle is ON and dimmed (unavailable) unless the “Save Transmit
File” toggle is ON. In that case, you can uncheck “Load Database File” if
you simply wish to create a transmit file and do not want to import a
database.
Imported Data Use this pull-down list to select the types of data you wish to import.
Parameter Description
Trimmed Surface Type Specifies how four-edged faces of trimmed surfaces will be represented in
the database (simply trimmed or general trimmed).
Solid Representation Solids may appear in boundary representation (B-rep Solids) or as a
collection of constituent surfaces. The Parameterized Solid option allows
B-rep solids, whose faces are biparametric surfaces, to be automatically
converted to triparametric solids.
Enable Tolerance Prompt If OFF (default), global model tolerance is calculated based on the
expected maximum model size (see Global Model Tolerance, 437), without
prompting for a response.
Enable Geometry Tracking If ON, a geometry tracking log file will be created to describe geometric
attributes of imported geometry.
Import Action
Import Geometry Executes geometry import.
Calculate Model Tolerance Processes the file to help determine the best tolerance for geometry
import.
Parameter Description
Group Name Enter a group name.
Group Entity Types Select the type of imported geometric entities that will be added to the
group.
Group Entity Layers All--selects all entities regardless of layer assignments
Layer numbers--Toggle All Layers OFF and enter the layer(s) where
the imported entities reside in the Unigraphics database
Show Groups... Display all groups defined for imported STEP entities.
Delete Groups... Delete groups defined for imported STEP entities.
Parameter Description
Current Group Displays the current group into which the imported entities will be
placed. If you enter a group name that does not yet exist, a new group
with this name will be created and made current.
STL Options Brings up the STL Import Options form that enables you to specify the
types and attributes of entities targeted for import.
Parameter Description
Define Offsets... Select this button if the likelihood of entity ID duplication exists (e.g.,
when several neutral files are imported). It will activate the Entity Label
Offset Definition form in which you can specify offsets to avoid
conflicting IDs.
Assigning Offsets
Same for all entity types:
click on Offset, type the offset in the Input Offset Value data, press Enter, or
pick Automatic Offset to let the system assign offset automatically.
Unique value to each entity type:
click on an entity, type the offset in the Input Offset Value data field, press Enter, or
select Automatic Offset.
Importing Results
The File>Import command can also bring in results data created outside of the current database. If the
imported object is specified as Results, the Import dialog box buttons and text boxes are related to result
import choices. Imported result files may be in a variety of Patran formats.
File>Import 193
Importing Models and Results
Parameter Description
Format Select the format of the imported results file.
Current Analysis Indicate the current analysis code preference.
Code
Zero Tolerance Specify a tolerance value; a result with the absolute value less than this value will be
considered equal to zero.
Element node This switch appears when importing element (.els) files. If neither of these are ON, the
results in orderelement result file is assumed to contain element center data. All results of a particular
of: element are assigned to the element center location. Typical element result files
Connectivity normally only contain element center data for each element. However, if
Connectivity is ON, it is assumed that the element results file contains element nodal
Ascending Node results (results at each node for each element). The node ordering is assumed to be in
IDs the order of the element connectivity and results assigned to the node locations
accordingly. If Ascending Node IDs is ON, it is assumed that the element nodal results
are in the order of the node IDs in ascending order. The type of element is extracted,
the actual node connectivity determined and then the results are reordered in the order
of the element connectivity. The user must be aware of the type of data in the element
results files before turning this switch ON. If result plot appear strange, it may be due
to incorrect setting of this switch.
194 File>Import
Importing Models and Results
Element results files from an MSC Nastran fatigue analysis that correspond to the .fef file (which are .els files)
use the extension .tml and are automatically produced by the fatigue analysis if a .fef file is produced so that
you can select it as the template when importing via this mechanism.
File>Export 195
Exporting Files
With the File>Export command sequence you can transfer model data to use outside the current database.
Exported output may be in the form of Patran neutral files, or formatted as ACIS, Parasolid xmt, IGES, and
STEP files.
Parameter Description
File Name/Type Enter a new file name. The default file name extension is .out.
Format The output file may be a PATRAN 2.5 neutral file, IGES format,
Parasolid xmt file, or STEP file.
Neutral Options Activates the Neutral Export Options dialog box in which you select
exported entities and groups.
Parameter Description
Neutral File Title Activates the Neutral File Title form to enter a title for your file.
Entity Packets Displays the names of all entity types that are candidates for export. Select
the packet(s) to send to the output file.
Existing Groups Select the groups to transmit to the output file. Only those entities that
belong to a group will be exported, therefore this is a required selection.
Parameter Description
File Name/Type Enter a new file name. The default file name extension is .igs. For
multiple files, version numbers will be appended to the file name.
Format Select IGES to create an output file in IGES format.
IGES Options Activates the IGES Export Options dialog box in which you define the
IGES file sections and select exported entities and groups.
Parameter Description
Start Section Displays the IGES File Start Section form.
Global Section Displays the IGES File Global Section dialog box.
Entity Types Displays the names of all entity types that are candidates for export.
Select the entities to send to the output file.
Select Options... Brings up the Options Form, where you can select translation parameters
for export.
Parameter Description
STEP 203/209/214 Options Brings up the STEP 203/209/214 Export Options form that enables
you to select the type and attributes of entities targeted for export.
Export Through Parasolid File Uses Parasolid format as the starting format for exporting the geometry.
Type Only STEP 214 files can be created when this toggle is ON.
File>Export 203
Exporting Files
Entities Features
Geometry Geometry data comprising Curves, Surfaces and Solids are exported,
imported, from geometrically bounded surface shape representations and/or
advanced-Brep shape representations. Assemblies are also supported.
Association of Geometry data to Configuration Management data is
maintained when exported. AP209 translation supports all of the AP203
geometry types.
Configuration Control Support for Configuration Management data conforming to agreed upon
Data STEP minimum subset.
FEM/FEA Data Nodes Support for import and export of nodes in the global coordinate system.
204 File>Export
Exporting Files
Entities Features
Elements Support for the following Element types:
Volume Elements:
Hexahedral elements:
HEX8, HEX9, HEX20, HEX21, HEX26, HEX27, HEX32&HEX64
Pentahedral elements:
WEDGE6, WEDGE15 & WEDGE24
Tetrahedral elements:
TET4,TET10&TET16
Surface Elements:
Quadrilateral elements:
QUAD4,QUAD5,QUAD8, QUAD9,QUAD12&QUAD16
Triangular elements:
TRI3,TRI4,TRI6&TRI9
Curve Elements:
BAR2,BAR3&BAR4
Materials Support for Isotropic, Orthotropic and Anisotropic Materials with linear
constituent model.
Regions Support for the element properties:
Surface Elements:
Membrane Stiffness, Bending Stiffness, Coupling Stiffness, Shear Stiffness
and Thickness.
Curve Elements:
Cross sectional area, Second Moment of Inertia, Torsional and Warping
Constant and Non-structural Mass.
Entities Features
Loads and Boundary Point Loads: At Nodal positions.
Conditions (LBCs) and Pressure Loads: Element Uniform and Element Varying Pressure Loads are
MPCs supported for loads applied on faces of Volume Elements and Surface
Elements.
Distributed Loads: Element Uniform and Element Varying Distributed
Loads are supported for loads applied on Curve Elements.
Single Point Constraints: Nodal Displacements.
Multi Point Constraints: Only Explicit MPCs are supported.
LBCs: Associated with at least one Load Case are only exported.
Load Cases Load Cases which have at least one of the supported LBCs are exported.
Output Requests Support for Multiple Jobs.
Support is available for only those Load Cases associated with a single result
Subcase.
Parameter Description
Entity Types Displays the names of all entity types that are candidates for export. Select
the packet(s) to send to the output file.
Parameter Description
File Name/Type Enter a new file name. The default file name extension is .xmt. For
multiple files, version numbers will be appended to the file name.
Format Select Parasolid xmt to create an output file in xmt format.
Parasolid xmt Options Activates the Parasolid xmt Options dialog box to specify the entity types
and the Parasolid version for export.
208 File>SimXpert
Session Files
Parameter Description
Entity Types Displays the names of all entity types that are candidates for export.
Select the entities to send to the output file.
Parasolid Versions for Export Select the Parasolid Version for export from the given list. Default version
is 28.0.
SimXpert This menu item appears if you have a valid installation of SimXpert on your local
system and the environment variable MSC_SX_HOME is set pointing to the
installation directory of SimXpert. Selecting this option will launch SimXpert. If
you wish to export a current model to SimXpert, this can be done in the Analysis
application with the Action/Object/Method set to Analyze/Entire Model/Load
SimXpert in the MSC Nastran preference.
210 File>SimManager
Session Files
SimManager Publishes and retrieves Patran databases and other related analysis files directly from
within Patran with the SimManager client. Once logged on, the user may publish and
retrieve as well test connection and access the Web Client. The server settings need to
be set in order for the SimManager client to communicate with the server. The
following variables need to be set:
SM_RICH_CLIENT_IC_HOST montecarlo
SM_RICH_CLIENT_IC_PORT 8000
SM_RICH_CLIENT_IC_PROTOCOL http
SM_RICH_CLIENT_IC_WEBCONTEXT SimManager
RC_ROOT
JDK_PATH
APPS
ACTION_LOC
JARS_PATH
CLASSPATH
SCA_SYSTEM
SCA_RESOURCE_DIR
SCA_SERVICE_CATALOG
SCA_JAVA_COMP_PATH
SCA_JVM_CONFIG
RC_LIBRARY_PATH
For more information on this, please see the Patran Environment Variables (p. 38) in the
Patran Installation and Operations Guide or the SimManager documentation for more
details. Client access to a SimManager server via Patran is only supported on Windows
machines.
212 File>Session
Session Files
A session file is a log of all database related commands and corresponding comments executed during a work
session. A single session file may contain commands that were used for more than one database.
The File>Session>Play command sequence executes a specified session file either in its entirety or one
command at a time for debugging or editing purposes.
Parameter Description
File Name/Type Select or type a file name. Session files are given a.ses.xx filename
extension, where xx is a number that shows where this session file is in
the sequential order of session files.
Single Step Plays back the session file one line at a time.
Commit Commands Commits (saves) the database before each command is executed. This
prevents an Undo from canceling an entire session file.
Stop Stops playing the session file. After stopping, this button changes to
Resume. Press Resume to continue playing the session file.
file is committed. If FALSE (default), an entire session file playback may be undone. If TRUE, only the last
session file command may be undone.
Parameter Description
File Name/Type Enter a new file name. The extension.ses will be added automatically.
Record Rotations Records each incremental rotation of your model in the session and
journal files.
Stop Stops recording the session file. After stopping, this button changes to
Resume. Press Resume to continue recording the session file.
214 File>Print
Printing Patran Images
The File>Print command sequence will send Patran images to a designated printer or to a specified print file.
Print setups and properties are unique to the operating system and to each printer, but several Patran options
exist that allow you certain control over the printed output.
Printing on Windows
Parameter Description
Print From Select Viewport(s) and/or XY Window(s) to print. You can print one or
several viewports and windows on the same page. Invalid options are
disabled (e.g., if there are no XY Windows posted, the Current XY
Window option will be disabled).
One Viewport per page If this toggle is ON, only a single viewport will be printed on a page.
Print to File Toggle this ON if you do not wish to print immediately but want to save
the output to a file for later use. The following form will be superimposed
on the Print dialog box, listing the available print file options.
File>Print 215
Printing Patran Images
Postscript Files
Although different Postscript printers can have different setups and defaults, the Postscript Driver generally
supports the options listed below. Defaults are shown in bold. If desired, defaults may be overridden in the
Printer Configuration File, p3_printers.def.
Printing on Linux
For running Patran in a Linux environment, use the Print form to generate output of your Patran images.
File>Print 217
Printing Patran Images
Select the Viewport(s) and/or XY Window(s) to print. You can print multiple viewports
and windows on the same page or on separate pages. Invalid options are disabled
(e.g., Current XY Window is disabled if there are no XY Windows posted).
Current Viewport
Select the Current Printer. The list of
Available Printers is defined by the Printer
Configuration File, 225. This file can be system
Available Printers wide but is usually user specific. You can set
Postscript Default a default printer specifying the Patran
environment variable primary_printer in the
PatranHard Default settings.pcl file. Example:
CGM Default pref_env_set_string (“primary _printer”,
Patran Hardto Postcript Default “printer_name”), where printer_name
corresponds to the right hand side of the
Printer variable defined by the Printer
Configuration File, 225.
Apply Cancel
More Help:
(Available Printers)
Postscript Options, 218
Will generate an output file and either
spool it to the printer or save it in the PatranHard File Options, 222
current directory.
CGM Options, 223
218 File>Print
Printing Patran Images
Page Setup
The Page Setup subform defines the paper size, margins, print orientation and number of copies to print.
The defaults on the form are a function of the Current Printer. This form reverts to the printer’s default
settings every time the printer is selected from the listbox on the Print form.
Print Control
Choices change with the current
printer. For possible paper sizes
Paper Size Letter see the Printer Configuration File, 225.
Margins
Left 0.5 Right 0.5
Margins can be specified in the
Top 0.5 Bottom 0.5 following units: inches, cm, mm,
picas and points. If no units are
specified, inches are assumed.
Default Units Inches The default margins are a function
of the current printer.
Print Orientation
OK Cancel
Postscript Options
The Options subform defines Driver specific options. Shown below is a typical setting for a PostScript laser
printer. The options and defaults are unique to the current printer. They are defined in the Printer Configuration
File, 225. The form reverts to the printer’s default settings every time the printer is selected from the listbox
on the Print form.
File>Print 219
Printing Patran Images
Determines if the image is printed in color or black and white. In the latter case,
the spectrum colors can be optionally converted to a “black to white” or “white to
black” range.
Print Control
You can control the color of the
Background and the Lines & Text
Format Black to White independently of the Format. Valid
options are White, Black and
Actual.
Background White
Correlates the one pixel line width
Lines & Text Black on the screen to a line width on
output. Valid units are inches, cm,
mm, picas and points. Note that
Line Weight 0.25 pts there are 6 picas per inch and
72 points per inch.
Text Scale 250%
You can scale the text
Image Size Fit on Page independently of the image. Enter
a percentage. Text can be deleted
Draw Borders Yes from the output by entering
“None” in this databox.
The Postscript Driver supports the following options. The default choice is shown in bold. Note that this
default can be overridden in the Printer Configuration File, 225.
220 File>Print
Printing Patran Images
Print Control
Format Color
You can control the color of the
Image resolution (dots per inch). Background and the Lines &
Background White Text independently of the
Format. Valid options are White,
Black and Actual.
Lines & Text Actual
Filename patran.hrd
OK Cancel
CGM Options
Determines if the image is printed in color or black and white. In the latter case, the
spectrum colors can be optionally converted to a “black to white” or “white to black”
range.
Print Control
More Help:
OK Cancel (Available Printers)
Postscript Options, 218
PatranHard File Options, 222
“Fit on Page” scales the image so that it fits on the
Paper Size defined on the Page Setup form (less
margins). Or the image can be left unscaled
(same as the size on the screen) with the As Is
option.
224 File>Print
Printing Patran Images
5. If the first choice is “No Show”, then this option will not appear on the form. Its value can be preset
with a default; otherwise, the system default will be used. This feature only applies to Driver Specific
options. The Printer Definition and Page Setup options are always displayed. If all Driver Specific
options are hidden, then the Options button on the main form will be disabled (for the subject printer
only).
6. The @ sign continues the printer definition on the next line.
7. Options not assigned will be given the system default.
The following table lists each option and its possible choices. The first section refers to the Printer Definition
options and the second to the Page Setup options. These are used by all drivers. Following this are Driver
Specific options. System defaults for unspecified choices are shown in bold. Those options that accommodate
multiple choices (Option menu instead of a Databox) are also shown in bold.
Images are graphic outputs of Patran models generated in a number of popular graphics file formats that can
be accessed on various computer platforms. Image files utilize specific compression techniques. Outputs may
be static images, animations, or 3D virtual models. The supported standard Internet graphics formats are
BMP, JPEG, MPEG, PNG, TIFF and VRML.
The playback of generated images is highly dependent on the hardware and software used for viewing.
Limitations, such as window size, color maps, file size, and the number of animation frames can affect the
quality of the display.
When you select File>Images, the Output dialog box allows you to pick the output format type.
Parameter Description
File Select Use this option to navigate to the desired folder and file.
Filename Default name is the current database name with the .bmp extension.
Optionally, you can supply a new file name complete with the extension.
Overwrite If you selected an existing bitmap file name, the new image will overwrite
the image that is currently in the file.
230 File>Images
Create Graphic Images
Increment If you selected an existing bitmap file name, the new image will be added
to the image that is currently in the file.
Apply Save the image file in the specified destination folder.
Parameter Description
File Select Use this option to navigate to the desired folder or file.
Filename Default name is the current database name with the .jpg extension. You
can enter a new name but keep the .jpg extension.
Overwrite If you selected an existing file name, the new image will overwrite the
image that is currently in the file.
Increment If you selected an existing file name, the new image will be added to the
image that is currently in the file.
File>Images 231
Create Graphic Images
Quality Sets the relative quality of the image output. A value of 1.0 is the highest
quality (least compressed, largest file), and a value of 0 produces the
lowest quality (most compressed, smallest file) output.
Apply Save the image file in the specified destination folder.
Parameter Description
File Select Use this option to navigate to the desired folder or file.
Filename Default name is the current database name with the .mpg extension.
Optionally, you can supply a new file name complete with the extension.
Overwrite If you selected an existing file name, the new image will overwrite the
image that is currently in the file.
Increment If you selected an existing file name, the new image will be added to the
image that is currently in the file.
Max. Frames Set the maximum number of animation frames generated.
232 File>Images
Create Graphic Images
Start (1), Pause (2), and Stop (3) buttons to control animation file
recording.
Apply Save the image file in the specified destination folder.
Parameter Description
File Select Use this option to navigate to the desired folder or file.
Filename Default name is the current database name with the .png extension.
Optionally, you can supply a new file name complete with the extension.
Overwrite If you selected an existing file name, the new image will overwrite the
image that is currently in the file.
Increment If you selected an existing file name, the new image will be added to the
image that is currently in the file.
Apply Save the image file in the specified destination folder.
Parameter Description
File Select Use this option to navigate to the desired folder or file.
Filename Default name is the current database name with the .tif extension.
Optionally, you can supply a new file name complete with the extension.
Overwrite If you selected an existing file name, the new image will overwrite the
image that is currently in the file.
Increment If you selected an existing file name, the new image will be added to the
image that is currently in the file.
Apply Save the image file in the specified destination folder.
Parameter Description
File Select Use this option to navigate to the desired folder or file.
Filename Default name is the current database name with the .wrl extension.
Optionally, you can supply a new file name complete with the extension.
Overwrite If you selected an existing file name, the new image will overwrite the
image that is currently in the file.
Increment If you selected an existing file name, the new image will be added to the
image that is currently in the file.
Apply Save the image file in the specified destination folder.
File>Report 235
Creating Report Files
The File>Report command enables you to write and print a report file that contains a summary of a model,
its node and element attributes, properties and results. You can control the format of the report with options
you select in the Report File Preferences form, and read the completed report file using any word processor
program (e.g. Notepad).
Parameter Description
Open FIle New--create a new report file
Append--open an existing report file to add new data.
File Name Enter a new file name (keep the .rpt extension), or select an existing name
if Append was selected.
Output Format Activates the Report Format Preference dialog box in which you can
provide format specifications.
236 File>Report
Creating Report Files
Report File Name The name of the report file is automatically entered from the File Name
input field.
Report Contents Select the data you want to include in the report file.
Parameter Description
Real Numbers Select the format of displayed numerical data.
Field Width/Number of Select the appropriate number with slide bar. The width of the field must
Decimals accommodate the total number of digits and the decimal point contained
in each field of the tabular report.
Integers Select the number of integers expected in the numbers contained in the
tabular report.
Spacing Select the number of spaces between columns in the tabular report.
Group Names
Groups, as well as several other database objects (e.g. viewports), are assigned names to differentiate them
from one another. In naming groups, you must conform to the following set of rules:
Uniqueness--each name must be unique.
Number of characters--name may not contain more than 31 characters.
“Legal” characters--the following characters are acceptable in names:
a through z
A through Z
0 through 9
-, _ , and .
Case sensitivity--upper and lower case letters are differentiated. For example, group_1 and Group_1 are
regarded as two distinct groups.
Optional prefixes and suffixes--a prefix and/or suffix added to a stem name can make it easier to
manage named objects. For example:
asm.wheel.left
Group Membership
A group may consist of any combination of geometric and finite element entities. Other design features, such
as coordinate frames, materials, element properties, loads and boundary conditions, fields, and analysis results
cannot be categorized as group members even though they are associated with group members.
Group Status
The status of a group may be:
current or not current
posted or unposted
target group
Current Group
The current group is the active and visible group that receives all newly created entities. Any group may be
selected as current, however only one group may be current at any given time. The name of the current group
is displayed as part of the Viewport Banner.
Each viewport has its own current group but the only active current group is that of the current viewport (see
also Current Viewport, 305).
Posted Group
Posted groups are the groups that are visible in a viewport. A current group is automatically posted, but any
number of additional groups may also be posted to the same viewport. A group may be posted to more than
one viewport.
Posting gives you the power of selectively displaying entities, since only those entities that are contained in
posted groups are visible in a viewport.
You can unpost any posted group but do not unpost the current group, or else you will not be able to see the
geometric and finite element entities as they are created. If you try to unpost the current group Patran asks
you to assign a new current group.
Target Group
A group selected for action in certain commands (e.g., Group Translate). The operation takes place using only
the entities in the target group(s).
Group Attributes
For each group you may specify a unique color and rendering style (e.g., smooth shaded), and display entity
labels. Although attributes can be assigned to groups in the Group Menu, for attribute definitions you must
look in the Display Menu (see The Display Menu, 366).
242 Patran Reference Manual
Group Concepts and Definitions
Transforming Groups
Group transformations allow you to translate, rotate, and otherwise modify the position of a large number of
entities in a single step. Several transformations, e.g., rotation, allow repeated iterations as well.
Deleting Groups
When a group is deleted, or dissolved, its former members remain in the model database unless you
specifically request to delete them.
Note that the current group of a viewport cannot be deleted.
Important: If a deleted group contains nodes associated with elements or multipoint constraints not
in the group, these nodes are retained in the database even if you choose to delete the rest
of the group members.
Chapter 5: All About Groups 243
Group Concepts and Definitions
Group Transformations
Transformations are rigid body movements that treat a group as a single unit. These operations can translate,
rotate, mirror, scale, pivot, or reorient a large number of entities at the same time.
Implicit in a transformation process is the copy action. By default, in a transformation process the original
(target) group is copied and the resulting copy is transformed leaving the target group in its initial position.
As a result, a number of new entities are created while the originals are retained, unless you specifically request
that the original entities be deleted.
The operations of translation, rotation, and scaling allow you to iterate the transformation process by entering
a repeat count (n). In all of these actions, if the repeat count is greater than one (1), the copies of the target
group are placed in the current group (new entities are always placed in the current group!). However, you
may choose the current group to be the same as the target group.
In these transformations you can either save the original group members or delete them, optionally reusing
the entity IDs of the deleted entities for the new members. This is done using the Move option as opposed
to the Copy option. Similarly, you may retain the newly transformed entities in the original target group or
designate them to be placed in a new or the current group.
Translation
Translation is a linear transformation along an XYZ translation vector. The formula for translation is:
P n = P n – 1 + T xyz
where:
P n = the location of a point ( P 0 ) in the current group after the nth iteration
P n – 1 = the location of the same point before the nth iteration
T xyz = the translation vector
244 Patran Reference Manual
Group Concepts and Definitions
Rotation
Rotation is an angular transformation around an axis. The formula for rotation is:
Pn = Pn – 1 + ( θo + θr )
where:
P n = the location of a point ( P 0 ) in the current group after the nth iteration
Pn – 1 = the location of the same point before the nth iteration
θ o = an optional offset angle. The offset is valid only for the first rotation, for the second iteration
and beyond, θ o = 0 .
θ r = the rotation angle.
P2
P1
Repeat Count = 2
θr
θr
Axis
θo
P0
Radius
The plane of rotation is established by the Axis and the Radius. The axis is a vector that is normal to, and
intersects, the plane of rotation. The radius of rotation, a straight line in the plane of rotation, extends from
the location of point P0 to the point where the axis intersects the plane. See Rotating Points, Curves, Surfaces,
Solids, Planes and Vectors (p. 842) in the Geometry Modeling - Reference Manual Part 2 for further information
on entity rotation.
Scaling
This transformation proportionately scales the target group relative to a scaling origin ( S 0 ). The formula for
scaling is:
P n = P n – 1 ⋅ S xyz
where:
P n = the location of a point ( P 0 ) in the current group, relative to the scaling origin,
after the nth iteration.
P n – 1 = the location of the same point before the nth iteration.
S xyz = the scaling factors in the X, Y, and Z directions.
Chapter 5: All About Groups 245
Group Concepts and Definitions
Mirroring
Mirror transformation is a 180-degree rigid-body rotation of a group around a mirror plane. The formula for
mirroring is:
Pm = –Pb
where:
P m = the distance, before transformation, of any point ( P 0 ) from the final mirror
plane, measured along an axis, normal to the final mirror plane.
P b = the distance, after transformation, of the same point from the final mirror plane,
measured along an axis, normal to the final mirror plane.
Referring to the diagram below, the selected Mirror Plane is any arbitrary plane in model space.
Final Mirror Plane is a plane offset from the selected mirror plane by a specified distance along an axis, normal
to the selected mirror plane.
The Radius of Rotation is a straight line of length P b that is normal to the final mirror plane, and extends
from the selected point ( P 0 ) to the point of intersection with the final mirror plane.
In the example illustrated below, the selected mirror plane is the Y-Z plane of the global cartesian coordinate
system. Thus, the offset, radius, and distances P b and P m are measured along the X-axis, which is normal
to the Y-Z plane.
P’ P
Pm Radius = Pb
X
Offset
246 Patran Reference Manual
Group Concepts and Definitions
X
X
Z
(1) (2)
Coordinate Frame 0 Coordinate Frame 2
Pivoting
This transformation performs the rigid-body rotation of a group through a plane defined by a pivot point
( P p ), a starting point ( P s ), and an ending point ( P e ).
The angle of rotation, θ , is the angle between the P p P s and P p P e vectors. The center of rotation is the
pivot point, P p .
In the diagram below, any point P a in a group is rotated around point P p through angle θ to produce the
corresponding point, P b in the pivoted group.
Ps
Pa
Radius
θ Pe
θ
Pb
Pp
Chapter 5: All About Groups 247
Group Concepts and Definitions
Repositioning
Modifying the position of a group involves simultaneous rigid-body translation and rotation. The
transformation is defined by mapping a set of three points in an original position to a set of three points in a
destination position. The transformation cannot be performed if either set of points lies in a straight line.
Each three-point set defines a temporary coordinate frame. The positional and angular differences between
the two frames establish a translation vector and planar rotation angles, respectively. These are then applied
to all geometry. Repositioning is performed as follows:
P1o
P2d Vt
P1d
P3d P2o
P3o
(1)
P2d
P1d P3d
P1o P2o
P2d P3o P2o
P3d P2d P3o
P1d P1d
P2o P1o P1o
P3o P3d
1. Translation: The translation vector, V τ is defined between the original position of Point 1 ( P 1o ) and
the destination position of Point 1 ( P 1d ).
2. Rotation:
Two vectors are drawn; one between the original position points P 1o and P 2o ( P 1o P 2o ) and
Two additional vectors, P 1d P 2d and P 1d P 3d , are drawn between the three destination
position points ( P 1d to P 2d ) and ( P 1d to P 3d ).
The two angles, one between P 1o P 2o and P 1d P 2d and the second between P 1o P 3o and
Transforming Properties
Along with the entities of a group, you may also transform properties assigned to the original group members
if that option is turned ON:
Transform ON applies the same transformation to properties as the transformation applied to the
group and assigns them to the newly transformed entities. It is highly advised to check transformed
properties to ensure the result is what is desired.
Transform OFF does not transform the properties but does assign the transformed entities to the
same property sets as the original entities.
Set Names
For each existing LBC set or Property Set referenced by entities in the current group, and for each repeat
count, a new LBC set or Property Set may be created with transformed entities. The names of the new
property sets are derived from the original set name; an extension is appended to the original name in the
form of “.N”, where “N” is an integer. The value of N is determined by searching all existing property sets for
the highest “.N” extension, and then incrementing it by 1.
Menu Conventions
A menu item with ellipses (...) attached to it calls up a dialog box in which you enter further data.
The Group pulldown menu keywords lead to dialog boxes that initiate all group-related actions. Menu
functionality is described below in the order in which they appear.
Parameter Description
Create... Creates a new group and automatically posts it for display. See
Group>Create, 251.
Post... Posts (or unposts) existing groups to the current viewport. See Group>Post,
254.
Modify... Provides several functions to change a selected group’s definition,
including renaming the group, making it current, and adding to or
removing entities from it. See Group>Modify, 255.
Move/Copy... Moves or copies members of one group to another. See Group>Move/Copy,
257.
Set Current... Selects a group to be current for the current viewport. See Group>Set
Current, 259.
Transform... Transforms members of a group to a different configuration. Load,
boundary conditions and element properties associated with the original
entities may also be transformed. See Group>Transform, 260.
Delete... Deletes a group, except the current group, and optionally deletes its
associated members from the database. See Group>Delete, 282.
250 Patran Reference Manual
The Group Menu
Attributes... Assigns display attribute sets to one or more groups. See Group>Attributes,
283.
Expand Expands the entities in an existing group or groups from the existing list
by determining the entities associations to adjacent entities. See
Group>Expand, 284.
SuperGroups... Gives access to the SuperGroups utility, which simply allows you to
create a group of groups. This functionality is accessible from this pull
down menu only for the MSC.Nastran Structural, Thermal, Implicit,
and Explicit Nonlinear preferences. It is accessible otherwise from the
Utilities pull down menu and has limited applications for
posting/unposting groups of groups to the active viewport for all
preferences, and for submitting jobs to MSC.Nastran by selecting a
group of groups defined as a SuperGroup. For more information on
SuperGroups, click on the Description button after accessing the utility.
Extras/Hierarchy... Allow you to create hierarchical groups and maintain hierarchical (tree-
like) dependencies between groups. See Hierarchical Groups (Hgroups), 286.
Group>Create 251
Creating a New Group
The Group>Create command sequence displays the dialog box below. Assign a unique group name,
observing group naming conventions, then select entities designated for membership in the group.
Additional options include making the new group current, as well as unposting all other groups currently
posted. There are several methods available to select entities for the group.
The following methods are available to create a group and add entities to that group:
Method Description
Select Entity Allows you to graphically select entities from the graphics screen for
inclusion in the group.
Property Set Allows you to select existing property sets from a list or from the graphics
screen. Entities associated to the selected sets are added to the group. You
have the option of putting those entities in a single group or in separate
(multiple) groups, one for each property set selected. With the latter
option the group name takes on the property set name and you may
specify a prefix or suffix (or neither).
Property Type Allows you to select entities for the group based on existing property type
from a list, such as a beam, shell, or solid property type. Like the previous
option, you can place all entities in a single group or your naming or
multiple groups, which take on the property type name with or without
prefix/suffix.
Loads/BCs Set Identical functionality as Property Set except allows you to select
Load/BC sets. The LBC sets cannot be graphically selected however.
252 Group>Create
Creating a New Group
Loads/BCs Type Identical functionality as Property Type except allows you to select
Load/BC types.
Material Identical functionality as Property Set except allows you to select
Materials.
Element Topology Identical functionality as Property Set except allows you to select existing
element topologies from a list, such as quad4 or bar2 elements. The
element topologies cannot be graphically selected however.
Element Shape Identical functionality as Element Topology except allows you to select
element shapes from a list, such as 2D, 3D, Bar, Hex, etc.
Element ID Allows you to add elements to the new group by specifying a range of
element IDs with or without an increment counter.
MPC Type Identical functionality as others above except allows you to select MPC
types from a list.
Boolean Allows you to select existing groups and perform a boolean operation
such as intersect, union, or exclusion of the entities from the selected
groups when creating the new group and its entities.
Expand Creates a group or groups by expanding the selected entities based on
association to adjacent entities. See Group>Expand, 284 for more details.
The following general parameters on the group creation form are explained here:
Parameter Description
Existing Group Names Displays the names of previously defined groups for your information.
Selecting a group from this list places it in the New Group Name data
box.
Filter Using a filter helps you reduce the number of items displayed in a
potentially long list. Consequently, it takes less time to search for an item
(see Forms, Widgets, and Buttons, 22). By default, all items contained in a list
are displayed since the default filter is the wild card (*). To specify a filter,
either enter the full name of the desired item or type one or more letters
in the name followed by a wildcard. After you pressed the Filter button
to activate it, only the item(s) that pass the filter criteria are included in
the list.
New Group Name Enter a unique new group name; (see Group Names, 240 for more help). If
the group already exists, you will be asked for overwrite permission to
modify its existing entities.
Group>Create 253
Creating a New Group
Make Current When a single group is being created the default is to make it the current
Post Groups group in the current viewport, thus the Make Current toggle is ON by
Unpost All Other Groups default. With methods that allow multiple group creations, you can
specify to post them or not (OFF by default). When posting the group(s)
any other posted groups are unposted if the latter toggle is ON (OFF by
default).
Group Contents Provides several options for selecting entities to become group members
for the default Method. The default selection method is to select entities
from the graphics screen or type the entity IDs directly into the data box
to include in the new group. Additional options include adding all
geometric entities, all FEM entities, all orphan entities, or even adding all
entities. No graphical selection is necessary if these other options are used.
Entity Selection Displays the ID’s of the entities as you graphically select them for
inclusion. To select several entities, hold down the Shift key while picking
the next item or use other picking techniques.
Automatically Color Groups When multiple group creation methods are used, the toggle is used to
automatically color code the groups for easy visualization.
254 Group>Post
Posting and Unposting Groups
The Group>Post dialog box allows you to post or unpost one or more selected groups. Posted groups are the
groups that are visible in a viewport. A current group is automatically posted, but one or more additional
groups may also be posted to the same viewport. A group may be posted (visible) in more than one viewport.
The current viewport is listed just under the Action menu. Simply select the groups of interest, or use one of
the buttons to select all, none or the current group and press Apply to post the groups.
Group>Modify 255
Modifying Groups
With the Group>Modify command and dialog box you can modify the following group definitions:
Select the target group on which to invoke the Modify action
Make the target group the current group
Rename the target group
Add entities to the target group
Remove entities from the target group
256 Group>Modify
Modifying Groups
Parameter Description
Target Group to Modify Identifies the group targeted for modification. Although the default
target group is the current group, you may designate any another group
as the target group.
Change Target Group Displays a dialog box in which you can select a different target group.
Make Current Makes the target group the current group.
Rename Enables you to enter a new name for the target group in a subordinate
dialog box.
Selectable Members When this toggle is OFF, the entities that belong to the group cannot be
picked even though the group is displayed (default is ON).
Member List Lists the member entities of the group by name and ID.
Member List to Add/Remove Displays IDs of the entities as you select them for adding to or removing
from the group.
To add entities, select from the screen or type in entity IDs. To remove
entities, you can pick them from the Member List text box.
To select several entities, hold the Shift key and click the next item.
Add Press this button to complete the process of adding the selected entities
to the target group.
Remove Press this button to complete the process of removing the listed members
from target group. The membership of these entities in other groups will
not be affected.
The Group>Move/Copy command and dialog box allow you to move or copy entities between groups by
picking the source group (From Group) to which the entities belong and the destination group (To Group)
to where the entities are to be moved or copied. By default all entities are moved or copied unless the Select
Entities... button is pressed and only certain entities are selected.
258 Group>Move/Copy
Moving and Copying Group Members
Select Entities
Parameter Description
Geom. On Press Geom. On to select all geometric entity types.
Geom. Off Press Geom. Off to cancel the “all” selection. Note that an entity type is
selectable only if its toggle box is ON.
FEM On Press FEM On to select all FEM entity types.
To pick entities:
With the Group>Set Current command you can set any group as the current group in the current viewport.
260 Group>Transform
Transforming Groups
The Group>Transform dialog box directs you to various actions that allow you to translate, rotate, scale,
mirror, change, pivot, and reposition the entities within a group or groups.
Although some of the commands are specific to the selected transformation method you select, certain dialog
box entries are common to all or most transformations.
Select Group(s)... Displays a dialog box allowing you to select the groups to transform. A
filter mechanism allows you to filter only those groups that fit the given
spelling criterion as any other filter mechanism described previously. By
default the current group is selected automatically.
Selected Group(s) This data box displays the name(s) of the selected group(s) on which the
transformation takes place. This cannot be edited manually. You must use
the Select Group(s)... button to actually select the group(s) to transform.
The displayed group(s) in the data box are the target group(s) for the
transformation operation. When more than one group is selected, ellipses
are displayed after the first group name to indicate this!
Move / Copy / n Times This switch specifies whether the entities in the groups to transform are
to be copied (that is, new entities to be created) or whether the entities
are simply to be moved to the new position. The move operation retains
the original IDs of the transformed entities. If the operation allows it, the
n Times data box allows you to specify how many times you wish the
operation to be performed incrementally. For example, if you translate a
group by five (5) length units or rotate a group by five (5) degrees and
specify 3 Times, you get a new group at 5, 10, and 15 length units or 5,
10, and 15 degrees from the original location. Copy is the default
mechanism. The n Times functionality is only applicable to the Translate,
Rotate, and Scale operations.
Transformed Group Name(s) By default, the new entities of a group transformation are placed in the
same group(s) in which the originals reside. Other options are:
Current - place all transformed entities into the current group of the
current viewport
Group>Transform 261
Transforming Groups
Transform Loads/BCs Loads and boundary conditions associated with transformed entities are
transformed or copied as necessary. Alternately, you may choose not to
assign any loads and boundary conditions to transformed entities by
turning this toggle OFF.
Transform Properties Properties associated with transformed entities are transformed or copied
as necessary. Alternately, you may choose not to assign any properties to
transformed entities by turning this toggle OFF, in which case the
transformed entities inherit the same property set as the originals. Note
that FEM entities associated with geometric entities where the properties
have been assigned to the geometry must have the geometry transformed
also in order to maintain an association to a property set.
The Group>Transform>Translate command sequence moves or copies a group linearly along an XYZ
translation vector. The example used here show the original group translated 1.5 units along the X axis of the
global coordinate system and two (2) copies are requested. A force (red) associated to the translated entities
is shown translated also. The new forces are associated to new coordinate frames two (2) and three (3). The
magenta arrows show the material orientation, which is an element property. The orientation is in the X-
direction of coordinate one (1). The new entities inherit the property set of the original entities in this case.
Group>Transform>Translate 263
Group Translation
Parameter Description
Reverse Direction See Direction Vector below.
Auto Update Magnitude See Vector Magnitude below.
Reference Coordinate Frame Specifies the coordinate frame referenced by the translation process.
When you click in this field, the Coordinate Frame select icons appear
(see Select Menu, 31). Enter the ID of a previously defined coordinate frame
(the ID of the global coordinate frame is Coord 0) or select a coordinate
frame type from the Select Menu then pick a frame of the selected type in
a viewport. The selected reference frame must be Cartesian; curvilinear
frames are not accepted.
Direction Vector When you click in this field, the Vector select icons appear (see Select
Menu, 31). You may type in the X, Y, Z, components of a vector or select
a vector type from the selection menu then pick a vector of the selected
type in a viewport. Vector direction is reversed if Reverse Direction is
selected.
Vector Magnitude Vector magnitude is calculated automatically if Auto Update Magnitude
is selected (the default). If Vector Magnitude is 0 or blank, magnitude is
calculated from Direction Vector.
Copy n Time(s) Specifies the number of incrementally translated copies you wish to create
(default=1).
264 Group>Transform>Rotate
Group Rotation
The Group>Transform>Rotate command performs angular transformations around an axis. The example
here shows the original group rotated 30 degrees about the global Z axis and two (2) copies are requested. A
force (red) associated to the translated entities is shown rotated also. The new forces are associated to new
coordinate frames. The magenta arrows show the material orientation, which is an element property. The
orientation is in the X-direction of the coordinate one (1). The transformation rotates the property also in
this case.
Group>Transform>Rotate 265
Group Rotation
Parameter Description
Reference Coordinate Frame Specifies the coordinate frame referenced by the rotation process. When
you click in this field, the Coordinate Frame select icons appears in the
Toolbar (see Select Menu, 31). Enter the ID of a previously defined
coordinate frame (the ID of the global coordinate frame is Coord 0) or
select a coordinate frame type from the Select Menu then pick a frame of
the selected type in a viewport. The selected reference frame must be
Cartesian; curvilinear frames are not accepted.
Axis When you click in this field, the Axis select icons appear in the Toolbar
(see Select Menu, 31). Select the axis type (e.g., 2Point Axis), then specify
an axis of the selected type (e.g., select two points). This is the axis about
which the rotation operation is performed
Rotation Parameters
Specifies the angle of rotation ( θ r ) in degrees. Default = 90o in a
Rotation Angle counterclockwise direction based on the right hand rule about the Axis
of rotation. A minus sign indicates clockwise rotation.
Specifies an angle of offset ( θ o ), if any, in degrees, in a counterclockwise
Offset Angle direction based on the right hand rule about the Axis of rotation.
Default= 0o. A minus sign indicates a clockwise offset angle.
Copy n Time(s) Specifies the number of incrementally rotated copies you wish to create
(default=1).
266 Group>Transform>Scale
Group Scaling
The Group>Transform>Scale command sequence proportionately scales the target group relative to a scaling
origin ( S o ). The example here shows the original group (cyan) scaled up by 55% (green). A force (red)
associated to the translated entities is shown also. LBCs do not get scaled but simply remain associated to the
relative entities that are scaled. The new forces are associated to new coordinate frames. The magenta arrows
show the material orientation, which is an element property. The orientation is in the X-direction of the
coordinate one (1). The transformation creates a new property set in this case.
Group>Transform>Scale 267
Group Scaling
Parameter Description
Reference Coordinate Frame Specifies the coordinate frame referenced by the scaling process. When
you click in this field, the Coordinate Frame select icons appears in the
Toolbar (see Select Menu, 31). Enter the ID of a previously defined
coordinate frame (the ID of the global coordinate frame is
CoordinateFrame 0) or select a coordinate frame type from the Select
Menu then pick a frame of the selected type in a viewport.
Scale Origin Specifies the coordinate location of the scaling origin. When you click in
this field, the Point select icons appears in the Toolbar (see Select Menu,
31). Enter a point location (global Cartesian coordinates, Point ID,
Vertex ID, or Node ID) or select a point type from the Select Menu (e.g.,
Curve Intersect) then pick or construct a point of the selected type in a
viewport.
Coordinate Frame Scale Specifies the scaling factors applied to the group in the X, Y, and Z
Factors directions (if scale factor = 1, there is no change). A positive scale factor
expands the entities and a negative scale factor shrinks the entities.
268 Group>Transform>Mirror
Group Mirror
Parameter Description
Define Mirror Plane Normal Specifies the plane that serves as the mirroring plane. When you click in
this field, the Plane select icons appears in the Toolbar (see Select Menu,
31). Enter the endpoint coordinates of the axis normal to the mirror plane
or select a plane type from the Select Menu (e.g., 3Point Plane) then pick
a plane of the selected type in a viewport (e.g., select three points). A YZ
mirror plane effectively mirrors along the X-axis, a ZX mirror plane along
the Y-axis, and a XY mirror plane along the Z-axis. Thus you specify the
mirror plane normal as the axis you wish to mirror along or across.
Offset Specifies the offset of the final mirror plane from the one previously
defined. The offset is a specified distance (positive or negative) along an
axis, normal to the selected mirror plane. This effectively moves the
mirror plane to a new position. For example, if the global X axis is the
mirror plane normal (mirroring across the YZ plane), specifying 10 units
for an offset places the mirror plane at that location along the X axis
instead of at the origin of the coordinate system.
It is important to understand the mirroring operation and how it affects the geometry, finite elements, loads
and boundary conditions, material and element properties.
Connectivity Reversal
See Reversing a Curve, 592 and Reversing Surfaces (p. 672) in the Geometry Modeling - Reference Manual
Part 2. The mirror operation modifies the contained curves and surfaces by reversing the
corresponding parametric direction and normals. Beam and shell finite elements are also reversed by
modifying the connectivity to ensure the beam orientations and outward normal direction and
remain proper. Solid finite elements are reversed to avoid inside out elements (negative volume).
270 Group>Transform>Mirror
Special Mirror Considerations
Beam Connectivity: In the illustration below, the top portion shows the connectivity of a true
mirror of the beam nodes across a couple different mirror planes. However the mirror operation
reverses the beam node connectivity as show for the actual mirror. This is necessary to keep the beam
orientations proper as shown further below. This affects certain element properties, also explained
below.
Shell Connectivity: In the illustration below, the top portion shows the connectivity of a true mirror
of the shell nodes. However the mirror operation reverses the node connectivity as show for the
actual mirror. This is necessary to keep the pressure loading and other properties oriented properly as
shown further below. This affects certain element properties, also explained below. Similarly 3-
noded, 6-noded, and 8-noded shell elements are also reversed.
Group>Transform>Mirror 271
Special Mirror Considerations
Solid Connectivity: In the illustration below, the top portion shows the connectivity of a true mirror
of the solid element nodes. However the mirror operation reverses the node connectivity as show for
the actual mirror. This is necessary to keep avoid inside out element (negative volume). This reversal
affects some element properties as explained below. Similarly 4-noded, 6-noded, 10-noded, 15-
noded, and 20-noded solid elements are also reversed.
Pressures: Pressures are generally applied to element surfaces or edges. The positive direction of the
pressure is based on the elements outward normal. The outward normal is determined by the
element’s connectivity based on the engineering right hand rule. Thus the necessity to reverse the
element’s connectivity in order to maintain the correct outward normal and thus, the correctly
mirrored pressure loads. The example here shows both surface and edge pressures. Were the element
connectivity not reversed, the mirrored pressure loads would all be pointing the opposite direction.
Rotations/Moments: The same explanation for translational vectors is true for rotational vectors
(such as moments) except that the sign of each component must be reversed in order to achieve a
true mirror. Also the vectorial display of rotational LBC vectors is a double headed arrow. This
makes it difficult to actually visualize the rotational direction and may be misleading if you simply
rely on the pictorial display of the rotational vectors. The plot shown below might seem that the
mirror of the rotational vector is opposite what it should be (but it is not). A better representation of
the rotational direction would be an arrow with a curved arrow around it to show the axis of rotation
and the direction or rotation, however a double arrow head is all that is available. Coordinate system
one (1) below and its mirror coordinate system four (4) are expanded to show the mirrored
rotational directions that correlate to the double arrow head representation.
Material Orientation
The material orientation of directional material properties (orthotopic, anisotropic, composite
laminates) is mirrored based on how the material orientation is defined as follows (which may be
dependent on the Analysis preference). Whenever a material orientation is defined as part of the
element properties, a new property set is created with transformed material orientations.
• Real Scalar Value: Typically this is an angle (θ) defined relative the to the G1-G2 edge of a shell
type element. As the connectivity of the mirrored element is changed (reversed) relative to the
original element, the G1-G2 edge is changed and an updated THETA must be calculated. This
is done by determining the angle between the G1-G2 and G2-G3 edges and then subtracting the
original θ from this angle. This new θ is the angle relative to the G1-G2 edge of the mirrored
element.
As this type of material orientation definition could have a different θ defined for every element
and the mirrored θ is likely to be different for every element, a discrete scalar FEM field is created
to store these angles for every affected element. Thus the new element property set references the
newly created FEM field. If the FEM field already exists, new element values are simply added
274 Group>Transform>Mirror
Special Mirror Considerations
The illustration below shows a 3-noded element with G1-G2 edge and the material angle θ = 25°
defined relative to this edge. The mirrored element now has the G1-G2 edge designated as
G1m-G2m edge. The angle between the G1-G2 edge and the G2-G3 edge is 60°. Therefore the
new mirrored angle relative to G1m-G2medge is 60° - 25° = 35°.
If a scalar field (anything other than a discrete scalar FEM field) is used to define the material
orientation angle, then the field is evaluated at the locations of the original entities. The evaluated
angles are transformed based on the above explanation and a new discrete elemental based scalar
FEM field is created with the evaluated values associated to the newly mirrored entities and
associated to the new property set. If the material orientation is defined by a discrete FEM field,
then the same discrete FEM field continues to be used for the mirrored entities but with the newly
mirrored entities and their transformed angles added to the existing field.
• CID (Coordinate): A coordinate frame is used to define the material orientation where the X-axis
of the coordinate frame is the material direction. This is done by simply mirroring the coordinate
frame and then reversing the Y-axis to ensure a right-handed coordinate system. The new property
set then references this mirrored coordinate system for the material orientation. The illustration
below shows a couple of coordinate systems in the original group and the mirrored coordinate
systems on the mirrored entities. The important thing is that the X-direction of the coordinate
systems be the mirror of the original and that the new coordinate systems remain right-handed.
Group>Transform>Mirror 275
Special Mirror Considerations
• Vector: A physical vector is used to define the material direction. Any valid representation of this
vector in Patran is allowable as the vector itself is transformed to be relative to the global system
and then mirrored. As with the scalar definition, a discrete vector FEM fields is created to store
the vectors, which may be different for each element. The FEM field is then referenced by the new
property set as necessary. The image below shows the mirror of a vector <1,0,1> relative to the
global system.
If a vector field (anything other than a discrete vector FEM field) is used to define the material
orientation angle, then the field is evaluated at the locations of the original entities. The evaluated
vectors are mirrored and a new discrete elemental based vector FEM field is created with the
evaluated values associated to the newly mirrored entities and associated to the new property set.
If the material orientation is defined by a discrete vector FEM field, then the same discrete FEM
field continues to be used for the mirrored entities but with the newly mirrored entities and their
transformed vectors added to the existing field.
Composite Laminate Ply Orientation
Directional material properties and associated material orientations are often used with composite
laminates. When the mirror operation takes place the composite ply orientation angles are negated.
Ply angles are defined relative to the material orientation angle.
So take for example, the previous illustration of the 3-noded element. Now in the illustration below
one of the composite laminate plies is defined as 15°. The red arrow shows this relative to the
material orientation angle of 25°. The mirror of this element shows the new material orientation as
35° relative to the new G1m-G2m edge, but the ply angle is still relative to the material orientation so
its angle does not change except for its direction. So instead of 15° it is now -15° (or 360°-15°=345°).
So all composite laminate material properties are duplicated with the ply angles negated and
associated to the new property set for the mirrored entities.
276 Group>Transform>Mirror
Special Mirror Considerations
Beam Orientations
This illustration below shows a beam element mirrored across the YZ-plane (in X-direction) and
then the resulting two beams mirrored across the ZX-plane (in negative Y-direction). The beam
orientation (red), the pin-flags (magenta), and the beam offsets (blue brackets) are shown. The beam
is rendered such that you can see the L section clearly. The nodes of the mirrored elements are
reversed in order to keep the L-section orientation proper (a true mirror). The beam orientation
vectors visually do not indicate a proper mirror. But the rendering of the L-section does prove that
the mirror is proper. Were the connectivity not reversed, the L-section would be opposite what is
shown, thus not a true mirror.
YZ mirror plane
} {
{ P1
P6 P6
ZX mirror plane P1 }
{ P1
P6
P6
} P1 }
{
278 Group>Transform>Mirror
Special Mirror Considerations
Limitations
• Contact Bodies and Contact Pairs are not mirrored. It is advised that you create bodies and pairs
after the mirror operation.
• The Mirror/Move operation of LBCs that are applied only to geometry does not work. Please
ensure that a mesh exists before the Mirror/Move operation is done and that the application
region references the finite element and not the geometry. The Mirror/Copy operation does not
have this limitation.
Group>Transform>Mcoord 279
Group Orientation
The Group>Transform>Mcoord command simply moves or copies a group from its original coordinate
frame to a new coordinate frame. As a result of simultaneous rigid-body translation and rotation, the relative
position of the moved or copied group with respect to the new coordinate frame is the same as its relative
position with respect to the original coordinate frame. Thus the orientation of the group changes. The
example below copies the original group relative to Coord 1 to the equivalent relative position defined by
Coord 2. Coord 2 is positioned a unit up and over from Coord 1 and rotated by 45 degrees.
Transformed Group
relative to Coord2
Original Group relative to Coord 1
Parameter Description
From Coordinate Frame Specifies the coordinate frame in which the group is currently defined.
The default ID of the From Coordinate Frame is the active coordinate
frame. Coord 0 is the ID of the global coordinate frame.
To Coordinate Frame Specifies the coordinate frame in which a copy of the group is created or
moved. When you click in this or the other field, the Coordinate Frame
select icons appear in the Toolbar (see Select Menu, 31). Enter the ID of a
previously defined coordinate frame or select the icon of the coordinate
frame type then pick a frame of the selected type.
280 Group>Transform>Pivot
Group Pivoting
The Group>Transform>Pivot command performs rigid-body rotation of a group through a plane defined by
a pivot point ( P p ), a starting point ( P s ), and an ending point ( P e ). The example below defines the pivot
point at the origin, the starting point at -0.5 from the origin and the end point at coordinate point [1 1 0].
So P s is rotate about P p until it gets to a position defined by the line connecting P p and P e . All entities
in the group are moved in a rigid body fashion relative to P s to the new position based on the location of
P e around the pivot point P p .
Pe
Original Group Ps Pp
Pivoted Group
Parameter Description
Pivot Point Center of rotation. The Point select icon appears in the Toolbar (see Select
Menu, 31). Use any valid mechanism to select a point for this and the other
two select data boxes below.
Starting Point Current position of any point in the group ( P s ).
End Point Final position of the same point in the pivoted group ( P e ).
Group>Transform>Position 281
Group Repositioning
The Group>Transform>Position performs simultaneous rigid-body translation and rotation of a group. The
transformation is defined by mapping a set of three points in an original position to a set of three points in a
destination position. This is basically identical to creating coordinate frames with the three point method and
an alternate method to the Mcoord method except no coordinate frames need to be created or referenced. As
an example, the original group below is rigidly moved and rotated from point A [-.5, 0, 0] to point B [1, 1,
0]. The three points defined for point A and B would create Coord 1 and Coord 2, respectively. Thus the
Mcoord method could also be used by referencing Coord 1 and Coord 2 as the from and to coordinate frames.
Parameter Description
Original Position Specify the current position of three non-colinear points in the group.
Destination Position Specify the final desired position (non-colinear) of the same three points
in the final group.
When you click in one of these fields, the Point select icons appear in the Toolbar (see Select Menu, 31). Enter
a point location (global Cartesian coordinates, Point ID, Vertex ID, or Node ID) or select a point type from
the Select Menu then pick or construct a point of the selected type in a viewport.
282 Group>Delete
Deleting Groups
The Group>Delete command deletes one or more group definitions. The current group is displayed just
below the Action menu. You may designate to physically delete the entities associated with the groups if the
toggle at the bottom of the form is turned ON (OFF by default). Note that associations of nodes, elements,
and other entities with property sets or other database entities may prevent all entities of a group from actually
being deleted until or unless that association is broken. Deleting the current group from any viewport is not
allowed.
Group>Attributes 283
Assigning Attributes to Groups
With the Group>Attributes command you can assign named attributes to one or several groups (for more
information on named attributes, see Named Attributes, 365). The advantage of using this command is that it
allows you to assign display attributes to any number of groups.
284 Group>Expand
Expanding Entities in Groups
This functionality allows for a group to be created or an existing group to be expanded from a list of entities
based on associativity with adjacent entities. Existing groups can be expanded from their original list of
entities. Or a group or groups can be created from a starting list of entities through this expansion association.
3. Expand - this feature takes an existing group and expands the list of entities in the group based on
associativity until no more associativity is found. This feature is the same as Create/Expand/Single
where the list of entities comes from the Group itself and not a list of supplied entities.
The above features also do or can do the following:
Create/Expand - if the group already exists (and overwrite allowed), it is cleared of any entities before
the expansion process is done. If the group's original entities are to be retained, the Group/Expand
capability should be used instead.
Expansion can be done on FEM or Geometry:
Expansion done on FEM uses associativity of nodes/elements by defaults. MPCs and Connectors
can optionally be used to determine associativity. If Geometry is also specified when FEM is also
ON, then if the original list contains geometric entities, the associativity of elements to the geometry
is taken into account when expanding the FEM. Geometry is not expanded in this case - only FEM.
Expansion done on Geometry only will expand the geometric entities associated to other geometric
entities only. Expanding both FEM and Geometry does not work. If you wish to expand FEM and
Geometry in the same group you must perform two separate operations, first FEM and then
Geometry or vise-versa using the Group/Expand functionality.
Multiple Groups can be expanded in the same operation by selecting more that one group. But each
group is expanded separately.
Single group creation allows for the newly created/modified group to be set to the current group or
posted after creation.
Multiple group creation allows for the newly created/modified groups to be posted and/or color
coded.
All other previously posted groups can be unposted after the expansion process is done.
For the Group/Expand capability where existing groups are selected, a list of excluded entities may
also be selected. These excluded entities do not take part in the association and are not allowed to
become part of the group’s expanded entities even if they are actually associated to any of the
expanded entities.
The Number of Layers is used to limit the expansion. If set to some finite number the expansion
ends when this limit is hit. If set to zero (0) or left blank, entities are expanded without limit and the
expansion ends only after no more associations are found. However, there is a built in limit of 100
layers, which if hit, will ask the user if you wish to continue. Answering “Yes to All” turns this limit
check off for subsequent layers. Answering “Yes” allows expansion for another 100 layers before
asking to continue again. Answering “No” stops the expansion.
286 Group>Expand
Hierarchical Groups (Hgroups)
Unless a hierarchial group structure is created, the group structure is flat. All groups exist at the same level:
Group>Expand 287
Hierarchical Groups (Hgroups)
Complex and large FEM data models are diffcult to handle in a flat structure.
Note: By using the right mouse button (RMB) on a selected tree widget entity, a contextual menu
appears giving access to easily change Actions.
Organizing the data hierarchically establishes associations between groups that support performing
operations on more than one group at a time.
H-Group A
Group_1
H-Group B Subgroup
Group_2
H-Group C Subgroup
Group_3
H-Group D
Group_4
H-Group E Subgroup
Group_5
Establishing hierarchical groups, subgroups and element parent/child relationships provide a general tool for
subdividing large models. It allows the same operations to be performed on collections of groups, and groups
and their subgroups.
Note: Each hierarchical group can contain only one Patran group.
288 Group>Expand
Hierarchical Groups (Hgroups)
Hierarchy groups contain pointers to real groups. By selecting parent groups for operations, the operations
can be performed on the elements in the group and subgroups, as well.
You can perform the following actions:
Create Hgroups. See Creating an Hgroup, 289.
Post Hgroups. See Posting an Hgroup, 296.
Modify Hgroups. See Modifying Group Hierarchies, 297.
Delete Hgroups. See Deleting Hgroups, 299.
Set Current an Hgroup as the current group. The current group is posted to the current viewport.
See Changing the Current Hgroup, 300.
Export or Import an entire group hierarchy. See Exporting and Importing Hgroup Trees, 301.
At any time, you can view the existing Hgroups and group hierarchy.
Group>Expand 289
Hierarchical Groups (Hgroups)
Creating an Hgroup
Select the action “Create” on the Group Hierarchy form to display the Create Group form.
You use this form to create an association between a standard group and an Hgroup that will contain the
standard group. Assigning the Selection Group name identifies the standard group that is to be associated
290 Group>Expand
Hierarchical Groups (Hgroups)
with the Hgroup. You can either select a group from the list of groups displayed on the form or you can enter
the name of a standard group. The name you specify can identify an existing standard group or it can be the
name of a standard group that has yet to be created.
Note: You can associate the same standard group with more than one Hgroup, but each Hgroup can
be associated with only one standard group.
As an example, assume the following very simple example where you want to create two Hgroups called fem
and geom. The fem Hgroup will be associated to a group containing all the finite elements of the model and
the geom Hgroup will be associated to a group containing all the geometry. In addition to that, the fem and
geom Hgroups will contain multiple sub Hgroups associated with groups containing only portions of the
fem or geom Hgroup entities, respectively.
select
Step 1
select
enter
press
Repeat the process for the Hgroup called geom associated to the group called all_geom.
With the Group Hierarchy form displayed and the Action set to Create, and the Group icon
selected, identify or enter the group and Hgroup names. (Do not click Apply at this point.) Type in
all_geom for the group name and geom for the Hgroup name.
Optionally, click the Group Member icon and add or define the element members of the all_geom
group. (Group members can be added at a later time if desired.) Press the All Geometry, -Add-
button (not shown below). (Do not click Apply at this point either.)
Use the Parent icon to display and select the newly created group. Select the top level as the parent:
Group Hierarchy. Then click Apply. The Hgroup geom is created associated to the group called
all_geom, which contains all geometric entities of the model.
292 Group>Expand
Hierarchical Groups (Hgroups)
select
select
enter
press
Click Add.
Click Remove for the category of data to be excluded (e.g., All Geometry or All FEM).
Use the Parent icon form to add the subelement to the Hgroup. First, select the parent Hgroup. Then, click
Apply on the Parent icon form. Continuing with the previous example, we would like to add a sub Hgroup
under the geom Hgroup to furthur refine the hierarchy. The geometry of the model contains two surfaces.
We will create two sub Hgroups under the geom Hgroup, each associated with one of the surfaces of the
model. Similarly we will create two sub Hgroups under the fem Hgroup each associated with the elements of
the particular surface. Thus if you post the fem Hgroup and all its sub Hgroups, you will get all the fem
posted and ikewise, with the geom Hgroup for posted geometry. If you select the sub Hgroups for posting,
then only those entities assicoated with them are posted.
With the Group Hierarchy form displayed and the Action set to Create, and the Group icon
selected, identify or enter the group and (sub) Hgroup names. (Do not click Apply at this point.)
Type in surface_1 for the group name and surface.1 for the (sub) Hgroup name.
Optionally, click the Group Member icon and add or define the element members of the surface_1
group. (Group members can be added at a later time if desired.) Select Surface 1 from the graphics
screen and press the -Add- button under the Member List to Add/Remove . (Do not click Apply at
this point either.)
Use the Parent icon to display and select the newly created group. Select the geom level as the
parent. Then click Apply. The (sub) Hgroup surface.1 is created associated to the group called
surface_1, which contains just the entity Surface 1.
This operation can then be repeated for creating (sub) Hgroup surface.2, associated with group surface_2,
which contains entity Surface 2 where the Parent Hgroup is geom. The operation can then be done two more
times, once each for creating (sub) Hgroup FEM_surface.1 and FEM_surface.2, associated with groups
fem_surface_1 and fem_surface_2 each containing the finite element entities associated to the two surfaces,
respectively, and each having the fem Hgroup as their parent Hgroup.
294 Group>Expand
Hierarchical Groups (Hgroups)
In this example, when both surfaces have been defined as subelements (sub Hgroups of the parent Hgroup),
the group hierarchy will look as follows:
Group>Expand 295
Hierarchical Groups (Hgroups)
296 Group>Expand
Hierarchical Groups (Hgroups)
Posting an Hgroup
The following form is used to display all or parts of the hierarchy tree in the Viewport:
Note: If Auto Post Subtree is checked on the form, all the selected groups and their subgroups and
elements get posted when Apply is clicked.
Group>Expand 297
Hierarchical Groups (Hgroups)
Modify icon
Always start a modify hierarchical group operation by clicking the Modify icon.
For example, if the operation is to change a group name:
Click the Modify icon and select the Hgroup.
Click the Group icon and select the group.
Enter the new name.
Click Apply.
If the hierarchy operation is to add members to a group:
298 Group>Expand
Hierarchical Groups (Hgroups)
Deleting Hgroups
The following form is used to remove the association between standard groups and Hgroups.
Use the check boxes at the bottom of the form to scale the delete operation. You can delete the entire tree by
selecting Group Hierarchy.
Note that deleted items can be restored by:
Selecting the Undo option.
Using the Import form to recreate an exported tree.
300 Group>Expand
Hierarchical Groups (Hgroups)
6 Viewports
Viewport Names
Viewports are given names to differentiate them from one another. In naming a viewport, you must conform
to the following set of rules:
Uniqueness--each name must be unique.
Number of characters--name may not contain more than 31 characters.
“Legal” characters--the following characters are acceptable in names:
Chapter 6: Viewports 305
Viewport Concepts and Definitions
a through z
A through Z
0 through 9
-, _ , and .
Case sensitivity--upper and lower case letters are recognized. For example, top_view and Top_view are
regarded as two distinct views.
Viewport Status
The status of a viewport may be:
current (or not current)
posted (or unposted)
target viewport
Current Viewport
The current viewport is the viewport in which view commands are applied, titles are posted, and
postprocessing is performed. Only one viewport may be current at one time and only the current viewport is
updated when a model is viewed from a new angle or with new results and titles.
Posted Viewport
Posted viewports are the only viewports displayed on the screen. If a viewport is unposted it is hidden from
view.
You can hide any posted viewport but do not unpost the viewport to which the current group is posted, or else
you will not be able to see the geometric and finite element entities as they are created.
Target Viewport
The target viewport is a viewport selected for modifications. Any viewport can become the target viewport,
including the current viewport.
Only one group can be the current group in a viewport, however in each viewport you can designate a
different group as the current group.
Origin Symbol--crosshairs that identify the global cartesian origin (0,0,0) location. While this
symbol is ON by default, it can be turned OFF (see Show Origin Symbol, 313).
Global Cartesian Coordinate Axes--the icon that represents the global Cartesian coordinate axes is
displayed in the viewport’s lower left corner. As the viewing plane is rotated, the orientation of these
axes will change to reflect the new position of the model. While this symbol is ON by default, it can
be turned OFF (see Show Global Axes, 313).
Local Coordinate Axes--the icon that represents the axes of a locally defined rectangular, cylindrical,
or spherical coordinate system (for more information on local coordinate systems, see Coordinate
Frames, 365 )
Tiling Viewports
Posted viewports can be tiled within the available screen area. Tiling scales viewports so that they are of the
same size and repositions them in rows and columns to fit the viewing area.
Chapter 6: Viewports 307
The Viewport Menu
Menu Conventions
A menu item with ellipses (...) attached to it will call up an additional menu form in which you enter further
data.
The Viewport menu functionalities are described below in the order in which they appear.
Parameter Description
Create... Creates a new viewport and makes it the current viewport.
Post... Posts or unposts viewports for display.
Modify... Provides several functions that change viewport definitions, such as
viewport name, size, or location, current viewport selection, and
visualization control.
Delete... Deletes selected viewports (except the current viewport).
Tile Resizes and repositions posted viewports to fit within the available screen
area.
Viewport Commands
The following is a detailed description of the commands and dialog boxes with which you create and manage
viewports.
308 Viewport>Create
Creating a New Viewport
With the Viewport>Create command sequence you can create and name new viewports.
Parameter Description
Existing Viewports Displays the names of previously defined viewports for your information.
The name of the current viewport is highlighted.
New Viewport Name Enter a unique new viewport name; (see Viewport Names, 304 for more
help).
Note that a newly created viewport automatically becomes the current viewport.
Viewport>Post 309
Posting and Unposting Viewports
The Viewport>Post dialog box allows you to post or unpost one or more selected viewports. Posted viewports
are the only viewports visible on the screen. The current viewport is automatically posted.
Parameter Description
Post/Unpost Viewports Displays the names of all viewports in the database. The name of the
current view is highlighted since it is automatically posted.
To post a viewport, click on its name to highlight it. When you select a
viewport for posting, all other viewports become unposted and their
names become unhighlighted.
To select several viewports listed consecutively, hold the Shift key while
clicking each item. To select several viewports not listed consecutively, hold
the Ctrl key while clicking.
310 Viewport>Post
Posting and Unposting Viewports
Caution: If you unpost the current viewport, it will not be shown on the screen. Neither will the
current group, which is posted to the current viewport (see Posted Group, 241). Consequently,
you will not be able to see new geometric and finite element entities as they are created.
If you select a viewport other than the current viewport for posting, the current viewport will be unposted.
Patran will display the following warning message:
Viewport>Modify 311
Modifying Viewports
With the Viewport>Modify command and dialog box you can modify the following viewport definitions:
Indetify the viewport targeted for modifications (the target viewport).
Make the new target viewport current.
Post/unpost groups to the target viewport.
Set the current group.
Apply a named view to the target viewport.
Rename the target viewport.
Modify the attributes of the target viewport.
312 Viewport>Modify
Modifying Viewports
Parameter Description
Current Viewport Displays the name of the viewport you specified as current.
Target Viewport to Modify Displays the name of the viewport you selected for modification.
Change Target Viewport... Displays the Change Target Viewport dialog box in which you can select
a different viewport for modification.
Make Current Makes the newly specified target viewport the current viewport.
Post/Unpost Groups... Displays a dialog box in which you can select one or more groups to post
or unpost (display or hide) in the target viewport.
Viewport>Modify 313
Modifying Viewports
Set Current Group... Displays a dialog box in which you can select a group that will be the
current group in the target viewport.
Apply Named View... Brings up the Apply Named View dialog box in which you can select a
previously defined and named view that will be displayed in the target
viewport.
Rename... Displays a dialog box in which you can specify a new name for the target
viewport.
Attributes Allows you to control various display attributes assigned to the target
viewport.
Background Color Set the viewport background color.
Background Effects Displays a subordinate form to allow a number of different background
color effects such as a gradient between two different colors. This form is
explained below in Changing the Background Effects, 320
Range Name Displays the name of the selected range (or the default range).
Change Range Ranges have an important role in displaying finite element analysis
results. The name of the default range table is standard_range. This
command brings up a dialog box in which you can select a previously
defined and named range table to assign to the target viewport.
Show Spectrum Bar If the toggle is ON (4), the spectrum color bar will be displayed. Default
is OFF.
Show Viewport Legend If the toggle is ON (4), the viewport legend will be displayed. Default is
OFF.
Show Global Axes If the toggle is ON (4), the global coordinate axes will be displayed in the
lower left corner of the target viewport. Default is ON.
Show Origin Symbol If the toggle is ON (4), the crosshairs that identify the global cartesian
origin (0,0,0) location will be displayed in the target viewport. Default is
ON.
314 Viewport>Modify
Modifying Viewports
X,Y Location Indicates the location of the upper left corner of a viewport. Note the
following:
Enter new numerical values to locate the upper left corner of the
target view
With the cursor in the top banner, drag the viewport anywhere
in the viewing area. Note that in the dialog box, the X, Y
Location input display will update only after you click
Viewport>Modify again.
X,Y Size Indicates the X and Y dimensions (in inches) of the target viewport.
Parameter Description
Filter Minimizes the number of items that appear in the list (optional). You
may enter a combination of one or more characters and wildcards (*)
then press the Filter button. Only the item(s) whose name passes the filter
criteria will be listed in the text field.
Parameter Description
Target Viewport Displays the name of the target viewport in which the change will take
place.
Viewport>Modify 317
Modifying Viewports
Filter Specification Minimizes the number of items that appear in the list (optional). You
may enter a combination of one or more characters and wildcards (*)
then press the Filter button. Only the item(s) whose name passes the
filter criteria will be listed in the text field.
Post/Unpost Group(s) Displays the names of existing groups. To post a group, click on its name
to highlight it. When you select a group for posting, all other groups
become unposted and their names become unhighlighted.
To select several groups listed consecutively, hold the Shift key while
clicking each item. To select several groups not listed consecutively, hold
the Ctrl key while clicking.
Parameter Description
Filter Specification Minimizes the number of items that appear in the list (optional). You
may enter a combination of one or more characters and wildcards (*)
then press the Filter button. Only the item(s) whose name passes the filter
criteria will be listed in the text field.
318 Viewport>Modify
Modifying Viewports
Existing Names Displays the names of previously defined groups. Pick the group you wish
to specify as the current group in this viewport.
Current Group The name of the newly selected current group will also appear in this text
field.
Note: As an alternative to this command, you can simply click inside the viewport window to specify
it as the current viewport.
Parameter Description
Target Viewport Shows the name of the target viewport in which the named view will be
displayed.
Viewport>Modify 319
Modifying Viewports
Filter Specification Minimizes the number of items that appear in the list that follows
(optional). You may enter a combination of one or more characters and
wildcards (*) then press the Filter button. Only the item(s) whose name
passes the filter criteria will be listed in the text field.
Named Views Displays the names of existing named views. To apply a named view, click
on its name to highlight it. The view of the model in the target viewport
will then change to the named view as requested.
Renaming a Viewport
If you pressed the Rename... button in the Viewport>Modify dialog box, you will see the subordinate dialog
box shown below.
Parameter Description
Filter Specification Minimizes the number of items that appear in the list (optional). You
may enter a combination of one or more characters and wildcards (*) then
press the Filter button. Only the item(s) whose name passes the filter
criteria will be listed in the text field.
Default is the wildcard (*), meaning that all items will be listed.
Existing Names Displays the names of existing viewports. If you specified a filter, only
those viewports that pass the filter criteria will be listed.
Rename As Enter the new name that you want to give to the target viewport.
320 Viewport>Modify
Modifying Viewports
Parameter Description
Color 1 / 2 Select the color of the background. If both colors are the same, a solid
backgroud of that color is displayed. If the two colors are different, then
a gradation/transition between the two colors is displayed based on the
Shading Syles.
Swap Colors Swaps the colors between Color 1 and Color 2.
Shading Styles The shading or gradation / transition between the colors can be a
horizontal, vertical, diagonal or other type of effect. It is best to
experiment with these using the Preview button.
Inside Out Creates a shading from the middle out instead of top to bottom (or right
to left as the case may be).
Preview To preview how the viewport looks before applying the effect
permanently with the Apply button.
Apply / Cancel Press Apply to keep the effect and then Cancel to close the form.
Parameter Description
Target Viewport Displays the name of the target viewport in which the change will take
place.
Filter Minimizes the number of items that appear in the list that follows
(optional). You may enter a combination of one or more characters and
wildcards (*) then press the Filter button. Only the item(s) whose name
passes the filter criteria will be listed in the text field.
Ranges Displays the names of previously defined Ranges. Pick the range you wish
to use for results displays in the target viewport. The newly selected name
will also appear in the Viewport>Modify dialog box.
Viewport>Delete 323
Deleting Viewports
With the Viewport>Delete command sequence you can delete any number of viewports--except the current
viewport.
Parameter Description
Current Viewport Displays the name of the current viewport.
Select a Viewport(s) Displays the names of all existing viewports, with the exception of the
current viewport.
To select several viewports listed consecutively, hold the Shift key while
clicking each item. To select several viewports not listed consecutively, hold
the Ctrl key while clicking.
324 Viewport>Tile
Tiling Viewports
With the Viewport>Tile command you can display a number of viewports in an ordered “tiled” arrangement.
Extents of viewports are changed so that each view is the same size and viewports are positioned in rows and
columns to fill the viewing area.
Chapter 7: Right Mouse Button
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
Introduction 326
Model Display Options 327
Right Mouse Button Customization 329
326 Patran Reference Manual
Introduction
Introduction
In Patran additional context-dependent functionality has been added to the right mouse button to reduce the
“mouse travel” required to manipulate the display or obtain simple model information.
Right Mouse Button (RMB) Display Control – right click on an open area of the viewport to
perform operations such as: clean up the display or refresh the graphics, “tile” the viewport and
menus in the Patran window, or do a “fit view” to see the entire model
Right Mouse Button Viewport Control – right click on an open area of the viewport to change the
change the model orientation, render style, reverse the background, or show the cycle picking labels
Right Mouse Button Model Information – right click on an entity to find information or attributes
of that entity.
• Picking filter controls entity selection
• Right click on a node or element to obtain information such as location, attributes, verification
options or associations
• Right click on a geometry entity to obtain information such as surface area, curve length or arc
dimension, and FEM association such as mesh seeds or associated nodes / elements
Note: The right mouse button menu is completely customizable so you can add your favorite
viewport or display function to the menu. The procedure for customization is provided later
in this section.
Chapter 7: Right Mouse Button 327
Model Display Options
Select a Node, Element or Geometric Entity, Right Click on it to See The Options
You can use the right mouse button in conjunction with the select filter to get information on FEM entities
without navigating the AOM menus. Clicking the right mouse button when over an entity will bring up the
RBM menu where you can choose from a long list of options.
328 Patran Reference Manual
Model Display Options
Some of the options available from the right mouse button apply to individual entities, such as the transform,
modify, show or sweep options.
Chapter 7: Right Mouse Button 329
Right Mouse Button Customization
<MENUITEM>
<NAME>AsmSetColor</NAME>
<CALLBACK>asm_set_color_cb</CALLBACK>
<CONDITION>asm_set_color_cond</CONDITION>
</MENUITEM>
Add the following in p3_user_menu_res.xml within the <RMBRESOURCEMAP> tags:
<MENUITEM>
<NAME>AsmSetColor</NAME>
<LABEL>Set Color</LABEL>
</MENUITEM>
Implement the callback function in any .pcl file (note the function signature):
FUNCTION asm_set_color_cb( sel_entities, entity_type )
STRING sel_entities[]
STRING entity_type[]
dump sel_entities
dump entity_type
END FUNCTION
Implement the condition function in any .pcl file(note the function signature):
FUNCTION asm_set_color_cond( sel_entities, entity_type )
STRING sel_entities[]
STRING entity_type[]
RETURN TRUE
Chapter 7: Right Mouse Button 331
Right Mouse Button Customization
A slightly more complex example can be performed by replacing the name NoEntityMenu in the
<NAME>NoEntityMenu</NAME> line of the p3_user_menu.xml file with ASM_MENU. If you do this
and carry through with the rest of the example, you will find that the “Set Color” option will only appear at
the bottom of the RMB menu after you have selected multiple types of geometry.
The above examples show how you can add functionality to the RMB. The XML files that control the default
RMB menu are in the Patran installation directory under the rmb_menu subdirectory. You can examine these
files to see how the submenu structures are set up if you wish to create your own. You can also modify these
files to change the default behavior of the RMB, or even change the functions called by the call backs.
New and more complex call back functions can also be created, however, these call back functions must all
have argument lists that follow the same format. Specifically they must use the format and arguments
identical to those of the example: two string variables as arguments. This means that there are no limits on
what the call back functions do as long as the argument list is matched.
332 Patran Reference Manual
Right Mouse Button Customization
Chapter 8: Viewing a Model
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
8 Viewing a Model
View Concepts and Definitions 334
The Viewing Menu 337
Viewing Commands 339
334 Patran Reference Manual
View Concepts and Definitions
Current View
Each viewport displays one independent view of a stationary model. The current view is the view most
recently defined for a viewport.
Named Views
If in a work session you rotated, zoomed, scaled, or clipped a view to show a particular aspect of your model,
you can preserve all your modifications with a named view that will be stored and ready to be recalled at a
later time or even in a different model (see Named Views in Viewports, 306). Additionally, Patran provides several
predefined standard engineering views (e.g., top_view) that you can utilize in any viewport.
When naming a new view, remember that just as in naming groups or viewports, view names must conform
to the following set of rules:
Model Space
Model space is defined in the global X, Y, and Z rectangular coordinate system.
Screen Space
Screen space is defined by a projection plane’s X and Y coordinate system.
Y Global Axes
Screen Axes
Global Origin
Y
Observer
Position Focal Point
Z
X
Z
X
Viewing Plane
Viewing Plane
The viewing plane lies in the plane of the screen and is the plane onto which the model is projected.
Window Center
The window center is at the center of the viewing plane.
Model Center
The model center is the geometric centroid of a viewport’s displayed geometric and finite element entities.
Automatic Centering
The model center is recalculated each time an entity is added or removed, or each time a group is posted or
unposted. However, the focal point may be moved to coincide with the model center.
Fitting a View
Fitting a view moves and resizes the view of the model so that all model entities will fit inside the current
viewport window. The view’s rotational orientation will remain the same.
336 Patran Reference Manual
View Concepts and Definitions
View Transformations
Transformations refer to the action of panning, rotating, and resizing a view in the current viewport.
Pan
Moves the window center left, right, up, or down in the current viewport as if a camera panned over
the model in the view.
Zoom
Makes the model appear larger (zoom in) or smaller (zoom out) in the viewport.
Rotate
Rotates the view around selected global or screen axes.
All transformations can be implemented one of three ways:
The Viewing>Transformations command (see Viewing>Transformations on page 296)--click the
applicable icon to pan, zoom, or rotate a view. Accept a default transformation factor or specify the
desired rate by which the transformation will be performed.
Other Viewing menu commands--use one of the following Viewing menu commands:
Panning--Select Center (p. 342)
Zooming--Select Corners, and Zoom% (p. 344)
Rotating--Angles (p. 346) and View From/To (p. 348)
“Mouse method”--program the middle mouse button to execute one of the transformations (see
Preferences>Mouse, 441).
Note: Several shortcuts to some of the view control functionalities are also available via tool bar icons
(see also Mouse Function Tool Palette, 15 and Viewing Tool Palette, 15).
View Clipping
To clip a view, you make use of one or more planes to “slice” into the model at selected locations. Since the
geometry outside the clipping planes will be eliminated from view, with view clipping you can show the inside
of a model as well as create special sectional views. Z-axis clipping provides front and back clipping planes that
are parallel to the XY plane. In arbitrary clipping, you can define, orient, and place your own clipping planes
for specific clipped views.
Perspective Views
Perspective viewing makes surfaces that are farther from the position of an observer appear smaller. Changing
the observer’s position as well as the viewing plane location will modify perspective distortion.
Chapter 8: Viewing a Model 337
The Viewing Menu
View Parameters
Focal Point
The view’s origin, it is also the center of rotation when the view is rotated, the center for scaling, and the
perspective’s center.
Window Center
The center of the viewing plane from where translation distances are measured.
Focal
Point
Viewing Plane
Z Observer’s
Position
Menu Conventions
A menu item with ellipses (...) attached to it will call up an additional dialog box in which you enter or select
further data.
If a menu item is followed by an expression containing the abbreviation Ctrl, this item can also be accessed
by an accelerated keyboard shortcut. For example, to activate the Viewing>Transformations command with
the shortcut, press the Ctrl (Control) key and the lower case letter key (t) simultaneously.
The Viewing menu functionalities are described below in the order in which they appear.
Parameter Description
Transformations... Displays graphic icons with which you can pan, rotate, and zoom a view
by selected incremental factors. Also provides a Fit View icon to adjust
the view of the model to be contained completely inside the boundaries
of the viewport.
Fit View Moves and resizes the current view so that all model entities will fit inside
the current viewport window. The view’s rotational orientation will
remain the same.
Select Center Pans a view by moving its center to a cursor picked location.
Select Corners Zooms in on a cursor-defined rectangular area of the view.
Viewing>Transformations 339
Viewing Commands
Zoom (% of view) Specifies a zoom factor, expressed as a percentage of the normal fit view
area, for viewing the model.
Angles... Rotates a view by specific angles about the X, Y, and Z axes of either the
global or screen coordinate system.
View From/To... Rotates a view by moving the view origin or by modifying the location
of an observation point.
Scale Factors... Changes the projected size of a model in the view by using specific scale
factors.
Named View Options... Applies an existing named view in a selected viewport. Creates new
named views, and renames or deletes existing named views.
Clipping/ Perspective... Controls the parameters for clipping and perspective viewing.
Arbitrary Clipping... Creates, modifies, and deletes user-defined clipping planes. Also enables
or disables (posts/unposts) selected clipping planes.
Viewing Commands
The following is a detailed description of the commands and dialog boxes that manage and manipulate views.
With the icons of the View>Transformations dialog box you can pan, rotate, zoom, or fit the view in the
current viewport. Transformations are incremental, each mouse click will modify the view orientation once
by a predefined amount that you specify in the Options... dialog box.
340 Viewing>Transformations
Transforming Views
Parameter Description
Visually translates (pans) the model in the view left, right, up, or down,
by a selected incremental “pan factor”.
Transformation Options
If you pressed the Options... button in the View>Transformations dialog box, you will see the subordinate
dialog box shown below.
Parameter Description
Rotation Displays the rotation angle in degrees. Each mouse click will rotate the
view of the model by that increment. Move the slidebar to the desired
angle value.
342 Viewing>Transformations
Transforming Views
Fit View
Fitting a view moves and resizes the view of the model so that all model entities will fit inside the current
viewport window. The view’s rotational orientation will remain the same (for automatic execution of Fit
View, see Automatic View Settings, 438).
Select Center
The Viewing>Select Center command is an alternative way of panning the model. Click an arbitrary point
in the viewport and the view will be repositioned with its window center at the selected point. Note that if
you picked a point in a viewport other than the current one, that viewport will automatically become the
current viewport.
Select Corners
Using the Viewing>Select Corner command, you can zoom to a cursor-defined rectangular area of the
current view of the model.
Move the cursor to a point at the edge of the area you wish to zoom (P1). This point becomes the first corner
of the rectangle. Click and hold down the left mouse button while dragging it to form the rectangle. When
the rectangle surrounds the desired area, release the mouse button at the opposite corner (P2). The view’s
center will reposition itself to the center of the rectangle, and the selected area will zoom to fill the viewport.
The viewport in which you select the corners will automatically become the current viewport.
Viewing>Transformations 343
Transforming Views
344 Viewing>Zoom (% of View)
Zoom by a Specified Factor
The Viewing>Zoom (% of View) command lets you specify the zoom rate numerically rather than using the
zoom icon and the slidebar.
Parameter Description
Zoom Factor The zoom factor is expressed as a percentage of the fit view size.
Custom... Enter a zoom factor in this subordinate dialog box if you want to use a zoom factor other
than those listed.
Viewing>Zoom (% of View) 345
Zoom by a Specified Factor
346 Viewing>Angles
Rotate by a Specified Angle
Use the Viewing>Angles command when you want to enter very specific rotation angles that are not easily
set with the rotation slidebar, or when you want to control the axes about which the view is rotated.
Rotation Terminology
Parameter Description
Model The view is rotated about the global model axes. These stay fixed to the
model and rotate with the model.
Screen The view is rotated about the screen axes. These are fixed to the screen and
never move.
Absolute The view is rotated relative to the zero (unrotated) position.
Relative The view is rotated relative to the current view position.
Rotation Angles The angle of rotation may be positive or negative around the respective
axis (follow the right hand rule).
Unit of Rotation The unit of rotation is degree, the allowable range is ±180o.
Center of View Rotation The center of rotation is the focal point (see Observation Point, 348); the
only point that remains fixed during a view rotation. If the center of
rotation does not coincide with the model center, the center of the model
will move, and a portion of the model (or the entire model) will move
outside the viewport during rotation.
Viewing>Angles 347
Rotate by a Specified Angle
list2+
Rotate the view as follows:
The position of two points, the view origin, or focal point, and the observer position (see Observation Point,
348) also influence the rotational orientation of a view.
In the Viewing> From/To dialog box, you can enter new coordinates for one or both of these points. If you
move either one--but not the other-- the view will be rotated. If the coordinates of both points are changed
by the same value, the view orientation remains unchanged.
Parameter Description
Observation Point The observation point, or observer position, represents the location of a
person viewing the model in a perspective view. To change the observer
position, enter new model space coordinates for the observation point.
Focal Point The focal point is the view’s origin as well as the center of rotation when
the view is rotated. To change the focal point location, enter new model
space coordinate values.
Model Center The model center is the geometric centroid of a viewport’s displayed
geometric and finite element entities. If you changed the Focal Point
coordinates in the dialog box, this button will return the focal point to
the model center. The observer position will also change accordingly, in
order to maintain the same view rotation.
Viewing>Scale Factors 349
Scaling a View
The Viewing>Scale Factors dialog box lets you enter specific scale factors to create a scaled view of the model.
Parameter Description
Screen Scale Factors The scale factors are applied in the X and Y directions of screen space.
The center of scaling is the focal point.
Model Scale Factors The scale factors are applied in the X, Y, and Z directions of model space.
The center of scaling is the focal point.
350 Viewing>Named Views
Creating and Manipulating Named Views
With the Viewing>Named View Options command, you can create special views that can be named and
stored for later use. When a named view is applied in a selected viewport, the view of the model will change
to the same orientation, size, and clipping state defined for the named view. In this dialog box you can also
rename and delete existing named views.
Parameter Description
Current Viewport Displays the name of the current viewport.
Select Named View Lists all named views that exist in the database. Click on the view you
want to display in the selected viewport.
Create View... Creates and saves a new named view. After you positioned, rotated, and
sized a view to achieve the effect you wanted, select this command then
specify a new, unique view name in the subordinate dialog box.
Viewing>Named Views 351
Creating and Manipulating Named Views
Parameter Description
Rename View... Renames a selected named view. Select the existing view to be renamed
and enter a new name in the subordinate dialog box.
Delete View... Deletes a selected named view. You may confirm or cancel your request
to delete a named view:
352 Viewing>Clipping/Perspective
Clippped Views
With the Clipping part of this command, you can control the location of the Z-clipping planes visually, as
well as numerically in the dialog box.
Parameter Description
Z Min/ Z Max These show the extents of the view of the model in the positive and
negative Z direction.
Front/Back Clipping Planes These text boxes show the current position of the front and back clipping
planes. Enter new values to change the position of either or both, then
press Apply.
You can also change the Z-clipping plane location by simply dragging
the plane symbols to the left or to the right. The changes will apply to
the model immediately, clipping it according to the new distances. The
numerical values in the databoxes will update as well.
Note that the front clipping plane distance must be greater than the back
clipping distance, otherwise, the back clipping plane would end up in
front of the front clipping plane. If you enter wrong values, a warning
message will appear.
Viewing>Clipping/Perspective 353
Perspective Views
In the Perspective portion of the dialog box, you can modify the parameters of a perspective view, namely the
location of the viewing plane and the observer position.
Parameter Description
View Plane Distance The distance between the viewing plane, which is normal to the Z-axis,
and the focal point measured along the Z-axis. If this distance is zero, the
viewing plane intersects the Z-axis at the focal point. A positive value
places the viewing plane to the right of the focal point while a negative
value moves it to the left of the focal point.
Observer Position The distance between the focal point and the location of an observation
point, measured along the Z-axis.
354 Viewing>Clipping/Perspective
Perspective Views
The Viewing>Arbitrary Clipping dialog box accepts and displays all necessary information to create and
manipulate arbitrary, or user-defined clipping planes.
356 Viewing>Arbitrary Clipping
Creating and Managing User-defined Clipping Planes
Parameter Description
Post/Unpost Clipping Planes Lists all previously defined arbitrary clipping planes; the currently posted
(active) clipping planes are highlighted.
The maximum number of clipping planes posted at any one time is six
(use the Ctrl key while picking multiple entries).
Incrementally translates the clipping plane along its normal. You set the
increment in model units in the Number of Units text box. Each mouse
click moves the plane once.
Viewing>Arbitrary Clipping 357
Creating and Managing User-defined Clipping Planes
Direction As an alternative to rotating the clipping plane with the rotation icon,
you can enter a new vector to change the direction of the clipping plane
normal. Note that if you do use the rotation icon, the components of the
normal vector will automatically update in this text box.
Location As an alternative to moving the clipping plane with the translation icon,
you can enter the model coordinate location of the clipping plane. Note
that if you do use the icon to move the plane, the location coordinates
will automatically update in this text box.
358 Viewing>Arbitrary Clipping
Creating and Managing User-defined Clipping Planes
Chapter 9: Display Control
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
9 Display Control
Display Modes
For controlling entity colors, labels, and render styles you must choose between two display modes:
Entity mode--targets entities according to entity type. For example, you may specify that solids
must be shaded and green-colored. This specification then will apply to all solids in the database.
Group mode--targets entities according to group membership. For example, if Fender and Wheel
comprise two groups in a model, solids in the group called Fender may be rendered in wireframe
while those in Wheel may be shaded.
Display modes are global in nature; whichever you select will apply to the display in all visible viewports.
Rendering Styles
While you are constructing a geometric or FEM model, it is not necessary to display solids and surfaces in
true-to-life “photographic” appearance. Such display would actually make it difficult to create certain
geometry, such as entities that define the interior of an object. In addition, it would take more time to
perform operations related to many display functions, such as view transformations.
Rendering is a tool that can change the display of solid or surface geometric and FEM entities for visualization
purposes. The basic rendering styles are wireframe and shaded, with additional options within each of these
styles.
Wireframe
In wireframe, the edges of solid and surface entities are displayed but faces appear transparent. To help perceive
surface contours, however, visualization lines can be drawn in all parametric directions. You can control the
number of lines depending on what it takes to improve visualization (see Number of Display Lines, 373).
Chapter 9: Display Control 361
Display Concepts and Definitions
Wireframe/Accurate
This rendering style, used primarily when in group display mode, affords better visualization of a group that
appears in the same viewport with smooth shaded entities of other groups. This technique takes into
consideration changes in depth, therefore it is especially appropriate for showing how certain objects are
positioned behind one another.
Hidden Line
Hidden line rendering also displays the edges of solids and surfaces but the faces appear opaque, not
transparent. As a result, portions of an object that would be hidden from an observer are also hidden in the
display. In some cases this will result in a more realistic image of an object, especially in straight-edged solids;
for curved edges, however, it helps if you use visualization lines in the display.
362 Patran Reference Manual
Display Concepts and Definitions
Hidden Line/Accurate
This rendering combines the characteristics of Hidden Line and Wireframe/Accurate styles. It renders hidden
edges and faces invisible and also depicts the correct spatial order of objects.
Shaded/Flat
A compromise between smooth shading and wireframe or hidden line representation is “flat shading”. Flat
shading applies a series of shaded triangles of constant color to faces. Visual accuracy increases as the number
of triangles increases and the size of triangles decreases. The number and size of triangles is governed by a
calculated value called chordal tolerance.
Chordal Tolerance
Database definitions of even the most complex solid or surface objects are mathematically accurate, but the
exact graphical representation of curvatures in solids is, to some extent, at the expense of display speed and
computer resources. Therefore, the screen display of objects is somewhat less precise than the mathematical
data.
With the approximation technique used for creating the display, curved edges are replaced with a series of
straight line segments, or chords. The distance between a curve segment and its subtended chord is the chordal
deviation.
chordal deviation
chord
Chapter 9: Display Control 363
Display Concepts and Definitions
Chordal tolerance is calculated as the ratio of the chordal deviation and the length of the curve segment. It is
a user-controllable input that is entered as a display parameter. Bear in mind that while very small chordal
tolerance values produce smoother, more realistic displays, they may also cause the slowing down of view-
related operations.
Shaded/Smooth
The most realistic display of models is the “smooth” shaded image. It renders surfaces and solids realistically,
in a smoothly shaded manner, as if a light were shining on the model. It only shows visible faces and edges,
and does not display those that are hidden from view.
QUAD8
Similarly, the default number of display lines on the edges of a QUAD12, a cubic quadrilateral element with
two midside nodes, is three.
It must be emphasized that the display of line segments is strictly a visual tool and has no effect on the
mathematical formulation of elements.
Shrinking Entities
Shrinking is another display tool that can help improve visualization. It reduces the screen size of each
geometric or finite element entity separately by a user-selectable shrink factor, defined in model percentage.
For example, when you shrink adjacent solid components that initially touch one another, they will become
separated (each is individually shrunk by the shrink factor). You can then examine these entities to be sure
that each is geometrically correct. Similarly, you can shrink a FEM mesh to display finite elements more
distinctly within the geometric model.
Shrink action is global, it affects all entities in all viewports. Both geometric and FEM shrink are saved in the
database; if you apply shrink to a model and save it upon exiting, you will find the model in the same saved
shrink state when you open it again.
Titles
Especially useful for proposals or presentations, titles and other textual information enhance the display of
the model. Text is inserted into a selected viewport and is related to the viewport only, not to the model nor
to the view. Therefore, it remains in position through any view modification (e.g., view panning). Each
viewport may be annotated with different text and titles, however the same text may also be posted to several
viewports.
Chapter 9: Display Control 365
Display Concepts and Definitions
Coordinate Frames
Local coordinate frames are user-defined coordinate systems, generally created to help build specific geometry
and to evaluate localized results (see also Geometry Modeling, Chapter 3, p. 59). Their symbols may be
displayed or hidden, as desired.
Named Attributes
You can create a named attributes set to save certain changes you made to the geometry or FEM display. The
attributes in the set will then be available any time you work with the model, sparing you from repeating the
display changes.
Spectrums
In Patran, spectrum is a named, ordered set of colors, used for displaying analysis results. For example, when
stress analysis results are superimposed on a model, it is customary to use the colors in the red family to
indicate “hot spots”, or high stress areas, then transition toward the “cool” blue colors where stresses are low.
Spectrums, together with specific range and subrange definitions, interpret the color-coding of result displays
and the underlying numerical values.
Spectrum definition is global; the same spectrum is automatically used in all viewports where analysis results
are displayed.
Ranges
A range is a named collection of ordered subranges that attach numerical meaning to the displayed colors
according to result values. A subrange is generated when the full extent of analysis results (between defined
minimum and maximum values) is divided, automatically or manually, into smaller intervals with specified
starting and ending boundaries. Each subrange is paired with a color in the spectrum. In a result plot, nodes
and elements are shown in the color assigned to the subrange to which their analysis results belong.
Thresholding cuts down the amount of data utilized for displayed analysis results. It may be used to eliminate
from the result plot those values that fall in the upper or lower extremes of the result range. An even more
important function of thresholding is the ability to delimit a narrow interval, with upper and lower
boundaries, in the vicinity of a particular result value that requires closer examination.
Ranges are not defined globally but linked to viewports. Using this feature, you can simultaneously display
results of multiple analyses (e.g., structural and thermal) with different range definitions in each viewport.
Color Palette
For all color displays, Patran uses a color table of 16 colors. A named, ordered collection of the 16 colors in
various combinations makes up a Color Palette.
Several pre-defined color palettes exist, the one initially used in a new database is named standard_colortable.
You can modify the currently existing colors to create and store any number of new color palettes in a
database.
366 Patran Reference Manual
The Display Menu
The first color in a color palette defines the viewport background color.
Color palettes are global in nature and will affect all viewports, therefore, only one color table can be active
at any one time.
Light Sources
The appearance of shaded surfaces is significantly affected by the nature of light that illuminates them. You
can experiment with some of the light-source control features to see which one will make the model look even
more realistic and visually pleasing.
Patran comes with several existing light source definitions, try them before you introduce new light sources.
If these do not produce the effect you are seeking, you can modify an existing light source or create any
number of new ones.
The characteristic features of light are color, intensity, direction, and the distance of the light source from the
object.
In Patran you can choose among the following types of light sources:
Ambient--a background light, typically used to provide low level lighting around the model.
Directional--directional light simulates the effects of sunlight. It is spread uniformly across a surface
and its intensity depends only on the direction of the light not on the distance between the object
and the light source.
Spot--spot light is typically controlled by the location of the light source as well as the direction of
the light. A characteristic feature of this light source is attenuation, the measure of influence of the
distance between the object and the light source on the intensity of light on the surface. At
attenuation = 0, distance has no significance, and spot light is effectively the same as directional
light.
Menu Conventions
A menu item with ellipses (...) attached to it will call up an additional menu form in which you enter further
data. For more information on using the Display menu forms see Entering and Retrieving Data, 21.
The Display menu functionalities are described below in the order in which they appear.
Entity Color/ Label/Render... Controls colors assigned to entities or groups, turns entity labels on or off,
and defines rendering styles of solid and surface entities.
Plot/Erase... Determines which entities of a model are visible. Erase hides selected
entities from view, Plot redisplays erased entities.
Erase and Plot are global actions that affect the display of all viewports the
same way.
Display>Entity Color/Label/Render 367
Display Commands
Display Commands
The following is a detailed description of the commands and dialog boxes that affect the appearance of model
entities in viewports.
In these dialog boxes you specify rendering styles for solid and surface entities, control the colors assigned to
entities or groups, and turn entity labels on or off.
368 Display>Entity Color/Label/Render
Enhancing the Appearance of Entities
Parameter Description
Entity Type Specifies that actions in this command will target entities by type. The
selected rendering style will apply to all surfaces; similarly, colors and
label On/Off designations will affect all entities within a specific entity
class (e.g., all curves).
Group Specifies that the actions of this command will target entities by group
designation. Displays a dialog box in which you define the rendering
style, color, and label On/Off choice as they apply to members of a
selected group.
Display>Entity Color/Label/Render 369
Enhancing the Appearance of Entities
Render Style Displays a pop-up menu in which you can select a rendering method.
Shade Color Sets the color of shaded solid and surface entities, if Shaded rendering was
selected. This color will not apply if the object is rendered in wireframe.
Entity Type Colors and Labels Only in Entity mode, it assigns colors to entities by type. Specifies
whether or not labels will be displayed on an entity class.
Click the color chip next to the entity type. This will bring up
the “Color Select” form with all available colors.
In this form, pick a new color for the entity type.
To specify that entities of a particular type should have their labels
displayed, click in the label toggle (4).
Show/Hide All Entity Labels In the Entity mode dialog box; turns labels on or off for all entities.
Show Labels In the Group mode dialog box; turns labels on or off for all group
members.
Label Font Size Controls the size of entity labels. Note that the font size change can take
effect only if you specify Software Rendering Mode in the Graphic
Preferences Menu ( see Preferences, 413.).
370 Display>Plot/Erase
Erasing and Redisplaying Entities
With the Display>Plot/Erase command you can temporarily “hide” (erase) selected entities or redisplay
erased entities (plot).
Both Erase and Plot are global actions; erased entities are removed from every view and plotted entities are
restored to all views. Since erased entities are only hidden from display and not deleted from the database,
the results of the erase action will not be saved when you exit from the database.
Display>Plot/Erase 371
Erasing and Redisplaying Entities
Parameter Description
Selected Entities Lists entities selected for erasure. You can type entity ID’s, select them
with the mouse (hold the Shift key for multiple selections), or use any
other select mechanism (see Selecting Entities, 29). The text in this textbox
is editable, you can delete any entity ID you did not intend to include in
the list.
Erase Erases the entities contained in the entity list.
Plot Redisplays erased entities contained in the entity list.
Coord. Frames Brings up the Coordinate Frames dialog box in which you can select the
local coordinate frame(s) you want to display or hide from view.
Posted Entities
Geometry Erase/Plot Erases or plots all geometric entities.
FEM Erase/Plot Erases or plots all FEM entities.
All Erase/Plot Erases or plots all entities.
372 Display>Highlight
Highlighting Selected Entities
Use the Display>Highlight command to call attention to specific entities or to locate certain entities by their
ID number. The default highlight color is red. If you want to change the default, you have to go to the
Preferences>Graphics command (see Preferences, 413).
Parameter Description
Selected Entities Lists the entities you selected for highlighting. Pick entities using any of
the select mechanisms (multiple pick with the Shift key, polygon pick,
etc. see also Selecting Entities, 29). Alternately, type the name and ID
number of entities. The text in this textbox is editable; you can correct,
add or delete any text.
Highlight Performs the highlight action. You need to click this button only if you
entered entity IDs. If you picked entities with the cursor, they will
highlight immediately.
Clear All Clears the highlights as well as the entries from the textbox, but leaves the
dialog box on the screen.
OK Removes the highlights and the dialog box from the screen (pressing the
Enter key will have the same effect).
Display>Geometry 373
Modifying the Appearance of Geometric Entities
The Display>Geometry command lets you change certain display attributes of geometric entities. The
modified display features are saved upon exiting the model and will be recalled when you open the database
again.
Parameter Description
Number of Display Lines Specifies the number of display lines used to help visualize solids or
surfaces in Wireframe or Hidden Line rendering (see Hidden Line, 361). By
default, the number of display lines = 0, meaning that only the entity’s
boundaries are shown.
Chordal Tolerance Shows the selected chordal tolerance value that controls the precision of
the display of solid geometry (see Chordal Tolerance, 362).
Geometric Shrink Shows the model percentage by which the display of each geometric
entity will be reduced. At default = 0, no shrinking takes place.
374 Display>Geometry
Modifying the Appearance of Geometric Entities
Show Parametric Direction Displays the location and orientation of the parametric axes of geometric
entities. This information may be essential in certain geometric and finite
element applications, for example, the parametric directions of a surface
determine the direction of element normals, that in turn defines the
positive direction of pressure loads on the surface.
Show Free Faces Shows free faces of solids. This feature is useful when you import CAD
geometry that might contain gaps that will prevent you from creating
acceptable meshes on the model.
Point Size Increases or decreases the display size of geometric points to aid
visualization.
Colors and Labels Controls the colors and label display of geometric entities. This dialog is
the same as in the command Display>Entity Color/Label/Render (see
Display>Entity Color/Label/Render, 367), except it applies only to geometric
entities. The two commands work together, the latest input in either one
will become the prevailing color definition and will show up in both
dialog boxes.
Coordinate Frames Posts or unposts symbols of previously defined local coordinate frames.
Note: You can save the first five of the geometry attributes in a named attribute set (see Named Attributes,
365.
Display>Finite Elements 375
Modifying the Appearance of FEM Entities
The Display>Finite Elements command can change certain display attributes of FEM entities. Modified
display features are saved when you save and exit the model, and will be recalled when you open the database
again.
376 Display>Finite Elements
Modifying the Appearance of FEM Entities
Parameter Description
Number of Line Segments per Defines the number of line segments used to approximate the curvature
Edge of element edges. Default=0, which is to be interpreted as accepting the
minimum number of line segments needed to connect the nodes located
on each edge (number of midside nodes plus one).
FEM Shrink Shows the model percentage by which the display of each FEM entity
will be shrunk. At default=0, no shrinking takes place.
Show Only Free
Edges A free edge is a boundary edge of an element that is not shared by at least
one other element. When this toggle is on, only free edges are displayed.
This display tool can help you verify whether there are any
discontinuities in the finite element model.
Faces A free face is an element face that is not shared by at least one other
element. When this toggle is on, only the free faces are displayed. This
too can help you verify the continuity of the finite element model.
Node Size Increases or decreases the display size of nodes to aid visualization.
Display MPC Markers Turns the display of MPC Markers On or OFF. By default, the display is
ON.
Display Point (0D) Element Turns the display of Point (0D) Element marker ON or OFF. By default,
Marker the display is ON.
Colors and Labels Controls the colors and label display of FEM entities. This dialog is the
same as in the command Display>Entity Color/Label/Render (see
Display>Entity Color/Label/Render, 367, except it applies only to FEM
entities. The two commands work together, the latest input in either one
will become the prevailing color definition and will show up in both
dialog boxes.
Coordinate Frames Posts or unposts symbols of previously defined local coordinate frames.
Connector Attributes Additional Connector display attributes may be defined via the
Connector Attributes form, invoked by selecting this button.
Note: You can save the first five of the FEM attributes in a named attribute set (see Named Attributes, 365).
Display>Finite Elements 377
Modifying the Appearance of FEM Entities
Parameter Description
Display 2D Markers Display Use these checkboxes to turn the display of 2D (bars) and 3D (spheres)
3D Markers markers ON/OFF, independent of each other (default ON).
Scale The scale to be applied to the connectors diameter when calculating the
size of the spheres upon display.
If the 3D Marker Size is set to Absolute, then the label of this databox
becomes Diameter, and fixed model space diameter is specified.
Unverified Connectors The color that unverified connectors shall be displayed in. In the event
that the underlying model of a connector is changed (like a remesh), then
the connector will be flagged as Unverified, until it is re-verified. Such
connectors shall be displayed in an alternate color, defined here.
With this command you can control the display symbols for loads, boundary conditions, and element
properties.
380 Display>LBC/Element Property Attributes
Symbols for Loads, Boundary Conditions, and Element Properties
Parameter Description
Load/BCs Controls of load and boundary condition symbols. To change a default
color, click on the color chip, then pick the desired color in the color
table.
Element Properties Controls element property symbols.
Show on FEM Only Functional assignments, such as loads, boundary conditions, and
element properties may be applied either directly to geometry or to the
finite element model. By default, all symbols are displayed and
positioned at the entities to which they had been applied. If this toggle is
on, only those symbols are displayed that represent loads, boundary
conditions, or element properties applied to FEM entities.
Show LBC/ El. Property Certain loads and boundary conditions, and some element properties are
Vectors vector entities and their symbols are directed arrows. Generally, their
numerical values are also displayed. If you turn this option OFF, both the
vectors and the numbers will be turned OFF.
Show LBC/ El. Property If you turn this OFF, but keep the Vectors on, the symbols will be
Values displayed but not the numerical values.
Vectors/Filters Displays the Vector Attributes dialog box in which you can select the
length and color properties of display vectors. Optionally, you can also
stipulate that vectors be displayed according to some filtering
mechanism, e.g., if the numeric value they represent exceeds some
specified minimum.
Label Style Displays the Label Style dialog box that provides options for the display
format of the numerical values of functional assignments.
Beam Display Presents various options for identifying and displaying beam elements.
Display Pin DOFs If ON, displays the degrees of freedom of the pinned connection.
Display Spring DOFs If ON, displays the degrees of freedom assigned to a spring element.
Vector Attributes
In this dialog box you can designate length, color, and filtering characteristics for the vectors that represent
loads, boundary conditions, or certain element properties.
Display>LBC/Element Property Attributes 381
Symbols for Loads, Boundary Conditions, and Element Properties
Parameter Description
Vector Length
382 Display>LBC/Element Property Attributes
Symbols for Loads, Boundary Conditions, and Element Properties
Constant - The length of the vector symbols is constant. When you use this option
Screen Relative/ all vectors are of the same length; for example, a vector that represents a
100 lb force will be just as long as the one that represents a 1,000 lb force.
Model Relative
Vector lengths may be proportional either to the screen display or to the
dimensions of the model.
Scaled - The length of the vector symbols is scaled. In this case, the vector that
Screen Relative represents the 1,000 lb force will be displayed as ten times the length of
the 100 lb force vector.
Model Relative
Vector lengths may be proportional either to the screen display or to the
dimensions of the model.
Scale Factor Enter a scale factor to be used when the vectors are scaled.
Vector Coloring
Same for All Vectors are shown in their actual direction in the colors specified in the
LBC/Elem. Properties dialog box.
Component This option displays the X, Y, and Z components of the vectors in the
colors defined in this dialog box.
Colors Select the display colors for vector components and the resultant vector.
LBC/El. Prop. Filter With this option you can reduce some screen clutter by displaying only
those vectors that are associated with values that meet some boundary
requirements.
Label Style
Label style refers to the display format of the numerical values attached to symbols. The range labels are now
styled independent from the plot's value labels. The range label color, font size, format (i.e. fixed, exponential,
integer) and number of significant digits can be controlled.
Display>LBC/Element Property Attributes 383
Symbols for Loads, Boundary Conditions, and Element Properties
Parameter Description
Label Format
Fixed The numbers are displayed in a decimal format.
Exponential The numbers are displayed in exponential format.
Integer The numbers are displayed as integers.
Significant Figures When using decimal or exponential format, you can specify the desired
number of significant figures either with the slider or by typing it in the
textbox.
Beam Display
This attribute controls the way beam elements of a mesh are displayed on the screen.
Parameter Description
1D:Line Elements are drawn as lines. Element properties (defined in the Properties
application), such as offsets and beam section shape, are not displayed.
1D:Line + Offsets Elements are drawn as lines. Offsets are also displayed.
384 Display>LBC/Element Property Attributes
Symbols for Loads, Boundary Conditions, and Element Properties
1D: Line + Offsets + NA Element shear centre axis and neutral axis are displayed as lines including
any offsets. The two axes are connected by a line at each end of the beam.
The neutral axis is designated by a marker at each end. The default
marker is a circle. The marker type and size can be controlled by the
Preferences>Graphics command.
2D:Mid-Span Beam section shape is displayed at the mid-span location of each beam
element.
2D:Mid-Span + Offsets Beam section shape is displayed at the mid-span location of each beam
element. Offsets are also shown.
Display>LBC/Element Property Attributes 385
Symbols for Loads, Boundary Conditions, and Element Properties
2D:Mid-Span + Offsets + Beam section shape is displayed as a square of equivalent area at the mid-
Equiv. A span location of each beam element (see notes below). Offsets are also
shown.
3D:Full Span Beam section shape is displayed over the full span of elements.
386 Display>LBC/Element Property Attributes
Symbols for Loads, Boundary Conditions, and Element Properties
3D:Full Span + Offsets Beam section shape is displayed over the full span of elements. Offsets are
also drawn.
3D:Full Span + Offsets + Beam section shape is displayed as a rectangle of equivalent moments of
Equiv. I inertia over the full span of elements (see notes below). Offsets are also
drawn.
3D:Full Span + Offsets + Beam section shape is displayed as a square of equivalent area over the full
Equiv. A span of elements (see notes below). Offsets are also drawn.
Display>LBC/Element Property Attributes 387
Symbols for Loads, Boundary Conditions, and Element Properties
Notes: In 3D options, the beam sections are rendered in the rendering style specified for the model with
the Display>Entity/Color/Label/Render command. Equiv. I and Equiv A.: Displaying the
Relative Size of a Beam: The beam area (A) and two bending moments of inertia (Iyy, Izz) are
used to determine an equivalent rectangular bar section. The dimensions of the equivalent
section are then used to draw the section as a rectangular bar. The "Equiv. A" and "Equiv.
I" options indicate what property values are used to determine the dimensions. "Equiv. A" uses
only the area and ignores the moments of inertia. "Equiv. I" uses the moments of inertia and
the area if necessary. "Equiv. A" Option. If the "Equiv. A" option is chosen, the technique for
determining the equivalent square bar dimension is based only on the area. The formula for the
area of a square section of width w is: A = w2 Rule 1: Although it should not happen, if
no area is input, no attempt will be made to display an equivalent section. Rule 2: If area is
input, a square section will be drawn. Example 1: A = 10
Use Rule 2 w = (10)1/2 =
3.162 “Equiv. I” Option. If the “Equiv. I” option is chosen, the technique for determining the
equivalent rectangular bar dimensions is based on the moments of inertia and sometimes the
area. The well known formulae for area and bending moment of inertia for a rectangular section
of width w and height h are: A = wh Iyy = hw3/12 Izz = wh3/12
Since all 3 properties can only be satisfied by a given width and height if the properties are indeed
those of a rectangular section, additional rules must be applied. Rule 1: Although it should
not happen, if no area, Iyy or Izz is input, no attempt will be made to display an equivalent
section. Rule 2: If only area is input, a square section will be drawn as with the "EquivA"
option. Rule 3: If both Iyy and Izz are input, a height and width that yield the input Iyy and Izz
will be computed. The area will be ignored. Rule 4: If only Iyy or Izz and the area is input, a
height and width that yield the input Iyy or Izz and area will be computed. Rule 5: Although
it should not happen, if only Iyy or Izz are input, a square section that yields the input Iyy or Izz
will be computed. Example 1: A = 10, Iyy and Izz undefined
Use Rule 2 w = h = (10)1/2 = 3.162 Example 2: A = 10, Iyy = 15, Izz = 30
Use Rule 3 A is ignored, and by solving the
equations we obtain: w = 3.359, h = 4.75 Example 3: A = 10, Iyy = undefined, Izz = 30
Use Rule 4 By solving the equations we obtain: w=
1.667, h = 6 Example 4: A = undefined, Iyy = undefined, Izz = 30
Use Rule 5 In this case, since w = h: Izz = h4/12 or h =
(12Izz)1/4 = 4.356
388 Display>Named Attributes
Creating and Managing Named Attribute Sets
Use the Display>Named Attributes command to create, rename, or delete a unique set of display attributes
that you wish to recall during other work sessions with the current model.
Parameter Description
Select Current Set Lists the existing attributes set names. Two default sets, general and simple
already exist. After you create a new set, its name will appear in this area.
Pick the attribute set you want to use.
Current/New Set If you pick an existing set, its name will appear here. To crate a new
Named Attribute set:
In the Display>Coordinate Frames dialog box you can select one or more previously defined local coordinate
frames for posting.
Parameter Description
Post/Unpost Coordinate Lists the names and IDs of currently defined coordinate frames. Select
Frame(s) the coordinate frame you want to display, or “post”. For multiple
selections, hold down the Shift key to pick names listed consecutively, or
the Ctrl key to pick non-consecutive names.
Post/Unpost All Displays all coordinate frames, or removes all coordinates from the
screen.
Select Coordinate Frame(s) Provides another way of selecting one or more coordinate frames for
posting. Type the ID of the coordinate frame or pick it with the cursor.
Use the Shift key for multiple selection.
Display>Titles 391
Adding Text to Viewports
With the Display>Titles command you can create and modify titles and other text displayed in a viewport.
Parameter Description
Post/Unpost Titles Lists defined titles. To insert existing text into the viewport, select the text
you want then pick the viewport in which it will be displayed. The text
will be placed at the upper left portion of the viewport. You can drag it
to any other part of the viewport, as long as the Titles dialog box is on
the screen.
Click on the text you want to edit; the text will be entered in the
Target Title textbox.
Press Rename. The Rename dialog box will appear.
Enter the new text and press Apply.
Click on the text you want to delete; the text will be entered in
the Target Title textbox.
Press Delete. The following message will appear:
With the Display>Spectrums command you can define new spectrums or modify existing ones for displaying
analysis results.
394 Display>Spectrums
Creating and Managing Spectrums
Display>Spectrums 395
Creating and Managing Spectrums
Parameter Description
Current Spectrum Lists the names of all spectrums defined in the database and highlights
the currently used spectrum. Patran software comes with several
predefined spectrums.
Create Creates a new spectrum by placing the colors in the standard spectrum in
a different order. When you press this button, a subordinate dialog box
will appear in which you can specify the new spectrum attributes.
Number of Colors Specifies the number of colors in the new spectrum; this number must be
between 3 and 16.
Note that after a spectrum has been created, the number of colors cannot
be modified.
Spectrum Attributes
Continuous Color Displays the color bar in the viewport as a continuum of colors without
the separation lines.
Interpolation Factor Controls interpolation between any two colors in a continuous-display
spectrum. The default value of 2.0, representing quadratic interpolation,
is generally acceptable.
Spectrum/ Color Table The left-hand column is for defining the new spectrum, the right-hand
column is the standard color table. To change the definition of a color
button:
All of the data entered on the Range form is now stored in the Patran database. This is most useful for
customizing the range labels and for defining ranges that automatically update to fit the current results data
being plotted. You can choose from several different methods to generate the range intervals. Your method
choices and all associated data are stored in the Patran database. The results plotting tool then uses these
setting to regenerate the range intervals based on the current results data and the Method and parameters you
defined for the range.
The Display Ranges form shown below allows you to create and manage named range definitions that
associate numerical intervals to the colors of the current spectrum and are used to color code data in a plot.
The range labels are now styled independent from the plot's value labels. The range label color, font size,
format (i.e. fixed, exponential, integer) and number of significant digits can be controlled.
Display>Ranges 397
Defining Ranges and Sub-ranges for Results Display
The options listed in the Action pull down menu located at the upper left corner of the Ranges form allow
you to set the forms operational mode. The operations are Create, Copy, Modify, Assign to Viewport, and
Delete.
Create allows you to create a new range definition.
Copy allows you to make a copy of an existing range definition, with a new name. This copy can be
your starting point for a new range definition.
Modify allows you to change the definition of an existing range.
Assign to Viewport lets you select an existing range to be used for the current or any existing
Viewport.
Delete allows you to delete one or more existing range definitions. Each Action option is fully
described in the sections that follow.
398 Display>Ranges
Defining Ranges and Sub-ranges for Results Display
Parameter Description
Create Creates a new Range
Range Names The options located in the Range Names frame allow you to specify the
name of the new range. You can either enter a new name into the New
Range name edit box or select an existing range name by pressing the
Existing Ranges button. If you select an existing range name the Ranges
form will be updated to show the definition of the range you selected.
This method us typically selected if you want to use an existing range as
the starting point for your new range creation. You will need to change
the selected range name if you do not want the exiting range definition
to be over written.
Data Methods Data Methods define the algorithm that you would like to use to create
the range intervals.
Algorithms Auto: Auto is the algorithm used in the previous versions of the Ranges
form, with new capabilities added to the Fit Results function. These new
capabilities will be described below. A typical use scenario for the Auto
option is to first enter the number of sub-ranges for the new range you
are creating and then press the Fit Results button to map result values
into the range spread sheet as a starting point for defining the new range
intervals.
When you press the Fit Results button the Existing Plots form will
appear. This form has been added for this release. Previously the result
values of the current range tool would be loaded into the Ranges
spreadsheet. Now you can select any existing posted or unposted plot.
The selected plot’s results values to be loaded into the Ranges spread
sheet. After selecting an existing plot press the Apply button to cause your
selection to be set and to close the Existing Plots form. Next, press the
Calculate button to update the spread sheet, the Start and End Value edit
boxes with the result values of the plot you selected. You can now modify
the Start and End values and then to press the Calculate button again to
update the spreadsheet relative to your changes.
Display>Ranges 399
Defining Ranges and Sub-ranges for Results Display
Delta: The Delta method requires you to enter the Number of Sub-
ranges, Start, and Delta values. The new range intervals will be created
beginning at the Start Value, having subinterval lengths of Delta size, and
will extend from the Start Value to an end value defined by the product
of the number of intervals and Delta length.
2) Starting with the minimum value the distance between it and the next
value is compared to the current Bin Size. The units of the Bin Size and
distance values are defined by the Bin Method, which can be set to either
Percent or Delta value units. If the distance is less than or equal to the Bin
Size the second value is contained in the first range interval. If the
distance is larger than the Bin Size the data value defines the first data
value to be included in the next range interval.
Step 2 is repeated using the initial value included in the new range
subinterval as the value to be compared with values that are greater than
it. This process stops when either the last data value is compared and
included in a range interval or the number of intervals exceeds the
Number of Sub-ranges values set by the user. If the number of sub-ranges
exceeds the Number of Sub-ranges than the process exits if Failure
Recovery is set to None.
If the Failure Recovery is set to Revert to Auto than the Number of Sub-
ranges is automatically increased to the number of sub-ranges that are
needed to map the data set into cluster sub-intervals.
400 Display>Ranges
Defining Ranges and Sub-ranges for Results Display
None: You must enter all of the values. No values are calculated for you,
nor are any values automatically copied to other cells.
From and To: You must enter the From and To values for each range
interval. The Middle value is calculated for you and entered
automatically.
From gets To: You must enter the From values for each range interval.
The To values are set to the adjacent interval’s From values. The Middle
values are also calculated and set automatically for you.
To gets From: You must enter the To values for each range interval. The
From values are set to the adjacent interval’s To values. The Middle values
are also calculated and set automatically for you.
Middle only: You must enter each range interval’s Middle value. Simple
arithmetic averaging of adjacent interval Middle values is used to define
the To and From values that occur between adjacent Middle values.
Mid +/- Delta and Mid +/%: You must enter each range interval’s
Middle value and a single delta value. The interval’s From and To values
will be calculated by adding and subtracting the delta value from the
interval’s Middle value respectively. The value is either the value you
entered or the product of the decimal equivalent of the percent integer
you entered and the current Middle value. You can change the Delta or
Delta Percent Value at any time. This will only affect intervals set after
the change. Intervals already defined will not be affected by the change.
From + Delta and From +%: You must enter each range interval’s From
value and a single delta value. The interval’s To value will be calculated
by adding the value to its From value. The value is either the value you
entered or the product of the decimal equivalent of the percent integer
you entered and the current From value. The Middle value is calculated
and set automatically for you.
Display>Ranges 401
Defining Ranges and Sub-ranges for Results Display
Note on Manual Aids: During the process of defining the range intervals,
you may switch between the various Manual Aids and use the currently
selected Manual Aid for subsequent interval definitions.
Delta Log: You must enter the range start value and a delta log value that
will be used as the exponent of the base ten multiplier (i.e. 10delta) used
to determine the interval’s end value. For example, a Delta Log value of
0.5 and a Starting Value of 1.0 will produce a range starting at 1.0 and
increasing by a factor of 10 every 2 intervals.
Thresholds The Auto, Delta, and Delta Log Data Methods Algorithms allow you to
define Range Thresholds. Thresholding allows you to manually define
the size of the upper and lower range intervals. The remaining intervals
are located between these and defined by the Data Method Algorithm
you chose to use. A typical use of Thresholding is to temporarily redefine
the range to focus on a subset of result values to determine where these
occur with in the simulation model. The upper and lower threshold
values can be defined entering a result value or a percent value. If a result
value is entered then the lower and upper intervals will be defined to have
a length of minimum result value to lower value and upper value to
maximum result value respectively.
The Use Percentages toggle allows you to define the thresholds in terms
of the interval between the lower and upper range values before
thresholding. Negative Percent Values produce lower thresholds below
the lower range value. Percent Values greater than 100% produce
threshold values above the upper range value. Percent values between 0%
and 100% produce threshold values between the lower and upper range
values.
402 Display>Ranges
Defining Ranges and Sub-ranges for Results Display
Attributes Allow Overwrite: If turned off this option will not allow the range’s
definition to be modified when attributes of a tool that uses it are
changed. This is to prevent accidental overwriting of your range by an
auto-ranging result plot.
Force Result Update: This option must be used in conjunction with the
Allow Overwrite option. It causes the range definition to be modified if
the results value associated to a plot that uses the range is changed. This
toggle causes the range intervals to be recalculated every time the range is
used. It does not work in conjunction with the Manual Data Method.
For the other Data Methods (Auto, Delta, Cluster and Delta Log) the
Data Method, relevant data values and thresholding settings have been
saved in the Patran database. These setting will be used to automatically
regenerate the range intervals based on the result data values being
plotted each time.
Post When Used: This option causes the range to be posted to the
Viewport if a results tool that is posted in a Viewport references it.
Display>Ranges 403
Defining Ranges and Sub-ranges for Results Display
General Information You can now customize Range labels. You can now control labels for
Concerning Range Labels values inside and outside the range as well as labels for values that fall with
in the maximum to minimum range bounds but do not map to an
interval within the range. Any combination of these labels can be toggled
on/off. Range labels can now include prefix and suffix text that can be
applied to all subinterval labels. Custom labels can be defined for any
label by pressing in its Custom button. Once this is done the label
becomes editable by the user. The following sections describe the four
sections of the Range form that contain the range label controls offered
to the user.
Label Display Label Display allows you to control the display of the To, Middle, and
From labels of each interval with in the range. For the Middle label you
can define a tolerance style format using the Tolerance option. The
choices of Tolerance are described below:
+/- Delta: The label will appear as the middle value plus the value if
added and subtracted from the middle value would derive the interval’s
From and To values respectively.
+/- Delta: The label will appear as the middle value plus a percent of the
middle value that if it were added or subtracted from the middle would
derive the interval’s From and To values respectively.
From: To: This option allows you to label the interval at its middle
location with the From and To values that define the extent of the
interval.
When the Use All Custom Labels button is pressed, labels that you have
not customized (i.e. the Custom button for the label is depressed) will be
turned on regardless of the state of its To/Middle/From toggle button
that globally turns on/off the labels at these range interval positions.
Label Controls Reset All: If this button is pressed all the Custom buttons associated to
the labels will be turned off and the custom text you have entered will be
deleted.
No Data: This edit box allows you to define text that will decorate the
range and spectrum interval used to show the regions of the model where
no analysis data is available.
404 Display>Ranges
Defining Ranges and Sub-ranges for Results Display
Label Style Label Style controls are used to define the format and color of the range
labels. The range labels are now styled independent from the plot’s value
labels. The range label color, font size, format (i.e. fixed, exponential,
integer) and number of significant digits can be controlled.
No Matching Sub-range The options included in this section of the form let you control a special
range interval that is used to represent result values that do not belong to
any of the range intervals. The various Use Sub-range options are as
follows.
First / Last / No Data: These options turn off the special No Matching
Sub-range interval. If results data exists that is not mapped to one of the
range intervals than the regions of the model that contain these values are
rendered with the first, last, or no data spectrum color according to your
selection of First, Last, or No Data.
Copy Existing range definitions can be copied. To perform a copy first set the
Ranges form Action pull down option menu to Copy. Next, press the
Existing Ranges button and select an existing range by highlighting its
name and pressing the Apply button at the bottom of the Existing Ranges
form. Finally, enter a new name in the New Range Name edit box and
press the Apply button at the bottom of the Ranges form.
Modify An existing range definition can be modified. To modify an existing
range first set the Ranges form’s Action pull down option menu to
Modify. Next, press the Existing Ranges button and select an existing
range by highlighting its name and pressing the Apply button at the
bottom of the Existing Ranges form. You are now free to alter any part of
the range’s current definition. When you are finished simply press the
Apply button at the bottom of the form to save your changes.
You can also modify existing ranges by using the Create Action of the
Ranges form but you will always be asked to verify that you would like to
apply your changes to the existing range.
Assign to Viewport The Action option, Assign to Viewport, allows you to pick an existing
range to be assigned to any existing Viewport. When you perform this
operation the model will be re-rendered in the viewport using the
assigned range definition to define the value-color mapping. This
assignment may also be set from the Viewport > Modify, Attributes,
Change Range... sub-form.
Delete To delete an existing range definition just set the Ranges form Action pull
down option menu to Delete. Select the existing ranges you would like
to delete by first pressing the Existing Ranges button, highlighting the
range names you would like to delete, and then pressing the Apply button
at the bottom of the Existing Ranges form.
406 Display>Color Palette
Creating and Managing Color Configurations
In the Display>Color Palette dialog box you can customize all colors used in the current database.
Parameter Description
Current Color Palette Lists the name of all Color Palettes that exist in the database and
highlights the currently used Color Palette. Patran provides the following
three default color tables: gray_scale, rgb_colortable and
standard_colortable.
Display>Color Palette 407
Creating and Managing Color Configurations
Color Table Displays the 16 colors of the current color palette. The color at the top of
the column determines the background color of viewport displays.
To change a color, click on the color chip then use one of the
modification methods to create the effect you want.
Color Table Modifications You can choose between two methods of modifying colors:
The Display>Shading command controls the way light interacts with surfaces displayed in shaded rendering.
Parameter Description
Texture Gives a textured appearance to surfaces. For smooth surfaces the texture
= 0, a value of 1.0 on the slidebar makes the surface look rough.
Transparency Controls the amount of light that passes through a shaded object. If
transparency = 0, no light passes through and the object is opaque, at a
value of 1.0 the object becomes totally transparent.
Display>Shading 409
Controlling the Appearance of Light on Surfaces
Specular Reflection Sets the degree of light reflection in an object’s specular region, the area of
the surface that is normal to the light source. If this value = 1, all light
will be reflected in the specular region.
Diffuse Reflection Controls the degree of reflection throughout the surface of the whole
object. At higher values more of the surface area will be lighted. If this
setting is low and the specular reflection is high, the object will appear
brightly lit where the light is normal to the surface then the light will
dissipate all over the surface.
Highlight Size Illustrates the relative sizes of specular regions on surfaces.
Specular Color Specifies whether the color of the object or the color of the light source
will affect the color of the specular area.
410 Display>Light Source
Managing the Illumination of Surfaces
With the Display>Light Source command you can create new light sources and control the light that affects
the shading of surfaces.
Parameter Description
Post/Unpost Light Sources Lists all light sources defined in the database and highlights the currently
active (posted) light source(s). Pick the name of a light source to post it.
For multiple selections, hold down the Shift key to pick consecutively
listed items, use the Ctrl key for names not listed consecutively.
Display>Light Source 411
Managing the Illumination of Surfaces
Target Light Source Identifies the light source selected for modifications.
Create Creates a new, named light source. Displays a subordinate dialog box, in
which you enter the name and select the type of the light source.
Direction Displays the coordinates of the end point of the light direction vector.
Location Displays the coordinates of the light source location (the start of the light
direction vector).
Color Shows the color of light selected for the target light source.
Intensity Controls the intensity of the light from low (0.0) to high (1.0).
Attenuation Applied to spot lights only, it controls the change in intensity based on
the distance of the light source from the object.
Opposing Light Sources When displaying surface entities, for each posted light source an
opposing light source is created to illuminate those faces whose surface
normals point away from the light source.
412 Display>Light Source
Managing the Illumination of Surfaces
Chapter 10: Preferences
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
10 Preferences
Preferences Concepts and Definitions 414
The Preferences Menu 416
Preferences Commands 418
414 Patran Reference Manual
Preferences Concepts and Definitions
Analysis Codes
Analysis codes are the finite element programs you use to perform the analysis. Possible analysis codes include
MSC Nastran (default), MSC Marc, MSC Dytran, Patran Thermal, ABAQUS, ANSYS 5, LS-DYNA3D,
PAMCRASH, SAMCEF, PATRAN 2 NF. The analysis code you pick here depends on what is available at
your site. For more information, see the relevant preference guide.
Preference Guides
Patran Interface to ABAQUS Preference Patran Interface to MSC Nastran Patran Thermal User’s Guide Volume 1:
Guide Preference Guide Thermal/Hydraulic Analysis
Patran Interface to ANSYS Preference Patran Interface to SAMCEF Preference MARC Preference Guide
Guide Guide
Patran Interface to LS-DYNA Patran Interface to Dytran Preference PATRAN 2 Neutral File Preference
Preference Guide Guide Guide
Finite element analysis codes have their own specific way of defining components of a FEM model and of
formatting analysis input and output data. Therefore, the code you select will also determine the following:
available analysis type
element type, shape, and property definitions
material property definitions
applicable loads and boundary conditions
code-specific forms in the Analysis application.
Chapter 10: Preferences 415
Preferences Concepts and Definitions
Analysis Types
The analysis code you selected also determines which kind of finite element analysis can be accessed.
Structural, thermal, and fluid dynamics analyses are the most frequently used types available for most analysis
code applications.
Preference Mapping
Patran offers three mapping options each providing a unique level of conversion and user control.
1. Mapping Functions - Running a series of PCL commands, you can produce customized mapping
tables that you use when switching from one analysis code to another. These mapping tables precisely
define how element properties and material properties are translated from one particular code to
another.
2. Legacy Mapping - This option employs default mapping tables such that the most obvious data is
mapped to the new code and the more complex data is left untouched. Earlier versions of Patran were
limited to this default mapping.
3. No Mapping - Using this option the database remains unchanged when switching from one analysis
code to another. No mapping of any kind is done. The advantage to this option is that you can change
preferences, perhaps just to see what capabilities a code has, without changing the model.
The mapping option you select will depend on the issues pertinent to your model and to the analysis codes.
For example: 1) do the fem entities (nodes, elements, mpc’s) map over correctly; 2) are there equivalent loads
and boundary conditions, contact, material and element properties; 3) are there equivalent analysis
procedures, and will they convert correctly when you change the analysis preference?
Model Tolerance
Tolerance specifies the maximum distance within which two like entities (e.g., nodes), are said to be
coincident. Tolerance, being a global parameter, remains valid for both geometric and FEM construction. The
same tolerance value will apply to geometric entities imported in a CAD database.
Model tolerance may be specified as an absolute number (normally 0.005) or it may be based on the
maximum model size. In the latter case, the recommended tolerance is 0.05% of the expected maximum
model size. However, you may specify a different tolerance depending on how accurately the imported
geometry was constructed.
416 Patran Reference Manual
The Preferences Menu
Warning Messages
Occasionally Patran issues a warning in conjunction with a command or entity selection. Warning messages
are output to the history window and to the session file and, by default, are also shown on the screen. You
may choose to sound just a warning bell rather than the screen display, or omit warning notifications
altogether.
Hardware Rendering
If your system is set up to access a hardware graphics device for graphics displays (The settings.pcl file, 61) you
can choose to render shaded images through that device. Hardware generation of images typically takes less
time but, in general, software rendering is more accurate and even offers more display options (e.g., texturing
effects).
Representing Geometry
In earlier versions of Patran (e.g., PATRAN 2), curves, surfaces, and solids were created as parametric cubic,
bicubic, and tricubic geometry. An option in the Preferences Geometry dialog box enables you to create
parametric cubic geometry that can be exported to a neutral file.
Model Units
The vehicle that Patran uses to create solid geometry is a modeler named Parasolid. Parasolid assumes model
units in meters. Although Patran is “unitless” (dimensions can be interpreted in any unit system), because of
Parasolid, a scale factor is used when creating solid geometry ( see Parasolid Model Units, 167). The default scale
factor is set in the Preferences menu.
Menu Conventions
A menu item with ellipses (...) attached to it calls up an additional dialog box in which you enter further data.
Chapter 10: Preferences 417
The Preferences Menu
The Preferences menu functionalities are described below in the order in which they appear.
Parameter Description
Analysis... Selects the finite element analysis code and the type of analysis that will
be performed.
Preferences Commands
The following is a detailed description of the commands and dialog boxes that manage global preferences.
With the Preferences>Analysis command you specify the analysis code you will use to run the finite element
analysis calculations and select the kind of analysis you want to perform. Setting the Analysis Preference
activates code-specific definitions in the Patran database.
Preferences>Analysis 419
Selecting/Changing the Analysis Code and Type
Parameter Description
Analysis Code Specifies the analysis program used for analyzing the model.
Parameter Description
Preference Mapping
Using PCL generated mapping tables, you can convert many of the
complex parts of the code-specific model from one analysis code to
another. In particular, mapping functions allow for the mapping of
element and material properties.
Mapping Functions
Patran uses mapping tables to convert code-specific definitions from one analysis code to another. These
mapping tables are specific to the old and new analysis codes and separate mapping tables are required for
material properties and element properties.
A limited number of mapping tables are included in the Patran delivery. These mapping tables have been
generated as part of included example problems or generated to map previously supported analysis solvers
over to currently supported solvers. For example, the mapping tables for mapping from the MSC Nastran
Preference to the MSC.Marc Preference are included and an example illustrates the full model conversion
between these solvers. In addition, you can access the Hexagon website under Product Updates for the latest
information on mapping tables.
Material property mapping tables and element property mapping tables are generated through separate
procedures that involve using spreadsheets to define translation instructions, converting spreadsheets to PCL
functions, then compiling those into the system to be executed during a preference change.
Once these mapping tables are generated they can be used repeatedly to switch between analysis codes.
422 Preferences>Analysis
Selecting/Changing the Analysis Code and Type
Important: Procedure Information in the Patran database that pertains to the old analysis code is
overwritten with the information for the new analysis code.
Prior to changing the Analysis Preference, type in the command (on the command line):
map_materials.generate_leaflist( )
Change the Analysis Preference and repeat the command above.(You may have to restart Patran.)
For each material model in the original code (CodeA) enter a corresponding Leaf Number (from
Code B) that designates what the material model will be translated to in the new code in the 3rd
column, labeled “Maps To Leaf.”
map_materials.map_materials(“CodeATypeMaterials”,
”CodeBTypeMaterials”,”CodeAtoCodeBMaterials.xls”)
This command generates the file CodeAtoCodeBMaterials.xls.
424 Preferences>Analysis
Selecting/Changing the Analysis Code and Type
For each material property, enter the Leaf Numbers from CodeA in the column labeled Old ID.
Selecting which input data boxes should be mapped from Code A to Code B is up to your judgement
and experience.
map_materials.Convert_To_PCL(“CodeAtoCodeBMaterials.xls”,”
CodeAtoCodeBMaterials”)
This generates a file named: CodeAtoCodeBMaterials.pcl. Remember, Code A and Code B are the
exact preference names (without spaces or decimals).
6. Compile the PCL Function
Prior to changing the Analysis Preference, type in the command (on the command line - all one line):
map_properties.create_property_spreadsheet(“Code”,”Type”,
”Filename.xls”)
The “Code” and “Type” are case sensitive with the full name with decimals included and should be
entered exactly as they appear on the Analysis Preference form, for example “MSC.Marc” and
“Structural.” However “Filename.xls” can be whatever you want to name your property spreadsheet
such as “MarcStructuralProps.xls.”
Now, change the Analysis Preference to what you want to map to or from and repeat the command
above.
Keep track of whatever you name the spreadsheet as you will be needing this later.
428 Preferences>Analysis
Selecting/Changing the Analysis Code and Type
A property set is defined by the following information: a dimension, an element type, five element
options (geometric, condensation, laminate, formulation, and dof set), a topology, two material rules
(directionality i.e., materials category and linearity i.e., constitutive model) and a set of property
words. It is this data that is shown in the second section of the “Property Set Spreadsheet” with the
following exceptions. The topology and material rules are not shown, and only one of the possible
dof set element options is shown.
The first and most tedious part of creating a property set mapping is to match “Source” property sets
with “Destination” property sets. You will note that the first two columns in the “Property Set
Spreadsheets” (in the property set and property word sections) are “Source” and “Destination”. The
“Destination” column is just a count for identification. A mapping pair is created by entering one or
more source property set counters in the “Source” column.
For example, when mapping Abaqus to MSC.Marc consider the first two Abaqus property sets, which
are “Point Mass” and “Rotary Inertia.” In MSC.Marc, translational and rotational mass are defined
by the “Mass” property set. Therefore, we want to translate all Abaqus “Point Mass” and “Rotary
Inertia” property sets to MSC.Marc “Mass” property sets. This is done, by entering “1,2” in the
“Source” column in the MSC.Marc “Property Set Spreadsheet” on the line containing the “Mass”
property set (which happens to be the first one). This says source property sets 1 and 2 map to
destination property set 1.
Preferences>Analysis 429
Selecting/Changing the Analysis Code and Type
Property words with the same IDs map automatically, regardless of the name. (The name is just an
analysis code specific label.) Property words with different IDs but the same meaning (represent the
same physics) are mapped like property sets. The counter for the source word is entered in the
“Source” column of the destination spreadsheet. For example, Abaqus has two thickness definitions,
“Shell Thickness -- ID 1080” and “Membrane Thickness -- ID 1081”. These two words should map
to the MSC.Marc property word “Thickness -- ID 36”. This is done by entering “72,73” in the
“Source” column in the MSC.Marc “Property Set Spreadsheet” on the line containing “Thickness –
ID 36” (which is the 26th property word). So we have mapped source property word 72 and 73 to
destination property word 26.
430 Preferences>Analysis
Selecting/Changing the Analysis Code and Type
map_properties.create_mapping_spreadsheet(“Filename1.xls”,”
Filename2.xls”,”CodeATypetoCodeBTypeProps.xls”)
This spreadsheet shows each pair of source and destination property sets along with their source and
destination property words. This block of data defines how the data will map. The first two lines of
each block show the source and destination property set name, element type and element options.
Following this are the source and destination property word maps. At this point, the mapped words
include words with identical IDs and words that have been specifically mapped.
Not all source property words will map. (In this case, the corresponding cell in the “Destination”
column is blank.) If the data cannot be used by the destination Analysis Code, it can be ignored. It
will remain in the database, but will not be visible to the user. However, queries for element property
data by forward translators, etc. will have to account for property words that are “unknown” to that
Analysis Code. This is also true for unmapped property sets.
5. Make Additional Mappings
Some property words may not map in a general way. For example, you may want a property word to
map only for a specific property set. In this case, you can paste the destination word into the
appropriate cell next to the source word. Note that the spelling of the property word and the
accompanying ID must be accurate. The double hyphen is used as a delimiter and is therefore also
important.
If a complex translation is required, the general function can be used. See the section below describing
the use of the general function.
Conflicts
There are possible conflicts with acceptable data types or data values. For example, the source Analysis
Code allows either a real or a real nodal field to define a specific property word but the destination
Analysis Code only allows a real. Let’s assume we have one of these property sets to convert and a real
nodal field has been used for this property word. By default, the field will be stored. This can be
overridden by entering “No” in the column labeled “Store Incorrect Datatype”. Likewise, if the source
Analysis Code does not impose a limit on a specific property word, but the destination Analysis Code
does, the data will be mapped unless directed otherwise. As mentioned above, queries for element
property data by forward translators, etc. will have to account for this inconsistent data. An easy way
to identify these inconsistencies is to do a “Modify” (with no changes) on each property set after the
mapping is done. Any data consistency problems will be flagged by Patran by an error or warning
message.
Preferences>Analysis 431
Selecting/Changing the Analysis Code and Type
The property mapping capability provides access to the mapping process via a specified function.
This function is declared in the “Property Set Mapping Spreadsheet” in the cell to the right of the cell
containing “GENERAL FUNCTION”. If a general function is specified and it exists, it will be called
at several points in the process. Specifically, it is called at the beginning and end of the entire property
mapping process, at the beginning and end of each “source” property set and following each “source”
property word, provided that a “tag” has been specified. (The “tag” is not required for the two calls at
the beginning and end of the entire property mapping process.)
You’ll note in the “Property Set Mapping Spreadsheet” following each source and destination
property set pair are cells containing “Initial Property Set Function Tag” and “Final Property Set
Function Tag”. If data is entered in the cell to the right of the cell containing “Initial Property Set
Function Tag”, then when this specific source property set is encountered in the database, the general
function is called and is passed the current state add the specified tag.
This function can then perform whatever actions are required including calling back to the
“map_properties” class for current data on the property set in hand. (See below for a list of available
functions.) Note that if no “Point Mass” property sets exist in the database, this call will not be made.
Likewise, if a “Property Word Function Tag” is provided and that source word is encountered, the
general function is called. Note that these tags are specified in the column to the right of the
“Destination Word” column in the “Property Mapping Spreadsheet”. Also note that “Property Word
Function Tags” can only be specified for “Source Words”.
7. Converting the Mapping Spreadsheet into a PCL Function
map_properties.create_final_map("CodeATypetoCodeBTypeProps.
xls",
"CodeATypetoCodeBTypeProps.pcl",”FunctName”)
Recall that Code A and Code B are the exact preference names (without spaces or decimals).
“FunctName” is the name of the function that will be called to do the property mapping.
For the ABAQUS to MARC Change, this command generates the PCL file, “abatomarcprops.pcl”
which contains the function “abatomarcprops.”
This function consists of the spreadsheet data loaded into pcl variables, which are then passed to the
element property mapping logic. This function needs to be compiled and made accessible to Patran.
The suggested location is the analysis plb, which in this case is “mscmarc.plb.”
The property mapping logic currently does not consider topology, linearity and directionality data. Neither
does it verify that materials mapped to laminate property sets are laminate materials. Further, only the first
DOF set value for each set of geometric, condensation, laminate, formulation options is considered in the
“Property Set Spreadsheets”. This could pose some problems for logic accessing the mapped element property
set data, such as forward translators.
432 Preferences>Analysis
Selecting/Changing the Analysis Code and Type
my_mapping_class.do_the_lbcs ( )
The logical place to make the call to "mscmarc_mapping.set_mapping_function" would be in the
p3epilog.pcl file. But this call can be made anytime before a preference change is made. In addition, the user
would have to compile and add their plb to the system, again, most likely in the p3epilog file.
A little used but useful place to install this code on an enterprise basis would be in the "init.pcl" function in
"p3_home", probably just before the call to "p3epilog.pcl".
STRING state[ ]
STRING tag[ ]
SWITCH ( state )
CASE ( “Map Property Word” )
CASE ( “Start Region Set Mapping” )
CASE ( “End Region Set Mapping” )
CASE ( “Start Property Set Mapping” )
CASE ( “End Property Set Mapping” )
434 Preferences>Analysis
Selecting/Changing the Analysis Code and Type
END SWITCH
END FUNCTION
Now lets do something practical. The Abaqus “Point Mass” property set allows a single quantity for “Mass
Magnitude”. The MSC.Marc “Mass – (MASS)” property set however defines mass in three directions, “Transl
Inertia, X”, “Transl Inertia, Y” and “Transl Inertia, Z”. Clearly when we map from Abaqus to MSC.Marc, we
want any “Mass Magnitude” to map to each of the three MSC.Marc property words. Rather than handling
this complexity in the “Property Mapping Spreadsheet”, we do it with the general function.
Assume we have created a “Property Word Function Tag” for the “Mass Magnitude” property word in the
Abaqus “Point Mass” property set as described above. Our general function might look like the following.
FUNCTION map_abaqus_elmt_props_to_mscmarc ( state, tag )
STRING state[ ]
STRING tag[ ]
INTEGER status
REAL mass
STRING word[32]
SWITCH ( state )
CASE ( “Map Property Word” )
SWITCH ( tag )
CASE ( “Translational Mass” )
$Recover the current “Mass Magnitude” value. We’re
$assuming it is a real value and not a field.
word = "Mass Magnitude"
status = map_properties.get_active_src_word_rval ( word, mass,
datatype,
field_id )
$status = 0, if word is valid, exists and defined
$status = 1, if word is valid, exists, but is not a real
$status = 2, if word is valid but doesn’t exist
$status = 3, if word is not valid for current property set
$status = 4, if a property set conversion is not active
IF( status == 0 ) THEN
$Create three MSC.Marc words using the Abaqus value
$Note that word definitions have to be specified exactly
$and they have to be valid for the destination property set.
word = "Transl Inertia, X"
map_properties.create_dest_word_rval ( word, mass, datatype,
field_id)
word = "Transl Inertia, Y"
map_properties.create_dest_word_rval ( word, mass, datatype,
field_id)
word = "Transl Inertia, Z"
map_properties.create_dest_word_rval ( word, mass, datatype,
field_id)
END IF
END SWITCH
CASE ( “Start Region Set Mapping” )
CASE ( “End Region Set Mapping” )
Preferences>Analysis 435
Selecting/Changing the Analysis Code and Type
END FUNCTION
436 Preferences>Global
Controlling Global Operational Parameters
Parameters defined in the Global Preferences dialog box affect operational characteristics and geometric
construction.
Parameter Description
Session File Selects whether or not a session file will be saved. Options are to save after
Patran completes, delete after Patran completes, or to be prompted as to
whether or not to save the session file.
Preferences>Global 437
Controlling Global Operational Parameters
Enable Revert Operation Controls the use of the File>Revert command (see File>Revert, 84). If ON,
the revert operation will be enabled. This selection does not have
immediate consequences; to have it take effect, you must exit the current
work session then reopen the database.
Warning Message Options Picks the type of feedback you receive whenever Patran needs to issue a
warning.
In the Graphics Preferences dialog box you can stipulate certain view settings, specify the colors used for
highlighting, and select the shape, color, and size of markers, used in some geometric and FEM procedures
(e.g., node equivalencing).
Parameter Description
Automatic View Settings
Preferences>Graphics 439
Specifying Graphic Display Parameters
Auto Extend If ON, automatically fits the view whenever new entities are created and
they fall outside the viewport.
Auto Fit View If ON, automatically fits the view after any view rotation.
Hardware Rendering If ON, rendering will utilize a hardware device.
Default Background Color
Background Color Sets the background color of newly created viewports.
All Existing Viewports If ON, sets the background color for all existing viewports to the
Background Color setting.
Background Effects... Opens the form to set default background effects. This is explained in
Changing the Background Effects, 320.
XY Color Sets the background color on XY plot windows.
All Existing XY Windows If ON, sets the background color for all existing XY viewports to the
Background Color setting.
Disable Auto Updates If ON, the graphics display does not update after each operation. This
technique is particularly useful at times when you are performing a
number of operations but do not want to see the results of each interim
step.
Highlight Colors
Primary Color Assigns the color that will be used for highlighting entities selected for an
operation.
Secondary Color Identifies a second color in case the primary highlight color is already in
use.
Error Color Selects a color to highlight entities associated with an error condition.
440 Preferences>Graphics
Specifying Graphic Display Parameters
Marker Options Picks the type, color, and size (in pixels) of markers.
Model Tree Configuration... If the Model Browser Tree (MBT) has been activated by starting Patran
with the -mbt ON option, this toggle can be used to display or hide the
MBT from the graphics screen. By default the MBT is displayed,
meaning it is not necessary to start Patran with the -mbt ON because that
is the default behavior. Hoever if the -mbt OFF is used, then this toggle
will have no effect because the MBT is not active.
Preferences>Mouse 441
Programming the Mouse for View Transformations
With the Mouse Preferences options you can program the middle mouse button to perform incremental view
transformation functions.
442 Preferences>Mouse
Programming the Mouse for View Transformations
Parameter Description
Middle Mouse Button Map All four functions can be programmed with different MMB / key
combinations simultaneously.
Rotate X/Y Rotates the view about the global or screen X and Y axes.
About X
move the mouse up to rotate clockwise
move the mouse down to rotate counterclockwise.
About Y
move the mouse right to rotate clockwise
move the mouse left to rotate counterclockwise.
Rotate Z Rotates the view about the global or screen Z axis.
move the mouse right to rotate clockwise
move the mouse left to rotate counterclockwise.
Pan X/Y Pans the view in the screen X or Y direction.
move the mouse left or right to pan left or right
move the mouse up or down to pan up or down.
Zoom Zoom the view of the model in (enlarge) or out (reduce).
move the mouse left to zoom in
move the mouse right to zoom out.
Transform in Wireframe If ON, view transformations are performed in wireframe even if the
model is rendered in shaded or hidden line mode.
Transform with Edges If ON, and the toggle above is OFF, view transformations are performed
in shaded mode and solid edges are shown.
Mouse Tracking This parameter is meaningful in hardware graphics mode only. If ON,
partial redraws will be created as rendering tries to catch up to the mouse
motion (in software graphics mode this happens automatically).
Spin Model With the mouse button map set to one of the rotate functions, and this
toggle turned ON, you can spin the view of the model. When you press
the middle mouse button, the view will transform as expected, but you
can make it spin by releasing the button. The speed of rotation is
proportional to the speed with which you release the button.
Transformation Options Brings up a subordinate dialog box in which you can set the rotation
angle increment, pan factor and zoom factor.
SpaceMouse Parameters These additional parameters appear only on the Linux platform to set
calibration of SpaceMouse movement.
Check the Motion Control Calibration button ON and set the value on
slide bar from 0.1 to 9.0 for the desired mouse calibration.
Preferences>Mouse 443
Programming the Mouse for View Transformations
Parameter Description
Rotation Displays the rotation angle in degrees. Each mouse movement will rotate
the view by that increment.
Model/Screen Relative Selects whether the rotation axis specified is to be interpreted as a global
axis or a screen axis.
Pan Factor Displays the panning rate. Each mouse movement will move the view of
the model by that increment.
Zoom Factor Displays the zooming rate. Each mouse movement will zoom the view of
the model at that rate.
444 Preferences>Picking
Parameters of Interactive Screen Picking
Many geometric and finite element operations require that you select one or several entities as the object of
some action. The Picking Preferences dialog box contains a variety of options for picking entities with the
mouse (for more information on interactive screen picking, see Screen Picking, 29).
Note: The selections you make in this dialog box will not take effect immediately. After selecting the
parameters, exit Patran. The choices you made will be saved in a file (settings.pcl) that will activate
the new parameter settings when you restart Patran.
Preferences>Picking 445
Parameters of Interactive Screen Picking
Parameter Description
Single Picking These options apply when you select single entities.
Centroid Picks the entity whose centroid is closest to the center of a “pick box”.
Entity Picks the entity at which the cursor is pointing.
Entity Picking Cursor In entity picking mode, selects the shape of the cursor. In centroid
picking mode the cursor always remains an arrow.
Rectangle/Polygon Picking These options apply when you select a number of entities at the same
(Multiple) time.
446 Preferences>Picking
Parameters of Interactive Screen Picking
Enclose entire entity An entity is selected only if it is totally inside the selection rectangle or
polygon.
Enclose any portion of An entity is selected even if it is only partially inside the selection
entity rectangle or polygon.
Enclose centroid An entity is selected only if its centroid is inside the selection rectangle or
polygon.
Cycle picking form In entity picking mode:
lists the names of two or more entities that overlap at the place
the cursor is touching. You can then accept the highlighted
selection, or pick the entity you wanted to target.
lists all entities whose centroid lies near the point where the
cursor is touching.
Horizontal Select Menus If ON, the Select Menu (Picking Filters) will be horizontally placed.
Note that this is one of those parameters that will take effect only in the
next Patran work session.
Show Picking Icons If ON, the Select Menu will contain the icons to add, reject, and replace
a selection whenever a screen picking option is evoked.
Preselection Settings These options control the highlighting of entities prior to selection as the
cursor passes over them.
Label Highlighting If ON, entity labels will be highlighted along with the entities.
Entity Highlighting If ON, entities will be highlighted as the cursor passes over them.
Node/Point Marker Size Controls the size of the marker that is highlighted when the cursor passes
over a point or a node.
Preferences>Report 447
Formats of Numerical Entries in Analysis Result Reports
The Preferences>Report command controls the format of numerical entries in reports that output finite
element analysis results.
Parameter Description
Real Numbers
Floating Point Outputs result data in floating point format.
Scientific Notation Outputs result data in scientific notation format.
Field Width Selects the width of the numeric field. This size must accommodate all
digits and the decimal point. In scientific notation the field width takes
on the maximum value.
Number of Decimals Defines the number of decimal digits in a numerical entry. In scientific
notation format, this number defaults to the maximum value.
448 Preferences>Report
Formats of Numerical Entries in Analysis Result Reports
Integers Selects the number of integers the numerical entries may contain in the
tabular output.
Spacing Selects the number of spaces between numerical entries in the tabular
output.
Preferences>Geometry 449
Parameters for Representing Geometric Entities
With the Geometry Preferences options you can specify the way parameterized curves and surfaces are
represented in the database. These preferences apply to geometry imported from an external source, as well
as to geometry created in the Patran system.
Parameter Description
Exportable to Neutral File If ON, curves, surfaces, and solids will be created as parametric cubic
geometry.
Import to Parametrized Solid If ON (default), imports geometry to parametrized solid.
450 Preferences>Geometry
Parameters for Representing Geometric Entities
Solid Origin Location With the options in this category, you can select the method by which
left-handed parameterization created by some hyperpatch construct or
transform methods is changed to right-handed parameterization.
This selection is important only when you are running session files (see
Session File, 60), because the hyperpatch origin location must be set
according to whether the session file came from Patran or PATRAN 2.
Patran The origin location will be determined according to Patran convention.
PATRAN 2 The origin location will be determined according to PATRAN 2
convention.
Solid Property Assignment Default OFF. Controls the inheritance of property sets by new/modified
Inherit From Parent solid geometry created from existing solids. Whenever new solids are
created, this setting will be used to determine if property sets should be
assigned. The following rule will be applied for those solid creation
operations where existing solids are used. If the preference is On and the
original solid has a property set assigned, this property set will be assigned
to the new/modified solids. Otherwise, no property set will be assigned to
the new/modified solids. The following solid editing operations are
affected:Geometry/Edit/Solid/Break|Blend|Refit|Boolean|
EdgeBlend|Chamfer|Imprint|Shell
NURBS Accelerator If ON (default), NURBS (Non-Uniform Rational B-Spline) curves and
surfaces will be converted to piecewise polynomials without introducing
any approximations. This format accelerates evaluation of geometry and
provides increased performance.
Preferences>Geometry 451
Parameters for Representing Geometric Entities
Auto Update Solid If ON (default), the mesh, loads, and boundary conditions applied on a
Mesh/LBC solid model will automatically update after you performed a Boolean
operation or other editing applications, namely edge blend, imprint, or
shelling.
If you turn this parameter OFF, the update action becomes a selectable
item in the Geometry>Edit>Solid command dialog boxes for the above
editing functions.
Geometry Scale Factor Because the model unit of Parasolid geometry is meter, a scale factor is
applied to Patran geometric extents so that they can be expressed in the
appropriate Parasolid dimensions. The default scale factor is 39.37, the
equivalent of one meter in inches. Other possible scale factors are:
If you select Customize, an arbitrary scale factor must be entered into the
Geometry Scale Factor databox.
Several parameters are defined in the Preferences>FEM dialog box. They are described in the table below.
Preferences>Finite Element 453
Setting FEM Parameters
Parameter Description
Node/Edge Snap Angle Controls the angle that determines whether a node will snap to a vertex
where the slope of a composite edge changes. If the angle of the slope is
greater than the specified edge snap angle, a node will snap to the vertex
when you create a mesh seed or a mesh. If, however, the angle of the slope
is less than the snap angle, no node will snap to this vertex.
You may realize that you need to change the Node/Edge Snap Angle value
after you have created a mesh seed on a composite edge and discovered
that no control point was placed on the vertex. If it is important that a
node be located there, you can invoke the Preferences>FEM command
and change the Node/Edge Snap Angle so that it becomes less than the
slope angle. When you press the Apply button, the following will appear:
Select Yes and a mesh seed control point will snap to the vertex and the
mesh seed will be adjusted along the entire edge.
DFEM Field Equivalence Specifies which values of discrete FEM fields, that associate loads and
Options boundary conditions (LBCs) with nodes, will be associated with a node
that “survived” after coincident nodes have been equivalenced in the finite
element model.
454 Preferences>Finite Element
Setting FEM Parameters
Displace Presents various options for associating displacement values with the
surviving node.
Use Retained--use the value associated with the node retained after
equivalencing.
Add--use the sum of the values associated with each of the
equivalenced nodes.
Use Deleted--use the value associated with the node that was deleted
during the equivalencing process.
Vector Presents the same options for associating vector (e.g., force) values with
the node that survived the equivalencing process
Scalar Presents various options for associating scalar values (pressures and
temperatures) with the node that survived the equivalencing process.
In addition to those already seen for vector field values, the option exists
to use the average of the two scalar values associated to the equivalenced
nodes.
Preference Specific Verify Specifies whether analysis code specific element verification parameters
should be used in the Elements/Verify forms. Currently this value is on by
default for MSC Nastran and off by default for all other analysis codes.
Enable Pseudo Surface ASM Specifies whether pseudo-surface tool icons will be displayed on the Finite
Elements/Create/Mesh/Advanced Mesh form. The tools are used to
convert between tessellated surfaces and pseudo-surfaces, to stitch gaps in
pseudo-surfaces, and to edit pseudo-surfaces.
Geometry/FEM LBC These parameters affect how Geometry to FEM association is processed
Association for LBCs. Each of these settings is saved in the database and are restored
each time the database is opened.
Preferences>Finite Element 455
Setting FEM Parameters
Check Adjacent Geometry This checkbox specifies whether adjacent geometry is checked when
associating LBCs to FEM that were applied to Geometry. Patran always
uses the node to geometry association determined by the mesher to
associate LBCs to element faces and edges. When adjacent solids or
surfaces have overlapping or duplicate faces or edges, an element may be
associated to one piece of geometry but some of its nodes may be
associated to an adjacent geometry. When this check is turned on,
element nodes associated to the adjacent geometry are included in the
LBC evaluation.
By default, adjacent geometry checking is turned on. The user can change
the default value to off by placing the following in the settings.pcl
file:pref_env_set_logical("fem_geo_lbc_adj_geo_check", FALSE)
Connection Elements The maximum normal angle controls the Maximum and Normal Angel
between the surface patches of a connector. This value is used to
determine if the validity of a connector is suspect, since the elements onto
which the connector location was projected do not face in relatively the
same direction. For the PARTPAT or PROP formats, the wrong element
may be found, since a point can have multiple projections.
During a create or modify operation, angle checks are done, and upon
failure an attempt is made to find the correct elements that will satisfy the
angle check.
Preferences>Main Form 457
Controlling the Appearance of the Main Form
On Linux platforms, the Preferences>Main Form options enable you to change the layout and appearance
of the Main form. The changes will not take effect until you restart Patran
Close
Parameter Description
Add Latest History Line Adds latest history line to be written at top of history list (history lines
scroll down). Defaults ON and allows last history line to be viewed above
viewport in default orientation. If using history list to enter PCL
commands or debug PCL functions, you may want to turn this OFF.
Latest history line will be displayed at bottom of history window and will
scroll up.
Popup Applications Switch Causes application switch to be removed from Main form (allowing a
larger viewport) and displayed as a popup. As a default, this is mapped to
the right mouse button and can be activated by clicking almost anywhere
in a Patran form or in the history list on the Main form. This will not
activate with the cursor on the menu bar, the toolbar, on an icon or in a
select databox. Try several locations to see the best places for using this
option.
Small Screen Layout Causes initial orientation of Main form and viewport to fit better on a
small computer screen so that forms do not extend off the screen.
Save Visible History Line Allows any changes made during the current session to the vertical height
Count of the main form to be saved between sessions (Default is ON). If turned
OFF, the next session will startup ignoring any main form height changes
made during the present session.
458 Preferences>Main Form
Controlling the Appearance of the Main Form
Chapter 11: Tools
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
11 Tools
Menu Conventions
A menu item with ellipses (...) attached to it calls up an subordinate form to allow access to the functionality.
Other menu items have cascading items listed under them. Not all items are visible. What is presented to the
user from the Tools pull down menu is dependent on the Analysis Preference set and whether some items are
licensed and installed or not. The table below is a complete listing and explains when items are enabled.
Mass Properties... Calculates mass properties either of entire geometric and finite element
(p. 479) models or of their subregions. Displays graphic symbols related to mass
properties and outputs report files and summary spreadsheets.
Beam Library... Creates and manages dimensioned cross section shapes to be associated
(p. 493) with beam elements. Calculates section properties for any selected beam
cross section.
Regions... Creates named application regions for use in most places where
(p. 511) application regions (collections of entities) are required.
Modeling...(p. 516) This cascade menu item lists a number of utilities available for aiding in
the modeling process. These are listed below.
Design Study (p. 644) Creates and manages design study cases in which the functions necessary
Pre-process... for design optimization are defined. Also facilitates reading in and
Post-process... displaying results from topology optimization. These features are only
(p. 468)
available when the Analysis Preference is set to MSC Nastran.
Results... This cascade menu item lists a number of utilities available for aiding in
(p. 655) the post-processing of results data. These are listed below.
User Defined AOM... Allows for creating user defined “Action/Object/Method” forms for
(p. 713) customization purposes.
Pre Release Provides access to pre-release capabilities that have not yet been fully
(p. 714) validated.
Mass Property Tool to help engineers estimate the weight of a structure from its finite
Management... element model and to fine tune the model weight distribution by
(p. 556) specifying mass factors for the model to modify its weight, and then
adding quantities of element nonstructural mass based on the factors.
Assembly... MSC Nastran specific tools to reduce components down to equivalent
(p. 556) mass and stiffness matrices, specify configurations.
Experimental Data Fitting... Used to curve fit experimentally derived raw elastomeric material data
(p. 618) and fit a number of material models to the data and create material
models for use with the MSC Nastran and MSC.Marc Analysis
Preferences only.
Bolt Pre-load... Easily create simulated bolts with this tool for use in MSC Nastran and
(p. 621) MSC.Marc Analysis Preferences only.
Rotor Dynamics... A utility to help in the modeling of rotors for rotor dynamic analysis
(p. 633) when MSC Nastran is set as the Analysis Preference.
Rebar Definitions... A utility to help in the definition and modeling of rebar for the ABAQUS
(p. 635) and MSC.Marc Analysis Preferences only.
NSM Properties... Used to define non structural masses that can be applied as Lumped or
(p. 634) Distributed to elements or as part of property sets. This tool is MSC
Nastran preference specific.
Feature Recognition... Automatically and interactively recognize geometric features such as
(p. 638) holes, chamfers, and blend. Show, edit, and delete these features as
necessary.
Contact Bodies/Pairs... Functionality to create Deformable Bodies, Rigid Bodies, and Contact
(p. 640) Body Pairs.
Results Templates... Creates and manages templates that store collections of settings for
(p. 696) displaying, plotting and reporting analysis results.
Test Correlation... This is MSC.ProCOR, a tool for modal correlation between test data and
(p. 706) FE data (or FE & FE data).
NEF Random Vibration... This is utility for plotting input and output PSD and corresponding stress
(p. 707) transfer function from an MSC Nastran Embedded Fatigue (NEF)
analysis. Plotting of the spectral moments and PDF of rainflow ranges is
also supported with this utility.
Tools Commands
The following are detailed descriptions of the commands and dialog boxes that are referenced in the Tools
menu or references to the application documentation.
8. Tools>Laminate Modeler 465
9. Tools>Random Analysis 466
10. Tools>Analysis Manager 467
11. Tools>List 468
12. Tools>List>Create 470
13. Tools>List>Boolean 477
14. Tools>Mass Properties 479
15. Tools>Beam Library 493
16. Tools>Regions 511
17. Tools>Modeling 516
18. Tools>Modeling>Model Content 517
19. Tools>Modeling>Properties Import 521
20. Tools>Modeling>Load Tools 525
21. Tools>Modeling>Model Variables 540
22. Tools>Modeling>Element Quick Create 550
23. Tools>Modeling>Property Data Plots 552
24. Tools>Modeling>Mass Property Management 556
25. Tools>Modeling>Assembly>Configurations 574
26. Tools>Modeling>Assembly>Reduced Mass/Stiffness 587
27. Tools>Modeling>Assembly>Model Unmerge 612
28. Tools>Modeling>Experimental Data Fitting 618
29. Tools>Modeling>Bolt Pre-load 621
30. Tools>Modeling>Rotor Dynamics 633
31. Tools>Modeling>NSM Properties 634
32. Tools>Modeling>Rebar Definitions 635
33. Tools>Modeling>Feature Recognition 638
464 Patran Reference Manual
Tools Commands
Laminate Modeler
The MSC.Laminate Modeler application aids the design, analysis, and manufacture of laminated composite
structures. It integrates various methods of simulating the manufacturing process (including draping of
fabrics) with simplified, more efficient ways of storing and manipulating data required for the analysis of
composite materials. This selection appears only if a license is available.
MSC.Laminate Modeler is a Patran module for aiding the design, analysis, and manufacture of laminated
composite structures. The functions available within MSC.Laminate Modeler allow you to visualize the
manufacturing process and estimate the quantity of material involved. Representative analysis models of the
component can be produced very rapidly to allow effective layup optimization. Finally, a “ply book” and other
manufacturing data can be produced.
Selecting Laminate Modeler from the Tools menu activates the Laminate Modeler module if installed and
licensed. For more information, see the MSC Laminate Modeler User’s Guide
466 Tools>Random Analysis
Performing Random Analysis
Random Analysis
Random Analysis is a random analysis software package used with MSC Nastran and Patran. It was developed
to offer a fast, integrated random analysis solution and all of Random Analysis’ capabilities and generated
results are available from within the Patran environment. To use this capability a software license must be
available.
MSC.Random software technology is similar to the existing MSC Nastran random analysis capability. In
both packages, random analysis is treated as a data reduction procedure that is applied to frequency response
analysis, but with MSC Nastran, the output request for a random response can only be made through the
XYOUT module. This requires that you to prepare XYPLOT or XYPRINT entries for each degree of
freedom for nodal responses, and for each stress/force component for element responses. Even for a small size
model, you must prepare a large number of XYPLOT/XYPRINT entries. In addition, the results that are
calculated cannot be postprocessed from within Patran.
For more information on Random Analysis please see, Random Analysis (Ch. 13).
Tools>Analysis Manager 467
Managing Analysis Jobs
Analysis Manager
If installed and licensed, the Analysis Manager provides convenient and automatic submittal, monitoring,
control and general management of analysis jobs to local or remote networked systems. Primary benefits of
using the Analysis Manager are engineering productivity and efficient use of local and corporate network-
wide computing resources for finite element analysis.
The Analysis Manager has its own scheduling capability. If commercially available queueing software, such
as LSF (Load Sharing Facility) from Platform Computing Ltd. or NQS is available, then the Analysis
Manager can be configured to work closely with it.
Selecting Analysis Manager from the Tools menu activates the Analysis Manager module if licensed and
installed. For more information, see the Patran Reference Manual.
468 Tools>List
Entity List Operations
Lists
A list is a convenient way of referencing a number of entities for input in commands that accommodate
multiple entity selection. When you use a list, the listed entities are picked directly from the database, rather
than being cursor-selected in the graphics window.
Lists can be created of entities that either share some common attribute or are associated with a common
entity. For instance, an attribute-based list may contain elements that have the same material properties, while
an association-based list may be generated of nodes that are all located on the same edge.
An example where a list can be useful may be a finite element model in which you want to apply a nodal
displacement constraint to all nodes whose global x-coordinate is 2.0. Instead of picking a potentially large
number of nodes in the FEM application, you can first create a list to include the nodes that fit the attribute
criterion, then use the list for the constraint assignment.
Entity Types
Lists may contain either geometric or finite element entities.
Classification Methods
The criteria that determine an entity’s inclusion in a list may be attribute or association.
Attribute
The Attribute method identifies a distinctive characteristic that is shared by all members of the list. In the
FEM application, a list of elements may be based on common element properties, material properties, or
analysis results (fringe values), and for a node list you can specify coordinate values as well as fringe values.
For a geometry list, on the other hand, you must cursor-select entities or enter their IDs, because the list
generator does not recognize any attributes that are common for geometric entities.
Association
With this method you can list a number of entities that are associated with one common entity or group. For
example, you may specify that the list include those geometric entities, e.g., points, that are located at the
same vertex, or on the same edge or face. The list of FEM entities, such as nodes, may be based either on their
association with a geometric entity (e.g., vertex) or a group, or with an FE entity, for example an element edge.
Group Assignment
After you created a list, you can associate its members with an existing group or, alternately, assign them to a
newly created group.
Tools>List 469
Entity List Operations
Boolean Operations
You can create several lists and combine them, two at a time, into one comprehensive list, with one of the
Boolean operations:
Union--outputs a resultant list that contains all members of list A plus all members of list B.
Subtraction--outputs a resultant list obtained by subtracting the contents of one list from the
contents of another list.
Intersection--outputs a resultant list obtained by finding members that are common to both list A
and list B.
Using Lists
List names are entered enclosed in single quotes (‘), because the list names (lista, listb, and listc) are global
PCL string variables and require special delimiters so that the List Processor can recognize them.
470 Tools>List>Create
Creating Lists
With the List>Create dialog box you establish a “pick list” of entities. The criteria for inclusion in the list
may be a common attribute that the entities possess (e.g., elements that have the same material properties),
or the association of the listed entities with one common entity (e.g., elements that are on the same face).
Lists by Attributes
The nature of attributes that may be ascribed to entities depend primarily on whether they are geometric or
FEM entities.
Geometric Entities
For the purposes of lists, the only attribute of geometric entities is that they can be selected, either with the
cursor or by entering their names and ID numbers.
Tools>List>Create 471
Creating Lists
Parameter Description
Model Specifies the model definition, Geometry or FEM, that defines the type
of selectable objects.
Object Identifies the entity types to be include in the list. The entity
designations displayed when you press this button depend on the Model
type you selected.
Method Selects the criteria by which an entity’s inclusion in the list will be
determined (Attribute or Association).
Tools>List>Create 473
Creating Lists
Attribute Names the possible common attributes that determine which entities will
be included in the list.
In cylindrical and spherical coordinate frames the tolerance values will be in degrees.
Tolerance
Enter a value (or accept the default) that determines how close the actual coordinate value or fringe value
must be to the specified range values so that the entity will be included in a list. For example, if the node
474 Tools>List>Create
Creating Lists
fringe value attribute is temperature, and the range is specified as F> 300 and Tol= 5, the list will include all
nodes for which the actual temperature result value was 295 degrees or higher.
Properties
If you are creating a list based on Property Set (element properties) or Material attributes, the dialog box will
contain the “Existing Property Sets” or “Existing Materials” textbox with the names of previously defined
element property sets or material properties. Pick the property set or material of interest. When you press the
Apply button, the list will comprise all elements to which the selected properties or material is assigned.
A filtering mechanism helps you reduce a potentially long list by entering one or more letters of the name of
the desired property set.
Tools>List>Create 475
Creating Lists
Lists by Association
Association also depends on the nature of entities selected for the list. Geometric entities may be associated
with other geometric entities, whereas FEM entities may be associated either with other FEM entities (e.g.,
nodes associated with the same element) or with geometric entities (e.g., nodes associated with the same
edge).
Target List
The list assembled in the List>Create dialog box will be entered in a List A or an identical List B form. The
listed entities may now be saved in the database as a group, added to another group, input into a select
databox in an application dialog box, or highlighted on the screen.
476 Tools>List>Create
Creating Lists
Parameter Description
‘lista’ contents: Displays the list that resulted from the List>Create operation. The
contents of this textbox are not editable.
Add to Group Creates a new group for the listed entities or adds them to an existing
group.
Remove from Group Removes listed entities from a group.
Highlight Highlights listed entities on the screen.
Clear Removes all listed entities from the contents box.
Previous Restores the contents of the textbox to what it was before the current list
was applied.
Tools>List>Boolean 477
Boolean Operations on Lists
With the Tools>List>Boolean command sequence you can combine two lists into one, using Boolean
operations.
Union--outputs a resultant list that contains all members of list A plus all members of list B.
Subtraction--outputs a resultant list obtained by subtracting the contents of one list from the
contents of another list.
Intersection--outputs a resultant list obtained by finding members that are common to both list A
and list B.
478 Tools>List>Boolean
Boolean Operations on Lists
Parameter Description
‘listc’ Contents Displays the list that resulted from the Boolean operation.
Clear Removes all listed entities from the contents box.
Add to Group Creates a new group for the listed entities or adds them to an existing
group.
Remove from Group Removes listed entities from a group.
Replace A Transfers the contents of List C to List A.
Replace B Transfers the contents of List C to List B
Highlight Highlights listed entities on the screen.
Tools>Mass Properties 479
Calculating Mass Properties
Mass Properties
The Tools>Mass Properties application enables you to calculate the mass properties of two-or three-
dimensional geometric and finite element models. The calculations extend to entire models or any of their
subregions. For an overview of the theoretical background of mass properties calculations, see Summary of Mass
Properties, 916.
The following mass properties are calculated and, if applicable, their symbols displayed:
mass and volume
center of gravity (CG)
inertia tensor at the origin of the reference frame
inertia tensor and principal inertias at the CG
radii of gyration corresponding to the principal inertias at the CG
principal directions for the inertia tensor at the CG.
The principal directions at the center of gravity may be presented in three different forms:
Three orthogonal unit vectors.
A triad of space-fixed rotation angles γ, β, α that rotate a reference frame into the principal inertia
frame.
In space-fixed rotation the coordinate frame in which the rotation takes place remains fixed. The
rotation angles represent a 3-2-1 (Z-Y-X) sequence.
The principal frame is obtained by the following rotations:
about the Z-axis by γ degrees
• about the original Y-axis by β degrees
• about the original X-axis by α degrees.
The X axis of the principal inertia frame corresponds to the largest principal inertia, and the Y
axis, to the next largest.
A triad of body-fixed rotation angles ( γ, β, α ) in a 3-1-3 (Z-X-Z) sequence.
In body-fixed rotation the coordinate frame in which the rotation takes place moves with each
prescribed rotation.
The principal frame is obtained by the following rotations:
about the Z axis by γ degrees
about the newly positioned X axis by β degrees
• about the newly positioned Z axis by α degrees.
Where applicable, mass properties are calculated in both the reference Cartesian coordinate frame and in a
user-specified coordinate frame.
480 Tools>Mass Properties
Calculating Mass Properties
Output Options
For the results output of the mass properties calculations, you can request that Patran do one or all of the
following:
plot the principal axes at the center of gravity
create a coordinate frame aligned with the principal axes of inertia
write the results to a mass properties report file.
The principal axes are plotted in proportion to the magnitudes of the radii of gyration of the corresponding
principal inertias, as shown:
The newly created principal inertia coordinate frames will be assigned a coordinate frame ID that is the next
available in the database.
Report Files
Mass Properties report files are written in standard Patran report file format. In addition to mass properties
calculation results, these reports also list all included entities and all rejected entities.
Units
Mass properties are generated in units consistent with those used in the referenced geometry, element
properties, and material properties.
Weight Factors
Mass properties of shell elements are calculated by treating the thickness as a weighting factor and assuming
that all mass lies in the surface of the shell. Similarly, when calculating the mass properties of beam elements,
the cross-sectional area enters as a weighting factor with all mass assumed to lie in the locus of the one-
dimensional beam.
Consequently, mass properties calculated for these entities will be slightly different from those calculated for
corresponding 3D solids.
Three-dimensional Models
With this default option, you can calculate mass properties for all entity types (0D, 1D, 2D, and 3D).
482 Tools>Mass Properties
Calculating Mass Properties
Parameter Description
Dimension Selects the dimensionality of the analysis model. Models may be defined
as two-dimensional or three-dimensional.
Use Element Properties (default) applies the density specified for the
element material and the mass entered as element property.
1.0/0.0 overrides the defaults with a density value of 1.0 and a mass
value of 0.0.
Thicknesses/Areas/NSM Specifies additional element properties. For three-dimensional models
and 2D axisymmetric models you can use previously defined element
properties. For plane stress and plane strain models, however, thickness
and area default to 1.0 and non-structural mass defaults to 0.0.
Plot Principal Axes at CG Displays the principal axes at the center of gravity.
Create Principal Coordinate Creates a coordinate frame that is aligned with the principal axes of
Frame inertia.
Write to Report File Writes the calculation results to a formatted report file.
Mass Properties Display Redisplays the spreadsheet that contains the last calculated mass
properties.
Parameter Description
Region Specifies the region for which mass properties calculations will apply.
Include Specifies the type of entities that can be included in the selected region.
Inclusion options are:
For FEM entities, this spreadsheet will also contain additional columns to accommodate element properties,
such as element thickness, cross-sectional area, bar length, and property type. The N/A entry in a cell
indicates that the property is not applicable to that element (e.g., bar length for a plate element).
Tools>Mass Properties 489
Calculating Mass Properties
Parameter Description
Mass, CG, Principal Inertias, The first six columns are:
and Others
1. Center of gravity (CG) in the Cartesian coordinate frame
2. CG in a user-specified coordinate frame
3. Principal inertias at the CG in decreasing order
4. Corresponding radii of gyration
5. Mass
6. Volume.
Inertia Tensor Columns 1, 2, and 3 contain the inertia tensor in a user-specified
coordinate frame relative to the coordinate frame origin. The last three
columns contain the inertia tensor in the reference Cartesian frame
relative to its origin.
Inertia Tensor at CG The first three columns contain the inertia tensor at the center of gravity
in a user-specified coordinate frame. The last three columns contain the
inertia tensor at the CG in the reference Cartesian frame.
Principal Directions in User- Columns 1-3 - three mutually orthogonal principal direction unit
Specified Frame vectors at the CG, given in a user-specified coordinate frame in the
order of decreasing principal inertias;
Column 5 - triad of 3-2-1 space fixed angles (see also on Mass
Properties, 479) that rotate a user-specified coordinate frame into the
principal inertia frame at the CG;
Column 6 - the triad of 3-1-3 body-fixed angles (see also on Mass
Properties, 479) that rotate the user-specified frame into the principal
inertia frame at the CG.
Principal Directions in Ref. Columns 1-3 - three mutually orthogonal principal direction unit
Cartesian Frame vectors at the CG, given in the reference Cartesian frame in the order
of decreasing principal inertias;
Column 5 - triad of 3-2-1 space-fixed angles (see Mass Properties, 479)
that rotate the reference Cartesian frame into the principal inertia
frame at the CG;
Column 6 - triad of 3-1-3 body-fixed angles (see Mass Properties, 479)
that rotate the reference Cartesian frame into the principal inertia
frame at the CG.
3. Select the appropriate folder and enter a name for the report file. Be sure that the .rpt extension is
included.
4. Press Apply, and the right-hand side of the form will now become selectable.
5. Pick Mass Properties in the Report Contents list and press Apply. The report file will be written.
If you haven’t completed all input required for mass properties calculations, skip step 5, return to the Mass
Properties dialog box, perform whatever needs to be done. Press Apply to write the report.
Therefore, Steps 2-5 in the preceding discussion apply only if you have not yet generated a report file in the
current work session; the process will be slightly different if a report has been created already.
If you select the Write To Report File toggle in the Mass Properties dialog box and the Report File form does
not appear, that is an indication that a report file is already running even though the report form may be
hidden (removed from the screen with the Cancel button). If you now request that another set of data be
written to a report, the new information will be automatically appended to the already open report file.
To create a new report file (and close the one that is open), select File>Report and the Report File form will
be redisplayed. Follow steps 3-5 for creating a new report file.
You can find and read your report files in the Notepad application.
Center of Gravity
Center of Gravity coordinates are presented in Cartesian, as well as in a user-defined coordinate frame.
Inertia Tensor at CG
These inertia tensor components, in both the Cartesian and a user-defined coordinate frame, are given at the
center of gravity.
Rotation Angles
Space-fixed and body-fixed rotational angles (see Mass Properties, 479) are given in the Cartesian as well as in
a user-defined coordinate frame.
Beam Library
Beam elements can be defined with a variety of cross sections. The beam library offers a number of standard
shapes as well as a means of defining your own “arbitrary” cross sections. In either case, you can request that
the dimensioned profile and its calculated section properties be shown after you have entered all required
dimensions or point coordinates. Optionally, you can also output a report file that contains all boundary
information.
Standard Shapes
Industry standard beam cross sections are presented in a tabular form; after you select an item, the enlarged
shape and its required dimensions will be displayed.
Standard-shaped cross sections may be constant or vary along the length of the beam. To create variable
sections, you must use one or more spatial fields for dimensions, as well as provide a location for evaluation
along the length of the beam. This may be defined either with XYZ coordinates or with a parametric
function.
494 Tools>Beam Library
Using the Beam Library
Arbitrary Shapes
In addition to standard cross-sectional profiles, you can also create your own specific non-standard beam cross
sections by generating arbitrary boundary contours. A boundary must be a closed loop that consists of
straight line segments. The cross section may contain holes; these are generated by adding inner boundaries
to the shape definition. Because the first loop defines the outer boundary, all subsequent loops must be
located within the area enclosed by the first loop.
To define the cross section, you can
enter a series of input point coordinates
select a surface whose outline will be approximated by the boundary
provide a file from which the point coordinates may be selected.
Using a Surface
The arbitrary cross section is created by tracing the outline of an existing surface. The surface may be a
trimmed surface but not with any degenerated edges or duplicate edges. A number of points are sampled on
the surface boundary and their coordinates are placed in the spreadsheet. If the surface contains mesh seeds,
the points are sampled at the seeds.
Reading a File
The boundary is drawn utilizing points whose coordinates are contained in a file. To be able to read the data
and generate the profile, the format of the referenced file must be the same as the format of a Report File that
captures the point data of a manually created cross section.
Parameter Description
Action Creates, modifies, or deletes a beam cross section shape.
Object Selects Standard or Arbitrary for the shape definition.
Method Regardless of the analysis preference, you can only select standard shapes
supported by MSC Nastran or MSC.Dytran.
Existing Sections Lists the names of previously defined beam cross sections.
New Section Name Specifies the name of the new beam cross section.
496 Tools>Beam Library
Using the Beam Library
Shape Symbols Shows the standard shape symbols. To browse through all the shapes,
press one of the arrows and the next (or previous) panel will be displayed.
For a standard cross section, select one of the profiles. Its outline and
required dimensions will appear on the right side of the form. Fill in all
dimensions.
Spatial Scalar Fields Lists the name of existing spatial fields that you may apply for one or
more dimensions if the cross section varies along the length of the beam.
Calculate/Display Displays the dimensioned cross section along with calculated section
properties and symbols.
Write to Report File Outputs section properties to a formatted report file.
Parameter Description
Spatial Scalar Fields Lists the name of existing spatial fields that you may
apply for one or more dimensions if the cross
section varies along the length of the beam. To
enter the field value, first click in the dimension
databox then pick the field name.
Location Specification Options:
Select an Entity and a Parametric Location (C1) Evaluates the variable dimension at a parametric
location of the beam. Move the slider to the
appropriate position between End A (0.000) and
End B (1.000).
Specify an XYZ Coordinate Specify an XYZ Coordinate
498 Tools>Beam Library
Using the Beam Library
Select a Beam or Curve Identifies the beam element, curve, or edge along
which the cross section varies. Click in the textbox
or and select the entity or enter its ID.
Coordinate If you picked the Specify an XYZ Coordinate
option, the textbox heading changes to Coordinate.
Enter the coordinates of the location where the
cross section is to be evaluated.
Parameter Description
Option Shows the available methods for creating arbitrary profiles:
Loop Shows the number of the loop that you are generating. Loop 1 is the
outer loop, any subsequent loops are inner loops that define holes in the
profile. Up to eight loops may be created.
Insert Row/ To insert a new row of data into the spreadsheet, select the row below
where the new row will be placed and press Insert Row. The row above it
Delete Row will become available for data input.
To delete a row from the spreadsheet, select the row and click the Delete
Row button.
Clear Boundary Deletes all input from the spreadsheet.
Display Boundary Draws the boundary loops. Loop points are numbered according to the
spreadsheet input.
Rotate/ Angle Rotates the points on all loops about point 1 of the outer loop by the
angle you enter in the Angle databox.
5. Continue entering points to define the loop. The maximum number of points you can specify in a
loop is 150. When you press Calculate/Display to create the section, the loop will be automatically
closed even if the last point you entered does not coincide with the first.
6. To create a hole in the cross section, press the up arrow to begin Loop 2. The spreadsheet headings
will be X Inner and Y Inner.
7. Continue entering hole boundaries as desired.
The endpoint coordinates of the line segments will be recorded in the spreadsheet as the boundary input
points. For a closer approximation--and a larger number of points--decrease the value of the curvature error.
Once the data has been entered, there is no further connection between the surface and the section,
consequently you can edit the point coordinates as desired (e.g., round them up or down).
Tools>Beam Library 501
Using the Beam Library
If the reference surface lies in the global XY, YZ, or XZ plane, the orientation of its boundary loops will be
defined in Coordinate Frame 0. If it is not in any principal plane, a temporary plane and coordinate frame
will be created as the edge points are recorded.
The two numbers in each line of the boundary loops data represent the X and Y coordinates of a point, these
will be entered into the spreadsheet. A blank line ends the loop. If there are several loops, each is delimited
by blank lines.
The “Stress Recovery Points” heading is followed by a line with up to four numbers that identify the stress
recovery points. The numbers correspond to the boundary loop points as they appear in the point list starting
with the first line (1) and not counting blank lines.
4. Continue assigning additional points; points C through F can be selected. To eliminate a stress
recovery point, select None and the cell will be cleared. If you assign a label to a point and that label
is already in use, you will be asked if you wish to overwrite, or redefine, the stress recovery point.
5. When you press Calculate/Display, the profile will be drawn and the stress recovery points will be
labeled with the appropriate letters.
Parameter Description
Option Displays the only available option: Input Branches.
Input Data Textbox where you enter X and Y coordinates.
Branch Displays a spreadsheet for branch information. Branches are numbered
consecutively.
X X coordinates of the beginning and end points.
Y Y coordinates of the beginning and end points.
Thickness Beginning and ending thickness for each branch.
dx/ds Beginning and ending slope in the X direction.
dy/ds Beginning and ending slope in the Y direction.
#Divs Number of divisions for each branch.
Insert Branch/ To insert a new branch into the spreadsheet, select the branch below
where the new branch will be placed and press Insert Branch. The branch
Delete Branch above it will become available for data input.
To delete a branch from the spreadsheet, select the branch and click the
Delete Branch button.
504 Tools>Beam Library
Using the Beam Library
Note: You can define arbitrary sections with the Centerline method, press the Display
Boundary button, and then change the Method to Boundary Loops. The arbitrary
shape from the centerline definition is also stored as boundary loop data. At this point,
if you press the Apply button, the beam section will be stored as Boundary Loop
arbitrary section as opposed to centerline data. Thus the centerline data can be used
directly in an MSC.Marc or MSC Nastran analysis, or can be converted to boundary
loops and used in other analysis code including MSC.Marc if property values are
accepted and input.
X Y t
1b 0 0 1
1e 10 0 2
2b 10 0 0
2e 5 0 0
3b 5 0 3
3e 5 10 1
The second example is a D section with curvature. The X, Y, dx/ds, dy/ds and thickness values are tabularized
at the side of the plot. Two branches are defined. The slopes of the first branch are opposite each other, thus
indicating to the program a curvature for this branch. The D section looks bad when using the default
curvature error. If you reduce this to say, 0.02 instead of the default 0.05, the D section looks much better as
shown below.
506 Tools>Beam Library
Using the Beam Library
X Y t dx dy
1b 0 0 0.1 1 0
1e 0 1 0.1 -1 0
2b 0 1 0.1 0 -1
2e 0 0 0.1 0 -1
Tools>Beam Library 507
Using the Beam Library
Parameter Description
Existing Sections Lists existing cross sections. Select the one you want to change.
Rename Section As Displays textbox for entering a new name.
Section Symbols Shows cross section symbols. Pick the section you want to use to replace
the existing one.
Section Dimensions Displays existing dimensions. Edit dimensions as desired.
Spatial Scalar Fields Lists existing fields. To associate a dimension with a field, click in the
dimension databox then pick the field name.
Location Specification Modifies the location where the field value will be evaluated. Enter new
Options coordinates, or select a new curve or beam element and move the slider
to define a new parametric location.
Parameter Description
Existing Sections Lists existing beam cross sections. Pick the section(s) you want to delete.
Sections to Delete Displays the name of the cross section(s) you selected for deletion.
Apply Deletes the selected cross section(s) and remains in the Beam Library
application
Cancel Cancels the delete action and exits the Beam Library application.
Tools>Regions 511
Define Named Application Regions
Named Regions
Named Regions are collections of entities that can be used as application regions for Loads and Boundary
Conditions as well as Element Properties. They are general like Groups, but differ in that they are not used
for display purposed and are restricted (like Application Regions) in that they can only contain one topology
type (1D, 2D, 3D). Some Applications, such as CATIA import, will automatically create these named
Regions making them a convenient way to define LBC or Element Property application regions.
Unlike Groups, where the entire entity must be in the group, Named Regions can be defined with only
portions of the entity defined such as the faces of a solid element or the edges of solid geometric entities.
Once a named Region is created it can be used on the Select Application Region form of a Load and
Boundary Condition or Element Property Set and in other select areas of Patran.
Tools>Regions 513
Define Named Application Regions
3D Entity Select
Edge
2D Entity Select
Select
1D Entity Select Face Select
Model Contents
This is a simple utility to allow you to view the contents of a database. It is limited to finite element data and
gives information on the following entities (any entities not listed are not supported in this utility):
• Groups
• Coordinate Frames
• Load Cases
• Properties
• Fields
• Loads/BCs
• Materials
• Result Cases
• Elements / Nodes / MPCs
The Model Contents tool creates a spreadsheet summary at three levels of resolution. The lowest level of
resolution is displayed in the main summary shown below. At this level, only the number of entities of a
particular type are displayed. A more refined summary is obtained by selecting any one of the main category
buttons or any one of the cells in the spreadsheet where the contents of each group are summarized.
518 Tools>Modeling>Model Content
Viewing Model Contents
The general contents of the current database are summarized into different categories. A detailed listing of all
of the contents of any category may be obtained by selecting the button associated with that category. Then
another form displays giving an expanded summary.
If changes to the model are made while this form is visible it may be necessary to press the Update button in
order for the changes to be reflected in the form.
All data can be written to a file by clicking on the Write to File button. The data is written to a file called
smdl_modelstat.txt in the current working directory. This issues the following PCL command, which
only works properly when Patran is run in graphics mode (not batch) as it exercises the PCL form widgets
themselves, which are not active in batch mode.
smdl_modelstat.dump_model_info(val)
The input argument, “val” is set to TRUE when issued by this utility. If it is set to FALSE, the file will not
be written but the data will be dumped to the command line window and in the currently recording session
file. Note that there can be significant performance issues if you do this with a very large model and is not
recommended.
Groups
If the user selects a cell in the group summary contents spreadsheet under the column labeled Elements, then
a subordinate form is displayed. The format of the element summary depends on whether the Shape or Type
toggle is set in the main form. If a summary by Type is requested, then any MSC Nastran element type not
supported by the current Analysis Preference is listed as Other. If a cell in the group element summary form
is selected, a form is displayed giving a listing of all the element IDs for a particular element type or shape.
The user also has the ability to highlight the elements contained in the list box in the current graphics
viewport.
If the user selects a cell in the group summary contents spreadsheet under the column labeled Nodes, then a
form is displayed giving a listing of all the node IDs contained in the group. The user may either highlight
or un-highlight the nodes in the current graphics viewport. Similarly, selecting a cell in the column labeled
MPCs results in a similar form being displayed. To obtain a listing of the specific MPC IDs associated with
a given type, select any cell that has a nonzero count. Any MPC not recognized by the current Analysis
Preference will be listed as Unknown/Not Valid.
Properties Summary
If the Properties button is selected, then a form is displayed giving a detailed summary of all of the property
types contained in the model. The summary includes the property name as well as the property type. Any
property type not currently supported by current Analysis Preference will be classified as Other.
Material Summary
If the Materials button is selected, then a form is displayed giving a detailed summary of all of the material
types contained in the model. The summary includes the material name as well as the type. Any material type
not currently supported by current Analysis Preference will be classified as Other.
Tools>Modeling>Model Content 519
Viewing Model Contents
Field Summary
If the Fields button is selected, then a form is displayed giving a detailed summary of all of the Patran fields
contained in the model. The summary includes the field name as well as the type.
520 Tools>Modeling>Model Content
Viewing Model Contents
Loadcase Summary
If the Load Cases button is selected, then a form is displayed giving a detailed summary of all of the load cases
contained in the model. The summary includes the load case name only. The contents of any load case can
be accessed by selecting the Load Cases application radio button located of the Patran main form or under
the Loads/BCs tab if running Patran with a GUI skin other than the classic mode.
LBC Summary
If the LBCs button is selected, then a form is displayed giving a detailed summary of all of the LBC types
contained in the model. The summary includes the LBC name, the type, as well as whether or not the LBC
is static or dynamic (i.e. time dependent). Any LBC type not currently supported by Patran will be omitted.
Any association to Load Cases is not accessible through the summary. Rather it may be obtained by selecting
the Load Cases application as explained above for loadcase summary.
Properties Import
To use the Properties Import feature you will need to create and select an input file. You will need to decide
how element properties will be named if new element properties are made.
Creation of a Property
The creation of a property requires all of the following fields. If one these fields (columns) is defined, all must
be defined, or an error will be issued. These fields are only used when creating new properties. Note that all
field headers and the data that follows on subsequent lines must be separated by the semi-colon ";" delimiter.
The last column must end with a ";" or it will not be recognized.
continued...
Modification of a Property
If you want to modify a property, you will need to create a text file similar to the following:
PNAME ; 13 6 APPRGN
$Prop name Material Bar orientation Element list
bar ; ;1, 0, 1.0 ;
shell ; M:Alum ; ;E 1:10
The above example modifies the property “bar” to change the “bar orientation” to <1,0,1.0> and the property
“shell” to have the material “Alum” and an appregion of Elements 1 through 10.
The 2D shell data would show up as if the following session file had been played.
The easiest way to find the ELTYPEID thru the DOFOPTID data is by looking at the session file. The
session file above corresponds to the input file above. Also, the IDs of the words for the data “m:STEEL” and
for the thickness “0.33” can also be derived from the same session file. The data you have entered is found in
the first and third arguments of the data array. The IDs for those pieces of data can be found highlighted in
the ID array below.
Tools>Modeling>Properties Import 523
Importing Properties
$ comment
PNAME ; 4061
PROP_BAR ;RL0.,0.8,1.
$ comment
$ Creation of Beam Property
EID ; 13 ; 1 ; 10 ; 11 ; 6
101 ; m:STEEL ; 1.1 ; 10.1 ; 1.1 ;RV<1,0,1.1>
102 ; m:STEEL ; 1.1 ; 10.1 ; 1.1 ;RV<1,0,1.2>
The above example assumes that elements 101 and 102 are already associated to an element property. The
code then "expands" the element property for the elements, and modifies those expanded properties to
change the properties 13, 1, 10, 11 and 6. (Which are Material, Area, I11, 122 and Bar Orientation).
Example 1
$ This File Modifies an existing Property
$ Regular 2D Shell, modifies the Matl and thickness.
PNAME ; 13 ; 36
aaa ; m:mat2 ; 0.31
$
524 Tools>Modeling>Properties Import
Importing Properties
Example 2
$ This file Creates a New Property
$ If element 4 is already associated, it removes the previous
$ association.
ELTYPEID ; GEOOPTID ; CONOPTID ; FOROPTID ; LAMOPTID ; DOFOPTID ; EID
; 13 ; 36
51 ; 25 ; 35 ; 1 ; 1 ; 20 ; 4
; m:mat1 ; 0.01
Example 3
$ This file changes element 4 to have a thickness of 0.08 and a
$ mat of steel2
$ Elem ; material ; thickness
EID ; 13 ; 36
4 ; m:steel2 ; 0.08
Example 4
$ This file Creates a New Property
$ The elements from the APPRGN Column are assigned to the new
property
ELTYPEID ; GEOOPTID ; CONOPTID ; FOROPTID ; LAMOPTID ; DOFOPTID ; 13 ; 36 ;
APPRGN ; PNAME
51 ; 25 ; 35 ; 1 ; 1 ; 20 ; m:mat1 ; 0.01 ; E
1:15:2 ; imported
The abbreviations for the datatypes are listed below:
Load Tools
The Loads Tools utility allows users to create either Running Loads plots or perform Load Summations. The
Actions are grouped as follows:
Create (Region, Region Chain and Force)
Modify (Region or Region Chain)
Delete (Region or Region Chain)
Plot - Running Loads (LBCs, Load Cases, or Results)
Plot - Load Summation (LBCs, Load Cases, or Results)
Creation of Running Loads plots and Load Summations requires the identification of a section of the model
over which the plot is to be created. This section can be described using a Region, Region Chain or on-the-
fly through interactive node and element selection.
For example, visualizing resultant loads along the bending axis of a wing can be very helpful for verifying that
the correct loads have been applied to a model..
Load Summation provides a convenient method of summing the applied vehicle loads about a spatial
location.
Both Running Loads and Load Summation support the following kinds of external loads:
Forces and Moments
Pressure
Inertia
Distributed Edge Loads
Presently, load summation excludes any of the following load types:
Inertial loads
Pressures applied to the faces of 3D elements
Edge pressures applied to 2D elements
Distributed loads applied to either 1D or 2D elements
526 Tools>Modeling>Load Tools
Using Load Tools
The following picture illustrates the methodology behind the Running Load plots., often referred to as
SBMT (Shear, Bending, Moment, Torque) plots.
Chained region 1
Z’ Chained region 2
Y’
Z’’ Y’’
5 10
15 20
X’ 25 X’’ 25
30 20
15
10
0 5
-5
Fuel_Mx
30
Moment
Plotted together by
20 component, for this example
10
0 10 20 30 40 50 60
X Location
Note: The groups used to define a Region must contain the FEM node/elements of interest for the Running Loads
plots and should only contain FEM entities (no geometric entities). The application regions of the selected loads
(or loads in selected load cases) for a Running Loads plot and the Regions should have the same entities. If these
rules are not followed, the plots may be difficult to interpret as some loads may be ignored in the calculation and
the user may be unaware. Two or more Regions can be chained
together and referenced as a Region Chain. A Region Chain can describe Regions with a discontinuity at their
intersections (i.e. two Regions that follow a wing spar break). Region Chains can be referenced in Running
Load plots.
To create a Region Chain over which to calculate Running Loads or do load Summation you must do the
following with the Action/Object set to Create/Region Chain.
1. Supply a new Region Chain Name in the data box.
2. Select the Existing Regions in the order in which they are to be plotted. You can always use the Clear
Selection button to remove the selected Regions from the Chained Regions list box and start over.
Loads from a Chained Region are calculated from the maximum X of the last region in the chain back to the
minimum X of the first region in the chain. Loads from regions further out on the chain are added to regions
further in on the chain at the maximum X after they are transformed to the designated coordinate system.
Use the Modify and Delete Actions to modify or delete existing Regions and Region Chains.
LoadCases
For Running Loads plots follow the same sequence as for LBCs above. The only difference is that you select
Load Cases is step 3 above as opposed to LBCs. All applicable LBCs in the Load Cases will be used in the
Running Loads plot.
Tools>Modeling>Load Tools 529
Using Load Tools
Results
For Running Loads plots follow the same sequence as for LBCs above. The only difference is that you select
Results Cases and corresponding Nodal Vector Results is step 3 above as opposed to LBCs. The Results will
be integrated over the Selected Entities, Region or Region Chain to product a Running Loads plot.
Load Summation
To do a Load Summation, set the Action to Plot and the corresponding Method. The form layout is set up
so that the user sets up the plot in a logical order from the top of the form to the bottom. Several subforms
are also used to define the parameters of the plots to be generated. There is the optional choice of writing this
information to a report file.
After identifying that a Load Summation is desired, the model’s nodes and elements must be identified either
by membership to a Region or Selected Entities or the Entire Model. Follow these instructions for calculating
Running Loads from LBCs, Load Cases, or Results quantities:
LBCs
1. Set the Target to either Selected Entities the Entire Model or pre-defined Regions.
2. Select the entities, or pre-defined Regions if not summing over the entire model.
3. Select the LBCs that will be used in calculating the load summation. Be sure to select LBCs that are
defined on the selected entities or Regions, otherwise they will be ignored. One or more
Loads/Boundary Conditions can be summed over the model or selected entities.
4. Set any Options... required. Please see the Plot Options section below that describes these options.
This option enables the user to produce more refined load summations. The coordinate system in
which the load summation is displayed is set under this option. Default is the global Coord 0.
5. Select a Reference Point about which to perform the Load Summation. This can be a finite element
node, a geometric grid point, or another other allowed definition of a point via the select mechanism.
The point is to be selected graphically from the graphics window or you can type in something like
Node 5 or Point 3 or an actual point in space such as [1.0 2.5 -3.2].
6. Press the Apply button to do the load summation. A spreadsheet will appear with the summary of
each selected load and their components. You may optionally save this data to a report file by clicking
on the Save button once the spreadsheet is displayed.
LoadCases
For Load Summation follow the same sequence as for LBCs above. The only difference is that you select Load
Cases is step 3 above as opposed to LBCs. All applicable LBCs in the Load Cases will be used in the Load
Summation and the component results displayed for each selected Load Case.
Results
For Load Summation follow the same sequence as for LBCs above. The only difference is that you select
Results Cases and corresponding Nodal Vector Results is step 3 above as opposed to LBCs. All selected
Results will be used in the Load Summation and the component results displayed for each selected Results
Case.
530 Tools>Modeling>Load Tools
Using Load Tools
Plot Options
The following table explains the options on the Plot Options subordinate form for a Running Loads Plots
and Load Summations. This subform is accessed from the Running Loads main form and controls the
appearance of the XY plot (as well as the status of previously created plots) and load summations. Not all
widgets appear for both Running Loads and Load Summation. Only those that appear on the form are
applicable for the selected option.
Load Components These are the components that are reported in the Running
Load plot or Load Summation spreadsheet. By default, these
are all ON.
Pressure to Load Algorithm A default algorithm is used to convert pressures to concentrated
loads or users may supply their own algorithms. See Pressure to
Load Algorithm below this table. This routine is called anytime
a pressure load needs to be converted to nodal forces. The se-
lected LBC must be of type pressure or the Load Case must
contain LBCs of type pressure. For Results, only nodal results
are allowed, so in this case, this routine is ignored.
Evaluation Points Number of evaluation points for each Region for a Running
Loads Plot. The default is 10 points.
Integration Axis Range Minimum Value and Maximum Value are active when option
“Integration Axis Range” is Manual; otherwise, these are greyed
out for Auto.
Multiple Curves Plotted Multiple curves can be Individually plotted to separate XY win-
dows, plotted Together by Load/Set, plotted Together by Com-
ponent or all plotted on one XY plot.
Previously Created Curves Previously created Running Load plots can be left "As Is" or au-
tomatically deleted (Remove All).
Coordinate System Defines the coordinate system in which to display the load
summation.
Sum Loads For: Changes the load summation to the opposite side requested.
Restore Default Values Restores all widgets to their default values.
The PCL library .plb file containing the user created PCL function for pressure conversion must then be
read into Patran using the !!LIBRARY command. See the PCL and Customization for details on creating PCL
functions and loading PCL libraries. Finally, the pressure conversion algorithm must be registered on the
form using the following PCL function.
load_tools_pressure_register.register_alg ( new_alg_name )
Register a new algorithm for element pressure to nodal forces conversions.
Input:
STRING[] new_alg_name Algorithm name to be added to the user algorithm list. This
string must include the classname and function name if de-
fined within a class, e.g.: classname.function.
Output:
None.
Regions
The first item to be defined is the region. The region consists of finite elements and a reference coordinate
system (see figure below)
Reference
z Coord Aft
Z’ System Inboard
Outboard
Y’ Forward
y
X’
x
Global
Coord
System
SBMT Region
All data reported on a Running Loads plot for this region is given in terms of the reference coordinate system.
The region covers a certain range of the reference coordinate system. This range is from the minimum X axis
value in the reference coordinate system of the FEM nodes in the region to the maximum X axis value in the
reference coordinate system of the FEM nodes in the region.
Region Chains
Region Chains may be defined. The Region Chain consists of an ordered list of regions. These regions should
be adjacent and attached pieces of structure for a Running Loads plot to give realistic results. There are no
checks in that prevents Region Chains from containing unattached pieces of structure.
X’’’ Y’’’
number is the same for all of the regions. Loads applied to the model that lie within the X-axis region of the
specified coordinate system(s) are included in the running loads plot.
Planes / Evaluation points
for chained region 2
Planes / Evaluation points Chained
for chained region 1 Region 2
N
Chained . .
Region 2 . = Load point
.
5
3 4
2 = Evaluation point
1
The equations used to sum the loads together for an evaluation point are as follows.
For the reporting of region locations on the plots, the first region is plotted using its x coordinates directly.
The next chained region is included by adding their X value onto the end of this, with the origin of the second
system locating its value in the first coordinate system.
For example, a first chained region is defined from X’=5 to X’=32, and the second chained region covers X’’=-
3 to X’’=23. The origin of the second chained region is located at X’=29 in the first coordinate system. Data
from the first chained region occupies the graph from x=5 to x=32, and the second chained region is plotted
over x=26 to x=51.
It is very likely that two adjacent regions contain identical nodes. Therefore, the code checks to see if regions
next to each other in a chain contain identical nodes and place forces attached to those nodes only in the
region appearing first in the list. This prevents double counting of the forces applied to these nodes. This
check is only done for adjacent regions in a chain. No check is done for duplicate elements, therefore pressures
applied to elements present in more than one region in an chain is summed twice in the running load
calculation.
Tools>Modeling>Load Tools 535
Using Load Tools
Z
Y
1 X
Z Z
Y Region 1 Y Region 2
X X
Z
Y
2 X
X
Z 3 Y
Z Z
Y Region 3 Y Region 4
X X
• Select the group or groups that are to make up the Region being defined.
• When the groups are selected, the elements that are part of the region are highlighted on the
model. Check to make sure that the correct elements are highlighted.
• Press the OK button to accept the region definition.
3. Select the coordinate system to define the integration axis.
4. Press the Apply button to create the Region. For this example, this procedure must be done for all
three regions.
Condition--Component--Region:
SBMT Plot for Regions: load case 1--Fz--inner wing
inner wing, outer wing, winglet load case 1--Fz--outer wing
load case 1--Fz--winglet
0.
-15000.
-30000.
Force
-45000.
-60000.
-75000.
-90000.
-2.34 10.0 22.5 34.9 47.4 59.8 72.3
X Location (Integration Axis)
538 Tools>Modeling>Load Tools
Using Load Tools
Mx dx
My = Fx Fy Fz × dy
Mz dz
For pressure loads, the equivalent nodal loads must be calculated. The first step is to transform the element
face to a local coordinate system whose normal, the vector w , is defined by the cross product of a vector from
node1 to node 2, the vector u , of the face and a vector from node 1 to node 4,
1-2
ux v x
uy = v y 1-2
uz 1-2
v z
and
.
wx ux
w y = v 1-4 x v 1-4 y v 1-4 z × u y
wz uz
The second local direction, the vector v , is defined by taking the cross product of w and u ,
vx ux
vy = wx wy wz × uy
vz uz
Tools>Modeling>Load Tools 539
Using Load Tools
The transformation matrix, λ , is created from the direction cosines between the local system and the global
system. The nodal coordinates are then multiplied by the transformation matrix.
The pressure load, like the displacements in an isoparametric finite element, is defined anywhere in the
element (or on the element face for 3D elements) by
n
q(u, v) = qi ψi
i=1
where
q(u, v) = the spatial distribution of the pressure load in the local element coordinate system.
q i = the pressures at the nodes
M N
q = q(ξ, η) dξ dη ≅ q(ξ I, η J)det(J)W I W J
ΩR I = 1J = 1
where
ξ, η = the element’s parametric coordinates.
q(ξ, η) = the pressure distribution in the element’s parametric coordinate system.
det(J) = the determinate of the Jacobian.
q(ξ I, η J) = the pressure at the integration points ξ I, η J .
Model Variables
Model variables provide the foundation for design studies. They are the parameters, or properties, whose
magnitude will be modified in the process of performing iterative solutions. A variable may be a dimension
value, an element property (e.g., plate thickness), or a material property. This is a generic utility for defining
model variable. Any variables created using this module are generally available under the Design Study
module. Design variable can also be defined under the Design Study module and may prove more convenient
to only use that module. Variables are only used with design optimization and therefor only accessible when
the Analysis Preference is set to MSC Nastran.
Values as Variables
Parameter Description
Action Lists the action that can be performed. In addition to creating new
variables, you can also show (verify), modify, and delete existing variables.
Existing Variables Displays the names of previously defined variables.
Variable Name Names the new variable. The unique name may be a letter, a symbol, or
a text string, up to 32 characters long.
Description Provides a space where you can describe the nature of the variable. This
optional entry is especially helpful if you used an abbreviation or symbol
for the name of the variable and may not remember in the future what the
intent was (for example, which dimension was designated as “L1”?).
Analysis Value Shows the initial value of the variable. Enter a real, scalar number.
Create Referencing Field If ON, creates a field for the model variable.
542 Tools>Modeling>Model Variables
Defining Model Variables
Parameter Description
Existing Variables Displays the names of previously defined variables.
Variable Name Names the new variable. The unique name may be a letter, a symbol, or
a text string, up to 32 characters long.
Description Provides a space where you can describe the nature of the variable. If no
description is entered, Patran will create a description; it specifies the
names of the Property Set and Property Name from which the variable
was created.
Tools>Modeling>Model Variables 543
Defining Model Variables
Analysis Value Shows the initial value of the variable. Enter a real, scalar number.
Dimension These two entries act together as a filter that facilitates finding the
element property that will be designated as the variable. The search will
Type be limited to the properties associated with those elements for which the
named dimensionality and type apply.
Select Property Set Lists the names of the Property Sets defined for the designated element
type. Pick the set that contains the property you wish to parameterize.
Select Psets by Elements Selects a Property Set associated with an element you pick on the screen
(this can be helpful if you do not remember the pairing of property sets
and elements).
Select Property Name Displays a specific property contained in the named Property Set.
544 Tools>Modeling>Model Variables
Defining Model Variables
Parameter Description
Existing Variables Displays the names of previously defined variables.
Variable Name Names the new variable. The unique name may be a letter, a symbol, or
a text string, up to 32 characters long.
Description Provides a space where you can describe the nature of the variable. If no
description is entered, Patran will create a description; it will identify the
name of the element property set and specific element property (e.g.,
Thickness) from which the variable was created.
Tools>Modeling>Model Variables 545
Defining Model Variables
Analysis Value Shows the initial value of the variable. Enter a real, scalar number.
Type This entry acts as a filter that facilitates finding the beam section for
which the variable is applied. The beam library will be searched for the
specified beam cross section type.
Select Beam Section Lists the names of previously defined beam cross sections. Pick the one
that contains the property you wish to parameterize.
Select Beams by Elements Selects a beam cross section associated with an element you pick on the
screen (this can be helpful if several beam elements exist each with their
own cross sections and you do not remember which name goes with
which element).
Select Beam Dimension Lists all dimensions pertaining to the named beam section. Select a beam
dimension which will become the variable.
546 Tools>Modeling>Model Variables
Defining Model Variables
Parameter Description
Existing Variables Displays the names of previously defined variables.
Variable Name Names the new variable. The unique name may be a letter, a symbol, or
a text string, up to 32 characters long.
Description Provides a space where you can describe the nature of the variable. If no
description is entered, Patran will create a description; it will identify the
name of the material property set and specific element property (e.g.,
Density) from which the variable was created.
Tools>Modeling>Model Variables 547
Defining Model Variables
Analysis Value Shows the initial value of the variable. Enter a real, scalar number.
Category This entry acts as a filter that facilitates finding the property that will be
designated as the variable. The search will be limited to the material to
which the category type applies (e.g., Isotropic).
Select Material Lists the names of previously defined materials. Pick the material that
contains the property you wish to parameterize.
Select Materials by Elements Selects a material associated with an element you pick on the screen (this
can be helpful if you do not remember which material goes with which
element).
Select Property Name Selects a specific property contained in the named material definition.
Also enters its current value into the Analysis Value textbox.
Parameter Description
Select Variables to Show Displays all previously defined variables. Pick one or several to show in
detail.
Select by Elements Selects the properties associated with elements you pick on the screen.
After you picked the variable(s) you want to verify, press Apply and the variable information will be displayed
in a spreadsheet.
548 Tools>Modeling>Model Variables
Defining Model Variables
Pick any of the properties and its description will appear in the lower left corner of the spreadsheet.
Parameter Description
Select Variable to Modify Lists all variables contained in the database. Pick the variable you want to
modify.
Variable Name Displays the name you selected. This name cannot be changed.
Tools>Modeling>Model Variables 549
Defining Model Variables
Description Displays the original description that you can edit or replace.
Modified Value Enter the new value you want to assign to the variable. All field values and
relationships that depend on the value of this parameter will be updated
when the new value is applied.
Parameter Description
Select Variables to Delete Lists all variables contained in the database. Pick one or more variables
that you want to delete.
Select by Elements Select an element whose property is a variable that you want to delete.
Apply/Close Pick Apply to complete the deletion. Pick Close to cancel the delete
action and exit from the application.
550 Tools>Modeling>Element Quick Create
Creating Elements Quickly
Note: Element property values cannot be deleted or modified using the Quick Create functionality.
Quick Create can only reference previously created element properties.
Tools>Modeling>Element Quick Create 551
Creating Elements Quickly
Elements
To assign an existing Element Property set to any newly created elements, select a property using the
Existing... button. If the Show Properties toggle is set ON, when an existing element property set is selected,
the appropriate Input Data form is presented. Element property values may not be altered. After the Element
Property set is selected, the Quick Create form is updated to reflect the currently selected property set. If a
property is not selected for automatic assignment to created elements, the main form displays Property: None
Selected. If elements are created and no existing Element Property set is identified for automatic assignment,
then the elements are simply created without reference to any Element Property set.
Properties
This Object provides access to create Element Properties without having to access the Element Properties
application. Simply supply a Property Name, set the Dimension, Type, and other options as necessary. Open
the Input Properties form and input the data. Then press the Apply button. Unlike the Element Properties
application, no application region is provided. Only the property set and its data are created.
552 Tools>Modeling>Property Data Plots
Plotting Property Data
Select the target window the curves are placed in. The user
may select from the existing XY plot windows or type in a new
name to create a new XY plot window.
the field are the same ones used by Patran to evaluate Fields, as a result the interpolation methods specified
for the Field are used to evaluate that Field.
Limitations
1. Bar and beam properties, as defined using the Beam Section capabilities, are not supported.
Specifically, if the beam "Dimensions" option is used to derive the properties on-the-fly, these may
not be plotted. If, however, the beam "Properties" option is used to calculate beam properties from a
section definition, then these properties may be displayed. (If the beam properties are grayed out on
the Element Property - Input Data form, they may not be used for Property Data Plots.)
2. Material properties are not supported.
3. Derived properties are not supported.
Example Of Usage
Visualizing the properties of elements verses a spacial variable can be helpful in verifying the simulation
model. This section gives an example of the usage of the properties vs. location plotting capabilities. This
example uses a simplified wing model to illustrate the use of the property XY plotting application.
The following figure shows the simplified wing model that was used for this example. This model has varying
thicknesses for the plate elements that make up the wing.
Mass Factors Enter the Mass Factors in the Mass Factors scroll frame. For each mass factor,
select the Enter Value option and enter the value of the factor in the databox. The
Parameter List option is available only if the Mass Properties function has been
customized by the user (see Mass Properties Customization and Mass Factor
Customization sections). The date and time the factor was entered and recorded
automatically.
Apply Select Apply to create the Mass Properties Region.
Tools>Modeling>Mass Property Management 559
Mass Property Management
The date and time the factor was changed are recorded automatically. The Mass
Properties Region description cannot be changed.
Description Modify description if desired.
Apply Select Apply to modify the Mass Properties Region.
Regions that have overlapping properties will cause problems and mass factors
will not be applied in this case. Ensure that all regions have unique groups
(elements) associated with them.
If you delete a region after applying factors, delete the mass factors and reapply
them. The same applies if you add new mass property regions.
If an associated property already has NSM defined, you will be asked for overwrite
permission.
560 Tools>Modeling>Mass Property Management
Mass Property Management
Parameter Description
Mass Properties Set the Action to Apply and Object to Mass Factors.
If desired, turn on the toggle Elements Must Have Factors in the Application
Options: frame.
Parameter Description
Mass Properties Set the Action to Delete and Object to Mass Factors.
Apply Press Apply to delete the Mass Factors.
Parameter Description
Mass Properties Set the Action to Delete and Object to Mass Prop Region.
Mass Properties Select the Mass Properties Region which is to be deleted.
Region
Accept Press Apply to delete the Mass Properties Region.
Requirements
Before using the Mass Properties Management function, the finite elements to which mass factors are applied
must be grouped into regions that share factors. Use the Groups functionality to do this. Material density for
all elements with factors must also be defined in the Materials application when defining materials associated
to the elements.
Before customizing the Mass Properties Management function, the user must program forms and algorithms
for parameter lists. A separate function is required for each type of mass factor. See below for more
information.
Example of Usage
The following example illustrates the basic usage of the Mass Properties Management function. Figure 11-1
represents a section of a wing structure, that is constructed utilizing three spars. The elements of the wing
have been grouped based on the structural components modeled. This example concentrates on spar number
3 (Figure 11-2 and Figure 11-3), that has been grouped as spar3. The spar has been further broken down into
upper and lower spar caps (Figure 11-4), grouped as spar3.capu and spar3.capl, a spar web (Figure 11-5),
grouped as spar3.web, and the effective portions of the upper and lower skins (Figure 11-6), grouped as
spar3.skinu and spar3.skinl. The remaining spars are similarly grouped.
The goal of this example is to apply mass factors to these groups.
562 Tools>Modeling>Mass Property Management
Mass Property Management
5. For each mass factor type, select the Enter Value option and enter the value of the factor in the
databoxes in the Mass Factors scroll frame. The date and time the factor was entered are recorded
automatically.
6. Press Apply to create the spar3.capu Mass Properties Region.
7. Repeat steps 3 through 6 to create four more Mass Properties Regions from the remaining groups of
spar3 (spar3.capl, spar3.web, spar3.skinl and spar3.skinu).
8. Write out an analysis input deck to see the NSM applied to the model. You may also view the NSM
per element in the spatial FEM field called NSM_mass_field in the Fields application.
class so they can be displayed as available means of assigning factors. This class is also used to get the current
status of available factor lists and the factor values themselves.
To start the data transfer process, two calls to the registry class are made when the Algorithm Class is
initialized, one to register the name and class of the algorithm, and the other to register the types of factors
available for that algorithm.
INIT:
Alg name, - register
alg class algorithm name
register_alg: and class
- Place alg name,
alg class name
give_alg_names:
RC.give_alg_names - obtain list of
. algs in class
Done. variable
Alg list,
num of algs
Alg name
RC.give_lst_names. give_lst_names:
. - Find class for
. alg in registry
. exec_func(AC,
. give_lists) give_lists:
. . - get latest list
. . of instances from
. . user data
. . - Register lists
. . Alg name, RC.register_lst
. . latest
. . lists,
. .
. List of lists,
. num of lists
Alg name,
List instance,
Factor type
RC.give_factor give_factor:
. - Find alg in
. registry
. - Finds class AC in
. registry
. - Place instance in
. class variable send_factors:
. exec_func(AC, - obtain instance
. send_factors)
List instance RC.give_param_list
. . - obtain factors
. . for instance
. . - send factors to
. . registry
. . Factor array,
. . datemark
. .
. .
. .
.
. Factor
Done.
CLASS CLASSNAME
/*
* The algorithm data management class handles all work
* involved in storing and retrieving data associated with
* an algorithm and its associated parameter lists. It:
* - registers its availability and associated factor
* types in a registry class
* - interacts with the GUI used to set up the parameter
* lists to store and retrieve list instances
* - calculates and stores mass factors at the request of
* the mass region, via a "registry class"
* - gives a list of available parameter lists, at the
* request of the mass region via a "registry class"
* - provides mass factors as requested
Tools>Modeling>Mass Property Management 569
Mass Property Management
*/
FUNCTION init()
/*
* Purpose:
* - Register algorithm in registry class:
* - Register types of factors in registry class
* - Create user data templates, if they don’t exist
*
* Input:
* (none)
* Output:
* (none)
*
* Side Effects:
* - Lets mass region GUI know that a new algorithm is
* available, and will thus appear on the list of available
* algorithms.
* - Sets up templates for later data storage
*
* External Dependencies:
* Need user data functions to store data
* Need registry class to keep track of available
* algorithms.
*
* General Description:
* To be called in the init.pcl when starting up PATRAN,
* or any other customized PATRAN initialization
*/
REGISTER_CLASSNAME.register_alg( @
/* algorithm name STRING */ algorithm_name, @
/* current class name STRING */ CLASSNAME_QUOTED)
REGISTER_CLASSNAME.register_asg( @
/* algorithm name STRING */ algorithm_name,@
/* factor types STRING ARRAY */ fact_types,@
/* number factor types INTEGER */ num_types)
FUNCTION delete_data
END FUNCTION /* delete_data */
FUNCTION get_data
END FUNCTION /* get_data */
FUNCTION calculate_factors ()
/*
* Purpose:
* - Needed only if it is necessary to be able to
* initiate factor calculation from the mass region
* form.
* - Calculate massproperty factors
* - Store factors in the parameter list used to
* calculate them
570 Tools>Modeling>Mass Property Management
Mass Property Management
*
* Input:
* (none)
* Output:
* (none)
*
* Side Effects:
* - Modifies parameter list instance
*
* External Dependencies:
* - Called by mass region class
* - Calls routine in mass region class to get current
* instance
*
* General Description:
* The calc factors function is called by the Mass Properties
* region when a factor is needed, using
* ui_exec_function(smdl_algname,"calculate_factors").
* It calls back to the Mass Properties region to get the
* name of the instance for which the factor is to be
* calculated, and then calls the algorithm to calculate
* the factors. It stores the factors in the parameter
* list once they are calculated.
*/
smdl_mass_region.give_current_instance(current_instance)
/*
* Calculate factors using whatever functions are needed.
* This can be done here or another call can be made.
*/
/*
* Store factors in the parameter list. As with
* calculation, this can be done here or in another
* function, e.g. the calculation function.
*
* The class that calls this function can then get the
* factor through the registry class and the send_factor
* function in this class.
*/
FUNCTION send_factor ()
/*
* Purpose:
* - Provide Mass Properties factors to registry class
*
* Input:
* (none)
*
* Output:
* (none)
*
* Side Effects:
* (none)
*
* External Dependencies:
* Called by registry class. Uses functions in that class:
* give_param_list -- gets instance name for which factors
* are needed
* receive_factors -- sends factors back to registry class
*
* General Description:
* Factors will be given to the Mass Properties region
* via a call to the registry function. The mass region
Tools>Modeling>Mass Property Management 571
Mass Property Management
REGISTER_CLASSNAME.give_param_list(instance)
/*
* from the specified instance, get the factors
*/
ud_get_instance(template,instance,r_data,s_data)
factor=r_data
date=s_data(n)
REGISTER_CLASSNAME.receive_factors(factor_array,date)
FUNCTION give_lists ()
/*
* Purpose:
* - Provide to registry class a list of available instances
* for algorithm
*
* Input:
* (none)
*
* Output:
* (none)
*
* Side Effects:
* - Registers list of parameter list instances
*
* External Dependencies:
* Called by registry class
*
* General Description:
* This function gets a list of the current instances and
* registers it in the registry class. It is called by
* the registry class when a request is made to it for
* a list.
*/
ud_get_all_instances(template, list, num)
REGISTER_CLASSNAME.register_lst(algname, list, num)
END FUNCTION/* give_lists*/
END CLASS /* smdl_algname */
$ Output:
/* Number of mass factors */ INTEGER num_props
/* Names of the mass factors */ STRING names[]()
$
$ Side Effects:
$
$ External Dependencies:
$
$ General Description:
$
$ Notes:
$ Mass factor names must be 32 characters or fewer
$
INTEGER retval = 0
RETURN retval
END FUNCTION
Tools>Modeling>Mass Property Management 573
Mass Property Management
Select Algorithm
Available Algorithms
Available parameter list algorithms, read
from a registry of algorithms.
sheet_metal_part
machined_part
cast_part
Ok Select List
Assignment Type
Ok
574 Tools>Modeling>Assembly>Configurations
Configurations
Tools>Modeling>Assembly>Configurations Configurations
Configurations
Overview
The Assembly and Configuration module is used during analysis to manipulate parts of a structure into new
positions without changing the original model. This can be used to analyze any structure with moving
components, such as an aircraft with control surfaces or an actuated arm on a back-hoe. The transformations
are performed automatically when a job is submitted and the results are viewed on the undeformed model.
Procedure
1. Set the Action to Create and Object to Configurations
2. Define the configuration from: the group to be transformed, the load cases to be moved with it, and
how the transformation is to take place. Any intermediate structure MUST be a subset of the group
being transformed. Give it a name and select Apply. Repeat until you have created all the
configurations you need for your job.
3. From the Configurations form, set the Action to Associate and Object to Configurations
4. Link the configurations you have defined to the load cases by selecting the load case and then the
configurations associated with it. Use the switch labeled Configure Automatically to turn on and off
automatic manipulation of the model during job submittal. If the switch is disabled, a type of check
run is performed where all the appropriate subcases are formed, but none of the defined
configurations occur. Only one analysis job is submitted for this check run versus one for each
configuration if the switch is enabled. Select Apply to save the configuration to load case link and the
setting of the Configure Automatically switch.
5. Configuration of the model is performed on a copy of the database when the job is submitted. The
results are read back into the baseline model (initial configuration).
circumstances. In addition, element properties of intermediate structure do not get rotated along with
the elements, so property definitions for the intermediate elements should be valid for any position
in the rotation plane. For example, when bar properties are defined, the vector used to orient the beam
should be parallel to the rotation axis.
4. Geometry in the intermediate structure is not reconnected along with the FEM. This makes the
model look different than what you would expect when you watch it move during an interactive
submittal, but does not affect the finite element run.
5. You must have the switch Configure Automatically toggled ON (from the Associate Configuration
action and object) for the configuration to be performed automatically.
6. The module does not currently have a capability to perform chained rotations, i.e. transformations of
parts of larger pieces that are themselves transformed. Examples of this would be a trim tab on an
airplane flap or a claw on the end of a rotating arm.
7. Loads and boundary conditions on rotating components MUST be carefully applied. LBCs applied
to the finite element mesh are correctly transformed. LBCs applied to the geometry, that is not part
of the transformed group, is not properly applied to the transformed finite element mesh. In addition,
the LBC set name used for the loads on the component must be unique so that it does not get
renamed during the merge.
8. Currently, the capability does NOT exist to preview the transformation. If you want to check the
transformation, you need to submit the job and watch it take place, or create a new model from the
MSC Nastran results file.
Technical Operation
When you submit a job through SuperModel (action Submit on the Analysis form), the configuration
module looks at the load cases for any associated configurations. Based on the configurations, a job is created
for the different combinations of configurations. For example, if you submit an analysis of an airplane with
the following subcases (load cases) and the listed associated configurations:
gear_down gear_down
Component Transformation
The configuration module performs component transformation using the Group Transformation
functionality in Patran. The module uses settings in this function to delete the original group and use original
entity ID’s where possible, and also transforms the Element Properties. You are given the option to copy or
transform Loads and Boundary Condition sets along with the group, as well as the opportunity to specify
those specific load sets that is affected. However, this is currently only valid for vector-type loads, such as
forces and moments.
Configuration Synchronization
If you have PCL functions to integrate with the configuration process, they must be registered. An example
of this would be a function to check the load balance on a model before and after transformation, and to
apply a corrective load to maintain the balance. Functions can be called both immediately before and after
the configuration. The following call is used to register those functions:
Function
Function called to register a function for execution. Execution will be performed via a ui_exec_function(user_class_name,
user_func_name)
Input:
STRING[] when When to execute function (BEFORE or AFTER)
STRING[] user_class_name Class in which to execute function
STRING[] user_func_name Function to execute
Output:
INTEGER <Return Value> Zero for success, nonzero for error
Because information cannot be passed when the configuration class calls your function, you must call back
to it to get information about the transformation. The following function can be used to get that information.
Tools>Modeling>Assembly>Configurations 577
Configurations
Input:
None.
Output:
STRING[] config_name Name of configuration
STRING[] group Group being transformed
STRING[] method Method used for transformation (POSITION or ROTATE)
STRING[] params Parameters for transformation
STRING[]() load_sets Load sets involved in transform
INTEGER num_load_sets Number of load sets
STRING[] lbc_movement How LBCs are moved (COPY or TRANSFORM)
STRING[]() load_cases Load cases being analyzed (add any corrective LBCs to these)
INTEGER num_load_cases Number of load cases
INTEGER <Return Value> Zero for success, nonzero for error
In the routine from which you call this function, you should include the file jobdef_appstrings.p and
declare your arguments as follows:
STRING config_name[MAX_CONFIG_NAME_LEN]
STRING group[MAX_GROUP_NAME_LEN]
STRING method[VIRTUAL]
STRING params[VIRTUAL](TRANSFORM_PARAMS)
STRING load_sets[MAX_LBC_NAME_LEN](VIRTUAL)
INTEGER num_load_sets
STRING lbc_movment[MAX_MOVE_LEN]
STRING load_cases[load case_LEN]
If the jobdef_appstrings.p include file is not available, the following values may be used:
MAX_CONFIG_NAME_LEN 32
MAX_GROUP_NAME_LEN 32
TRANSFORM_PARAMS 6
MAX_LBC_NAME_LEN 32
MAX_MOVE_LEN 9
LOADCASE_LEN 80
578 Tools>Modeling>Assembly>Configurations
Configurations
For the intermediate structure to be reconnected after the configuration, select a group containing elements
connecting the transformed group to the rest of the structure. The intermediate structure MUST be a
subgroup of the target group being transformed, and also MUST be a single element connecting the
Tools>Modeling>Assembly>Configurations 579
Configurations
transformed structure to the parent structure. Properties for the element do not get transformed, therefore,
make sure that the property definition is either non-directional or is defined in such a way that it is still correct
after the transformation takes place. With bars, this can be done by making the vector used to define the bar
orientation parallel to the rotation axis.
The information defined for each transformation technique correlates to that required for the Patran
Group/Transform.
580 Tools>Modeling>Assembly>Configurations
Configurations
Deleting a Configuration
The following form is used to delete an existing configuration.
Tools>Modeling>Assembly>Configurations 581
Configurations
Example
Figure 11-11 shows an example on how to rotate the flap structure attached to the wingbox on the right side
of the model. The flap will be rotated down 10 degrees about the hinge line axis defined by points (85, 80,
0) and (100, 80, 0).
If you submit the job interactively, you will be able to see the model transform to reflect the analyzed
configuration model for evaluation. Answers for the configured model are read back into the original database
(initial configuration). If you want to view the reconfigured model, you must create a new model by reading
the results and model information from the results file into an empty database.
586 Tools>Modeling>Assembly>Configurations
Configurations
Reduced Mass/Stiffness
Assembly and configuration tools are commonly utilized in aerospace. Design studies often focus on changes
to a single component (i.e., aircraft wing) while the remaining components retain a constant design (e.g., the
fuselage, vertical tail, etc.). Each design study requires a structural analysis or analyses to understand the effect
of the changes. Depending on model sizes and computing costs, a high penalty on throughput and costs can
be realized by analyzing structure that does not change between design studies. To increase throughput and
potentially decrease computing costs, users may employ the reduced stiffness and mass modeling technology.
Reduced stiffness and mass modeling can substantially decrease model analysis time by reducing the total
number of degrees of freedom. Reduced stiffness and mass models created from one or more components can
be used during analysis as a boundary condition to the attached structure. For example, a stiffness matrix can
be generated for an aircraft fuselage and subsequent design studies and re-analysis of the wing model can use
this reduced model as the boundary condition at its root and eliminate the need and time necessary to
redundantly analyze the fuselage structure.
Use of the reduced stiffness and mass models is similar to the MSC Nastran Superelement technology, but
more simplified. Less bookkeeping is associated with its use; however results cannot be recovered from
elements in the reduced structure.
A reduced stiffness matrix (RSM) represents the stiffness matrix of a component at degrees of freedom
specified by the user, and a reduced mass matrix (RMM) performs the same function for mass information.
A set of user interface forms allow for the creation and inclusion of reduced stiffness and mass models in an
analysis. The actual RSM/RMM data is stored in physical files, named by the user. These RSM/RMM files
use (by default) the MSC Nastran OUTPUT4 format. However, the OP2 and DMIG file format is also
supported. A new entity is created and stored in the model database; its definition contains all of the
information needed to create and include RSM/RMM in subsequent models.
A reduced stiffness or mass matrix definition consists of an ordered list of degrees of freedom that are
contained in the stiffness/mass matrix, the filename containing the matrix, the type of matrix (stiffness or
mass), and the degrees of freedom map.
When a new RSM is created, Patran creates a model file, with the extension .gnl, and a companion file with
the extension .gnl.def.
RSM Procedure
This section discusses the procedure of first creating an RSM and then its subsequent usage. Brief references
to user interface forms are made, which are described in the following section. A detailed example follows the
user interface discussion.
The following picture is used to describe RSM creation and usage.
588 Tools>Modeling>Assembly>Reduced Mass/Stiffness
Reduced Mass/Stiffness
The figure above can be used to discuss several key points with respect to RSM creation and usage.
Nodes 1-4 are always fixed. These are not required to be included in the boundary description of the
RSM; rather, the user must verify that the proper elements attached to these nodes are included.
Additionally, the clamped boundary condition must be included in the RSM “analysis” job to
permanently constrain these nodes.
Warning: While permanent constraints are supported, these are not always recommended as node
constraints such as rigid bars and multi-point constraints can introduce singularities into the stiffness
matrix. The most safe modeling technique is a “free-free” structure where nodes 1-4 are included in
the RSM boundary description and the clamped boundary condition is applied when the RSM is
included in an analysis with the adjacent structure. For more information on inclusion of boundary
conditions on a free-free structure, please see note 4 below.
Nodes 9 - 11 must be included in the RSM boundary description. The user is asked to define the
degrees-of-freedom to be used at each node; typically this is all 6 DOF’s.
Nodes 15 - 17 have an applied load condition. These nodes must also be included in the RSM
boundary description. Typically all 6 DOF’s at each node are included. Multiple load conditions are
supported and must be included in the analysis where the RSM is attached to the adjacent structure.
Nodes 5 - 9 have an applied, variable boundary condition. Therefore, these nodes must be included
in the RSM description. Typically all 6 DOF’s at each node are included. Multiple boundary
conditions are referenced in the subsequent analysis where the RSM is attached to the adjacent
structure. If a “static” boundary condition is also present (like the clamped condition shown above),
the boundary condition for each analysis would include both the clamped and variable condition, as
shown above.
Nodes 12 - 14 are not required to be included in the RSM boundary definition.
To create an RSM requires three steps:
Tools>Modeling>Assembly>Reduced Mass/Stiffness 589
Reduced Mass/Stiffness
1. Create an RSM definition. All new RSMs are “manually” created and are of type “Write”.
2. Activate (queue-up) an RSM definition. Only one RSM may be activated.
3. Submit an analysis job. The queued RSM is automatically included in the analysis job, resulting in
the creation of an RSM. An actual analysis is not submitted as Patran automatically detects the
presence of an activated RSM and take appropriate actions.
Note: If multiple RSMs are to be created from an original database, steps 1 - 3 must be repeated for
each RSM. Step 1 can be performed for each RSM prior to the remaining steps. Steps 2 and 3
must be performed once for each RSM.
To create an RSM definition from a finite element model, as shown above, use the
following procedures.
1. Create a “manual”, type “Write” RSM.
2. Identify the boundary nodes in any order, along with their associated DOF’s.
3. Specify whether the stiffness or stiffness and mass representation is to be created.
4. Identify a file name where the RSM data is to be stored.
To activate an RSM definition, or queue an RSM definition for a subsequent analysis job, use the following
procedures.
1. Activate an RSM by selecting it from the list of RSMs. This queues the RSM definition to be included
in the next analysis job, creating an RSM.
2. Only one RSM may be activated (queued) for creating in the analysis step.
To create an RSM from an RSM definition, use the following procedures.
1. Go to the Patran Analysis form. The action must be Analyze.
2. If a permanent boundary condition is to be included, select the appropriate Load Case. Only one
Load Case may be submitted for “analysis”.
3. If the RSM is to be created from a portion of a larger finite element model, select the appropriate
groups for analysis. For example, make the RSM Group current and then use the “Current Group”
option.
4. Submit the analysis. Three physical files are created and stored under the single logical file name
defined during the RSM definition phase.
To use an RSM in an analysis requires four steps:
1. Load the RSM into the opened adjacent structure database. Use the “From File” Method. An RSM
definition should only be loaded into one “adjacent structure” database; multiple references results in
an error condition.
2. Activate (queue-up) one or more RSM definitions.
3. Apply any required load and boundary condition definitions.
590 Tools>Modeling>Assembly>Reduced Mass/Stiffness
Reduced Mass/Stiffness
4. Submit the analysis job. This analysis may include multiple defined configurations, in addition to
multiple RSMs.
To load an RSM definition, use the following procedures.
1. Create an RSM Definition in the adjacent structure database by using the Method “From File”.
2. Select the appropriate RSM entry in from the proper directory. The RSM definition file
(rsm_name.gnl.def) is selected.
3. Specify any required rotations about the global coordinate system axes. These rotations are required
to be in 90 degree increments.
4. Press the Apply button to load the RSM definition. The following items should be noted:
• Patran automatically detects the RSM attach points in the adjacent structure based on the user-
defined tolerance. If the adjacent structure attach points have associated analysis coordinate
systems that are in conflict with the incoming RSM. The RSM analysis coordinate systems
overrides the adjacent structure definitions.
• If nodes are not present in the adjacent structure database where the RSM connection points are
located, they are automatically created.
To activate an RSM definition, use the following procedures.
1. Set the RSM menu Action to Activate.
2. Select one or more RSM definitions that have been previously loaded into the adjacent structure
database. Please note the following:
• Not all loaded RSM definitions must be activated.
• Multiple “adjacent structure” databases may exist, each with activated RSMs.
• Activating one or more RSMs in an adjacent structure database queues these up for inclusion in
the next analysis job that contains the adjacent structure database.
To apply load and boundary conditions to RSMs, use the following procedures.
1. After the RSMs are either defined or activated in the adjacent structure database, the previously
identified boundary nodes are present. The node numbers are most likely be different than when first
defined because they are identified by spatial location and not physical node number.
2. Create load and boundary conditions definitions on the boundary nodes, as is customary in a standard
Patran modeling session. The associated Load Cases must be identified during analysis job submittal.
To use one or more RSMs in an analysis, use the following procedures.
1. Go to the Patran Analysis form. The Analysis Action must be Analze.
2. Select the appropriate Load Cases.
3. Submit the analysis. Any activated RSMs in the submodels included in the analysis are used.
Recall from the above discussion, the most common method to first create an RSM definition is using the
Method “Manual” and Type “Write”. If this has been previously done, and for some reason the RSM
definition file (rsm_name.gnl.def) does not exist, reconstruct the RSM definition. Use the following
procedure when “manually” creating an RSM definition by using the option Type = “Read”.
Tools>Modeling>Assembly>Reduced Mass/Stiffness 591
Reduced Mass/Stiffness
1. Set the RSM action to Create, Object to RSM Definition and Method to Manual.
2. Set the Type to Read.
3. Select the boundary nodes in sorted (ascending) order. Recall the selection order when creating an
RSM Definition using Type = “Write” was not important. The order is important after the RSM
exists because MSC Nastran sorts the nodes in ascending order prior to creation of the RSM file and
RSM Definition file.
4. For each selected node, identify the DOF’s used in the original RSM definition.
5. Note that the analysis coordinate systems at each node must also correspond to those from the original
definition.
6. Select the original RSM file (rsm_name.gnl).
7. Create the RSM definition.
The user interface to the functionality described above is described in the following pages.
Note: When the RSM Type is set to Write (create a new stiffness/mass matrix), the order of the list
of degrees of freedom and the mapping of the degrees of freedom is ignored (MSC Nastran
ASET cards are not order dependent). The order of the RSM/RMM created by MSC Nastran
are in increasing node ID, based on the matched nodes at the defined spatial locations.
If an RSM definition file is lost, but the associated RSM file is present, the definition file can be reconstructed.
The following shows the Create/RSM/Manual form using the RSM Type Read.
Tools>Modeling>Assembly>Reduced Mass/Stiffness 593
Reduced Mass/Stiffness
Note: When the RSM Type is set to Read, the degrees of freedom order and mapping are used to
determine the MSC Nastran DMIG card sequencing. The selected nodes must exactly match
the ascending order of the originally selected boundary nodes. Additionally, the associated
nodal DOF’s and analysis coordinate system must exactly match the original definitions.
The following form is used to define the DOF list associated with a RSM and appears when the DOF List
Definition button on the Create (and Modify) form is selected.
594 Tools>Modeling>Assembly>Reduced Mass/Stiffness
Reduced Mass/Stiffness
The following form appears when the Select Output (or Input) File button on the Create/RSM/Manual form
is selected. This form is used to select the input or output matrix filename for the RSM definition. The
RSM/RMM OP4 file by convention should have a .gnl extension. When entering a name for the
RSM/RMM input file the .gnl extension should be added by the user.
To use one or more RSMs in an analysis, they must be included in an “adjacent structure” database. The
method to include these previously constructed RSMs is described. Set the Action to Create, Object to RSM
Definition and Method to From File. Any new nodes and coordinate systems needed for the RSM definition
is automatically generated. The Create/From File form appears as follows:
Tools>Modeling>Assembly>Reduced Mass/Stiffness 595
Reduced Mass/Stiffness
A file browser form appears when the Select RSM Definition File button on the Create/RSM/From File form
is selected.
596 Tools>Modeling>Assembly>Reduced Mass/Stiffness
Reduced Mass/Stiffness
After the model has been created, the RSM must be created. This is done from the Create/RSM form.
To create an RSM:
1. Enter the RSM name fuselage in the RSM name box.
2. Select the Write toggle for the RSM Type.
3. Press the DOF List Definition button.
• Select all of the DOF toggles.
• Select the DOF coordinate system (Coord 0)
• Select the nodes 1:11, 12, 23, 27, 34,38,39,43,44,48 to be added to the RSM definition. For the
Write RSM Type the order that the nodes appear in the list is ignored.
• Press the Display Current List button and check that the correct locations have been selected. The
model should look like Figure 11-14.
• Press the OK button to accept the DOF list.
Tools>Modeling>Assembly>Reduced Mass/Stiffness 605
Reduced Mass/Stiffness
4. Select the Stiffness Only toggle. If a dynamic analysis is to be performed, a mass representation is also
required.
5. Press the Select Output File button.
• Input the name fuselage.gnl for the file to contain the RSM/RMM data. (In general this
filename should have an .gnl extension.)
• Press the OK button to accept this filename.
6. Press the Apply button. This defines the RSM.
After the RSM has been created, it must be selected from the Activate RSM form for use in an analysis run.
To select the RSM definition:
1. Press the Change Current Activation button to open the MSC Nastran Activation subform.
2. Set the Activation Type to Write RSM.
3. Select the RSM fuselage from the list box.
4. Select the Options button.
5. Select the matrice to write as well as the format of the matrices.
6. Press OK to make selections and close the Options Subform.
7. Press OK to make selections for Write RSM to Create and close the form.
606 Tools>Modeling>Assembly>Reduced Mass/Stiffness
Reduced Mass/Stiffness
8. Confirm that the RSM fuselage appears in the Active Write RSM Definitions list box located on the
Active RSM Definition main form.
9. Press Apply to activate.
10. Press OK to make selection and close out form.
11. Confirm that the RSM fuselage appears in the Active Write RSM Definitions list box located on the
Activate RSM Definition main form.
12. Press Apply to enable activation.
Now that the RSM has been selected, an MSC Nastran job must be run to generate the RSM/RMM file.
This is done using the same procedure to run any job. The job must consist of only one subcase that contains
any boundary conditions and loads that are to be applied to the model. The solution sequence must be SOL
101, if the RSM is to produce only a stiffness matrix, or SOL 103, if the RSM definition is to produce both
stiffness and mass matrices.
Tools>Modeling>Assembly>Reduced Mass/Stiffness 607
Reduced Mass/Stiffness
After the model has been created, the RSM must be created. First, the order that the nodes appears in the
DOF’s list must be determined. When a RSM/RMM file is created the order of the nodes in the file is
determined by the node numbering. The order is from the lowest node number to the highest node number.
When a RSM/RMM file is read in, this order must be maintained. To be able to read in the RSM/RMM file
correctly, the model that generated the RSM/RMM file must be compared to the model that reads in the
model. The order of the nodes in the new DOF’s list is determined by matching the order of the nodes in the
original model to the corresponding nodes in the new model.
In this example the following correspondences between nodes are found:
The list gives the order that the nodes must be in for the canopy model to correctly read in the RSM/RMM
file. This order must be used when defining the RSM.
Now an RSM must be created. This is done from the Create RSM form.
To create a RSM:
1. Enter the name fuselage.
2. Select the Read toggle for the RSM Type.
3. Press the DOF List Definition button. (This brings up the Define DOF List Form.)
• Select the all the DOF toggles.
• Select the DOF coordinate system (Coord 0)
• Select the nodes 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 33, 32, 1, 2, 3, 4, 5, 6, 7, 31, 8, 30,
15, 29, 22 to be added to the RSM Definition. For the Read RSM Type the order that the nodes
appear in the list must be the same as the order of the corresponding nodes in the RSM/RMM file.
• Press the Display Current List button and check that the correct nodes have been selected. The
model should look like the following figure.
Tools>Modeling>Assembly>Reduced Mass/Stiffness 609
Reduced Mass/Stiffness
Now that the RSM has been activated, the job includes the RSM/RMM file when it is run. This job may be
run using the same procedure used to run any job. Currently only structured solution sequences
(SOL >100) are supported, but results may not be accurate for any solution sequence except linear statics
(SOL 101) and normal modes (SOL 103), because RSM/RMM files contain only a linear approximation of
the structure they represent.
Model Unmerge
The Model Unmerge functionality provides the tools needed to extract component models and their
associated results from a large structural model.
You should start with an empty database when extracting components from a larger model. The selected
component groups and result cases are stored in the new database. The model database is then closed and the
starting database containing the extracted groups and result cases remain open.
Procedure
The Model Unmerge functionality is available from the Tools/Modeling/Assembly pull down menu.
1. Start with an empty database when extracting components and results from a larger model.
2. Use the Select Source Database button to bring up the file selection form.
3. Select the model database from which the Unmerge is to be performed.
4. Select the groups or submodels to be extracted from the model.
5. Select the results to be extracted from the model.
6. Use the Apply button at the bottom of the form to initiate the Unmerge process. Any Patran results
postprocessing tools can now be applied on the component model extracted from the larger structure.
The form has a button to select the model database from which the extraction is to be made and listboxes for
the selection of the desired groups and result cases to be extracted.
If only model data is being extracted, then the following form will be displayed.
614 Tools>Modeling>Assembly>Model Unmerge
Model Unmerge
Example
An analysis of an airplane wing model has been performed. This analysis contains different structural groups
and different results cases. You wish to generate a display of one results case applied to only one portion of
the model (the flap). To do this, you must extract the flap and the results for the desired case.
616 Tools>Modeling>Assembly>Model Unmerge
Model Unmerge
6. If for some reason the independent and dependent columns need to be interchanged, you can turn
this toggle ON. Check your imported fields before proceeding to ensure they are correct. This is done
in the Fields application.
7. When you press the Apply button, you will be taken to the second step. If you need to import more
than one file, you will have to reset the Action pull-down.
Calculate Properties
Once test data has been associated to a test type or mode the curve fit function is performed by following
these steps:
1. Select the material Model you wish to curve to fit. The available models will depend on the test data
selected in the previous step. Hyperelastic models will be available for deformation mode test data.
Viscoelastic models will be available for relaxation test data.
2. In general you will leave Use Test Data to ‘All’ for hyperelastic models. If however you only want the
curve fit to use one of the deformation modes, you may set it here.
3. Press the Compute button. The coefficient values will be displayed in the Coefficients spreadsheet.
4. To visually see the curve fit, press the Plot button. You may repeat the above four steps for as many
material models as you wish to curve fit.
5. Select an existing material or type in a New Material Name and press the Apply button to save the
material model as either a Hyperelastic or Viscoelastic constitutive model for use in a subsequent
analysis.
Keep in mind the following points and considerations when calculating properties:
1. The plots are appended to the existing XY Window until you press the Unpost Plot button. You can
turn the Append function ON/OFF under the Plot Parameters... form.
620 Tools>Modeling>Experimental Data Fitting
Experimental Data Curve Fitting
2. By default, all the deformation modes are plotted along with the raw data even if raw data has not
been supplied for those modes. This is very important. These additional modes are predicted for you.
You should always know your model’s response to each mode of deformation due to the different
types of stress states. For example, a rule of thumb for natural rubber and some other elastomers is
that the tensile tension biaxial response should be about 1.5 to 2.5 times the uniaxial tension response.
3. You can turn ON/OFF these additional modes or any of the curves under the Plot Parameters button
as well as change the appearance of plot. More control and formatting of the plot can be done under
the XY Plot application on the Patran application switch on the main form.
4. Viscoelastic constitutive models are useless without a Hyperelastic constitutive model also. Be sure
your model has both defined under the same material name if you use viscoelastic properties.
5. You may actually change the coefficient values in the Coefficients spread sheet if you wish to see the
effect they have on the curve fit. Select one of the cells with the coefficient you wish to change, then
type in a new coefficient value in the Coefficient Value data box and press the Return or Enter key.
Then press the Plot button again. If you press the Apply button, the new values will be saved in the
supplied material name.
6. For viscoelastic relaxation data, the Number of Terms used in the data fit should, as a rule of thumb,
be as many as there are decades of data.
7. A number of optional parameters are available to message the data and control the curve fitting. See
the table below for more detailed descriptions.
For more information, see Experimental Data Fitting (p. 146) in the Marc Preference Guide, Chapter 2: Building
A Model.
Tools>Modeling>Bolt Pre-load 621
Bolt Modeling and Pre-loads
Bolt Pre-load
This modeling tool allows you to facilitate the creation of bolt pre-loads and the associated MPCs. This tool
can be used for both Marc and MSC Nastran.
Regardless of which method is used, the following general operations are done to create each bolt pre-load.
1. The mesh of the bolt is split at a designated cutting plane. This cutting plane is either designated by
the user or automatically determined by the tool. A coordinate system is created at the cutting plane
surface with the y-axis in the direction of the axial bolt direction. Coincident nodes are created for
element nodes above and below the plane and the element connectivity is regenerated. (If the Manual
method is used, the mesh is assumed to already be split in certain cases as explained later.)
2. MPCs are created to connect the two sections above and below the determined cutting plane. The
coincident nodes created in the previous step are tied together via MPCs. Either Overclosure type or
Explicit MPCs are created. Marc analysis and MSC Nastran SOL 400/600 typically use Overclosure
types. MSC Nastran can also use Explicit MPCs.
3. A control node is created at the coordinate system location that defines the cutting plane and it is
connected to each set of node pairs. The control node location can be offset as required for
visualization purposes.
4. A designated load (force or displacement) is applied for the pre-load in the local y-direction (axial bolt
direction) of the coordinate system created at the control node location. Lateral displacements of the
bolt are also fixed by a displacement constraint.
5. Each bolt pre-load is named and stored in the database.
6. Undo, Show and Delete capabilities are available.
Four methods are available to define the bolt pre-loads. Each has specific inputs. All have some common
inputs. Each is explained below:
Note: Import note: If an MSC Nastran input file contains a BOLT entry, it is imported as an
Overclosure MPC in the Finite Elements application and a bolt definition consisting of the
BOLTs top and bottom nodes, the control node, and any load and/or constraints associated to
the control node with corresponding coordinate system is also created. This definition then
appear in this Bolt Pre-load utility with a name of bolt_<MPC id>, where MPC_id is the ID of
the imported BOLT. If there are ID conflicts on import, any existing, conflicting bolt definition
is deleted if allowed by the user. The imported bolt definition is always associated to the
Manual creation method.
622 Tools>Modeling>Bolt Pre-load
Bolt Modeling and Pre-loads
Geometric based
This is by far the easiest and most intuitive method to use. A set of elements is selected that defines the bolt.
Based on the geometric dimensions and using Patran’s mass property utility, the most likely axial direction of
the bolt is determined. The mesh is split at the center of the selected element set. If the geometric properties
of the selected element set do not distinctly determine the axial direction of the bolt, the cutting plane may
not be determined correctly and a strange cut may result. At least a two to one axial versus width ratio is
recommended. Please note the following:
The application region, that is, the elements selected that define the bolt should:
• Be one contiguous/equivalenced set of elements
• Have enough elements to clearly define the axial direction
• Only define a single bolt - pre-loads can only be define one at a time - see multiple bolt creation
below.
If any of the above are not followed, a strange mesh cut may result.
The Geometric based method does its best to determine the bolt axis as explained above. If the cut appears
to be strange and/or the applied load (y-direction of created coordinate frame) does not appear to be in the
axial bolt direction, then you will likely have to create your own vector that defines the axial bolt direction at
the center location of the cutting plane where you want the mesh split. See the Vector based method below.
Vector based
This method requires that you define a vector, the base of which determines the location of the cutting plane,
which is normal to the defined vector. The element set selected must have a few layers of element both above
and below the base of the defined vector plane. This method is identical to the Geometric based method
except that you supply the vector that defines the bolt axial axis direction. A coordinate system is created at
the base of the vector with the y-direction in the direction of the defined vector. The control node is located
at this point and then offset as requested. It is up to the user to ensure the direction of the vector is in the
axial direction of the bolt. The y-coordinate of the locally created coordinate is the axial bolt direction.
Element based
This method may be more advantageous for certain element types in that you select element faces (3D),
element edges (2D), or an element (1D) where you want the mesh split and the MPCs are automatically
created. For 3D elements, this can be difficult as the graphics screen can get messy trying to select element
faces, especially TET elements. For 2D and 1D elements, this method is easy. The split occurs only for the
selected element entities, which may be problematic if you only select a portion of the cross section. Please
note the following for this method:
For 1D, only a single element should be selected. The split occurs at the node farthest from the
origin. If multiple elements are selected, only the first is used. The bolt axis is defined by the
direction of the selected element.
For 2D, select element edges of the connected elements through which the mesh should be split.
Make sure you select all element edges that define how the mesh is to be split. Leaving out any edge
through the cross section will result in an incomplete mesh split. It is OK to use a single picking
mechanism (and SHIFT key for multiple selection) or rectangular/polygon picking to select all edges
Tools>Modeling>Bolt Pre-load 623
Bolt Modeling and Pre-loads
simultaneously. The bolt axis direction is determined by the node connectivity of the first selected
edge, the average location of all nodes of the selected edges, and the normal of the element of the
first selected edge. A vector from the first selected element edge’s node and the average location is
made and the bolt axis is then the cross product of the element normal and this vector. This
determines the bolt axis for any arbitrarily oriented model. If the selected edges are not straight and
perpendicular to the expected bolt axis, the actual bolt axis may not appear as desired. Also selecting
different edges as the first selected edge can change bolt axis orientation. The first selected edge
should be as perpendicular to the expected bolt axis as possible.
For 3D, select element faces in the same way as 2D element edges. The same comments apply for
3D element faces as for 2D element edges. The bolt axis direction is determined by the node
connectivity of the first selected face, the average location of all nodes of the selected faces, and the
vectors from the averaged location to the first and second face nodes. The bolt axis is the cross
product of these two vectors. This determines the bolt axis for any arbitrarily oriented model. If the
selected faces are not straight and perpendicular to the expected bolt axis, the actual bolt axis may
not appear as desired. Also selecting different faces as the first selected face can change bolt axis
orientation. The first selected face normal should be as perpendicular to the expected bolt axis as
possible.
For 2D and 3D, make sure you select all the element edges or faces, respectively, that define the
entire cut through the bolt or else you will not get a fully disconnected mesh. Internally the
operation finds all nodes associated to the selected edges or faces and then subsequently finds all
element associated to those nodes. With the elements identified and the definition of the cutting
plane, the mesh is split by determining which element exist above and below the plane.For 2D and
3D, make sure you select all the element edges or faces, respectively, that define the entire cut
through the bolt or else you will not get a fully disconnected mesh. Internally the operation finds all
nodes associated to the selected edges or faces and then subsequently finds all element associated to
those nodes. With the elements identified and the definition of the cutting plane, the mesh is split
by determining which element exist above and below the plane.
Edge/Face Selection on one side (OK) Edge/Face Selection on both sides (OK)
624 Tools>Modeling>Bolt Pre-load
Bolt Modeling and Pre-loads
Manual creation
There are two modes when manually creating the bolt preload definition. The first mode assumes the mesh
is already split and the second assumes that the mesh needs to be split.
Mesh already split. In this mode, you supply a list of top nodes (independent) and a list of bottom
nodes (dependent). The mesh is assumed to be split already. The same number of top nodes and
bottom nodes is required. The operation detects and ensures there is a one-to-one correspondence
between the top and bottom nodes based on a geometric tolerance and aborts if not. By default this
tolerance is the global model tolerance as set under the Preference/Global menu, but can be changed
directly on the bolt modeling form. The tolerance check can also be based on a cube or spherical
check. The top nodes must be coincident with the bottom nodes within this specified tolerance for
the operation to be successful. The top nodes and bottom nodes can be in any order, but there must
be the one-to-one correspondence as already mentioned.
Mesh split requested. In this mode, you supply a list of nodes (bottom or dependent) across which
the split is to be made and a list of corresponding elements below the split. The operation then splits
the mesh at the nodes of these element to produce the top (independent) node list. The generated
top and supplied bottom nodes then become part of the bolt MPC definition.
In both cases, the bolt load is defined as a vector relative to a coordinate system. By default this is the y-
direction of the global coordinate system designated as a typical Patran list processor vector string:
“<0 1 0 Coord 0>”. It is up to the user to ensure that the bolt load direction is in the axial direction of the
bolt. The magnitude of the load is supplied as part of the vector components. A local coordinate system is
not created in this manual operation and is assumed to already exist. Any valid Patran list processor vector
string can actually be used, but the magnitude of the load can only be controlled using the vector form:
“<v1 v2 v3 Coord n>”
As with the other methods, the load is placed on the control node. The control node can be supplied directly
by the user using an existing node or, if not supplied, it is created at the center of the mesh split (average
location of the top and bottom nodes of the mesh split). When the control node is automatically created, it
can also be offset for visualization purposes using a vector definition as with the other methods. This vector
offset is defined relative to the coordinate system used to define the bolt axial load.
If you need to modify an existing bolt pre-load, you must first delete it and
then re-create it.
Tools>Modeling>Bolt Pre-load 625
Bolt Modeling and Pre-loads
You can select an existing bolt by name(s) or if you are not sure which one you
want, you can select a control node graphically. The application determines
which bolt pre-load is associated to the selected control node.
Note that only entities created by the bolt pre-load are deleted unless those
entities are modified by the user to reference other entities in some way.
Warning messages are issued in those cases and some of the entities such as the
coordinates may not be deleted.
You can elect to delete all entities associated with (that were created by) the bolt
preload operation or you can elect to retain the associated Control Node,
Coordinate System, Multipoint Constraint (MPC), load and constraints,
and/or the mesh split. It may not be possible to delete just one or two of these
entities as they may be associated to other entities. You will be warned if this is
the case.
Show Displays information about one or more bolt pre-loads.
You may select a bolt by name(s), by control node, or show all in the database.
A separate form appears with a spreadsheet showing the different components
of each bolt pre-load. Each cell in the spreadsheet can be selected and the
corresponding entity graphically highlighted, if applicable. Textual
information is also displayed in the text box of the subordinate form.
If you turn ON the Verify Mesh Split toggle, then when pressing the Apply
button or clicking on a bolt name in the spreadsheet, the selected bolt is color
coded showing the two distinct meshes made by the mesh split operation. This
requires the bolt to have been defined with a set of elements and/or a distinct
mesh split. Please note the following:
This does not work for bolts split using the 1D Elemental method
since the application region is simply a single element.
For properly defined bolts, this results in two distinctly displayed
meshes. If the application region is not discontinuous from the rest of
the model, the operation may not be able to identify distinct meshes.
If two meshes are not identified, check the mesh split carefully.
The current graphic settings of the active viewport are saved and then
restored after the show operation is complete, reset, or the form is
closed. Make sure bolts of interest are posted.
Note the last two columns of the spread sheet highlight the top and bottom
elements of the bolt mesh split for verification purposes. The independent
nodes of the bolt overclosure or explicit MPC should be the top and the
dependent should be the bottom. To verify this, a positive bolt load should
point to the top bolt nodes/elements and the bottom would be the opposite.
626 Tools>Modeling>Bolt Pre-load
Bolt Modeling and Pre-loads
Object When creating a bolt pre-load, the designated load can be either a force or a
prescribed displacement. Positive loads place the bolt in tension and negative
loads place the bolt in compression.
Method The four methods are described above as Geometric, Vector, and Element
based plus a Manual creation.
New Bolt Name Enter a bolt pre-load name.
Axial Bolt Load Enter the magnitude of the bolt pre-load to be applied. This is a force or a
prescribed displacement depending on the set Object. The load is created in
the y-direction in the coordinate system defining the axial bolt axis. A force
LBC or a displacement LBC is created by the same name as the bolt pre-load
and can be viewed and/or modified using the Loads/BCs application. Also the
lateral displacements of the bolt are fixed by creating a displacement
constraint, also viewable in the Loads/BCs application, the name of which is
the bolt name with “_LateralDisp” appended.
For the Manual method, the load is specified as a vector component in the
form “<v1 v2 v3 Coord n>”. The default is the y-direction of the global
coordinate system: “<0 1 0 Coord 0>”. Other Patran list processor vector
definitions can also be used by using the select mechanism, but you will not
have control over the actual magnitude of the bolt load in these cases. It is up
to the user to ensure that the bolt load for the Manual method is in the axial
direction of the bolt and that the positive direction of the load points toward
the top (independent) nodes of the bolt mesh split.
MPC Type* Select the type of MPC required. You may not be given a choice depending on
the set Analysis Preference and Analysis Type. Overclosure is the desired
method for both MSC.Marc and MSC Nastran SOL 400/600. Other MSC
Nastran solutions need Explicit MPCs defined. For MSC.Marc, Overclosure
creates TYING type 69 and Explicit creates SERVO LINKs. For MSC Nastran
SOL 400, a BOLT entry is created or for SOL 600, a MBOLTUS entry is
created when using the Overclosure MPC type, otherwise, Explicit MPCs are
used.
Control Node Offset A direction vector and magnitude can be supplied to offset the location of the
control node. This is highly recommended for visualization purposes. A vector
Direction Vector is provided, the length of which is the offset from the center of the cutting
Magnitude plane relative to the created coordinate system defining the axial bolt direction.
You may enter a vector in any way allowable with the select mechanism or you
can manually type between the “< >” brackets a valid three-component
translational vector, e.g., <0, 5, 2>.
By default it is offset by one (1) unit in the x-direction of the local coordinate
system defining the axial bolt direction. But this may not be adequate
depending on model dimensions and direction of the bolt axis.
Tools>Modeling>Bolt Pre-load 627
Bolt Modeling and Pre-loads
Control Node For the Manual method, if the Select Control Node toggle is ON, then you
can select an existing node as the Control Node. It is not possible to offset this
Select Control Node node. The node is directly used as the Control Node.
Tolerance Type For the Manual method, when checking that top and bottom nodes are
coincident, a tolerance is used. By default this is the global model tolerance as
Tolerance set in Preferences/Global. You may change this here for the bolt preload
definition operation if necessary. The tolerance can be checked based on a cube
or spherical operation. In other words, the tolerance operation checks to see if
a pair of nodes fits within a tolerance cube or a tolerance sphere.
Auto Execute If this toggle is ON, then the operation of splitting the mesh and creating the
pre-load begins automatically without have to press the Apply button. For the
Vectorial and Geometric methods, this is ON by default. For the Elemental
method, this if OFF be default since the usage requires manually selecting
element edges or faces and can be annoying if the operation occurs without all
the entities properly selected.
You can always press the Undo icon immediately after a creation (or deletion)
to undo the creation (or deletion) operation and start over. The bolt pre-load
is committed to the database and cannot be undone without doing a delete if
you leave the bolt pre-load tool or change the Action on the bolt pre-load tool
or create some other database entity.
Multiple Bolts This toggle exists for the Geometric and Vectorial methods only. If this toggle
is ON, then multiple bolt pre-loads can be created in a single operation by
selecting one or more elements from each of the meshes defining the bolts.
This works by taking the selected elements and identifying all completely
discontinuous (unconnected) meshes associated to the selected elements. Once
the meshes have been identified, a separate bolt is created for each. All bolts
receive the same load and offset vector. If no discontinuous meshes are
identified, then only one bolt is created.
Split Mesh For the Manual method, if the mesh is to be split, turn this toggle ON. You
are then required to supply a list of nodes along a line or surface of the supplied
list of elements where the mesh split it to be made. The mesh is split along the
line/surface of the supplied nodes and the selected elements define the bottom
side of the bolt. Coincident nodes are created during the mesh split,
correspond to, and are associated with the top elements defining the bolt.
Element/Node List(s)
628 Tools>Modeling>Bolt Pre-load
Bolt Modeling and Pre-loads
Method: Select a list of elements that sufficiently defines the bolt geometry. The axial
Geometric direction of the bolt should be longer than the lateral directions in order for
the algorithm to determine the proper axial direction of the bolt. The cutting
plane will be created at the center of the bolt as best as possible based on the
element connectivity. The control node offset will be created from the location
of the cutting plane. If the Multiple Bolts toggle is ON, only one or more
elements need to be selected from each location where a bolt pre-load is to be
created, otherwise all the elements making up the bolt must be selected. With
this toggle ON, you can select a single element and all connected elements will
be used as the application region to create just a single bolt pre-load.
Method: For this method, select enough elements above and below the base of the Bolt
Vectorial Axis vector such that a proper cut can be made. Two or three layers of elements
above and below is usually sufficient. An error may result or a bad looking cut
may be had if not enough element above and below are given. If the Multiple
Bolts toggle is ON, only one or more elements need to be selected from each
location where a bolt pre-load is to be created, otherwise all the elements above
and below the cutting plane must be selected. With this toggle ON, you can
select a single element and all connected elements will be used as the
application region.
Method: Split Mesh OFF: A list of top (independent) nodes and a list of bottom
Manual (dependent) nodes is supplied from which the bolt MPC is created. The two
node lists must have the same number of nodes in them each and each node
pair between the two lists must be coincident with the given Tolerance. The
nodes do not have to be in the same order as the operation will find which
nodes are coincident between each list. The mesh is not split in this case. It is
assumed the mesh is already split. Selecting the top and bottom nodes when
they are coincident can be problematic. See the notes below.
Split Mesh ON: A list of nodes (dependent) and a list of elements below the
mesh split is required. The mesh is then split at the nodes of these given
elements. You must supply all the nodes and element that make up the request
split in order to have the split operation completely separate the top and
bottom of the bolt mesh. The mesh split operation then creates the top
(independent) nodes of the bolt MPC.
Bolt Axis This is a required vector input to define the axial direction of the bolt for the
Vectorial method. Typically you only need to use the select mechanism to
Method: define a vector using two nodes on the outside of the bolt. You can use any
Vectorial method that the select mechanism allows to define a vector. You may enter a
vector in any way the is allowable with the select mechanism or you can
manually type between the “< >” brackets a valid three-component
translational vector, e.g., <0, 5, 2>. In this method, you can define any
direction to do the cut and apply the pre-load. Care should be taken in that
some strange cuts may results. This is the method to use if you wish to use a
non-axial bolt pre-load.
Tools>Modeling>Bolt Pre-load 629
Bolt Modeling and Pre-loads
Target Element Type In this method, you must select the element dimensionality of the bolt: 1D
bars, 2D shells/planar elements, or 3D solids.
Method:
Elemental
1D Element The application region defines the actual location where the split is made for
the Elemental method. For 1D beam/bar elements, you select a single element
2D Element Edges and the split is made at the node farthest from the origin. For 2D shell or
3D Element Faces planar elements, you select element edges that define the cut. For 3D elements,
you select the element faces to define the cut. All the element edges or faces
need to be connected together in order for this method to create a proper cut.
* When manually creating MPCs via the Finite Elements application, various checks are made
to ensure proper MPC creation. These checks are bypassed when using this tool. If you wish to
enable the checks, set the environment variable SKIP_MPC_CHECKS to NO or OFF or FALSE. Any
other setting of this environment variable turns it ON, if it is set, and the MPC checks are skipped.
You can also use a PCL preference setting command
pref_env_set_logical(“SKIP_MPC_CHECKS”, FALSE)
and place it in the settings.pcl file or manually issue the command via the command line.
Note: Use the FEM application and do a Verify / Element / Boundary to ensure that the bolt tool
properly cut the bolt into two sections with coincident nodes between or use the Show
operation in this tool with Verify Mesh Split turned ON.
You can use the Undo icon to remove an undesired bolt creation (or deletion) as long as you do
it before leaving the bolt modeling tool or change its Action or create some other database
entity that cause a database commit operation.
When selecting top and bottom nodes that are coincident or when trying to select element
faces, the following procedure is recommended. Turn ON element shrink under Display/Finite
Elements. Then select the element faces directly on the side of the desired element as they are
now visible independently from each element. If trying to select coincident nodes, use the
Tools/List/Create to create a list of top nodes associated to the element faces or edges of
interest on one side of the mesh split. And then do the same for the bottom nodes. With the
element shrink ON, it makes it easier to select the element faces on each side of the mesh split
in order to get the associated node list. You then copy the list contents and paste them into the
Top or Bottom Nodes data box.
Positive bolt loads should result in tension in the bolt. Negative bolt loads should result in
compression in the bolt. The direction of the load and whether it results in tension or
compression is dependent on the definition of the top (independent) and bottom (dependent)
nodes of the bolt MPC. Positive bolt loads must point toward the top (independent) nodes of
the bolt MPC. For the Manual method it is up to the user to ensure this. All other methods
should orient a positive bolt load toward the top nodes.
630 bolt_create_geometric
Bolt Modeling and Pre-loads
or
Description:
Creates bolt preload using the indicated method (geometric, vectorial, elemental, or manual) or deletes a
bolt preload definition by indicating either the bolt name or the control node (one or the other, not both).
Input:
STRING bolt_name Name of the bolt to create.
STRING() bolt_to_delete Name of the bolt to delete. It is not necessary to supply the
control_node, if the name is supplied. Enter a blank string (“”)
for the control_node.
LOGICAL del_CN When deleting bolt preload definitions, you may specify to delete
del_CID the Control Node, associated coordinate frame (CID), multipoint
del_MPC constraint (MPC), load and constraints (LBCs), and/or
del_LBCs corresponding mesh split. All are deleted by default (TRUE). If some
del_meshSplit are to be deleted and other not, the operation may or may not delete
the entities depending on associations with other entities.
bolt_delete bolt_delete2 631
Bolt Modeling and Pre-loads
STRING control_node Enter the control node in list processor format, e.g: “Node 10”. The
bolt preload associated to this control node is deleted. It is not
necessary to supply the bolt name in this case. Enter a blank string
for bolt_to_delete when using the control node to delete a bolt
definition, e.g.: “”.
STRING mpc_type Type of MPC to create: “Overclosure” or “Explicit”
REAL bolt_load Methods: Geometric, Vectorial, Elemental
Value of the pre-load to be applied. This value is the axial bolt load
in the y-direction of the created coordinate system.
STRING bolt_load Method: Manual
Value of the pre-load to be applied input as a vector string in the
form “<v1 v2 v3 Coord n>”. This value is the axial bolt load where
the vector coordinates, v1, v2, v3, are the x, y, and z-components of
the load in the axial bolt direction. They can be defined relative to a
specific, existing coordinate frame also, if desired. The default is
Coord 0, the global coordinate system. It is the user’s responsibility
to ensure that this vector is in the bolt’s axial direction. Any valid
Patran vector definition can also be supplied. However the
magnitude is only controllable when defining as a vector in the
above mentioned format.
LOGICAL disp_load TRUE if load is displacement, otherwise set to FALSE.
STRING offset Offset vector and magnitude, both input as a string to display the
offset_magn pre-load. For example, enter “2.0” for the offset_magn and “<1 0
0>” to displace or offset the pre-load 2.0 units away from center of
the bolt in the x-axis direction of the locally created coordinate
system for the bolt load. This is for visualization purposes only and
does not affect actual load application. The control node is created
at the location defined by this offset and is relative to the local
coordinate system created by this operation. The local y-direction is
the bolt axis.
STRING elem_dim For the elemental method, the dimension of the bolt elements for
the bolt split. Either “1D”, “2D”, or “3D”.
STRING app_region Geometric or Vectorial Methods: List processor string of elements
making up the bolt, e.g., “Elm 1:#”
Element 1D Method: List processor string of a single 1D bar
element where the bolt mesh is to be split, e.g., “Elm 1”
STRING top_nodes Manual Method: List processor string of top nodes and string list of
bot_nodes bottom nodes of the mesh split if the mesh is already split, e.g.,
“Node 1 2 3” and “Node 4 5 6”.
STRING node_list Manual Method: If the mesh is to be split, then the node_list is a list
elem_list of nodes where the mesh is to be split and the elem_list is a list of
elements below the mesh split, e.g., “Node 1 2 3” and “Elm 1 2”.
STRING vector For the vectorial method, the vector that defines bolt axis direction
in any valid list processor vector definition format, e.g: “<0.0,
1.0,.0.0>” indicating that the bolt axis is in the y-direction of the
global coordinate system.
Output:
INTEGER <Return Value> Non-zero status indicates an error occurred.
Tools>Modeling>Rotor Dynamics 633
Preparing for Rotor Dynamics
Rotor Dynamics
The new rotordynamics capability provides you with a relatively simple method of performing the design and
analysis of structures with rotating components. The new rotordynamic capability can be used in frequency
response (direct and modal), complex modes (direct and modal), static, nonlinear transient, and linear
transient (direct only) analyses.
For more information on Rotor Dynamics, see the Building a Model / Rotor Dynamics in the MSC Nastran Structural
Users’ Guide.
634 Tools>Modeling>NSM Properties
Non-Structural Mass Properties
Rebar Definitions
Creates 2D layered rebar definitions for use with the MSC.Marc and ABAQUS Analysis Preferences. Discrete
rebar models and general 3d layered rebar models are not supported. Rebar is actually an element property
definition for the Preferences, however this tool is used to automate the creation of rebar layers and embed
them into existing element meshes. This tool allows you to:
Create, modify, delete and visualize Rebar data definitions.
Support multiple rebar definitions, both isoparametric and skew type geometry.
Support rebar membrane elements in 2D solid (plane strain and axisymmetric) elements.
Create a customized mesh and automatically assign rebar properties to these elements.
Note: The Rebar Definition tool supports automatic generation of rebar elements and properties
for 2D solid elements only. For rebar embedded into 3D solid elements, you must manually
create the elements (mesh) and assign properties in the Element Properties application
using 2D Rebar Membrane definition. You can also manually create 1D Rebar Membrane
elements without using this tool but this is less convenient.
For more information please see Rebar Definition Tool (p. 201) in the Marc Preference Guide.
Parameter Description
Action
Create/Modify Create and Modify are identical. The only difference is that Modify
requires you to pick an existing rebar definition before you can proceed.
Delete Delete simply allows you to delete existing rebar definitions.
Show The Show action allows you to graphically visualize rebar property data
set.
Object/Type Only 2D Layers are supported.
Existing Rebar or Rebar Supply a name for the rebar layer and select a color. Or pick an existing
Name rebar from the Existing Rebar... button.
Tools>Modeling>Rebar Definitions 637
Creating Rebar Definitions
Curve List All rebar layer definitions must be associated to a geometric curve. This
curve must be placed on top (in the xy plane) of a 2D solid mesh for
axisymmetric or plane strain elements. These elements should already
have properties assigned to them.
Material Select an existing material that defines the rebar material properties from
the Material... button. The name will be filled in the data box below the
button.
Area/Spacing/ Supply the cross sectional area, the spacing and the orientation in these
data boxes. If you press one of the buttons here, it will ask you to provide
Orientation a spatial field definition of these of these properties as they vary along the
curve length.
Clear Press the Clear button to clear the fields and start over.
Feature Recognition
This feature works from parasolid geometry.
1. Select the entity type and entities of interest and set the controls.
2. Then right-mouse-click on the features you want to recognize (holes, chamfers, blends) in the tree
widget.
This populates the tree widget with the recognized features.
3. Right mouse click on the features to show, edit, or delete them.
The Parasolid Kernel will fail to edit or delete a feature if there is a topological dependency on other geometry.
Multiple features can be deleted as long as all dependent features have also been selected for deletion in the
same operation.
The propagation controls get passed to the feature recognition APIs to control the type of recognition. In
other words, if you select Chain option for Blends and do Interactive recognition then it will do the
recognition and then perform chaining so finally you will get Blend Chains. Each Blend Chain may be a
combination of several individual Blends. To recognize each blend individually you can select the Single
option.
Parameter Description
Recognize Automatic these options are not used. For automatic recognition these options
have been set to default values of Hole - Single, Chamfer - Chain, Blend -
Chain.
These options are valid for Recognize - Interactive only and respective values
get passed through the second argument in the recognition API.
> status = ifr_recognize_blends_list(entity_list,
propagation, topology, $entity_type,
$number_of_features)
Recognize Automatic works with Geometric Entity as Solid only.
Recognize Automatic does not need any input other that Solid ID in which
the features need to be recognized. All other inputs are defaulted. It is available
to provide user a convenience. It will recognize the features in the whole solid.
Recognizing features in the whole solid may not always be useful as there may
actually only be the need of recognizing features in one particular region of the
solid. In this case simply select the faces / edges where the need to recognize
the features exists and use Recognize Interactive.
Tools>Modeling>Feature Recognition 639
Recognizing and Editing Geometric Features
Contact Bodies/Pairs...
This functionality creates Deformable Bodies, Rigid Bodies, and Contact Body Pairs.
It automatically creates contact body pairs by determining if two bodies are close enough to be considered a
body pair based on the user defined distance tolerance. The name of contact pair also gets generated
automatically by combining the names of two bodies with suffix as ‘_pair’. If the contact pair name is more
than 31 characters, then the contact bodies names are truncated followed by assignment of internal body IDs
with suffix ‘_pair’. In this it is made sure that the contact pair name is unique.
It creates both Contact Bodies and Pairs when the analysis preference is MSC.Nastran and only Deformable
Bodies when the analysis preference is MSC.Marc. For other analysis preferences this functionality is not
available.
Tools>Modeling>Contact Bodies/Pairs... 641
Creating Contact Bodies/Pairs
Parameter Description
Create Creates Body Pairs or Deformable Bodies. Deformable Bodies are described in
the next section.
Distance Tolerance The value of tolerable distance between body boundaries. All exterior node
positions of body 1 are compared with exterior node positions of body 2, and
if any distance is less than Distance Tolerance a body pair is created.
All Bodies If selected, creates pair between any two bodies, both rigid and deformable.
Deformable Only If selected, both the bodies in pair will be deformable.
Create From The options to consider are, bodies in the Entire Model, only those in the
Current Group, Current Viewport, or by selecting bodies manually. If the
Select Bodies button is opted, a list box icon appears. Click it to get the list of
bodies, it displays All Bodies or Deformable Only based on the option
selected on the form.
Contact Property Set Here you can specify contact property set for the body pair. The options are:
Specify: You can select existing properties or specify new geometrical and
physical properties to all contact pairs created.
Apply Creates the specified body pairs.
Defaults Resets form to its default values.
Cancel Closes the form without creating a body pair.
Note: Automatic Contact Body Pair creation is based on the FEM data. Contact Body Pair will not
be created with a rigid body that is not meshed.
642 Tools>Modeling>Contact Bodies/Pairs...
Creating Contact Bodies/Pairs
Deformable Bodies
Option Description
Create Creates Body Pairs or Deformable Bodies. Rigid Bodies can also be created
using the “Geometry” method.
Method Provides the methods to automatically create bodies. The options are
Connectivity, Element Type, Groups, Properties, Materials, and Geometry.
The buttons on the form vary depending on the method selected.
Connectivity This method creates bodies based on continuous element connectivity of solid
3D elements (hex/tet), shell or 2D element (quad/tria), and bar/beam (1D)
elements.
Element Type This method creates deformable bodies based on element types and
continuous connectivity of elements if the Consider Connectivity toggle is
checked. Otherwise there will be one body of bars, one body of trias, etc.
Groups This method creates deformable bodies based on the existing groups.
Properties This method creates deformable bodies based on existing element properties.
Materials This method creates deformable bodies based on existing materials.
Tools>Modeling>Contact Bodies/Pairs... 643
Creating Contact Bodies/Pairs
Option Description
Geometry This method creates deformable and rigid bodies from geometry in the entire
model, current viewport, or current group. Each set of similar geometry
(curve, surface, or solid) that is connected will create a body. The application
type will remain geometry. It does not have to be meshed at the time of body
creation.
Select Create Rigid Bodies check box if you want to create rigid bodies. Only
1D and 2D type geometry is allowed for the rigid bodies.
Create From Entities in the entire model, in the current view port, or in the current group
are considered in the creation process. For batch mode, only the entire model
is applicable. In cases where specific entities can be selected, such as groups,
materials, properties, the list box appears for selection and filtering.
Elements Element types to be considered in the Connectivity and Element Type
methods.
Apply Creates the specified bodies.
Defaults Resets the form to its default values.
Cancel Closes the form without creating the deformable bodies.
Design Studies
Finite element analysis is seldom conducted as a single-run operation; frequently the process goes through
several iterations. In each iteration the model may be “tweaked”, some dimensions or other properties of the
model modified, and the analysis repeated until an optimal design is attained.
As a simple example, you may run a linear static plane stress problem with a certain thickness assigned to the
elements. If the stress and displacement outcomes are well within the acceptable range, you may decide to
reduce the element thickness, thereby decreasing the weight of the object, and run the analysis again. You
may continue refining the model through several iterations, until the weight reaches a desirable minimized
value without compromising the stress or other criteria.
This procedure can be automated through a series of design studies and, ultimately, design optimization.
A design study is a named event in which you specify the following:
the objective of the design study and of optimization--what do you want to achieve through multiple
iterations of the analysis process? Although there may be a number of possible objectives, in the
majority of structural analysis problems the objective of optimization is to minimize the weight of
the model.
the parameters of the model--which dimensions or properties may vary in order to achieve the
optimal design?
the constraints placed on the design study--what condition is a limiting factor in the optimization
process? For example, in the plane stress problem cited before, as the plate thickness is reduced to
decrease the weight, the thickness value must not become so small as to cause the plate to deform
beyond a given acceptable limit.
Variables
Variables are those parameters, or properties, whose magnitude will be modified in the process of studying
the solutions that can improve the design. The variable may be some dimension, an element property (e.g.,
plate thickness, beam cross-section), or a material property. To perform studies for the purpose of improving
and optimizing a design through iterative solutions, you must parameterize the model, that is, identify and
label variables and set up possible relationships between them.
When you define a model variable, a corresponding field may be created as well. This field is a linear function
of the variable and it becomes available throughout Patran. Thus, if desired, it can be used to define additional
model properties. Any changes made to the variable will also change the properties dependent on the field.
Tools>Design Studies>Pre-Process 645
Creating Design Studies
This tool is used in conjunction with analysis setup of MSC Nastran SOL 200 optimization analyses. To
successfully run a SOL 200 job you must setup a design study. Design studies are then selected when a SOL
200 job is submitted from the Analysis application. Please see Optimize (Ch. 3) in the Patran Interface to MSC
Nastran Preference Guide.
Before you can initiate a design study, you have to:
consider the objective, or goal of the design study and of optimization. Although there may be a
number of possible objectives, in the majority of structural analysis problems the objective of
optimization is to minimize the weight of the model.
parameterize the model. Define the variable dimensions or properties that may change in order to
achieve the optimal design.
decide the constraints to place on the design. Define the condition that is considered as a limiting
factor in the optimization process.
This tool allows you to:
define the design objectives of the optimization
define the design variables or parametization of the model
define the design constraints the model is subject to during the optimization
create named constraint sets, a collection of constraints
create a design study, a collection of objectives, variables, and constraints.
Important: Note on topology optimization versus sizing optimization. There are two mechanisms
to set up a topology optimization run.
• The first is through the Analysis form with the Action set to Optimize. The Customized Solutions
form is used to turn ON topology optimization and define constraints, objectives, domains, and
optimization controls. The mechanism is referred to as Quick Topology Optimization.
• The second is through the definition of a design study using this tool. All constraints, objectives,
responses, etc. are defined and collected into a design study. Both sizing and topology can be
mixed in the same design study. This is referred to as General Topology Optimization.
Quick Topology Optimization supersedes General Topology Optimization. If you wish to use
General Topology Optimization, please ensure that you have turned OFF the customized
solution topology optimization in the Analysis | Optimize | Customized Solutions... form and
that you select the design study and the objective/constraint of interest from the Design Study
Select... and the Global Obj/Cosntr Select forms.
646 Tools>Design Studies>Pre-Process
Creating Design Studies
Parameter Description
Action Lists the action that can be performed.
Note that with Create you can also modify a design study.
Design Study Name Provides a textbox where you can enter a name for a new design study.
The name may consist of any number of alpha-numeric characters.
special symbols and spaces are not acceptable.
Description Provides a textbox where you can enter a detailed description of the
design study.
Make Current Makes the selected design study current. Only those design parameter
values that originate in a current design study can be used to update finite
element model properties.
You can modify a design study even if it is not current (the toggle is not
on), but the parameter values of the model will not be updated.
Modifications to a design study that is not current will not affect a current
design study.
Design Study Setup
Design Variables Displays the Design Variables dialog box where you can review and
modify design variables (see Design Variables, 647).
Design Objective Displays the Design Objective dialog box (see Design Objectives, 651) and
allows you to associates them to a design study.
Design Constraints Displays the Design Constraints dialog box (see Design Constraints, 652)
and associate them to a design study.
Constraint Sets Displays a dialog box where you can associate them to a design study.
Max/Min... Displays a dialog box where you can associate them to a design study.
Apply/Close Saves or discards input. The design study will be saved only if you press
Apply.
Design Variables
A design variable is a model variable that is used in a design study and in optimization. You create model
variables when you create a design variable or you can select an existing model variable to create the design
variable. When you press Design Variables in the Design Study dialog box, a spreadsheet will display a
summary of variables and their attributes. Because initially every model variable is also considered a design
variable, the spreadsheet will contain all variables defined in a database.
With the exception of the parameter names and their default initial values, all other data in the spreadsheet
may be modified.
648 Tools>Design Studies>Pre-Process
Creating Design Studies
The first column contains the name of the variable. Subsequent column headings and their contents are as
follows:
Parameter Description
Design Variable A YES entry in this column confirms that the model variable is also a
design variable. If a variable is not to be used in the design study, you can
“deselect” it by clicking on the word YES. All variable information for
this item will be removed, indicating that the variable is not a design
variable, even though it is listed in the spreadsheet. To toggle back to
YES, click in the field again.
You can pick several consecutive items in this column at the same time
by dragging the cursor down the column.
A button will then appear at the top of the spreadsheet to show that the
current status is YES. Click on YES, to display the choices, pick NO,
then press the Enter (or Return) key, and the items will be deselected.
The button also works in the reverse (NO to YES).
Tools>Design Studies>Pre-Process 649
Creating Design Studies
Analysis Value Displays the value you assigned to the variable when you defined it. This
value cannot be changed here.
Design Value Provides a field where the value of a design variable will be placed, if you
define one that is different from the value of the model variable.
When you click in this field, a textbox appears at the top of the
spreadsheet. Type a new value then press Enter (or Return).
If you specify a new design value, the original lower and upper boundary
values will no longer be valid. Therefore, you will see the following
message:
Press Yes to acknowledge the warning. The new value will be entered in
the Design Value category and one or more of the boundary values will
change accordingly.
Lower Bound Displays the lowest value the design variable may assume during the
design study/design optimization process. By default, this boundary is set
to 10% below the base value. To change the boundary value, click in the
appropriate field then enter the new value in the Input New Value
textbox.
Upper Bound Displays the highest value the design variable may assume during the
design study/design optimization process. By default, this boundary is set
to 10% above the base value. To change the boundary value, click in the
appropriate field then enter the new value in the Input New Value
textbox.
Move Limit Specifies the change allowed in a design variable in each design cycle.
Default is 1.0, the equivalent of 100%.
Design Cycle Select Calls up the Design Cycle Select dialog box.
Defaults Resets all entries to their original value. Keeps the dialog box on the
screen.
OK/Cancel OK accepts all variables. Cancel closes the form.
650 Tools>Design Studies>Pre-Process
Creating Design Studies
Parameter Description
Runs Displays the names of the result cases, or runs, that were output by
iteratively performing analysis with different values of the variables.
Design Cycles Presents the list of design cycles (subcases).
Design Variables Shows the design variables.
Values Displays the values of the design variables for a selected design cycle.
To apply the results of a particular cycle of an analysis run in the design study, pick the name of the Run then
pick a Design Cycle. The design variable values of that run and cycle will be shown. Press OK to accept the
new values. When the Design Variables spreadsheet is redisplayed, the variables will be updated to the new
values.
Design Responses
Design responses are objectives or constraints. If you define a design response, you can select it to be used as
either an Design Objective or a Design Constraint later on. You can also group them together under a
Tools>Design Studies>Pre-Process 651
Creating Design Studies
MaxMin definition. The information necessary to define a design response is the same as that for an objective
or constraint. See Design Objectives, 651 and Design Constraints, 652 below.
Design Objectives
The design objective is the goal of the optimization process.
The computation of total weight includes only elements with definable volume. Elements such as lumped
mass (CONM2) and distributed mass/unit length are excluded--in fact these are invariant during design
optimization.
Parameter Description
Solution Set this to the solution of interest. Valid solutions are:
Linear Statics
Normal Modes
Buckling
Frequency Response
Transient Response
Global
Response The combination of Solution and Response is the overall objective. Each
Solution has it’s own valid Responses, which can consist of responses at
discrete locations on the model
Weight
Volume
Fractional Mass
Average Compliance
Existing Objectives Displays names of the objective function already defined.
Use Existing Response For some Objectives, you may select an existing Response to define the
objective rather than redefining it again.
652 Tools>Design Studies>Pre-Process
Creating Design Studies
Examples objectives:
minimize the weight or volume of the structure
minimize the displacement at a particular location
maximize the buckling load
minimize the stress in a member
minimize the acceleration at a particular point at a particular frequency
Design Constraints
Design constraints provide certain restrictions, or limits, to ensure that as the optimization process advances
toward achieving the design objective, other design conditions do not become compromised. As an example,
you may decrease the cross-sectional area of a beam to minimize its weight, but not to the extent where the
axial stress generated in the beam increases beyond a specified value.
The nature of a design constraint depends, primarily, on the type of analysis solution you are performing. In
general, you define a constraint much the same way you define an objective except you give additional
information, the most important being the bounds in which the response must remain such as stress not
exceeding a particular value.
constraint is valid. For frequency and transient response, the constraints per frequency and/or time step can
be defined. Bt default all frequency and/or time steps are used.
Global Constraints
Weight, Volume, Fractional Mass, Average Compliance, Compliance, and Total Strain Energy are global
constraints that can be setup that require only the upper and/or lower bounds to be specified. The latter two
are valid for linear statics and normal modes only, respectively. Total Strain Energy requires the mode of
interest to be specified.
Constraint Sets
These are named sets of Design Constraints that can be selected later on when defining a Design Study
instead of selecting individual Design Constraints.
Maximum/Minimum Definitions
These are collections of responses for which special consideration is given to minimize (or maximize) the
maximum response of the collection. An example might be minimizing the stress in a set of elements where
each element response is setup separately as a Response. Thus they are all collected together in a Min/Max
definition.
When an input deck is created, each response is written to the input deck using a DRESP1 entry. The
DESRP2 entry is then used to associate all the DRESP1 entries and the BETA function keyword used to
indicate minimizing the maximum response. The constants C1, C2, and C3 are optional and default to 1.0,
0.005, and 10.0 respectively if not explicitly given. These constants are used in optimization equations as
explained in the Nastran Quick Reference Guide under the DRESP2 entry. C1 weights the design variable, C2
sets an initial value, and C3 provides an offset to avoid dividing by zero.
654 Tools>Design Studies>Post-Process
Design Study Results
After running a topology optimization analysis in SOL 200 of MSC Nastran, use the Action:
Read Results - to first import the new mesh from a jobname.des. This file is created by the analysis
run. Or import from a jobname.xdb file if PARAM,POST,0 is included in the input deck.
Display Results - to view the results of the optimization run. A shaded or fringe plot of element
density distribution is created. Each time a plot is created a new group is created (defined by the
user, default = HIGH_DES_GRPn) and used to post the results on the elements associated to the
result case selected. The target elements, when creating the element density plot, can be the "Entire
Model", only elements posted and visible in the "Current View", or elements with selected
"Properties". If you select "Current View" please be aware that when you make a plot, a new group
is created and posted. If you make a subsequent plot with different results, the "Current View" is
now the new group posted. To avoid an unexpected plot, make sure the group or groups with the
desired target elements are posted first. The one exception to this is if the posted group is the same as
the group to be created as listed on the form, then "Current View" will not be used, but the previous
set of posted groups.
FEM Smooth - to smooth the mesh. During this operation the elements are modified. A backup
database is created to preserve the original model in case you need to revert back to the original
model before smoothing.
Tools>Results 655
Results Tools
This cascade menu provides access to the following results plotting or post-processing capabilities:
1. Tools>Results>Bar/Spring Forces 656
2. Tools>Results>Bar End Loads 660
3. Tools>Results>Max/Min Sorting 667
4. Tools>Results>Shear Panel Plots 675
5. Tools>Modeling>Explore 678
6. Tools>Results>Plot Sets 679
7. Tools>Results>Templates 696
8. Tools>Results>Test Correlation 706
9. Tools>Results>NEF Random Vibration 707
656 Tools>Results>Bar/Spring Forces
Investigating Bar/Spring Force
678.1
1174.3
636.7
For Bar/Spring Forces and Moments, the Element Force Table produced during an MSC Nastran analysis is
required and therefore is accessible only for the MSC Nastran Preference. Make sure there is a “FORCE=”
case control entry in the MSC Nastran input deck. If the elements have properties, the XY plane definition
is used to determine the element directions. The positive results directions for the shear forces and moments
are according to the MSC Nastran convention, see below. If a value is negative, the vectors are plotted in the
positive directions with negative values.
v
yelem Plane 1 xelem
wb
Grid Point GB
θx
θy
Plane 2
θz zelem
yelem v1
wa
zelem v2
Μ2a
x
Μ2b
a b
Plane 2
v2
Tools>Results>Bar/Spring Forces 657
Investigating Bar/Spring Force
The Bar/Spring Forces and Moments main form appears as shown here. Each widget option is explained in
the tables below.
Parameter Description
Results Cases Displays any load/results cases and their subcases. If listbox is empty, then
no results exist in the database. If the selected results case does not have
Grid Point Force data and Element Force data then Apply generates an
error message explaining which result type was missing.
Display Options Accesses a form to manipulate the format of the displayed results. In this
form you can choose to display the results as components or resultants,
change the color, modify the scale of the vectors, and other display
functions.
Vector Position Shrink Controls the displacement of the vector base from the bar node. Offsets
the display from element nodes and element edges toward the element
center. 0.0 indicates the label will be plotted on the corners and 1.0
indicates all the labels will be plotted on the element centers.
658 Tools>Results>Bar/Spring Forces
Investigating Bar/Spring Force
Selection Method Controls whether the bar/spring forces and moments are plotted on
selected bar elements or bar elements in selected groups.
Display Options
Show Options are: Force, Moment, Force/Moment and Springs.
Display As Options for the display of the force and/or moment are Component or
Resultant.
Fx, Fy, Fz, etc. The components change based on your option selection for Show.
Display Values Values are plotted alongside the arrow. The format of the values is
controlled by selecting Exponential or Fixed and by specifying the
Exponential/Fixed significant digits.
Significant Digits
Display Title
Parameter Description
Results Cases All of the Results Cases that exist in the current database are shown. If the
listbox is empty, then no results exist in the database. If the selected results
case does not have Grid Point Force data and Element Force data, then
press Apply to generate an error message explaining which result type was
missing. Only one result case may be selected and this is highlighted.
Display Options Press the Display Options button to display the following form in order
to enable further plot control.
Include Membrane Loads Setting this toggle will result in all inplane shell forces being incorporated
in the calculation of bar end forces.
Selection Method Controls whether the bar end loads are plotted on selected bar elements
or bar elements in selected groups.
Display Options
Plot Bar End Loads Bar end load values may be enabled or disabled. If enabled, the color of
the labels can be controlled through a palette of available colors.
Load Label Position Shrink Offsets the display from element nodes and element edges toward the
element center. 0.0 indicates the label will be plotted on the corners and
1.0 indicates all the labels will be plotted on the element centers.
Plot Shear Flow Offsets the display from element nodes and element edges toward the
element center. 0.0 indicates the label will be plotted on the corners and
1.0 indicates all the labels will be plotted on the element centers.
Format Type User can select display results in either fixed pointk or scientific notation
format.
Display Precision Moving slide bar to right increases the number of significant digits
displayed.
Display Title
662 Tools>Results>Bar End Loads
Investigating Bar End Load
Tools>Results>Bar End Loads 663
Investigating Bar End Load
Requirements
There are certain requirements that must be met in order for the bar end forces to be plotted.
1. The MSC Nastran analysis must be run with GPFORCE=ALL and FORCE(SORT1, REAL,
BILIN)=ALL in the Case Control for all subcases. PARAM,POST,-1 must appear in the Case
Control or Bulk Data Section of the input file to ensure that the Grid Point Force Balance Table is
written to an OUTPUT2 file.
2. The existence of two results quantities in the database is required for the execution of the Bar End
Loads application. The name of these results can be seen in the Results application. They must not
be altered or deleted. The labels are:
• Grid Point Forces, Elements
• Bar Forces, Translational
Description of Calculations
Below is a simple model that is used to show a sample calculation. It is fixed on the left side and loaded with
1000 lbs. force distributed to the 3 nodes on the right. All the elements are in the XY plane.
333.33
12
8
17 333.33
11
9 23
7
6
16 333.33
14 10
8 22
6
21
15
5
11 4 13
7
3
5
19 20
2 10 12
3
2 4
18
1 9
For the example calculations, Elements 12 and 20 are used. Element 20 is a quad element with membrane
properties. Element 12 is a bar element with CBAR properties.
664 Tools>Results>Bar End Loads
Investigating Bar End Load
8
(33.7346, 28.3195)
7
13.821
6.915
7
5 12
20
Direction Cosine
<0.765, 0.643, 0.0>
4
8.297
14.679 (22.4923,18.8797)
4
This Bar End Loads and Shear Panel Flow calculation requires the Grid Point Force data to be aligned along
the panel element edge. For each element node, a matrix of the direction cosines of the two adjacent edges
and the normal to those directions is inverted.
Direction Cosines 8
Matrix of Direction Cosines Inverted Matrix
<-0.812, -0.583, 0.0> Node 4 Node 4
13
5 0.765 -0.009 0.0 1.316 -0.012 0.0
<0.009, 0.999, 0.0>
7
5 0.643 -0.999 0.0 0.846 -1.008 0.0
20
The inverted matrix is then multiplied by the Global Grid Point Force for that element at that node.
Tools>Results>Bar End Loads 665
Investigating Bar End Load
5 -50.4
1.316 -0.012 0.0 184.0 242.6
13
-378.4
287.8 7 0.846 -1.008 0.0 -33.3 189.3
5
20
184.0 4
-33.3
These transformed values are used for the remaining calculations in which Grid Point Force data is required.
The Bar End Loads are calculated using the Bar Force loads from the results file. The Bar Force results contain
the element axial load values. The Grid Point Force for each end of the bar element is subtracted from the
axial load for each element. These become the bar end loads for that bar element.
Max/Min Sorting
The Max/Min Results Sorting postprocessing utilities permit sorting of results across multiple load cases
based on a user-specified criteria. The results of the sort are displayed on each element with the load case and
the maximum (or minimum) value. This utility is only accessible from the MSC Nastran Preference.
This utility enables the user to compare results obtained in other databases as well as across multiple results
cases. In addition, the user can sort results for either selected elements or nodes as well as by groups or current
viewport. Results obtained from any Max/Min sort may also be saved to a report file.
Parameter Description
Compare Other Models... Select to enable Max/Min sorting across multiple databases.
668 Tools>Results>Max/Min Sorting
Max/Min Results Sorting
Select Results... Select to specify which results for a Max/Min sort. You can select results
in any of the databases previously specified.
Controls... After the results are specified, select to specify how the results of a
Max/Min sort are displayed.
Sort As: Type of Max/Min sorting can be varied. Options include: Max-Algebraic,
Max-Absolute, and Min-Algebraic.
Select By: Specify which entities are to be included in the Max/Min results sort.
Options include selecting by node/element ID, group or viewport. For
multiple databases only elemental results may be specified.
Write Report File Toggles to enable results of a Max/Min sort to be written to a standard
report file.
Reset Graphics Resets the display to remove any Max/Min plot markers.
Apply Performs a Max/Min sort and displays the results in the current graphics
viewport as well as in a report file, if requested.
Parameter Description
Existing Databases All Patran databases in the working directory are displayed. Any selected
models are highlighted.
Add to List You must manually add the databases to the select list box below.
670 Tools>Results>Max/Min Sorting
Max/Min Results Sorting
Selecting Results
If you choose Select Results on the main Max/Min Result Sorting form, the following menu displays. Select
which results cases to compare from either the current or multiple models as well as the specific result type.
Tools>Results>Max/Min Sorting 671
Max/Min Results Sorting
Parameter Description
Select Results Cases All of the Result Cases contained in the selected models to be compared
are listed. Selected Result Cases are highlighted. The numeric prefix in
the result case label is of the form:
Display Options
If Control was selected from the main Max/Min for, the Display Options form displays. In the Display
Options form, the user can change the default display properties of the Max/Min sorted results.
Parameter Description
Value / Result Case Select the color-filled box to display a palette of colors. Depress and hold
the mouse button, scroll over to the desired color and then release the
mouse button. This becomes the color that is used to identify the result
case and value labels that appear in the Max/Min Results plot, which can
be turned ON or OFF with the toggles.
Tools>Results>Max/Min Sorting 673
Max/Min Results Sorting
Format Type Alters the format and precision of the displayed results.
Display Precision
Display Vectors Varies the position and size of vectors when displaying vector results.
Display Result Titles Set to display Results Titles in the Max/Min Sorted plots for the current
viewport.
Coordinate Transformation Select from one of the available options if you wish to transform the
results into a different coordinate system.
Result Positions Specify where results are plotted on elements.
Result Scale Factor Scale the results if desired.
Max/Min Legend
The Critical Results Cases legend is presented to the user with all the Load Case names that satisfy the
Max/Min Sort criteria. The user may then select those results associated with particular Load Cases to display
in the graphics viewport. The default is to display the results associated with all critical load cases.
This functionality is particularly useful if a large number of load cases satisfy the Max/Min Sort criteria, but
only a limited set are associated with the current region of the model. The extraneous information may be
disabled resulting in an uncluttered display of the key results of interest.
Parameter Description
Filter Select this to deselect all of the load cases contained in the list box. You
may use the databox to specify key characters to filter the list of displayed
result cases. The “*” is a wild card.
674 Tools>Results>Max/Min Sorting
Max/Min Results Sorting
Result Cases List Box All Critical Load Cases satisfying the Max/Min sort criteria are initially
highlighted. Those that are not desired to appear in the display may be
un-highlighted. The numeric prefix in the result case label is of the form:
Database ID:Load Case ID.Subcase ID.
Apply Select Apply to enable any changes made by the user and these changes
immediately display in the viewport.
Done Select Done to close out the form and enable changes made by the user
for any subsequent Max/Min plots.
Save To File Select Save to File to save the contents of the Critical Results Cases list
box to a report file.
The results of the Max/Min Sort are displayed graphically on each selected element of the model. The
maximum (minimum) result for the selected elements or elements in the selected groups from the selected
load cases maybe displayed at either the element centroid, nodal or both positions. Nodal results are always
displayed at the nodes as shown below.
Critical condition information includes number of Load case identification, the bracketed number
identified conditions from initial list and names of corresponds to the load cases identified in the legend.
selected critical conditions.
Tools>Results>Shear Panel Plots 675
Shear Panel Plots
q2
q4
G2
q1
G1
676 Tools>Results>Shear Panel Plots
Shear Panel Plots
Parameter Description
Results Cases Displays any load/results cases and their subcases. If this listbox is empty,
then no results exist in the database. If the selected results case does not
have Element Force data then Apply generates an error message
explaining which result type was missing.
Display Options Press the Display Options button to display the following menu for
further plot control.
Selection Method Controls whether the shears are plotted on selected elements or bar
elements in selected groups.
Display Options
Label Position Shrink Offsets the display from element nodes and element edges toward the
element center. 0.0 indicates that the label is plotted on the corners and
1.0 indicates all the labels are plotted on the element centers. This is
useful in differentiating the edge shears of adjacent elements.
Force or Stress Determines whether to display the element shear forces as is or convert to
stress.
Plot Average Shear Stress Offsets the display from element nodes and element edges toward the
element center. 0.0 indicates the label will be plotted on the corners and
1.0 indicates all the labels will be plotted on the element centers.
Plot Edge Shear User can select display results in either fixed pointk or scientific notation
format.
Display Precision Moving slide bar to right increases the number of significant digits
displayed.
Display Title
Tools>Results>Shear Panel Plots 677
Shear Panel Plots
Below are a Shear Element Plot of forces with Plot Average Shear selected, a Shear Element Plot of forces with
Plot Edge Shear selected, and the same plot with Label Position Shrink offsets so the edge shears on adjacent
edges can be seen.
Requirements
To make a Shear Panel Plot, Element Forces must be requested when submitting the analysis. The shear
element results data is imported from the MSC Nastran results file, creating a result type of Shear Panel
Forces, Shear. The result contains four values for each Shear Panel element. The values represent the q1, q2,
q3, and q4 edge shears.
678 Tools>Modeling>Explore
Exploring Results Quantities
Explore Results
MSC.Explore is a complementary module of Patran to enable rapid identification and visualization of critical
design results from MSC Nastran analyses. This is a single program with many capabilities. MSC.Explore
provides a new way of looking at MSC Nastran results across multiple load cases and multiple result files
instead of the traditional one-load-case at a time approach. MSC.Explore uses an efficient GUI interface for
selecting and viewing results. This single tool processes Static, Transient and Frequency Response Analyses
and produces web-based HTML and ASCII text output in addition to graphical output.
Benefits
Using MSC.Explore has many advantages because it:
Comprises a single program with many capabilities that incorporates industry-wide methods and
expertise
Processes Static, Non-linear, Transient, and Frequency Response Analyses with one tool and gives
faster and more reliable critical design information
Efficiently processes MSC Nastran results from a large number of load cases
Substantially reduces the time spent analyzing MSC Nastran results
Manages large volumes of data better than any other commercial preprocessor or postprocessor and
facilitates large-scale analyses
Automates the results-synthesis by incorporating large amounts of results data among multiple
results files
Provides a low-cost, low-maintenance tool that avoids high-cost maintenance and development of
in-house code
Analyzes larger FEA model results using current hardware resources
Requires neither an additional translator program nor additional intermediate files which save disk
space
Produces output that is web-based HTML as well as ASCII report output.
This tool is only accessible via the MSC Nastran Preference. Access to the full documentation for
MSC.Explore can be found in a PDF file in the Patran installation directory (P3_HOME):
$P3_HOME/mscexplore_files/mscexlpore_documentation.pdf
Tools>Results>Plot Sets 679
Creating Plot Sets
Parameter Description
Action
680 Tools>Results>Plot Sets
Creating Plot Sets
Create The Create form shows the Plot Sets that exist in the Patran database.
With this form you can enter a new Plot Set name, description, and
toggle the overwrite button. The Plot Set names are limited to 79
characters but there is no limit to the size of the description you can enter.
Copy The Copy form shows the Plot Sets that exist in the Patran database.
With this form you can enter a new Plot Set name and its description. If
the name you have assigned is equal to an existing name, the new Plot Set
will replace it if the overwrite option has been selected. When the apply
button is pressed a new Plot Set will be generated and the contents of the
selected set will be copied to it. If you did not enter a Plot Set description
a warning message will appear. The warning does not effect the creation
of the Plot Set.
Edit The Edit form shows the Plot Sets that exist in the Patran database. To
edit a Plot Set select it from the list and press the Edit button. When the
Edit button is pressed the Plot Set Edit Spread Sheet will appear. For
details on editing a plot set, please see, Editing a Plot Set Using the Plot Set
Spread Sheet, 680.
Import With the Import form you can enter the name of the Plot Set file you
would like to import located in your current working directory or you
can select the “Files...” submenu to specify the complete path to the file
you would like to import. An option is present so you can over write a
Plot Set that exists in the Patran database. This toggle has higher
precedence than any overwrite flags specified in the imported file.
Export The Export form shows the Plot Sets that exist in the Patran database.
With this form you can choose one or more existing Plot Sets to export.
You may use the “Files...” button to select or enter the name and path to
the file that will receive the exported Plot Sets. You can also just enter this
information directly in the File Name data box. An option is present to
allow over writing an existing Plot Set file.
Delete The Delete form shows the Plot Sets that exist in the Patran database. To
delete either single or multiple Plot Sets first select the Plot Set(s) and
then press the “Apply” button.
Print The Print form shows the Plot Sets that exist in the Patran database that
you can print to a JPEG file. The Preview Only toggle will preview the
plots contained in a Plot Set(s) within Patran’s graphics viewport(s)
before printing them to JPEG files. With the Save Plots To Db toggle you
can persist the plot definitions within the Patran database.
In the example shown above the “Tee Model - Static Analysis” plot set is empty. When plot sets are created
using the Create user interface you can enter the plot set name and a text description of the plot set but not
the contents of the plot set. The Edit user interface has been provided to allow you to define the contents of
your plot set.
To add a row to the plot set simply press the Add Row button. Once the Row Control sub form appears
change the Action to Add Row, enter a row name of your choice, select a Row Type, and finally press the
Apply button.
Here a Fringe Plot row type is being added to the spread sheet. After creating a second row of type, Deform
Plot, the spread sheet should appear as shown below.
682 Tools>Results>Plot Sets
Creating Plot Sets
The plot set now contains two Plot Type rows but the definition of these rows are incomplete. Plot Type rows
contain columns that represent the plot’s Results data, graphic Attributes, and Target entities. To define the
contents of a column cell just click on that cell. Shown below is an example of editing the Results cell within
the Fringe Plot row. Here a Result Case, Result Type, and Derived Value have been selected within the Result
Control submenu that appeared. Clicking the Apply button will accept the selected values and close the
Result Control form.
Tools>Results>Plot Sets 683
Creating Plot Sets
Similarly by selecting the Attributes cell within the Fringe Plot row the following Attributes Control sub form
will appear.
684 Tools>Results>Plot Sets
Creating Plot Sets
A fringe plot’s graphical attributes are defined by selecting an existing Fringe Result Template that has been
previously persisted in the Patran database. Any viewports, views, spectrums, or ranges that also currently
exist in the Patran database are shown in the various list boxes. You can choose one or more selections from
each list box. These selections will over-ride the definition that is contained in the selected Fringe Result
Template. Multiple selections from any of the list boxes will influence the number of plots that will be created
when you use the Plot Set Print functionality to preview or print the contents of the Plot Set Spread Sheet.
See Appendix B for a detailed discussion of the two types of Plot Iterators that cause multiple plots to be
rendered when multiple definitions of a plot attribute have been selected.
With the Attributes Row Control form you can add a plot name to the row’s plot definition. By saving the
plot with a name you are able to post or modify this plot when using the Patran post processor. The Print
Filename edit box allows you to assign the path to and name of the image files that will be produced when
you run the completed spread sheet.
Tools>Results>Plot Sets 685
Creating Plot Sets
The final step to complete the definition of the fringe plot row is to enter the plot target definition. Shown
below is the Target Row Control sub form that appears when you select the Target cell in the row.
The Row Control form shown above allows you select multiple target definitions for your plot row thus
allowing you to create multiple plots from a single row relative to the number of target definitions you have
chosen. To create a target definition select the Create Target Definition button. The following definition
form will then appear. Your choice of plot target types that you can create are those that are used within the
Patran post processor (e.g. Current Viewport, Elements, Groups, Properties, and Element Types). First select
a target type using the Target pull down menu. Next, select various choices that appear in the target types
subordinate list boxes. Shown below is an example where the user has created three target definitions using
the Current Viewport, Groups, and Elements options.
686 Tools>Results>Plot Sets
Creating Plot Sets
Once you press the OK button in the Row Input sub form the target definitions will appear in the Row
Control form. To complete the Plot Row’s target definition you must select one or more of the target
definitions you have created and then press the Apply button as shown in the example below.
Tools>Results>Plot Sets 687
Creating Plot Sets
You must now perform similar operations for the Deform Plot row to complete its definition.
To create a combination plot all you need to do is add a new Plot Sheet row that is of type Combination, and
place that row above the plot type rows you desire to combine. To do this press the Add Row button, set the
Row Type to Combined Plot within the Row Control sub form that appears, and then press the Apply button
to cause the Combined Plot row to appear in the spread sheet.
688 Tools>Results>Plot Sets
Creating Plot Sets
When you create the Combined Plot row it will be added as the last row in the spread sheet. You now must
move the row above the plot type rows you want to combine (e.g. to row 1 position in our current example)
and then edit the Combined Plot row’s data, setting the number of rows that you will combine to 2. To move
the row first select the Combined Plot row’s Row Name cell. This will cause the selection of option buttons
to change at the bottom of the spread sheet. Select the Move Row option button. The Row Control sub form
that contains the various move options will appear. Select Beginning from the Position option pull down
menu as shown below.
Tools>Results>Plot Sets 689
Creating Plot Sets
Pressing the Apply button will cause the Combined Plot row to move to the row 1 position and the Fringe
and Deform plot rows to shift down one position. Next, select the Data cell in the Combined Plot row. When
the Row Control sub form appears enter 2 in the Number of Rows list box. This causes the following two
plot type rows to be used to form the combined plot.
When the Apply button is pressed the Print Control submenu and the first image defined by the Plot Set
contents will appear as shown below.
Tools>Results>Plot Sets 691
Creating Plot Sets
If your Plot Set definition defines more than one plot press the Advance One Image button to advance to the
next plot. Pressing the RESUME button will cause Patran to quickly render the remaining plots defined by
your Plot Set. When you have finished reviewing the last Plot Set image the Print Preview sub form will close
and the Print function will try to return Patran’s display back to its initial state before you started the Plot Set
preview as shown in the example below.
692 Tools>Results>Plot Sets
Creating Plot Sets
In the example we have been following above we defined a plot set that contained a single combined fringe
and deformed shape plot. With very few changes we can modify this example to produce several plots with
out adding another plot set row.
Tools>Results>Plot Sets 693
Creating Plot Sets
In the example shown below the Plot Set is edited by selecting Fringe Plot Results cell to cause the Results
Row Control form to reappear. In addition to our initial selection of the von Mises Derived Result all six
stress components of the symmetric stress tensor have been selected at both the Z1 and Z2 positions.
Our final edit will be to change the default Tuple iterator to the Product Iterator. This is done by selecting
the Data cell of the Combine Plot row to cause the Combine Plot Row Control sub form to appear. The
Iterator Type option is used to change to the desired Product Iterator type. See Appendix B for a detailed
discussion of the different Iterator Types. The changes we have just made will cause 14 combination plots to
be rendered. The Product Iterator forms the combination plots from the single displacement plot with the
14 possible fringe plots.
694 Tools>Results>Plot Sets
Creating Plot Sets
Example 1: If you select multiple entries in either the Result Cases or Layer Locations list box and then select
the NONE option from the associated Combination Methods list box, multiple plots for the different
selections will be generated relative to the Iterator type you have defined in the Combination Plot row’s Data
cell.
Tools>Results>Plot Sets 695
Creating Plot Sets
Example 2: If you select multiple entries in either the Result Cases or Layer Locations list box and then select
the NONE option from the associated Combination Methods list box, then the selected data sets will be used
to form a single data set whose entries are the point by point maximum of the data contained within the
selected data sets.
In the Result Row Control form shown to the right multiple Result Cases have been selected. When multiple
Result Cases are selected the Result Type entries that appear are the intersection of the results types contained
in the data sets identified by the selected Result Cases (for a selected Output Type). Likewise, the Layer
Location entries that appear are an intersection of the layer locations contained within the data sets identified
by the selected Result Types and Cases.
696 Tools>Results>Templates
Applying Results Templates
Result Templates
Results Templates provide a convenient means of storing in the database collections of settings that you can
use to create plots, graphs and reports under the Results menu. Settings stored in Results Templates are
applied to the Results Display Attributes and Plot Options menu settings for the following results tools:
Deformation Plot, Fringe Plot, Marker Vector Plot, Marker Tensor Plot, Graph, and Report.
The Results Templates menu provides the ability to Create, Edit, Copy, Delete, Export, and Import results
templates and then a means to Apply the template values to the Results Display Attributes and Plot Options
menu settings. Once you Create and Apply a Results Template from the Tools menu, you can go the Results
menu and select the “Use Templates” option. For more information on the Use Templates option, see Use
Templates (p. 28) in the Results Postprocessing.
Patran can also be customized to automatically load into a new or opening database a set of predefined Results
Templates.
Parameter Description
Object Defines the Results tools to which the Template will be applied.
Existing Deformation Select an the existing template to apply. The list includes templates that
Templates match the selected object.
Parameter Description
Action
Tools>Results>Templates 699
Applying Results Templates
Create Accesses the settings of the Results Display Attributes or Plot Options on
a Results form and creates a template. You have the choice of “Use Tool
Values” or “Use Form Values.” Selecting “Use Form Values” requires that
the corresponding Results form to Create or Modify the same Object
already displayed before the template values can be read from the Results
Display Attributes or Plot Options forms. For example, before creating a
Deformation template using the Results forms, you need to display either
the Create Deformation or Modify Deformation results menu and set the
Attributes and Options menu items to the desired settings.
Edit Editing uses the Results Display Attributes and Plot Options forms to
display the Results Template Values when the “Apply To Results Forms”
button is clicked. The corresponding Results form to Create or Modify
the same Object must already be displayed before the template values can
be applied to the Results Display Attributes and Plot Options forms. For
example, before applying a Deformation template to the Results forms,
you need to display either the Create Deformation or Modify
Deformation results menu.
Go to the Results Display Attributes and Plot Options forms and modify
the settings as desired. Return to the Results Template Edit form.
Clicking the “Use Current Form Settings” will cause the currently
selected results template to be modified according to the current settings
of the Results Display Attributes and Plot Options forms.
Copy The “New Template Name” must be unique for its Object type
(Deformation, Fringe, etc.).
Delete Deletes an existing template.
Object Defines the Results tool to which the template will apply.
700 Tools>Results>Templates
Applying Results Templates
Method “Use Tool Values” extracts the Results Display Attributes and Plot
Options values that were stored in the database in a Results tool. “Use
(for Creating Templates) Form Values” reads the Results Display Attributes and Plot Options
values directly from the Results forms. If you select “Use Form Values”
the corresponding Results form with the same Object must be displayed
before the template values can be read from the Results Display
Attributes and Plot Options forms.
Existing Deformation Select an the existing template to use. The list includes templates that
Templates match the selected object.
New Template Name The “New Template Name” must be unique for its Object type
(Deformation, Fringe, etc.).
Template Description The Template Description is optional. It lets you attach notes about the
results template to its database record. This can be helpful in keeping
track of your different results templates.
Select Deformation Tool Selects the Deformation Tool to use for the Results template.
Tools>Results>Templates 701
Applying Results Templates
Overwrite Db Template If the “Overwrite Db Template” toggle is set and the database already has
a results template of this type and name, it will be overwritten or replaced
with the new results template values.
Spectrum & Range... This button brings up the Results Template Spectrum & Range form.
Use this form to optionally select which color palette, spectrum and range
will be used for results plots using this template. You can also use this
form to store the exact definition of a color palette, spectrum and/or
range in the results template. Then, when this template is used to create
a result plot these definitions will be used to create the color palette,
spectrum and/or range for the plot. They will have the same attributes
and options settings as the original.
Parameter Description
Action
Export The export menu takes selected Results Templates from the database and
writes to the file the session commands that would create the same
database content. These commands can then be used to recreate the
exported results templates in other databases (see the Import menu), or as
a standard set to be loaded into new or opened databases (see Auto Load
Details section of document).
Import The Import menu prompts you to select an existing Results Template to
import into the database.
Tools>Results>Templates 703
Applying Results Templates
Object Defines the Results tool to which the template will apply.
Existing Deformation Select an the existing template to export. The list includes templates that
Templates match the selected object.
Set Overwrite Flag The “Set Overwrite Flag” toggle controls whether or not to overwrite
existing results templates of the same name and type when the file is later
imported or used for template initialization at database open or new
database creation. Setting the toggle turns ON overwrite.
Files... Browses and selects a Results Template to import.
Overwrite File/ When exporting, the “Overwrite File” toggle controls whether the export
file will be overwritten or appended to if it already exists. Setting the
Overwrite Db Template toggle causes it to be overwritten, while if it is not set, the export will
append to the end of the file if the file already exists.
When importing, the “Overwrite Db Template” toggle controls whether
a preexisting results template of this type and name will be overwritten or
replaced with the new results template values.
If force_over is true, this will take precedence above the overwrite argument to res_temp_create_over. This
can be useful in the auto load files. The force_over value is reset to FALSE when using the results template
forms, so you will need to call res_tmpl_set_force_overwrite(TRUE) again after doing anything with the ui.
It is best just to call it whenever you want force_over to be true and not worry about when it gets unset.
The files processed during the automatic loading process will be logged to a file in the working directory
named “ResTmplAutoLoadLog<random number>.ses and then this session will be played.
For more information see, The settings.pcl file (p. 61) in the Patran Reference Manual.
706 Tools>Results>Test Correlation
Correlating Analysis to Test Data
The utility is simple to use once these files are available. Simply follow these steps:
1. First select the type of plots to create. Either:
• PSDs (Power Spectral Density functions and the TF of stress)
708 Tools>Results>NEF Random Vibration
Random Vibration Fatigue
• logX, logY - changes to the X or Y-axes to log scale if ON. Not applicable for time history plots
when simply turning the toggle ON/OFF.
• Dots - plots markers at actual existing point locations
• Bars - plots the curves as bar chart. This is only used for PDFs of Rainflow ranges (Cycles) and
requires that the curves be regenerated.
• Minimum/Maximum Frequency (or other quantity) - changes these slider bars to zoom in or
zoom out of the X-axis. Not available for log axes or plots with a time based X-axis.
7. Press OK or Cancel to close the form and exit the application. When exiting the application the XY
Windows are closed (but not deleted). If you manipulate the XY Windows (resize or move) they will
appear as you left them should you reenter this application and make more plots. All curves
themselves are deleted when the application is closed unless the Save Curves toggle was ON when the
plot was made. The difference between the OK and the Cancel buttons is simply that the OK button
saves the setting on the form so that when you reenter the application the settings are as you left them.
However, the Cancel button restores the setting to the previous values before you opened or reopened
the form.
An example of the PSDs plotted. The input PSD, the Transfer Function of Stress, and the stress output PSD:
710 Tools>Results>NEF Random Vibration
Random Vibration Fatigue
An example of the running sum Moments plotted (m0, m1, m2, m4) versus frequency:
An example of the cycle plots (PDFs of rainflow ranges) showing cycles to failure versus stress bins, allowable
cycles to failure versus stress bins, and actual damage versus stress bins with the bar chart view:
An example of plotting damage verses sweep frequency and same plot versus Event ID. If a results type is
selected and a <jid>CFV.log file exists with sweep frequency data in it, the x-axis displays frequency,
Tools>Results>NEF Random Vibration 711
Random Vibration Fatigue
otherwise it displays Event ID. If the frequencies are not in ascending order or there is a zero frequency, data
is displayed versus Event ID.
An example of the material plots (S-N curve and FE Stress vs local strain). Note that if only the S-N curve
file is available, then only one plot is posted. To get both plots, Strain-Life data must be supplied.:
712 Tools>Results>NEF Random Vibration
Random Vibration Fatigue
An example of FFT (fast fourier transformation) data from the TIM2PSD operation showing the resulting
PSD, the original time history, and the reconditioned time history for three channels of data (superimposed).
Limitations:
1. When plotting PSD data, only the resultant stress PSD can be plotted for multi-input PSD problems.
For single input PSD problems the input PSD, the transfer function and the output stress PSD can
all be plotted. But multi-input PSD have multiple direct and cross PSDs and their corresponding
TFs, which are impractical to plot with this application and are simply not output by MSC Nastran
in this form. The output PSD, however, is always output as there is ever only one for any input point.
2. When plotting Event data, there must be multiple events or multiple frequencies in the case of sine
or narrow band sweep analysis. If there is only one event, these plots will appear blank.
3. It is highly recommended that when configuring MSC Nastran to output this data for subsequent
plotting in Patran, that you be very selective in which entities you output as the data can be enormous
if all or too many entities are requested. Use the FTGDEF entry to limit the number of entities
requested in the vibration fatigue analysis to mitigate performance issues if the data is too large for
this tool to process efficiently.
Tools>User Defined AOM 713
User Define Action/Object/Method Forms
*ACTION: Create
*OBJECT: Mesh
*METHOD: Pattern
*DATABOX: Type = STRING, Value = String, Label = A
*DATABOX: Label = Int, Value = 4, Type = INTEGER
*SDBOX: Grid Sdbox, Value = [ 0 0 0 ], Type = GRID
*SFRAME: YES
*SDBOX: Label = Sdbox, Value = [ 0 0 0 ], Type = NODE
*SDBOX: Label = 2Sdbox, Value = [ 0 1 0 ], Type = NODE
*SDBOX: Label = 3dbox, Value = [ 1 1 0 ], Type = NODE
*FUNCTION: Example_CMP
*ENDFORM
*ACTION: Create
*OBJECT: Bottle
*METHOD: From Parameters
*DATABOX: Int, Value = 4, Type = INTEGER
*DATABOX: Label = F, Type = STRING, Value = STRiNG
*DATABOX: Label = Float, Value = 0.3, Type = REAL
*HELP: Key = mesh_create_surface
*FUNCTION: Example_CBPr
*ENDFORM
*ACTION: Create
*OBJECT: Bottle
*METHOD: From Pattern
*LABEL: Label = Pick Your Pattern
*OPTIONMENU: Label = Pattern, Value = 1 Hole, Items = No Holes:1 Hole:2 Holes
*DATABOX: Label = Radius, Value = 1, Type = REAL
*FUNCTION: Example_CBPt
*ENDFORM
*ENDCUSTOM
714 Tools>Pre-Release
Access to Pre-Release Functionality
Pre-Release
These are items that are still under development but released for use by customers for evaluation and to give
feed back to Hexagon. They are not to be considered as production code and are provided as-is.
Tools>Pre-Release 715
Access to Pre-Release Functionality
716 Tools>Pre-Release
Access to Pre-Release Functionality
Chapter 12: Patran Model Browser Tree
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
Introduction
The Model Tree browser displays database entities on screen and perform actions to add, delete and modify
existing entities through the model tree. Not only can the database contents be viewed from the tree structure,
but by right clicking on the elements of the tree you can create, copy, paste, modify, or delete those database
entities and more easily navigate through different forms.
Easy visualizing, accessing, and manipulating of database entities through the model tree reduces learning
time, increases productivity and makes Patran more intuitive to use. The Model Browser Tree is available on
Windows and Linux platforms.
Getting Started
The Model Browser Tree (MBT) allows the user to quickly see what is in the current database in a user-
friendly tree structure. Database entities refer to material definitions, property sets, LBC sets, load cases,
fields, geometry, meshes, groups, analysis jobs, results, geometry and meshes. In addition to right mouse
button manipulation of the entities in the tree structure, drag and drop capabilities will be used in some cases
to create associations and toggle buttons to show/hide entities on graphics model.
The MBT is preference-neutral, e.g. generic, and as possible (like the icon ribbons) but there are some
preference-specific aspects (like the ribbon icons).
Thus, MBT reduces the number of mouse clicks and saves the time while traveling to number of options.
This makes the Patran GUI more efficient and modern.
Chapter 12: Patran Model Browser Tree 719
Availability
Availability
The Model Browser Tree is available on Windows and Linux platforms on both skin and non-skin modes.
Select ‘Show/Hide Model Tree’ button from ribbon bar to make Model Tree available after opening or
creating new Patran database.
Alternatively, the Model Browser Tree can also be posted or unposted with the use of command
toggleModelTree() in the Patran command window.
720 Patran Reference Manual
Tree View Form
Tree Control
Tree widget displays database items/entities in tree hierarchy. This is model browser tree control with below
functionalities.
Tree item – Each tree item will have
• Text label
• Icon
• Tree node connecting line
Checkboxes or toggle button – Toggle buttons will be available for those database entities which
supports post/unpost on the model view. Currently it is available with groups, LBCs and results type
of entities.
Pre-selection highlighting – Tree item will highlights and change the cursor type (hand) while user
move mouse over tree.
Selection highlighting – Tree item gets selected and shows highlighted by mouse left click and
combination with “shift” and “ctrl” keys in case of multiple selection.
Scroll – Vertical and horizontal scrollbars will display automatically when items goes beyond the size
of tree view window.
Drag/Drop – Drag and drop is supported for limited tree items.
Right click popup menu – Context sensitive popup menu will be displayed by mouse right click on
selected tree item.
Collapse/Expand tree nodes – Image(+ and -) or a double click on a parent node will
expand/collapse the node and show/hide the child items in it.
Double click on a child item – Double click on a child item will perform specific operation defined
for that node. For Material, Property, Fields, Group, Load case, and Results plot it will display the
Modify form. For Analysis it will display the Analyze form and for Result case it will display the
Create Result form.
Keyboard Delete – Selecting a single or multiple items and then pressing the Delete key on keyboard
will bring up a delete confirmation form and on confirmation the selected items will be deleted.
Delete operation is valid only for child items, it will not delete parent node and a UI error/warning
will be displayed. This functionality is supported only on Windows platform and will not work on
Linux.
Chapter 12: Patran Model Browser Tree 721
Context Sensitive Popup Menu
Configuration
Configuration window provides the different configuration options for Model tree and tree container.
Chapter 12: Patran Model Browser Tree 723
Search
Text font - Tree item font name. The default is Verdana. Available fonts are Arial, Calibri,
Trebuchet MS, and Times New Roman.
Text size - Tree item text size. The default is 12. Other available sizes are 10 and 14.
Text color - Tree item text color. The default is black.
Configuration settings and other state information (visibility, show transparent RMB option) are stored and
retrieved from the patran_conf.ini file. While loading Patran, if this file is present in current directory then
Patran loads the settings. Otherwise Patran searches the file in the HOME directory and then in the
P3_HOME location. If Patran does not find the file in these locations then it uses the above default values
and creates and/or updates the settings in the patran_conf.ini file in your current working directory when you
quit Patran.
Search
When this option is selected, a form will be displayed having edit control to specify search text and
next/previous buttons. The text specified is searched in the tree and shown if found otherwise error will be
reported. Search is case insensitive. You can search text forward or backward in the tree with Previous and
Next buttons.
724 Patran Reference Manual
Sort
Sort
There are two sorting methods supported to sort tree child items.
Alphabetical - Sort tree items in alphabetical order.
Creation order - Sort tree items in creation order.
Selecting same sorting method reverse sorting (ascending /descending) order. By default tree is generated by
its creation order and in ascending order. Only child items in the tree are sorted.
Chapter 12: Patran Model Browser Tree 725
Filter
Filter
When this option is selected, a form with a list of available type entities appears in the MBT. Only selected
type entities will be shown in the tree. This feature enables you to determine which category of entity appears
in the Model browser tree.
726 Patran Reference Manual
Materials
Materials
Materials tree item lists all the available material types and corresponding materials. Right mouse click on
material tree item will show the popup menu. Selecting any menu option will bring up the corresponding
form. In “skin” mode, “Materials” tab will be selected and corresponding ribbon options will be available to
the user.
Chapter 12: Patran Model Browser Tree 727
Materials
Properties
Properties tree item shows all the available property types and corresponding properties in the current
database. Right mouse click on any property item will show popup menu. Selecting any menu option will
bring up the corresponding form. In "skin" mode, “Element Properties” tab will be selected and
corresponding ribbon options will be available to the user.
730 Patran Reference Manual
Properties
Fields
Fields tree item shows all the available field types and corresponding fields. Right mouse click on any field
item will show popup menu. Selecting any menu option will bring up the corresponding form. In "skin"
mode, “Fields” tab will be selected and corresponding ribbon options will be available to the user.
Chapter 12: Patran Model Browser Tree 733
Fields
LBCs
LBCs tree item shows all the available LBC types and corresponding loads and boundary conditions in the
currently opened database. Right mouse clickon any LBC item will show popup menu. Selecting any menu
option will bring up the corresponding form. In "skin" mode, “Load/Boundary Conditions” tab will be
selected and corresponding ribbon options will be available to the user. Each LBC tree items will have
additional toggle buttons to plot/erase markers for that particular LBC.
736 Patran Reference Manual
LBCs
Contact
Contact tree item shows deformable bodies, rigid bodies, and body pairs in the current database. Right mouse
click on any contact item will show popup menu. Selecting any menu option will bring up the corresponding
form. In "skin" mode, “Load/Boundary Conditions” tab will be selected and corresponding ribbon options
will be available to the user.
Chapter 12: Patran Model Browser Tree 739
Contact
A Deformable Body item displays the associated element property if used as an application region. The Body
Pair tree item also displays the associated bodies that make up the Body Pair. A user can quickly perform
different actions on these items and sub-items from the Right Mouse Button (RMB) menu. Actions include
such as operations as Plot Markers, Plot Contours, Modify, Delete, among others. A check-box can be
selected/deselected for quick posting/unposting of LBC markers. And the Delete key can be used to delete
selected contact body and body pair items including their sub-items.
Chapter 12: Patran Model Browser Tree 741
Contact
Notes: Even if a deformable contact body has more than one element property in its
application region, only one element property is shown under that deformable
body in the MBT. However, the Application Region form shows all the
element properties.
Multiple body pairs under the Body Pair parent tree node do not get sorted in
the alphabetical and creation order in the MBT. However, the individual
contact body tree nodes under those multiple body pairs get sorted in the given
order.
A double-click on the MBT leaf item opens the Input Data form, whereas a
double-click on a non-leaf tree node expands or collapses its child nodes. With
the new contact hierarchy, Body Pair nodes now became non-leaf nodes. In
other words, associated bodies are now child nodes. Hence, double-clicking on
the Body Pair tree item expands or collapses the child nodes rather than
modifying the Body Pair. To modify the Body Pair, use the RMB and select
the Modify Data option.
Load cases
Load cases tree item shows all the available load cases. Right mouse click on load case item will show popup
menu. Selecting any menu option will bring up the corresponding form. In "skin"
mode, “Load Cases” tab will be selected and corresponding ribbon options will be available to the user.
Chapter 12: Patran Model Browser Tree 743
Load cases
Groups
Groups tree item shows all the available groups. Right mouse click on any group will show popup menu.
Selecting any menu option will bring up the corresponding form. Each group tree items has additional toggle
buttons to post or unpost particular group.
Chapter 12: Patran Model Browser Tree 745
Groups
Analyses
Analyses tree item shows all the available simulation jobs in the current database. Right mouse click on job
item will show popup menu. Selecting any menu option will bring up the corresponding form. Selecting
delete will delete the selected jobs.
748 Patran Reference Manual
Results
Results
Results tree item displays all the available result types and corresponding result cases. Right mouse click on
result plot or result cases item shows popup menu. Selecting any menu option will bring up the
corresponding form. In "skin" mode, Results tab will be selected and corresponding ribbon options will be
available to the user. For each result plot tree item will have additional toggle buttons to post or unpost results
on the graphics viewport for that particular results plot.
Chapter 12: Patran Model Browser Tree 749
Results
Customization
Right mouse button (RMB) popup menus for different entity types are configurable through xml files. For
more information, see: Right Mouse Button Customization, 329.
Chapter 13: Random Analysis
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuidePatran Reference Manual
13 Random Analysis
Introduction 752
Basic Random Analysis Theory 755
Random Analysis Process 761
Using MSC Random 765
Example 1: Cylinder subjected to base PSDF input. 767
Example 2: Table - Subjected to Simultaneous Random Excitation in Three
Directions 810
Example 3: Plate - Subjected to Pressure and Point Load with Cross Spectrum Input
823
Appendix A 837
Frequency Response Setup Using Patran Interface 845
752 Patran Reference Manual
Introduction
Introduction
Purpose
MSC Random is a random analysis software package for use with MSC Nastran and Patran. It was developed
by field engineers at MSC to offer a fast integrated random analysis solution from within the Patran
environment. All of MSC Random’s analysis capabilities and generated results are available from within the
PATRAN environment.
MSC Random software technology is similar to the existing MSC Nastran random analysis capability. In both
packages, random analysis is treated as a data reduction procedure that is applied to frequency response
analysis, but MSC Random offers additional capabilities and graphical interface.
The program uses the MSC Nastran XDB file from MSC Nastran frequency response analysis to calculate the
random responses. It calculates displacements, velocities, accelerations, SPCForce and MPCForce for grids
and stresses, forces and strains for elements as requested in the MSC Nastran case control data section in the
frequency response run. The program also creates a result file containing RMS responses that will be
automatically be imported into Patran for creating fringe plots of RMS response. A xy plot of PSDF response,
cumulative RMS, cross PSDF, relative PSDF or auto/cross correlation can also be created from within Patran.
MSC Random is also designed to make it easier for engineers familiar with MSC Nastran’s random analysis
capability to adapt quickly to this new procedure. MSC Random requires the same initial frequency response
run setup and the same random input format.
MSC Nastran
Limitations
1. Maximum number of output frequencies: 32,768.
2. Maximum Number of RANDPS entries: 250,000.
3. Maximum Number of TABRND1 entries: 250,000.
4. MSC Nastran elements supported CBAR, CBEAM, CROD, CONROD, CTUBE, CBEND,
CDAMP, CBUSH, CELAS, CQUAD4*, CQUAD8*, CQUADR*, CTRIA3*, CTRIA6*,
CTRIAR*, CSHEAR, CHEXA*, CPENTA*, CTETRA*.
* Centroidal and Corner Forces, Stresses and Strains
Chapter 13: Random Analysis 755
Basic Random Analysis Theory
Introduction
The information in this section has been adapted from MSC Nastran Advanced Dynamics Analysis User’s
Guide (Ref 1) and MSC Nastran 2004 Release Guide (Ref 2). The calculations performed by MSC Random
are essentially identical to MSC Nastran and any differences will be noted.
As with MSC Nastran, random response analysis with MSC Random is treated as a data reduction procedure
that is applied to the results of a frequency response analysis. First, the frequency response analysis is
performed for sinusoidal loading conditions, {Pa}, each a separate subcase, at a sequence of frequencies i. The
results are output to a normal XDB results file. At this point MSC Random is used throughout the Patran
interface to perform calculations of random responses such as auto and cross power spectral densities and auto
and cross correlation functions for all of the result data in the XDB file.
Each loading condition subcase represents a unique random load source, which may be applied to many grid
points. Typically, these loads are chosen to be unit loads such as unit “g” loads or unit pressures. The
probabilistic magnitude of each load source is defined by spectral density functions on RANDPS entries in
the random input file. If the load subcases are correlated, the coupling spectral density is also defined on one
or more RANDPS entries. An example of coupled spectral density would be the forces on four wheels of a
vehicle traveling over a rough road (see example 3 for Cross Spectrum Input).
Figure 2-1 is a simplified flow diagram for the random analysis. The inputs to the module are the frequency
responses, Hja(i), of quantities uj to loading conditions {Pa} at frequencies i, and the auto- and cross-spectral
densities of the loading conditions Sa and Sab. The response quantities, Sj, may be displacements, velocities,
accelerations, internal forces, or stresses. The power spectral densities of the response quantities are calculated
by different procedures depending on whether the loading conditions are correlated or uncorrelated. The
spectral densities due to all sources, considered independent, will be combined into one set of outputs.
756 Patran Reference Manual
Basic Random Analysis Theory
Theory
The application of frequency response techniques to the analysis of random processes requires that the system
be linear and that the excitation be stationary with respect to time. the theory includes a few important
theorems which will be reviewed. An important quantity in random analysis theory is the autocorrelation
function Rj(), of a physical variable, uj, which is defined by
1 T
T 0
R j (τ ) = T lim ∞ u j (t ) u j (t −τ )dt
(13-1)
Chapter 13: Random Analysis 757
Basic Random Analysis Theory
u2
Note that Rj(0) is the time average value of j , which is an important quantity in the analysis of structural
failure. The one-sided power spectral density Sj() of uj is defined by
2
2 T
S j (ω ) = T lim ∞
T 0
e −iω t u j (t )dt
(13-2)
It may be shown (using the theory of Fourier Integrals) that the autocorrelation function and the power
spectral density are Fourier transforms of each other. Thus, we define the autocorrelation function in terms
of frequency response functions
1 ∞
R j (τ ) =
2π 0
S j (ω ) cos(ωτ ) dω
(13-3)
from the mean-square theorem, the rms (root mean squared) magnitude, uj, is
1 ∞
2π 0
u 2j = R j (0) = S j (ω )dω
(13-4)
The expected value of the number of zero crossing with positive slope per unit time, or apparent frequency,
is a quantity of interest for fatigue analysis. This mean frequency, N0, can be found from the power spectral
density;
∞
(ω / 2π ) S (ω ) dω
2
j
2 0
N 0 = ∞
S (ω )dω
0
j
(13-5)
The mean frequency, N0, is thus the root mean square frequency, where the power spectral density is used as
a weighing function.
The transfer function theorem states that, if Hja() is the frequency response of any physical variable, uj, due
to an excitation source, Qa, which may be a point force, a loading condition or some other form of excitation,
i.e., if
u j (ω ) = H ja (ω ).Qa (ω )
(13-6)
Where uj() and Qa() are the Fourier transforms of uj and Qa, then the power spectral density of the response,
is related to the power spectral density of the source, Sa(), by
2
S j (ω ) = ( H ja (ω ) . S a (ω )
(13-7)
Eq 2-6 is an important result because it allows the statistical properties (e.g., the Auto-correlation function)
of the response of a system to random excitation to be evaluated via the techniques of frequency response.
758 Patran Reference Manual
Basic Random Analysis Theory
Another useful result is that, if sources Q1, Q2, Q3, etc., are statistically independent, i.e., if the cross-
correlation function between any pair of sources
1 T
T 0
Rab (τ ) = T lim ∞ qa (t )qb (t − τ ) dτ
(13-8)
is null, then the power spectral density of the total response is equal to the sum of the power spectral densities
of the responses due to individual sources. Thus
S j (ω ) = S ja (ω ) = H ja (ω ) S a (ω )
2
a a (13-9)
If the sources are statistically correlated, the degree of correlation can be expressed by a cross-spectral density,
Sab, and the spectral density of the response may be evaluated from
S j = H ja H *jb S ab
a b (13-10)
1 T
T 0
Rab (τ ) = T lim ∞ ua (t ) ub (t − τ )dt
(13-11)
Where ua(t) and ub(t) can be displacement, velocity, acceleration or single-point force responses at the same
or different grid points; or stress, strain, and force components in the same of different elements. The cross-
correlation functions have the following relation
Rab ( −τ ) = Rba (τ )
(13-12)
The cross-power spectral density (cross-PSD) of ua(t) and ub(t) is defined as;
2 T
S ab (ω ) = T lim ∞ ua (t )e − iω t dt ua (t )eiω t dt
T
T 0 0 (13-13)
Chapter 13: Random Analysis 759
Basic Random Analysis Theory
+∞
= 2 Rab (τ )e − iωτ dτ
−∞
(13-14)
And Rab() is related to Sab() by the relation
1 +∞
Rab (τ ) =
4π − ∞
S ab (ω ) eiwτ dω
(13-15)
The cross-PSD Sab() is a complex-valued function of angular frequency . The following relations hold for the
cross-PSDs.
*
Sab (ω ) = Sab ( −ω ) = Sba (ω )
(13-16)
Where Sab*() is the complex conjugate of Sab(). If we denote Sab() by its real and imaginary parts as
Sab (ω ) = Sab
(R)
(ω ) + iSab
(I )
(ω )
(13-17)
From (2-15), we can see that Sab(R)() is an even function and Sab(I)() is an odd function of , i.e.
(R)
S ab ( −ω ) = Sab
( R)
(ω )
(13-18)
(I )
S ab ( −ω ) = − Sab
(I )
(ω )
(13-19)
Substituting (2-17) and (2-18) into (2-14), we get
Rab (τ ) =
1 ∞ ( R)
2π 0
[
S ab (ω ) cos(ωτ ) − S ab
(I )
sin(ωτ ) dω ]
(13-20)
If the system is subject to multiple sources of excitation, the cross-PSD of responses ua(t) and ub(t) is related
to the PSDs of excitation sources by the frequency response function as
S ab (ω ) = H aj (ω ) H bk* (ω ) S jk (ω )
j k
(13-21)
Where Haj() is the frequency response function of ua(t) corresponding to the excitation source Qj(t), Hbk*()
the complex conjugate of Hbk() , and Sjk() the cross-PSD of excitation sources when j k. If the two different
excitation sources Qj and Qk are not correlated, we have Sjk() 0.
The aforementioned equations of cross-PSDs and cross-correlation functions become the ones for auto-PSDs
and auto-correlation functions when ua(t) = ub(t).
The calculation of the cross-correlation function from 2-18 is carried out by numerical integration based on
the trapezoidal approximation.
760 Patran Reference Manual
Basic Random Analysis Theory
1
1 ωi 2
u j (ω i ) =
2π
w1 S j (ω )dω
, i = 1,2, …, N(2-21) (13-22)
Ref 3 and 4 outline the method of calculating von Mises PSD response. Ref 3 discusses computing von Mises
PSD using Modal Approach whereas Ref 4 computes von Mises PSD directly from PSD-matrix of stress
tensor. The MSC Random uses the approach from Ref 4 since it is applicable to both Modal Frequency
Response Analysis and Direct Frequency Response Analysis.
Process Overview
All random analysis runs will start with a frequency response run. The quality of this run will directly affect
the random analysis results. Because of this relation, the term “random analysis” is often implied to mean the
combined frequency response and random solutions. To eliminate potential confusion, the term “random
analysis process” will be used when referring to the combined frequency response and random solutions. The
“random analysis cycle” will be used when referring to just the random calculations and “frequency response
analysis cycle” will be used when referring to just frequency response analysis iterations. These definitions are
illustrated in Figure 13-4.
762 Patran Reference Manual
Random Analysis Process
User Interface
(Patran)
Frequency Response
Random Analysis
Analysis
(MSC.Random)
(MSC NASTRAN)
The frequency response and random analysis cycles will be discusses separately in following sections, but they
will be presented in the order that the random analysis process would typically proceed.
results 23% higher than the curve with more points. This would have been much worse if any important
natural frequencies were skipped. Assuming at least all of the natural frequencies are recovered, the random
RMS results will usually error on the high side when inadequate numbers of output frequencies are requested.
The iterative process of verifying the FEM and verifying the frequency response analysis cycle is illustrated in
Figure 13-6.
764 Patran Reference Manual
Random Analysis Process
Output Files:
MSC Random produces various output files depending upon different action selected by user.
XY Plot:
Job_Name.log: Error Messages
Job_Name-xy.out: ASCII output files – Input description and warning messages
Job_Name.xy: ASCII XY Plot output file. This file can be imported in to Excel Spreadsheet.
Note: All GRID responses are processed in Analysis Coordinate System. Element results are in
Element Coordinate System.
RMS Analysis:
Result_Name.log: Error Messages
Result_Name.out: ASCII RMS results output files
Result_Name.pat: Neutral result file that can be imported in to Patran database.
766 Patran Reference Manual
Using MSC Random
Note: All Grid RMS Fringe Plots/Results are in BASIC Coordinate System Element Results are in
Element Coordinate System.
In addition, MSC Random will create following input files.
Job_Name.inp: This files will be read by MSC Random executable (similar to .bdf or .dat file created
by Patran
Job_Name.rnd: User created or created by MSC Random Interface. This file contains the random
input descriptions.
Contents of output files:
Job_Name.xy: This file is similar to MSC Nastran XYPUNCH file. First Line describes the type of plot,
Elem/Node ID, Component/DOF and then followed by XY data representing Frequency Vs Result.
XYDATA,ACCE-PSDF:ID 92, Tx :RMS(*3.00) 5.05682E+04 Zero X-ing
3.32133E+02
1.00000000E+01 4.08137744E+03
1.06809082E+01 5.53827100E+03
1.11413689E+01 6.68424609E+03
1.13124104E+01 7.11009375E+03
1.16323595E+01 8.02400781E+03
1.18563261E+01 8.76009570E+03
....
....
XYDATA,ACCE-PSDF:ID 144, Tx :RMS(*3.00) 3.89760E+04 Zero X-ing
4.38824E+02
1.00000000E+01 1.08585098E+04
1.06809082E+01 1.47525918E+04
1.11413689E+01 1.78551055E+04
1.13124104E+01 1.90274238E+04
1.16323595E+01 2.15572695E+04
....
....
Job_Name.out: RMS Result output file.
User Input........
XDB:C:\barbela\Random\_Production\2005\doc\Examples\cylinder-1\base-x.xdb
RESPONSE:ACCE
LOG_LIN:LOG
FACTOR:3.0
RFILE:C:\barbela\Random\_Production\2005\doc\Examples\cylinder-1\Random.rnd
OPTION:RMS
No of Subcases : 1
No of Frequencies : 435
No of Randps : 1
No of Tabrnd1 : 1
Integration Scheme : Log-Log (to calculate RMS & Number of Zero Crossing)
Grid_Id Tx Ty Tz Rx Ry Rz
( Zero X-ing)( Zero X-ing)( Zero X-ing)( Zero X-ing)( Zero X-ing)( Zero
X-ing)
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.69641E+03)(1.43129E+03)(1.84746E+03)
2 2.30924E+04 0.00000E+00 0.00000E+00 1.10007E+03 8.68984E+03
1.50619E+02
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.35119E+03)(1.42223E+03)(1.86314E+03)
3 2.30924E+04 0.00000E+00 0.00000E+00 2.07223E+03 8.13880E+03
1.78845E+02
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.35360E+03)(1.42746E+03)(1.85834E+03)
4 2.30924E+04 0.00000E+00 0.00000E+00 2.80963E+03 7.31220E+03
1.14604E+02
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.36068E+03)(1.43917E+03)(1.85221E+03)
5 2.30924E+04 0.00000E+00 0.00000E+00 3.17502E+03 6.23646E+03
4.71577E+01
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.35383E+03)(1.44905E+03)(1.84413E+03)
6 2.30924E+04 0.00000E+00 0.00000E+00 3.19763E+03 5.14193E+03
6.86768E+00
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.36159E+03)(1.47125E+03)(1.50072E+03)
7 2.30924E+04 0.00000E+00 0.00000E+00 2.79517E+03 4.08549E+03
2.65419E+01
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.35498E+03)(1.49633E+03)(1.82526E+03)
8 2.30924E+04 0.00000E+00 0.00000E+00 2.08432E+03 3.24476E+03
4.72351E+01
(9.74284E+02)(0.00000E+00)(0.00000E+00)(1.36012E+03)(1.53061E+03)(1.84444E+03)
……
……
Example Problems:
Instead of going through each form and every line item on the form, the usage of MSC Random and its
various capabilities will be demonstrated using few examples.
Three different examples will be considered.
1. Cylinder under base acceleration PSDF input in one direction only.
2. Table, modeled with all solid elements, subjected to three simultaneous acceleration base PSDF Input
in three directions.
3. Flat plate subjected to pressure and point load with Auto and Cross PSDF input.
FEM Model
Create New Database
1. File / New
2. Enter File Name “Cylinder”
3. Click “OK”
770 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
1. Geometry
2. Create / Coord / 3Point
3. Type: Select Cylindrical
4. Apply
Chapter 13: Random Analysis 771
Example 1: Cylinder subjected to base PSDF input.
Create Curve
Create Surface
1. Elements
2. Create / Mesh Seed / Uniform
3. Select “Number of Elements”
4. Number: 36
5. Select Curve 1 & 2
6. Apply
Chapter 13: Random Analysis 775
Example 1: Cylinder subjected to base PSDF input.
1. Number: 60
2. Curve List – Click on Surface 1.1
3. Apply
776 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
Create Mesh
Create Material
1. Material
2. Create / Isotropic / Manual Input
3. Enter Material Name “alum”
4. Input Properties
5. Enter Elastic Modulus (10.e6), Poisson’s Ratio(0.25) & Density(0.1)
6. Apply
Chapter 13: Random Analysis 779
Example 1: Cylinder subjected to base PSDF input.
1. Properties
2. Create / 2D / Shell
3. Property Set Name “shell-prop”
4. Click on Input Properties
5. On Input Properties Form Click on Mat Prop Name & select “alum”
6. Enter Thickness 0.05
7. Click on OK
8. Application Region – Select Surface 1
9. Click on Add
10. Click OK
11. Apply
780 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
1. Loads/BCs
2. Create / Displacement / Nodal
3. New Set Name: fixed-base
4. Click on Input Data
5. Enter <0 0 0> for both Translations and Rotations
6. Click on OK
7. Click on Application Region
8. Select Geometry
9. Application Region: Select Curve 1 (curve at Base) and Click on Add
10. Click OK
11. Apply
1. Tool Menu
2. Select Random Analysis
13. Click OK
14. On main form, click on Adv. Freq. Output (see next page)
Note: Always add all break points frequencies that define the PSD input curve. If there are more than one
PSD input curves, make sure to include all frequencies, which define all PSD input profiles, in output list
Add few more rows and add additional frequencies as shown on next page.
1. Click “Apply” – This will create a message saying a Jobname ‘base-x’ was created
2. Click OK
Now go to ANALYSIS form, select job ‘base-x’. If necessary modify/add additional analysis related
parameters. Make sure that you have selected Residual Vector Computation check box on Solution
Parameters form (Analysis | Solution Type | Solution Parameters | Residual Vector Computation). Then
either create the full analysis .bdf file or run Nastran job through Patran. Once Nastran run is completed,
examine Nastran output file ‘base-x.f06’ and check for any warning/error messages. In addition to base-x.f06,
you will also see ‘base-x.xdb’ file. This file contains the frequency response results.
788 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
1. Tool Menu
2. Select Random Analysis
Chapter 13: Random Analysis 789
Example 1: Cylinder subjected to base PSDF input.
1. Select XY plots
2. Click on “Select XDB File”
3. Select XDB file
4. Click “Apply”
790 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
9. Click “OK”
No of Zero
Crossing
1
G /Hz
2
0.1
G2/Hz
0.01
10 100 1000 10000
Chapter 13: Random Analysis 797
Example 1: Cylinder subjected to base PSDF input.
This PSDF plot confirms that the PSDF output at the base node is same as input. The total RMS input is
19.92 G. If Linear Integration scheme were chosen than total rms would be
SQRT [{(20-10)*0.1} + { (50-20)*(0.1+0.3)/2} + {(600-50)*0.3} + {(1500-600)*(0.3+0.12)/2} + {(2000-
1500)*0.12}] = SQRT (1.0 + 6.0 + 165 + 189 + 60) = 20.52 G
Curve Display Attribute: Modify Curve Style and Curve Color, Symbol Color & Size.
Graph Display Attribute: Use for customizing Title, Axes Scale, Custom Title as well formatting
Axes, Legend, Grid Lines, Tic Marcs etc.
Export/Import: Writes out XY raw data to an ASCII file in CSV (Comma Separated) format that
can be easily imported to Excel Spread Sheet. In Addition, MSC Random will also create an ASCII
file (job_name.xy) that can also be imported to Excel Spread Sheet
1. Select XY Plots
2. Set Plot Type: CRMS (Cumulative RMS)
3. Click “Target Entity” Icon.
4. Select DOF 1 (X direction)
5. Select Node 2222
6. Click “Delete Current XY Window” to clear existing xyplot.
7. Click “Apply”
Once plot is created, experiment with various XY Plot option to change the scale, color etc.
Chapter 13: Random Analysis 803
Example 1: Cylinder subjected to base PSDF input.
Relative Displacement
1. Select XY Plot
2. Plot Type “PSDF (Relative A-B)
3. Res. Type Displacement
4. Click on “Delete Current XY Window” to clear Display of any existing XY Plot.
5. Click on “Target Entity” Icon
6. Select First Node and DOF (Base Node 30 and DOF 1, X direction)
7. Select another node (Node 2222 and DOF 1, X direction)
804 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
8. Apply
1. Select XY Plot
2. Plot Type: Auto Correlation
3. Result Type: Displacement
4. Set Start Time 0.0, Ending Time 0.5 and Number of Increments 500
5. Click on “Target Entity” Icon
6. Select DOF 1 and Node 400 & 2222
7. Apply
806 Patran Reference Manual
Example 1: Cylinder subjected to base PSDF input.
Chapter 13: Random Analysis 807
Example 1: Cylinder subjected to base PSDF input.
The background process will start to calculate RMS response of all entitys (elements or nodes). Once this
background process is finished, MSC Random will import RMS results and available for fringe plots.
Note: Steps b thru f are not required in same MSC Random session.
Random Analysis - RMS Acceleration Fringe Plot using RMS scale factor of 3.0
1.00
G^2/Hz
0.10
G^2/Hz (X/Y)
G^2/Hz (Z)
0.01
10.00 100.00 1000.00
Frequency
PARAM POST 0
Param, Wtmass, .002589 $ (1/386.4 to convert WEIGHT unit to MASS
unit)
Param, Autospc, yes
$
Eigrl, 99, , 1000.
$
$ Damping 1% Critical - g = 2 * crit = 0.02
Tabdmp1, 33,
+, 0.1, 0.02, 10000., 0.02, Endt
$
Freq, 91, 15.0, 15.1, 30.0, 30.1, 100.0, 100.1
Freq, 91, 34.9, 35.0, 55.0, 55.1, 300.0, 300.1
Freq2, 91, 10.01, 999.99, 200
Freq4, 91, 10.0, 1000.0, 0.1, 1
$
RBE2 99999 99999 123 22561 22563 22646 22725
22816
22818 23613 23778 24115 24117 24239 24626
24628
24795 24797 25644 26635 26637 27156 27158
27577
30217 30219 30232
Spc1,1,123456,99999
$
$ Input for X direction
$
Rload1, 51, 61, , , 31, , Acce
Spcd, 61, 99999, 1, 386.4
Tabled1, 31
+, 0.1, 1.0, 10000., 1.0, Endt
$
$ Input for Y direction
$
Rload1, 52, 62, , , 31, , Acce
Spcd, 62, 99999, 2, 386.4
$
$ Input for Z direction
$
Rload1, 53, 63, , , 31, , Acce
Spcd, 63, 99999, 3, 386.4
$
$ Rest of the model goes here.
Random Analysis
In this example, new feature will be used to read Random Input Profile using Existing Randps File. Random
Input is defined as Sjk(f ) = (X + iY) G(f )
Remarks:
For Auto Spectral Densities, J=K, X must be >0.0 and Y must be 0.0
For Cross Spectral Densities, in general, two entries are required with same SID. One entry defines the real
part (X<>0.0, Y=0.0) and second one with imaginary part (X=0.0, Y<>0.0) – See example 3 for usage.
Existing Randps file is an ASCII file created by any text editor or any other source. It contains the random
input description. The input consists of two type of entries 1) RANDPS and 2) TABRND1. Both entries
are described in MSC Nastran Quick Reference Guide (QRG) – see Ref 6. MSC Nastran supports various
input format such as Double Filed, Tab or Comma delimited input, etc. MSC Random on other hand
supports only Small Field (Fixed Field) or comma delimited file. Following is acceptable input file for this
problem.
$
Randps,99, 1, 1, 1.0, 0.0, 11
Randps,99, 2, 2, 1.0, 0.0, 12
Randps,99, 3, 3, 1.0, 0.0, 13
$
$ Random Input in X direction
Tabrnd1, 11, Log, Log
+, 10.0, 0.18, 15.0, 0.18, 15.1, 0.10, 30.0, 0.10
+, 30.1, 0.22, 100.0, 0.22, 100.1, 0.12, 1000.0, 0.12
+, Endt
$
$ Random Input in Y direction
Tabrnd1, 12, Log, Log
+, 10.0, 0.18, 15.0, 0.18, 15.1, 0.10, 30.0, 0.10
+, 30.1, 0.22, 100.0, 0.22, 100.1, 0.12, 1000.0, 0.12
+, Endt
$
$ Random Input in Z direction
Tabrnd1, 13, Log, Log
+, 10.0, 0.15, 34.9, 0.15, 35.0, 0.25, 55.0, 0.25
+, 55.1, 0.15, 300.0, 0.15, 300.1, 0.08, 1000.0, 0.08
+, Endt
$
The Input shown above is based on the Random Input Profile defined below.
Chapter 13: Random Analysis 815
Example 2: Table - Subjected to Simultaneous Random Excitation in Three Directions
1.00
G^2/Hz
0.10
G^2/Hz (X/Y)
G^2/Hz (Z)
0.01
10.00 100.00 1000.00
Frequency
816 Patran Reference Manual
Example 2: Table - Subjected to Simultaneous Random Excitation in Three Directions
1. From Patran Tool Menu, Select MSC Random and set Action: XY Plots
2. Click on “Select XDB File”
3. Select XDB File on Select MSC Nastran XDB Form
4. Click “Apply”
5. On Main Form, Click on “PSD Input”
Chapter 13: Random Analysis 817
Example 2: Table - Subjected to Simultaneous Random Excitation in Three Directions
1. Select XY Plots
2. Plot Type: PSDF Cross
Chapter 13: Random Analysis 819
Example 2: Table - Subjected to Simultaneous Random Excitation in Three Directions
1. Select Random Analysis from TOOL menu and set ACTION: RMS Analysis
2. Select Stress on Main Form and
3. Apply.
Wait for MSC Random to finish the RMS analysis. Once the RMS Analysis is finished, the RMS Stresses will
be imported in to Patran Database.
Chapter 13: Random Analysis 821
Example 2: Table - Subjected to Simultaneous Random Excitation in Three Directions
SOL 111
$
CEND
$
TITLE = Plate subjected to pressure and concentrated load.
ECHO = NONE
SDAMPING = 1
METHOD = 1
FREQUENCY = 1
SPC = 2
ACCELERATION(PLOT)=ALL
SPCFORCES(PLOT)=ALL
MPCFORCES(PLOT)=ALL
STRESS(PLOT, BILIN)=ALL
FORCE(PLOT, BILIN)=ALL
SUBCASE 1
$ Subcase name : Pressure
SUBTITLE=Applied Pressure
DLOAD = 11
SUBCASE 2
$ Subcase name : Tip_Force
SUBTITLE=Applied Load at Tip
DLOAD = 12
BEGIN BULK
PARAM POST 0
PARAM WTMASS .002589
PARAM GRDPNT 0
PARAM,NOCOMPS,-1
PARAM PRTMAXIM YES
FREQ2 1 10. 1000. 300
FREQ4 1 10. 1000. .1 3
FREQ, 1, 20., 30., 100., 500., 1000.
TABDMP1 1 CRIT
.1 .03 2000. .03 ENDT
EIGRL 1 -.1 2000. 0
SPCADD 2 1
RLOAD1 11 4 1
$ Pressure Loads of Load Set : Pressure
PLOAD4 4 1 -1. THRU 40
$
RLOAD1 12 5 1
$ Nodal Forces of Load Set : Force
FORCE 5 11 0 1. 0. 0. 1.
$
$ Constant Load Table
TABLED1 1
0. 1. 1000. 1. ENDT
$
$ Displacement Constraints of Load Set : spc1.1
SPC1 1 12345 1 12 23 34 45
$
$ Rest of the model – grid, element connectivity etc.
$
826 Patran Reference Manual
Example 3: Plate - Subjected to Pressure and Point Load with Cross Spectrum Input
Random Analysis
Auto Pressure
Auto-Force
After creating all required PSD Input Field, create PSD input profile and then create PSDF XY Plot for
various response quantities.
828 Patran Reference Manual
Example 3: Plate - Subjected to Pressure and Point Load with Cross Spectrum Input
1. From Tool Menu, Select MSC Random and set Action: XY Plot
2. Click on ‘Select XDB File’ and select ‘freq-plate.xdb’ file
3. Click on PSD Input.
4. Change Random Input Method to ‘Combine Cases’
5. Select Auto Spectral Density
6. Click in Excited Set Field
Chapter 13: Random Analysis 829
Example 3: Plate - Subjected to Pressure and Point Load with Cross Spectrum Input
RANDPS,101,1,1,1.,0.,200022
RANDPS,101,2,2,1.,0.,300022
RANDPS,101,1,2,1.,0.,400011
RANDPS,101,1,2,0.,1.,500011
$
$ From Patran Field: auto-press
TABRND1, 200022,log,log,,,,,,+
+, 10.0000, 0.10000, 20.0000, 0.10000, 30.0000, 1.00000, 100.000,
1.00000,
+, 500.000, 0.10000, 1000.00, 0.10000,endt
$ From Patran Field: auto-force
TABRND1, 300022,log,log,,,,,,+
+, 10.0000, 0.50000, 20.0000, 0.50000, 30.0000, 2.50000, 100.000,
2.50000,
+, 500.000, 2.50000, 1000.00,1.0000-6,endt
$ From Patran Field: Cross-Real
TABRND1, 400011,linear,linear,,,,,,+
+, 10.0000,-0.09962, 20.0000,-0.09962, 100.000,-0.49810, 500.000,
0.07071,
+, 1000.00,1.0000-6,endt
$ From Patran Field: Cross-Imag
TABRND1, 500011,linear,linear,,,,,,+
+, 10.0000, 0.00782, 20.0000, 0.04358, 100.000, 0.04358, 500.000,-
0.07071,
+, 1000.00,1.0000-6,endt
Chapter 13: Random Analysis 831
Example 3: Plate - Subjected to Pressure and Point Load with Cross Spectrum Input
3. Apply. Once MSC Random finished the background processing, RMS results will be imported in to
Patran Database.
4. Click on Patran Result Menu
5. Set Action to Create and Object to Quick Plot
6. Select Acceleration Result in Tz (Translation, Z) direction
7. Apply
Following Similar Procedure, Create Fringe Plots for RMS Von-Mises Stresses
Chapter 13: Random Analysis 837
Appendix A
References
1. “Random Analysis with Coupled Excitations”, sec 6.5, MSC Nastran Advanced Dynamic Analysis
Users’ Guide.
2. “Random Response Analysis”, sec 3.4, MSC Nastran 2004 Release Guide.
3. Segalman, D.J., C.W. Fulcher, G.M. Reese, and R.V. Field, Jr., “An Efficient Method for Calculating
RMS Von Mises Stress in a Random Vibration Environment”, Proceedings of the 16th International
Modal Analysis Conference, Santa Barbara, CA, pp. 117-123.
4. X. Pitoiset, A. Preumont, A. Kernilis , “Tools for a Multiaxial Fatigue Analysis of Structures
Submitted to Random Vibrations”, Proceedings European Conference on Spacecraft Structures
Materials and Mechanical Testing Braunschweig, Germany, 4-6 November 1998 (ESA SP-428,
February 1999)
5. Francois Charron, Louis Donato and Mark Fontaine , “Exact Calculation of Margin of Safety for
Frequency Response Analysis Stress Results using Yielding or Failure Theories”, 1993 MSC World’s
Users’ Conference, May 24-28, 1998, Arlington, VA. .
6. MSC Nastran Quick Reference Guide.
Appendix A
Frequency Response Analysis Setup for Example 3 was prepared using text editor. Same example is repeated
here, however using two different interfaces available within Patran. The core Patran Interface will require
more steps since it is more generic to all types of dynamic analysis (transient and frequency response) whereas
the interface within MSC Random is custom tailored for frequency response analysis using unit input at all
excited frequencies and will satisfy most needs.
Problem Definition:
In both cases, it is assumed that basic FEM model is created with all Material and Physical Properties.
838 Patran Reference Manual
Appendix A
FEM Model:
.
Chapter 13: Random Analysis 843
Appendix A
Click on Apply, MSC Random will create following message, click OK.
On Subcase Select, Make sure subcases are selected in the order. i.e. Pressure_Loadcase is first and
then Force_Loadcase. This is required since Random Input will refer to Subcase 1 as Pressure Load.
Click OK and return to main form
Click Apply. MSC Nastran input file “freq-plate” will be created. See partial listing of input on next
page.
A File Formats
Parameter Description
Finite Element Model The most common use of the neutral file is to output a finite element
Output model for analysis. In this application, the neutral file is read by an
application interface which converts Patran model data into the required
input format for a particular analysis program. A typical example is the
PATNAS interface which translates neutral file data into a bulk data deck
for input to Nastran.
Geometry Model Output It is also possible to output a neutral file containing mathematical
definitions of a geometry model. Points, parametric cubic curves,
parametric bi-cubic surfaces, and parametric tri-cubic solids are the only
geometry forms which can be written to a neutral file. This information
can then be accessed by programs that perform such functions as
automated drafting or preparation of tapes for numerically controlled
milling machines.
Ap. A: File Formats 859
The Neutral File
Finite Element Model Input Through the use of an “inverse translator”, an existing finite element model
in the form of an input deck for a particular analysis program can be input
to Patran. Once in the Patran database, the model can be displayed
interactively, modified if necessary, and even output to a different analysis
program if desired.
Geometry Model Input Dependent upon your particular engineering application, it may be cost
effective to input part of your problem's geometry via the neutral file rather
than the keyboard. This is especially true if points defining your geometry
can be computed using relatively simple algorithms. In this case, rather
than calculating coordinates of points and typing them into Patran by
hand, try writing a short computer program to compute the coordinates
and output them to a file in neutral file format.
Sub-Structuring One of the most effective techniques for modeling a large, complex
structure is to break it up into its component parts. Each component part
is separated by identifying the finite element node locations at each
interface. Then, each part can be modeled as a separate sub-structure
independent of the other parts.
An important point here is that each modeler can use Patran's default ID
number assignments for his nodes, elements and geometry items without
having to worry about later conflict with other sub-structures.
When each sub-structure is finished, it will be written into its own neutral
file. Then, one by one, the individual sub-structure neutral files will be read
into a single database. As each sub-structure neutral file is read, its ID
numbers will be offset from those already present in the database.
*This nodal data packet (22) and the corresponding element counterpart (23) can be used in
place of packets 1 and 2, respectively. However they are not recognized by default and you must
use the PCL function, neutold_write_old_toggle(), before exporting/importing inorder
for them to be recognized Using this command toggles between the two different types (with
geometry association or without).
The header card is followed by “KC” data card images. The meaning of the header variables for each packet
type plus the content and format of its data cards are presented in PATRAN 2.5 Neutral File Contents and Format,
864. The packet types are listed in the order of their appearance (if present) in the neutral file.
864 Patran Reference Manual
The Neutral File
Data Card 2 Format (I1, 1A1, I8, I8, I8, 2X, 6I1)
ICF GTYPE NDF CONFIG CID PSPC
ICF*=Condensation flag (0 = unreferenced)
GTYPE=Node type
NDF*=Number of degrees-of-freedom
CONFIG=Node configuration
CID=Coordinate frame for analysis results
PSPC*=6 permanent single point constraint flags 0 or 1
* These parameters are not currently used.
*Material Types:
1Isotropic 4TIS option 11HAL option
22D anisotropic 5TAN option 12LLAM option
33D orthotropic 6-73D anisotropic 13MIX option
N2*=User function ID
* This parameter is not currently used.
N2=User function ID
*NTYPE meanings:
1grid# 8quadrilateral
2line 9tetrahedron
3patch 11wedge
4hyperpatch 12hexahedron
5node 19coordinate frame
6bar 22multi-point constraints
7triangle
NTYPEs 6-12 may have 100 or 200 added to the basic NTYPE. The number of hundreds is
usually the number of midside nodes.
Ap. A: File Formats 883
The Neutral File
Data Card 2 Format (I1, 1A1, I8, I8, I8, 2X, 6I1, 2I8)
ICF GTYPE NDF CONFIG CID PSPC GTYP GID
ICF*=Condensation flag (0 = unreferenced)
GTYPE=Node type
NDF*=Number of degrees-of-freedom
CONFIG=Node configuration
CID=Coordinate frame for analysis results
PSPC*=6 permanent single point constraint flags 0 or 1
GTYP = Associated Geometry entity type (1=Vertex, 2= Curve, 3=surface, 4=solid)
GID = Geometry Entity ID
* These parameters are not currently used.
1
This nodal data packet (22) and the corresponding element counterpart (23) can be used in place of
packets 1 and 2, respectively. However they are not recognized by default and you must use the PCL
function, neutold_write_old_toggle(), before exporting/importing inorder for them to be rec-
ognized Using this command toggles between the two different types (with geometry association or
without).
884 Patran Reference Manual
The Neutral File
1This elemental data packet (23) and the corresponding nodal counterpart (22) can be used in place of
packets 2 and 1, respectively. However they are not recognized by default and you must use the PCL
function, neutold_write_old_toggle(), before exporting/importing inorder for them to be
recognized Using this command toggles between the two different types (with geometry association or
without).
Ap. A: File Formats 885
The Neutral File
ADATA†=Associate data values (For bars, these are coordinates of the bar ends if offset from end nodes).
†ADATA will not be present if N1 is zero
886 Patran Reference Manual
The Neutral File
Packet Types 42, 43 or 44: GFEG Table for Line, Patch or Hyperpatch 1
(when created from a GFEG command)
1The format of the GFEG tables changed with Patran release 2.0.
Ap. A: File Formats 891
The Neutral File
+ if specified by user,
- if assigned by Patran
892 Patran Reference Manual
The Neutral File
Packet Type 42, 43 or 44: GFEG Table for Line, Patch or Hyperpatch (when created from a MESH
command)
+ if specified by user,
- if assigned by Patran
894 Patran Reference Manual
The Neutral File
LCON(10)
LCON(10)=Element data (NELS records with NDIM words per second)
+ if specified by user
- if assigned by Patran
*These are local node ID numbers corresponding to record numbers in the associated GFEG table.
896 Patran Reference Manual
Session File/Journal File
Session File Names By convention, session files are named “<file>.ses”. The first portion
<file> is a user selectable base file name. The second portion, “ses”, is
the standard session file extension. In addition, a file revision is appended to
all session files. Session files created by Patran have revision numbers that are
either specified manually or generated automatically. If a session file name
is supplied without any extension (indicated by the presence of a “.” in the
file name), the standard extension “.ses” is automatically appended.
Revision numbers are at least 2 digits long (starting with “01”) to facilitate
the listing of session files in increasing numerical order.
Note: Revisions greater than “99”are not listed in numerical order on the
forms.) Automatically generated revision numbers are always created as one
(1) greater than the highest existing revision number. Gaps in revision
numbers are not automatically filled in by the system.
For recording session file, the supplied name is checked for existence. If this
file does exist, then a new revision (starting with “01”) is created.
In order to play a session file, the supplied name is also checked for existence.
If this file does not exist, then the highest existing revision of this file is used.
If no revision exists, then no file is played.
898 Patran Reference Manual
IGES File
Session File Contents Session files are text files that may contain PCL statements or NOODL
commands. No single physical line may exceed 256 characters. The logical
line length limit is 7000 characters.
Session files are designed to support the PCL comment marker ($). In
addition, there are two special cases of comments that are written to a session
file. Any comment lines that do not contain one of these two special
comment markers will be written unchanged to the recording session file.
None of these lines are executable, but may have varying results during
playback of a session file and the recorded session file.
Patran writes out certain comments using the system comment marker.
These include messages about session file start and end information. When
a session file is read, any lines with this marker are ignored and not displayed
in the history window or recorded in the recording session file. A user can
enable and disable the writing of these comments using the PCL built-in
command verbose.
IGES File
The Initial Graphics Exchange Specification (IGES) is a mechanism for the digital exchange of database
information among present day CAD systems. Its history has seen a rapid development of capability,
Ap. A: File Formats 899
IGES File
formalization into an ANSI standard, widespread implementation across the vendor community and
substantial commitments for production use. Engineering drawings, 3-D wireframe and surfaced part
models, printed wiring product descriptions, finite element mesh descriptions, Constructive Solid Geometry
(CSG), B-Rep Solid Geometry, and process instrumentation diagrams are addressed by the IGES standard.
This is the level of technology embodied by IGES and by present generation CAD systems.
IGES was developed by the IGES/PDES Organization and is supported by the U.S. Department of
Commerce, National Institute of Standards and Technology (NIST) in Gaithersburg, Maryland.
Administrative
Product Identification
Product Structure
Design/Analysis
Idealized models
Basic Shape
Geometric
Topological
Augmenting Physical Characteristics
Presentational Information
required to represent the product definition. Each entity occurrence consists of a directory entry and a
parameter data entry. The directory entry provides an index and includes descriptive attributes about the
data. The parameter data provides the specific entity definition. The directory data are organized in fixed
fields and are consistent for all entities to provide simple access to frequently used descriptive data. The
parameter data are entity-specific and are variable in length and format. The directory data and parameter
data for all entities in the file are organized into separate sections, with pointers providing bidirectional links
between the directory entry and parameter data for each entity. The specification provides for groupings
whose definitions will be found in a file other than the one in which they are used.
Each entity defined by the file structure has a specific assigned entity type number. While not all are assigned
at this time, entity type numbers 0000 through 0599 and 0700 through 5000 are allocated for specific
assignment. Entity type numbers 0600 through 0699 and 10000 through 99999 are for implement-defined
(i.e., macro) entities.
Some entity types include a form number as an attribute. The form number serves to further define or classify
an entity within its specific type.
The entity set includes a provision for associativities and properties. The Associativity Entity provides a
mechanism to establish relationships among entities and to define the meaning of the relationship. The
Property Entity allows specific characteristics, such as line widening, to be assigned to an entity or collection
of entities. Each entity format includes a structure for an arbitrary number of pointers to associativities and
properties. The file structure provides for both predefined associativities and properties to be included in the
specification and unique definitions which will be defined by the implement.
Most Analysis Model translators create a different DISPLACEMENT or FORCE RESULTS FILE for each
load case. If you desire to write your own results translator from your own in-house analysis program, you
should load the results in the scheme mentioned above: X, Y, Z translations or forces followed by X, Y, and
Z rotations or moments.
Patran will interpret the X, Y, and Z values of displacement, force, rotation, or moment in the coordinate
system defined in the associated Patran 2.5 Results Files, 60.
Both a binary and a text version of displacement and force results files are supported in Patran. The format
of the file will be automatically determined before reading in the data.
Ap. A: File Formats 903
PATRAN 2.5 Results Files
Binary Version
Record 1: TITLE, NNODES, MAXNOD, DEFMAX, NDMAX, NWIDTH
Record 2: SUBTITLE1
Record 3: SUBTITLE2
Record 4: NODID(1), DX(1),
DY(1),DZ(1), RX(1),
RY(1),RZ(1)
Record 5: NODID(2), DX(2),
DY(2), DZ(2), RX(2),
RY(2),RZ(2)
Parameter Description
Text Version
Record 1: h3 (80A1)
Record 2: NNODES, MAXNOD, DEFMAX, (2I9,
E15.6, 2I9)
NDMAX, NWIDTH
Record 3: SUBTITLE1 (80A1)
Record 4: SUBTITLE2 (80A1)
Record 5 to n+4: NODID, (DATA(J), J=1, NWIDTH) (I8,
(5E13.7))
Binary Version
Record 1: TITLE, NNODES, MAXNOD, DEFMAX, NDMAX, NWIDTH
Record 2: SUBTITLE1
Record 3: SUBTITLE2
Record 4: NODID(1), (DATA(J), J = 1, NWIDTH)
Record 5: NODID(2), (DATA(J), J = 1, NWIDTH)
.
Record N+3: NODID(N), (DATA(J), J=1, NWIDTH)
Parameter Description
Text Version
Record 1: h3 (80A1)
Record 2: NNODES, MAXNOD, DEFMAX, (2I9
E15.6, 2I9)
NDMAX, NWIDTH
Record 3: SUBTITLE1 (80A1)
Record 4: SUBTITLE2 (80A1)
Record 5 to n+4: NODID, (DATA(J), J=1, NWIDTH) (I8,
(5E13.7))
Note: MAXNOD, DEFMAX, NDMAX can be set to zero unless it is a displacement results.
Binary Version
Record 1: TITLE, NWIDTH
Record 2: SUBTITLE1
Record 3: SUBTITLE2
Record 4: ID, NSHAPE, (DATA(J), J=1, NWIDTH)
Record 5: ID, NSHAPE, (DATA(J), J=1, NWIDTH)
.
Record n+3: ID, NSHAPE, (DATA(J), J=1, NWIDTH)
Record n+4: ID = 0 or end-of-file
Parameter Description
Text Version
Record 1: h3 (80A1)
Record 2: NWIDTH (I5)
Record 3: SUBTITLE1 (80A1)
Record 4: SUBTITLE2 (80A1)
Record 5 to n+4: ID, NSHAPE, (DATA(J), J=1,NWIDTH) (2I8, /,
(6E13.7))
Binary Version
Record 1: TITLE, NWIDTH
Record 2: SUBTITLE1
Record 3: SUBTITLE2
Record 4: ID(1), STAT(1), (DATA(J), J=1, NWIDTH)
Record 5: ID(1), STAT(2), (DATA(J), J=1, NWIDTH)
.
Record n+3: ID(1), STAT(n), (DATA(J), J=1, NWIDTH)
Record n+4: ID(2), STAT(1), (DATA(J), J=1, NWIDTH)
Record n+5: ID(2), STAT(2), (DATA(J), J=1, NWIDTH)
.
Record n+m+3: ID(2), STAT(m), (DATA(J), J=1, NWIDTH)
Record n+m+4: ID(N), STAT(1), (DATA(J), J=1, NWIDTH)
Record n+m+5: ID(N), STAT(2), (DATA(J), J=1, NWIDTH)
.
Record n+m+k+3 ID(N), STAT(k), (DATA(J), J=1, NWIDTH)
Parameter Description
h3 80A1 title stored in an 80 word real or integer array
(1 character per word)
STAT Fractional station along the beam (real between 0. And 1.).
STAT(1)
Should always be 0.
STAT(m), STAT(n), and STAT(k)
Should always be 1.
A results template file is required for each PATRAN 2.5 results file type to be imported. You can create or
customize your own results template file.
The structure of the results template file is as follows:
Example 1 Example 2
KEYLOC = 0 KEYLOC = 19
TYPE = SCALAR TYPE = SCALAR
COLUMN = 11 KEY = 67
PRI = Stress COLUMN = 11
SEC = von Mises PRI = Stress
TYPE = TENSOR SEC = von Mises
COLUMN = 25, 26, 27, 28, 29, 30 TYPE = SCALAR
PRI = Stress KEY = 33
SEC = Components COLUMN = 11
CTYPE = ELEM PRI = Stress
TYPE = END SEC = von Mises
TYPE = TENSOR
KEY = 67
COLUMN = 25, 26, 27, 28, 29, 30
PRI = Stress
SEC = Components
CTYPE = ELEM
TYPE = TENSOR
KEY = 33
COLUMN = 15, 16, 0, 18, 0, 0
PRI = Stress
SEC = Components
CTYPE = ELEM
TYPE = END
B Printing Options
Introduction 912
Device-dependent Hardcopy File 912
Additional Information for Printers/Plotters 912
If Your Plot Does Not Turn Out as Expected 913
Hardware Setup 913
Supported Hardware for Patran Hardcopy 914
912 Patran Reference Manual
Introduction
Introduction
There are numerous ways to produce a hardcopy of your workstation screen, from platform-specific programs
that create a bit-mapped image to photographing the screen. One of the available methods is the Print utility
provided with Patran. It is designed to be flexible and easy to use.
Patran provides user control over creating hardcopy output from within the Print forms. Refer to File>Print,
214 for a description of these forms. The device-dependent hardcopy file varies depending on the specific
hardcopy device requirements. Refer to Device-dependent Hardcopy File, 912.
Parameter Description
Bad Hardware Connection Verify that the connection between the workstation and the printer/plotter
is valid. This can be done by submitting another plot to be printed/plotted.
Usually the printer/plotter vendor provides a small test program which can
serve as a check.
Wrong Printer/Plotter Ensure that the destination defined in the hardcopy form is valid. By
Destination checking the hardware connection above, you will also be checking the
destination. Submitting a test program is highly recommended to verify your
setup.
Network Problems Sometimes network connections can be blamed for hardcopy plots not being
submitted to the desired printer/plotter. If possible, attempt to bypass the
network when submitting a test plot to eliminate the network as a possible
source of error.
Hardware Memory Usually printers/plotters come with enough RAM for most plots to be
plotted satisfactorily. If you consistently produce very large plots (device-
specific hardcopy file is 1.5 Mb or more) you may need to upgrade the
printer/plotter internal memory. Please consult your printer/plotter
manufacturer for more information.
Hardware Problems Submitting a test plot can also determine if your printer/plotter hardware is
the problem. Sometimes turning the hardware OFF and ON can solve the
problem.
The manual for your printer/plotter may contain additional information to help you diagnose any problems.
Hardware Setup
There are numerous ways to set up printers/plotters so that the four Patran hardcopy drivers (CGM and
PostScript) can communicate with the hardware. The most common ways are:
Parameter Description
Laser Printer Black and White or Color.
914 Patran Reference Manual
Supported Hardware for Patran Hardcopy
Spooler
Plotters Electrostatic, Inkjet, Pen
Parameter Description
Laser Printers
Submit Command lp (HP700 platform)
lpr (Linux/Windows)
Destination Multiple destinations are setup in
/etc/printcap and /usr/spool.
Destinations in Windows are setup in the Printer Setup menu.
Example: lpr -Plw2 ps.plt.01
Plotters
Submit Command cat
Destination Name of serial or parallel port on the workstation that is connected to the
plotter.
Again, keep in mind that your setup could be very different from the above. Your system administrator should
be able to assist Patran users with printer/plotter setups for your computer environment.
C Mass Properties
Overview
The Mass Properties forms provide the capability to calculate mass properties for all or any part of a model.
Both FEM and geometric entities are supported, as are most of the widely used analysis model types. These
include 2D Axisymmetry, 2D Plane Stress, 2D Plane Strain, and 3D. The primary Mass Properties form is
accessed from the Tools menu which is located on the main form.
Patran generates a complete set of mass properties for the user-specified region and outputs all data to a
spreadsheet. This set includes the mass and volume, the center of gravity (CG), the inertia tensor at the origin
of the reference frame, the inertia tensor at the CG, the principal inertias at the CG, the radii of gyration
corresponding to the principal inertias at the CG, and the principal directions for the inertia tensor at the
CG. The principal directions at the CG are given in three forms: (1) as three orthogonal unit vectors, (2) as
a triad of space-fixed rotation angles in a 3-2-1 sequence, and (3) as a triad of body-fixed rotation angles in a
3-1-3 sequence. Where applicable, the mass properties are provided in both the reference Cartesian frame and
in the user-specified coordinate frame. For the special case of displaying mass properties on an individual
element basis, additional output of plate thickness, plate surface area, bar area, bar length, and the property
type name (ie. Stan. Membrane (CQUAD4)) are given. Output options include the graphical display of the
principal axes, the creation of a coordinate frame aligned with the principal axes (except for display by entity
mode), and the creation of a report file. The principal axes are plotted in proportion to the magnitudes of
the radii of gyration of the corresponding principal inertias, as shown below:
Newly created principal inertia coordinate frames are assigned the next available coordinate frame ID in the
database. Mass Properties report files are written in standard Patran report file format. Each Mass Properties
report contains all of the mass properties along with a list of all included entities and a list of all rejected
entities.
The densities, shell thicknesses, beam cross-sectional areas, non-structural mass, and concentrated mass
values used to calculate mass properties come from element property definitions by default, but you can
override the element property records by using 1.0 for densities, thicknesses, and areas; and using 0.0 for non-
structural mass and concentrated mass. The mass properties are generated in units that are consistent with
those used in your referenced geometry, element properties, and material properties. For the entity display
method, the actual plate thickness, areas, and bar length will be displayed regardless of the
Ap. C: Mass Properties 917
Summary of Mass Properties
“Thicknesses/Areas/NSM” setting. If no properties exist for an element then a value of “--” will be displayed
if the “Thickness/Areas/NSM” menu is set to unity.
All offsets are ignored. Mass property calculations are based on the assumption that all element offsets,
including beam, shell, and concentrated mass offsets, are zero. If a referenced entity has an offset, a warning
is issued. Non-structural mass is included in the calculation, while non-structural inertia is ignored without a
warning. Constant and variable-thickness plates and shells are supported. General beams and rods with
constant or variable cross-sectional areas are supported, but only tapered beams with constant cross-sectional
areas are supported. Furthermore, beams defined using cross-sectional dimensions instead of section
properties (e.g., I-beams requiring the input of web and flange dimensions) are supported. Concentrated
masses are supported, but direct-input mass matrices are not. Composite materials are supported. If a
composite property such as laminate thickness is defined in both the element property record and in the
material record, then the value in the element property record will be used. Material densities defined with
fields are not supported. If you are not sure whether an entity is supported, you can put it into a new group
containing no other entities and attempt to generate mass properties for that group. Patran will then tell you
if that entity is supported.
Mass properties for shells are calculated by treating the thickness as a weighting function and assuming that
all mass lies in the surface of the shell. Likewise, beam mass property calculations treat the cross-sectional area
as a weighting function with all mass assumed to lie in the locus of the 1D beam. Thus the mass properties
calculated for these entities differ slightly from those based on the corresponding 3D solids.
If you specify that your Mass Properties Region includes only Geometry, and you further specify that
densities, concentrated masses, thicknesses, or areas are to be taken from Element Property records, then those
records must be defined on the geometry and not on the FEM entities within the geometry. If, however, you
change the Mass Properties Region to include only FEM entities, then any needed Element Property records
may be defined on either the FEM entities themselves, or the geometry containing the FEM entities.
Field defining thickness, cross-sectional area, and non-structural mass are taken into detailed analysis. For a
geometry entity in the mass property region, a field property is integrated over the entity regardless of the
property’s value type. For a FEM entity, a field property is evaluated at the centroid of the entity if the
property’s value type is real scalar, and is integrated over the entity if the property’s value type is element nodal.
Discrete FEM fields are supported only for real scalar properties of FEM entities.
Patran attempts to treat all entities as though they are consistent with the selected analysis model type,
regardless of the element type of the entity’s element property record. For example, if a surface is assigned an
element property record corresponding to that of a non-axisymmetric shear panel, and the surface is
subsequently referenced for a 2D axisymmetric mass property calculation, Patran will calculate the mass
properties for the solid of revolution generated by that surface as long as it can find the properties it needs to
do the calculation (and as long as the surface lies in the user-specified modeling plane). In this case it only
needs to find the density defined in the material referenced by the element property record.
Naturally, however, all entities are removed from the user-specified region that are geometrically inconsistent
with the analysis model type. Two entities that are geometrically inconsistent with 2D Axisymmetric analyses,
for example, are surfaces that do not lie in the axisymmetric modeling plane, and solids. Entities lacking a
needed property such as density are also discarded. Upon completion, the user receives a warning if any
specified entities were ignored. The warning includes a list of all rejected entities.
918 PatranReference Manual
Summary of Mass Properties
D List Processor
Introduction
The list processor interprets the contents of all select databoxes. All select databoxes in Patran expect character
strings as input. The character strings may be supplied by the graphics system when the user selects an entity
from a viewport or the string can be typed, or pasted in directly. The character strings are called “pick lists.”
The pick list syntax is common throughout Patran which means that for each application all of the select
features are available at all times. Because the interpretation of input data is so general, the description must
be specific. If the application is expecting nodes as input, it is not enough just to type their ids, the word
“Node” must be added to the beginning.
Examples of pick list syntax are:
Node 9 18
Elm 1 4 5 8
Quad 4
hpat 10
Surface 1.2
In addition to referring to entities which exist in the database, Patran allows selection of immediate geometric
entities such as a straight line defined by two endpoints. As long as the application is not associating attributes
to the entity, it is a valid option. An example of the syntax of a straight line defined by two points is:
Construct 2PointCurve(Evaluate Geometry(Point 2 ))(Evaluate
Geometry(Point 4 ))
Many of the items in pick lists can be abbreviated. An example of the abbreviation of the previous pick list is:
Co 2PointCurve( Ev Geo (G2))( Ev Geo (G4))
In most cases, the immediate geometric entities are defined by cursor picking in the graphics viewport and
the pick list is created, making it unnecessary to memorize the pick list syntax.
This section is intended to assist you in understanding the syntax used by the list processor so that, not only
will you understand the interaction between the Patran selection mechanism (via the select menus) and
Patran application programs, but you will also be able to modify improperly-selected entries to suit your
needs. Each area in this section contains syntax definitions as well as examples of the syntax in use.
Important: Wherever white space is necessary to separate two items from one another, the list
processor will accept any number of blank characters, commas, or slashes without
distinction.
Ap. D: List Processor 921
Understanding the List Processor
Geometry
Points
Referring to points which exist as the vertexes of other entities which exist in the database
Patran allows applications to use points in a topological context for any operation where points are valid. That
is, if it is more convenient to refer to points in their vertex context to edges or faces, Patran will allow it. The
syntax for using this form can be described symbolically as:
Referring to points by referring to finite element nodes which exist where a point is to be
located
Point lists can also be formed by the selection mechanism from finite element nodes which already exist in
the Patran database. Any application which uses the point list to gather [X Y Z] geometry for further
processing, rather than for label or ID information, will accept point lists which coerce values from the finite
element node definitions. The syntax for this form is described symbolically as:
Ap. D: List Processor 923
Understanding the List Processor
<digit> ::= 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
<surfaceEdgeExpression> ::= <surfaceKW>
<surfaceLabel>.<surfaceEdge>
<surfaceKW> ::= Surface | Surf | Srf | S | Patch | Pa |
P
<surfaceLabel ::= <int>
<surfaceEdge> ::= <int>
<solidEdgeExpression> ::= <solidKW><solidLabel>.<solidFace>.
<solidFaceEdge>
<solidKW> ::= Solid | Sld | Sl | Hyperpatch | Hpat |
Hp| H
<solidLabel> ::= <int>
<solidFace> ::= <int>
<solidFaceEdge> ::= <int>
<curveConstructionExpression> ::= <2PointCurveExpression> |
<2SurfaceCurveExpression>
Table 4-6 Examples of Points Defined by the Intersection of a Curve and a Surface
List Processor Syntax Meaning
Construct CurveSurfacePoint (Evaluate Geo A point at the intersection of curve 1 and surface 2 will
(Curve 1)) (Evaluate Geo (Surface 2)) be used for an application requesting [X Y Z]
information for a point.
Make CurveSurfacePoint (Ev Geo (S1.2)) (Ev A point at the intersection of the 2nd edge of surface 1
Geo (S2)) with surface 2 will be used for an application requesting
[X Y Z] information for a point.
Co CurveSurfacePoint (Eval GeometryDef A point at the intersection of the 3rd edge of the 2nd
(Solid 1.2.3)) (Evaluate GeometryDefinition face of solid 1 with surface 4 will be used for an
(Surface 4)) application requesting [X Y Z] information for a point.
Table 4-7 Examples of Points Defined by the Closest Approach of a Point to a Curve
List Processor Syntax Meaning
Construct PointCurvePoint (Evaluate Geo A point at the closest approach of point 1 to curve 2 will
(Point 1)) (Evaluate Geo (Curve 2)) be used for an application requesting [X Y Z]
information for a point.
Make PointCurvePoint (Ev Geo (S1.2.1)) (Ev A point at the intersection of the 1st vertex of the 2nd
Geo (L2)) edge of surface 1 with curve 2 will be used for an
application requesting [X Y Z] information for a point.
Co PointCurvePoint (Eval GeometryDef A point at the intersection of the 1st vertex of the 3rd
(Solid 1.2.3.1)) (Evaluate edge of the 2nd face of solid 1 with curve 4 will be used
GeometryDefinition (Curve 4)) for an application requesting [X Y Z] information for a
point.
Table 4-8 Examples of Points Defined by the Closest Approach of a Point to a Surface.
List Processor Syntax Meaning
Construct PointSurfacePoint (Evaluate Geo A point at the closest approach of point 1 to surface 2
(Point 1)) (Evaluate Geo (Surface 2)) will be used for an application requesting [X Y Z]
information for a point.
Make PointSurfacePoint (Ev Geo (S1.2.1)) (Ev A point at the closest approach of the 1st vertex of the
Geo (S2)) 2nd edge of surface 1 with surface 2 will be used for an
application requesting [X Y Z] information for a point.
Co PointSurfacePoint (Eval GeometryDef A point at the intersection of the 1st vertex of the 3rd
(Solid 1.2.3.1)) (Evaluate GeometryDefinition edge of the 2nd face of solid 1 with surface 4 will be
(Surface 4)) used for an application requesting [X Y Z] information
for a point.
Curves
Referring to curves which exist as the edges of other entities which exist in the database
Patran allows applications to use curves in a topological context for any operation where curves are valid. That
is, if it is more convenient to refer to curves in their edge context to faces, Patran will allow it. The syntax for
using this form can be described symbolically as:
Table 4-11 Examples of Curves Defined by a Straight Line Between Two Points
List Processor Syntax Meaning
Construct 2PointCurve (Evaluate Geo A curve defined by a straight line between point 1 and point
(Point 1)) (Evaluate Geo (Point 2)) 2 will be used for an application requesting the geometry of
a curve.
Make 2PointCurve (Ev Geo (S1.2.1)) (Ev A curve defined by a straight line between the 1st vertex of
Geo (G2)) the 2nd edge of surface 1 with point 2 will be used for an
application requesting the geometry of a curve.
Co 2PointCurve (Eval GeometryDef A curve defined by a straight line between the 1st vertex of
(Solid 1.2.3.1)) (Evaluate the 3rd edge of the 2nd face of solid 1 with point 4 will be
GeometryDefinition used for an application requesting the geometry of a curve.
(Point 4))
936 Patran Reference Manual
Understanding the List Processor
Note: The syntax for <2CurveSurfaceExpression> may be found under the appropriate heading in
this section.
Table 4-13 Examples of Referring to a Curve and a Parametric Location on the Curve
List Processor Syntax Meaning
Curve 1 (u 0) Curve 1 at u = 0.0.
L1 (u .5) Curve 1 at u = 0.5.
Crv 1 (U 1.000) Curve 1 at u = 1.0.
Surfaces
Referring to surfaces which exist as the faces of other entities which exist in the database
Patran allows applications to use surfaces in a topological context for any operation where surfaces are valid.
That is, if it is more convenient to refer to surfaces in their face context to solids, Patran will allow it. The
syntax for using this form can be described symbolically as:
Ap. D: List Processor 939
Understanding the List Processor
0:n
<surfaceTopologicallyInDatabaseList> ::= { <solidFaceList> }
<solidFaceList> ::= <solidKW>
<singleToplogicalIndentLabelList> {
<singleToplogicalIndentLabelList> }
0:n
<vKW> ::= V
<vValue> ::= <float>
942 Patran Reference Manual
Understanding the List Processor
Table 4-17 Examples of Referring to a Surface and a Parametric Location on the Surface
List Processor Syntax Meaning
Surface 1 (u 0) (v 0) Surface 1 at u = 0.0, v = 0.0.
P1 (u .5) (v .5) Surface 1 at u = 0.5, v = 0.5.
Srf 1 (U 1.000) (v 1.000) Surface 1 at u = 1.0, v = 1.0.
Solids
definition phase. A user must tell the selection mechanism that she wishes to select a solid via the two surface
solid mechanism, select two surfaces (by any of the available selection mechanisms, including such methods
as construction of surfaces between 2 curves, etc.) and allow the system to evaluate the resulting expression.
This expression, while somewhat verbose, is quite general in its ability to conform to user expectations for
robustness. The syntax for this type of expression is diagrammatically described as:
Note: The syntax for <2CurveSurfaceExpression>, may be found under the appropriate heading in
this section.
944 Patran Reference Manual
Understanding the List Processor
Finite Elements
Referring to nodes in the database
Node selection yields pick lists which refer to nodes that already exist in the Patran database. The syntax for
this form is described symbolically below:
Miscellaneous
Referring to a coordinate frame
The selection mechanism generates a simple pick list for coordinate frames for the list processor to work with.
Its syntax is:
and list processor, points may be defined with arbitrary complexity, such as the intersection of two lines being
the base of an axis with the closest approach of a point to a surface being the tip.
Index
Patran Reference Manual
A databases
ACIS (sat) files, 167 closing, 71
analysis manager, 467 creating, 69
Index applications opening, 70
mass properties, 916 rebuilding
automatic centering, 335 , 72
reverting, 72
saving, 72
B Deformable Bodies, 642
Bar End Loads, 660
design studies, 644, 645, 654
Bar/Spring Force Moment, 656
displacement results files, 901
beam library, 493
display
beam results files, 907
color configurations, 365
bolt preload, 621
menu, 12
bolt_create_elemental, 630
properties, 365
bolt_create_geometric, 630
bolt_create_vectorial, 630
bolt_delete, 630 E
boolean lists, 477 Ease-of-use enhancements
Hierarchical groups, 286
element force, 656, 660
C Element Quick Create, 550
CATIA files, 120, 155, 160
element results files, 906
CGM, 912
EPS files, 221
clipping, 339
experimental data fitting, 618
clipping perspective, 339
Explore, 678
clipping plane, 337
exporting models, 73
color configurations, 365
IGES files, 197, 206
command line comments, 20
Patran 2.5 Neutral files, 195
configurations, 574
STEP files, 202
coordinate system, 334
express neutral files, 106
creating lists, 470
current viewport, 305
F
Fatigue, 707
D feature recognition, 638
database
file commands, 74
freeing unused space, 72
956 Patran Reference Manual
file formats H
IGES file, 898 hardcopy
journal file, 896 CGM, 912
neutral file, 858 device-dependent, 912
session file, 896 postscript, 912
file menu, 12 printers/plotters, 912
file types setup, 913
hardcopy file, 60 supported hardware, 914
IGES file, 60 Hierarchical groups, 286
journal file, 60
PATRAN 2.5 results files, 60
PATRAN 2.5 results template files, 908
I
IGES file, 60, 898
PATRAN database, 60
IGES files, 111, 197, 206
files
image files, 74
p3epilog.pcl, 66
importing models, 72
p3prolog.pcl, 66
ACIS (sat) files, 167
session, 66
CATIA files, 120, 155, 160
settings.pcl, 61, 65
Express neutral files, 106
template database, 67
IGES files, 111
focal point, 337
Parasolid (xmt) files, 167
force results files, 901
PATRAN 2.5 neutral files, 99
functional assignments, 5
Patran databases, 87
Pro/ENGINEER files, 144
G STL files, 189
geometry importing modesl
direct geometry integration, 2 Parasolid (xmt) files, 163
grid point force balance, 660 importing results, 72
group
attributes, 241, 284
current, 241
J
journal file, 60, 896
membership, 241
menu, 12
modify, 255 L
names, 240 laminate modeler, 465
posted, 241 list processor, 39, 920
status, 241 Load Tools, 525
target, 241
transformations, 243 M
Groups, hierarchical, 286 mass properties, 479, 916
Mass Property Management, 556
Max/Min Sorting, 667
Model Content, 517
model space, 334
model unmerge, 612
model variables, 511, 540
INDEX 957
SuperGroups, 250
T
template database file, 67
Test Correlation, 706, 714
U
undo, 212
Unigraphics-NX, 155
User Defined AOM, 713
V
view
automatic centering, 335
clipping, 339
clipping perspective, 339
clipping plane, 337
clipping/capping, 336
coordinate system, 334
focal point, 337
menu, 12
model space, 334
named views, 339
observer position, 337
screen space, 334
select corners, 338
viewing plane, 337
viewport menu, 12
window center, 337
zoom, 339
viewing plane, 337
viewport, 4, 11, 12, 304
menu, 12
W
window center, 337
Z
zoom, 339