ACP User's Guide

ANSYS, Inc. Release 2024 R1

Southpointe January 2024
2600 Ansys Drive
Canonsburg, PA 15317 ANSYS, Inc. and
[email protected] ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2015
(F) 724-514-9494 companies.
Copyright and Trademark Information

© 2024 ANSYS, Inc. Unauthorized use, distribution or duplication is prohibited.

ANSYS, Ansys Workbench, AUTODYN, CFX, FLUENT and any and all ANSYS, Inc. brand, product, service and feature
names, logos and slogans are registered trademarks or trademarks of ANSYS, Inc. or its subsidiaries located in the
United States or other countries. ICEM CFD is a trademark used by ANSYS, Inc. under license. CFX is a trademark
of Sony Corporation in Japan. All other brand, product, service and feature names or trademarks are the property
of their respective owners. FLEXlm and FLEXnet are trademarks of Flexera Software LLC.

Disclaimer Notice

THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.

ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2015 companies.

U.S. Government Rights

For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).

Third-Party Software

See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, contact ANSYS, Inc.

Published in the U.S.A.

Table of Contents
1. Getting Started ....................................................................................................................................... 1
1.1. Overview .......................................................................................................................................... 1
1.1.1. Introduction ............................................................................................................................ 1
1.1.2. Supported Platforms and Functional Add-ons ........................................................................... 2
1.1.3. Known Limitations ................................................................................................................... 3
1.1.4. First Steps ................................................................................................................................ 4
1.2. The Ansys Product Improvement Program ......................................................................................... 5
1.3. Graphical User Interface .................................................................................................................... 9
1.3.1. Menus ..................................................................................................................................... 9
1.3.1.1. File ................................................................................................................................ 10
1.3.1.1.1. Workbench ........................................................................................................... 10
1.3.1.1.2. Stand Alone .......................................................................................................... 10
1.3.1.2. View .............................................................................................................................. 11
1.3.1.2.1. Perspectives ......................................................................................................... 12
1.3.1.2.2. View Manager ....................................................................................................... 12
1.3.1.3. Tools ............................................................................................................................. 13
1.3.1.3.1. Extract Materials From Composite CAE H5... ........................................................... 13
1.3.1.3.2. Winding Wizard .................................................................................................... 13
1.3.1.3.3. Preferences ........................................................................................................... 15
1.3.1.3.3.1. Add Ons ....................................................................................................... 16
1.3.1.3.3.2. Ansys Product Improvement Program ........................................................... 16
1.3.1.3.3.3. General ACP Preferences .............................................................................. 16
1.3.1.3.3.4. Logger Settings ............................................................................................ 17
1.3.1.3.3.5. Material Database ........................................................................................ 17
1.3.1.3.3.6. Notifications and Pop-ups ............................................................................ 18
1.3.1.3.3.7. Scene Preferences ........................................................................................ 18
1.3.1.3.3.8. Section Generation ...................................................................................... 18
1.3.1.3.3.9. Units ............................................................................................................ 19
1.3.2. Tree View ............................................................................................................................... 20
1.3.3. Scene ..................................................................................................................................... 22
1.3.3.1. Scene Manipulation ....................................................................................................... 22
1.3.4. Toolbar .................................................................................................................................. 22
1.3.4.1. Updates ........................................................................................................................ 23
1.3.4.2. Edit Entities with Excel ................................................................................................... 23
1.3.4.3. Mesh Appearance .......................................................................................................... 24
1.3.4.4. Orientation Visualization ................................................................................................ 24
1.3.4.5. Fiber Directions ............................................................................................................. 26
1.3.4.6. Draping ......................................................................................................................... 27
1.3.4.7. Other Features ............................................................................................................... 30
1.3.4.8. Configure Plots .............................................................................................................. 31
1.3.5. View Panes ............................................................................................................................. 32
1.3.5.1. Shell View ...................................................................................................................... 32
1.3.5.2. Keyboard Shortcuts ....................................................................................................... 33
1.3.5.3. Logger .......................................................................................................................... 34
1.3.5.4. History View .................................................................................................................. 34
1.3.6. Keyboard Shortcuts ................................................................................................................ 34
1.3.6.1. General Shortcuts .......................................................................................................... 34
1.3.6.2. Scene View Shortcuts .................................................................................................... 35
1.3.6.3. Tree View Shortcuts ....................................................................................................... 35

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
ACP User's Guide

1.3.6.4. Shell View ...................................................................................................................... 35

1.3.6.5. Properties Windows ....................................................................................................... 36
1.4. Implementation in Workbench ........................................................................................................ 37
1.4.1. Basic Workflow ....................................................................................................................... 37
1.4.2. ACP Component Properties .................................................................................................... 41
1.4.3. Supported Analysis Types ....................................................................................................... 43
1.4.3.1. ACP–LS-DYNA ............................................................................................................... 44
1.4.4. Multiple Load Cases and Analyses ........................................................................................... 46
1.4.5. Shared Composite Definition for Different Models .................................................................. 46
1.4.6. Solid Modeling ....................................................................................................................... 47
1.4.7. Assembly ............................................................................................................................... 48
1.4.7.1. Renumbering and Transfer Type ..................................................................................... 49
1.4.7.2. Creating a Mixed Assembly ............................................................................................ 50
1.4.8. Limitations ............................................................................................................................. 51
1.5. Migrating ACP Projects from Previous Versions ................................................................................ 52
1.6. Stand Alone Operation ................................................................................................................... 53
1.6.1. Starting ACP in Windows ........................................................................................................ 53
1.6.2. Starting ACP in Linux .............................................................................................................. 53
1.6.3. Command Line Options and Batch Mode ................................................................................ 54
1.6.4. Workflow in Stand Alone Operation ........................................................................................ 54
1.7.Tutorials and Examples .................................................................................................................... 56
2. Usage Reference .................................................................................................................................... 57
2.1. Features ......................................................................................................................................... 57
2.1.1. Model .................................................................................................................................... 58
2.1.1.1. Model Properties - General ............................................................................................ 59
2.1.1.1.1. ACP Model ............................................................................................................ 61
2.1.1.1.2. Reference Surface ................................................................................................. 61
2.1.1.1.3. Lay-Up Computation ............................................................................................. 61
2.1.1.1.4. Model Summary ................................................................................................... 62
2.1.1.2. Solve ............................................................................................................................. 62
2.1.1.3. Import/Export of ACP Composite Definitions File ........................................................... 63
2.1.1.4. Import From/Export to HDF5 Composite CAE File ........................................................... 64
2.1.1.5. Import Section Data from Legacy Model ........................................................................ 64
2.1.1.6. Element- vs. Node-based Thicknesses ............................................................................. 64
2.1.1.7. Winding Wizard ............................................................................................................. 67
2.1.2. Scripts ................................................................................................................................... 67
2.1.2.1. Executing Scripts ........................................................................................................... 68
2.1.2.2. Script Properties ............................................................................................................ 68
2.1.2.3. Limitations .................................................................................................................... 69
2.1.2.4. Tips and Best Practices ................................................................................................... 69
2.1.2.5. Sorting Scripts ............................................................................................................... 70
2.1.3. Material Data ......................................................................................................................... 70
2.1.3.1. Materials ....................................................................................................................... 71
2.1.3.1.1. Materials Context Menu ........................................................................................ 71
2.1.3.1.2. Temperature Dependent and General Variable Material Properties ......................... 71
2.1.3.1.3. Material Properties Dialog ..................................................................................... 72
2.1.3.1.4. Thermal Expansion Coefficients ............................................................................. 74
2.1.3.1.5. Fabric Fiber Angle ................................................................................................. 74
2.1.3.1.6. Strain Limits .......................................................................................................... 75
2.1.3.1.7. Stress Limits .......................................................................................................... 76
2.1.3.1.8. Puck Constants ..................................................................................................... 77

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

2.1.3.1.9. Puck for Woven ..................................................................................................... 78

2.1.3.1.10. Tsai-Wu Constants ............................................................................................... 79
2.1.3.1.11. LaRC Constants ................................................................................................... 80
2.1.3.2. Fabric ............................................................................................................................ 80
2.1.3.2.1. General ................................................................................................................. 81
2.1.3.2.2. Polar Properties .................................................................................................... 81
2.1.3.2.3. Fabric Solid Model Options ................................................................................... 82
2.1.3.2.4. Draping ............................................................................................................... 83
2.1.3.3. Stackup ......................................................................................................................... 84
2.1.3.3.1. Top-Down or Bottom-Up Sequence ....................................................................... 85
2.1.3.3.2. Symmetries .......................................................................................................... 85
2.1.3.3.3. Analysis ................................................................................................................ 87
2.1.3.3.4. Stackup Solid Model Options ................................................................................ 89
2.1.3.3.5. Draping Options ................................................................................................... 89
2.1.3.4. Sublaminates ................................................................................................................ 89
2.1.4. Element and Edge Sets ........................................................................................................... 90
2.1.4.1. Element Sets ................................................................................................................. 91
2.1.4.1.1. Context Menu ....................................................................................................... 92
2.1.4.2. Edge Sets ...................................................................................................................... 92
2.1.5. Geometry .............................................................................................................................. 93
2.1.5.1. CAD Geometries ............................................................................................................ 95
2.1.5.1.1. Direct Import ........................................................................................................ 96
2.1.5.1.2. Workbench Geometry Link .................................................................................... 97
2.1.5.2. Virtual Geometries ......................................................................................................... 97
2.1.6. Rosettes ................................................................................................................................. 99
2.1.6.1. Rosette Definition ........................................................................................................ 102
2.1.7. Look-Up Tables ..................................................................................................................... 103
2.1.7.1. 3D Look-Up Table With The Excel Link ........................................................................... 103
2.1.7.2. 1D Look-Up Table with .csv Files ................................................................................... 105
2.1.7.3. Look-Up Table with a Python Script .............................................................................. 107
2.1.7.4. 1-D Look-Up Table ....................................................................................................... 108
2.1.7.5. 3D Look-Up Table ........................................................................................................ 108
2.1.7.6. Look-Up Table Column Properties ................................................................................ 110
2.1.8. Selection Rules ..................................................................................................................... 111
2.1.8.1. Basic Selection Rules .................................................................................................... 112
2.1.8.2. Tube Selection Rule ..................................................................................................... 114
2.1.8.3. Cut-Off Selection Rules ................................................................................................ 116
2.1.8.3.1. Geometry Cut-Off Selection Rule ......................................................................... 117
2.1.8.3.2. Taper Cut-Off Selection Rule ................................................................................ 119
2.1.8.3.3. Example Cut-Off .................................................................................................. 120
2.1.8.4. Geometrical Selection Rule .......................................................................................... 121
2.1.8.5. Variable Offset Selection Rule ....................................................................................... 124
2.1.8.6. Boolean Selection Rules ............................................................................................... 127
2.1.9. Oriented Selection Sets (OSS) ............................................................................................... 128
2.1.9.1. Reference Direction ..................................................................................................... 129
2.1.9.2. Selection Rules ............................................................................................................ 131
2.1.9.3. Draping ....................................................................................................................... 132
2.1.10. Modeling Groups ............................................................................................................... 133
2.1.10.1. Modeling Group Structure ......................................................................................... 133
2.1.10.2. Modeling Group Tree Object Context Menu ................................................................ 134
2.1.10.3. Individual Modeling Group Context Menu .................................................................. 135

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. v
ACP User's Guide

2.1.10.4. Modeling Ply Properties ............................................................................................. 136

2.1.10.4.1. Draping ............................................................................................................ 137
2.1.10.4.2. Selection Rules .................................................................................................. 139
2.1.10.4.3. Thickness .......................................................................................................... 140
2.1.10.4.4. Modeling Ply Context Menu .............................................................................. 143
2.1.10.5. Interface Layer Properties .......................................................................................... 145
2.1.10.6. Butt Joint Sequence ................................................................................................... 146
2.1.10.6.1. Butt Joint Sequence Notes and Limitations ........................................................ 148
2.1.10.7. Reordering Modeling Plies, Interface Layers, and Butt Joint Sequences ........................ 149
2.1.10.8. Production Ply ........................................................................................................... 149
2.1.10.9. Analysis Ply ................................................................................................................ 150
2.1.10.10. Import from / Export to CSV File ............................................................................... 150
2.1.10.10.1. Export ............................................................................................................. 151
2.1.10.10.2. Import ............................................................................................................ 151
2.1.10.11. Export Ply Geometry ................................................................................................ 151
2.1.11. Imported Modeling Group .................................................................................................. 152
2.1.11.1. Tree Object Context Menu ......................................................................................... 153
2.1.11.2. Imported Modeling Ply .............................................................................................. 153
2.1.11.2.1. Imported Modeling Ply Properties ..................................................................... 154
2.1.11.3. Imported Production Ply ............................................................................................ 157
2.1.11.4. Imported Analysis Ply ................................................................................................ 158
2.1.12. Field Definitions ................................................................................................................. 158
2.1.13. Sampling Points ................................................................................................................. 161
2.1.14. Section Cuts ....................................................................................................................... 164
2.1.14.1. Types of Extrusion ...................................................................................................... 166
2.1.14.2. Section Cut Notes ...................................................................................................... 168
2.1.14.3. Section Cut Export ..................................................................................................... 169
2.1.15. Sensors .............................................................................................................................. 169
2.1.16. Solid Models ...................................................................................................................... 171
2.1.16.1. Solid Model ............................................................................................................... 172
2.1.16.1.1. Properties ......................................................................................................... 173
2.1.16.1.1.1. General .................................................................................................... 173
2.1.16.1.1.2. Drop-Offs ................................................................................................. 177
2.1.16.1.1.3. Export ...................................................................................................... 179
2.1.16.1.2. Export Solid Model ............................................................................................ 182
2.1.16.1.3. Extrusion Guides ............................................................................................... 183
2.1.16.1.3.1. Mesh Morphing ........................................................................................ 185
2.1.16.1.3.2. Extrusion Guide Examples ........................................................................ 186
2.1.16.1.4. Snap-To Geometry ............................................................................................ 188
2.1.16.1.5. Cut-Off Geometry ............................................................................................. 190
2.1.16.1.5.1. Defining Cut-Off Geometry ....................................................................... 191
2.1.16.1.5.2. Decomposition of Degenerated Elements ................................................. 193
2.1.16.1.5.3. Limitations ............................................................................................... 193
2.1.16.1.6. Mesh Components ............................................................................................ 194
2.1.16.1.7. Material Handling for Different Extrusion Methods ............................................. 195
2.1.16.1.8. Save & Reload Solid Models ............................................................................... 195
2.1.16.1.9. Node-based Thicknesses ................................................................................... 195
2.1.16.2. Imported Solid Model ................................................................................................ 196
2.1.16.2.1. Imported Solid Model Properties ....................................................................... 197
2.1.16.2.1.1. General Tab .............................................................................................. 198
2.1.16.2.1.2. Export Tab ................................................................................................ 199

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
vi of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

2.1.16.2.1.3. Mapping Statistics .................................................................................... 199

2.1.16.2.2. Mesh Components ............................................................................................ 199
2.1.16.2.3. Lay-up Mapping Objects ................................................................................... 200
2.1.16.2.3.1. General Tab .............................................................................................. 200
2.1.16.2.3.2. Layered Element Tab ................................................................................. 203
2.1.16.2.3.2.1. Limitations ...................................................................................... 206
2.1.16.2.3.3. Reinforcing Tab ........................................................................................ 207
2.1.16.2.3.3.1. Design Tips and Best Practices .......................................................... 208
2.1.16.2.3.3.2. Limitations ...................................................................................... 208
2.1.16.2.4. Quality Check .................................................................................................... 209
2.1.16.2.5. Miscellaneous ................................................................................................... 209
2.1.17. Lay-Up Plots ....................................................................................................................... 210
2.1.17.1. Interface Options ....................................................................................................... 211
2.1.17.2. Thickness Plots .......................................................................................................... 214
2.1.17.3. Angle Plot .................................................................................................................. 215
2.1.17.4. Draping Mesh Plot ..................................................................................................... 215
2.1.17.5. Look-Up Table Plot ..................................................................................................... 217
2.1.17.6. Field Definition Plot ................................................................................................... 219
2.1.17.7. Lay-Up Mapping Plot ................................................................................................. 219
2.1.17.8. Material Plots ............................................................................................................. 221
2.1.17.9. User-Defined Plot ...................................................................................................... 221
2.1.18. Definitions ......................................................................................................................... 221
2.1.19. Solutions ............................................................................................................................ 222
2.1.19.1. Solution Object ......................................................................................................... 223
2.1.19.1.1. Solution Context Menu ..................................................................................... 223
2.1.19.1.2. Solution Properties ........................................................................................... 224
2.1.19.2. Envelope Solution ...................................................................................................... 226
2.1.19.3. Solution Plots ............................................................................................................ 227
2.1.19.3.1. Common Plot Settings ...................................................................................... 227
2.1.19.3.2. Visualization Mismatch ...................................................................................... 229
2.1.19.3.3. Deformation Plot .............................................................................................. 229
2.1.19.3.4. Strain Plot ......................................................................................................... 229
2.1.19.3.5. Stress Plot ......................................................................................................... 230
2.1.19.3.6. Failure Mode Plot .............................................................................................. 231
2.1.19.3.7. Temperature Plot .............................................................................................. 232
2.1.19.3.8. Progressive Damage Plot ................................................................................... 232
2.1.19.3.9. Material Plot ..................................................................................................... 233
2.1.19.3.10. User-Defined Plot ............................................................................................ 235
2.1.20. Scenes ............................................................................................................................... 243
2.1.21. Views ................................................................................................................................. 244
2.1.22. Ply Books ........................................................................................................................... 245
2.1.22.1. Creating Chapters ...................................................................................................... 245
2.1.22.2. Chapter Properties ..................................................................................................... 246
2.1.22.3. Editing the Ply Book Template .................................................................................... 246
2.1.22.3.1. Python Expressions ........................................................................................... 248
2.1.22.4. Modifying the Ply Book Snapshots ............................................................................. 249
2.1.22.5. Exporting the Plybook ............................................................................................... 249
2.1.22.6. Sample Ply Book Page ................................................................................................ 250
2.1.22.7. Ply Book Limitations .................................................................................................. 252
2.1.23. Parameters ......................................................................................................................... 252
2.1.23.1. Settings for an Expression Output .............................................................................. 254

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. vii
ACP User's Guide

2.1.24. Material Database .............................................................................................................. 255

2.2. Postprocessing ............................................................................................................................. 256
2.2.1. Failure Criteria ...................................................................................................................... 257
2.2.2. Failure Mode Measures ......................................................................................................... 258
2.2.3. Principal Stresses and Strains ................................................................................................ 258
2.2.4. Linearization of Inverse Reserve Factors ................................................................................ 258
2.2.5. Postprocessing of a Composite Solid Model .......................................................................... 259
2.2.6. Postprocessing of Drop-Off and Cut-Off Elements ................................................................. 260
2.2.7. Evaluating Custom Failure Criteria ........................................................................................ 260
2.2.8. Limitations & Recommendations .......................................................................................... 263
2.3. Exchanging Composite Definitions with Other Programs ............................................................... 264
2.3.1. HDF5 Composite CAE Format ............................................................................................... 264
2.3.1.1. Export ......................................................................................................................... 265
2.3.1.2. Import ......................................................................................................................... 267
2.3.1.2.1. Import Projection Types ...................................................................................... 268
2.3.1.2.2. Import Settings ................................................................................................... 269
2.3.2. Mechanical APDL File Format ................................................................................................ 271
2.3.3. Import of Legacy Mechanical APDL Composite Models ......................................................... 273
2.3.3.1. Special Cases ............................................................................................................... 275
2.3.3.2. Known Limitations ....................................................................................................... 276
2.3.4.Tabular Data Format for Excel ................................................................................................ 276
2.3.5. CSV Format .......................................................................................................................... 277
2.3.6. ESAComp ............................................................................................................................. 277
2.3.6.1. Export ......................................................................................................................... 278
2.3.6.2. Import ......................................................................................................................... 278
2.3.7. LS-Dyna ............................................................................................................................... 278
2.3.8. BECAS .................................................................................................................................. 279
3. Composite Modeling Techniques ........................................................................................................ 281
3.1. T-Joint .......................................................................................................................................... 281
3.2. Local Reinforcements .................................................................................................................... 287
3.3. Ply Tapering and Staggering .......................................................................................................... 289
3.3.1. Ply Tapering ......................................................................................................................... 289
3.3.1.1. Edge Tapering ............................................................................................................. 289
3.3.1.2. Tapered Core .............................................................................................................. 290
3.3.1.3. Tapered Edges ............................................................................................................. 290
3.3.1.4. Tapering of Multiple Plies ............................................................................................. 292
3.3.2. Ply Staggering ...................................................................................................................... 292
3.4. Variable Core Thickness ................................................................................................................. 293
3.4.1. Solid CAD Geometry ............................................................................................................ 294
3.4.2. Look-Up Table ...................................................................................................................... 295
3.4.3. Geometry Cut-Off Selection Rule .......................................................................................... 296
3.4.4. General Application .............................................................................................................. 298
3.5. Draping ........................................................................................................................................ 298
3.5.1. Internal Draping Algorithm of ACP ........................................................................................ 299
3.5.2. User-Defined Draping ........................................................................................................... 301
3.5.3. Visualization ......................................................................................................................... 302
3.6. Guide to Solid Modeling ................................................................................................................ 303
3.6.1. When to Use a Solid Model ................................................................................................... 304
3.6.2. How to Use the Solid Model Feature ..................................................................................... 304
3.6.3. Principles of Solid Model Generation .................................................................................... 305
3.6.4. Drop-Off and Cut-Off Elements ............................................................................................. 305

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
viii of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

3.6.5. Workflow ............................................................................................................................. 306

3.6.6. Practical Tips ........................................................................................................................ 307
3.6.7. Known Limitations ............................................................................................................... 308
3.7. Guide to Composite Visualizations ................................................................................................. 310
3.7.1. Model Verification ................................................................................................................ 310
3.7.2. Postprocessing Visualizations ............................................................................................... 311
3.8. Guide to Composite Failure Criteria ............................................................................................... 317
3.9. Element Choice in ACP .................................................................................................................. 318
3.9.1. Introduction ......................................................................................................................... 318
3.9.2. Shell Elements ...................................................................................................................... 318
3.9.3. Solid Elements ..................................................................................................................... 318
3.9.4. Solid-shell Elements ............................................................................................................. 319
3.10. Variable Material Data in Composite Analyses .............................................................................. 319
3.10.1. Element- or Layer-wise Field Definition ............................................................................... 319
3.10.2. Draping Shear .................................................................................................................... 320
3.10.3. Degradation Factors ........................................................................................................... 320
3.10.3.1. Definition of the Degradation Factor Field .................................................................. 321
3.10.4. Definition of General User-Defined Fields in ACP-Pre ........................................................... 321
3.10.5. Variable Data Interpolation Settings .................................................................................... 321
4. Example Analyses ................................................................................................................................ 323
4.1. Analysis of a Composite Shell Model .............................................................................................. 323
4.1.1. Preprocessing ...................................................................................................................... 324
4.1.1.1. Workbench Integration ................................................................................................ 324
4.1.1.2. Adding ACP Components to the Project ....................................................................... 324
4.1.1.3. Engineering Data ......................................................................................................... 325
4.1.1.4. Properties .................................................................................................................... 326
4.1.1.5. Geometry and Units ..................................................................................................... 328
4.1.1.6. Named Selections and Elements/Edge Sets .................................................................. 328
4.1.1.7. Starting and Running ACP ............................................................................................ 328
4.1.2. Workbench: Adding an Analysis System to the Project ........................................................... 329
4.1.3. Postprocessing: Adding an ACP (Post) Component to the Project ........................................... 330
4.2. Analysis of a Composite Solid Model ............................................................................................. 331
4.2.1. Preprocessing ...................................................................................................................... 332
4.2.2. Workbench Analysis System ................................................................................................. 333
4.2.3. Postprocessing ..................................................................................................................... 337
4.3. Analysis Using Variable Material Data ............................................................................................. 339
4.3.1. Workbench Engineering Data: Set-Up Variable Data .............................................................. 340
4.3.2. ACP-Pre: Define Fields for Shear Angle, Degradation Factor, and User-Defined Field Vari-
ables ............................................................................................................................................ 343
4.3.3. Mechanical, Thermal Loading, and External Data ................................................................... 344
4.3.4. ACP-Post: Analysis Effect of Variable Data .............................................................................. 345
4.4. Analysis of a Mapped Composite Solid Model ................................................................................ 346
4.4.1. Transfer External Solid Mesh to ACP (Pre) .............................................................................. 347
4.4.1.1. Geometry .................................................................................................................... 348
4.4.1.2. Meshing ...................................................................................................................... 349
4.4.1.3. Linking the Workbench Systems .................................................................................. 350
4.4.2. Lay-Up Mapping in ACP (Pre) ................................................................................................ 350
4.4.3. Analysis of A Mapped Composite Model ............................................................................... 355
4.5. Shear Dependent Materials in Composite Analysis ......................................................................... 356
4.6. 3D Ply Workflow – Imported Plies .................................................................................................. 361
4.6.1. Inputs .................................................................................................................................. 362

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. ix
ACP User's Guide

4.6.2. Example of Use - HDF5 Composite CAE ................................................................................. 363

4.7. ACP for Workbench LS-DYNA: Bird Strike ........................................................................................ 365
4.7.1. Workbench Workflow ........................................................................................................... 366
4.7.2. Engineering Data – Material Model Definition ...................................................................... 366
4.7.3. SpaceClaim – Geometry ....................................................................................................... 368
4.7.4. Mechanical Model Setup ...................................................................................................... 368
4.7.5. ACP - Material Assignment and Lay-Up ................................................................................. 369
4.7.6. Setting Up the LS-DYNA Analysis System .............................................................................. 370
4.7.7. Post-Processing in Workbench LS-DYNA: ............................................................................... 371
5. Theory Documentation ....................................................................................................................... 373
5.1. Draping Simulation ....................................................................................................................... 373
5.1.1. Introduction ......................................................................................................................... 373
5.1.2. Draping Procedure ............................................................................................................... 373
5.1.2.1. Propagation Strategy ................................................................................................... 374
5.1.2.2. Woven Material Model ................................................................................................. 375
5.1.2.3. Unidirectional Material Model ...................................................................................... 375
5.1.2.4. Output of the Draping Simulation ................................................................................ 376
5.1.3. Thickness Correction ............................................................................................................ 376
5.1.4. Limitations of Draping Simulations ....................................................................................... 376
5.2. Interlaminar Stresses ..................................................................................................................... 377
5.2.1. Introduction ......................................................................................................................... 377
5.2.2. Interlaminar Normal Stresses ................................................................................................ 377
5.2.2.1. Reference Coordinates ................................................................................................. 379
5.2.2.2. Numeric Solution ......................................................................................................... 379
5.2.3. Transverse Shear Stresses ..................................................................................................... 380
5.3. Failure Analysis ............................................................................................................................. 383
5.3.1. Reserve Factor ...................................................................................................................... 383
5.3.2. Weighting Factors ................................................................................................................ 383
5.3.3. Failure Criterion Function ..................................................................................................... 384
5.3.4. Failure Criteria for Reinforced Materials ................................................................................. 384
5.3.4.1. Maximum Strain Criterion ............................................................................................ 384
5.3.4.2. Maximum Stress Criterion ............................................................................................ 385
5.3.4.3. Quadratic Failure Criteria ............................................................................................. 385
5.3.4.3.1. Tsai-Wu Failure Criterion ...................................................................................... 385
5.3.4.3.2. Tsai-Hill Failure Criterion ...................................................................................... 386
5.3.4.3.3. Hoffman Failure Criterion .................................................................................... 387
5.3.4.4. Hashin Failure Criterion ................................................................................................ 388
5.3.4.5. Puck Failure Criteria ..................................................................................................... 388
5.3.4.5.1. Simple and Modified Puck Criterion ..................................................................... 389
5.3.4.5.2. Puck's Action Plane Strength Criterion ................................................................. 389
5.3.4.5.2.1. Fiber Failure (FF) ......................................................................................... 389
5.3.4.5.2.2. Interfiber Failure (IFF) ................................................................................. 390
5.3.4.6. LaRC Failure Criterion ................................................................................................... 393
5.3.4.6.1. LaRC03/LaRC04 Constants ................................................................................... 394
5.3.4.6.2. General Expressions ............................................................................................ 395
5.3.4.6.3. Fiber Misalignment Frame ................................................................................... 395
5.3.4.6.4. LaRC03 (2D) ........................................................................................................ 397
5.3.4.6.5. LaRC04 (3D) ........................................................................................................ 398
5.3.4.7. Cuntze's Failure Criteria ................................................................................................ 399
5.3.4.7.1. 3D Failures .......................................................................................................... 401
5.3.4.7.2. 2D Failures .......................................................................................................... 402

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
x of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

5.3.5. Sandwich Failure .................................................................................................................. 403

5.3.5.1. Core Failure ................................................................................................................. 403
5.3.5.2. Face Sheet Wrinkling .................................................................................................... 403
5.3.5.3. Shear Crimping Failure ................................................................................................. 405
5.3.6. Isotropic Material Failure ...................................................................................................... 406
5.3.7. Adhesive Failure (Beta Version) ............................................................................................. 407
5.3.7.1. Peel Stress Criterion ..................................................................................................... 407
5.3.7.2. Shear Stress Criterion ................................................................................................... 407
5.3.8. Failure Criteria vs. Ply Type Table ........................................................................................... 408
5.4. Classical Laminate Theory ............................................................................................................. 408
5.4.1. Overview ............................................................................................................................. 409
5.4.2. Analysis ................................................................................................................................ 409
5.4.2.1. Laminate Stiffness and Compliance Matrices ................................................................ 409
5.4.2.2. Normalized Laminate Stiffness and Compliance Matrices .............................................. 410
5.4.2.3. Laminate Engineering Constants .................................................................................. 411
5.4.2.4. Out-of-Plane Shear Moduli and Correction Factors ....................................................... 412
5.4.2.5. Polar Properties ........................................................................................................... 413
5.4.2.6. Analysis Options .......................................................................................................... 413
5.5. General Interpolation Library ........................................................................................................ 414
5.5.1. Algorithms ........................................................................................................................... 414
5.5.1.1. Nearest-Neighbor Interpolation ................................................................................... 414
5.5.1.2. Linear Multivariate Interpolation .................................................................................. 415
5.5.1.3. Radial-Basis Algorithm ................................................................................................. 416
5.5.2. Options ................................................................................................................................ 417
5.5.3. Extrapolations ...................................................................................................................... 417
5.6. Nomenclature ............................................................................................................................... 418
6. The ACP Python Scripting User Interface ............................................................................................ 421
6.1. Introduction to ACP Scripting ........................................................................................................ 421
6.1.1. Basic Scripting ...................................................................................................................... 421
6.1.2. Advanced Scripting .............................................................................................................. 422
6.1.3. Scripting Examples ............................................................................................................... 423
6.2. Extending the Python Environment in ACP Pre and Post ................................................................ 423
6.2.1. How to Create a Virtual Environment .................................................................................... 423
6.2.2. How to Install a Module in your Virtual Environment and Use it within ACP ............................ 424
6.2.3. Alternatives to Extending ACP’s Python ................................................................................ 424
6.3. The Python Object Tree ................................................................................................................. 425
6.4. DB Database ................................................................................................................................. 425
6.5. Material Classes ............................................................................................................................ 428
6.5.1. MaterialData ........................................................................................................................ 428
6.5.2. Material ............................................................................................................................... 434
6.5.2.1. PropertySet ................................................................................................................. 435
6.5.3. Fabric ................................................................................................................................... 437
6.5.4. Stackup ................................................................................................................................ 440
6.5.5. SubLaminate ........................................................................................................................ 443
6.6. Model Classes ............................................................................................................................... 445
6.6.1. Model .................................................................................................................................. 445
6.6.2. Rosette ................................................................................................................................ 480
6.6.3. LookUpTable ........................................................................................................................ 483
6.6.3.1. LookUpTableBase ........................................................................................................ 483
6.6.3.2. LookUpTable1D ........................................................................................................... 484
6.6.3.3. LookUpTable3D ........................................................................................................... 485

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xi
ACP User's Guide

6.6.3.4. LookUpTableColumn ................................................................................................... 485

6.6.4. ElementSelectionRule Classes ............................................................................................... 486
6.6.4.1. ParallelSelectionRule ................................................................................................... 487
6.6.4.2. CylindricalSelectionRule .............................................................................................. 488
6.6.4.3. SphericalSelectionRule ................................................................................................ 488
6.6.4.4. TubeSelectionRule ....................................................................................................... 489
6.6.4.5. CutoffSelectionRule ..................................................................................................... 490
6.6.4.6. GeometricalSelectionRule ............................................................................................ 491
6.6.4.7. BooleanSelectionRule .................................................................................................. 492
6.6.4.8. VariableOffsetSelectionRule ......................................................................................... 493
6.6.5. EntitySet Classes .................................................................................................................. 494
6.6.5.1. ElementSet .................................................................................................................. 494
6.6.5.2. EdgeSet ....................................................................................................................... 495
6.6.6. Geometry Classes ................................................................................................................. 496
6.6.6.1. CADGeometry ............................................................................................................. 497
6.6.6.2. CADCompound ........................................................................................................... 499
6.6.6.3. CADSolid ..................................................................................................................... 499
6.6.6.4. CADShell ..................................................................................................................... 499
6.6.6.5. CADFace ...................................................................................................................... 499
6.6.6.6. VirtualGeometry .......................................................................................................... 499
6.6.6.7. CADReference ............................................................................................................. 501
6.6.7. OrientedSelectionSet ........................................................................................................... 502
6.6.8. ModelingGroup .................................................................................................................... 504
6.6.8.1. ModelingPly ................................................................................................................ 509
6.6.8.2. ProductionPly .............................................................................................................. 514
6.6.8.3. AnalysisPly .................................................................................................................. 516
6.6.8.4. InterfaceLayer .............................................................................................................. 517
6.6.8.5. ButtJointSequence ...................................................................................................... 518
6.6.9. ImportedModelingGroup ..................................................................................................... 519
6.6.9.1. ImportedModelingPly .................................................................................................. 520
6.6.9.2. ImportedProductionPly ............................................................................................... 522
6.6.9.3. ImportedAnalysisPly .................................................................................................... 522
6.6.10. FieldDefinition ................................................................................................................... 523
6.6.11. SamplingPoint ................................................................................................................... 523
6.6.12. SectionCut ......................................................................................................................... 526
6.6.13. Sensor ................................................................................................................................ 529
6.6.14. PlyBook .............................................................................................................................. 531
6.6.14.1. PlyBook ..................................................................................................................... 531
6.6.14.2. Chapter ..................................................................................................................... 532
6.6.15. PublishedParameter ........................................................................................................... 532
6.6.16. Script ................................................................................................................................. 533
6.7. Solid-model Classes ...................................................................................................................... 534
6.7.1. SolidModel ........................................................................................................................... 534
6.7.2. ExtrusionGuide .................................................................................................................... 538
6.7.3. SnapToGeometry ................................................................................................................. 539
6.7.4. CutOffGeometry .................................................................................................................. 539
6.7.5. SolidElementSet ................................................................................................................... 540
6.7.6. ImportedSolidModel ............................................................................................................ 540
6.7.7. LayupMappingObject .......................................................................................................... 543
6.8. Solution Classes ............................................................................................................................ 545
6.8.1. Solution ............................................................................................................................... 545

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xii of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

6.8.2. EnvelopeSolution ................................................................................................................. 549

6.9. Scene Classes ................................................................................................................................ 550
6.9.1. Scene ................................................................................................................................... 550
6.9.2. View ..................................................................................................................................... 552
6.10. Postprocessing Definition Classes ................................................................................................ 553
6.10.1. CombinedFailureCriteria ..................................................................................................... 553
6.10.1.1. MaxStressCriterion ..................................................................................................... 554
6.10.1.2. MaxStrainCriterion ..................................................................................................... 555
6.10.1.3. TsaiWu ....................................................................................................................... 557
6.10.1.4. TsaiHill ....................................................................................................................... 557
6.10.1.5. Hashin ....................................................................................................................... 557
6.10.1.6. Hoffman .................................................................................................................... 558
6.10.1.7. Puck .......................................................................................................................... 558
6.10.1.8. Wrinkling ................................................................................................................... 560
6.10.1.9. CoreShear .................................................................................................................. 560
6.10.1.10. Larc ......................................................................................................................... 561
6.10.1.11. Cuntze ..................................................................................................................... 562
6.10.1.12. VonMises ................................................................................................................. 563
6.10.1.13. ShearCrimping ......................................................................................................... 564
6.11. Plot Classes ................................................................................................................................. 564
6.11.1. PlotContainer Classes ......................................................................................................... 564
6.11.1.1. PlotDataDict Class ...................................................................................................... 564
6.11.1.2. LayupPlotDict Class ................................................................................................... 565
6.11.1.3. PostProcessingPlotDict Class ...................................................................................... 571
6.11.2. PlotData Classes ................................................................................................................. 578
6.11.2.1. PlotData .................................................................................................................... 578
6.11.2.2. ContourData .............................................................................................................. 583
6.11.2.3. AngleData ................................................................................................................. 584
6.11.2.4. ThicknessData ........................................................................................................... 584
6.11.2.5. ScalarFieldData .......................................................................................................... 584
6.11.2.6. DrapingData .............................................................................................................. 586
6.11.2.7. FieldDefinitionData .................................................................................................... 586
6.11.2.8. LayupMappingData ................................................................................................... 586
6.11.2.9. UserDefinedData ....................................................................................................... 587
6.11.2.10. DeformationContourData ........................................................................................ 588
6.11.2.11. StrainData ............................................................................................................... 588
6.11.2.12. StressData ............................................................................................................... 588
6.11.2.13. FailureData .............................................................................................................. 588
6.11.2.14. TemperatureData ..................................................................................................... 589
6.11.2.15. ProgressiveDamageData .......................................................................................... 590
7. Guide for ACP Terminology ................................................................................................................. 591
Bibliography ............................................................................................................................................. 595

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xiii
 Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xiv of ANSYS, Inc. and its subsidiaries and affiliates.
List of Figures
1.1. Oriented Selection Set Properties ............................................................................................................ 4
1.2. Ansys Composite PrepPost GUI ............................................................................................................... 9
1.3. Ansys Composite PrepPost Menu Options ............................................................................................. 10
1.4. File Menu for Workbench Integration .................................................................................................... 10
1.5. Stand Alone File Menu .......................................................................................................................... 11
1.6. View Menu ........................................................................................................................................... 11
1.7. Perspective Submenu ........................................................................................................................... 12
1.8. Show View ............................................................................................................................................ 12
1.9. Tools Menu ........................................................................................................................................... 13
1.10. Extract Materials From Composite CAE H5... Dialog .............................................................................. 13
1.11. Winding Wizard with the Inputs on Top and the Description at the Bottom ........................................... 15
1.12. Preferences Window ........................................................................................................................... 16
1.13. General ACP Preferences ..................................................................................................................... 17
1.14. Logger Preferences ............................................................................................................................. 17
1.15. Scene Preferences ............................................................................................................................... 18
1.16. Section Generation Preferences ........................................................................................................... 19
1.17. Units Menu ......................................................................................................................................... 19
1.18. Tree View ............................................................................................................................................ 21
1.19. Locked Rosettes and the Update Status ............................................................................................... 21
1.20. Excel Link Dialog ................................................................................................................................. 23
1.21. Orientation Visualizations in the Toolbar .............................................................................................. 24
1.22. Visualization of the Element Normals ................................................................................................... 25
1.23. Visualization of the OSS Normal ........................................................................................................... 25
1.24. Visualization of the OSS Reference Direction ........................................................................................ 26
1.25. Fiber Directions in the Toolbar ............................................................................................................. 26
1.26. Visualization of the Fiber Direction ...................................................................................................... 27
1.27. Visualization of the Transverse Ply Direction ......................................................................................... 27
1.28. Draping Directions in the Toolbar ........................................................................................................ 28
1.29. Fiber Directions (Defined and Draped) ................................................................................................. 28
1.30. Traverse Directions (Defined and Draped) ............................................................................................ 29
1.31. Material 1 Direction and Draped Fiber Direction for a Material with a 45° Fabric Fiber Angle .................. 29
1.32. Enclosed Box and Coordinate System .................................................................................................. 30
1.33. Distance Measure Tool ........................................................................................................................ 31
1.34. Properties from Right-Click Context Menu ........................................................................................... 42
1.35. Properties Menu: Setup ....................................................................................................................... 42
1.36. Sample Workflow of ACP – LS-DYNA within Workbench ....................................................................... 44
1.37. Create an LS-DYNA Keyword (.k) File from the Workbench Model within Mechanical ............................. 45
1.38. Multiple Load Cases and Analyses ....................................................................................................... 46
1.39. Two Analyses Share the Same ACP (Pre) Setup ..................................................................................... 47
1.40. Import Volume Mesh from Mechanical Model (E4 to C5) ...................................................................... 48
1.41. Import Volume Mesh from Third Party Application ............................................................................... 48
1.42. A Multi-System Analysis in Workbench ................................................................................................ 49
1.43. Write Input File ................................................................................................................................... 55
1.44. Import Ansys Model Using the Context Menu ...................................................................................... 55
1.45. Switch Between ACP Pre and Post ....................................................................................................... 56
2.1. Model Context Menu in Workbench Mode ............................................................................................. 58
2.2. Model Context Menu in Stand-Alone Mode ........................................................................................... 58
2.3. General Model Properties ...................................................................................................................... 60
2.4. Model Statistics .................................................................................................................................... 60

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xv
ACP User's Guide

2.5. Solver Information (Solve.out) ............................................................................................................... 63

2.6. Export Composite Definitions Window .................................................................................................. 63
2.7. Import Composite Definitions Window .................................................................................................. 63
2.8. Element-based vs. Node-based Piercing ................................................................................................ 65
2.9. Ply Extension and Element-wise Thicknesses of a Tapered Ply with Element-based (left) and Node-based
(right) Thicknesses ...................................................................................................................................... 65
2.10. Restriction for Node-based Thicknesses ............................................................................................... 66
2.11. Extrusion of a Tapered Ply without and with Node-based Thicknesses on the Left and Right, Respect-
ively ........................................................................................................................................................... 66
2.12. Solid Model Extrusion of a Tapered Ply without and with Node-based Thicknesses ............................... 67
2.13. Cut-Off Selection Rule with Ply Tapering Based on Element-based and Node-based Thicknesses ........... 67
2.14. Materials Class Context Menu in Stand Alone Mode ............................................................................. 71
2.15. Example of Woven Material with a 45° Fabric Fiber Angle ..................................................................... 75
2.16. Fabric Properties - General .................................................................................................................. 81
2.17. Fabric Properties - Analysis .................................................................................................................. 82
2.18. Fabric Properties - Solid Model Options ............................................................................................... 83
2.19. Fabric Properties - Draping .................................................................................................................. 84
2.20. Stackup Properties - General ............................................................................................................... 85
2.21. Stackup Sequence with Even Symmetry .............................................................................................. 86
2.22. Stackup Sequence with Odd Symmetry ............................................................................................... 87
2.23. Lay-Up Information and Polar Properties ............................................................................................. 88
2.24. CLT Analysis - Laminate Engineering Constants .................................................................................... 89
2.25. Sub Laminate Properties - General Tab ................................................................................................ 90
2.26. Element Set Selection ......................................................................................................................... 91
2.27. Element Set Context Menu .................................................................................................................. 92
2.28. Edge Set Definition ............................................................................................................................. 93
2.29. Example of three Cut-Off geometries ................................................................................................... 94
2.30. CAD Geometry Assembly and Virtual Geometries in the Tree View ....................................................... 94
2.31. Example of Multiple Virtual Geometries ............................................................................................... 96
2.32. Property Dialog CAD Geometry ........................................................................................................... 96
2.33. Project Schematic with a CAD Geometry Import in ACP ....................................................................... 97
2.34. Create Virtual Geometry Directly from CAD Geometry Part .................................................................. 98
2.35. Create Virtual Geometry Through CAD Geometry Parts in Tree ............................................................. 98
2.36. Create Virtual Geometry Through Face Selection in the Scene .............................................................. 99
2.37. Rosette Properties Dialog .................................................................................................................. 100
2.38. Oriented Selection Set with a Radial Rosette. ..................................................................................... 101
2.39. Oriented Selection Set with a Cylindrical Rosette ............................................................................... 101
2.40. Oriented Selection Set with a Spherical Rosette ................................................................................. 102
2.41. Edge Wise Rosette ............................................................................................................................. 102
2.42. Schematic of 1-D Look-Up Table Function ......................................................................................... 108
2.43. Look-Up Table Values ........................................................................................................................ 109
2.44. Interpolated Values with Weighted Nearest Neighbor, Nearest Neighbor, and Linear Multivariate (From
Left to Right) ............................................................................................................................................. 109
2.45. Look-Up Table Interpolation Parameters ............................................................................................ 110
2.46. Setting the Dimension in the Column Properties Dialog ..................................................................... 111
2.47. Selection Rules Context Menu ........................................................................................................... 111
2.48. Definition of a Parallel Selection Rule ................................................................................................. 112
2.49. Example of a Parallel Selection Rule ................................................................................................... 113
2.50. Example of a tube rule with an outer and inner radius ........................................................................ 114
2.51. Tube Selection Rule Properties .......................................................................................................... 115
2.52. Edge with a long extension at the head of the edge and a short one at the tail ................................... 116

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xvi of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

2.53. Cut-Off Selection Rule Properties ....................................................................................................... 117

2.54. Trailing Edge with Cut-Off Plies (Ply Tapering Activated) ..................................................................... 118
2.55. Section of the Cut-Off Geometry ....................................................................................................... 118
2.56. Core Thickness Without Ply Tapering (Left) and With Ply Tapering (Right) ............................................ 119
2.57. Taper Cut-Off Selection Rule Definition .............................................................................................. 120
2.58. Section with The Production Ply Option ............................................................................................. 120
2.59. Section with the Analysis Ply Option .................................................................................................. 121
2.60. Section with the Analysis Ply with Tapering Option ............................................................................ 121
2.61. Example Geometrical Selection Rule .................................................................................................. 122
2.62. Geometrical Selection Rule Properties ............................................................................................... 122
2.63. Capture Tolerances ............................................................................................................................ 124
2.64. Look-Up Table Defines the Offset to Edge Set at a Given Length ......................................................... 125
2.65. Offset Correction ............................................................................................................................... 126
2.66. Offset Mapping Along a Direction Vector ........................................................................................... 126
2.67. Boolean Selection Rule ...................................................................................................................... 127
2.68. Boolean Operation Types .................................................................................................................. 127
2.69. Orientation Point Definition .............................................................................................................. 128
2.70. Definition ......................................................................................................................................... 129
2.71. Reference Direction of a Bonding Laminate Defined by Two Rosettes and a Minimum Angle Selection
Method .................................................................................................................................................... 131
2.72. Selection Rules .................................................................................................................................. 132
2.73. Draping ............................................................................................................................................ 132
2.74. Object Tree of a Lay-Up Definition ..................................................................................................... 134
2.75. Context Menu of Modeling Groups .................................................................................................... 135
2.76. General Information .......................................................................................................................... 136
2.77. Internal Draping Definition ................................................................................................................ 138
2.78. Draping with Tabular Values Definition .............................................................................................. 139
2.79. Thickness Definition .......................................................................................................................... 140
2.80. Thickness Definition Options ............................................................................................................. 141
2.81. Core Geometry ................................................................................................................................. 141
2.82. Resulting Section Cut ........................................................................................................................ 142
2.83. Edge Tapering ................................................................................................................................... 143
2.84. Taper Edge Example .......................................................................................................................... 143
2.85. Right-Click Modeling Ply Menu .......................................................................................................... 144
2.86. Interface Layer Properties - General ................................................................................................... 145
2.87. Interface Layer Properties - Open Area ............................................................................................... 146
2.88. Drop-Off Elements and a Butt Joint Between Two Cores ..................................................................... 146
2.89. Production Ply Context Menu ............................................................................................................ 149
2.90. Analysis Ply Context Menu ................................................................................................................ 150
2.91. CSV Import with Update Options ....................................................................................................... 151
2.92. Export Ply Geometry Window ............................................................................................................ 152
2.93. General Properties Options ............................................................................................................... 155
2.94. Draping Properties Options ............................................................................................................... 156
2.95. Thickness Properties Options ............................................................................................................ 157
2.96. Imported Production Ply Dialog ........................................................................................................ 158
2.97. Imported Analysis Ply ........................................................................................................................ 158
2.98. Field Definitions Context Menu ......................................................................................................... 159
2.99. Field Definition Context Menu ........................................................................................................... 160
2.100. Field Definition Object Properties .................................................................................................... 161
2.101. Sampling Point Properties - General Tab .......................................................................................... 162
2.102. Lay-Up Sequence and Enhanced Postprocessing .............................................................................. 163

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xvii
ACP User's Guide

2.103. General Section Cut Properties ........................................................................................................ 164

2.104. Wire Frame Options ......................................................................................................................... 165
2.105. Surface Options .............................................................................................................................. 166
2.106. Section Cut Crossing an Element Corner .......................................................................................... 166
2.107. Element Normals ............................................................................................................................. 167
2.108. Surface Normal vs. Surface Sweep Based Extrusion ........................................................................... 168
2.109. Ply-Wise Angles on the Surface Section Cut ..................................................................................... 168
2.110. Supported Lay-up for T-Joints .......................................................................................................... 169
2.111. Export Surface Section Cut Options ................................................................................................. 169
2.112. Sensor Properties ............................................................................................................................ 170
2.113. Solid Model Folder with a Standard Solid Model and an Imported Solid Model ................................. 171
2.114. Solid Model Feature in the Tree View ................................................................................................ 172
2.115. Solid Model Properties - General ...................................................................................................... 173
2.116. Illustration of Solid Model Extrusion Methods .................................................................................. 175
2.117. Extrusion Direction .......................................................................................................................... 175
2.118. Offset Direction ............................................................................................................................... 175
2.119. Solid Model Properties - Drop-Offs ................................................................................................... 177
2.120. Disable Drop-Offs ............................................................................................................................ 178
2.121. Connect Butt-Jointed Plies .............................................................................................................. 178
2.122. Solid Model Properties - Export ....................................................................................................... 179
2.123. Write Degenerated Elements ........................................................................................................... 179
2.124. Quadratic Tetrahedral Element on Top of a Hexahedral Element ....................................................... 180
2.125. Transferred Element Sets in Mechanical ........................................................................................... 181
2.126. Properties of the ACP-Pre Setup Cell in the Project Schematic .......................................................... 182
2.127. Extrusion with and without an Edge Set Guide ................................................................................. 183
2.128. Extrusion Guide Properties .............................................................................................................. 184
2.129. Reordering Extrusion Guides ........................................................................................................... 185
2.130. Mesh Morphing Diagram ................................................................................................................. 186
2.131. Example of a Direction-type Extrusion Guide with Different Mesh Morphing Radii ............................ 187
2.132. Example of a Geometry-type Extrusion Guide with Different Mesh Morphing Depths. ...................... 188
2.133. Extrusion without Snap Operation ................................................................................................... 189
2.134. Extrusion with Snap-To Geometry at the Top (Shell Geometry also Displayed) .................................. 190
2.135. Extrusion with Snap-To Geometry at the Top and Bottom (Shell Geometry also Displayed) ................ 190
2.136. Extruded Solid Model ...................................................................................................................... 191
2.137. Cut-Off Geometries Shown Alongside Extruded Solid Model ............................................................ 191
2.138. Solid Model with Cut-Off Features ................................................................................................... 191
2.139. Cut-Off Geometry Normal Direction ................................................................................................ 192
2.140. Example of three Cut-Off geometries ............................................................................................... 193
2.141. A Degenerated Hexahedral Element (left) is Decomposed into Several Tetrahedral Elements (right) ... 193
2.142. Solid Model with Highlighted Drop-Off elements ............................................................................. 195
2.143. Tree Object of the Imported Solid Model Feature ............................................................................. 196
2.144. Transfer of Mesh Components from an External Mesh via External Model, Mechanical to ACP Pre ...... 200
2.145. Element Normals of the Filler Elements Computed from Two Rosettes. ............................................. 205
2.146. Thickness Plot ................................................................................................................................. 214
2.147. Angle Plot ....................................................................................................................................... 215
2.148. Draping Mesh Plot Properties .......................................................................................................... 216
2.149. Draping Mesh ................................................................................................................................. 216
2.150. Draping Plot for a Hemisphere ......................................................................................................... 217
2.151. Flatwrap Surface of the Ply .............................................................................................................. 217
2.152. Look-Up Table Plot General Properties Tab ....................................................................................... 218
2.153. Look-Up Table Plot of a 1-D Scalar Quantity with Supporting Points Shown as Circles ........................ 219

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xviii of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

2.154. Lay-Up Mapping General Properties Tab .......................................................................................... 220

2.155. Deviation of the Normal Direction between Shell Elements and Layered Solid Elements ................... 220
2.156. Failure Criteria Definition ................................................................................................................. 221
2.157. Puck Failure Criteria Configuration ................................................................................................... 222
2.158. Solutions Object in the Tree View ..................................................................................................... 223
2.159. Solution Properties Window Showing Several Solution Sets in the Data tab ...................................... 224
2.160. Comparison of Imported and Recomputed Interlaminar Stresses ...................................................... 226
2.161. Envelope Solution Properties ........................................................................................................... 226
2.162. Scene with Failure Mode Plot Activated ........................................................................................... 232
2.163. Material Plot General Properties Tab ................................................................................................ 234
2.164. Script Field in the User-Defined Plot Properties ................................................................................ 235
2.165. Scene Properties ............................................................................................................................. 244
2.166. Connection of ACP and Workbench Parameter Interface .................................................................. 252
2.167. Parameter Properties ....................................................................................................................... 253
2.168. Material Database ........................................................................................................................... 256
2.169. Failure Plot Dialog ........................................................................................................................... 259
2.170. Failure Analysis of a Solid Model. Show on Solids (left) and Show on Shells (right) ............................. 260
2.171. Export and Import Options in Model Context Menu ......................................................................... 265
2.172. HDF5 Composite CAE File Export Settings ........................................................................................ 266
2.173. 3D Representation of a Lay-Up with Offset Ply Surfaces .................................................................... 266
2.174. The External Model Component in Workbench ................................................................................ 267
2.175. HDF5 Composite CAE File Import Settings ....................................................................................... 269
2.176. Schematic of Tolerance Settings for a Single Element ....................................................................... 271
2.177. SHELL181 Keyopts ........................................................................................................................... 272
2.178. SHELL281 Keyopts ........................................................................................................................... 273
2.179. SOLID185 Keyopts ........................................................................................................................... 273
2.180. SOLID186 Keyopts ........................................................................................................................... 273
2.181. Configuration Overview .................................................................................................................. 274
2.182. Configuration Overview .................................................................................................................. 275
2.183. A Four Ply Mechanical APDL Lay-up Where a Ply Crosses the Reference Surface is Converted to a Five
Ply ACP Lay-up .......................................................................................................................................... 276
2.184. ModelingGroup Tabular Format in Excel ........................................................................................... 276
2.185. Look-Up Table Tabular Format in Excel ............................................................................................. 277
3.1. T-Joint Lay-Up ..................................................................................................................................... 282
3.2. OSS for the Base Plate ......................................................................................................................... 282
3.3. OSS for the Stringer ............................................................................................................................. 283
3.4. OSS for Bonding Plies .......................................................................................................................... 283
3.5. Reference Direction ............................................................................................................................ 284
3.6. Laminate of the Base Plate .................................................................................................................. 285
3.7. Laminate of the Base Plate and Stringer ............................................................................................... 285
3.8. First Bonding Laminate ....................................................................................................................... 286
3.9. Second Bonding Laminate .................................................................................................................. 286
3.10. Cover Plies ........................................................................................................................................ 287
3.11. Tube Selection Rule ........................................................................................................................... 288
3.12. Rules Tab of the Modeling Ply Property Dialog ................................................................................... 288
3.13. Resulting Local Reinforcements ......................................................................................................... 289
3.14. Simple Edge Tapering ........................................................................................................................ 290
3.15. Tapered Edge .................................................................................................................................... 290
3.16. Tapering in Ply Definition .................................................................................................................. 291
3.17.Thickness Distribution After Core Tapering ......................................................................................... 291

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xix
ACP User's Guide

3.18. Superposition of Modeling Plies with Identical Taper Angles. Schematic (Middle) and Section View Illus-
tration (Right) ........................................................................................................................................... 292
3.19. Thickness Distribution of a Laminate with a Cutoff Selection Rule ....................................................... 293
3.20. Template Selection Rule Definition .................................................................................................... 293
3.21. Imported Core Geometry .................................................................................................................. 294
3.22. Modeling Ply Thickness Definition ..................................................................................................... 295
3.23. Section with Variable Core Thickness ................................................................................................. 295
3.24. Table Definition ................................................................................................................................. 296
3.25. Thickness Definition Through Tabular Values ...................................................................................... 296
3.26. Section Cut and Thickness Contour Plot ............................................................................................. 297
3.27. Imported Cut-Off Geometry .............................................................................................................. 297
3.28. Resulting Thickness Distribution (Ply Tapering Activated) ................................................................... 298
3.29. Flatwrap (Boundary) .......................................................................................................................... 299
3.30. Draping Mesh with Shear Energy ....................................................................................................... 300
3.31. Draping Definition in OSS .................................................................................................................. 301
3.32. Tabular Values Definition of Draping .................................................................................................. 302
3.33. Fiber and Draped Fiber Directions ..................................................................................................... 303
3.34. Analyzing a Solid Model Alongside a Shell Model ............................................................................... 306
3.35. Solid Model Assembly Workflow ........................................................................................................ 307
3.36. Conversion of the Named Selections in the Solid Model Workflow ...................................................... 308
3.37. A quadrilateral interface element surrounded by a brick element and two tetrahedral elements created
when the Drop-Off is split ......................................................................................................................... 310
3.38. T-Joint Section Cut ............................................................................................................................ 311
3.39. Class40 Section Cut ........................................................................................................................... 311
3.40. Activate Deformed Geometry in the Solution Properties Visualizations ............................................... 312
3.41. Activate the Deformation Plot for Total Deformation .......................................................................... 312
3.42. Activate the Failure Criteria Plot with Failure Mode and Critical Ply Information .................................. 313
3.43. IRF Value and Text Plot for Each Element (Tutorial 1) ........................................................................... 313
3.44. Zoom on Critical Area (Class 40) ......................................................................................................... 314
3.45. Activate the Ply-Wise Results in the Plot Properties ............................................................................ 315
3.46. Select an Analysis Ply in the Modeling Groups or Sampling Points ...................................................... 315
3.47. Ply-Wise Stress (Tutorial 1) ................................................................................................................. 316
3.48. Stress Analysis for Selected Sampling Point ........................................................................................ 317
3.49. Field Definition Properties to Set Up a Degradation Factor Field ......................................................... 321
4.1. ACP Components ................................................................................................................................ 325
4.2. Engineering Data Sources ................................................................................................................... 325
4.3. Outline of Composite Materials ........................................................................................................... 326
4.4. Material Properties for ACP .................................................................................................................. 327
4.5. Context Menu of ACP (Pre) Setup ........................................................................................................ 329
4.6. Connecting a Static Structural Analysis to ACP (Pre) using a Drag and Drop Operation .......................... 330
4.7. Adding ACP (Post) by Drag and Drop Operation ................................................................................... 330
4.8. Linking a Solution with ACP (Post) ....................................................................................................... 331
4.9. Complete Composite Shell Analysis Model .......................................................................................... 331
4.10. Conversion of the Named Selections in the Solid Model Workflow ...................................................... 333
4.11. Workbench Workflow for Composite Solid Modeling with Mechanical ................................................ 334
4.12. Workbench Workflow for Composite Solid Modeling with Mechanical APDL ....................................... 334
4.13. Analysis of a Composite Tube with Metal Inserts Modeled with Mechanical ........................................ 335
4.14. Suppressed Shell in Mechanical Model .............................................................................................. 335
4.15. Assembly of Composite and Metal Solids ........................................................................................... 336
4.16. Analysis of Composite Plate and T-joint Modeled with Mechanical APDL ............................................ 336
4.17. Add Reference File ............................................................................................................................ 337

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xx of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP User's Guide

4.18. List of Used Files and Their Order in Mechanical APDL ........................................................................ 337
4.19. Step 1: Drag and Drop an ACP (Post) System on to an ACP (Pre) System .............................................. 338
4.20. Step 2: Drag and Drop the Static Structural Solution Cell into the ACP (Post) Results Cell ..................... 339
4.21. Race Car Workbench Setup ................................................................................................................ 340
4.22. Predefined and User-Defined Field Variables in Engineering Data ....................................................... 341
4.23. Assigning a Field Variable to Material Property ................................................................................... 341
4.24. Populating the Tabular Material using the CSV Interface ..................................................................... 342
4.25. Setting Interpolation Options ............................................................................................................ 342
4.26. Draping Results ................................................................................................................................. 343
4.27. Distribution of the Curing Degree (Scalar Look-Up Table Plot) ............................................................ 344
4.28. Activating a Look-Up Table to Define Curing per Modeling Ply (Layer-Wise) ........................................ 344
4.29. Using External Data to Define Temperature Field ................................................................................ 345
4.30. Inverse Reserve Factor (Constant Material Data on the Left; Variable Material Properties on the
Right) ....................................................................................................................................................... 346
4.31. Geometry and Lay-Up of the Composite Spring ................................................................................. 347
4.32. Complete Workbench Project Schematic ........................................................................................... 348
4.33. Mechanical Model F4 with the Bodies Roving and Tube ..................................................................... 349
4.34. Detail View of the Final Solid Mesh with Hex Elements only in the Outer Body .................................... 350
4.35. Mesh Features and Solid Mesh with the Inflation Layers and Roving Cross Section .............................. 350
4.36. Imported Solid Model Properties Dialog ............................................................................................ 351
4.37. Figure: Lay-up Mapping Definition of the Mesh Component Tube ...................................................... 352
4.38. The Filler Options for the Roving ........................................................................................................ 353
4.39. Filler Elements and Fiber Directions ................................................................................................... 354
4.40. Using the Filler Option for the Roving ................................................................................................... 355
4.41. Ply-wise failure analysis ..................................................................................................................... 356
4.42. Workbench Project Setup .................................................................................................................. 356
4.43. Woven RVE defined in Material Designer ............................................................................................ 357
4.44. Materials in the Engineering Data Component of the ACP system ...................................................... 357
4.45. Shear Dependent Fabric Fiber Angle .................................................................................................. 357
4.46. Ply Definition .................................................................................................................................... 358
4.47. Fiber (Light Green), Transverse (Dark Green) and Material 1 (Red) Directions ....................................... 358
4.48. Draping Definition ............................................................................................................................ 359
4.49. ACP Draping Mesh ............................................................................................................................ 359
4.50. Shear Angle Plot ............................................................................................................................... 360
4.51. Draped Fiber Direction (Light Blue), Draped Transverse Direction (Blue) and Material 1 Direction
(Red) ........................................................................................................................................................ 360
4.52. Shear-Dependent Young's Modulus ................................................................................................... 361
4.53. Deformation Plot (variable material on left, constant material on right) ............................................... 361
4.54. 3D Ply Workflow (Courtesy of 9T Labs) ............................................................................................... 362
4.55. HDF5 Composite CAE Imported as 3D Plies (Imported Modeling Plies) ............................................... 363
4.56. 3D Printing with Endless Fiber Reinforcement and Final Part (Courtesy of 9T Labs) .................... 363
4.57. Simulation of a 3D Printed Composite (Courtesy of 9T Labs) ............................................................... 364
4.58. Distribution of the Inverse Reserve Factors in the Mapped Composite Solid Model ............................. 365
4.59.The Drag-and-Drop Workflow Showing the Transfer of ACP Composite Models to a Workbench LS-DYNA
Analysis System ........................................................................................................................................ 366
4.60. Setting up an Automatic Conversion of LS-DYNA Material Models ...................................................... 367
4.61. Material Definition for LS-DYNA in Engineering Data .......................................................................... 368
4.62. Geometry Preparation in SpaceClaim ................................................................................................ 368
4.63. Mechanical Model - Assigning Part Properties to the Bird Body .......................................................... 369
4.64. Defining Materials in ACP .................................................................................................................. 370
4.65. Composite Lay-Up Modeling in ACP .................................................................................................. 370

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xxi
ACP User's Guide

4.66. : Setting Up the Analysis .................................................................................................................... 371

4.67. Accessing Input Files and Results Files ............................................................................................... 372
5.1. Draping Scheme ................................................................................................................................ 374
5.2. Angle Notation for the Draping Energy Algorithm ............................................................................... 375
5.3. Deformation of the Draping Unit Cell .................................................................................................. 375
5.4. Doubly Curved FE Geometry ............................................................................................................... 378
5.5. Integration Scheme ............................................................................................................................ 380
5.6. Fracture Curve in σ2, τ21 Space for σ1 = 0 .............................................................................................. 390
5.7. UD Failure Modes ................................................................................................................................ 400
5.8. Relation Between ABD Matrix and the Coupling Between Laminate Forces and Deformations .............. 410
5.9. Laminate Properties with Out-of-Plane Shear Stiffness and Shear Correction Factors ............................ 412
5.10. Linear Multivariate Algorithm ............................................................................................................ 416

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xxii of ANSYS, Inc. and its subsidiaries and affiliates.
List of Tables
1.1. Predefined Unit Systems ....................................................................................................................... 19
2.1. Key Differences Between a Modeling Ply and Imported Modeling Ply ................................................... 154

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. xxiii
 Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
xxiv of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: Getting Started
The following sections describe how to begin using Ansys Composite PrepPost (ACP):
1.1. Overview
1.2.The Ansys Product Improvement Program
1.3. Graphical User Interface
1.4. Implementation in Workbench
1.5. Migrating ACP Projects from Previous Versions
1.6. Stand Alone Operation
1.7.Tutorials and Examples

1.1. Overview
The following sections provide an overview of Ansys Composite PrepPost (ACP).
1.1.1. Introduction
1.1.2. Supported Platforms and Functional Add-ons
1.1.3. Known Limitations
1.1.4. First Steps

1.1.1. Introduction
Composite materials are created by combining two or more layered materials, each with different
properties. These materials have become a standard for products that are both light and strong.
Composites provide enough flexibility so products with complex shapes, such as boat hulls and
surfboards, can be easily manufactured.

Engineering layered composites involves complex definitions that include numerous layers, materials,
thicknesses and orientations. The engineering challenge is to predict how well the finished product
will perform under real-world working conditions. This involves considering stresses and deformations
as well as a range of failure criteria. Ansys Composite PrepPost provides all necessary functionalities
for the analysis of layered composite structures.

ACP Workflows
Ansys Composite PrepPost (ACP) is an add-in to Ansys Workbench and is integrated with the standard
analysis features. As a result, the entire workflow for a composite structure can be completed from
design to final production information.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Getting Started

The geometry of the tooling surfaces of a composite structure is the basis for analysis and production.
Based on this geometry and a FE mesh, the boundary conditions and composite definitions are applied
to the structure in the pre-processing stage. After a completed solution, the post-processing is used
to evaluate the performance of the design and laminate. In the case of an insufficient design or ma-
terial failure, the geometry or laminate has to be modified and the evaluation is repeated.

ACP has a pre- and post-processing mode. In the pre-processing mode, all composite definitions can
be created and are mapped to the geometry (FE mesh). These composite definitions are transferred
to the FE model and the solver input file. In the post-processing mode, after a completed solution
and the import of the result file(s), post-processing results (failure, safety, strains and stresses) can be
evaluated and visualized.

1.1.2. Supported Platforms and Functional Add-ons

Supported Platforms
ACP is supported on both Windows and Linux systems. For information about specific operating
system versions and distributions, see the Platform Support section of the Ansys Website.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
 Overview

ACP has additional library dependencies in Red Hat Enterprise Linux, for information on how to install
those libraries, see Post-Installation Procedures for Other Products in the Ansys, Inc. Linux Installation
Guide.

Functional Add-ons
ACP provides functional add-ons for problem-specific functionality. These add-ons are not considered
appropriate for general use and should be used with caution. No standard documentation is provided
for these features, but additional information is available on request. For more information, please
contact [email protected].

For information on how to activate these add-ons, see Add Ons (p. 16).

1.1.3. Known Limitations

ACP has the following known limitations. Note that feature-specific limitations are often documented
with the corresponding feature description throughout the ACP user's guide.

Unicode
ACP does not support Unicode characters.

Composite Failure Tool For Migrated ACP Projects

The Composite Failure Tool in Mechanical can only be used in migrated projects once the ACP-Pre
SetupWorkbench cell has been updated.

Coordinate System Naming For Migrated ACP Projects

In Version 2019 R2, naming is maintained when coordinate systems defined in Workbench are trans-
ferred to ACP as Rosettes. (See Rosettes (p. 99).) When migrating projects from previous versions, the
Oriented Selection Set Properties may lose the Rosette link due to the renaming. This will require lay-
up definitions to be updated manually as shown in Figure 1.1: Oriented Selection Set Properties (p. 4).
For more information on migrating projects from previous versions, see Migrating ACP Projects from
Previous Versions (p. 52).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
Getting Started

Figure 1.1: Oriented Selection Set Properties

Export System(s) and Import to Workbench

The Export System(s) and Import of Workbench projects are not supported for ACP Systems. With
this current limitation, the imported ACP systems cannot be updated correctly after import.

Parameters
In ACP, Parameters, and how they are handled by the Parameter Manager, have certain limitations.
See the Parameters (p. 252) section for additional information.

Options for Objects with the Same Name

The application allows you to create objects with the same name. However, there are certain property
specification and graphical selection limitations for this scenario. Based on the object type, you may
not be able to define the properties to include objects with the same name. For example, you cannot
define Sub Laminates using a Fabric and Stackup that have the same name.

1.1.4. First Steps

The best way to get to know the features of ACP is to attempt one of the tutorials. There are two
tutorials that explain step-by-step how to define and analyze basic composite structures. The tutorials
both start off with existing Workbench projects. These sample projects and more information can be
found in the ACP Tutorials. Knowledge of Ansys Workbench is a prerequisite.

For information on how to build a composite model from new, see Analysis of a Composite Shell
Model (p. 323).

There are many ways to implement ACP in Workbench. The workflow for modeling composite solid
element models is described in Analysis of a Composite Shell Model (p. 323). Other examples are
shown in Implementation in Workbench (p. 37).

Composite Modeling Techniques (p. 281) offers an insight into modeling approaches for common
composite problems.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
 The Ansys Product Improvement Program

Explanations and specific information of the ACP features can be found in Features (p. 57).

Background information on the underlying theory used in ACP is available in Theory Documenta-
tion (p. 373). This is especially of interest for the failure criteria.

1.2. The Ansys Product Improvement Program

This product is covered by the Ansys Product Improvement Program, which enables Ansys, Inc., to collect
and analyze anonymous usage data reported by our software without affecting your work or product
performance. Analyzing product usage data helps us to understand customer usage trends and patterns,
interests, and quality or performance issues. The data enable us to develop or enhance product features
that better address your needs.

How to Participate
The program is voluntary. To participate, select Yes when the Product Improvement Program dialog
appears. Only then will collection of data for this product begin.

How the Program Works

After you agree to participate, the product collects anonymous usage data during each session. When
you end the session, the collected data is sent to a secure server accessible only to authorized Ansys
employees. After Ansys receives the data, various statistical measures such as distributions, counts,
means, medians, modes, etc., are used to understand and analyze the data.

Data We Collect
The data we collect under the Ansys Product Improvement Program are limited. The types and amounts
of collected data vary from product to product. Typically, the data fall into the categories listed here:

Hardware: Information about the hardware on which the product is running, such as the:

• brand and type of CPU

• number of processors available

• amount of memory available

• brand and type of graphics card

System: Configuration information about the system the product is running on, such as the:

• operating system and version

• country code

• time zone

• language used

• values of environment variables used by the product

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
Getting Started

Session: Characteristics of the session, such as the:

• interactive or batch setting

• time duration

• total CPU time used

• product license and license settings being used

• product version and build identifiers

• command line options used

• number of processors used

• amount of memory used

• errors and warnings issued

Session Actions: Counts of certain user actions during a session, such as the number of:

• project saves

• restarts

• meshing, solving, postprocessing, etc., actions

• times the Help system is used

• times wizards are used

• toolbar selections

Model: Statistics of the model used in the simulation, such as the:

• number and types of entities used, such as nodes, elements, cells, surfaces, primitives, etc.

• number of material types, loading types, boundary conditions, species, etc.

• number and types of coordinate systems used

• system of units used

• dimensionality (1-D, 2-D, 3-D)

Analysis: Characteristics of the analysis, such as the:

• physics types used

• linear and nonlinear behaviors

• time and frequency domains (static, steady-state, transient, modal, harmonic, etc.)

• analysis options used

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
 The Ansys Product Improvement Program

Solution: Characteristics of the solution performed, including:

• the choice of solvers and solver options

• the solution controls used, such as convergence criteria, precision settings, and tuning options

• solver statistics such as the number of equations, number of load steps, number of design points,
etc.

Specialty: Special options or features used, such as:

• user-provided plug-ins and routines

• coupling of analyses with other Ansys products

Data We Do Not Collect

The Product Improvement Program does not collect any information that can identify you personally,
your company, or your intellectual property. This includes, but is not limited to:

• names, addresses, or usernames

• file names, part names, or other user-supplied labels

• geometry- or design-specific inputs, such as coordinate values or locations, thicknesses, or other

dimensional values

• actual values of material properties, loadings, or any other real-valued user-supplied data

In addition to collecting only anonymous data, we make no record of where we collect data from. We
therefore cannot associate collected data with any specific customer, company, or location.

Opting Out of the Program

You may stop your participation in the program any time you wish. To do so, select Ansys Product
Improvement Program from the Help menu. A dialog appears and asks if you want to continue parti-
cipating in the program. Select No and then click OK. Data will no longer be collected or sent.

The Ansys, Inc., Privacy Policy

All Ansys products are covered by the Ansys, Inc., Privacy Policy.

Frequently Asked Questions

1. Am I required to participate in this program?

No, your participation is voluntary. We encourage you to participate, however, as it helps us create
products that will better meet your future needs.

2. Am I automatically enrolled in this program?

No. You are not enrolled unless you explicitly agree to participate.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
Getting Started

3. Does participating in this program put my intellectual property at risk of being collected or discovered
by Ansys?

No. We do not collect any project-specific, company-specific, or model-specific information.

4. Can I stop participating even after I agree to participate?

Yes, you can stop participating at any time. To do so, select Ansys Product Improvement Program
from the Help menu. A dialog appears and asks if you want to continue participating in the program.
Select No and then click OK. Data will no longer be collected or sent.

5. Will participation in the program slow the performance of the product?

No, the data collection does not affect the product performance in any significant way. The amount
of data collected is very small.

6. How frequently is data collected and sent to Ansys servers?

The data is collected during each use session of the product. The collected data is sent to a secure
server once per session, when you exit the product.

7. Is this program available in all Ansys products?

Not at this time, although we are adding it to more of our products at each release. The program
is available in a product only if this Ansys Product Improvement Program description appears in the
product documentation, as it does here for this product.

8. If I enroll in the program for this product, am I automatically enrolled in the program for the other Ansys
products I use on the same machine?

Yes. Your enrollment choice applies to all Ansys products you use on the same machine. Similarly,
if you end your enrollment in the program for one product, you end your enrollment for all Ansys
products on that machine.

9. How is enrollment in the Product Improvement Program determined if I use Ansys products in a cluster?

In a cluster configuration, the Product Improvement Program enrollment is determined by the host
machine setting.

10. Can I easily opt out of the Product Improvement Program for all clients in my network installation?

Yes. Perform the following steps on the file server:

a. Navigate to the installation directory: [Drive:]\v241\commonfiles\globalsettings

b. Open the file ANSYSProductImprovementProgram.txt.

c. Change the value from "on" to "off" and save the file.

Additional Notes specific to ACP

If you run ACP in standalone mode, you can opt out or in under Tools > Preferences > ACP > Ansys
Product Improvement Program.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

1.3. Graphical User Interface

The user interface is split into the following parts:
1.3.1. Menus
1.3.2.Tree View
1.3.3. Scene
1.3.4.Toolbar
1.3.5. View Panes
1.3.6. Keyboard Shortcuts

The interface also contains View Panes (p. 32) that show how individual elements within the ACP interface
can be rearranged.

Figure 1.2: Ansys Composite PrepPost GUI

1.3.1. Menus
ACP (Pre) provides the following menu options:
1.3.1.1. File
1.3.1.2. View
1.3.1.3.Tools

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
Getting Started

Figure 1.3: Ansys Composite PrepPost Menu Options

1.3.1.1. File
The File menu differs between Workbench and Stand Alone mode.
1.3.1.1.1. Workbench
1.3.1.1.2. Stand Alone

1.3.1.1.1. Workbench
When you launch ACP (Pre) from Workbench, the File menu contains the following options:

Save Project: If the project was not already saved, specify the project name and location.
Saves the entire Workbench project.
Refresh All Data: Reloads the model in ACP. If the model is not up-to-date in the
Workbench schematic, changes on the model (mesh, Named Selections) are not transferred
to ACP. If you have made changes to the model, close ACP and update the model in
Workbench.
Run Script: Select a Python script to execute.
Exit: Exit from Ansys Composite PrepPost. Any newly defined ACP features are not deleted.

Figure 1.4: File Menu for Workbench Integration

1.3.1.1.2. Stand Alone

When you open the application in stand alone mode (via the Start menu), the File menu contains
the following options:

Open: Open an existing database.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Save: Save the active database.

Save As: Save the active database, select location and file name.
Save All: Save all open databases.
Close: Close the active database.
Close All: Close all open databases.
Import Model: Import an Ansys model.
Run Script: Select a Python script to execute.
Exit: Exit from Ansys Composite PrepPost. Any newly defined ACP Features are not de-
leted.

Figure 1.5: Stand Alone File Menu

1.3.1.2. View
The layout of the GUI is managed through the View menu.
1.3.1.2.1. Perspectives
1.3.1.2.2. View Manager

Figure 1.6: View Menu

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
Getting Started

1.3.1.2.1. Perspectives
The Perspectives submenu allows you to manage different interface layouts:

Perspective: Activate a named Perspective. Available perspectives appear in a list in the

drop-down menu.
New Perspective: Create a new Perspective.
Save Perspective As: Save the current interface layout into a new Perspective.
Rename Perspective: Modify the name of the active Perspective.
Delete Perspective: Delete the active Perspective.
Reset Perspective: Reset the active Perspective to an empty Perspective.
Reset All Perspectives: Reset all defined Perspectives.

Figure 1.7: Perspective Submenu

1.3.1.2.2. View Manager

Interface elements can be added or removed from a Perspective by clicking Other... to bring up
the View Manager. To activate a View, select it in the View Manager and click OK. The selected
View appears in the View menu for the selected perspective. Views present in the Perspective
can be activated or deactivated through the View menu.

Figure 1.8: Show View

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

1.3.1.3. Tools
You will find the following options in the Tools menu:
1.3.1.3.1. Extract Materials From Composite CAE H5...
1.3.1.3.2. Winding Wizard
1.3.1.3.3. Preferences

Figure 1.9: Tools Menu

1.3.1.3.1. Extract Materials From Composite CAE H5...

This option allows you to extract material data from an HDF5 Composite CAE (p. 264) file for use
in Workbench. Using the dialog box shown below, specify the HDF5 Composite CAE file which
contains the materials data. Then select the folder where you want to save it. ACP saves the
materials in MatML format so it can be imported into Engineering Data in Workbench.

Figure 1.10: Extract Materials From Composite CAE H5... Dialog

1.3.1.3.2. Winding Wizard

The Winding Wizard generates a winding lay-up for an axisymmetric body. The Wizard is useful
for creating a simple lay-up where the paths are geodesic. For more complex winding lay-ups,
consider importing the lay-up from a dedicated winding tool using ACP's feature Import from
HDF5 Composite CAE File … (See HDF5 Composite CAE Format (p. 264).) CADWIND, CADFIL ,and
μWind (Mefex GmbH) are all able to export Composite CAE H5 files and generate machine code.
Below are links to their websites.

• https://www.material.be/cadwind/intro/

• https://www.cadfil.com/

• https://mefex.de/software/wind

The Wizard uses the Origin (a point on the axis of symmetry), the Axial Direction, and the Reference
Radius to automatically generate a winding lay-up for an axisymmetric body. The radius is defined
as the minimal distance from any point on the surface to the axis of symmetry. The Reference

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
Getting Started

Radius is equal to the radius where the layers have the nominal thickness and angle. For a typical
winding body, this is the radius in the cylindrical region.

The thickness correction of each layer is calculated with:

(1.1)

The angle is calculated based on a geodesic path for which is constant:

(1.2)
(1.3)

otherwise with
(1.4)

Each layer has the following properties, which can be defined in the table:

• Fabric: Fabric of the layer (Stackups and Sublaminates are not supported).

• Angle: Nominal angle at Reference Radius with respect to the axis of symmetry (in degrees).

• Ply limits: If "Has limits" is true, the ply ends at the locations defined by the "Upper Limit" and
"Lower Limit" column. The "Upper Limit" and "Lower Limit" values are interpreted as distance
from the origin along the axial_direction.

• Add mirrored ply: If set to True, an additional layer with the same properties but a negative
angle is generated. This implies that the resulting thickness is twice the original thickness of
the layer.

You can also import the layers from a CSV file with the Import from CSV button. Columns are
Fabric Id, Nominal Angle, Has Limits, Lower Limit, Upper Limit, and Add Mirrored Ply. Example
Row:

Fabric.1,30,True,0,1,False

Note:

The reference directions computed by this function are not defined along the axis of
symmetry but along the circumferential direction using a cylindrical Rosette. This allows
you to handle edge cases, such as elements normal to the symmetry plane, with a
single Rosette. As a result, the Ply Angle of the generated plies is rotated by 90° with
respect to the specified nominal angle in the layers list. The resulting fiber direction
still matches the specified nominal angle: A nominal angle of 0° means the fiber direc-
tion is along the Axial Direction.

The Wizard generates the following objects:

• A cylindrical Rosette which defines a reference direction along the circumferential direction of
the axisymmetric body

• An Oriented Selection Set

• A Lookup Table with the thickness corrections and angles

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

• A template Selection Rule if limits are defined

• A Modeling Group with the Plies

Once the lay-up is generated, you can manually adjust it. For example, you can edit the thicknesses
and angles in the Look-up Table or edit the parameters of the Selection Rule.

Figure 1.11: Winding Wizard with the Inputs on Top and the Description at the Bottom

1.3.1.3.3. Preferences
You can configure the following application settings through the Preferences submenu:

• Add Ons (p. 16)

• Ansys Product Improvement Program (p. 16)

• General ACP Preferences (p. 16)

• Logger Settings (p. 17)

• Material Database (p. 17)

• Notifications and Pop-ups (p. 18)

• Scene Preferences (p. 18)

• Section Generation (p. 18)

• Units (p. 19)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
Getting Started

Figure 1.12: Preferences Window

1.3.1.3.3.1. Add Ons

Add-Ons: Activate or deactivate the available add-ons (p. 3).

1.3.1.3.3.2. Ansys Product Improvement Program

Ansys Product Improvement Program: Here you can opt to participate in the Ansys Product
Improvement Program. Refer to the section Ansys Product Improvement Program (p. 5) for
complete information.

The option applies only to workflows in ACP standalone operation. For Workbench workflows,
you must opt into the Ansys Product Improvement Program using the Workbench settings.

1.3.1.3.3.3. General ACP Preferences

In the General heading, the following options are available:

Ansys Executable Path: Path to the ansys.exe file (solver). If empty, ACP uses the
default path from the installation.
Ansys License: Defines which license will be used to solve the model. For more inform-
ation on licenses, see Product to License Feature Mapping in the Ansys, Inc. License
Management Guide. The Feature Name (from the Ansys Product to License Feature
Mapping Table) should be typed in this field. For example, enter struct for an Ansys
Mechanical Enterprise Solver. By default, the Ansys License field is empty, in which
case ACP uses the order of licenses defined in the LM Center.
Number of Threads to Use in Parallel: Specifies the number of cores/threads used
for computation. ACP uses all available cores when the option is zero (default).
H5 Compression Level: Specify the GZip compression level of HDF5 (storage format
of ACP). The default setting is 2. This setting provides good compression at an overhead
of about 35% when compared to no compression (setting of 0). The highest available
setting is 9. Note that processing requirements increase based on this setting. You will

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

notice an increase in processing times with a setting of 4 and above. You need to
evaluate the benefits of increased processing time versus file size reduction.

Figure 1.13: General ACP Preferences

1.3.1.3.3.4. Logger Settings

Use the Logger Settings dropdown menu to set the severity level of messages displayed in
the Log Window. The levels are:

Debug: Log everything, including debugging information.

Info (default): Log everything, except debugging information.
Warning: Log errors and warnings.
Error: Log errors only.
Critical: Not used.

Number of Days to Keep Log Files: Specify how long the ACP log files are retained. By default,
ACP deletes files older than seven days. Note that keeping a large number of log files slows
down the ACP startup.

Figure 1.14: Logger Preferences

1.3.1.3.3.5. Material Database

Material Database: Define the path to the material database (.acpMdb file). See Material
Database (p. 255).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
Getting Started

1.3.1.3.3.6. Notifications and Pop-ups

Notifications and Pop-ups: Enable or disable notifications and confirmation dialogs.

1.3.1.3.3.7. Scene Preferences

In the Scene heading, some graphical properties of the model display can be modified. These
properties are grouped in three parts:

Figure 1.15: Scene Preferences

• Appearance: Background color of the Scene window can be defined as uniform or as a

gradient from bottom to top. To obtain a uniform background, Background Color and
Background Color 2 should have the same color definition. When defining a top to bottom
gradient, Background Color is the bottom color and Background Color 2 is the top color.
To modify these colors click Edit.

• Screenshot: By default, the size of the image captured by the Snapshot utility has the same
size as the Scene size. The size of the captured image can be fixed to a certain dimension.
This option should be used carefully. By default, the Anti-Aliasing option is active. On some
hardware, this option may slow down image creation. If you are experiencing difficulty taking
screenshots, turn the Anti-Aliasing option off.

1.3.1.3.3.8. Section Generation

Section Generation: Define default tolerance values for the generation of sections
and the minimum analysis ply thickness. For more information see Lay-Up Computa-
tion (p. 61).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Figure 1.16: Section Generation Preferences

1.3.1.3.3.9. Units

You use the Units menu to change the active unit system.

Figure 1.17: Units Menu

The unit system can only be altered in preprocessing. It is locked in shared mode and postpro-
cessing. When changing from a predefined unit system to Undefined, or vice versa, no conver-
sions take place.

The unit system of the active model is displayed in the status bar at the bottom of the ACP
window.

Table 1.1: Predefined Unit Systems

Name Length Mass Time Length*Mass/Time2 Temperature Currency

BFT ft slug s lbf F USD
2
BIN in 1/in*lbf/s s lbf F USD
CGS cm g s dyn C USD
MKS m kg s N K USD
MPA mm t s N C USD
SI m kg s N K USD
UMKS μm kg s μN C USD

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
Getting Started

Name Length Mass Time Length*Mass/Time2 Temperature Currency

Undefined - - - - - -

1.3.2. Tree View

The underlying Python Object Tree (p. 425) is mapped into the graphical Tree View. It provides an
easy way of selecting objects or viewing/modifying the state of an object. An explanation on how to
modify specific objects in the Tree is provided in the Usage Reference (p. 57).

Most Tree objects are associated with a context menu, which can be displayed by right-clicking the
object. Double-clicking a Tree object directly opens the Properties dialog for that object - providing
a shortcut from opening the context menu.

The Tree View is accompanied with a toolbar that is located at the top of the Tree View. The following
functions are available:

• Search allows you to search for Tree objects which have a name matching the search string.

• The collapse button folds the Tree back into its original state.

Note:

The search is case-insensitive and requires an exact match. Special characters are not
treated as wild cards and are not ignored in the search and object name strings. For ex-
ample, a search for "test object 1" will not return a match for an object named test_ob-
ject_1. Similarly, a search for "test_object_*" will not return a match for and object named
test_object_1.

Caution:

Care should be taken when defining objects while Tree filtering is active. The object selec-
tion must be consistent with what is displayed in the filtered Tree. It is recommended that
you clear any Tree filters while defining new objects.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Figure 1.18: Tree View

A status symbol appears for each item.

Figure 1.19: Locked Rosettes and the Update Status

: Rosette is locked and up-to-date.

: Rosette is locked but not up-to-date.
: Rosette is updated.
: Rosette is hidden.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
Getting Started

: Rosette is not updated. It can be updated with the general update in the toolbar or
context menu.

The symbol indicates that this object is defined, but inactive and therefore not considered in any
evaluation. Modeling Plies, Solid Models and Analysis Plies can be inactive.

You can move through the Tree using the arrow keys. The sub-trees are automatically reduced and
expanded.

Special shortcuts exist for the Modeling Group. For more information, see Usage Reference (p. 57)).

1.3.3. Scene
The Scene contains a 3D graphical representation of the model and all defined entities. There is no
limit to the number of Scenes that can be created, and changing from one Scene to another can be
done with a single click. You can navigate through the Scene by mouse or keyboard input. For more
information, see Scene Manipulation (p. 22).

1.3.3.1. Scene Manipulation

The view of the Scene can be manipulated using several buttons on the toolbar:

: Standard views along each axis.

: Zoom to fit the model.

: View full-screen.

: Active or deactivate perspective.

: Capture screenshot.

1.3.4. Toolbar
The toolbar interacts with the Scene by modifying camera views or displaying or hiding elements:
1.3.4.1. Updates
1.3.4.2. Edit Entities with Excel
1.3.4.3. Mesh Appearance
1.3.4.4. Orientation Visualization
1.3.4.5. Fiber Directions
1.3.4.6. Draping
1.3.4.7. Other Features
1.3.4.8. Configure Plots

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

1.3.4.1. Updates
After some operations (for example, reloading the model, modification of one or more plies, or
activating postprocessing), an update ( ) of the Scene is necessary.

1.3.4.2. Edit Entities with Excel

: Create, edit, or save the entities such as Look-up Tables or Modeling Plies with Excel.

The Excel Link interface allows you to define, modify, or save the lay-up definition in an Excel
spreadsheet. The lay-up can be transferred to a spreadsheet using the push function or a lay-up
which has been defined in a spreadsheet can be imported into ACP using the pull function. By
default, all lay-up data is synchronized between Excel and ACP. Alternatively, you can select specific
Modeling Groups for which the lay-up is synchronized. In addition, Pull Mode controls how the lay-
up is transferred to ACP. The lay-up can be linked to a new spreadsheet or to an existing one. The
latter functionality gives you the ability to restore a lay-up from pre-defined data.

Figure 1.20: Excel Link Dialog

The main functions of the Excel Link are:

• Open Excel: Open an existing Excel file if specified. If no path is specified, a new worksheet is
opened and filled with the current lay-up information.

• Push to: Sync lay-up definition data from ACP to Excel.

• Pull from: Read definition data from Excel and update the definition in ACP.

• Close All: Close Excel and the ACP Dialog Box

The following options are available for Pull Mode:

• Update Entities: During a Pull from operation, definitions are updated, additional plies are
generated and deleted according to Excel data.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
Getting Started

• Update Properties Only: During a Pull from operation, definitions are updated with properties
given.

• Recreate Entities: During a Pull from operation, existing lay-up is deleted and generated from
scratch. The ACP Tree order corresponds to the Excel spreadsheet order.

1.3.4.3. Mesh Appearance

Appearance of the mesh can be modified using several buttons on the toolbar:

• : Show or hide element edges.

• : Show or hide the mesh surface.

• : Show or hide the silhouette of the mesh. For huge meshes, this function is computa-
tionally expensive. This will prevent Scene manipulation while it is processing.

• : Highlight elements.

• : Highlight silhouette of selected elements even if it is hidden by mesh.

• Element Selection Mode: The button icon changes depending on which mode is active:

– : Automatically highlight shell or solid elements when an object of a shell or solid model
is selected. For example, when an Analysis Ply under a Solid Model (p. 172) is selected, that
element on the model is highlighted.

– : Highlight only shell elements. When an object of a solid model is selected (for example,
a Mesh Component of a Solid Model (p. 172)), nothing is highlighted.

– : Highlight only solid elements. If the selected object is not part of a solid model (for
example, a Modeling Ply or a Production Ply), nothing is highlighted.

• : Display probe values when hovering over model.

1.3.4.4. Orientation Visualization

You can display the surface orientations using the orientation buttons on the toolbar.

Figure 1.21: Orientation Visualizations in the Toolbar

: Display element normals or normal direction of CAD geometry parts.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Figure 1.22: Visualization of the Element Normals

: Display orientation of an Oriented Selection Set (OSS).

Figure 1.23: Visualization of the OSS Normal

: Display reference direction of an Oriented Selection Set (OSS).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 25
Getting Started

Figure 1.24: Visualization of the OSS Reference Direction

1.3.4.5. Fiber Directions

The ply angles can be visualized with the fiber direction buttons on the toolbar.

Figure 1.25: Fiber Directions in the Toolbar

: Display the fiber direction of the selected ply.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
26 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Figure 1.26: Visualization of the Fiber Direction

: Display the transverse ply direction.

Figure 1.27: Visualization of the Transverse Ply Direction

1.3.4.6. Draping
You can highlight the draping effect by comparing the fiber direction (see Fiber Directions (p. 26))
with the draped fiber direction as well as the transverse fiber direction with the transverse draped

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
Getting Started

fiber direction. Moreover, if the Fabric Fiber Angle (p. 74) property is active, its effect can be visu-
alized by plotting the Material 1 Direction of the selected analysis ply.

Figure 1.28: Draping Directions in the Toolbar

: Plot Draped Fiber Directions.

Figure 1.29: Fiber Directions (Defined and Draped)

: Plot Draped Transverse Fiber Directions.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
28 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Figure 1.30: Traverse Directions (Defined and Draped)

: Plot Material 1 Directions.

Figure 1.31: Material 1 Direction and Draped Fiber Direction for a Material with a 45° Fabric
Fiber Angle

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 29
Getting Started

1.3.4.7. Other Features

The toolbar displays the following additional features:

• : Display or hide the coordinate system axis.

A coordinate system axis is displayed by default in the bottom left corner of the graphics window
for a better 3D orientation.

• : Plot box with coordinate system.

Figure 1.32: Enclosed Box and Coordinate System

• : Distance measure tool. Select two points of the mesh and the distance and point coordinates
will be displayed in the bottom left.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
30 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

Figure 1.33: Distance Measure Tool

1.3.4.8. Configure Plots

Configure the objects displayed in the Scene.

• Plot Properties: Configure vector density and length for the direction plots. In addition,
you can specify whether vectors and contour plots are always shown in front of the mesh.

• Show Legend: Show / hide the plot legend.

• Toggle Text Plot: Show / hide text labels in plots, such as Failure Mode or User-Defined
Text.

• Show Min/Max Labels: Show / hide labels highlighting the minimum and maximum value
of a plot. Note that the labels are not shown when Ply Offsets are active.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 31
Getting Started

• Show Description: Show / hide the plot description in the top left corner of the scene.

• Show Deformed Shape: Select whether the plot is shown on the original or deformed mesh.

1.3.5. View Panes

The View panes displayed at the bottom of the interface contain specific information about the pro-
cesses performed. You can rearrange the Views using drag and drop. A red highlight displays the
new (drop) position for placing the View. Each View is described below.

1.3.5.1. Shell View

All commands performed through GUI interactions are executed by the internal Python interpreter.
The same commands can be entered manually in the Shell View window. The Shell View window
also provides standard text editing features such as copy and paste, history, and tab completing.

A detailed overview about scripting in ACP and a command reference can be found in ACP Python
Scripting User Interface (p. 421).

Code Completing and Help

The period (".") activates the code completing. Use the Up Arrow, Down Arrow, or the mouse to
navigate through the drop-down menu. [TAB], [ENTER] or double-clicking inserts the selected
command.

Enter an opening parentheses "(" to get help on the selected method. Press [ENTER] to insert the
function header.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
32 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

The context menu of the Shell View windows is accessible by a right-click and it allows you to copy
and paste commands. Use "Paste and Run" to execute multi-line or multiple statements.

1.3.5.2. Keyboard Shortcuts

Here is the list keyboard shortcuts of the Shell View window that allow you to access the history,
copy, and paste commands, and so on.

Selection
Home Go to the beginning of the command or line.
End Go to the end of the line.
Shift + Home Select back to the beginning of the command or line.
Shift + End Select to the end of the line.

Copy and Paste

Ctrl + C Copy selected text, removing prompts.
Ctrl + Shift + C Copy selected text, retaining prompts.
Ctrl + V Paste from clipboard.
Ctrl + Shift + V Paste and run multiple commands from clipboard.

History
Ctrl + Up-Arrow Retrieve previous history item.
Ctrl + Down-Arrow Retrieve next history item.
Shift + Up-Arrow Insert previous history item.
Shift + Down-Arrow Insert next history item.

Font Size
Ctrl + ] Increase font size.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 33
Getting Started

Ctrl + [ Decrease font size.

Ctrl + Wheel Edit font size.
Ctrl + = Default font size.

1.3.5.3. Logger
The information saved in the file %APP_DATA%\Ansys\v241\acp\ACP.log is shown in this
View. The severity level of the logged events is defined in Logger Settings (p. 17).

1.3.5.4. History View

All commands processed during the existing session are stored in the Python command history.
They can be inspected in the History View window, where each text line refers to an executed
command. The command history is also available in the Shell View by using the Ctrl + Up / Ctrl +
Down keys.

1.3.6. Keyboard Shortcuts

ACP provides keyboard shortcuts for executing common operations.
1.3.6.1. General Shortcuts
1.3.6.2. Scene View Shortcuts
1.3.6.3.Tree View Shortcuts
1.3.6.4. Shell View
1.3.6.5. Properties Windows

1.3.6.1. General Shortcuts

Workbench mode
Ctrl+S Save Project (entire WB project)
Ctrl+Shift+S Save ACP Database as new file
Ctrl+R Run Script
Ctrl+H Open ACP Documentation

In Standalone mode
Ctrl+O Open ACP Database
Ctrl+S Save ACP Database
Ctrl+Shift+S Save ACP Database as new file
Ctrl+W Close active Model
Ctrl+Shift+W Close all Models
Ctrl+I Import Model
Ctrl+R Run Script
Ctrl+H Open ACP Documentation

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
34 of ANSYS, Inc. and its subsidiaries and affiliates.
 Graphical User Interface

1.3.6.2. Scene View Shortcuts

The following keyboard shortcuts are available in the Scene View pane. See also the section,
Scene (p. 22).

Scene View
Left-Click Select Element
Left-Click (drag) Select multiple Elements
Middle-Click Set rotation center
Middle-Click (drag) Rotate Camera
Ctrl+Middle-Click (drag) Move Camera
Right-Click (drag) Zoom to selected area
Scroll wheel Zoom in / out

1.3.6.3. Tree View Shortcuts

The following shortcuts are available in the Tree View pane. Also Tree View (p. 20).

Tree View
Up-Arrow Go up in tree
Down-Arrow Go down in tree
Right-Arrow Expand tree group
Left-Arrow Collapse tree group
[ Go to previous ply of the same kind
] Go to next ply of the same kind
F2 Rename object
Ctrl+C Copy object(s)
Ctrl+X Cut object(s)[a]
Ctrl+V Paste object(s)
Del Delete object(s)
Mouse-Click+Drag Drag-and-drop object(s)[b]
[a] Cut-and-paste and drag-and-drop are implemented only for the following object types:
Script, Modeling Group, Modeling Ply, Interface Layer, Butt Joint Sequence, and Extrusion
Guide.
[b] See Reordering Modeling Plies, Interface Layers, and Butt Joint Sequences (p. 149) for details
on how cut-and-paste and drag-and-drop affect the Global Ply Number.

1.3.6.4. Shell View

The following shortcuts are available in the Shell View pane. See also View Panes (p. 32).

Selection
Home Go to the beginning of the command or line.
End Go to the end of the line.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 35
Getting Started

Shift+Home Select back to the beginning of the command or line.

Shift+End Select to the end of the line.

Copy and Paste

Ctrl+C Copy selected text, removing prompts.
Ctrl+Shift+C Copy selected text, retaining prompts.
Ctrl+V Paste from clipboard.
Ctrl+Shift+V Paste and run multiple commands from clipboard.

History
Ctrl+Up-Arrow Retrieve previous history item.
Ctrl+Down-Arrow Retrieve next history item.
Shift+Up-Arrow Insert previous history item.
Shift+Down-Arrow Insert next history item.

Font Size
Ctrl+] Increase font size.
Ctrl+[ Decrease font size.
Ctrl+Wheel Edit font size.
Ctrl+= Default font size.

1.3.6.5. Properties Windows

Properties Window Shortcuts
Esc Discard changes and close the Properties window
Ctrl+Enter Save changes and close the Properties window.

In the Properties Windows, mouse interactions can be used to quickly define properties.

• Select Position: Click the model to define a coordinate.

– Selecting a node returns its coordinates.

– Selecting an element returns its centroid.

Application example: Defining the origin of a Rosette.

• Select Direction:

– Option 1: Ctrl+Click the start point, then Ctrl+Click the end point of the vector. Points can
be either nodes or elements. For nodes, its coordinates are used. For elements, its centroid is
used.

– Option 2: Click an element to get the normal direction of the element.

Application example: Defining the directions of a Rosette.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
36 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

1.4. Implementation in Workbench

In Workbench, the ACP analysis component can be used from basic analysis to complex load cases and
analyses. The following sections contain some examples of common use of the ACP analysis system.
1.4.1. Basic Workflow
1.4.2. ACP Component Properties
1.4.3. Supported Analysis Types
1.4.4. Multiple Load Cases and Analyses
1.4.5. Shared Composite Definition for Different Models
1.4.6. Solid Modeling
1.4.7. Assembly
1.4.8. Limitations

1.4.1. Basic Workflow

A composite shell defined using ACP can be imported into Mechanical for analysis by importing the
mesh and composite definitions from an upstream ACP system. To import a composite shell from
ACP into Mechanical, use the following procedure:

1. From the Component Systems list, drag and drop an ACP (Pre) system into the Project Schem-
atic. For more information on Component Properties available in Workbench, see ACP Component
Properties (p. 41).

2. Select the Geometry cell and specify your geometry. Make sure that you properly define your
mesh, Named Selections, etc. before opening the geometry in ACP. Note that ACP only uses a
linear or quadratic shell mesh.

3. Select the Setup cell of the ACP system. Right-click the cell and select the Properties option. As
needed, activate the Load Model Properties option contained in the Geometry category of the
Properties of Schematic. Selecting this property makes your geometry available in ACP's CAD
Geometries (p. 95) object.

4. Perform all of the steps to fully define your ACP (Pre) system.

5. Return to the Workbench. Drag and drop a supported Mechanical system into the Project
Schematic.

6. Drag and drop the ACP (Pre) Setup cell onto the Mechanical system Model cell to create a
transfer of the model. A context menu gives you options to Transfer Solid Composite Data or
Transfer Shell Composite Data. The connection enables the transfer of Mesh, Geometry, Engin-
eering Data, and composite definitions from ACP to Mechanical. When you create this link, the
Geometry and Engineering Data cells no longer display for the Mechanical system. ACP provides
this system data.

You can change the Transfer Type if you pass the Solid Model (p. 171) to the analysis instead of
the Shell Mesh, or vice-versa. See Assembly (p. 48).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 37
Getting Started

7. Double-click the Model cell of the Mechanical system. In the Mechanical application, an Imported
Plies object is already inserted. Analysis Ply objects, corresponding to the Analysis Plies in ACP,
are created under the Imported Plies object.

The Analysis Ply objects are grouped in Production Plies, and Production Plies are further grouped
into Modeling Plies to mimic the ply structure defined in ACP:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
38 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

8. Perform all the steps to fully define and solve the Mechanical system.

The following should be noted when performing an analysis with imported ACP data:

• Since the mesh is imported from an upstream ACP system, any operations that affect the mesh
state are blocked inside Mechanical.

• It is recommended that you do not edit the mesh inside Mechanical. However, the Clear Gen-
erated Data option is available on the Mesh object and performs the action of cleaning up
the imported mesh. The Generate Mesh/Update operation restores the imported mesh that
was previously modified.

• Since the material is assigned to elements/bodies through the upstream ACP system, the Ma-
terial Assignment field is read-only and set to Composite Material.

• If the Setup cell of the upstream ACP system is modified, refreshing the downstream Model
re-imports the meshes and resynthesizes the geometry. This action has the following effects:

– Any properties set on the bodies imported from the ACP system are reset to default.

– For solids, any scoping to geometry (bodies/faces/edges/vertices) is lost and any

loads/boundary conditions scoping to geometry are lost.

Tip:

Any criterion-based Named Selections defined in the downstream Mechanical system

are updated on refresh after any modification in the upstream ACP system. Since cri-
terion-based Named Selections are automatically updated, and any direct scoping is
lost, you should create criterion-based Named Selections and then scope any loads or

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 39
Getting Started

boundary conditions to these Named Selections. This will result in persistence of

scoping during modify/refresh operations.

9. Review the results. Layered results can be reviewed in Mechanical or in ACP-Post. For postprocessing
in Mechanical, see Displaying Surface Body Results (including Layered Shell Results) and the
Composite Failure Tool. To utilize additional postprocessing capabilities within the ACP application,
drag an ACP (Post) system onto the ACP (Pre) Model cell, and connect the Solution cell of the
Mechanical system onto the ACP (Post) Results cell.

Analyses that require upstream results from Eigenvalue Buckling or Pre-Stress Modal analyses are
also supported and can be transferred from the solution.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
40 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

1.4.2. ACP Component Properties

The following section describes properties of an ACP component in Workbench. Properties can be
accessed through the right-click context menu over each component cell, as shown below in Fig-
ure 1.34: Properties from Right-Click Context Menu (p. 42).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 41
Getting Started

Figure 1.34: Properties from Right-Click Context Menu

From the Setup Properties Menu, shown below in Figure 1.35: Properties Menu: Setup (p. 42), the
following options are available.

Figure 1.35: Properties Menu: Setup

• Load Model Geometry: Imports the geometry from ACP's Mechanical model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
42 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

• Editor Startup Timeout (s): Timeout to catch an ACP start-up error. (Example: No license is available.)
You can increase this value to account for license server delays.

• Batch Mode: Specifies the Batch Mode of ACP between True Batch Mode and GUI Without Win-
dow. By default, ACP runs in True Batch Mode so it can support cluster environments (Windows
or Linux) where no graphics support is present. Note that ACP Snapshot functionality is only sup-
ported in the GUI Without Window option. If your analysis is generating Snapshots and is run by
mistake in True Batch Mode, the analysis will still run to completion.

Notice that the Editor Startup Timeout and Batch Mode options are also available in the ACP Post
properties.

The Transfer Type, which defines whether the Shell or Solid Composite model is passed to the
downstream analysis, can be changed through the Properties of the downstream Mechanical model.
See Assembly (p. 48).

1.4.3. Supported Analysis Types

The ACP (Pre) system can be linked with the following Mechanical analysis systems:

• Static Structural

• Transient Structural

• Steady-State Thermal

• Transient Thermal

• Modal

• Harmonic Response

• Random Vibration

• Response Spectrum

• Eigenvalue Buckling

• Explicit (LS-DYNA)

The ACP (Post) system cannot post-process all analysis types. It supports the following Mechanical
analysis systems:

• Static Structural

• Transient Structural

• Steady-State Thermal

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 43
Getting Started

• Transient Thermal

Note:

• Although both Structural and Thermal layer modeling are available, the particular degrees
of freedom results on corresponding layers could behave differently in structural and
thermal environments. For more information, see the Element Reference for the specific
elements, particularly SOLID185 and SOLID278.

• Steady-State Thermal and Transient Thermal analysis systems are fully supported by the
solid workflow (p. 47)only. For the shell workflow, the number of layers per element is
limited to 31 for a linear temperature distribution through-the-thickness and 15 for a
quadratic distribution.

• Explicit analyses are not supported because ACP’s post-processing system predicts a
first ply failure and therefore does not consider damage or material degradation.

1.4.3.1. ACP–LS-DYNA
Using the ACP – LS-DYNA workflow, you can analyze composite structures with respect to crash
and impact. This workflow has been improved for various areas in recent releases. It supports the
transfer of shell models as *ELEMENT_SHELL and solid models as *ELEMENT_TSHELL between the
two applications (see Solid Modeling (p. 47) and Solid Models (p. 171)). Assemblies are supported
as well (see Assembly (p. 48)) .

Figure 1.36: Sample Workflow of ACP – LS-DYNA within Workbench

Several LS-DYNA material cards are available in Engineering Data. Once defined, they are automat-
ically transferred to the LS-DYNA solver. This allows you to define a material card for each material.
Among others, the following composite specific material cards are supported:

• MAT_001 MAT_ELASTIC

• MAT_002 Option ORTHO MAT_ORTHOTROPIC_ELASTIC

• MAT_002 Option ANISO MAT_ANISOTROPIC_ELASTIC

• MAT_054/055 MAT_ENHANCED_COMPOSITE_DAMAGE

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
44 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

• MAT_058 MAT_LAMINATED_COMPOSITE_FABRIC

• MAT_059 Option SHELL MAT_COMPOSITE_FAILURE_SHELL_MODEL

• MAT_059 Option SOLID MAT_COMPOSITE_FAILURE_SOLID_MODEL

• MAT_221 MAT_ ORTHOTROPIC_SIMPLIFIED_DAMAGE

The LS-DYNA analysis type (system C in the figure above (p. 44)) creates an LS-DYNA model (.k
file) from the Mechanical model, including lay-up definitions from ACP, and runs the LS-DYNA
solver in the background. LS-DYNA features which are not available in Workbench can be added
to the model through LS PrePost by doing the following: Export the LS-DYNA input file (use the
Write Input File Tool in Mechanical, as shown below) and load it in LS PrePost to further pre-process
the model. An alternative is to use the Commands object and the Input File Include constraint.
For more details, see How to use LS-DYNA in Workbench in the LS-DYNA User's Guide.

Figure 1.37: Create an LS-DYNA Keyword (.k) File from the Workbench Model within Mechanical

Note:

Not all material cards can be used for layered shells or solids. Here are some of the lim-
itations. Refer to the LS-DYNA documentation carefully for all details.

• MAT_002/ MAT_ORTHOTROPIC_ELASTIC

Cannot be used with angles other than 0 on integration points. Not valid in general
for ACP to LS-DYNA.

Note: This material does not support specification of a material angle, β1, for each
through-thickness integration point of a shell.

• MAT_221/MAT_ORTHOTROPIC_SIMPLIFIED_DAMAGE

Only valid for 3D_Solid Elements. Not valid in general for ACP to LS-DYNA.

• MAT_059/MAT_COMPOSITE_FAILURE_{OPTION}_MODEL, Option=SHELL/SOLID

Cannot be used with TSHELL. So, valid for ACP to LS-DYNA shell models only.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 45
Getting Started

1.4.4. Multiple Load Cases and Analyses

Complex workflows with multiple load cases and/or analyses are defined in the same way as standard
analyses. In most of the cases, the links to share the data are set automatically by Workbench. Some
links must be manually added. In the following example, the links from the Solution cells of analyses
B and C to the ACP (Post) system have been added manually.

Figure 1.38: Multiple Load Cases and Analyses

1.4.5. Shared Composite Definition for Different Models

The ACP (Pre) Setup cell can be shared across multiple models. This means the same composite lay-
up can be applied to models of different geometries and meshes. This functionality can be used in
design studies where the composite definition remains the same but different geometries are evaluated.
Submodeling is another situation where this functionality can be used. In a scenario where two
models are to share the same ACP (Pre) Setup, one setup cell is dragged on to the other. ACP maps
as much information onto the second model as possible. It is advised to use common Named Selections
as well as the same Engineering Data. The figure below shows an example of a shared ACP (Pre)
setup.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
46 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

Figure 1.39: Two Analyses Share the Same ACP (Pre) Setup

1.4.6. Solid Modeling

Similar to composite shells, composite solids defined using ACP can be imported into Mechanical for
analysis by importing the mesh from upstream ACP systems and synthesizing the geometry from the
imported meshes. The import of a composite solid from ACP into Mechanical follows the same pro-
cedure for shells except that the transfer option Transfer Solid Composite Data must be selected
as shown below.

ACP distinguishes between two different approaches: the first approach is an extrusion algorithm
that generates a solid mesh based on the Composite Definitions and the shell reference surface. This
feature is simply called Solid Model (p. 171). In this scenario the solid mesh is completely generated
by ACP (Pre). For more information, refer to the Guide of Solid Modeling (p. 303) and the Analysis of
a Composite Solid Model (p. 331) sections of the Help.

In the second approach, the Composite Definitions are mapped onto an external solid mesh that is
loaded in ACP. This feature is called Imported Solid Model (p. 196).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 47
Getting Started

Load an External Solid Mesh in ACP (Pre)

External solid meshes can be transferred to ACP (Pre) by linking a Mechanical Model component to
ACP Setup as shown in the Figure below. This allows you to map the composite definitions onto the
Imported Solid Model. (p. 196)

Figure 1.40: Import Volume Mesh from Mechanical Model (E4 to C5)

Solid meshes from third party applications can also be loaded into ACP (Pre). In that scenario the
mesh is loaded via External Model and Mechanical Model as shown in the next figure.

Figure 1.41: Import Volume Mesh from Third Party Application

Note:

The internal link between the MechanicalModel and ACP Setup within an ACP (Pre)
System (C4 to C5 in the figure above) transfers the shell mesh only.

1.4.7. Assembly
You can import meshes from multiple systems into Mechanical. It is possible to combine composite
shell, composite solid, and non-layered shell and solid meshes to perform a mixed analysis. Mechan-

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
48 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

ical does not allow the overlap of node/element numbers from multiple systems. The import fails if
the mesh node/element numbers from different systems overlap. Meshes from upstream to downstream
Mechanical models are renumbered automatically to avoid overlapping. For every analysis system
(mesh), you have the choice between automatic renumbering (default) and manual configuration.
(See Renumbering and Transfer Type (p. 49).) If automatic renumbering is disabled, you must ensure
that the element/node numbering is unique for each mesh.

Figure 1.42: A Multi-System Analysis in Workbench

Additional topics in this section:

1.4.7.1. Renumbering and Transfer Type
1.4.7.2. Creating a Mixed Assembly

1.4.7.1. Renumbering and Transfer Type

The Properties menu of the Mechanical Model allows you to turn automatic renumbering on or
off and also to change the Transfer Type of ACP (Pre) systems from shell to solid.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 49
Getting Started

1.4.7.2. Creating a Mixed Assembly

To create a mixed assembly:

1. From the Analysis Systems panel, drag and drop an ACP (Pre) Analysis system into the project
schematic.

2. Drag and drop a supported Mechanical system into the Project Schematic and create a link
from the ACP (Pre) Setup cell to the Mechanical Model cell.

3. Add other ACP (Pre) systems as needed.

4. Drag and drop a Mechanical Model component into the Project Schematic for the non-layered
parts. Create a transfer link from the Model cell of the upstream system to the Model cell of
any downstream systems.

5. Double-click the downstream Model cell to edit the model. For every upstream mesh, a Geo-
metry, Imported Plies, and Named Selections folder are inserted in the Tree View of Mechan-
ical.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
50 of ANSYS, Inc. and its subsidiaries and affiliates.
 Implementation in Workbench

6. Perform all the steps to fully define and solve the Mechanical Analysis system.

1.4.8. Limitations
• A connection from an upstream ACP (Pre) Setup or Mechanical Model cell is only possible if the
Engineering Data cell of the intended downstream Mechanical system is not modified. If the En-
gineering Data cell of the downstream system is modified by creating/modifying an existing ma-
terial in the Engineering Data interface, a data transfer cannot be created.

• ACP composite definitions are not supported in nested assemblies as shown below. For instance,
the Imported Plies of System D are not passed to System E, and therefore the ply definitions are
lost.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 51
Getting Started

1.5. Migrating ACP Projects from Previous Versions

General Updates
In Version 2019 R2, the coordinate system naming is maintained between Mechanical and ACP. When
migrating Workbench archives from previous versions, minor manual input may be required to maintain
Rosette reference links. See Known Limitations (p. 3) for more information.

A new serialization format for ACP was introduced in Version 2019 R1 in order to improve performance
and usability. Therefore, any ACP database created with version 19.2 or older must upgraded. The sections
below describe how to upgrade ACP projects from previous versions:

ACP into Workbench

When opening ACP projects generated in a previous version, you should do a Clear Generated Data on
the ACP (Pre) Setup cell.

Upgrading Projects from Version 17.1 or Older

Projects older then version 17.2 should be opened and saved in any version from 17.2 to 19.2 to ensure
a robust upgrade to the current release. Please ensure that every ACP-Pre, -Shared, and -Post system
is completely updated and saved. This intermediate upgrade is supported starting from version 14.0.

Upgrading Projects from Versions 17.2 to 19.2 to the Current Release

If you open or restore a Workbench project that has been created with any version from 17.2 to 19.2,
then the ACP systems turn to a `refresh required` state. This ensures that the upgrade happens auto-
matically on refresh or update of the ACP systems. This also leads to the situation that ACP-Post and
Shared systems cannot be launched before the corresponding (upstream) ACP-Pre system has been
updated. Once the upgrade is done, up-to-date status, etc. are maintained.

Miscellaneous

Version 17.0 introduced a new workflow for ACP (composites). The existing workflow from previous
versions is still valid. If you wish to upgrade your projects from previous versions to the new composite
workflow, please contact your technical support representative.

ACP Standalone
Upgrading ACP Databases from Version 17.1 or Older

ACP databases older then version 17.2 should be opened and saved in any version from 17.2 to 19.2
to ensure a robust upgrade to the current release.

Upgrading ACP Databases from Versions 17.2 to 19.2 to the Current Release

ACP models that have been generated with any version from 17.2 to 19.2 can be upgraded easily. Open
the *.acp file in the current release and perform a `Save As` in order to generate the new *.acph5
database file.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
52 of ANSYS, Inc. and its subsidiaries and affiliates.
 Stand Alone Operation

Python UI
Version 18.0 changed the material scripting interface for ACP. A material's properties (for example en-
gineering constants and stress and strain limits) are no longer members of the Material class, but each
property forms its own class instance of the type PropertySet. This is to better reflect the individually
closed data basis for data interpolation in case the properties depend on user-defined field variables
(see Variable Material Data in Composite Analyses (p. 319)). The PropertySet instances can be accessed
by their string key on the Material class. ACP scripts using materials must be updated to be compatible
with the new material properties.

In 2019 R1, The model attribute create_cad_selection_rule() has been replaced with cre-
ate_geometrical_selection_rule(geometrical_rule_type='geometry'). Scripts that
used the CAD Selection Rule in previous versions need to be adapted accordingly for this release.

1.6. Stand Alone Operation

ACP can be used as a Stand Alone application. This section describes how ACP can be operated in Stand
Alone mode. It is important to know that the Stand Alone mode does not support all features that are
available within Workbench (For instance, the user fields and variable materials are not supported.)

Version 2019 R1 introduced a new serialization format. This changes the handling of external sources
(shell input mesh or CAD geometries) when ACP is run in standalone mode. Modifications of the input
files are no longer automatically detected by ACP and are not considered on update or open. Therefore,
you must refresh the inputs explicitly:

• Reference Surface (shell): perform a Reload of the model (Model> Reload)

• CAD Geometry: press Refresh button in the property dialog of the object

• Imported Solid Model (solid mesh): press Refresh button in the property dialog of the object

1.6.1. Starting ACP in Windows

1.6.2. Starting ACP in Linux
1.6.3. Command Line Options and Batch Mode
1.6.4. Workflow in Stand Alone Operation

1.6.1. Starting ACP in Windows

To start ACP in Stand Alone mode in Windows, use the shortcut in the Start Menu. The shortcut can
be found in Programs\ANSYS 2024 R1\ACP

1.6.2. Starting ACP in Linux

On a standard installation, ACP can then be started by entering the following command into the
command prompt:
/ansys_inc/v241/ACP/ACP.sh

Command line options listed in Command Line Options and Batch Mode (p. 54) are also valid in
Linux.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 53
Getting Started

1.6.3. Command Line Options and Batch Mode

ACP can also be used on a command line level. The general usage of the ACP start script is:
ACP.exe [options] [FILE]

The supported command line options are:

Long Form Short Form Description

--version Display the program’s version number and exit.
--help -h Display the program’s command line options and exit.
--batch=BATCH_MODE -b BATCH_MODE Run ACP in Batch Mode.

0 - Batch Mode disabled.

1 - True Batch Mode. (No GUI will be created.
Snapshot functionality is not supported.)
2 - Batch Mode with GUI toolkit but hidden
window. (Snapshot functionality is
supported.)
--debug -d Enable debug output.
--num- -t Number of threads to be used. 0 for max available
threads=NUM_THREADS NUM_THREADS threads.
--logfile=LOGFILE -o LOGFILE Specify file to be used for log messages.
--mode=MODE -m MODE Application starts up in the specified mode (‘pre’,
‘shared’, or ‘post’).
--workbench -w Run ACP in Workbench mode.
--port=PORT -p PORT Specify port number for remote access server.
[FILE] [FILE] If the specified file is an ACP project, it is opened. If
it is a Python script it is executed.

1.6.4. Workflow in Stand Alone Operation

The difference between Stand Alone operation and WB Integration is that the several steps or opera-
tions have to be performed manually. The following is an overview of these steps:

1. Generate the Ansys input file in Workbench or Mechanical APDL, including the loads and boundary
conditions (*.inp, *.dat or *.cdb).

From Workbench:

In the Mechanical application, select the analysis and select Tools > Write Input File to write a
*.dat or a *.inp file.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
54 of ANSYS, Inc. and its subsidiaries and affiliates.
 Stand Alone Operation

Figure 1.43: Write Input File

Alternatively, in the project schematic, you can update the Setup status. A ds.dat file is written
in the project folder SYS-X/MECH. This file can also be used as Pre-processing Model in ACP.

From Mechanical APDL:

In Mechanical APDL, use the command CDWRITE to write a .cdb file, which can be used as a
preprocessing model in ACP.
cdwrite,db,file,cdb

2. Start ACP

3. Import the Ansys Model in ACP.

ACP supports the .dat, .inp and .cdb file formats. Import the model into ACP by selecting
File > Import Model or by right-clicking the Models object in the Tree View and selecting Import
Model.

Figure 1.44: Import Ansys Model Using the Context Menu

4. Define the Materials, or copy the materials from the ACP Material Databank.

For more information on defining materials, see Material Data (p. 70).

For more information on using the Material Databank, see Material Database (p. 255).

5. Create laminate sequences.

See Usage Reference (p. 57) and Composite Modeling Techniques (p. 281) for detailed information.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 55
Getting Started

6. Update the model after any change in the ACP definition (lay-up definitions) or change of the
input model.

After any modification in the input model, the input file must be reloaded (see Model (p. 58)).

After any change in the ACP definition, the database must be updated. Use the Update (p. 23)
button in the toolbar.

7. Send the model to the Ansys solver (Solve Current Model) or export the new analysis file (Save
Analysis Model). For more information, see Model (p. 58).

8. Switch between ACP Pre and ACP Post.

Click on the parent object in the Tree View to switch between ACP Pre and ACP Post. You may
also right click the parent object to call up the contextual menu and select ACP Post.

Figure 1.45: Switch Between ACP Pre and Post

9. Import the results.

In the ACP Post mode, solutions can be imported to evaluate the strength of the composite
structure. In the Tree View, import the result files by right clicking the Solution object. See Solu-
tions (p. 222) for more details.

10. Perform composite postprocessing.

Use definitions (p. 221) to define which results are evaluated in postprocessing. Plot these values
in the Scene (p. 243) for representation on the geometry or use sampling points (p. 161) for repres-
entation through the lay-up.

11. Save the composite definitions.

Use the File menu or right-click the Models object in the Tree View to use the contextual menu.

1.7. Tutorials and Examples

The Tutorials describe the basic features of ACP and provide a quick start to the software. The Example
Analyses (p. 323) describe special workflows. You must be familiar with the basics of the software to
understand the examples.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
56 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 2: Usage Reference
This chapter consists of the following sections:
2.1. Features
2.2. Postprocessing
2.3. Exchanging Composite Definitions with Other Programs

2.1. Features
The features described are in the following sections:
2.1.1. Model
2.1.2. Scripts
2.1.3. Material Data
2.1.4. Element and Edge Sets
2.1.5. Geometry
2.1.6. Rosettes
2.1.7. Look-Up Tables
2.1.8. Selection Rules
2.1.9. Oriented Selection Sets (OSS)
2.1.10. Modeling Groups
2.1.11. Imported Modeling Group
2.1.12. Field Definitions
2.1.13. Sampling Points
2.1.14. Section Cuts
2.1.15. Sensors
2.1.16. Solid Models
2.1.17. Lay-Up Plots
2.1.18. Definitions
2.1.19. Solutions
2.1.20. Scenes
2.1.21. Views
2.1.22. Ply Books
2.1.23. Parameters
2.1.24. Material Database

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 57
Usage Reference

2.1.1. Model
Right-click the context menu of the model for access to model properties, save options, and import/ex-
port interface options. The context menu options are different when ACP is run in Workbench compared
to Stand-Alone Mode.

In Workbench mode, these options are:

Figure 2.1: Model Context Menu in Workbench Mode

In Stand-Alone mode, the options are:

Figure 2.2: Model Context Menu in Stand-Alone Mode

This is an overview of the items in the model context menu. Selected items are explained in more
detail below.

• Properties: Display the Model Properties dialog where information about the model, input file,
tolerances and unit system can be found and modified (see Model Properties - General (p. 59))

• Update: Update the entire model.

• Clear Generated Data: Delete all results of the previous update and remove the serialized cached
data.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
58 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Save (Stand Alone only): Save the selected model.

• Reload (Stand Alone only): Reload the input file into the database (return to the last saved state).

• Close (Stand Alone only): Close the selected model.

• Save Analysis Model (Stand Alone only): Save the Ansys input file including the lay-up defined in
ACP.

• Save APDL Commands (Stand Alone only): Save the lay-up definition as APDL Command Macro,
modifies the model from isotropic material monolithic elements to orthotropic layered composite
elements with some adjustments on results save.

• Solve Current Model (Stand Alone only): Submit the Ansys input file including the composite lay-
up definition to the Ansys solver.

• Export Composite Definitions to ACP File: Export the lay-up definitions to a different ACP file
(see Import/Export of ACP Composite Definitions File (p. 63)).

• Import Composite Definitions from ACP File: Import the lay-up definitions from an other ACP
file (see Import/Export of ACP Composite Definitions File (p. 63)).

• Export to HDF5 Composite CAE File: Export the mesh with the Composite Definitions to a .HDF5
file (see Import From/Export to HDF5 Composite CAE File (p. 64)).

• Import from HDF5 Composite CAE File: Import a mesh with Composite Definitions from a .HDF5
file (see Import From/Export to HDF5 Composite CAE File (p. 64)).

• Import Section Data from Legacy Model: Import section data from a Mechanical APDL legacy
model (see Import Section Data from Legacy Model (p. 64)).

2.1.1.1. Model Properties - General

The following figures show the Model Properties dialog window in both Workbench and Stand
Alone mode.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 59
Usage Reference

Figure 2.3: General Model Properties

In Stand-Alone mode, the Format, Input File Path, and Input File Unit System properties become
editable and are used to import the shell reference surface (shell mesh). The Model Statisticstab
gives an overview of model statistics including number of materials, stack-ups, etc. The full list of
Model Statistics are shown in Figure 2.4: Model Statistics (p. 60) below.

Figure 2.4: Model Statistics

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
60 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.1.1.1. ACP Model

The ACP Model section of the Model Properties dialog displays the path to the ACP model file.
The unit system of the ACP model is also displayed. This unit system can be changed in the
Units (p. 19) menu. The selected unit system is displayed in the status bar at the bottom of the
ACP window.

The property Cache Update Results controls whether the update results (i.e ply extents, analysis
plies, solid models) are stored. This allows you to reopen the most recently used lay-up model
state and improves the application's performance. You can disable this feature in order to reduce
the size of the .ACPH5results file. Note, if the feature is disabled, you will be prompted for a
model update whenever the ACP Model is reopened.

2.1.1.1.2. Reference Surface

The file path to the input file of the reference surface is set in the Reference Surface section of
the Model Properties dialog.

In Workbench, the reference surface is automatically transferred to ACP in the Ansys HDF format.
In this case, the reference surface unit system is fixed.

In Stand Alone mode, the input file path for the reference surface is set here. The input file can
be a .DAT (generated by Workbench), .INP, or .CDB (generated by Mechanical APDL with
CDWRITE). The unit system for the reference surface can be set if it is not defined in the input
file.

The unit system must be defined in Stand Alone mode when importing or exporting a model in
.HDF5 format and also when exchanging material data with the database or ESAComp.

The bounding box describes the dimensions of the reference surface in xyz-space.

2.1.1.1.3. Lay-Up Computation

The options defined in this section are described below:

Angle and Relative Thickness Tolerance

ACP transfers the Composite Definitions into Section Data so that they can be interpreted by
Ansys Mechanical. In the case of curved surfaces or draped laminates, sections may change con-
tinuously with every element as their orientations change. This generates information which can
reduce the performance of data transfers and solvers. To avoid this, ACP groups section data of
multiple elements together within a certain tolerance range.

The Angle Tolerance field sets the allowable ply angle tolerance between the same layers of
neighboring elements. The Relative Thickness Tolerance field applies to the individual layer
thickness as well as the global lay-up thickness. For two elements to be included in the same
section definition, the difference of the angle and the relative thickness of every ply must be
within the defined tolerance. Core materials are typically thicker than a laminate by a factor of
10 or more. As such, the thickness tolerance is defined as a relative rather than an absolute value.
The default tolerance values are very small compared to the manufacturing tolerances of com-
posites. The loss of accuracy is negligible.

Minimum Analysis Ply Thickness

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 61
Usage Reference

Cutting operations used in ACP can cut an analysis ply to a thickness thinner than the specified
ply thickness. For example, if a Cut-Off geometry intersects a ply at its vertical mid-point, it will
slice the ply in half. When the intersection occurs at ply boundaries, an extremely thin layer can
appear as the result of geometric tolerances of CAD files. These extremely thin layers are of the
order of magnitude of 109 and are purely the results of numerical imprecision. The Minimum
Analysis Ply Thickness field sets a thickness threshold below which no such plies can arise.

The global default values for the above mentioned tolerances and thickness are set in the Section
Generation (p. 18) dialog but can be overridden in the Model Properties dialog.

Use Nodal Thicknesses

ACP supports ply with variable thickness (p. 293) and Ply Tapering (p. 289). By default, the thicknesses
are evaluated at the element centers, but for Ply Tapering and Cut-Off operations, it can be
worthwhile to evaluate them on a per-node basis. This additional data further refines the lay-up
representation in ACP and is used in shell and solid model analysis. The option Use Nodal
Thicknesses enables the node-based thicknesses evaluation. For more information, see Element-
vs. Node-based Thicknesses (p. 64).

Use Draping Offset Correction

By default, during draping simulation, the application lays the draping mesh on the reference
surface of the model independently of the lay-up thickness. However, for thick laminates, such
as sandwich structures, with Ply Tapering and Drop-Offs, this approach can lead to inaccurate
results. If you enable the Use Draping Offset Correction option, the draping mesh follows the
bottom offset (relative to the reference surface orientation) of the selected ply. This allows the
application to account for the lay-up thickness and, as a result, provides a more accurate draping
simulation. Enabling offset correction for thick and curved laminates also improves the precision
of the boundary and area for the flat wrap of the ply.

2.1.1.1.4. Model Summary

Global information about the model is displayed in this section of the dialog. The Number of
Elements field includes both layered shell and layered solid elements.

2.1.1.2. Solve
In Stand Alone, mode the Model Properties dialog has a second tab: Solve. On it, you can define
the file path of the analysis model and the working directory used by the solver. The Solver Status
and the Output File information are also located on the Solver tab. In the case of an incomplete
run, warning and error massages from the solver can be found here.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
62 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.5: Solver Information (Solve.out)

2.1.1.3. Import/Export of ACP Composite Definitions File

The ACP Composite Definitions file contains all the information stored in an ACP model. The model
is defined in the ACP file in the ACP Python scripting language. During import, you will be asked
specify how ACP should handle objects having the same name.

Figure 2.6: Export Composite Definitions Window

Figure 2.7: Import Composite Definitions Window

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 63
Usage Reference

2.1.1.4. Import From/Export to HDF5 Composite CAE File

You can exchange composite models across different CAE and CAD platforms using the HDF5
Composite CAE specification. For more information, see HDF5 Composite CAE Format (p. 264).

2.1.1.5. Import Section Data from Legacy Model

The Import Section Data from Legacy Model menu option automatically loads the section data
from a legacy Mechanical APDL layered shell model. This option converts the data into standard
ACP Composite Definitions. The conversion is based on the element labels, so the meshes of the
legacy and ACP model have to be equal. See the Import of Legacy Mechanical APDL Composite
Models (p. 273) section for a detailed explanation for importing legacy models.

Parameters
The parameters for the menu include:

• Path: This is the file path to the legacy file.

The Workbench framework does not allow ACP to add materials to the Workbench project
during the import process. Therefore, the materials have to be created and/or imported in
an upstream Engineering Data system before you can import the legacy model into ACP.
This makes sure that a full transfer of the section-based lay-up of the legacy model is per-
formed. The External Model component enables you to import materials easily (see Import
of Legacy Mechanical APDL Composite Models (p. 273)). However, the material IDs get con-
verted following a certain pattern. The Material ID pre- and suffix property of the import
options allows you to define this pattern. The mapping is case independent.

• Materials Mapping Mask: This area of the dialog provides the following entries:

– Prefix: A text-based string displayed before the legacy material ID in Workbench.

– Suffix: A text-based string displayed after the legacy material ID in Workbench.

2.1.1.6. Element- vs. Node-based Thicknesses

By default, ACP stores the thicknesses per ply and element. In other words, the ply's thickness is
constant per element. This representation is consistent with the solver capabilities of layered shells,
since they do not support varying ply thickness within one element. Therefore, geometry features
(for example thickness by geometry or taper edge) calculate the ply thickness at the element centers
(element-based thicknesses). ACP also supports node-based thicknesses. When node-based thickness
evaluation is enabled, thicknesses are evaluated supplementary to the element-based thicknesses.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
64 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

This involves some performance losses but gives benefits when working with tapered plies (see
Thickness (p. 140) and Cut-Off Selection Rules (p. 116)).

Shell Lay-Up

The differences between element- and node-based thicknesses are best explained with a tapered
ply. The nominal ply covers the entire plate and a defines the tapering as shown in the figure below.
The figure on the left shows the element-based piercing where the computed ply thickness at the
element centers is negative for the upper two elements (red arrows). The right image shoes the
node-based piercing that brings a more precise resolution. In that specific case, all elements have
at least one node with a positive (valid) thickness.

Figure 2.8: Element-based vs. Node-based Piercing

The final result for both optiomns is shown in the following figure. The ply is cropped if the thick-
nesses are only evaluated at the element corners since two elements have a negative thickness. In
contrast, the ply covers the entire plate if the thicknesses are evaluated for each node because at
least one node of each element has a valid ply thickness. If the node-based piercing determines
that only some nodes of an element have a valid piercing but not the element center, then the
thickness at the element center becomes the average node-based thickness.

Figure 2.9: Ply Extension and Element-wise Thicknesses of a Tapered Ply with Element-based
(left) and Node-based (right) Thicknesses

In summary, node-based thicknesses bring some benefit for shell models, but also bring certain
restrictions. Node-based thicknesses cannot be evaluated if a ply covers more than two components,
as shown in the figure below. In other words, a ply is not allowed to cover three elements that
share one edge.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 65
Usage Reference

Figure 2.10: Restriction for Node-based Thicknesses

Solid Extrusion

The usage of node-based thicknesses brings more benefits if you perform a solid model analysis
instead of a shell analysis because the extrusion of the solid model is performed on a per-node
basis. Additionally, layered solid elements support plies with variable thickness. The figure below
shows the solid model from an example discussed in a previous section. As for the shell model, the
solid model with element-based thicknesses does not cover the entire reference surface. In contrast,
the node-based extrusion represents the ply extension more precisely. Additionally, it also captures
the variable ply thickness over one element and therefore reproduces the taper much better.

Figure 2.11: Extrusion of a Tapered Ply without and with Node-based Thicknesses on the Left
and Right, Respectively

There are two additional examples where you can benefit from node-based thicknesses:

• Tapered edge: Only nodal thicknesses can represent tapers with 0 thickness correctly.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
66 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.12: Solid Model Extrusion of a Tapered Ply without and with Node-based Thicknesses

• Cut-Off selection rules with Ply Tapering: By default, tapering evaluated at the element centers
can cause ripples in the extrusion. Node-based thicknesses result in a smoother shape and more
accurate ply representation. In this specific case, it even allows you to proceed without a Snap-
To operation, since the surface is of good quality.

Figure 2.13: Cut-Off Selection Rule with Ply Tapering Based on Element-based and
Node-based Thicknesses

2.1.1.7. Winding Wizard

Refer to the section Winding Wizard (p. 13).

2.1.2. Scripts
Scripts enable more complex parametrization than is possible with Input Parameters (p. 252) alone.
You can use scripts to execute arbitrary Python code (p. 421) as part of updating the model. Scripts
are marked for execution whenever a parameter or the script itself changes.

To create a script, select Create Script... in the context menu of the Scripts object in the ACP Tree
View.

The following sections describe Scripts in detail:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 67
Usage Reference

2.1.2.1. Executing Scripts

2.1.2.2. Script Properties
2.1.2.3. Limitations
2.1.2.4.Tips and Best Practices
2.1.2.5. Sorting Scripts

2.1.2.1. Executing Scripts

By default, scripts are marked for execution whenever a parameter or the script itself changes. The
Unbound Input parameter category is meant for parameters that are used inside a script.

For scripts that should execute with every model update even if no parameters have changed, set
the Update Mode property to Always.

For scripts that should never execute automatically, set the Update Mode property to manual.
These scripts can be run manually either from the properties dialog, or the context menu of the
script as shown below.

2.1.2.2. Script Properties

You can edit a script and set its execution properties in the Properties dialog:

• Active: Activates or suppresses the script. Only active scripts can be executed.

• Update mode: Determines when the script is executed. Possible options are:

– On Triggers: Execute when updating the model, if a parameter or the script has changed.

– Manual: Execute only when instructed by the user.

– Always: Execute on every model update.

• Source: Contains the Python code to be executed.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
68 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

In addition to the default buttons (OK, Apply, and Cancel), the Script has a Save button which
saves the modifications without closing the window or updating the model.

2.1.2.3. Limitations
Because scripts can execute arbitrary Python code, it is important to be aware of their limitations:

• Scripts are executed only when a parameter or the script itself changes. If the script implicitly
depends on values in other parts of the model, they will still be shown as up-to-date when these
values change.

• New objects created by a script are not tracked. If the script runs again, objects created in a
previous execution are not deleted.

2.1.2.4. Tips and Best Practices

Based on the above limitations, adhere to the following guidelines for writing scripts to ensure
consistent behavior:

1. Dependencies: The values set by the script should only depend on the input parameters.

2. Idempotency: If the script is designed to execute multiple times, the model should not change.
For example, if the script generates new objects, it must also delete those objects created during
the previous execution.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 69
Usage Reference

2.1.2.5. Sorting Scripts

When updating the model, out-of-date scripts are executed in the order shown in the Tree View.
You can change this order in the following ways:

1. From the context menu of the Scripts folder, sort the scripts alphabetically:

2. Select one or more Scripts in the Tree View, and move them after another Script by doing one
of the following:

• Use the cut-and-paste options from the target Script’s context menu (shown below).

• Use the Cut (Ctrl+X) and Paste (Ctrl+V) hotkeys.

• Use the mouse to drag-and-drop the Scripts.

3. From the context menu of an individual Script (as shown below), choose Reorder Scripts …
to place it before or after another Script.

2.1.3. Material Data

ACP differentiates between four material classes: Materials (p. 71), Fabrics (p. 80), Stackups (p. 84)
and Sublaminates (p. 89).

• The Materials (p. 71) class is the material database in ACP.

• The Fabric (p. 80) class is where Materials can be associated with a ply of a set thicknesses.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
70 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• The Stackup (p. 84) class is used to combine fabrics into a non-crimp fabric, such as a [0 45 90]
combination.

• The Sublaminate (p. 89) class is used to group fabrics and stackups together for frequently used
lay-ups.

A Stackup or a Sublaminate can only be defined if a fabric and material have been defined previously.

2.1.3.1. Materials
The Materials database is only editable within ACP in Stand Alone mode. Otherwise, it draws all
material properties from Engineering Data within Workbench. In this case, the material properties
can be viewed- but not altered- in ACP.

2.1.3.1.1. Materials Context Menu

The context menu of the Materials class has the following options:

• Create Material (Stand Alone only): Open a Material Properties dialog for creating a new
material.

• Paste (Stand Alone only): Paste a copied material into the material database.

• Sort: Sort the list of materials alphabetically.

• Export: Export the material database into a .csv file, ESAComp XML file, or an Ansys Workbench
XML file.

• Import (Stand Alone only): Import materials from a .csv file or ESAComp XML file.

More information on the import and export of ESAComp XML file can be found in ESAComp (p. 277).
Stackups and Sublaminates can also be exported to an ESAComp XML file format but are con-
verted to laminates in the process.

Figure 2.14: Materials Class Context Menu in Stand Alone Mode

2.1.3.1.2. Temperature Dependent and General Variable Material Properties

Engineering constants, density, fabric fiber angle, as well as stress and strain limits, can be set to
depend on scalar field variables, including Temperature, Shear Angle, and Degradation Factor.
Other properties can only depend on temperature. The material properties are always shown at
the reference point in the Materials object. Variable material data can be edited in Workbench
Engineering Data.

In ACP, variable material data are considered in ACP-Post when evaluating failure criteria. Tem-
perature-dependence comes into effect if the solution contains a temperature data block.
Shearing of plies is considered if the material is dependent on the Shear Angle variable and at

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 71
Usage Reference

least one ply is draped. All other dependencies require the respective field variable to be defined
by means of Look-Up Tables. For more information, see Variable Material Data in Composite
Analyses (p. 319) and Analysis Using Variable Material Data (p. 339).

Within the Workbench workflow, variable data are passed to and from ACP. In Stand-Alone mode,
temperature-dependent data are passed to and from ACP if the import and export is in an Ansys
file format, such as .CDB.

General variable material properties are read only from the Workbench Engineering Data (.ENGD)
file. Export and import of material data within the Materials object via .csv or .XML file formats
do not support general variable material data.

2.1.3.1.3. Material Properties Dialog

Here is the Material Properties dialog.

In the Material Properties dialog, the following preprocessing data is required:

• Name: Name of the material.

• ρ: Density of the material.

• Ply Type: Defines the material type and controls which failure criteria evaluates the safety of
a certain material (see Failure Criteria vs. Ply Type Table (p. 408)). Depending on the extrusion
method (e.g. sandwich-wise extrusion) in the Solid Model, it also affects the volume mesh of
the solid model .

– Adhesive: Materials of this type are post-processed with specific failure criteria. An ad-
hesive has isotropic mechanical properties.

– Honeycomb Core: Sandwich core material with a honeycomb pattern.

– Isotropic: Isotropic material and post-processed with the von Mises criterion.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
72 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

– Isotropic Homogeneous Core: Sandwich core material, such as foam, with isotropic
elasticity. Note that orthotropic strength limits have to be defined for post-processing
(failure criteria evaluation).

– Orthotropic Homogeneous Core: Sandwich core material, such as balsa, with an ortho-
tropic material characteristic.

– Regular (uni-directional): Uni-directional reinforced material.

– Undefined: If the material type is not known or not defined, then the ply type becomes
undefined. This material type is not post-processed.

– Woven: Weave material.

• Orthotropic Young's Modulus:

– E1: In-plane, in fiber direction (fiber direction is corresponding to angle 0 for the ply's
definition)

– E2: In-plane, orthogonal to fiber direction

– E3: Out of plane direction

• Orthotropic Poisson's Ratio:

– ν12: In-plane

– ν13: Out of plane, in fiber direction

– ν23: Out of plane, normal to fiber direction

• Orthotropic Shear Modulus:

– G12: In-plane

– G13: Out of plane, in fiber direction

– G23: Out of plane, normal to fiber direction

Further failure properties can be activated. Depending on the Ply Type some properties are de-
activated automatically.

Note:

Engineering Data can only be modified in preprocessing. Once postprocessing has

been initiated the data is frozen.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 73
Usage Reference

2.1.3.1.4. Thermal Expansion Coefficients

For thermal stress analyses, the thermal expansion coefficients of the material and the reference
temperature must be given:

• Reference Temperature: Temperature at which strain in the design does not result from
thermal expansion or contraction

• alpha X: In-plane, in fiber direction (fiber direction is corresponding to angle 0 for the ply's
definition)

• alpha Y: In-plane, orthogonal to fiber direction

• alpha Z: Out of plane direction

2.1.3.1.5. Fabric Fiber Angle

The Fabric Fiber Angle represents the angle between the Material 1 Direction and the Draped
Fiber Direction. When no draping is specified, the Draped Fiber Direction coincides with the Fiber
Direction. By default, the Fabric Fiber Angle is set to zero so that the Material 1 Direction coincides
with the (draped) fiber direction.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
74 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.15: Example of Woven Material with a 45° Fabric Fiber Angle

When the Fabric Fiber Angle property is active and nonzero, you need to specify the Material
Properties, Thermal Expansion Coefficients, Strain Limits and Stress Limits with respect to the
material directions rather than the fiber directions. For instance, E1 and E2 would represent the
Young’s moduli in the material 1 and 2 directions, respectively. However, the fiber direction is
still the nominal modeling direction in ACP. For more information, see the Shear Dependent
Materials in Composite Analysis (p. 356) example and the Material Designer User's Guide.

You can highlight the effect of the Fabric Fiber Angle by plotting the draped fiber direction and
the material 1 direction of a selected analysis ply (see Draping (p. 27)).

2.1.3.1.6. Strain Limits

The Strain Limits are used to calculate the IRF if the Max Strain criteria is selected in the failure
criteria definition (p. 221). Compressive strain limits must be negative.

For orthotropic materials, 9 strain limits (5 in-plane and 4 out-of-plane strains) can be entered:

• eXc: Normal strain, in-plane, in fiber direction, compression limit

• eXt: Normal strain, in-plane, in fiber direction, tension limit

• eYc: Normal strain, in-plane, orthogonal to fiber direction, compression limit

• eYt: Normal strain, in-plane, orthogonal to fiber direction, tension limit

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 75
Usage Reference

• eZc: Normal strain, out of plane, compression limit

• eZt: Normal strain, out of plane, tension limit

• eSxy: In-plane shear strain

• eSxz: Transverse (interlaminar) shear strain, plane in fiber direction

• eSyz: Transverse (interlaminar) shear strain, plane normal to fiber direction

If the material is defined as isotropic, the von Mises Strain Limit can be entered:

2.1.3.1.7. Stress Limits

All the other Failure Criteria definitions are based on values defined in the Stress Limits dialog.
Compressive stress limits must be negative.

For orthotropic materials, 9 stress limits (5 in-plane and 4 out-of-plane strains) can be entered:

• Xc: Normal stress, in-plane, in fiber direction, compression limit

• Xt: Normal stress, in-plane, in fiber direction, tension limit

• Yc: Normal stress, in-plane, orthogonal to fiber direction, compression limit

• Yt: Normal stress, in-plane, orthogonal to fiber direction, tension limit

• Zc: Normal stress, out of plane, compression limit

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
76 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Zt: Normal stress, out of plane, tension limit

• Sxy: In-plane stress strain

• Sxz: Transverse (interlaminar) shear stress, plane in fiber direction

• Syz: Transverse (interlaminar) shear stress, plane normal to fiber direction

If the material is defined as isotropic the von Mises Stress Limit can be entered (equivalent to
Tensile Yield Strength in Engineering Data):

2.1.3.1.8. Puck Constants

The Puck failure criterion requires internal parameters, which depend on the material. The Mater-
ial Classification drop-down menu offers a selection of pre-defined constants and also allows
for the definition of custom constants. The menu has the following options:

• Carbon: Sets pre-defined Puck constants for carbon fiber materials.

• Glass: Sets pre-defined Puck constants for glass fiber materials.

• Material-specific: Allows you to set your own Puck constants.

• Ignore Puck Criterion: No constants are set.

• p21(+): Tensile inclination XZ

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 77
Usage Reference

• p21(-): Compressive inclination XZ

• p22(+): Tensile inclination YZ

• p22(-): Compressive inclination YZ

• s and M: Degradation parameters

• Interface Weakening Factor: Scales the interlaminar normal strength

2.1.3.1.9. Puck for Woven

ACP’s Puck for Woven functionality allows you to evaluate the Puck failure criterion for woven
materials. You specify two UD plies to represent the woven ply. During the failure evaluation,
ACP evaluates the stresses for theses plies in the new material directions and computes the Puck
failures. The relative ply angles, engineering constants, stress limits, and Puck constants must be
defined for both plies.

This approach, proposed by Puck (p. 596), has been validated by experiments. Warp dominated
woven fabrics have yielded good results. Puck described that fabrics with similar amounts of re-
inforcement in the warp and weft direction (50%/50%)– and therefore having higher fiber undu-
lation– need additional material characterization.

An alternative to Puck for Woven is the Maximum Stress Criterion (p. 385). It does not require
additional material properties (or characterization), and it has been successfully applied in different
commercial projects.

Note:

This specification does not affect the analysis model and is only considered in the
failure analysis for the Puck criterion.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
78 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.3.1.10. Tsai-Wu Constants

The Tsai-Wu constants are constants used into the interaction coefficient of the quadratic failure
criteria for Tsai-Wu formulation. Refer to Tsai-Wu Failure Criterion (p. 385) for more details.

In ACP the Tsai-Wu constants correspond to:

• 2 F12 = XY, default -1

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 79
Usage Reference

• 2 F13 = XZ, default -1

• 2 F23 = YZ, default -1

2.1.3.1.11. LaRC Constants

The LaRC failure criteria requires the following parameters to evaluate the failure in matrix and
fiber:

• Fracture Angle Under Compression: The value for α0 used in the LaRC fiber and matrix failure.
Default value is 53°.

• Fracture Toughness Ratio: The ratio of the mode I to mode II fracture toughness, which is
used in the fiber failure criteria.

• Fracture Toughness Mode I

• Fracture Toughness Mode II

• Thin Ply Thickness Limit (set to 0.7 mm in Workbench mode)

For more information, see LaRC03/LaRC04 Constants (p. 394).

2.1.3.2. Fabric
The settings for the Fabric Properties dialog are described in the sections below:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
80 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.3.2.1. General
Figure 2.16: Fabric Properties - General

• Material: Material of the fabric

• Thickness: Ply thickness

• Price/Area: The surface price can be given to provide global information. For more information,
see Sensors (p. 169).

• Weight/Area: The weight per unit area is calculated based on the thickness and material
density.

• Ignore for Post-Processing: If active, all the analysis plies with this fabric are not considered
in the failure criteria analysis during postprocessing. This does not affect the analysis model.

2.1.3.2.2. Polar Properties

The Polar Properties (Classical Laminate Theory (p. 408)) of the fabric can be plotted as graphical
information.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 81
Usage Reference

Figure 2.17: Fabric Properties - Analysis

This plot can be exported as a picture ( ) or in a .csv file ( )

2.1.3.2.3. Fabric Solid Model Options

Solid model options set which material is used for diminished (Drop-Off and Cut-Off ) elements
during solid model generation. Material handling is determined by the settings in every Fab-
ric/Stackup definition, the global Drop-Off/Cut-Off material handling setting, and the extrusion
method in the Solid Model definition. For more information, see Material Handling for Different
Extrusion Methods (p. 195).

Note:

The Solid Model Options tab is the same for both Fabrics and Stackups.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
82 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.18: Fabric Properties - Solid Model Options

• Drop-Off Material Handling:

– Global: The global Drop-Off material in the Solid Model Properties is used. (default)

– Custom: Select a material from the Drop-Off Material drop-down menu.

• Drop-Off Material: The list becomes active when Drop-Off Material Handling is set to Custom.

• Cut-Off Material Handling:

– Computed: The Fabric/Stackup material is used for analysis ply-wise extrusion. Otherwise,
the global material is used and a warning is generated that computed materials for Cut-Offs
are currently not supported if the element points to more than one Analysis Ply. (default)

– Global: The global Drop-Off material in the Solid Model Properties is used.

– Custom: Select a material from the Cut-Off Material drop-down menu.

• Cut-Off Material: The list becomes active when Cut-Off Material Handling is set to Custom.

2.1.3.2.4. Draping
The Draping settings are used if draping is activated in the Modeling Ply definition. For more
details about the draping calculation, see Draping Simulation (p. 373).

Note:

The Draping tab is the same for both Fabrics and Stackups.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 83
Usage Reference

Figure 2.19: Fabric Properties - Draping

• Material Model:The material model used in the draping simulation, either Woven (default) or
Unidirectional. Note that the draping material model can be set independently of the Ply Type
of the fabric’s material.

• UD Coefficient: A parameter between 0 and 1 which controls the amount of deformation in

the transverse draping direction. This property is active only when Material Model is set to
Unidirectional.

2.1.3.3. Stackup
A stackup is a non-crimp fabric with a defined stacking sequence. From a production point of view,
it is considered as one ply, which is applied on the form. For the analysis, all plies forming the
stackup are considered. For every ply of the stackup, the fabric and its orientation must be given:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
84 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.20: Stackup Properties - General

These stackups have different Price/Area and solid model options than a laminate of single plies.
For this reason, Price/Area can be entered again. Stackups can be exported to an ESAComp XML
file format and are converted to laminates in the process.

2.1.3.3.1. Top-Down or Bottom-Up Sequence

The definition of the stackup can be given in both directions (Bottom-Up and Top-Down). In
the Top-Down sequence, the first defined ply (the first one in the list) is placed first on the mold
and is the bottom of the stackup. The other plies are placed over it. During analysis, the sequence
can be checked. In the above figure, the ply 45 direction is on top (see Figure 2.20: Stackup
Properties - General (p. 85)).

2.1.3.3.2. Symmetries
For a quicker definition, the stackup can be defined with symmetries.

The Even Symmetry option defines the symmetry axis on the top of the sequence, and uses all
plies.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 85
Usage Reference

Figure 2.21: Stackup Sequence with Even Symmetry

In the Odd Symmetry option, the ply on the top is not used for the symmetry. So the middle of
the top ply is the symmetry axis of the final sequence.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
86 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.22: Stackup Sequence with Odd Symmetry

2.1.3.3.3. Analysis
The Analysis tab provides evaluation of the laminate properties of the stackup, which can be
plotted as graphical information.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 87
Usage Reference

Figure 2.23: Lay-Up Information and Polar Properties

This plot can be exported as a picture ( ) or as a .csv file ( ). It is possible to translate and
zoom into the lay-up distribution with the mouse button. To come back to a fit view, click . In
addition, laminate properties (stiffness matrix or flexural stiffness), which are based on Classical
Laminate Theory (p. 408) (CLT), can be calculated.

The following results based on Classical Laminate Theory (p. 408) can be calculated by selecting
them from the CLT Analysis drop-down:

• Laminate Stiffness and Compliance Matrices

• Normalized Laminate Stiffness and Compliance Matrices

• Laminate Engineering Constants

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
88 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.24: CLT Analysis - Laminate Engineering Constants

2.1.3.3.4. Stackup Solid Model Options

The material handling settings for Solid Models are identical for Fabrics and Stacks. For more in-
formation, see Fabric Solid Model Options (p. 82).

2.1.3.3.5. Draping Options

The Draping settings are identical for Fabrics and Stacks. For more information, see Draping
(p. 83).

2.1.3.4. Sublaminates
A sublaminate is a sequence of plies defined by fabrics and stackups with relative angles. This
sublaminate can be used later in the lay-up definition. As with stackups, you can choose the sequence
direction and symmetry. Refer to Symmetries (p. 85) for more information. Sublaminates can be
exported to an ESAComp XML file format and converted to laminates in the process.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 89
Usage Reference

Figure 2.25: Sub Laminate Properties - General Tab

The Analysis tab is exactly the same as for a stackup. Refer to Analysis (p. 87) for information on
the content of this tab.

Important:

If the sublaminate definition uses stackups and symmetry, the stackup is not reversed
in the ply sequence. For example, for a stackup S1 defined as [45,-45,0], and a sub-lam-
inate defined with even symmetry and the stackup ([S1]s), the sub-laminate sequence
is [45,-45,0,45,-45,0], not [45,-45,0,0,-45,45].

2.1.4. Element and Edge Sets

Named selections defined in Mechanical or components defined Mechanical APDL can be imported
into ACP. These selections are imported with the same names. Faces (element components in Mech-

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
90 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

anical APDL) are imported as Element Sets (p. 91) and edges (node components in Mechanical APDL)
as Edge Sets (p. 92).

Important:

After the definition of a new Named Selection in Mechanical, the model must be updated.

2.1.4.1. Element Sets

New Element Sets can be manually defined by selecting individual elements. Element Sets store
the element labels and are therefore not associated with the geometry. If the mesh changes, the
element numbering changes and the element set must be redefined to avoid erroneous lay-ups.

Figure 2.26: Element Set Selection

• Middle Offset: If the mesh is generated at the mid-plane surface, activate this option such that
the section definition is translated to where the middle of the section corresponds to the element.
The lay-up definition - in particular the definition of Oriented Selection Sets - is not influenced.
Solid Model extrusion and Draping Offset Correction do not support the Middle Offset setting.
To verify a lay-up with Middle Offset, use a Section Cut (p. 164) or Sampling Point (p. 161).

• Operation: Add or Remove elements in the list.

• Mode: Define the selection mode by dragging the mouse from one corner to the other.

– Box on Surface: Only visible elements are selected.

– Box Prism: All elements included in the box are selected, depth included.

– Point: Element at the picking location is selected.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 91
Usage Reference

2.1.4.1.1. Context Menu

Several options are available in the Element Set context menu:

• Properties: Open the Element Set property window.

• Update: Update any changes into the database

• Hide/Show: Hide or show this Element Set. The elements of the hidden Element Sets are no
longer visible in the Scene.

• Copy: Copy the selected Element Set to the clipboard.

• Paste: Paste an Element Set from the clipboard.

• Delete: Delete the selected Element Set

• Export Boundaries: Export the boundaries of the Element Set to a STEP or an IGES file

• Partition: Create partitioned Element Sets for any Element Set that can be divided in different
zones, due to a geometrical separation (for example, three elements share the same edge).

Figure 2.27: Element Set Context Menu

2.1.4.2. Edge Sets

Named Selections of connected edges in Mechanical are transferred to ACP as Edge Sets. New Edge
Sets can also be defined manually in ACP-Pre:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
92 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.28: Edge Set Definition

• Edge Set Type: How the Edge Set is defined:

– By Reference: Defined the Edge Set using an existing Element Set (activates the following
options):

→ Element Set: The Element Set of which the Edge Set is part.

→ Limit Angle: The Edge Set is extended from the origin in both directions until the angle
between two elements is bigger than the Limit Angle. If the Limit Angle is set to a negative
value, the Edge Set is the whole boundary of the selected Element Set.

→ Origin: Origin to determine the closest boundary.

• By Reference: An existing Element Set is used to define a new Edge Set through one boundary
limited by an angle diffusion.

• By Nodes: Manually select the nodes to define the Edge Set.

2.1.5. Geometry
Geometries can be used to build complex lay-ups during preprocessing in ACP. For example, core of
variable thickness can be modeled as a ply whose thickness is set by an imported geometry of the
core. Cut-Off Rules can be based on geometry, therefore controlling the lay-up by a CAD surface or
at a pre-defined offset to a CAD surface. Geometries are particularly helpful in generating solid
models where geometry-based Extrusion Guides, Snap-To and Cut-Off operations can create intricate
shapes.

For more information on the use of geometries in a lay-up definition, see the following sections:

• Ply thickness definition (p. 140) in Modeling Groups

• Geometry-based Cut-Off Selection Rule (p. 117)

• Extrusion Guides (p. 183), Snap-To (p. 188) and Cut-Off Geometries (p. 190) in Solid Models (p. 173)

CAD geometries are incorporated in an ACP model by creating a link to a Geometry in the Workbench
Project Schematic or by directly importing an external geometry (IGES or STP format). These CAD

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 93
Usage Reference

geometries may be surfaces, bodies, or assemblies of parts. The concept of virtual geometries allows
you to select and group specific regions or bodies of the imported CAD geometry and use them for
subsequent modeling operations. All geometry-based operations are based on virtual geometries.
Virtual geometries act as a reference to one of more faces or bodies of one CAD geometry.

Note:

Typically, operations based on CAD geometries are computationally intensive, so it is im-

portant to define your geometries efficiently. For example, it is much more efficient to
have multiple small geometrical operations rather than a single large one. Small geometries
process faster because ACP, prior to running the calculation, filters out all extraneous points
and elements. The figure below illustrates three smaller Cut-Off geometries defined instead
of one large one. The principle also applies to all other operations based on geometry.

Figure 2.29: Example of three Cut-Off geometries

Figure 2.30: CAD Geometry Assembly and Virtual Geometries in the Tree View

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
94 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.5.1. CAD Geometries

There are two ways to import an external geometry into ACP:

• The first option is directly through ACP, directly importing copies of the CAD file into the
user_files directory in the Workbench file structure. Any further changes to the original
file are not transferred.

• By selecting the Setup cell of your ACP system and then selecting the Load Model Properties
option (Geometry category of the Properties of Schematic) in Workbench. The advantage
of this option is that the CAD geometry can be refreshed inside DesignModeler or SpaceClaim.

For either case, the geometry remains intact when a project is archived and restored.

Note:

For CAD geometries imported from SpaceClaim, the entire geometry from SpaceClaim
is imported into ACP. In addition, bodies with the Suppress for Physics option activated
are imported.

The parts included in an imported CAD geometry are displayed once the CAD geometry is up-to-
date. If the imported CAD geometry is an assembly of parts, multiple parts are shown in the Tree
underneath the CAD geometry. ACP makes the distinction between four different types of parts:

• Face ( ): Single face

• Surface ( ): Single surface body

• Solid ( ): Single volume body

• Compound ( ): Combination of multiple connected surfaces and/or bodies

Performance:

– Features based on a CAD geometry can demand a lot of computational resources if you
apply them to areas with many elements and/or nodes. You can improve computational per-
formance by splitting the CAD Geometry into smaller parts so you are working with multiple
Virtual Geometries (p. 97) as shown below. The reason is that costly computations are only
performed for the elements and/or nodes which are inside the bounding box of the selected
geometry. Of course, this improves performance only if the intersection between the bounding
box of the geometry and shell mesh is small.

In the example below, it is more efficient to work with two Virtual Geometries (p. 97) because
the bounding box of each individual shape is much smaller than the shell mesh and so the
costly computations are performed only for a few shell elements instead of the entire mesh.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 95
Usage Reference

Figure 2.31: Example of Multiple Virtual Geometries

→ Loading a CAD Geomety can become slow if the CAD file contains many separate
shapes due to a system limitation. The workaround is to import multiple smaller CAD
files.

2.1.5.1.1. Direct Import

Geometry import has the following options:

Figure 2.32: Property Dialog CAD Geometry

• Name: Name of geometry for use in the database.

• External Path: Location of the geometry file to be imported.

• Refresh: Reload the file from the external path. The file is automatically copied to the Workbench
project folders.

• Scale Factor: Scale the geometry in the global coordinate system (useful for change of units).

• Precision: Precision of the imported geometry. This value is used to evaluate intersections and
other geometrical operations.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
96 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Offset: Sets the default capture tolerance value associated with the CAD geometry for operations
such as the Geometrical Selection Rule (p. 121).

• Use Default Offset: Boolean which sets the offset to 10% of the average element size.

• Visualization Color: Color in which the imported geometry is displayed.

• Transparency: Transparency of the imported geometry (value between 0 and 1).

Assemblies should be imported as a single .STP file rather than individual ones containing links.

2.1.5.1.2. Workbench Geometry Link

The geometry component in Workbench can be used to link CAD geometries with ACP-Pre. The
linked geometry is scaled automatically if its units do not match those of the project. The required
steps for geometry import are:

1. Add a Geometry component to the project.

2. In the context menu of the Geometry select Import Geometry

3. Link the Geometry cell to the ACP (Pre) Setup cell

The imported geometry appears under CAD Geometries in ACP.

Figure 2.33: Project Schematic with a CAD Geometry Import in ACP

2.1.5.2. Virtual Geometries

Virtual Geometries group together sub-shapes of CAD Geometry parts. The sub-shapes are referenced
by linking to the features of CAD Geometry parts. See CAD Geometries (p. 95) for information on
how working with geometries impacts system performance.

There are three ways to define virtual geometries:

• Directly from CAD parts through the CAD part context menu.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 97
Usage Reference

Figure 2.34: Create Virtual Geometry Directly from CAD Geometry Part

• By selecting multiple CAD parts from the Tree when the Virtual Geometry Properties dialog is
open.

Figure 2.35: Create Virtual Geometry Through CAD Geometry Parts in Tree

• Through face selection in the Scene.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
98 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.36: Create Virtual Geometry Through Face Selection in the Scene

Note:

Virtual geometries can only reference parts from one CAD geometry.

2.1.6. Rosettes
Rosettes are coordinate systems used to set the Reference Direction of Oriented Selection Sets.
Rosettes define the 0° direction for the composite lay-up. Coordinate systems defined in Mechanical
are imported by default and the naming is maintained between Mechanical and ACP. Additional
Rosettes can be defined in ACP. There are 5 different types of Rosettes. The origin and directions of
Rosettes are given in the global coordinate system. Rosettes are independent of the mesh, even if
you select nodes and elements to define their properties.

One or more Rosettes can be used to set the Reference Direction for elements in an Oriented Selected
Set (OSS). The Selection Method in the OSS definition controls which Rosette determines the Reference
Direction for the elements. The Reference Direction for a single element is determined by a projection
of the applicable Rosette onto the element. Different Rosette types can be used to define the Reference
Direction.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 99
Usage Reference

Figure 2.37: Rosette Properties Dialog

• Flip Buttons: Reverse the direction

• Shuffle Axes: Rotate coordinate system to exchange the X, Y, and Z axis.

• Swap 1 and 2 Direction: Exchange direction 1 with 2.

Rosette Types
• Parallel: Analogous to a Cartesian coordinate system. The Reference Direction is given by the
Rosette's X direction.

• Radial: the Reference Direction for a radial Rosette is perpendicular to the Z direction. The Z direction
lies orthogonal to Direction 1 and Direction 2 in the Rosette properties. The Reference Direction
for an individual element is defined by the vector of Rosette origin to element center which is
projected onto the element. If the direction vector cannot be projected the alternate Direction 1
is chosen.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
100 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.38: Oriented Selection Set with a Radial Rosette.

• Cylindrical: Based on a cylindrical coordinate system. The Reference Direction runs circumferentially
around the Rosette's Z direction according to the right hand rule. The Z direction is defined by the
X and Y direction vectors. Flip the Z direction to reverse the Reference Direction.

Figure 2.39: Oriented Selection Set with a Cylindrical Rosette

• Spherical: Based on a spherical coordinate system. The Reference Direction runs circumferentially
around the Z axis of the Rosette.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 101
Usage Reference

Figure 2.40: Oriented Selection Set with a Spherical Rosette

• Edge Wise: Requires the selection of an Edge Set in addition to the usual Rosette definition. The
Reference Direction is given by a projection of the Rosette's X direction and the path of the Edge
Set. The X direction of the Rosette coordinate system is projected on to the point on the Edge that
is closest to the origin of the Rosette. This determines Reference Direction along the Edge Set. The
Reference Direction is reversed by switching the coordinates of the Rosette's X direction. An element
within an Oriented Selection Set gets its Reference Direction from the direction of the point on the
edge that is closest to the element centroid.

Figure 2.41: Edge Wise Rosette

2.1.6.1. Rosette Definition

Each Rosette is defined by an origin and two vectors. Enter the origin by clicking on an element
or a node, or by typing the coordinates. When selecting an element, the coordinates of the center
of the element are used.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
102 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

If a direction field is selected in the dialog, the selection of an element returns the normal direction
of the element. By pushing down the Ctrl key and clicking on a second element, you can select the
direction defined by the two element centers.

2.1.7. Look-Up Tables

Several features in ACP can be defined as tabular values. Look-up tables can be used for thickness
definition of plies (p. 140), selection rules (p. 124), draping angles (p. 137), and field definitions (p. 158).
In such cases, the Look-up Table contains values (scalars) or direction (vectors) at specified points in
3D space or along a single direction.

Look-Up Tables require at least a Location column (1 or 3 components, one for each coordinate).
Direction columns (3 columns) and/or Scalar columns can be added. The Look-Up Table can be edited
efficiently by exporting and importing an .xls(x) file (see Edit Entities with Excel (p. 23)) or a .csv
file.(see CSV Format (p. 277)).

Note:

Look-up Table rows cannot be directly added or removed in the ACP GUI. The values in
existing cells can only be modified.

Populating Look-Up Tables

The easiest way is to populate Look-up Tables is with the help of the Edit Entities with Excel (p. 23)
on Windows. The set-up with exporting and importing a .csv file is similar and ideal for Linux. Data
can also be entered into Look-up Tables using The ACP Python Scripting User Interface (p. 421).

There are three approaches to populating a Look-Up table. This can be done with:

• The Excel Link (p. 103)

• Exporting/Importing .csv Files (p. 105)

• A Python Script (p. 107)

2.1.7.1. 3D Look-Up Table With The Excel Link

The set-up of a 3D Look-up Table is demonstrated in the figures below:

From the right-click context menu, select Create a 3D Look-Up Table (p. ?) .

An empty 3D Look-Up Table (p. ?) is created with XYZ-location columns.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 103
Usage Reference

Create Direction Columns (p. ?) from the right-click context menu of the new Look-Up Table.

The empty Look-up Table (p. ?) now has three additional columns for three directional components
of the vector.

Populate the table in Excel with your values. Ensure the data set is followed by the END DATA
and END TABLE rows. An example of a populated Look-Up Table (p. ?) in Excel is shown below.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
104 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Use the Excel Link (p. ?) to import and export the data from Excel to ACP.

2.1.7.2. 1D Look-Up Table with .csv Files

The Look-up Table definition with a .csv file follows the same process as the Excel Link (p. 103):
create Look-Up table, add desired columns, export data to Excel, populate the Excel data and re-
import. The .csv file approach for setting up a 1D look-up table is demonstrated with the figures
below.

From the right-click context Look-Up Table menu in the Outline, select Create 1D Look-Up
Table (p. ?).

An empty 1D Look-Up table is created with a single column. Specify the origin and direction of the
table as shown below.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 105
Usage Reference

From the right-click context menu of the new Look-Up Table, select Create Scalar Column (p. ?)
.

Export the empty Look-Up Table to a .csvfile using the right-click context menu.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
106 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Open the exported .csv file (p. ?) in an editor or spreadsheet program.

Add the entries and save the CSV file. Note that you may need to verify the deliminator type if your
regional settings use a comma as a decimal separator.

In ACP, re-import the CSV File by selecting Import from CSV File (p. ?).

2.1.7.3. Look-Up Table with a Python Script

The set-up of a 1D Look-Up Table with a script:
table = db.active_model.create_lookup_table1d(name='LookUpTable1D.1')
table.origin=(0.0, 0.0, 0.0)
table.direction=(1.0, 0.0, 0.0)
table.create_column(name='Value', type='scalar')
table.dimensions=['length', 'dimensionless']
table.columns['Location'].values = [0., 1., 2., 3.]
table.columns['Value'].values = [0., 1., 2., 3.]

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 107
Usage Reference

2.1.7.4. 1-D Look-Up Table

A 1-D Look-Up Table can be used to create a distribution of a scalars or vectors in one direction.
Such a distribution can be used in:

• the definition of an Oriented Selection Set (p. 128) Reference Direction.

• the definition of the draping angle (p. 298).

• the definition of the ply thickness (p. 140).

A 1-D Look-Up Table is defined by an origin, a direction vector, and a column of at least one
quantity varying along the direction vector. Location points can be defined in an arbitrary order.
They are automatically sorted and duplicate location points are permitted for the definition of step
functions. The values of the defined quantity are linearly interpolated to the element centers in the
mesh. The 1-D Look-Up Table uses a scalar product to project the vector between origin and element
center on to the Look-Up Table direction vector and look-up the desired value at that point.

Figure 2.42: Schematic of 1-D Look-Up Table Function

2.1.7.5. 3D Look-Up Table

A 3D Look-Up Table can be used to define field data, such as the variation of fiber directions or
variable layer thicknesses. This table can be used for:

• The definition of an Oriented Selection Set (p. 128) Reference Direction.

• The definition of the draping angle (p. 298) (Modeling Ply).

• The definition of the ply thickness (p. 140) (Modeling Ply).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
108 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.43: Look-Up Table Values

The values in the Look-Up Table are interpolated to the element centers. The Interpolation Al-
gorithm tab allows you to choose between different interpolation algorithms and adjust their
properties. By default, the interpolation uses the Shepard's method (a 3D inverse distance weighted
interpolation) with a reasonable search radius, and the number of interpolation points is 1.

The interpolation algorithm and properties can have a significant effect on the computed values.
The selection of the algorithm depends on the distribution of the supporting points and the FE
mesh. The example below shows the interpolation with different algorithms for the same field. The
spheres are the supporting points, and the color represents the values of the supporting points.
The color of the elements represents the interpolated values. Visualize the interpolation on the
mesh using the Look-Up Table Plot (p. 217), which also generated these figures. For more information
on interpolation, see General Interpolation Library (p. 414).

Figure 2.44: Interpolated Values with Weighted Nearest Neighbor, Nearest Neighbor, and
Linear Multivariate (From Left to Right)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 109
Usage Reference

Figure 2.45: Look-Up Table Interpolation Parameters

The Look-Up Table properties are:

• Algorithm Type: Selection of the interpolation algorithm. The supported options are Weighted
Nearest Neighbor, Nearest Neighbor, and Linear Multivariate. For more details, see General Inter-
polation Library (p. 414).

• Options for Weighted Nearest Neighbor:

– Use Default Search Radius: Compute the initial search radius based on the "characteristic
distance" of the supported points. Validate this search radius and adjust it if needed.

– Search Radius: Only the element centers within this radius are used in the interpolation.

– Min. Number of Interpolation Points: If there are no element centers (or not enough if > 1)
in the radius, the Search Radius increases until the pinball includes at least the minimum
number of interpolation points (element centers) defined in this value.

Note:

If a 3D Look-Up Table contains points without real numbers (i.e. nan or blank), these
values are automatically computed on update by interpolating the valid results.

2.1.7.6. Look-Up Table Column Properties

The dimension of the data columns must be set for unit conversion to work correctly. The column
properties can be accessed through the context menu of the column in the Tree View.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
110 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.46: Setting the Dimension in the Column Properties Dialog

2.1.8. Selection Rules

Selection Rules enable you to select elements through geometrical operations. These selections can
be combined with Oriented Selection Sets (see OSS Selection Rules (p. 131)) or Modeling Plies (p. 136)
to define plies of arbitrary shape. The final extension of the ply is the combination of the Selection
Rules and the selected Oriented Selection Sets. This feature can be used to define local reinforcements
(patches) or staggering. You can select between different selection rule types which are explained in
the sections below. It is also possible to combine different rules and to define Boolean operations
between rules.

Figure 2.47: Selection Rules Context Menu

The .csv file interface of ACP offers the ability to create or modify selection rules externally, share
them with other ACP users working on the same model, or even on a different project. Limitation:
The Variable Cut-Off Selection Rule and Boolean Selection Rule are not supported by the CSV interface.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 111
Usage Reference

2.1.8.1. Basic Selection Rules

2.1.8.2.Tube Selection Rule
2.1.8.3. Cut-Off Selection Rules
2.1.8.4. Geometrical Selection Rule
2.1.8.5. Variable Offset Selection Rule
2.1.8.6. Boolean Selection Rules

2.1.8.1. Basic Selection Rules

Figure 2.48: Definition of a Parallel Selection Rule

Parallel, Cylindrical, and Spherical Selection Rules are simple shapes which can be defined by a
few parameters:

• Parallel: Defined by two parallel planes. The planes are defined by an origin, a normal vector
and two distances (offsets of the planes from the origin along the normal vector).

• Cylindrical: The cylinder is defined by an origin and the vector of the axial direction and the ra-
dius. The cylinder has infinite height.

• Spherical: The sphere is defined by the center and the radius.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
112 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.49: Example of a Parallel Selection Rule

Selection Rule based on Rosettes

Parallel, Cylindrical, and Spherical Selection Rules can be defined in terms of the coordinate relative
to a specific Rosette. To choose a Rosette, uncheck "Use global Coordinate System" and select a
Rosette from the drop-down menu. If a Rosette is selected, Origin and Direction are in the Rosette's
reference frame. Only parallel Rosettes can be used to define Selection Rules.

Relative Selection Rule

It is possible to define a Selection Rule as relative. In this case, the Selection Rule parameters define
the ratios of the selection rule relative to the Modeling Ply dimensions. Take care that the Plotted
Selection rule is evaluated from the global geometry dimensions and that this plot does not represent
the final shape of the Selection Rule which depends on the Modeling Ply. Select the ply and check
the highlighted elements which represent the final shape of the ply.

Include Selection Rule

The Include Selection Rule Type option can be used to select the elements inside the geometry
or outside. By default the option is active (as shown in Figure 2.49: Example of a Parallel Selection
Rule (p. 113)). If the option is inactive, the inverse selection takes effect. Plies with a hole can be
created through a Cylindrical Selection Rule and disabled Include Selection Rule Type option.
This option applies to all geometrical rules as well as the Tube Selection Rule.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 113
Usage Reference

2.1.8.2. Tube Selection Rule

A Tube Selection Rule is a cylinder of variable axial direction with a constant inner and outer radius.
The longitudinal direction is defined by an Edge Set (p. 92), and the radii define the diameters of
the inner and outer cylinder. All elements between the inner and outer radius are selected if Include
Rule Type is enabled (shown below in Figure 2.51: Tube Selection Rule Properties (p. 115)). Otherwise
the inverse selection is used.

Figure 2.50: Example of a tube rule with an outer and inner radius

Note: The Variable Offset Selection Rule (p. 124) allows the definition of a tube with a variable radius.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
114 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.51: Tube Selection Rule Properties

Tube Selection Rule settings are:

• Edge Set: Defines the center line (longitudinal direction) of the tube.

• Outer Radius: Defines the outer radius of the tube.

• Inner Radius: Defines the inner radius of the tube.

• Include Rule Type: If enabled (as shown above), elements inside the tube will be selected. If not
enabled, elements outside the tube will be selected.

• Extend Endings: Enable this option to extend the endings of the tube.

• Symmetrical Extension: If enabled, the length of the extensions will be equal on both sides.

• Head: The free end which is closer to this point becomes the head of the tube. It is only needed
if Symmetrical Extension is disabled.

• Head Extension: Defines the length of the extension at the head of the tube. If Symmetrical
Extension is enabled, it defines both sides.

• Tail Extension: Defines the length of the extension at the tail of the tube if Symmetrical Exten-
sion is disabled.

Notes:

• An extension set to zero or a negative automatically disables the feature at the corresponding
side.

• When the end of a tube is extended, the extension is oriented in the same direction as the last
edge segment.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 115
Usage Reference

Figure 2.52: Edge with a long extension at the head of the edge and a short one at the tail

2.1.8.3. Cut-Off Selection Rules

A Cut-Off Selection Rule acts as a cutting operation on the composite lay-up. In contrast to other
Selection Rules that affect the in-plane directions of the ply, a Cut-Off Selection Rule also considers
the laminate thickness. A Cut-Off Selection Rule can be defined by a geometry or a taper. Using
a Geometry Cut-Off Selection Rule, the ply is cut at the intersection with a CAD Geometry, taking
into account the thickness of the laminate. An example of this is a skew-whiff surface being used
to define the tapering near a trailing edge of a blade. A Taper Cut-Off Selection Rule cuts plies
based on an edge and a taper angle.

Only Analysis Plies are cut off as a result of the selection rule. Modeling and Production Plies are
not affected. The Cut-Off Selection Rule is similar to a milling operation on built-up structure. In
that sense, the full size Modeling and Production Plies are required before the machining operation.
The Analysis Plies are the only decisive plies for any structural computation.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
116 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.53: Cut-Off Selection Rule Properties

Cut-Off Selection Rule settings are:

• Name: Name of the Selection Rule.

• Cut-Off Geometry: The CAD geometry defining the Cut-Off.

• Offset: CAD / taper surface offset. The intersection of the CAD Geometry/taper edge and the lay-
up can be moved by an offset. The direction and orientation of the offset is defined by the normal
direction of the Oriented Selection Set.

• Edge Set: Selection of an Edge Set (Taper).

• Angle: Taper angle (Taper).

• Ply Cut-Off Type: Either the complete production ply is cut off or individual analysis plies are
cut off. Ply Tapering can only be activated in the latter case.

• Example Cut-Off (p. 120)

• Ply Tapering: Control of the Cut-Off resolution.

2.1.8.3.1. Geometry Cut-Off Selection Rule

For each element, ACP determines the position of the ply (including its offset) in relation to the
imported surface. There are two possibilities of how the model geometry is cut by a CAD geometry
- one cutting operation follows the geometry contour, the other divides the ply into either its
maximum thickness or zero thickness. This is controlled by the Ply Tapering option in the Cut-
Off Selection Rule Properties dialog.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 117
Usage Reference

Figure 2.54: Trailing Edge with Cut-Off Plies (Ply Tapering Activated)

In the first method, the ply is cropped if it intersects with the geometry. The ply is cut to match
the external geometry.

In the second method, the ply is cut at a discrete point. The ply cannot have a varying thickness
- it is either at its maximum thickness or it has been entirely cut off. The ply is cut if the intersection
of CAD geometry and ply is less than half of the ply's thickness.

The following figures are taken from Tutorial 4 and are presented to explain the concept further.
In the tutorial, a Geometry Cut-Off Selection Rule is applied to the core. A section view of the
Cut-Off Geometry, applied to two edges, is shown in the figure below. The Cut-Off has a nominal
thickness of approximately two thirds of the core thickness and, towards the outside, it has a
multi radii edge. The dashed yellow line in the figure denotes the ply's centerline.

Figure 2.55: Section of the Cut-Off Geometry

When Ply Tapering is activated, the core is cropped to match the Cut-Off Contour, as shown in
the right figure below. If Ply Tapering is deactivated, the resulting core thickness is at its full
thickness everywhere the intersection of the geometry is above the core centerline. Everywhere
else, the core is completely cut off.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
118 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.56: Core Thickness Without Ply Tapering (Left) and With Ply Tapering (Right)

2.1.8.3.2. Taper Cut-Off Selection Rule

The second way of using the Cut-Off Selection Rule is to define a taper with an Edge Set and
a tapering angle. The area close to the edge has to be sufficiently meshed for the taper Cut-Off
to work. Similar to the Geometry Cut-Off (p. 117), the ply is cut off in the taper zone. Only if Ply
Tapering is selected will there a be a gradual taper over thickness. The Taper Cut-Off Selection
Rule allows the same definition as the Taper Edges feature for modeling plies. For a detailed
explanation of taper angle and offset, see Edge Tapering (p. 289).

By default, ACP analyzes the Cut-Off selection rule at the element centers. Each element is cropped
from the ply if the ply thickness at the element center is negative. This binary representation may
not be sufficiently accurate in certain cases. If the Use Nodal Thickness (p. 61) is enabled, the
Cut-Off and ply tapering (if enabled) will be refined, which in turn results in a more accurate
model. For more information, see Element- vs. Node-based Thicknesses (p. 64).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 119
Usage Reference

Figure 2.57: Taper Cut-Off Selection Rule Definition

2.1.8.3.3. Example Cut-Off

Consider a Stackup of three Fabrics for this example. In the pictures below, a laminate of one
Stackup is shown marked with the green lines. The blue lines highlight the Analysis Plies of the
Stackup. The black lines represents the mesh and the red line indicates the final laminate resulting
from the Cut-Off Selection Rule.

Figure 2.58: Section with The Production Ply Option

The Cut-Off Selection Rule with the Analysis Ply Cut-Off option will result in a smoother section
as each Analysis Ply of the Stackup is cut individually.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
120 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.59: Section with the Analysis Ply Option

The Cut-Off Selection Rule with Ply Tapering will result in an even smoother section. The ratio
between the area of the section cut by the CAD Geometry and the uncut section is calculated.
The same ratio is applied to the ply thickness for the considered element.

Figure 2.60: Section with the Analysis Ply with Tapering Option

2.1.8.4. Geometrical Selection Rule

The Geometrical Selection Rule allows you to define the extent of a modeling ply or OSS based on
a CAD surface or solid geometry. Elements are selected if they lie within the enclosure of a defined
volume. The volume is set by the size of the CAD solid geometry or the CAD surface geometry in
combination with specified Capture Tolerances. This means that a flat CAD surface geometry can
be used to define a ply on a curved mesh surface. Figure 2.61: Example Geometrical Selection
Rule (p. 122) shows a selection inside a curved mesh enclosed by a flat surface with relatively high
negative and positive capture tolerances. See CAD Geometries (p. 95) for information on how
working with geometries impacts system performance.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 121
Usage Reference

Figure 2.61: Example Geometrical Selection Rule

Geometrical Selection Rules have the following settings:

Figure 2.62: Geometrical Selection Rule Properties

• Rule Type: Define whether the rule extent is defined by a geometry of Element Sets. The value
can be geometry or element_sets. The default is setting is geometry.

• Geometry: Virtual Geometry (p. 97) defining the basic selection (only relevant for Rule Type:
Geometry).

– Geometry:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
122 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Virtual Geometries (p. 97)

defining the basic selection (only relevant for Rule Type: Geometry).

• Element Sets: Preselection of elements in the form of an Element Set where the rule is applied
on (only relevant for Rule Type: Element Sets). Multiple Element Sets can be parsed as input by
holding the [Ctrl] button while making your selections.

• Include Rule Type (p. 113)

Capture tolerances are necessary for non-solid geometries, such as surfaces. They evaluate whether
a point is within the geometry by creating an envelope as shown below. The unit values are in
length. All three tolerances support negative values.

• Use Defaults: Defines if the default value is used. The default value is the Offset property of the
CAD geometry (p. 95).

• In-plane: Increase the in-plane extension of the geometry by this value. A negative value will
shrink the surface.

• Negative: Capture tolerance in the reverse direction of the surface normal. A negative value
offsets the geometry in the surface normal direction.

• Positive: Capture tolerance in the direction of the surface normal. A negative value offsets the
geometry in the opposite direction of the surface normal.

The in-plane tolerance can also be adjusted on the Modeling Ply level by template rule parameters.
This may be useful when defining ply tapering. For more information, see Selection Rules (p. 139).

Note:

In principle, the in-plane tolerance is used to extend to the boundary of the geometry.
It is also used to fill gaps between adjacent surfaces that may cause sampling issues.
Therefore, it is recommended to use an In-plane tolerance > 0 when the selection is
missing some elements inside the capturing geometry.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 123
Usage Reference

Figure 2.63: Capture Tolerances

2.1.8.5. Variable Offset Selection Rule

The Variable Offset Selection Rule is defined on the basis of an Edge Set and a 1-D Look-Up Table
containing a list of offsets at different locations. Elements adjacent to the Edge Set are selected if
their centroids lie within the specified offset at the given locations. The offsets are linearly interpol-
ated between locations. In this way, the rule behaves like an advanced Tube Selection Rule where
the outer radius can be varied.

There are two different ways in which the Look-Up Table data can be interpreted: the location of
each offset can be mapped on to a direction vector (default), or on to the length of the Edge Set.

The rule is not called the variable radii rule is because you can deifine the offset over a curved
surface defined by an Element Set. The offsets are initially evaluated as a radius at each element
adjacent to the Edge Set. The Offset Correction then adjusts the offset so that the offset is measured
over the curvature of the surface.

The template rule functionality is not available for the Variable Offset Selection Rule; however there
is a way to accommodate ply staggering with this rule. In addition to the offsets, varying ply taper
angles can also be defined in the form of a 1-D Look-Up Table. Ply Tapering can be used when
multiple Modeling Plies share the same Variable Offset Selection Rule. In such cases, the first Mod-
eling Ply will cover the area defined by the offset definition. The subsequent plies will be tapered
based on the angle definition. The tapering is applied not on the Edge Set side, but on the offset
side, away from the Edge set.

Note:

The angle definition can be used to decrease, fix, or increase the covered areas of the
subsequent Modeling Plies.

Complex patch shapes can be realized with the help of this selection rule.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
124 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.64: Look-Up Table Defines the Offset to Edge Set at a Given Length

Parameters

• Edge Set: The offsets are measured along this Edge Set.

• Offsets: 1-D Look-Up Table with a list of offsets at different locations.

• Angles: (optional) 1-D Look-Up Table with a list of angles at different locations. Only active
when same rule is applied to multiple Modeling Plies. Does not affect the first Modeling Ply.
Depending on the local angle, the covered area of the subsequent plies is changed.

– Angle equals 90 deg: Plies are not changed.

– Angle less than 90 deg: Ply coverage decreases with number of modeling plies.

– Angle greater than 90 deg: Ply coverage increases with number of modeling plies.

• Include Rule Type: The selection envelope can be inverted with this option.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 125
Usage Reference

Offset Correction

Figure 2.65: Offset Correction

• Use Offset Correction: The offset is measured along the surface curvature of the selected
Element Set in a segmented arc when this option is active.

• Element Set: The offset correction is calculated on the curvature of this Element Set. The
selection rule can be applied to other Element Sets also, but retains the offset correction.

Table Properties

Figure 2.66: Offset Mapping Along a Direction Vector

• Origin: This replaces the origin in the 1-D Look-Up Table definition.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
126 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Direction: This replaces the direction in the 1-D Look-Up Table definition.

• Distance Along Edge: When active, the 1-D Look-Up Table data is mapped along the distance
of the Edge Set. In this case, the origin is used to determine the start and the end of the
Edge Set. The mapping will start at the corner of the edge which is closest to the origin. The
zero location in the Look-Up Table coincides with the start of the selection rule.

2.1.8.6. Boolean Selection Rules

The Boolean Selection Rule enables you to combine rules based on Boolean operations. Supported
operators are Intersect, Add, and Remove. (See the dialog below in Figure 2.67: Boolean Selection
Rule (p. 127).) The order you apply the rules is important because they are processed as sequential
filters. Each Boolean operation is applied to the previous intermediate result. Also, because the first
rule applies to all shell elements, using the ADD operator in the first rule will have no effect.

Template Rules: You can redefine some Selection Rule parameters in the Boolean Selection Rule
definition. Set the Template (A, below) to True for those selection rules that should be treated as
a template rule, and then set the values manually. The same feature can be applied to Modeling
Plies. Details are documented in Modeling Ply - Selection Rules (p. 139).

Figure 2.67: Boolean Selection Rule

Figure 2.68: Boolean Operation Types

Note the following limitations:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 127
Usage Reference

• Cut-Off Selection and other Boolean Rules cannot be used within a Boolean Selection Rule.

• The CSV interface does not support Boolean Selection Rules.

2.1.9. Oriented Selection Sets (OSS)

Oriented Selection Sets (OSS) are a key concept in ACP.

The OSS define the basis for the lay-up definition. Plies are applied on Oriented Selection Sets and
not on Element Sets. The OSS give you an independence from your finite element model and its
element normals. OSS combine the following important entities for your composite lay-up:

• The area that plies are applied to.

• The orientation, or side of the shell mesh on which the plies are applied.

• The reference direction defining the 0° fiber direction. All ply angles are relative to this direc-
tion.

The Selection Rules, defined in the Rules tab, can further control the area of an OSS. You may also
use the draping algorithm, in the Draping tab, to define the reference direction on the OSS.

The following figure shows an example of an Orientation Point selected on the mesh and pointing
outwards. The section cut indicates that the lay-out is built in the outwards direction.

Figure 2.69: Orientation Point Definition

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
128 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.70: Definition

An Oriented Selection Set is defined by:

• Name: Name of the OSS.

• Element Sets: Underlying elements for the OSS definition

• Orientation Point: Offset direction is defined at this point. The point should be inside and close
to the reference surface, otherwise the mapping of the offset direction can result in wrong results.

• Orientation Directions: Vector defining the offset (normal) direction at the Orientation Point.

• Reference Direction: Defines the 0° direction of the OSS.

– Selection Method: Defines the mapping algorithm for the Rosettes if more than one Rosette is
used. For more information, see Reference Direction (p. 129).

– Rosettes: One or more Rosettes defining the Reference Direction for each element through the
selected method.

– Reference Direction Field: Defines the direction column of a 3D Look-Up Table. Only applicable
to the tabular values method.

Use the Flip button to reverse the offset direction.

2.1.9.1. Reference Direction

The Reference Direction can be defined by Rosettes or from tabular values. A single Rosette is suf-
ficient for the definition of the Reference Direction. Multiple Rosettes can be selected for one Oriented
Selection Set to obtain complex Reference Direction definition. In this case, a Selection Method

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 129
Usage Reference

must be used to determine which Rosette is applicable to what part of the Element Set. The Selection
Method offers several interpolation algorithms listed below:

• Ansys Classic: Coordinate system is projected on the elements as defined in Ansys (see Coordinate
Systems).

• Maximum Angle: Coordinate system in which the Z direction has the maximum angle with the
element orientation defines the Reference Direction of the Oriented Selection Set.

• Maximum Angle Superposed: Same as Maximum Angle but all the chosen coordinate systems
are considered and weighted by the maximum difference angle direction.

• Minimum Angle: Coordinate system in which the Z direction has the minimum angle with the
element orientation defines the Reference Direction of the Oriented Selection Set. (default)

• Minimum Angle Superposed: Same as Minimum Angle but all the chosen coordinate systems
are considered and weighted by the minimum difference angle direction.

• Minimum Distance: Nearest coordinate system of the element defines the Reference Direction
of the Oriented Selection Set

• Minimum Distance Superposed: Same as Minimum Distance but all the chosen coordinate
systems are considered and weighted by the distance to the element.

• Tabular Values: Interpolated from the values put in a Look-Up Table (p. 103). The table must in-
clude the location values and a direction column.

Note:

If the determination of an element's Reference Direction fails, an alternate computation

method is used and a warning is issued. In this case, it is recommended to verify the
Reference Directions of the affected Oriented Selection Set.

The bonding laminates of the T-Joint example are a case where a Minimum Angle Selection
Method is suitable.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
130 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.71: Reference Direction of a Bonding Laminate Defined by Two Rosettes and a
Minimum Angle Selection Method

2.1.9.2. Selection Rules

The OSS can be intersected with one or several Selection Rules. The intersection of all selected
entities (Element Sets (p. 91) and Selection Rule (p. 111)) defines to new extension of the OSS.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 131
Usage Reference

Figure 2.72: Selection Rules

Note:

Although the Cut-Off Selection Rules (p. 116) use the lay-up definition to calculate the
cut location, this Selection Rule has no influence in this case.

2.1.9.3. Draping
If the Draping option is activated, the reference direction of the Oriented Selection Set is adjusted
and all associated modeling plies use this draped reference direction. Note that the model property
Use Draping Offset Correction doesn’t have any effect on the OSS draping. For more information
about draping, see Draping (p. 298) and Draping Simulation (p. 373).

Figure 2.73: Draping

The following parameters control the Internal Draping of the OSS:

• Seed Point: Starting point of the draping process.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
132 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Auto Draping Direction: Uses the reference direction of the oriented selection set.

• Draping Direction: Sets the primary draping direction for the draping scheme. The secondary
direction is always orthogonal to the primary.

• Use Default Mesh Size: Enable this property to use the default size for the draping mesh. The
default size is the average element size of the shell mesh.

• Mesh Size: A user-defined mesh size for the draping mesh can be set if Use Default Mesh Size
is disabled.

• Material Model: The material model used in the draping simulation, either Woven (default) or
Unidirectional.

• UD Coefficient: A parameter between 0 and 1 that controls the amount of deformation in the
transverse draping direction. This property is active only when Material Model is set to Unidirec-
tional.

For more information on the Draping feature, see Draping Algorithm (p. 373) and its Limita-
tions (p. 376).

2.1.10. Modeling Groups

The ply definition can be organized into Modeling Groups. These Groups do not affect the ply-ordering
and definition, but they provide a way for you to better organize Composite Definitions and streamline
your workflow. For example, you might choose to define one Ply Group for each substructure of a
boat project- one for the hull, one for the deck, and one for the bulkhead.

Before working with a Modeling Group, you must specify an Oriented Selection Set and a Material
(Fabric, Stackup, or Sublaminate). Within a Modeling Group, plies can be created. The lay-up is defined
as it would be in production. The first ply is also first in the stacking sequence. The lay-up can be
tailored by specifying the Orientation, Layering, geometrical Selection Rules, Draping Settings, and
Edge Tapering for each ply.

A lay-up can also include an Interface Layer for carrying out a fracture analysis of a composite solid
model in Mechanical. The interface layer is a separation layer in the stacking sequence, used to analyze
the crack growth of existing cracks. The crack topology is defined with an interface layer in ACP while
all other fracture settings are specified in Mechanical. The interface layers are exported as INTER204
or INTER205 elements and can be used to set up a Cohesive Zone Model (CZM) or a Virtual Crack
Closure Technique (VCCT) analysis. They can also be used to define contacts zones between two layers.
For more information, see Interface Delamination and Contact Debonding in the Mechanical User's
Guide.

Lay-ups can also be defined or changed using the Excel Link interface (p. 23). Changes can also be
made by importing or exporting the lay-up as a CSV file (p. 277).

2.1.10.1. Modeling Group Structure

The Modeling Group node has three sub-levels:

• Modeling Ply (MP): The ACP lay-up is defined at this level. The other two levels are built auto-
matically from information defined in this level.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 133
Usage Reference

• Production Ply (PP): Production Plies are generated derived from the Modeling Ply definition
(Material and Number of Layers). A Fabric and Stackup is one Production Ply. A Sublaminate
typically contains more than one Production Ply. In addition the Number of Layers option is
also propagated to this level.

• Analysis Ply (AP): The analysis plies describe the plies used in the section definition for the Ansys
solver. A Fabric results in one Analysis Ply. A Production Ply without an Analysis Ply indicates
that the resulting Analysis Ply contains no elements and is therefore not generated.

In the example below, there are three different MP separated by one interface layer:

• ModelingPly 1: Defined with a single Fabric

• ModelingPly 2: Defined with a Stackup of two Fabrics

• ModelingPly 3: Defined with a Sublaminate containing three production plies (Stackup, Fabric,
Stackup), which results in five analysis plies.

The interface layer lies between the second and third modeling plies.

Figure 2.74: Object Tree of a Lay-Up Definition

You can easily navigate through the ply definition with a shortcut. Use the square brackets keys (
[ and ] ) to move up and down through the plies.

Modeling Plies can be reordered or moved between Modeling Groups using cut-and-paste or drag-
and-drop. See Reordering Modeling Plies, Interface Layers, and Butt Joint Sequences (p. 149) for
details.

2.1.10.2. Modeling Group Tree Object Context Menu

The context menu of Modeling Group in the top level of the object Tree contains the following
options:

• Create Modeling Group: Create a Ply Group with the default name.

• Create Imported Modeling Group: Create an Imported Ply Group with the default name.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
134 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Export to CSV file: Export all plies with all modeling ply definitions to a .csv file (see Import
from / Export to CSV File (p. 150)).

• Import from CSV file: Import plies from a .csv file (see Import from / Export to CSV File (p. 150))

Figure 2.75: Context Menu of Modeling Groups

2.1.10.3. Individual Modeling Group Context Menu

The context menu of an individual Modeling Group has these options:

• Properties: Display the Modeling Ply Properties dialog.

• Create Ply: Create and define a new ply.

• Create Interface Layer: Create and define an interface layer for fracture analysis.

• Create Butt Joint Sequence: Create and define a new butt joint sequence.

• Update: Update the model until all Modeling Plies of this group are up-to-date.

• Paste Ply or Modeling Group: Paste objects from the clipboard.

– If any Plies, Interface Layers, or Butt Joint Sequences are on the clipboard, paste them into the
selected Modeling Group.

– Otherwise, paste Modeling Groups from the clipboard after the selected Modeling Group.

See Reordering Modeling Plies, Interface Layers, and Butt Joint Sequences (p. 149) for details on
how cut-and-paste affects the Global Ply Number.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 135
Usage Reference

• Reorder Modeling Groups: Move the selected Modeling Group(s) before or after another group.
Note that the order of the Modeling Groups does not affect the stacking sequence. The stacking
sequence is based on the Global Ply Number and the Orientation of the Oriented Selection
Set (p. 128).

• Delete: Delete the selected Modeling Group.

• Export to CSV file: Export the whole Modeling Group with all modeling ply definitions to a .csv
file (see Import from / Export to CSV File (p. 150)).

• Import from CSV file: Import a Modeling Group from .csv file (see Import from / Export to CSV
File (p. 150)).

• Export Plies: Export the ply offset geometry as a .STP, .IGES, or STL file (see Export Ply Geo-
metry (p. 151)).

2.1.10.4. Modeling Ply Properties

The following properties are needed for a Modeling Ply definition:

Figure 2.76: General Information

• Name: Name of the Modeling Ply.

• Oriented Selection Sets: Defines the offset and material direction.

• Material: Modeling Ply Material (Fabric, Stackup or Sublaminate).

• Ply Angle: The design angle between the reference direction and the ply fiber direction.

• Number of Layers: Number of times the plies are generated.

• Active: Active plies are considered in an analysis, inactive plies are present but not considered.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
136 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Global Ply Nr: Defines the global ply order. Per default a new Modeling Ply is added after the
last Modeling Ply of the Modeling Group. The order of the Modeling Plies in the Modeling Groups
is equal to this value.

2.1.10.4.1. Draping
Consider the draping effects during the production process in the lay-up definition. The draping
approach can be specified in the Draping tab of the Modeling Ply Properties dialog. The follow-
ing types of draping are available:

• No Draping (default)

• Internal Draping: The draped fiber directions are determined by the internal ACP draping al-
gorithm.

• Tabular Values: Draped fiber directions are interpolated from a Look-Up Table.

The parameters for Internal Draping and Tabular Values are explained below.

Note:

Draping can also be assigned to an Oriented Selection Set (OSS) (p. 132). In this case,
the Reference Direction of the OSS is adjusted. All associated modeling plies use this
draped reference direction. This avoids running multiple draping simulations on the
same surface. If Internal Draping is applied to a modeling ply associated with a draped
OSS, then an independent draping simulation is started for the Modeling Ply.

Internal Draping

The following parameters control the Internal Draping:

• Seed Point: Starting point of the draping process.

• Draping Direction: Sets the primary draping direction for the draping scheme. The secondary
direction is always orthogonal to the primary.

– Auto Draping Direction: Uses fiber direction of the production ply.

– User-Defined Direction: Uses the defined vector.

• Default Mesh Size: Enable this property to use the default size for the draping mesh. The default
size is the average element size of the shell mesh.

• Mesh Size: A user-defined mesh size for the draping mesh can be set if Default Mesh Size is
disabled.

• Thickness Correction: The thickness of the draped ply is corrected based on the shearing (see
Thickness Correction (p. 376)).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 137
Usage Reference

Figure 2.77: Internal Draping Definition

For more information on the Draping feature, see Draping Algorithm (p. 373) and its Limita-
tions (p. 376).

Tabular Values

The tabular value draping options lets you choose the draped fiber directions from vectors in a
Look-Up Table:

• Correction Angle 1: Sets the draped fiber direction.

• Correction Angle 2: Sets the draped transverse direction.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
138 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.78: Draping with Tabular Values Definition

2.1.10.4.2. Selection Rules

Like in the definition of an Oriented Selection Set, a Modeling Ply can have one or more Selection
Rules (p. 111). The combination of all Element Sets (p. 91) and active Selection Rules (p. 111) defines
the extension of the Modeling Ply. Each rule has its own Boolean operator (intersect, add, or re-
move) which allows you to define arbitrary combinations of rules (see Boolean Operation
Types (p. 127)).

Template Rules

In addition, the Selection Rule parameters can be redefined in the Modeling Ply definition. This
prevents the same Selection Rule from being defined multiple times and allows staggering to be
defined with a single Selection Rule. In the Rules tab, activate Template as True for those selection
rules that have to be treated as template rule and set the values.

The template parameters for each selection rule type are given in the table below:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 139
Usage Reference

Rule Type Parameter 1 Parameter

2
Parallel Selection Rule Lower Limit Upper
Limit
Tube Selection Rule Outer Radius Inner
Radius
Cylindrical Selection Rule Radius -
Spherical Selection Rule Radius -
Cut-Off Selection Rule - -
Geometrical Selection Rule (Geometry) In-plane capture -
tolerance
Variable Offset Rule - -
Boolean Selection Rule - -

2.1.10.4.3. Thickness
The thickness of the ply is defined by default by the thickness of the ply material.

Figure 2.79: Thickness Definition

For Fabrics the ply thickness can also be defined by a CAD Geometry or Tabular Values. The
thickness options are:

• Type: Thickness definition method.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
140 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.80: Thickness Definition Options

– Nominal: The thickness defined in Fabrics is used for the thickness definition.

– From Geometry: CAD Geometry (p. 93) calculates the thickness. In the case of a complex
core ply, it can be helpful to work with a CAD Geometry defining the thickness distribution
of the core. ACP samples through the CAD Geometry for each element and maps the thickness.
The thickness is evaluated in the element normal direction.

Figure 2.81: Core Geometry

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 141
Usage Reference

Figure 2.82: Resulting Section Cut

– From Table: A data field evaluates the thickness. ACP inter- or extrapolates the thicknesses
for each element. One data point contains the global coordinates and the thickness values.
The values in the table can be used as absolute or relative thickness. See Look-Up
Tables (p. 103) for more information on how to define this table.

• Core Geometry: Thickness of the CAD geometry is mapped to the mesh.

• Thickness Field: Thickness is determined by mapping a value field to the mesh.

• Thickness Field Type:

– Absolute Values: Values in the Look-Up Table define the thickness.

– Relative Scaling Values: Values in the Look-Up Table are scaling factors.

• Taper Edges: adds an edge tapering to the selected Edge Set.

Core plies are commonly tapered along the boundary. The Taper Edges option allows you to
define a taper angle and a taper offset for each edge. The figure below shows a 15 degree
tapering along the edge on the left. The thickness is 0 at the selected edge and grows with
the specified angle. The Taper Edges option is intended for applying a taper angle to a single
ply, for example, a core material. When applied to multiple Modeling Plies the thickness distri-
butions of all plies are superposed. For more information, see Edge Tapering (p. 289) and
Tapering of Multiple Plies (p. 292).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
142 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.83: Edge Tapering

Figure 2.84: Taper Edge Example

By default, ACP analyzes ply tapering at the element centers. Each element is cropped from
the ply if the ply thickness at the element center is negative. This binary representation may
not be sufficiently accurate in certain cases. If the Use Nodal Thickness (p. 61) is enabled, the
ply tapering will be refined, which results in a more accurate model. For more information, see
Element- vs. Node-based Thicknesses (p. 64).

2.1.10.4.4. Modeling Ply Context Menu

The context menu for Modeling Ply has the following options:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 143
Usage Reference

Figure 2.85: Right-Click Modeling Ply Menu

• Properties: Display the Modeling Ply Properties dialog.

• Update: Updates the selected Modeling Ply.

• Active/Inactive: Activate or deactivate the selected Modeling Ply. Inactive plies are defined in
the database but not considered in the analysis.

• Create Ply Before: Create a new ply before the selected one.

• Create Ply After: Create a new ply after the selected one.

• Reorder: Move the selected Modeling Ply (or plies if several are selected) before or after another
defined ply.

• Copy: Copy the selected Modeling Plies to the clipboard.

• Paste at End: Paste Modeling Plies from the clipboard to the end of the selected Modeling
Group.

• Paste Before: Paste Modeling Plies from the clipboard before the selected ply.

• Paste After: Paste Modeling Plies from the clipboard after the selected ply.

• Delete: Delete the selected Modeling Plies.

• Export Ply (p. 151)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
144 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.10.5. Interface Layer Properties

A lay-up can also include an Interface Layer for carrying out a fracture analysis of a composite solid
model in Mechanical. The interface layer is a separation layer in the stacking sequence. It can be
used to analyze the growth of existing cracks. The crack topology is defined with an interface layer
in ACP while all other fracture settings are specified in Mechanical. The interface layers are exported
as INTER204 or INTER205 elements and can easily be used to set up a Cohesive Zone Model (CZM)
or a Virtual Crack Closure Technique (VCCT) analysis. They can also be used to define contact zones
between two layers. For more information, see Interface Delamination and Contact Debonding in
the Mechanical User's Guide.

The Interface Layer is defined by two sets of surfaces:

• The first set is the total surface of the open interface. This is the surface along which a crack can
propagate. It is defined by an Oriented Selection Set in Interface Layer Properties dialog under
the General tab.

Figure 2.86: Interface Layer Properties - General

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 145
Usage Reference

• The second set is the surface of the open interface. It is defined by an Oriented Selection Set in
Interface Layer Properties dialog under the Open Area tab.

Figure 2.87: Interface Layer Properties - Open Area

The Interface Layer can be activated or deactivated with a check box. You can also change the
global number of an Interface Layer (Global Ply Number). Interface Layers are only taken into
consideration in solid model generation and further processes. All shell based analyses ignore any
Interface Layers.

2.1.10.6. Butt Joint Sequence

The Butt Joint Sequence allows you to define butt joints between Modeling Plies. A butt joint
consists of sequences (primary and secondary plies) which specify the lay-up on both sides of a
butt joint. The Butt Joint Sequence object automatically detects where the selected plies join and
generates butt joints instead of drop-offs.

Figure 2.88: Drop-Off Elements and a Butt Joint Between Two Cores

The Butt Joint Sequence Properties window contains the following options:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
146 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Active: Active plies are considered in an analysis. Inactive plies are present but not considered.

• Global Ply Number: Defines the global ply order. By default, a new Sequence is added after the
last one in the Modeling Group. The order of the Plies in the Modeling Groups is equal to this
value.

• Primary Plies: Sequences which pass their thickness onto the other plies of a Butt Joint Sequence.
A Primary Ply can be a Modeling Ply or a Modeling Group. The Level column specifies which
sequence defines the thickness at a butt joint. The sequence with the lower level is dominant
where the other sequence inherits the thickness. Potential differences in the thickness between
the sequences are graduated over one element within the sequence with the higher level (the
transition zone in the following image). No butt-joint is created between plies with equal level.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 147
Usage Reference

• Secondary Plies: Secondary plies inherit the thickness from Primary Plies, but do not pass it
further. So, drop-offs are generated where two secondary plies join.

In most cases, you can define a Butt Joint Sequence without the use of secondary plies. An example
where secondary plies may be necessary would be a butt joint on a cylinder where you need
drop-offs:

2.1.10.6.1. Butt Joint Sequence Notes and Limitations

The following is a list of notes limitations of the Butt Joint Sequence:

• A Modeling Ply can only be used in one Butt Joint Sequence

• Butt Joint Sequences do not affect shell models. They are only considered in Section Cuts (p. 164)

• Solid model extrusion (p. 171) does not consider butt joints

• A Butt Joint Sequence can only be linked to Modeling Plies with a lower Global Ply Number.

• The butt joint can not be updated if a ply sequenced between the first and last ply of the butt
joint covers the node where the plies join, shown in the following diagram:

• Modeling groups (p. 133) may be easier to work with if a butt joint consists of a large number
of plies

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
148 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.10.7. Reordering Modeling Plies, Interface Layers, and Butt Joint Sequences
Modeling Plies, Interface Layers and Butt Joint Sequences can be reordered using cut-and-paste
(Ctrl+X, Ctrl+V) or drag-and-drop. This affects the Global Ply Number as follows:

• If you paste or drop objects onto another Modeling Ply, Interface Layer, or Butt Joint Sequence,
they are inserted after the selected target. Global Ply Numbers after the target are automatically
updated, so the list remains sequential. Conflicting Global Ply Numbers of other plies are also
renumbered automatically.

• If the objects are pasted or dropped onto a Modeling Group, they retain their original Global Ply
Number.

2.1.10.8. Production Ply

The context menu of the Production Ply has the following options:

Figure 2.89: Production Ply Context Menu

• Properties: Display the Production Ply Properties dialog. These properties cannot be edited,
but can be viewed or printed for informational purposes.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 149
Usage Reference

• Export Flat Wrap: Export the flat wrap as a .DXF, .IGES, or .STP file for production or design.
The draping option must be activated to obtain a flat wrap. Refer to Draping (p. 298) for more
information on draping and flat wrap.

• Export Ply (p. 151)

2.1.10.9. Analysis Ply

The context menu of the Analysis Ply has the following options:

Figure 2.90: Analysis Ply Context Menu

• Properties: Display the Analysis Ply Properties dialog. These properties cannot be edited, but
can be viewed or printed for informational purposes.

• Export Ply (p. 151)

2.1.10.10. Import from / Export to CSV File

The CSV interface allows you to create a comma separated value file to be edited in a spreadsheet
program such as Excel or OpenOffice. This can be efficient if you wish to edit the parameters of
many plies.

For additional information on the format, see CSV Format (p. 277).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
150 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.10.10.1. Export
All the information are exported to a .csv file. This file can be used to give the lay-up information
back to a CAD System or can be modified and imported.

2.1.10.10.2. Import
The modified .csv file can be imported. There are three different import options to handle the
update of the lay-up:

• Update Lay-up: During the import operation, definitions are updated, additional plies are
generated and deleted according to the .csv file.

• Update Properties Only: During the import operation, definitions are updated with
properties given.

• Recreate Lay-up: During the import operation, existing lay-up is deleted and generated
from scratch.

Figure 2.91: CSV Import with Update Options

2.1.10.11. Export Ply Geometry

You can export the ply geometry and fiber directions o a CAD file format. Using this feature, you
can check geometry clashes in CAD assemblies. Other uses may include using the data for CNC
programming or for the projection of orientation vectors of the fibers onto tooling surfaces. It is
possible to export the surfaces or boundaries with an offset. This gives you full control over surfaces
to be exported.

The Export Ply Geometry feature has the following settings:

• Format: The geometry file format (STEP, IGES or STL). The STL format only supports the ply sur-
faces. Directions and boundaries can only be exported in the STEP or IGES format.

• Path: Specify the file name and file path.

• Ply Level (only available for Export Ply Geometry at Modeling Group level):

– Modeling Ply Wise: Every Modeling Ply is exported.

– Production Ply Wise: Every Production Ply is exported.

– Analysis Ply Wise: Every Analysis Ply is exported.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 151
Usage Reference

• Offset Type:

– No Offset: Ply geometry is exported with no offset to the reference surface (Oriented Selection
Set).

– Bottom Offset: Bottom surface of the ply relative to the direction of the reference surface is
exported.

– Middle Offset: Middle surface of the ply is exported. (default)

– Top Offset: Top surface of the ply relative to the direction of the reference surface is exported.

• Export Ply Surface: Ply surface is exported as a shell surface.

• Export Ply Contour: Outlining contour of the ply surface is exported as perimeter lines.

• Export Fiber Directions: Fiber orientations are exported as orientation vectors.

– Export Draped Fiber Direction: Include the draped fiber direction (the fiber direction is included
if draping is not enabled).

– Export Draped Transverse Direction: Include the draped transverse direction (the transverse
direction is included if draping is not enabled).

– Arrow Type: Choose between No Arrow (line without an arrowhead), Standard Arrow and
Half Arrow.

– Arrow Length: Specify the arrow length.

Figure 2.92: Export Ply Geometry Window

2.1.11. Imported Modeling Group

Imported Modeling Groups organize plies which are independent of the shell reference surface. Im-
ported Modeling Groups and the attached Imported Plies do not contribute to the standard lay-up

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
152 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

that is defined by the Modeling Plies applied to a shell reference surface. The table below, Table 2.1: Key
Differences Between a Modeling Ply and Imported Modeling Ply (p. 154), lists the major differences
when compared to a Standard Modeling Ply (p. 136).

The structure of the Imported Modeling Group follows the pattern of the standard Modeling Group
and is described in the section above, Modeling Group Structure (p. 133). The equivalent to Modeling
Ply, Production Ply and Analysis Ply are Imported Modeling Ply, Imported Production Ply and Imported
Analysis Ply, respectively.

An example workflow is available in Chapter 4: 3D Ply Workflow - Imported Plies (p. 361).

2.1.11.1. Tree Object Context Menu

The context menu of the Imported Modeling Group contains the following options:

• Properties: Show the dialog window.

• Update: Update the model until all Imported Modeling Plies of this group are up to date.

• Create Imported Ply: Add a new Imported Modeling Ply.

• Paste: Create a new Imported Modeling Ply by copying the object on the clipboard.

• Delete: Remove all attached Imported Modeling Plies. Then remove the group object itself.

2.1.11.2. Imported Modeling Ply

An Imported Modeling Ply represents a single ply with a 3D surface mesh which is independent of
the reference surface. This allows you to model thick and/or complex 3D laminates in ACP based
on separate ply geometries. The Imported Modeling Ply can be used in combination with an Imported
Solid Model (lay-up mapping). The section 3D Ply Workflow - Imported Plies (p. 361) in chapter four
provides a sample workflow and instructions on how to work with Imported Plies.

The table below lists the key differences between a standard Modeling Ply and an Imported Mod-
eling Ply:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 153
Usage Reference

Table 2.1: Key Differences Between a Modeling Ply and Imported Modeling Ply

Modeling Ply Imported Modeling Ply

Mesh and Scoped to the shell reference Holds its own imported mesh (surface)
Extension surface that is independent of the reference
surface
Orientation The lay-up orientation is defined The orientation is defined by the element
by Oriented Selection Sets normals of the imported mesh and the
offset type (bottom, middle, or top)
Reference The reference directions of the ply Supports the same features as an
Direction are defined by Oriented Selection Oriented Selection Set, but the definition
Sets is part of the Imported Modeling Ply
object
Material Supports Fabrics, Stackups and Supports Fabrics only
Sub-Laminates
Shell Model / Contributes to the shell lay-up Is ignored in any shell analysis
Analysis
Solid Model Considered in the standard Solid The standard solid model extrusion
Extrusion Model feature ignores imported plies
Imported Solid Considered in the lay-up mapping Considered in the lay-up mapping of the
Model / Lay-Up of the Imported Solid Model if the Imported Solid Model if the scope is set
Mapping scope is set to Element Sets to Use Imported Plies

The context menu of an Imported Modeling Ply contains these actions:

• Properties: Display the ply properties dialog.

• Update: Update the model until this ply is up-to-date.

• Active/Inactive: Choose whether an Imported Ply is active or suppressed in all subsequent ana-
lyses.

• Copy: Copy into the clipboard.

• Paste: Create a new Imported Modeling Ply by copying the object in the clipboard.

• Delete: Delete the selected ply.

2.1.11.2.1. Imported Modeling Ply Properties

Standard features in ACP are used to define the thickness distribution, reference and fiber direc-
tions. An Imported Modeling Ply contains the properties listed below. Since the meaning is often
identical if compared with an Oriented Selection Set or Modeling Ply, it is classified with the same
wording.

General Properties

Refer to the figure below, General Properties Options.

• Offset: Determines if the surface mesh defines the bottom, mid or top surface of the ply.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
154 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Mesh Input: Indicates whether the mesh was imported from a HDF5 Composite CAE or from
a CAD geometry. This is automatically set by the application based on the input source and is
therefore read-only.

• CAD Surface: If the Mesh Input is From Geometry, then the selected Virtual Geometry defines
the surface of the ply.

• Selection Method: Defines the mapping algorithm for the Rosettes if more than one Rosette
is used. For more information, see Reference Direction in the section above, Oriented Selection
Sets (p. 128).

• Rosettes: Select which method one or more Rosettes (p. 99) will define the Reference Direction
for each element.

• Reference Direction Field: Defines the direction column of a 3D Look-Up Table. Only applicable
to the tabular values method.

• Ply Material: Select the Fabric that defines the material of the ply and nominal thickness.

• Ply Angle: Set the design angle between the reference direction and the ply fiber direction.

Figure 2.93: General Properties Options

Draping Properties

Refer to the figure below, Draping Properties Options.

• Type: Specifies the type of draping

– No draping: Constant thickness defined by the Fabric

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 155
Usage Reference

– Tabular values: Variable thickness by mapping a LookUp Table field

• Correction Angle 1: Sets the draped fiber direction

• Correction Angle 2: Sets the draped transverse direction

Figure 2.94: Draping Properties Options

Thickness Properties

Refer to the figure below, Thickness Properties Options.

• Type: Thickness definition method

– Nominal: The thickness defined in Fabrics is used for the thickness definition.

– From Table: A data field evaluates the thickness. ACP interpolates or extrapolates the
thicknesses for each element.

• Thickness Field: Thickness is determined by mapping the selected LookUp Table Column to
the mesh.

• Thickness Field Type:

– Absolute Values: Values in the Look-Up Table define the thickness.

– Relative Scaling Values: Values in the Look-Up Table are scaling factors.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
156 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.95: Thickness Properties Options

Limitations

• StackUps and Sublaminates are not supported as ply material.

• The ACP model always needs a reference surface, even if it is not relevant in the lay-up mapping
(Imported Solid Model) workflow in combination with Imported Plies.

• The CAD geometry must be a surface. Solid geometries are not supported.

• Export Composite Definitions to ACP File … does not support Imported Ply objects

• The Excel Interface cannot be used in combination with Imported Plies.

• The features Sensor and Ply Book do not take Imported Plies into account.

• The variable material workflow is not supported. That includes the field definitions and mater-
ial plots.

• The HDF5 Composite CAE Export does not support Imported Plies.

2.1.11.3. Imported Production Ply

An Imported Production Ply is the output of an Imported Modeling Ply update. The context menu
contains the following option:

Properties: Display the Imported Production Ply Properties dialog. These properties cannot be
edited but can be viewed or printed for informational purposes.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 157
Usage Reference

Figure 2.96: Imported Production Ply Dialog

2.1.11.4. Imported Analysis Ply

An Imported Analysis Ply is the result of an Imported Modeling Ply update. The context menu
contains the following option:

Properties: Display the Imported Analysis Ply Properties dialog. These properties cannot be
edited, but can be viewed or printed for informational purposes.

Figure 2.97: Imported Analysis Ply

2.1.12. Field Definitions

During the Variable Material Data (p. 319) workflow, you can define the variation of the scalar variables
controlling the local state of the material properties over the finite element model using Field Defin-
ition objects. You can scope Field Definition objects to Element Sets, Oriented Selection Sets, and
Modeling Plies.

If your field definition is based on Elements Sets or Oriented Selection Sets, all of the layers within
your scoping are affected. When scoping to Modeling Plies, only the associated Analysis Plies are af-
fected. Therefore, it is possible implement both a “layer-wise” as well as a “element-wise” application
of field definitions in your finite element model. Parts of the finite element model not covered by
Field Definition Objects assume default values of the field variables.

In order to understand the effect of a Field Definition Object, contour plots of the field variables are
available Field Definition Plot (p. 219) topic of the Lay-Up Plots (p. 210) section.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
158 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.98: Field Definitions Context Menu

As illustrated below, once you create a Field Definition object, you use the context menu to define
its features. Menu options include:

• Properties: Display the properties window of the selected Field Definition.

• Update: Update the selected Field Definition.

• Active/Inactive: Toggle field definition object active or inactive

• Copy: Copy the selected Field Definition to the clipboard.

• Paste: Paste a table Field Definition from the clipboard.

• Delete: Delete the selected Field Definition.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 159
Usage Reference

Figure 2.99: Field Definition Context Menu

Field Definition Object Properties

Field Definition objects can be used for element-wise and layer-wise specification of the variation of
a scalar variable controlling Variable Material Data on subparts of your finite element model. You can
scope layer-wise specifications to specific Modeling Plies. The properties dialog is illustrated below.
Properties include:

• Name: Name of the Field Definition. This field is initially populated with an default name.

• Active: This selection indicates that the application processes the Field Definitions during your
analysis. Inactive definitions are ignored.

• Field Variable Name: This drop-down menu provides a list of available Field Variables as
defined in the Engineering Data Workspace. Note that the Temperature and Shear Angle field
variables are not available for Field Definitions. Temperature is defined externally to ACP, and
the Shear Angle is defined via draping calculations.

• Scope Entities: Entry field to define the applicable element-wise field definitions. You can use
a combination of Element Sets and Oriented Selection Sets in order to scope the definition to
subparts of your model. For layer-wise field definitions, you can use a combination of Modeling
Plies to scope the definition to subparts of your model; the Field Definition will only be applied
to Analysis Plies attached to the Modeling Plies.

• Look-Up Table Column: Select the scalar Look-Up Table column from which the state of the
field variable is interpolated from.

• Include Shell Offset: Specify whether or not to include the shell offset of each analysis ply
for the interpolation process. The default is to interpolate the state of the field variables at the

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
160 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

shell element centroid. For solid elements, the actual position of each analysis ply is automat-
ically considered and this behavior cannot be changed.

Figure 2.100: Field Definition Object Properties

Element-Wise Field Definition Layer-Wise Field Definition

2.1.13. Sampling Points

Sampling Points can be used in postprocessing mode to access to ply-wise results. In addition, the
Sampling Point functionality provides Lay-Up Plots, through-the-thickness postprocessing plots, and
laminate engineering constants.

ACP samples through the element near the given coordinates. After the update all plies (Modeling
Ply, Production Ply, and Analysis Ply) are listed and can be selected for postprocessing. In the General
tab of the Sampling Point Properties dialog the sampling point and direction can be defined.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 161
Usage Reference

Figure 2.101: Sampling Point Properties - General Tab

• Sampling Point: The sampling point in global coordinates. The nearest element to the point is the
sample.

• Sampling Direction: Normal direction of the sampling point. The ply sequence will be given in
this direction.

• Element ID (Label): Element number closest to the defined sampling point. (informational only)

A detailed description of the options Offset is Middle and Consider Coupling Effect can be found
in Analysis Options (p. 413).Use the [and] buttons to navigate easily through the ply definition.

The Analysis tab of the Sampling Point Properties dialog provides extended postprocessing func-
tionality. The lay-up can be visualized and analyzed by evaluating the polar properties and equivalent
laminate stiffnesses based on the classical laminate theory. The 2D plots show the distributions of
the postprocessing results (strains, stresses, and failure criteria). To view postprocessing results, you
must select the solution and the set of interest.

The lay-up visualization can be set to display Modeling, Production, and Analysis Plies present in the
Sampling Point. The Material, Thickness, and Angle can be displayed additionally as text labels for
every ply in the plot. The angle displayed for Modeling and Production Plies always matches the
design angle in the Modeling Ply and Material definitions. Note that the angle for the Analysis Ply is
always given in relation to the reference direction of the Sampling Point. This reference direction is
indicated by a yellow arrow at the Sampling Point in the Scene. You can change the reference direction
in the General tab if desired.

Note:

Classical Laminate Theory is described in Classical Laminate Theory (p. 408).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
162 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.102: Lay-Up Sequence and Enhanced Postprocessing

Note:

Stresses and strains shown in the 2D plot are the values at the element center (interpolated)
at the top and bottom of the layer. The 2D failure plot shows the worst IRF, RF, or MoS
factor of all failure criteria from among all the failure modes evaluated and among all
evaluation points (nodal results).

The Python script below shows how to extract the nodal result in ACP for a certain element and
Analysis Ply. When adapting it for your own project, modify the name of the objects such as Solution
and Ply.

Python script to extract nodal stresses

model = db.active_model
# Select a solution and ensure that it was loaded
solution = model.solutions['Solution.1']
solution.update()

# Select the ANALYSIS PLY of interest

ap = model.modeling_groups["Hull"].plies['core_bwl'].production_plies['ProductionPly.9'].analysis_plies['P1L1__cor

# Select the critical element (also see Element ID in the general tab of the dialog of Sampling Point)
element_label = 3507
model.select_elements(selection='sel0', op='new', labels=[3507])

# Initialize the result data

results = {}
max_stress_values = {"s13": 0.0,
"s23": 0.0
}

# Loop over stress component and spots and collect the data and store the maximum values.
for comp in ["s13", "s23"]:
results[comp] = {}
for spot in ["bot", "mid", "top"]:
res = solution.query(definition='stresses',
position='integration_point',
component=comp,
selection='sel0',
entity=ap,
spot=spot)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 163
Usage Reference

results[comp][spot] = res
max_v = max([abs(v) for v in res])
if max_v > max_stress_values[comp]:
max_stress_values[comp] = max_v

print(max_stress_values)

2.1.14. Section Cuts

Section Cuts enable a visual verification of the lay-up definition on an arbitrary section plane through
the model. The lay-up definition at the Section Cut can be exported to Mechanical APDL or BE-
CAS (p. 279).

The Section Cut Properties dialog contains the following options:

Figure 2.103: General Section Cut Properties

• Name: Name of the Section Cut.

• Active: Set to false to suppress the computation of the Section Cut.

• Interactive Plane: If active, modify the section plane directly in the Scene. If inactive, the following
options are required:

– Origin: Origin of the section plane.

– Normal: Normal direction of the section plane.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
164 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

– Reference Direction 1: First in-plane reference direction (in-plane transverse direction). The
normal and this direction define the coordinate system of the section cut. It is used to compute
the section cut measures and to export the surface section cut.

• Show Plane: Plot the section plane.

• Entire Model: If active, the Section Cut applies to all shell elements in the model. Otherwise, only
the selected Element Sets are considered.

• Element Sets: List of Element Sets to which the Section Cut is scoped.

• Type: Mode of extrusion (p. 166).

• Scale Factor: Scale the offsets of all plies.

• Core Scale Factor: Thickness of the core plies are scaled by this factor.

• Section Cut Type: Select which ply type is plotted:

– Modeling Ply Wise: Modeling Plies are plotted.

– Production Ply Wise: Production Plies are plotted.

– Analysis Ply Wise: Analysis plies are plotted.

Figure 2.104: Wire Frame Options

• Interaction Type: Define the intersection of the section plane and the model:

– Normal to Surface: Plies are plotted as normal to the intersected elements.

– In Plane: Plies are plotted in the section plane.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 165
Usage Reference

Figure 2.105: Surface Options

• Use Default Tolerance: Use the default tolerance (0.1% of the average element size). If unselected,
you should specify the Tolerance:

– Tolerance: Defines the minimum length of the line segments in a Section Cut. Segments
shorter than the tolerance are merged. Small segments can occur if a Section Cut crosses
an element corner as shown below. In some cases, the Section Cut can be relocated to avoid
small segments.

Figure 2.106: Section Cut Crossing an Element Corner

Sweep based extrusion:

• Use Default Interpolation Settings: Use default interpolation settings. If unselected, you must
specify Search Radius and Number of Interpolation Points. For more information, see 3D
Look-Up Table (p. 108).

2.1.14.1. Types of Extrusion

The following extrusion types are available:

• Wire Frame: This type can be used to investigate the lay-up of shell elements. The mid-
surface of the plies are represented by lines, as shown below.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
166 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Surface Section Cut: For this type, the plies are shown as surface elements. A surface Section
Cut generates a continuous mesh w can be used for 2D analyses. Therefore, Drop-Off elements
are generated by default at the ply boundaries (like the solid model extrusion). If this does
not represent the real structural behavior, then you can use the Butt Joint Sequence (p. 146)
to control the connectivity of the adjacent plies and Drop-Off behavior. The surface Section
Cut supports two types of extrusion:

– Surface Normal: The extrusion follows the element normals of the reference surface.
The offset direction does not change during the extrusion.

– Surface Sweep Based: The offset direction follows the interpolated element normals
(potential field defined by the shell normals). The interpolation is based on a Look-
Up Table (p. 103) that specifies the Search Radius and Number of Interpolation Points.

In general, the sweep-based algorithm is more robust in sharp corners with thick
laminates; however, the extrusion of t-joints may be less accurate. The sharp corner
in Figure 2.99 illustrates the difference between the extrusion algorithms.

• Surface Normal: The plies are illustrated by surface elements. The extrusion follows the
element normals.

• Surface Sweep Based: The plies are shown as surface elements. The offset direction follows
the interpolated element normals (potential field defined by the shell normals).

Figure 2.107: Element Normals

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 167
Usage Reference

The interpolation is based on a Look-Up Table (p. 108) which specifies the Search Radius
and Number of Interpolation Points.

Figure 2.108: Surface Normal vs. Surface Sweep Based Extrusion

Section Cuts can also be used to plot ply-wise properties such as angles (p. 210). For more information,
see Lay-Up Plots (p. 210).

Figure 2.109: Ply-Wise Angles on the Surface Section Cut

2.1.14.2. Section Cut Notes

• The line segments are locally enlarged (if necessary) to improve the quality of the surface elements.

• Plies covering more than 3 components cannot be extruded (see figure below):

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
168 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.110: Supported Lay-up for T-Joints

2.1.14.3. Section Cut Export

The Section Cut can be exported in two formats:

Figure 2.111: Export Surface Section Cut Options

• The becas.in format includes the 2D mesh, material properties, and element orientations.

• The mapdl.cdb format supports only the 2D mesh and the named selections (top and bottom
node sets derived from the Element Sets of the shell mesh). This can be useful to fill the Section
Cut with a core material (for example).

2.1.15. Sensors
A Sensor provides the evaluation of global results like price, weight, or area. Results can be evaluated
for specific parts, materials or plies.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 169
Usage Reference

Figure 2.112: Sensor Properties

The Sensor Properties dialog contains the following options:

• Name: Name of the Sensor.

• Active: Set to false to suppress the Sensor computations.

• Sensor Type: Define the evaluation type.

– Sensor by Area: Select one or several Element Sets or Oriented Selection Sets.

– Sensor by Material: Select Fabric(s), Stackup(s) and/or Sublaminates. If a Fabric is selected, the
plies in the Sublaminates are also considered in the evaluation; plies in a Stackup are not.

– Sensor by Modeling Ply: Select one or more plies.

– Sensor by Solid Model: Select one or more solid models. For a solid model sensor type, only
weight and center of gravity are computed.

• Entities: Select the corresponding entities by clicking them in the Tree.

• Measure: Display results of different quantities.

– Weight: Mass of the selected entity.

– Covered Area: Surface area of a selected Element Set, Oriented Selection Set, or tooling surface
area that is covered by the composite lay-up of the selected Material or Modeling Ply.

– Modeling Ply Area: Surface area of all Modeling Plies of the selected entity.

– Production Ply Area: Surface area of all Production Plies of the selected entity.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
170 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

– Price: Price for the composite lay-up of the selected entity. The price per area is set under Ma-
terial Data > Fabrics or Material Data > Stackups.

– Center of Gravity: Center of gravity of the selected entity in the global coordinate system.

2.1.16. Solid Models

Topics in this section:
2.1.16.1. Solid Model
2.1.16.2. Imported Solid Model

ACP knows two different types of solid models: the first type is simply called Solid Model and is based
on an extrusion algorithm that generates a volume mesh from the shell mesh and its Composite
Definitions. The second type is named Imported Solid Model and maps the Composite Definitions
onto an external (imported) solid mesh.

Because of its geometrical limitations, you can only use the standard Solid Model for simple to mod-
erately complex lay-up models and shapes. You can customize the extrusion of the lay-up using Ex-
trusion Guides, Snap-To Geometries, and Cut-Off Geometries. Still, the extrusion can result in highly
distorted layered solid elements if the shell reference surface is highly curved and the laminate is
thick.

The Imported Solid Model is a good alternative because the solid mesh is generated independently
of the lay-up. The solid mesh is loaded in ACP, and the lay-up (Composite Definitions) from ACP is
mapped onto the external solid mesh. With the Imported Solid Model, you can choose to map the
lay-up using layered or reinforcing elements. The latter eases the solid mesh constraints since it enables
the use of any solid element type (brick, tetra, etc.). Meanwhile, layered elements require a solid mesh
with brick or prism elements.

Figure 2.113: Solid Model Folder with a Standard Solid Model and an Imported Solid Model

The context menu of the Solid Models object contains these actions:

• Create Solid Model: creates a new solid model object

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 171
Usage Reference

• Paste: adds a new solid model object from the clipboard

Note:

The Imported Solid Models can only be created via the Workbench Project Schematic. See
the Solid Modeling (p. 47) workflow section.

2.1.16.1. Solid Model

The Solid Model feature creates a layered solid element model from a composite shell model. The
solid element model can be integrated into a Workbench workflow or exported for use outside of
Workbench. Analysis of a Composite Solid Model (p. 331) explains the Solid Model workflow in
Workbench, and Guide to Solid Modeling (p. 303) provides general information on solid modeling.

The settings for the solid model generation are adjusted under the Solid Model context menu item
Properties. The Solid Model Properties (p. 173) dialog covers what Element Sets are extruded, the
extrusion method, Drop-Off elements handling and numbering offsets, among other things.

You can use Extrusion Guides, Snap-To, and Cut-Off Geometries to shape the Solid Model as desired.
They are specified in the respective subfolders in the Solid Model Tree View. The Analysis Plies
sub-folder shows which plies are incorporated in the Solid Model. The sub-folder Mesh Components
contains internal Element Sets which are created during the extrusion.

Figure 2.114: Solid Model Feature in the Tree View

Subtopics:
2.1.16.1.1. Properties
2.1.16.1.2. Export Solid Model
2.1.16.1.3. Extrusion Guides
2.1.16.1.4. Snap-To Geometry
2.1.16.1.5. Cut-Off Geometry

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
172 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.16.1.6. Mesh Components

2.1.16.1.7. Material Handling for Different Extrusion Methods
2.1.16.1.8. Save & Reload Solid Models
2.1.16.1.9. Node-based Thicknesses

2.1.16.1.1. Properties
The Solid Model Properties dialog is divided into the following tabs:
2.1.16.1.1.1. General
2.1.16.1.1.2. Drop-Offs
2.1.16.1.1.3. Export

2.1.16.1.1.1. General

The General tab has the following properties:

Figure 2.115: Solid Model Properties - General

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 173
Usage Reference

Element Sets

Starting with a shell model and the lay-up definition, the shell elements are extruded to a
layered solid element model. Select an Element Set to define the region of the extrusion.

Important:

The mid-offset option of Element Sets is not supported for Solid Model extrusion.
The ply definition must be defined without this option to obtain the correct
solid model position.

Extrusion Properties

The lay-up extrusion can be organized in different ways to merge plies with different criteria:

• Extrusion Method:

– Analysis Ply Wise: Extrude each Analysis Ply as one solid element layer.

– Material Wise: All sequential plies containing the same material are grouped in one
solid element layer. A maximum element thickness can be specified that will subdivide
the single element layers if necessary.

– Modeling Ply Wise: Extrude each Modeling Ply as one solid element layer (for example,
every Stackup or Sublaminate is extruded as one solid element layer).

– Monolithic: Extrude the whole lay-up in one solid element layer.

– Production Ply Wise: Extrude each Production Ply as one solid element layer if possible.
Depending on the model topology, monolithic Modeling Groups may be split in order
to ensure the cohesion of the resulting solid model.

– Specify Thickness: Plies are grouped by iterating through the laminate from the inside
out..

– User Defined: Plies are grouped by iterating through the laminate from the inside
out.

– Sandwich Wise: Plies on either side of a core material are grouped into single element
layers. The core material is extruded as one element layer.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
174 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.116: Illustration of Solid Model Extrusion Methods

For extrusion methods other than analysis ply-wise, see Material Handling for Different
Extrusion Methods (p. 195).

• Max Element Thickness: Thickness at which a new Modeling Group will be introduced.
If a single ply is thicker than this value it is split into layers of equal thickness no thicker
than this value.

• Start Ply Groups at: A new Modeling Group is introduced each time the iteration meets
one of the plies specified in this option (User Defined Extrusion Method only)

• Offset Direction: With the Surface Normal option, the extrusion direction is re-evaluated
after each row of solid elements. With Shell Normal option, the extrusion direction stays
defined as shell normal.

Figure 2.117: Extrusion Direction

An example of both options is shown in the following figure:

Figure 2.118: Offset Direction

Solid Model with Surface Normal Direction

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 175
Usage Reference

Solid Model with Shell Normal Direction

Drop-Offs and Cut-Offs

The Drop-Offs and Cut-Offs section controls the global material handling for Drop-Off and
Cut-Off elements in the solid model. The following options are available:

• Global Drop-Off Material: This setting is used when the material handling settings for
fabrics and stackups are set to Global.

• Global Cut-Off Material: This setting is used when the material handling settings for
fabrics and stackups are set to Global.

Element Quality

ACP performs shape checks during the solid model generation. The checks are similar to
Element Shape Testing in Mechanical APDL, and bad elements are deleted if they fail the
check. You can adjust some of the limits and tolerances:

• Delete Bad Elements: When enabled, ACP will perform shape checks. Disable this option
to suppress the shape checks.

• Warping Limit: Solid elements with a warping factor above this limit are removed from
the solid model. The default value is 0.4. Twisting the top face of a unit cube by 22.5°
and 45° relative to the base produces warping factors of about 0.2 and 0.4, respectively.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
176 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Minimum Volume: Elements with a volume equal to or smaller than this limit are deleted.
The default value is 0 so only elements with a negative or zero volume are removed.
You can adjust this parameter accordingly should the solver produce error messages
about small elements with a volume close to zero. For instance, the Mechanical APDL
solver logs this error: *** ERROR *** Zero volume in element...

2.1.16.1.1.2. Drop-Offs

The Drop-Offs Tab has the following properties:

Figure 2.119: Solid Model Properties - Drop-Offs

• Drop-Off Method: Define the ply's Drop-Off before or after the edge.

• Disable Drop-Offs on Top Surface: Deactivates Drop-Off elements on the top face sheet of
the laminate for the selected (oriented) Element Sets.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 177
Usage Reference

• Disable Drop-Offs on Bottom Surface: Deactivates Drop-Off elements on the bottom face
sheet of the laminate for the selected (oriented) Element Sets.

Figure 2.120: Disable Drop-Offs

Disable Drop-Offs option deactivated

Disable Drop-Offs option activated

• Connect Butt-Joined Plies: If a composite layer ends away from a mesh boundary, it tails
off with a Drop-Off Element. These Drop-Off elements are degenerated brick elements that
are reduced from bricks into prisms. This option can prevent an element Drop-Off of two
adjacent, sequential plies in the same modeling group. By default, it is active.

The feature is limited to plies that appear sequentially in the same Modeling Group. It is not
possible to connect all butt-jointed plies that are arranged in a circle. This is a known limita-
tion.

An example of a sandwich structure with divided core material is shown below to demonstrate
the use of a ply connection.

Figure 2.121: Connect Butt-Jointed Plies

Connect Butt-Joined Plies activated

Connect Butt-Joined Plies deactivated

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
178 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.16.1.1.3. Export

The Export Tab has the following properties:

Figure 2.122: Solid Model Properties - Export

Global Options

• Write Degenerated Elements: Include Drop-Off elements and Cut-Off elements in the
solid model export. Deactivating this option can lead to holes in the mesh and prevent
import into Mechanical. Deactivating this option is not advised during a Workbench
workflow.

Figure 2.123: Write Degenerated Elements

Export with Drop-Off Elements

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 179
Usage Reference

Export without Drop-Off Elements

• Use SOLSH Elements: Create the model with Solid-Shell elements (SOLSH190).

• Drop Hanging Nodes: Remove hanging nodes from model before solve (default on).

Hanging nodes are not connected to all the neighboring elements. Hanging nodes can
occur when quadratic hexahedral, tetrahedral, and prism elements are connected together.
Hanging nodes can lead to discontinuous deformation fields and are therefore not desir-
able. When this option is active, element edges containing a hanging node are described
as a linear shape function. The following figure shows a quadratic tetrahedral element
on top of a quadratic hexahedra element. There is a hanging node on the tet element,
highlighted by the red square:

Figure 2.124: Quadratic Tetrahedral Element on Top of a Hexahedral Element

• Use Solid Model Prefix: This option makes element components begin with the name
of the defined solid model. For example, if the solid model is BULKHEAD, the elements
are grouped into components in the following way:

CMBLOCK,BULKHEAD_P9L1_Plies_Top,ELEM, 600! users element compon-

ent definition

Transferred Sets

• Transfer All Sets: All Edge and Element Sets are transferred.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
180 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Transferred Element Sets: Specify Element Sets for transfer. Element Sets become two
separate element components with the designation _TOP and _BOT. One element
component coincided with the original Element Set and the other one lies at the end of
the extrusion path.

• Transferred Edge Sets: Specify Edge Sets for transfer. Edge Sets are extruded to form
surfaces (an Edge Set transfers to a surface element component).

Figure 2.125: Transferred Element Sets in Mechanical

Numbering Offset

ACP automatically performs entity numbering within your Workbench project. To avoid
overlap, entities of multiple solid models in one ACP setup are automatically renumbered.
When different ACP or Mechanical models are combined in a single analysis system, there
is also automatic renumbering.

The automatic renumbering is activated by default and can be deactivated in the properties
of the downstream Mechanical Model cell (see Renumber Mesh Nodes and Elements
Automatically).

The entity numbering offset can also be controlled manually. Deactivate the Default option
to define the offset manually for each of the entities (elements, nodes, materials, sections,
coordinate systems). The numbering starts at the defined index and is incremented by one
at a time.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 181
Usage Reference

Figure 2.126: Properties of the ACP-Pre Setup Cell in the Project Schematic

2.1.16.1.2. Export Solid Model

The context menu of Solid Model and Imported Solid Model enables you to export the solid
mesh itself or the skin (envelope) of the mesh in different formats.

You can export the skin of the solid model as STEP, IGES, STL, or Mechanical APDL (CDB). These
representations can be used, for instance, to construct the geometry of adjacent structures to

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
182 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

the solid model or to construct the geometry of filling material in an airfoil structure. Note that
the STEP and IGES geometries are built from a mesh based tessellation of the skin. Therefore, it
might be worth to work with the STL format and the usage of reverse engineering tools (for in-
stance in SpaceClaim) to construct a proper geometrical representation. The CDB format brings
the benefit that you work without a geometry.

The analysis solid model itself can be exported as a CDB file. Element shape checking is deactivated
in the exported file. Check that the material properties are consistent with the mesh units of the
CDB file.

Midside Nodes: If available and active, the tessellation of the mesh includes the midside nodes
of the quadratic elements. If not, only the corner nodes are considered. This option is only available
for the formats skin:stp, skin:igs and skin:stl.

2.1.16.1.3. Extrusion Guides

Solid Model generation for curved geometries and thick lay-ups can lead to boundary edges
which are extruded in undesirable directions. For example, the extrusion of a dome with a hole
at the top results in a solid model with a hole that is not cylindrical. The Extrusion Guide feature
allows you to control the extrusion direction of the edges in order to rectify this. The edge of the
hole can be used as an Extrusion Guide in the vertical direction to create a cylindrical hole.

Figure 2.127: Extrusion with and without an Edge Set Guide

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 183
Usage Reference

Multiple Extrusion Guides can be used for one Solid Model. The extrusion itself is controlled with
an edge set and a direction vector or with a geometry. The Extrusion Guide feature also contains
a Curvature Control. The Extrusion Guide Properties dialog has the following options:

Figure 2.128: Extrusion Guide Properties

• Edge Set: Define the Edge Set along which the Extrusion Guide acts.

• Type: The type of Extrusion Guide.

– Direction: Defines a direction vector of the extrusion direction of the Edge Set.

→ Orientation Direction: By default, the normal direction of the Edge Set is calculated and
defined when an Edge Set is selected. It can also be entered manually.

– Geometry: CAD file of a boundary surface is used to define the extrusion path.

→ CAD Geometry: Select a previously generated Virtual Geometry (p. 97). See CAD Geomet-
ries (p. 95) for information on how working with geometries impacts system performance.

– Free: No extrusion path is defined but a curvature correction can be activated independently.

• Radius: Controls the sphere of influence for mesh morphing.

• Depth: controls the bias of the mesh morphing.

• Use Curvature Correction: Apply a curvature correction during the solid model extrusion
which results in a smoother extruded surface. Under certain circumstances, deactivating
curvature correction can lead to better extrusion results.

Extrusion Guides are excuted in the order they appear in the Tree. This has significant effects
when Extrusion Guides intersect. You can change the order of Extrusion Guides from the Tree
View, in one of the follows ways:

• Use the cut-and-paste options in the context menu.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
184 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Use the cut (Ctrl+X) and paste (Ctrl+V) hotkeys.

• Use the mouse to drag-and-drop the Extrusion Guides.

• Use the Reorder option in the context menu, as shown below.

Figure 2.129: Reordering Extrusion Guides

2.1.16.1.3.1. Mesh Morphing

The generation of a solid model is by extrusion of a shell mesh. By default, extrusion is in the
direction of the shell normal direction. The 2D shell mesh is used as a base for the 3D solid
element mesh, which can have one or more element layers depending on the ply thickness
and extrusion method.

The Extrusion Guide only affects the extrusion of the element edges that are part of the guided
Edge Set. It is either defined by an Edge Set and direction vector or by an Edge Set and a CAD
geometry. While the CAD geometry already is a surface, the Edge Set and direction vector helps
define a surface. In both cases, these surfaces serve as target surfaces in the extrusion.

The guided edge is initially extruded in the normal direction. Then, the nodes on the resulting
free surface are moved to coincide with the target surface of the Extrusion Guide.

Mesh morphing is a way to control the propagation of the Extrusion Guide effect through the
entire mesh.

Mesh morphing is governed by the morphing law, shown in Equation 2.1 (p. 186). It relates the
displacement of internal nodes to the displacement of a node of the guided free surface. Mesh
morphing can be controlled with the two parameters:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 185
Usage Reference

• Radius: All elements within the defined Radius from the Edge Set are extruded with a mesh
morphing correction.

• Depth: Defines the bias of the mesh morphing (linear with 1, quadratic with 2,...).

(2.1)

where:

m0 is the distance a node on the free surface has to move in-plane to coincide with
the Extrusion Guide.
mi is the distance the inward node of the ith shell element moves in-plane as a result
of the mesh morphing.
di is the distance between the node in the guided Edge Set and the inward node of
the ith shell element.

Figure 2.130: Mesh Morphing Diagram

2.1.16.1.3.2. Extrusion Guide Examples

The following is an example of a direction-type Extrusion Guide with different mesh morphing
radii. The location of the edge set is indicated by the circle in the bottom left corner. The mesh
morphing is only applied to nodes on the shell surface whose distance to the Edge Set is
smaller than the radius.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
186 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.131: Example of a Direction-type Extrusion Guide with Different Mesh Morphing
Radii

The following is an example of a geometry-type Extrusion Guide with different mesh morphing
depths:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 187
Usage Reference

Figure 2.132: Example of a Geometry-type Extrusion Guide with Different Mesh Morphing
Depths.

2.1.16.1.4. Snap-To Geometry

The Snap-To Geometry feature can alter an extruded Solid Model to align with an imported CAD
Geometry (p. 95). The layered Solid Model is locally stretched or compressed so that its selected
faces coincide with the CAD geometry. Multiple Snap-To Geometries can be assigned to one
Solid Model. The adaptation occurs at the first intersection that is found. See CAD Geomet-
ries (p. 95) for information on how working with geometries impacts system performance.

The feature is only applied to the selected Oriented Selection Set and its selected face (top or
bottom). The normal orientation of the Oriented Selection Set defines which face is top or bottom.
The height of all the elements through the thickness is altered to an even distribution.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
188 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

In the following example, the first picture shows the extrusion without any Snap-To Geometry
operation. The lay-up is defined from two Oriented Selection Sets which point in opposite direc-
tions. In the second figure, the first Modeling Ply (oriented to the top) is defined to be extruded
to a CAD Geometry. Only the nodes which meet the surface are extruded until the surface. The
other nodes are extruded normally. The second Modeling Ply is extruded to another CAD Geometry
in the last figure. For both cases, the orientation of the Snap-To Geometry operation must be
top as the Oriented Selection Sets both point outward.

Figure 2.133: Extrusion without Snap Operation

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 189
Usage Reference

Figure 2.134: Extrusion with Snap-To Geometry at the Top (Shell Geometry also Displayed)

Figure 2.135: Extrusion with Snap-To Geometry at the Top and Bottom (Shell Geometry
also Displayed)

Caution:

The Snap-To Geometry operation occurs after the Extrusion Guide operations. It is
possible that the nodes moved during the Extrusion Guide operations are translated
again, and do not match with the previous Extrusion Guide definition.

2.1.16.1.5. Cut-Off Geometry

The Cut-Off Geometry feature uses CAD Geometries (p. 95) to shape the Solid Model by cutting
off elements. The operation is analogous to machining a composite part after curing. Refer to
Guide to Solid Modeling (p. 303) for more information. The following figures illustrate the Cut-Off
Geometry feature:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
190 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.136: Extruded Solid Model

Figure 2.137: Cut-Off Geometries Shown Alongside Extruded Solid Model

Figure 2.138: Solid Model with Cut-Off Features

2.1.16.1.5.1. Defining Cut-Off Geometry

Add a Cut-Off Geometry by selecting Create Cut-OffGeometry in the context menu of the
Cut-Off Geometry folder.

Define the Cut-Off operation with either a CAD surface geometry of CAD body geometry. The
orientation flag specifies which side of the surface or the body the elements are cut off. The
up orientation specifies that elements in the reverse normal direction of the geometry are cut
off. A visualization of the surface normal direction of a CAD body geometry can be displayed
with the Show Normals button in the toolbar.

You can use multiple Cut-Off Geometries for one solid model. The cut offs are applied sequen-
tially in order off Cut-Off Geometries creation.

The following properties must be defined in the Cut-Off Geometry Properties dialog:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 191
Usage Reference

Cut-Off Geometry Properties

• CAD Geometry: CAD geometry for surface or body geometry.

• Orientation: Determines the cutting orientation of a surface/body geometry.

Figure 2.139: Cut-Off Geometry Normal Direction

• Relative Merge Tolerance: Set the merging tolerance for neighboring nodes relative to the
element size. If two nodes fall within this tolerance they are merged, which avoids very small
element edges.

Note:

Cut-Off operations are computationally intensive, so it is important to define your

geometries efficiently. The Cut-Off algorithm runs faster if you create a for each part
instead of creating a single geometry containing all parts. This is because ACP, prior
to running the calculation, filters out all extraneous points and elements. The figure
below illustrates the principle: Instead of one large geometry, three Cut-Off geomet-
ries have been added, one for each feature.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
192 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.140: Example of three Cut-Off geometries

2.1.16.1.5.2. Decomposition of Degenerated Elements

The cutting operation can reshape elements in such a way that they are no longer able to be
handled by the solver. The Cut-Off elements are therefore decomposed into homogenous prism
and tetrahedral elements following the Cut-Off operation. An example of such a decomposition
is shown in the figure below. The decomposition takes place automatically during Solid Model
generation.

Figure 2.141: A Degenerated Hexahedral Element (left) is Decomposed into Several

Tetrahedral Elements (right)

2.1.16.1.5.3. Limitations

The Cut-Off Geometry feature modifies elements by cutting off nodes. However, it does not
refine the local mesh to conform precisely to the Cut-Off Geometry.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 193
Usage Reference

The sketch below illustrates how the Cut-Off Geometry Feature works: A node (a) of the finite
element is within the Cut-Off Geometry, so it is removed from the element. But no additional
nodes are added where the element edges intersect with the Cut-Off Geometry. Instead, the
element is converted into a degenerated shape (B), in this case from a quad to a triangle. This
also happens for 3D elements (prisms and hexes).

In many cases, the resulting element mesh will not represent all the features of the Cut-Off
Geometry. This is especially true when the Cut-Off Geometry has sharp edges or features that
are below the resolution of the elements. In the sketch shown below, for example, the finite
element retains its shape because none of its nodes fall within the Cut-Off Geometry. To remedy
this, you must refine the solid mesh by modifying the original shell mesh.

Another limitation is that degenerated elements (tetra elements, for example) do not support
layered section data. Instead, the cut-off material, which is defined either in the Solid Model
Properties (p. 173) or in the Fabric Properties (p. 82), is assigned to the element. You can
manage this by using the Analysis Ply-Wise Extrusion Method. Ansys recommends that you
assess the results of cut-off elements carefully.

2.1.16.1.6. Mesh Components

This folder contains Element Sets which were generated during the extrusion. For instance, the
DropOffSet contains all Drop-Off elements. This is the area where the thickness of the solid ele-
ments drops to zero, and homogeneous elements are generated at the boundary.

You can select and highlight the mesh components in the Scene if the Element Selection Mode
is set to Automatic or Solid (see Mesh Appearance (p. 24)).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
194 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.142: Solid Model with Highlighted Drop-Off elements

2.1.16.1.7. Material Handling for Different Extrusion Methods

The material handling for an analysis ply-wise extrusion follows the rules outlined in Fabric Solid
Model Options (p. 82). The following additional rules apply for other extrusion methods where
plies of different materials are grouped together in one solid element layer.

Drop-Off Material Handling in Non-Analysis-Ply-Wise Extrusions

• If the material handling option of at least one ply is set to Global, the global Solid Model Drop-
Off material is used.

• If all ply material handling options are set to Custom and refer to the same custom material,
the custom Drop-Off material is used.

• In all other cases (for example, a multi-layered solid with material handling options Custom
and Global), the global Solid Model Drop-Off material is used.

Cut-Off Material Handling in Non-Analysis-Ply-Wise Extrusions

• If the material handling option of at least one ply is set to Global, the global Solid Model Cut-
Off material is used.

• If all ply material handling options are set to Custom and refer to the same custom material,
the custom Cut-Off material is used.

• In all other cases, the global Solid Model Cut-Off material is used.

2.1.16.1.8. Save & Reload Solid Models

ACP Solid Models are saved as .H5 files. An update of ACP (Pre) component initiates a check of
the current and previous laminate lay-up. While the laminate lay-up does not change no new
solid model is generated.

2.1.16.1.9. Node-based Thicknesses

By default, the solid model extrusion and the 3D lay-up representation used for the lay-up mapping
within the Imported Solid Model are based on the ply thicknesses at the element center. If the

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 195
Usage Reference

Use Nodal Thickness is on (see Lay-up Computation (p. 61)), the solid model extrusion and 3D
lay-up representation directly consume the node-based thicknesses, which can improve the ac-
curacy. For more information, see the Element- vs. Node-based Thicknesses (p. 64) section.

2.1.16.2. Imported Solid Model

Topics in this section:
2.1.16.2.1. Imported Solid Model Properties
2.1.16.2.2. Mesh Components
2.1.16.2.3. Lay-up Mapping Objects
2.1.16.2.4. Quality Check
2.1.16.2.5. Miscellaneous

The Imported Solid Model feature enables you to map the Composite Definitions of ACP (Pre) onto
the mesh of an external (imported) solid model. This approach can be used if the standard solid
model approach, that is based on an extrusion algorithm and post operations, fails or produces a
mesh of poor quality. In that case, it is more robust to mesh the final composite solid structure
first, independent of the lay-up data and, in a second step, to map the Composite Definitions. See
the Guide to Solid Modeling (p. 303) section for solid model workflows as well as tips used when
working with a solid model.

Figure 2.143: Tree Object of the Imported Solid Model Feature

The Imported Solid Model (containing lay-up mapping data) can be used in combination with
structured elements (such as brick, prism, or wedge) and degenerated shapes (tetra and pyramid).
The Lay-Up Mapping Objects feature provides several options to control the mapping. For more
information on the element technologies, material handling, and element orientations, see Lay-up
Mapping Objects (p. 200). The imported solid mesh with the mapped lay-up data is exported for
downstream analyses using the standard solid model workflow in Workbench.

The lay-up mapping feature is the 3D representation of the lay-up model computed immediately
after the imported solid model updates. This 3D representation always follows the surface normal
of the shell mesh. The imported solid model does not support the Extrusion Guides (p. 183) feature.
If you need to manage the free edges in curved areas, one recommended approach is to enlarge
the shell surface and plies in the in-plane direction.

The elemental component sets that are defined in the external solid mesh are listed in the Mesh
Components sub-folder and are used to define the scoping of the Lay-up Mapping Objects (p. 200).
All component sets (also node sets) of the initial solid mesh are passed as Named Selections to the
downstream analyses (Mechanical Model) and can be used to maintain correct associations (such
as boundary conditions or contacts).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
196 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

See the Analysis of a Mapped Composite Solid Model (p. 346) section for an example analysis.

Cut-Off Geometries can be used to shape the Imported Solid Model in a desired way. They are
specified in the respective subfolders in the Imported Solid Model Tree View. The Cut-Off feature
behaves in the same way for the Imported Solid Model as it does for the standard Solid Model. It
is described in Cut-Off Geometry (p. 190). The Analysis Plies sub-folder shows which Analysis Plies
are incorporated in the lay-up mapping.

This Cut-Off feature allows you to shape the imported solid mesh after the lay-up mapping. It gives
you further control of geometry and mesh. You can add details and geometrical features to the
Imported Solid Model. Therefore, the generation of a structured mesh will be easier and more robust
for many cases.

The context menu of the Imported Solid Model contains these actions:

• Properties: Opens the Properties dialog of the imported solid model.

• Update: Runs the lay-up mapping algorithm and updates all dependencies of the Imported Solid
Model.

• Active/Inactive: Toggle whether the Imported Solid Model is suppressed or not.

• Import Initial Mesh: Loads the initial mesh of the solid model without performing the lay-up
mapping.

• Clear Generated Data: Removes all elements and mapped lay-up data from the object.

• Hide: Hide the solid model in the Scene.

• Show: Show the solid model in the Scene.

• Delete: Delete the Imported Solid Model. Not possible if the object is locked.

• Export Solid Model: Export the mesh or skin of the solid model as a geometry or as a Mechan-
ical APDL input file.

2.1.16.2.1. Imported Solid Model Properties

You can configure the settings for the Imported Solid Model under the Imported Solid Model
context menu item Properties. The properties dialog covers some basic settings where the scope
of the lay-up mapping is configured through the Lay-up Mapping Objects.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 197
Usage Reference

2.1.16.2.1.1. General Tab

2.1.16.2.1.2. Export Tab
2.1.16.2.1.3. Mapping Statistics

2.1.16.2.1.1. General Tab

• Name: Name of the object

• Format: This property specifies the format of the input file. Within a Workbench project,
solid meshes are imported via a Mechanical Model (p. 47) component. The import automat-
ically completes the Format, Unit System, and File Path properties, so as a result, these
properties are read-only.

If you are running ACP in standalone, you can directly import Ansys CDB files in ACP Pre. For
this scenario, you need to specify the Unit System of the volume mesh.

• Unit System: This property specifies the unit system of the external solid mesh which is used
to automatically convert the solid mesh into the unit system of ACP.

• File Path: Specifies the location of the mesh file to be imported.

• Refresh From Source: Only enabled in ACP standalone. Click to prompt ACP to reread the
mesh from the source file. Use this feature whenever the source file is modified because ACP
does not re-read the data automatically.

• Import Initial Mesh: Loads the initial mesh of the solid model into the ACP Model without
performing the lay-up mapping. This can be used, for example, after using the Clear Gener-
ated Data feature, to show the initial mesh once again.

• Element Quality (Delete Bad Elements, Warping Limit, Minimum Volume): See the explan-
ation for Element Quality under Solid Model Properties (p. 176).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
198 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Global Cut-Off Material: Controls the global material handling for Cut-Off Elements in the
solid model. Cut-Off Elements which have a degenerated shape (tetra) do not support layers
and therefore are filled with a Cut-Off material. This setting is used when the material
handling settings for fabrics and stackups are set to Global. See Fabric Solid Model Op-
tions (p. 82).

2.1.16.2.1.2. Export Tab

The export tab options are a limited set of the standard solid model options. See Export (p. 179)
in the Solid Model Properties section.

2.1.16.2.1.3. Mapping Statistics

The Mapping Statistics tab includes basic results regarding the lay-up mapping such as total
mass, volume, resin volume content, and so on. The Ply-Wise Data table shows the volume
per analysis ply and the difference compared to the lay-up definition based on the shell mesh.
The solid mesh ply volume is greater if the difference is positive, smaller if negative.

2.1.16.2.2. Mesh Components

Mesh Components (Element Sets) in the external solid mesh are listed in this folder. Mesh Com-
ponents are either:

• Named Selections in Mechanical

• Component sets in Mechanical APDL

• Or components of elements in the external mesh generated by a third-party meshing application

Note that Mesh Components cannot be visualized in the Scene until the initial mesh is loaded.
This happens when you Import Initial Mesh or Update the Imported Solid Model. Mesh Com-
ponents cannot be edited nor copied, and they are read-only.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 199
Usage Reference

Figure 2.144: Transfer of Mesh Components from an External Mesh via External Model,
Mechanical to ACP Pre

2.1.16.2.3. Lay-up Mapping Objects

This folder contains the Lay-up Mapping Objects used to define mapping scopes and to configure
material handling. An Imported Solid Model can have multiple Lay-up Mapping Objects defining
which plies are mapped to which components of the solid mesh. Note that the node connectivity
remains unchanged, regardless of the number of Lay-up Mapping Objects.

The Analysis Plies folder under a Lay-Up Mapping Object lists all the imported (p. 158) and/or
simple Analysis Plies (p. 150) of the source scope. The list becomes available after updating the
object and helps to verify the source scope.

The properties of the Lay-up Mapping Object are split into General, Layered Elements, and
Reinforcing.
2.1.16.2.3.1. General Tab
2.1.16.2.3.2. Layered Element Tab
2.1.16.2.3.3. Reinforcing Tab

2.1.16.2.3.1. General Tab

The General tab configures the source and target scopes of the lay-up mapping. The source
scope is defined by a set of shell elements and a list of plies. The mesh components of the

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
200 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

solid mesh define the target scope. This enables a component-wise mapping of the lay-up
model onto the solid mesh.

The Element technology for Imported Solid Models is the lay-up mapping feature that supports
layered and reinforcing elements. You can configure it in the General tab or the respective
option's tab. The following contains more information on the two Element technology options:

Layered Elements

• The layered element technology should only be used if the solid mesh consists mainly of
brick or prism elements, which are then treated as layered ones. These elements are auto-
matically aligned according to the normal direction of the lay-up and are filled with layers.

Note:

If the layered element faces are not parallel to the lay-up direction, there might
be inaccuracy since its normal direction would differ from the lay-up direction.

• Degenerated elements (pyramid, tetra, etc.) are filled with the filler material and become
homogeneous elements, as well, because they do not support layered data. The element
coordinate system of homogeneous elements can be defined by one or several rosettes (p. 99).

• Elements that do not intersect with the mapped lay-up can be deleted or filled with a filler
material. In that case, they are handled as homogeneous elements.

Reinforcing Elements

• The reinforcing element technology adds material to an existing element by intersecting the
element with basic shapes (link, shell, etc.). For more information, see Reinforcing Elements
in the Element Reference. This technology uses the REINF265 element which enables adding
material to a 3D solid element. Therefore, it can be used with any solid mesh type. The solid
elements are always homogenous, and their coordinate system is also defined by
rosettes (p. 99). Also, the reinforcing plies and their material direction are independent of
the base element.

The Source Scope is defined by a set of shell elements and a list of plies, while the Target
Scope is defined by the mesh components of the solid mesh. This enables a component-wise
mapping of the lay-up model onto the solid mesh.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 201
Usage Reference

Source Scope: Lay-up

• Shell Element Sets: Select one or several Element Set(s) to define the region of interest.
Starting with a shell model and the lay-up definition, the 3D representation of the laminate
is generated for the selected region.

Note:

The Middle Offset (p. 91) option for Element Sets is not supported. The ply
definition must be defined without this option to obtain an accurate mapping.

• Use Imported Plies: If enabled, Imported Plies are mapped onto the solid mesh instead of
the standard Modeling Plies. In this situation, the Shell Element Sets option becomes irrel-
evant.

• Select All Plies: By default, this property maps all plies of the selected shell mesh (Shell
Element Sets) onto the solid mesh. Clear this box to select a user-defined set of plies for the
mapping. Modeling Groups and/or Modeling Plies can be selected.

If Use Imported Plies and Select All Plies are both enabled, all Imported Plies are selected.

• User Defined Set: This field allows you to specify a set of Modeling Plies and/or Modeling
Groups when selecting the plies to be mapped onto the solid mesh. The equivalent object
types can be selected if Use Imported Plies is enabled.

Target Scope: Solid Mesh

• Entire Solid Mesh: If selected, the source scope (lay-up) and materials are applied to the
entire solid mesh. This also means that no other Lay-up Mapping Object can be configured
because the Target Scope cannot overlap.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
202 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Solid Element Sets: Use this field to select the specific Mesh Components of the solid mesh
to which the Lay-up Mapping Object will be applied. Mesh Components are Named Selections
or Element Sets which are defined in the initial (external) solid mesh.

2.1.16.2.3.2. Layered Element Tab

In most cases, the lay-up does not fill the entire selected target scope (solid elements), or there
are voids (gaps between layers). Use the options in the Layered Element tab to configure how
voids are handled as well as the lost elements which do not intersect with the lay-up. Because
these layered elements are defined per Lay-up Mapping Object, an Imported Solid Model can
have multiple void and filler materials.

Void Handling

• Scale Ply Thicknesses: The thickness of the mapped lay-up and the geometrical thickness
of layered elements can differ for various reasons (drop-offs, numerical differences, and so
on). If this option is enabled, the thickness of the mapped laminate will be scaled to match
the element as shown below. Note that the scaling is done per element and not on a global
scope. Below is a side view of a layered solid with void space (A) and the same element after
the ply thickness has been scaled (B).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 203
Usage Reference

• Global Void Material: Instead of scaling the laminate, you can fill the void space with a
specific material. To do so, be sure to clear the option Scale Plies and then define a void
material. Use an isotropic material since the in-plane orientation cannot be defined.

Note that you can access elements with void material through the analysis ply void_<mater-
ial id> within the Analysis Plies folder of the Imported Solid Model. There are as many void
layers in the folder as the maximum number of void layers in a layered element. For instance,
in the illustration below, there are two void spaces in a layered solid element.

• Minimum Void Material Thickness: Void spaces, like those shown above, can be caused by
drop-offs or differences between the shell and solid mesh, especially in curved areas– to
name some examples. You can further refine the void handling by specifying the Minimum
Void Material Thickness. If the thickness of the void space is less than the specified value,
the void will not be filled. Instead, the regular plies are scaled to fill the void space.

In the illustration below, scaled layers and filled void space are both applied.

This raises a possible point of confusion: Why does ACP scale the plies if the option Scale
Plies has been disabled? The fact is, the solver automatically scales the laminate whenever
the total laminate thickness does not correspond with the element height, so ACP is perform-
ing the scaling already. The Minimum Void Material Thickness feature allows you to visu-
alize and express numerically this effect in ACP.

Filler

Elements which do not intersect with the lay-up are called lost elements. They are either deleted
or filled and oriented with a Filler Material and Rosette(s), respectively.

• Delete Lost Elements: Use this option to control whether solid elements without mapped
lay-up data are removed or retained. Note that unstructured elements such as tets or pyramids
are ignored in the mapping algorithm and are always treated as lost elements (elements
without data).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
204 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Global Filler Material: If the property Delete Lost Elements is disabled, a filler material
must be assigned to the solid elements that do not have mapped lay-up data. Lost elements
are handled as non-layered (homogeneous) elements. The characteristic of the filler material
can be isotropic or anisotropic.

Note:

The homogeneous elements with filler material can be accessed through the
analysis ply filler_<material id> within the Analysis Plies folder of the Imported
Solid Model.

Orientation: Select one or several Rosettes (p. 99) to orient the filled elements. Note that
the Rosettes are used to evaluate the fiber directions (local x-axis) and the normal directions
(local z-axis) of the elements. This is slightly different compared to Oriented Selection
Sets (p. 128) where the Rosettes are used to apply the reference directions only.

If the Normals and Fiber Directions plot is enabled, you can visualize the element's x and z
axes by selecting the filler layer.

Figure 2.145: Element Normals of the Filler Elements Computed from Two Rosettes.

• Selection Method: Supported options include Minimum Distance and Minimum Distance
Superposed as described in Oriented Selection Set (p. 128).

Use Filler Option Only: The Lay-Up Mapping Object also allows you to fill Mesh Components
or the entire solid mesh with a filler material and to orient the elements so that no plies from
the lay-up are mapped. To do so, define an empty Source Scope in the General tab (A, below).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 205
Usage Reference

In the Materials tab (B), clear the Delete Lost Elements option, and select a Filler Material
and Rosettes.

The mapping algorithm, based on the 3D representation of the lay-up, consists of three main
steps:

1. Aligns the structured solid elements according to the local offset direction of the 3D
representation.

2. Evaluates the ply-wise intersections between the solid elements and plies. The mapping
algorithm also detects if an element is completely within a ply. The output contains
the element-wise plies' materials, thicknesses, and orientations. Thus, the element-wise
section data.

3. Stores the data for downstream analyses.

Note:

The mapping algorithm evaluates the intersection at the center of the solid elements,
therefore, the ply thicknesses are constant for the whole element.

2.1.16.2.3.2.1. Limitations

The following limitations are specific to the layered element technology:

• The projection of the failure results to the reference surface is not supported. Either do ply-
wise analyses or use the Section Cut feature in Mechanical to investigate results inside the
solid.

• Laminate failure criteria such as Wrinkling and Shear Crimping are not supported since the
reconstruction of the stacking sequence of the laminate is not possible for mapped lay-up
data.

• The mapping algorithm assumes that an analysis ply intersects only once with a solid element.
Therefore, the scenario on the left side of the image is not supported, and the generated
data is incorrect. A workaround is to split the ply as shown on the right side.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
206 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.16.2.3.3. Reinforcing Tab

This tab becomes active when the Element technology is set to reinforcing. It enables the
control of reinforcing elements' section properties and the configuration of the 3D solid elements'
material and orientation.

Use the following options to configure the reinforcing elements' structural behavior. For more
information, see SECCONTROL:

• Reinforcing Behavior: Specifies whether the reinforcing elements carry tension and
compression load, or only one of them.

• Base Material Handling: Removes the base material from the solid element where it
intersects with the reinforcing elements or, otherwise, retains the base material. It is
recommended to select remove if a high-volume fraction of reinforcing elements is
expected.

• Stress State: Specifies if the reinforcing elements should behave like a link, membrane,
or shell element (with or without bending). For more information, refer to SECCONTROL–
Type: REINF.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 207
Usage Reference

Reinforcing elements use the stiffness of the plies for the solid elements. An initial material
must be assigned to the solid elements because it is possible that some elements are not rein-
forced. The following options enable the specification of the initial material and orientation (if
the material is orthotropic):

• Base Material: Specifies the solid elements' material before the reinforcing elements
are applied. The base material characteristic can be either isotropic or anisotropic.

• Orientation: Selects one or more rosettes to orient the solid elements. Here, rosettes
are used to evaluate the material 1 directions (local x-axis) and normal directions (local
z-axis) of the elements. These characteristics are different from Oriented Selection Sets
(OSS) (p. 128), where the rosettes are only used to apply the reference direction.

• Selection Method: Supported options are Minimum Distance and Minimum Distance
Superposed as described in Oriented Selection Sets (OSS) (p. 128).

2.1.16.2.3.3.1. Design Tips and Best Practices

Mesh Quality

You can use the reinforcing technology with all solid element types (brick, prism, pyramid, or
tetra). Nevertheless, their shape must be of good quality, and not too distorted, so the reinforcing
elements can successfully apply to the base elements.

Element Size vs Ply Thickness

You can independently define the reinforcing elements of the base elements, including their
size, shape, and element formation. It is essential that the plies' thickness is smaller than the
base elements' size. This ensures that the reinforcing elements' stiffness accurately applies to
the base elements. For instance, you can model thick plies, such as core materials, with multiple
thin plies instead of one thick ply. For more information, see Number of Layers in Modeling
Ply Properties (p. 136).

Cut-Off Geometry

You can use the Cut-Off Geometry (p. 190) feature with the reinforcing elements. The algorithm
might result in solid elements with reduced shape quality and cause issues when combining
the reinforcing elements with the base elements. Therefore, you should mesh the final geometry
instead of shaping the solid mesh in ACP with cut-off geometries.

2.1.16.2.3.3.2. Limitations

The following limitations are specific to the reinforcing element technology:

• The standard composite post-processing features (failure tool, ply-wise result visualization,
etc.) are not supported for reinforcing elements. Use Mechanical APDL for post-processing
your analysis.

• The composite workflows (p. 37) in Workbench does not support reinforcing elements
and will skip all of their instances. The complete solid model with reinforcing elements
can be exported to Mechanical APDL via Export Solid Model from the context menu
of the Imported Solid Model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
208 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• The analysis ply thickness should be smaller than the solid elements' height. Otherwise,
the contribution of the reinforcing elements to the element stiffness might be incorrect.
For more information, see Design Tips and Best Practices (p. 208).

2.1.16.2.4. Quality Check

The application offers several options to verify the quality of the mapped lay-up.

• You can examine the fiber directions and element normals using the Orientation Visualiz-
ations options on the Toolbar.

Make sure that the solid elements are highlighted by having these mesh appearance set-
tings:

or

• You can use the Thickness Plot (p. 210) to display the ply-wise thicknesses on the solid
elements. You can also select the Component option Relative Thickness Correction to
plot the ply-wise scaling factors.

• lay-up Mapping Plot (p. 210) enables you to plot ply-wise volume contents and the deviation
of the normal direction between the shell mesh and solid mesh. This plot works only if
the Element technology is set to layered elements.

• You can get a general overview using the mapping statistics if the Element technology
is set to layered elements.

• Reinforcing Elements: A model that can also be reviewed in Mechanical APDL. These
Mechanical APDL commands show the reinforcing elements together with the reinforced
solid elements.
alls
esel,u,ename,,REINF265
/trlcy,elem,0.9
esel,all
! Enable the expanded element shapes.
/eshape,0.05
eplot

The following commands are used to plot the main material (reinforcing) direction.
/dev,vect,1
! Select only reinforcing elements (optional)
esel,s,ename,,REINF265
/psymb,layr,-1
eplot

2.1.16.2.5. Miscellaneous
The global model property 'minimum analysis ply thickness' also counts for the lay-up mapping.
A layer is only added to an element if the mapped layer thickness is greater than this value.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 209
Usage Reference

The lay-up representation (shell) is ignorant to the concept of Drop-Off elements (solid) and this
can lead to 'voids' if you have steps in the lay-up as shown in the figure below. If the drops are
low, this can be neglected, if they are high you might have to refine the tapering or adjust the
void handling of the imported solid model.

In general, the mapping is mesh independent and the shell and solid mesh do not have to be
coincident. However, too big of a difference in the meshes might cause inaccurate results.
Therefore you should work with meshes with similar element sizes, especially in curved regions.

The shape functions of the shell and solid elements can differ. For instance a Composite Definition
of a linear shell mesh can be mapped onto a quadratic solid mesh.

Full cross-sections: The mapping might does not work as expected for plies that shrink into a
very small tube as pictured below on the left hand side. In that case, it is more robust to have
several plies of moderate thickness instead of one thick ply as shown by the right picture.

2.1.17. Lay-Up Plots

Lay-Up Plots enable you to verify and visualize element and ply-wise data, such as thickness and
angle, of the Composite Definition in ACP (Pre). Available Lay-up Plots include:

• Thickness Plot (p. 214)

• Ply Angle Plot (p. 215)

• Draping Mesh Plot (p. 215)

• Look-Up Table Plot (p. 217)

• Field Definition Plot (p. 219)

• Lay-Up Mapping (p. 219)

• Material Plots (p. 221)

• User-Defined Plot (p. 221)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
210 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.17.1. Interface Options

The right-click context menu for the Lay-Up Plots object provides the following options:

• Create Thickness: plot thicknesses per element or ply-wise

• Create Lay-Up Angle: plot ply-wise angles (fiber, shear angle etc.)

• Create Draping Mesh and Flatwrap: plot draping mesh and flatwrap

• Create Scalar Look-up Table: plot scalar look-up tables and interpolations

• Create Field Definition: plot field definition data

• Create Lay-Up Mapping: plot lay-up mapping data

• Create User-Defined: plot a custom set of data on the mesh

• Paste: paste a lay-up plot from the clipboard.

The context menu for each individual Lay-Up Plot option includes the following selections:

• Properties: Display the Plot Properties dialog.

• Update: Update the selected plot.

• Copy: Copy the selected plot definition to the clipboard.

• Paste: Paste a lay-up plot from the clipboard.

• Delete: Delete the selected plot.

• Hide: Hide the selected plot.

• Show: Show the selected plot.

All plots can display the information for all or a selection of elements through the data scope. A
thickness and angle plot for all Element Sets is predefined by default. The plot definition for lay-up
plots follows the same definition as solution plots.

The properties for plots, such as Thickness properties illustrated below, have two tabs: General and
Legend. You can use the General tab to configure the plot's basic settings. Once you deselect the
Use Default check box, the Legend tab enables you to specify minimum and maximum values as
well as changing the legend title, range, and color display.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 211
Usage Reference

General Tab Legend Tab

The following general settings can be Property descriptions include:

found in most of the plots:
• Use Defaults: Uncheck this option
• Name: Name of the plot. to manually configure the color bar.
Otherwise, the default settings are
• Entire Model: If enabled, the scope used.
of the plot is the entire shell- or all
the solid elements of the model if • Min Value: Defines the value of the
Show on Solids is active. Otherwise first label. Disable Auto to set a
you can define the scope through user-defined value.
the Data Scope property. By default,
Entire Model is enabled. • Max Value: Defines the value of the
last label. Disable Auto to specify a
• Data Scope: Determines what user-defined value.
scope is used in the plot. Element
sets, OSS, Modeling Plies & • Use as Threshold: If enabled, the
Sampling Points can be selected in min and max labels become the
the data scope. The data scope of second and second-to-last labels in
a sampling point covers all plies the color bar, respectively.
that are intersected by the sampling
point. • Grey Below Value: Grey is inserted
in the color bar. All values below
• Ply-Wise: Activates a ply-wise plot the min label are then shown in
display. Thickness and angle plot grey. If Use as Threshold is on also,
are only shown if a ply is selected. then the min label becomes the
Angle plots are automatically set to third label, and the second and first
ply-wise. The plies can be selected are evaluated accordingly.
from the Modeling Groups,
sampling points or solid model • Violet Above Value: Violet is
analysis plies. appended to the color bar. All

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
212 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

General Tab Legend Tab

• Show on Solids: Shows plot data values above the max label are then
on solid elements and for solid shown in violet. If Use as Threshold
elements only. is checked as well, then the max
label becomes the third-last label,
• Component: Allows you to select and the second-last and last are
different components evaluated accordingly.

• Ply Offsets: Visualize the results of • Legend Title: Specifies the title that
a ply-wise plot on the selected plies is shown above the color bar. By
at their true or scaled offset from default, the name of the plot is
the reference surface (Angle Plot used.
only).
• Number of Colors: Sets the number
of colors for the color bar.

• Color Scheme: Chooses one of the

preconfigured color schemes.

• Fixed Color Bar Range: Activates

the Fixed Color Bar Range option
to prevent the color bar from
changing when you switch from
one ply to another. If enabled, the
overall min and maximum values of
the scope are set as color bar min
and max labels. If ply-wise is
enabled as well, the global min and
max are used.

Note:

Only a subset of the plots support Imported Plies. Currently, these are Thickness Plot,
Angle Plot and Lay-up Mapping Plot. To plot data on Imported Plies, the Entire Model
and Ply-Wise options must be enabled.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 213
Usage Reference

Thickness plot with "Use as Threshold" on for both the Min and Max Value.

Thickness plot with "Grey Below Value" and "Violet Above Value" on.

2.1.17.2. Thickness Plots

The Thickness Plot shows the thickness distribution for an entire lay-up or single plies. The Angle
Plot is purely a ply-wise plot and shows the orientation angle of a selected ply. The Look-Up Table
Plot enables you to explore the interpolation result of scalar columns. Scalar columns can be used
to define thickness, angle, or degradation fields.

Figure 2.146: Thickness Plot

Components

The component of the plot include:

• Thickness: show the element thickness or ply-wise thickness

• Relative Thickness Correction: show the thickness scaling due to draping or lay-up mapping

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
214 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.17.3. Angle Plot

The Angle Plot is purely a ply-wise plot and shows the orientation angle of a selected ply. For ex-
ample, an Angle Plot showing the shear angle of a draped ply is illustrated below.

Figure 2.147: Angle Plot

Components

The component of the plot include:

• Design Angle: The angle between the Reference Direction and the Fiber Direction. This is
the angle between the element lay-up reference defined through the Oriented Selection
Set and the user-set Ply Angle.

• Draped Fiber Angle: The angle between the Reference Direction and the Draped Fiber
Direction. This is the angle between the lay-up reference defined through the Oriented Se-
lection Set and the effective fiber direction due to draping.

• Draped Shear Angle: The local ply shear value due to draping.

• Draped Transverse Fiber Angle: The angle between the Reference Direction and the Draped
Transverse Direction. This is the angle between the lay-up reference defined through the
Oriented Selection Set and the effective transverse fiber direction due to draping.

2.1.17.4. Draping Mesh Plot

The Draping Mesh Plot enables you to control if the Draping Mesh or the Flatwrap of a draping
simulation are shown in the active Scene. You need to select a Production or Analysis Ply in order
to show the draping mesh and/or the flatwrap.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 215
Usage Reference

Figure 2.148: Draping Mesh Plot Properties

For this plot type, specific options of the General tab include:

• Show Draping Mesh: Shows the Draping Mesh Plot. The worst distortion is located in red
areas of the draping mesh. If the model property Use Draping Offset Correction (p. 61) is
active, the draping mesh is displayed at the bottom offset (relative to the reference surface
orientation) of the selected ply.

• Show Flatwrap: Shows the Flatwrap surface that is a result of the draping in ACP.

The Draping Plot shows the average shear (distortion) angle of each element. The angles are given
in degrees and they are the average absolute values of the corner angles differing from 90 degrees.
Therefore, no distortion is equal to zero degrees. More information on draping can be found in the
section Composite Modeling Techniques under Draping (p. 298).,

The following illustrations show examples of Draping Mesh, Draping Plot for a Hemisphere, and
Flatwrap Surface of the Ply.

Figure 2.149: Draping Mesh

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
216 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.150: Draping Plot for a Hemisphere

Figure 2.151: Flatwrap Surface of the Ply

2.1.17.5. Look-Up Table Plot

The Look-Up Table Plot enables you to explore the interpolation result of scalar columns. Scalar
columns can be used to define thickness, angle, or degradation fields for instance.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 217
Usage Reference

Figure 2.152: Look-Up Table Plot General Properties Tab

For this plot type, specific options of the General tab include:

• Look-up Table Column: Select the Look-up Table column data that is to be plotted.

• Supporting Points:

– Show Points: Visualize the location of the supporting points of the plotted look-up table
data.

– Show Labels: Show labels indicating the row index in the respective look-up table.

– Scale Factor: Scale the size of the supporting points.

• Show Labels: Show labels indicating the row index in the respective look-up table.

• Scale Factor: The supporting points can be scaled in size.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
218 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.153: Look-Up Table Plot of a 1-D Scalar Quantity with Supporting Points Shown as
Circles

2.1.17.6. Field Definition Plot

The Field Definition plot enables you to visualize and investigate the effect of a Field Defini-
tion (p. 158). This plot is only available ply-wise.

For this plot type, the specific option of the General tab is the Field Variable Name. You select the
field variable to be plotted from this drop-down menu.

2.1.17.7. Lay-Up Mapping Plot

The purpose of the lay-up mapping plot is to show the result of the lay-up mapping (mapped
Composite Definitions onto a solid mesh). It also allows you to check the quality of the mapping
result. Therefore, the scope only accepts Imported Solid Models and the property `Show on Solids`
is always checked.

For this plot type, the specific option of the General tab is the Data Scope option. Using this entry
field, specify one or more Imported Solid Models.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 219
Usage Reference

Figure 2.154: Lay-Up Mapping General Properties Tab

Components

The component options for this plot include:

• Volume Content: show the ply-wise volume contents

• Deviation in Normal Direction: show the difference between the shell normal and layered
solid normal direction. If ply-wise is disabled, the average normal deviation of the element
is shown.

Figure 2.155: Deviation of the Normal Direction between Shell Elements and Layered Solid
Elements

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
220 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.17.8. Material Plots

The Material Plot (p. 233) allows you to visualize ply-wise variable material properties (p. 319). You
must select an Analysis Ply to display the distribution of the material properties.

For additional information, see the Material Plot topic in the Solution Plots (p. 227) section of the
User Guide.

2.1.17.9. User-Defined Plot

With the User-Defined Plot, you can a specify arbitrary scalar quantities for plotting. For additional
information, see the User-Defined Plot (p. 235) topic in the Solution Plots section of the User Guide.

2.1.18. Definitions
Failure criteria are used to evaluate the strength of a composite structure. Several failure criteria can
be defined, combined and configured in the Definitions object. Failure criteria definitions can be
used for failure plots and sampling points. The critical failure mode for an element shown in failure
plots and sampling points is the one with the lowest reserve factor.

A list of implemented failure criteria and the associated failure types is shown in Postprocessing (p. 256).
More detailed theory information about failure criteria can be found in Failure Analysis (p. 383).

Add new failure criteria definitions by selecting the Create Failure Criteria option in the context
menu of the Definitions object. Failure criteria definition is configured in the Failure Criteria
Definition dialog that distinguishes between failure criteria for reinforced (UD and woven) materials,
sandwich structure, and isotropic materials.

Figure 2.156: Failure Criteria Definition

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 221
Usage Reference

Any failure criteria can be selected by each failure criteria definition. Different failure modes are activ-
ated via the check-boxes and can be set up in the failure criteria configuration.

Individual failure modes for each failure criterion can be activated and associated with a weighting
factor. The weighting factors can be used to define different factors of safety for certain failure criteria
or specific failure modes. Some criteria also have different levels of complexity. For example, the Puck
criterion can be used in its simplified, 2D, or 3D option.

Figure 2.157: Puck Failure Criteria Configuration

2.1.19. Solutions
The Solutions object is only available in postprocessing mode. The individual items under Solutions
objects are used to import and read the solution results into ACP. All postprocessing plots (deformation,
failure, stress, strain, temperature plots, etc.) are linked to individual solutions. Several solutions can
be combined into one envelope solution to visualize an overlay of failure results. One solution holds
all the results for each analysis system that is linked to ACP-Post in the Workbench schematic. The
solution has to be up-to-date and the results need to match the mesh before postprocessing.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
222 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.158: Solutions Object in the Tree View

The following sections detail how to configure the results import, create an envelope solution, and
plot results:
2.1.19.1. Solution Object
2.1.19.2. Envelope Solution
2.1.19.3. Solution Plots

2.1.19.1. Solution Object

The solution object controls how results are imported into ACP-Post. Each solution links to a .rst
results file. The import settings can be configured in the Solution Properties dialog. Solution Plots
can be created in connection with a solution object. The solution set (for instance, load step) is
specified for each plot object individually.
2.1.19.1.1. Solution Context Menu
2.1.19.1.2. Solution Properties

In Workbench mode, a solution is created in ACP-Post for every solution component that is linked
to the ACP-Post cell in the project schematic. A solution can also be added by selecting Import
Results in the context menu of the Solutions object in the Tree View. Doing so creates an individual
solution and displays the Solution Properties dialog.

2.1.19.1.1. Solution Context Menu

The context menu of every solution has the following options:

• Properties: Display the Solution Properties dialog.

• Update: Update the specific solution and reload result if changed.

• Reload: Reload the results file.

• Delete: Delete the selected solution.

• Delete Postprocessing Results: Delete all deformations, stresses and strains, computed.

• Export Results: Exports result (deformation, stress, strain, failure results, progressive damage)
as a .csv file for selected Element Sets, oriented selection sets, and modeling plies for both
shell and solid elements.

• Create Deformation: Create a deformation plot for the selected solution. (see Solution
Plots (p. 227) for more information on all plots)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 223
Usage Reference

• Create Strain: Create a strain plot.

• Create Stress: Create a stress plot.

• Create Failure: Create a failure plot based on a failure definition.

• Create Temperature: Create a temperature plot if data is available.

• Create Progressive Damage: Create a progressive damage plot if data is available.

• Paste: Paste a plot from the clipboard.

2.1.19.1.2. Solution Properties

Import settings and load step selection can be configured in the Data tab of the Solution
Properties dialog.

The following properties can be set in the Data tab of the Solution Properties dialog:

Figure 2.159: Solution Properties Window Showing Several Solution Sets in the Data tab

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
224 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Note that in the previous figure, the solution sets are greyed out; the solution set selection happens
at the plot level.

• Name: The name of the solution, used in postprocessing.

• Format: The format of the solution file to be imported.

– Import an .rst result file from the Ansys solver. All solution information is contained in this
file.

– Import deformation and rotational result file. These files are generated by Mechanical APDL
with the PRNSOL command.

• File Path: When importing a .rst file, the path to that file. When importing individual deform-
ation and rotational result files, the path to the deformation results.

• Rotation Path: When importing individual deformation and rotational result files, the path to
the rotational results (inactive otherwise).

• Automatic Reload: When active, ACP checks for changes to result files and reads new results
automatically.

• Read Strains and Stresses: When importing a .rst file, import stresses and strains calculated
by the solver by default. When this option is inactive and the Use ACP to Compute Strains
and Stresses option is active, ACP calculates stresses and strains from deformation and rotation
information present in the file. When several load steps or substeps are present, you are
prompted to select which set is to be imported. Calculating stresses and strains with ACP can
increase the computational load and time for postprocessing. So, it is only recommended for
linear analyses. Interlaminar stresses and strains cannot be calculated for linear triangular ele-
ments in ACP.

• Temperature Data Available: When active, this option indicates that the results file to be
imported contains a temperature field. When imported, temperature data can be visualized,
and temperature dependent material data can be used in stress and strain analysis.

• Use Solid Results if Available: If this option is active and results for solid elements are present
in the .rst file, the results are mapped onto the reference shell elements. Mapped results are
visible when Solid Models are hidden. Postprocessing can be done on both layered shell and
solid elements.

• Recompute ISS of Solids: When active, ACP recalculates interlaminar shear stresses for solid
models. The recomputation algorithm takes the following two steps:

1. Summation of all shear forces per solid stack.

2. Calculation of interlaminar shear stress by laminate-based approach (see Transverse Shear

Stresses (p. 380)).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 225
Usage Reference

Figure 2.160: Comparison of Imported and Recomputed Interlaminar Stresses

Non-zero boundary conditions are not considered in this recomputation process. The recom-
puted stresses take the place of the imported ones. The results file itself is not altered and the
recomputation can be reversed by un-checking the option and updating the solution.

2.1.19.2. Envelope Solution

The Envelope Solution feature can be used to combine and compare multiple load cases in failure
plots. In this way, the critical load case for a structure can be determined. Add an Envelope Solution
by selecting Create Envelope Solution from the context menu of the Solutions object. Existing
solutions can be added to the Envelope Solution in the Envelope Solution Properties dialog.

See Failure Mode Plot (p. 231) for more details on visualizing failure plots using Envelope Solutions.

Figure 2.161: Envelope Solution Properties

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
226 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

In the Envelope Solution Properties dialog, you can set the Name of the Envelope Solution and
add any results set for the available solutions for the failure analysis comparison.

2.1.19.3. Solution Plots

This section examines available solution plots and their functionality. Refer to the Guide to Composite
Visualizations for the practical application of solution plots (Postprocessing Visualizations (p. 311)).
All analysis results can be visualized as solution plots in ACP-Post. Solution plots are attached to
individual solutions.
2.1.19.3.1. Common Plot Settings
2.1.19.3.2. Visualization Mismatch
2.1.19.3.3. Deformation Plot
2.1.19.3.4. Strain Plot
2.1.19.3.5. Stress Plot
2.1.19.3.6. Failure Mode Plot
2.1.19.3.7.Temperature Plot
2.1.19.3.8. Progressive Damage Plot
2.1.19.3.9. Material Plot
2.1.19.3.10. User-Defined Plot

2.1.19.3.1. Common Plot Settings

Plot settings are largely similar for all plot types. Each plot can be configured through the Plot
Properties dialog. The Plot Properties dialog has two tabs, General and Legend. The General
tab is where the results component and geometry scope are defined. It possible to configure a
plot to display only a particular section of a component. The Legend tab controls the format of
the plot legend. Specific to solution plots is the selection of the solution set of interest.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 227
Usage Reference

The General Tab has the following properties:

• Name: Name of the plot.

• Entire Model: Shows the data of the full shell model or on the solid elements if Show on
Solid is enabled.

• Data Scope: Defines a refined scope if Entire Model is disabled and determines what scope
is used in the plot. Element sets, OSS, Modeling Plies, and Sampling Points can be selected
in the data scope. The data scope of a sampling point covers all plies that are intersected by
the sampling point.

• Ply-wise: Activates a ply-wise plot display. The plies can be selected from the Modeling Groups,
Sampling Points, or the Analysis Plies folder of the Solid Model. Most ply-wise post-processing
plots only display data if you select an Analysis Ply.

• Show on Solids: Shows plot data on solid elements and for solid elements only.

• Spot: Displays the position through the ply thickness for the result evaluation. Either top, mid,
or bottom.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
228 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Component: Choose the component available for the chosen plot. For example: usum, s12, or
Inverse Reserve Factor.

• Solution Set: Specifies the time/solution step for which the results are displayed.

• Ply Offsets: Display the results of a ply-wise plot on the selected plies at their true or scaled
offset from the reference surface.

The Legend tab allows you to control titles, labels, and legend ranges:

• The legend is formatted automatically by default but can be customized to suit.

• Limits can be set be set to be min/max limits.

• Limits can be set as thresholds on the penultimate labels on the contour plot scale.

• Values above limits can be colored in non-rainbow scale colors (grey and pink).

2.1.19.3.2. Visualization Mismatch

Failure plots show the critical values for all defined failure criteria (modes) and integration points.
The strain and stress plot illustrates the values at the element center (interpolation). Therefore,
the absolute strain and stress peaks are not displayed in the plots and the elements have a con-
stant value. This can cause graphical inconsistency between the strain/stress and failure plot.

2.1.19.3.3. Deformation Plot

Displays nodal deformation results and can plotted for the following:

• ux: Translation in X direction.

• uy: Translation in Y direction.

• uz: Translation in Z direction.

• rotx: Rotation around the X axis.

• roty: Rotation around the Y axis.

• rotz: Rotation around the Z axis.

2.1.19.3.4. Strain Plot

Shows strain values at the bottom, mid, or top position of the ply and at the element center (or
at the bottom or top of the laminate if ply-wise is disabled). In the Ansys Mechanical application,
this corresponds to the Elemental Mean display option. Strains can be displayed ply-wise or for
an entire laminate. Strain results can be plotted for the following component directions:

• 1: Material 1 direction.

• 2: Material 2 direction.

• 3: Out-of-plane normal direction.

• 12: In-plane shear.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 229
Usage Reference

• 13: Out-of-plane shear terms.

• 23: Out-of-plane shear terms.

• I: 1st principal direction.

• II: 2nd principal direction.

• III: 3rd principal direction.

2.1.19.3.5. Stress Plot

Displays stress values at the bottom, mid, or top position of the ply and at the element center
(or at the bottom or top of the laminate if ply-wise is disabled). This corresponds to the Elemental
Mean display option in the Ansys Mechanical application. There is an option to compute Inter-
laminar Normal Stresses for shell elements as explained in Interlaminar Stresses (p. 377).

Interlaminar Normal Stresses: (see A, below) Activates a separate post-processing step to

compute the interlaminar normal stresses s3 for shell elements. This happens automatically if a
3D failure criterion is active (for example: Puck 3D or Max Stress s3). Note that the s3 stresses are
cached once they are evaluated because the computation can be costly. Use Delete Post-Pro-
cessing Results from the solution’s action menu to clear the cache. By default, s3 stresses are
available for solid elements. See Interlaminar Normal Stresses (p. 377) in the theory chapter for
more information.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
230 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Stress results can be plotted for the following stress component directions:

• 1: Material 1 direction.

• 2: Material 2 direction.

• 3: Out-of-plane normal direction.

• 12: In-plane shear.

• 13: Out-of-plane shear terms.

• 23: Out-of-plane shear terms.

• I: 1st principal direction.

• II: 2nd principal direction.

• III: 3rd principal direction.

2.1.19.3.6. Failure Mode Plot

Failure plots can be used to display the safety factor for first ply failure of a pre-defined failure
criteria definition. Failure results can be displayed in the following ways:

• Ply-wise Failure: Results show the critical failure at each element for the selected Analysis
Ply, calculated over all of its integration points and defined failure criteria.

• Element-wise Failure: Results show the critical failure over all plies, integration points,
and defined failure criteria at each element. This guarantees that the critical results are
shown.

The failure evaluation for each defined failure criterion uses stress or strain results at each integ-
ration point. In contrast, stress and strain plots display the elemental mean results.

There are three kinds of safety factors that can be displayed in a failure contour plot. Text labels
can be activated to show the critical failure mode and in what layer it occurs. In the case of an
envelope solution, the critical load case can also be shown. The toolbar button switches the
display of activated element text labels on and off. For information on failure definitions see
Postprocessing (p. 256).

Available safety factor components:

• Inverse Reserve Factors (IRF)

• Margins of Safety (MoS/MS)

• Reserve Factors (RF)

The failure plot properties have the following additional options:

• Failure Criteria Definition: Drop-down menu for selecting the desired failure criteria definition.

• Show Critical Failure Mode: Show the critical failure mode as an element text label.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 231
Usage Reference

• Show Critical Layer: Show the layer index of the critical failure mode as an element text label.

• Show Critical Load Case: Show the solution index of the critical failure mode as an element
text label (Envelope Solution only).

• Threshold for Text Visualization: Set the threshold so that element labels are only shown for
as of a certain IRF, RF or MoS level.

Note:

The critical layer index counts from the reference surface upwards and starts at layer
1. The sandwich failure criteria top and bottom sheet wrinkling are evaluated for a
sandwich structure as a whole and cannot to be linked to specific layer. The layer index
shows 0 in this case. The critical load case index starts at 0. In the Envelope Solution,
the solution in position n is plotted with number n - 1.

Figure 2.162: Scene with Failure Mode Plot Activated

2.1.19.3.7. Temperature Plot

The temperature plot can display a temperature field results on solid elements if temperature
data is available in the results file.

2.1.19.3.8. Progressive Damage Plot

This plot object can display progressive damage results. The overall damage status can indicate
if, and how much, damage has occurred. The damage variables indicates how much the stiffness
has reduced for fiber and matrix in tension or compression. The damage variable scale goes from
0 (no damage, 0% stiffness reduction) to the maximum stiffness reduction specified. The highest
reduction possible is 1 (complete damage, 100% stiffness reduction).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
232 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Note that a failure analysis for this analysis type should be done with care and may not make
sense for damaged elements.

See Damage Results in the Mechanical User's Guide for more information on each result component.

The following components can be plotted:

• Damage Status:

– 0 = undamaged

– 1 = damaged

– 2 = completely damaged

• Fiber Tensile Damage Variable (FT)

• Fiber Compressive Damage Variable (FC)

• Matrix Tensile Damage Variable (MT)

• Matrix Compressive Damage Variable (MC)

• Shear Damage Variable (S)

2.1.19.3.9. Material Plot

The Material Plot enables you to visualize ply-wise variable material properties (p. 319).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 233
Usage Reference

Figure 2.163: Material Plot General Properties Tab

By default, all available field variables are used to evaluate the selected material property. However,
you can also deactivate some of these variables to inspect the dependency of the selected ma-
terial property more easily with respect to some specific factors. During the evaluation, inactive
variables stay fixed at their default value.

Available field variables include the Shear Angle (defined by draping simulation (p. 373) in ACP-
Pre), Temperature (if temperature data is available in the results file), and your own variables
defined using Field Definitions (p. 158) in ACP-Pre.

For this plot type, the plot-specific options of the General tab include:

• Material Property: This property displays a list of supported material properties: Engineer-
ing Constants, Density, Strain, and Stress Limits.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
234 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

• Component: The options listed for this attribute include dependent variables associated
with the selected material property. Examples include Orthotropic Young's Modulus,
Poisson's Ratio, and Shear Modulus.

• Use All Available Field Variables: By default, the application uses all available field vari-
ables to evaluate the selected material property.

• Internal Variables: If you disable the Use All Available Field Variables option, you can
selectively enable the Shear Angle and Temperature fields.

• User-Defined Variables: If you disable the Use All Available Field Variables option, you
can selectively enable specific field variables defined through a Field Definition.

2.1.19.3.10. User-Defined Plot

This plot object can be used to plot a scalar data set provided as a Python list or numpy.ndarray
, as well as associated custom text labels, provided as a list of strings. Once the plot has been
loaded, you can query active element indices, labels, and respective element centroid coordinates
through the plot user interface properties based on the data scope. User-defined plots can be
created as a lay-up plot or a solution plot. The plot is defined using the Python interface. The
code can be placed in the script field of the plot object. This ensures the plot is refreshed following
model updates. Alternatively, the plot definition can be executed through the Python shell. For
more information about the Python interface, see The ACP Python Scripting User Interface (p. 421).

Figure 2.164: Script Field in the User-Defined Plot Properties

In addition to the default buttons (OK, Apply, and Cancel), the Script has a Save button which
saves the modifications without closing the window or updating the model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 235
Usage Reference

Python User Interface Properties

user_element_indices

Retrieve a numpy.ndarray with the active element indices in the relevant order.

user_element_labels

Retrieve a numpy.ndarray with the active element labels in the relevant order.

user_element_centroids

Retrieve a numpy.ndarray with the active element centroid coordinates in the relevant
order.

user_data

Retrieve or provide data, which must obey the order of the user_element_indices or
user_element_labels, respectively.

user_script_enabled

Boolean that controls if a custom script is run on update.

user_script

The body of the script to be executed on update if user_script_enabled = True.

user_text

Access to the user-defined text of the plot. Empty strings can be inserted when no labels are
to be shown for certain elements.

text_threshold_type

show_all (default), show_only_values_above_threshold, show_only_values_be-

low_threshold. Threshold can be set using the text_threshold property

text_threshold

Threshold used for showing text if text_threshold_type is not show_all.

Example Scripts

A few examples of user-defined plots are shown in this section. The Python scripts are delivered
with the installation of ACP. You will find them in this location:

C:\Program Files\ANSYS Inc\v212\ACP\script_examples

Example 2.1: Show Material Distribution

Script: C:\Program Files\ANSYS Inc\v241\ACP\script_examples\MaterialDis-

tributionPlots\Wizard\material_plot_main.py

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
236 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

This plot shows the material distribution of a specific material in the structure. You can choose
to plot the total thickness of all plies of this material, the number of plies, or just 0/1 per element
as shown below. You make your selection using a simple wizard. To generate the plot, select File
> Run Script… and then choose the script material_plot_main.py. The wizard creates the
user-defined plot. Afterwards, you can use the Script tab to change parameters.

The next examples are based on the class40.wbpz Workbench workshop. Each example
consists of two parts: the first part configures the user-defined plot, and the second part sets the
user-script of the plot. These scripts are also included with your ACP installation: (C:\Program
Files\ANSYS Inc\v241\ACP\script_examples).

Example 2.2: Plot Material Property Distribution

Script: C:\Program Files\ANSYS Inc\v241\ACP\script_examples\plot_materi-

al_property_distribution.py

The sample code provided shows you how to create an advanced material plot which you can
use to plot variable material data. In this case, the objective is to plot variable material data with
a custom label, using the user-defined Plot to do so. The example below plots the effective
Young's modulus as a function of draping simulation with shear angle labels.

• This project contains a material called E_Glass_shear_dependent.

• This material is contained within cell B5 (ACP) of class40.wbpz.

Open ACP Setup of cell B5 and either run the script (File > Run Script …) or follow the instructions
below to create the user-defined plot.

A. The following commands must be copied and pasted (CTRL-Shift-V) into the Python shell in
ACP.

# get active model

model = db.active_model
# get angle plot
ap = model.layup_plots['Angle.1']
# set the angle plot to display the draped shear angle

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 237
Usage Reference

ap.component = 'shear'
# set the plot data scope to modeling ply 'outer_skin_1' which uses a draping simulation
scope = model.modeling_groups['hull'].plies['outer_skin_1']
ap.data_scope = scope
# update the model
model.update()

# create a user defined lay-up plot

up = model.layup_plots.create_user_defined_plot(name = 'myplot')
# apply the same scope as before
up.data_scope = scope
# enable the script field
up.user_script_enabled = True
up.show_user_text = True

B. The following code must be placed within the Script field of UserDefinedPlot object myplot:

# get active model, angle plot and data scope

model = db.active_model
ap = model.layup_plots['Angle.1']
scope = model.modeling_groups['hull'].plies['outer_skin_1']
plot.data_scope = [scope]
# get a list of the shear angles of the selected modeling ply
shear_angles = ap.get_data(visible = ap.data_scope, selected = scope)
# get the shear dependent material
mat = model.material_data.materials['E-Glas_shear-dependant']
moduli = []

# loop thru list of shear angles and determine the corresponding

# elastic modulus in 1 direction
for i in shear_angles[0]:
moduli.append(round(mat['engineering_constants'].query('E1', {'Shear Angle' : i}),3))

# set the plot to display the list of moduli

plot.user_data = moduli
# set the user text to display the corresponding shear value as string, rounded to 2 digits
import functools
plot.user_text = list(map(str, map(functools.partial(round, ndigits = 2), shear_angles[-1])))
# add formatting to the plot
plot.color_table.use_defaults = False
plot.color_table.description = 'E_1 [MPa] with shear angle labels'

This script should result in the following plot:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
238 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Example 2.3: Plot Combined Shear Stress Values- User-Defined Failure Criteria

Script: C:\Program Files\ANSYS Inc\v241\ACP\script_ex-

amples\plot_user_defined_combined_shear_stresses.py

The sample code below shows how you can plot the margin against the combined interlaminar
shear stresses.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 239
Usage Reference

Open ACP Setup of cell B5 and either run the script (File > Run Script …) or follow the instruc-
tions below to create the user-defined plot.

A. The following commands must be copied and pasted (CTRL-Shift-V) into the Python shell in
ACP.

# get active model

model = db.active_model
# set data scope to element set
scope = model.element_sets['HULL_BELWL']

# create a stress plot for out-of-plane shear stress s13

sp = model.solutions['Solution 1'].plots.create_stress_plot()
sp.data_scope = scope
sp.component = 's13'

# create a second stress plot for out-of-plane shear stress s23

sp1 = model.solutions['Solution 1'].plots.create_stress_plot()
sp1.data_scope = scope
sp1.component = 's23'
# update the model, to make stress data available
model.update()

# create user defined solution plot

up = model.solutions['Solution 1'].plots.create_user_defined_plot(name = 'myplot.1')
# apply the same data scope as before
up.data_scope = scope
up.user_script_enabled = True

B. The following code must be placed within the script field of the UserDefinedPlot object myplot:

# import numpy extentsion for mathematical operations

import numpy
# get active model, set data scope as before and select core layer
model = db.active_model
scope = model.element_sets['HULL_BELWL']
ply = model.modeling_groups['hull'].plies['core_bwl'].production_plies['ProductionPly.9'].analysis_plies[

# retrieve references to stress plots created before

sp = model.solutions['Solution 1'].plots['Stress.1']
sp1 = model.solutions['Solution 1'].plots['Stress.2']

# get list of s13 and s23 stresses

s13 = sp.get_data(visible = sp.data_scope, selected = ply)[0]
s23 = sp1.get_data(visible = sp1.data_scope, selected = ply)[0]

# take the sqrt of the sum of squares

combined = numpy.sqrt(numpy.power(s13,2) + numpy.power(s23,2))
# define a stress limit
slimit = 1.1

# calculate the inverse reserve factors (irfs)

irf = combined / slimit

# set the plot to display the list of irfs

plot.user_data = irf
# add formatting to the plot
plot.color_table.use_defaults = False
plot.color_table.description = 'irf_plot'

This script should result in the following plot:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
240 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Example 2.4: Mesh Selections and Queries on a Solid Model

User-defined plots can also show results on solid elements. The sample code below shows how
to execute mesh selections and mesh queries for solids.

A. The following commands must be deployed from within the UI of cell B5:

# get active model

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 241
Usage Reference

model = db.active_model
# set data scope to element set 'BULKHEAD_ALL'
scope = model.element_sets['BULKHEAD_ALL']

# create a user defined lay-up plot and apply the data scope set before
up = model.layup_plots.create_user_defined_plot(name = 'myplot.2')
up.data_scope = scope
# enable the script field
up.user_script_enabled = True
# activate the solid model display option
up.show_on_solids = True

B. The following code must be placed within the script field of the UserDefinedPlot object
myplot.2:

# get active model

model = db.active_model
# select all elements attached to 'SolidModel.1'
model.select_elements('sel0', attached_to=model.solid_models['SolidModel.1'])
# retrieve the element type numbers for the selected elements using a mesh query
data = model.mesh_query(selection='sel0', name='etypes', position='centroid')
# set the plot to display the element type number on the solid elements
plot.user_data = data.astype(float)

This script should result in the following plot. The prism and brick elements are highlighted
separately:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
242 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Example 2.5: Material-wise Post-Processing

This example shows how to generate a failure plot that computes the most critical failure within
an element for a specific material or a list of materials. For instance, you could determine the
most critical failure of all uni-directional materials per element.

Script: C:\Program Files\ANSYS Inc\v241\ACP\script_examples\ Material-

WisePostProcessing\material_wise_post_processing.py

To generate the plot, select File > Run Script… and then choose the script fail-
ure_plot_main.py. This opens a wizard which allows you to configure parameters such as
material, solution, and failure definition. To further customize it, use the Script tab in the Property
dialog of the user-defined plot. For instance, you might choose to select a list of materials instead
of a single material.

Script: C:\Program Files\ANSYS Inc\v241\ACP\ script_examples\Material-

WisePostProcessing\material_wise_post_processing.py

This script generates a template of a user-defined plot for material-wise post-processing. Within
the script of the user-defined plot, you can adjust the parameters such as the materials and the
solution. In this example, you can also select a list of materials.

2.1.20. Scenes
Scenes are windows that contain the visualization settings of the composite model. New Scenes can
be added or existing ones can be modified by hiding or showing visualization features. The visualiz-
ation of the following features is saved in a Scene:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 243
Usage Reference

• Element Sets

• Edge Sets

• CAD Geometries

• Rosettes

• Section Cuts

• Solid Models

In a new Scene, all Element Sets, Section Cuts and Solid Models are shown.

In the Scene Properties dialog you can set the Name and Title which are displayed in the top right
corner of the Scene.

Figure 2.165: Scene Properties

2.1.21. Views
Views can be used to save a certain view. The selection of a view automatically updates the Scene
and transfers the properties of the View to the active Scene. New Views can be created with the
button in the toolbar (see Scene Manipulation (p. 22)) or via the object Tree. Different parameters
can also be defined manually.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
244 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.22. Ply Books

A Ply Book is a document you can create which describes the production plies in your model. It is a
convenient way to forward production data to other members of your project such as designers or
manufacturers.

The Ply Book is separated into Chapters. Each Chapter lists the production plies belonging to a selected
set of Modeling Groups or Modeling Plies. You can also add to the Chapter a Snapshot image of
the plies. For each Chapter you will assign a specific View which determines the camera angle for the
Snapshot.

You can customize the content of the Ply Book by defining templates for the different sections as
described below in Editing the Ply Book Template (p. 246).

The following sections explain the Ply Book in detail:

2.1.22.1. Creating Chapters
2.1.22.2. Chapter Properties
2.1.22.3. Editing the Ply Book Template
2.1.22.4. Modifying the Ply Book Snapshots
2.1.22.5. Exporting the Plybook
2.1.22.6. Sample Ply Book Page
2.1.22.7. Ply Book Limitations

2.1.22.1. Creating Chapters

Before creating any Chapters for the Ply Book, at least one View must be defined. See Views (p. 244)
for more information.

Next, you create a Chapter or Chapters by selecting the Automatic Setup or the Create Chapter
option found in the Ply Book context menu.

• Create Chapter: This option creates one new Chapter and opens its Chapter Properties (p. 246)
dialog.

• Automatic Setup: This option creates one Chapter for each Modeling Group in your model. If
needed, you can change any of the Chapter Properties later.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 245
Usage Reference

2.1.22.2. Chapter Properties

You can set the following properties for each Chapter:

• Name: A descriptive title for the Chapter.

• Chapter View: The View used when the ply Snapshot is taken.

• Modeling Groups / Plies: Select a list of Modeling Groups or Modeling Plies. The Chapter will
contain all production plies contained in these Modeling Groups or Modeling Plies, in the selected
order.

• Show rosettes: If this check box is ticked, the rosettes associated with a given production ply
(through its modeling ply's oriented selection sets) will be shown in the Snapshot images

2.1.22.3. Editing the Ply Book Template

The format and content of the Ply Book is determined by three templates, each for a different part
of the Ply Book:

• Title page: Information shown at the very beginning of the Ply Book

• Chapter: Information shown at the start of each Chapter

• Ply: Information for each individual production ply

To edit the templates, right-click Ply Book in the Tree View and select Properties. This opens the
Ply Book Properties window shown below. Use the dropdown menu (A) to select the template
for the title page, the chapter, or the ply.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
246 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

When you select the chapter or the ply template from the menu (A), additional menus (as shown
in the image below) appear in the Ply Book Properties window so you can select the specific
Chapter and/or production ply template which will appear in the Preview.

Use the Source panel (B) to edit the template using reStructuredText markup format. Your modi-
fications will appear in the Preview panel below.

• Save: Saves the reStructuredText template to an external text file.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 247
Usage Reference

• Open: Allows you to open an external text file as a reStructuredText template.

• Default: Restores the template to its default format and content.

• OK: Save the templates and close the Properties dialog.

• Apply: Save the template and update the ACP model.

The Scene dropdown menu is explained below in Modifying the Ply Book Snapshots (p. 249).

2.1.22.3.1. Python Expressions

For the Chapter and Ply Templates, you can use Python expressions (p. 421) to print information
about the current Chapter and/or ply.

• A Python statement must be enclosed in vertical bars: |<statement>|

• The following literals must be present in the statement for it to be evaluated as a Python ex-
pression:

– In the Chapter Template: chapter

– In the ply section, any one of chapter, modeling_group, modeling_ply, or produc-

tion_ply

These are also the variables defined in the Python context.

• The statement |chapter.view| has special meaning: It will be replaced by a Snapshot image.

Example:

The following example shows two uses of Python expressions:

• |modeling_ply.draping_seed_point|: Adds information about the Draping Seed Point

to the Ply Book.

• |f"{production_ply.thickness:.4f}"|: Uses Python formatted string literals to set

the precision shown in the ply book.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
248 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

2.1.22.4. Modifying the Ply Book Snapshots

The Snapshot images in the Ply Book use the Scene inked to the Ply Book. You can change which
Scene is used in the Ply Book Properties window (p. 246).

By changing the Scene itself, you can control how the model is rendered, that is, which plots and
supporting information are shown. For details on manipulating the Scene, see the following sections:
Scene (p. 22) and Scene Preferences (p. 18).

You can define the size of the image in the Ply Book using Scene Preferences (p. 18). If you do not
specify its size, it will default to the size of the Scene in the ACP window.

2.1.22.5. Exporting the Plybook

To export the Ply Book, right-click the Ply Book object in the Tree View and select Generate the
Ply Book from the context menu. You can export Ply Books in .html, .pdf, .odt or .txt formats. The
export operation can take several minutes, depending on how many Snapshots are taken.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 249
Usage Reference

For the .pdf output, the paper orientation and size can be selected.

Note:

See the section below, Ply Book Limitations (p. 252), regarding exporting to .odt.

2.1.22.6. Sample Ply Book Page

Below shows a sample Ply Book page. The Scene displays the fiber directions, flat wrap, and rosette
used for the ply.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
250 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 251
Usage Reference

2.1.22.7. Ply Book Limitations

.odt export: When exporting to .odt format, the page numbers in the table of contents will be in-
correct. To generate the correct page numbers, open the file in a word processor and update the
table of contents. For example: In Microsoft Word, right-click the table of contents and choose
Update Field. In LibreOffice Writer, the command is Update Index.

2.1.23. Parameters
The Parameter feature connects inputs and outputs to the parameter interface in the Workbench
project schematic (see Working with Parameters in the Workbench User's Guide). You can use this, for
example, for creating parametric studies and for optimizing a model.

Figure 2.166: Connection of ACP and Workbench Parameter Interface

A Parameter is created by selecting Create Parameter... in the context menu of the Parameters
object in the ACP Tree View.

The Parameter connection is then defined in the Parameter Properties dialog:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
252 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Figure 2.167: Parameter Properties

• Category:

– Input: Input parameter taken from the Workbench Parameter interface

– Unbound Input: Input parameters that are not directly linked to other ACP objects. They are
mainly used in combination with Scripts (p. 67). Note that unbound inputs do not have the
Object or Property properties.

– Output: Output parameter given to the Workbench Parameter interface

– Expression Output (p. 254): Output parameter that can contain a regular ACP script

• Object: The object on which the parameter acts.

• Property: The property of the object to be parameterized.

• Type: The parameter format. Determined automatically if there is only one possible option. Units
are not transferred from ACP to Workbench. Parameters appear as dimensionless numbers in the
Workbench interface.

– Bool: Boolean (true or false).

– Float: Real number.

– Int: Integer.

– None: Default selection if multiple options are available.

– String: Text string from a list of strings. The values in the string list can be called up via an index
number in the Workbench interface. The first entry in the string list has the index value 1. The
rest follows sequentially.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 253
Usage Reference

• Value: The current value of the parameter. This option can be modified depending on if a parameter
is an Input or an Output.

Caution:

The ACP systems do not automatic convert Parameter units in the Parameter Manager.
Always verify that the units of any ACP-related Parameter are consistent with the unit
system selected in the ACP system.

For Parameters in ACP (Post), linked to an object in ACP (Pre), the Parameter will become
invalid if you rename the ACP (Pre) object. To correct, redefine the source object for the
Parameter.

2.1.23.1. Settings for an Expression Output

The formulation of an expression output requires a basic understanding of The ACP Python
Scripting User Interface (p. 421).

The Parameter Properties dialog displays a Source field that accepts Python code. Various inform-
ation stored in the ACP database can be accessed. It is possible to enter a script and perform most
of the operations available within ACP's Shell View.

The script's result can be returned by assigning a value to the global return_value variable.

Example 2.6: Simple Expression Output

An example of a simple expression output is shown here. In it, the maximum inverse reserve factor
is retrieved from the active contour plot.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
254 of ANSYS, Inc. and its subsidiaries and affiliates.
 Features

Example 2.7: Complex Expression Output of Maximum Thickness in the Kiteboard Model

# Get active model

model = db.active_model

# Create new selection of all elements attached to a specific ply

modeling_ply = model.modeling_groups['Core'].plies['mp_4']
model.select_elements(selection='sel0',op='new',attached_to=[modeling_ply])

# Get total thickness of the first entity of selection sel0

thicknesses = list(model.mesh_query(name='thickness',position='centroid',selection='sel0', entities=[modeli

# Get maximum thickness

max_thickness = max(thicknesses)

# Pass the found maximum thickness as the script's result.

return_value = max_thickness

2.1.24. Material Database

It is possible to build a Material Database which can be used in different projects. The database can
also be saved on an intranet drive for sharing to other ACP users.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 255
Usage Reference

The structure of the Material Database is exactly the same as in the model. For more information, see
Material Data (p. 70). The database is stored as .acpMdb and it can be managed through the context
menu:

Figure 2.168: Material Database

The units of the database and the model can be different. Use Copy and Paste to transfer a material
from one to the other. Values of the materials are converted automatically to the correct unit system.

A default Material Database is installed with ACP: ANSYS_INSTALL_DIR\v241\ACP\databases.

2.2. Postprocessing
Layered composites are typically made of various materials (reinforced plastics, foams, and honeycomb,
for example) which often have an orthotropic characteristic. The post-processing system in ACP takes
this into account. ACP implements many different failure criteria which are applied to specific materials.
For instance, Puck evaluates the safety margin for uni-directional materials (UD) only where Max Stress
is applied to UD and weave materials. The table Failure Criteria vs. Ply Type (p. 408) explains the relation-
ship between specific failure criteria and material types. Also, the different failure criteria account for
the numerous possible failure modes (fiber failure, delamination, and wrinkling for example) in layered
composites. (See the section below Failure Criteria (p. 257).)

In ACP, you can easily combine failure criteria. (See Failure Criteria Defintion (p. 221).) This allows you
to post-process and optimize complex layered composites efficiently because the most critical failure
value and failure mode are readily accessible. For additional background information on ACP post-pro-
cessing, see Failure Analysis (p. 383) and Interlaminar Stresses (p. 377). Also, you can visualize and configure
post-processing using the Solutions Object (p. 223) and Solution Plots (p. 227).

Note:

ACP’s post-processing system computes the most critical failure and does not estimate any
residual strengths, subsequent failures, or stress redistribution. This method is also called
first ply failure (FPF). In other words, it assumes the laminate fails when the first ply fails.
Therefore, ACP’s post-processing is not suitable for any solution (such as impact or damage
analysis) which goes beyond FPF. The section on Supported Analysis Types (p. 43) describes
which analysis types ACP Post supports. The opposite of an FPF analysis is a final failure
analysis which is part of a progressive damage or explicit analysis, both of which are supported
by Ansys products.

2.2.1. Failure Criteria

2.2.2. Failure Mode Measures

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
256 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing

2.2.3. Principal Stresses and Strains

2.2.4. Linearization of Inverse Reserve Factors
2.2.5. Postprocessing of a Composite Solid Model
2.2.6. Postprocessing of Drop-Off and Cut-Off Elements
2.2.7. Evaluating Custom Failure Criteria
2.2.8. Limitations & Recommendations

2.2.1. Failure Criteria

All available failure criteria are listed together with their failure mode abbreviations as used in failure
mode plots.

Terms:

• e = strain, s = stress

• 1 = material 1 direction, 2 = material 2 direction, 3 = out-of-plane normal direction, 12 = in-plane

shear, 13 and 23 = out-of-plane shear terms

• I = principal I direction, II = principal II direction, III = principal III direction

• t = tension, c = compression

Criteria:

• Maximum Strain: e1t, e1c, e2t, e2c, e12

• Maximum Stress: s1t, s1c, s2t, s2c,s3t, s3c, s12, s23, s13

• Tsai-Wu 2D and 3D: tw

• Tsai-Hill 2D and 3D: th

• Hashin: hf (fiber failure), hm (matrix failure), hd (delamination failure)

• Puck (simplified, 2D and 3D Puck implementations are available): pf (fiber failure), pmA (matrix
tension failure), pmB (matrix compression failure), pmC (matrix shear failure), pd (delamination)

• LaRC 2D and 3D: lft3 (fiber tension failure), lfc4 (fiber compression failure under transverse compres-
sion), lfc6 (fiber compression failure under transverse tension), lmt1 (matrix tension failure), lmc2/5
(matrix compression failure)

• Cuntze 2D and 3D: cft (fiber tension failure), cfc (fiber compression failure), cmA (matrix tension
failure), cmB (matrix compression failure), cmC (matrix wedge shape failure)

• Sandwich failure criteria:

– Wrinkling: wb (wrinkling bottom face), wt (wrinkling top face)

– Core Failure: cf

– Shear Crimping failure criteria: sc

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 257
Usage Reference

• Isotropic failure criteria - Von Mises: vMe (strain) and vMs (stress)

Weighting factor: The inverse reserve factor of each failure mode is multiplied by the accordant
weighting factor.

• 1: no safety

• 2: safety of two

An overview of all available failure criteria is given in the Section Failure Analysis (p. 383).

2.2.2. Failure Mode Measures

Three failure mode measures are available:

• IRF = Inverse Reserve Factor (IRF) defines the inverse margin to failure. Load divided with IRF is
equal to the failure load. IRF >1 discloses failure.

• MoS = Margin of Safety (MoS) defines the margin to failure. MoS is defined as (1/IRF - 1). MoS < 0
discloses failure.

• RF = Reserve Factor (RF) defines the margin to failure. Load multiplied with RF is equal to the failure
load. RF < 1 discloses failure.

2.2.3. Principal Stresses and Strains

For strains, only the first (eI) and second (eII) principals are evaluated. The principal strain (e) and
stress (s) values are ordered in descendent order.

2.2.4. Linearization of Inverse Reserve Factors

Failure criteria are functions that describe a failure envelope and the output of the function is the
inverse reserve factor (IRF). IRF is a measure of where the load point is in relation to the failure envel-
ope. IRFs calculated in ACP-Post can differ from those determined in Mechanical APDL. This is because
IRFs in ACP-Post are linearized.

For failure criteria without quadratic terms, such as maximum strain or maximum stress, the failure
output from Mechanical APDL should match closely with IRFs from ACP-Post. For those involving
quadratic terms, however, IRFs output from ACP are normalized and will therefore not match those
output from Mechanical APDL. Because of this normalization of IRFs, an increase of twice the force
does not result in four times the IRF in ACP-Post.

Exceeding the determination of failure criteria does not change as a result of the linearization (because
). However, the numerical values for failure criteria involving nonlinear differs between ACP-
Post and Mechanical APDL.

The implementation of some failure criteria (Puck, LaRC, etc.) differs between ACP-Post and Mechan-
ical APDL.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
258 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing

2.2.5. Postprocessing of a Composite Solid Model

ACP supports failure analysis for composites for shell and solid models. These analyses are based on
the same theory, including for sandwich criteria where the entire laminate stack is evaluated for in-
stances of wrinkling.

In the case where a solid model (p. 171) is generated in ACP-Pre and a solution (p. 222) is available for
the solid model, failure analysis for a solid model can be performed in two ways.

Figure 2.169: Failure Plot Dialog

If the Show on Solids option is enabled, the solid mesh shows the worst failure value and mode per
solid element. This plot can give you an overview about the general safety of the part, but may
overlook some hot spots, since the worst failure can occur inside the laminate and be obscured. In
layered structures, a critical failure may not occur in every layer, as opposed to isotropic parts where
critical stresses are on the surface.

If the Show on Solids option is disabled, the worst failure per solid stack is projected onto the shell
mesh. This makes internal failures visible, giving you a more detailed view of how the composite
structure reacts under stress. The following figure shows the difference between the two graphical
evaluation modes. The failure plot on the solid mesh (left) appears less critical when compared to
the shell mesh (right), however, the overall maximum failure value is equal for both plots.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 259
Usage Reference

Figure 2.170: Failure Analysis of a Solid Model. Show on Solids (left) and Show on Shells (right)

For an Imported Solid Model (p. 196), enable both the Show on Solids option and the Entire Model
scoping option to show the failure results on the solid mesh. This also means the failure plot cannot
be projected onto a shell mesh, as is the case for a standard Solid Model.

In addition to the failure plot (p. 231), strain (p. 229), stress (p. 230), and progressive damage (p. 232)
plots can be created with the Show on Solids option.

2.2.6. Postprocessing of Drop-Off and Cut-Off Elements

A structured layered element is turned into one or several homogeneous elements if it is cut or it
represents a ply Drop-Off. As a result, these Drop-Off and Cut-Off elements do not hold any layered
information. These elements are represented with one (isotropic or orthotropic) material.

In ACP-Post, the stresses and strains of the homogeneous elements (prisms and tetrahedrons) are
read from the .rst file. The failure evaluation is equivalent for homogeneous and layered elements.
The failure results can be displayed on the solid models and the critical (maximum) IRF can be projected
on to the shell mesh.

The evaluation of stress and strain distributions is not the same for homogeneous and layered elements.
The stresses and strains of the homogeneous elements can be displayed on the solid models but
cannot be mapped back on to the shell mesh. In this case, zero stress and strain are displayed where
Cut-Off and Drop-Off elements are present.

For more information, see Drop-Off and Cut-Off Elements (p. 305).

2.2.7. Evaluating Custom Failure Criteria

User-defined plots (p. 235) and the Python scripting interface (p. 421) allow you to implement custom
postprocessing evaluations. The following example shows how a custom core failure criterion is
evaluated.

This script should be executed within an ACP-Post analysis system. The ACP-Post should be linked to
a solution. The script should be copied into a text editor and saved as a .py file, and then executed
from ACP-Post using File > Run Script.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
260 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing

The script evaluates the following failure function for homogeneous and honeycomb core material
types:

# Background Information
########################
# This script serves as an example on how to evaluate custom failure criteria.
# The failure criteria evaluation is based on stresses or strains at integration point level.
# The script shows how stresses at integration point level are accessed. It is worth noting that stress
# and strain plots shown in the scene or the sampling point are elemental averages.

# The script requires two inputs: the name of an element set as a data scope for the evaluation as
# well as the name of the attached solution.

# The script loops through all analysis plies of the model and checks whether there is core material.
# For plies containing core material the s13 and s23 stresses are retrieved. The maximum stress per
# element across its integration points is used to calculate the inverse reserve factor (IRF)
################################
element_set_name = 'All_Elements'
solution_name = 'Solution.1'

# Start of Script
# NO INPUT NECESSARY!
#####################

# Loading Python modules

import numpy
import os
import logging

# initialize logger
log = logging.getLogger(__name__)

# num_ip dictionary maps the element type to the number of integration points
num_ip = {125: 1, 128: 3, 123: 1, 124: 4, 126: 4}

# get active ACP model and update it

model = db.active_model
model.update()

# Define Data Scopes

####################

element_set = model.element_sets.get(element_set_name)

if element_set is None: log.error("element set %s not found!" % element_set_name)

elem_scope = [element_set]
model.select_elements(selection='sel0', op='new', attached_to=element_set)
labels = model.mesh_query(name='labels', position='centroid', selection='sel0')

# create a dictionary that maps element labels to element indices

label2index_map = {}
for i, v in enumerate(labels):
label2index_map[v] = i

# results array initialization with -1. This means areas that do not contain core can be shown in grey in the plot
irf = numpy.ones(len(labels)) * -1

# Create shear stress plot

##########################
solution = model.solutions[solution_name]
if solution is None: log.error("solution %s not found!" % solution_name)

# Within the script, the stress plots are only used to retrieve element labels of an analysis ply.
# They can also be used to retrieve stress values at averaged at element level.
s13_plot = solution.plots.create_stress_plot(

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 261
Usage Reference

name='s13_plywise',
ply_wise=True,
solution_set=-1,
active=True,
component='s13',
show_ply_offsets=False,
ply_offset_scale_factor=1.0,
spot='bot',
interlaminar_normal_stresses=False,
show_on_solids=False,
data_scope=[element_set])
s13_plot.update()

s23_plot = solution.plots.create_stress_plot(
name='s23_plywise',
ply_wise=True,
solution_set=-1,
active=True,
component='s23',
show_ply_offsets=False,
ply_offset_scale_factor=1.0,
spot='bot',
interlaminar_normal_stresses=False,
show_on_solids=False,
data_scope=[element_set])
s23_plot.update()

# Loop thru all analysis plies

##############################

# Loop thru Modeling Groups

for mg_name in model.modeling_groups.keys():
mg = model.modeling_groups[mg_name]
# Loop thru Modeling Plies
for mp_name in mg.plies:
mp = mg.plies[mp_name]
# Loop thru Production Plies
for pp in mp.production_plies.values():
# Loop thru Production Plies
for ap in pp.analysis_plies.values():
material = ap.ply_material.material
is_core = False
# Check if the analysis ply material is a core material
if material.ply_type.find('core') > -1 or material.ply_type.find('honeycomb') > -1:
is_core = True

log.info("evaluate core failure for analysis ply %s of type %s" % (ap.id, material.ply_type))

# Get stresses and eval irf

###########################

# Common analysis ply properties

ap_elem_labels = s13_plot.get_element_labels(visible=s13_plot.data_scope, selected=[ap])
ap_material = model.material_data.materials[ap.material.name]
ap_s13_stress_limit = ap_material['stress_limits'].get('Sxz')
ap_s23_stress_limit = ap_material['stress_limits'].get('Syz')

model.select_elements(selection='sel0', op='new', labels=[int(v) for v in ap_elem_labels])

etypes = model.mesh_query(name='etypes', selection='sel0', position='centroid')

# ip-wise stresses for bot, mid and top

for spot in ['bot', 'mid', 'top']:

s13 = solution.query(
definition='stresses',
position='integration_point',
component='s13',
selection='sel0',
entity=ap,
spot=spot)
s23 = solution.query(

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
262 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing

definition='stresses',
position='integration_point',
component='s23',
selection='sel0',
entity=ap,
spot=spot)

ap_irf_absolute = numpy.absolute(s13 / ap_s13_stress_limit) + numpy.absolute(

s23 / ap_s23_stress_limit)

# need to check whether both element labels arrays are the same
if len(s13) != len(s23): log.error("s13 and s23 are of different shape!")

index = 0
for i, et in enumerate(etypes):
elem_irf_max = -1.
for n in range(0, num_ip[et]):
elem_irf_max = max(elem_irf_max, ap_irf_absolute[index])
index += 1

# insert results into the global irf results array

global_index = label2index_map[ap_elem_labels[i]]
irf[global_index] = max(irf[global_index], elem_irf_max)

# Delete shear stress plots

del (solution.plots[s13_plot.name])
del (solution.plots[s23_plot.name])

# Create user defined plot for IRFs

###################################

plot_name = "Core Shear Failure"

# User defined plot basic settings

udp = solution.plots.create_user_defined_plot(name=plot_name)
udp.user_script_enabled = False
udp.user_script = ""
udp.show_ply_offsets = False
udp.ply_offset_scale_factor = 1.0
udp.show_on_solids = False
udp.data_scope = [element_set]
# plot color settings
udp.color_table.use_defaults = False
udp.color_table.auto_lower_value = False
udp.color_table.auto_upper_value = False
udp.color_table.upper_value_as_threshold = True
udp.color_table.grey_values_below = True
udp.color_table.lower_value = 0.0
udp.color_table.upper_value = 1.0
# load irf data in plot
udp.user_data = irf
udp.update()

# End of script
log.info("End of script")

2.2.8. Limitations & Recommendations

Interlaminar shear strains of linear triangular shell elements can not be evaluated. Interlaminar shear
stresses of linear triangular shell elements can be evaluated by Ansys but not by ACP. By default, the
Ansys .rst results file contains stress and strain data; however, they may be excluded. In the case
of excluded stresses and strains, ACP can evaluate stresses and strains on the basis of the deformation
and rotation fields in the results file. Nonlinear effects are not considered by ACP and can induce in-
accurate stresses and strains. In general, you should include the stress and strain data in the .rst
data. More information can be found in Solutions (p. 222).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 263
Usage Reference

ACP provides a unique method to evaluate interlaminar normal stresses (INS) for shell elements. This
calculation of the INS requires the evaluation of the shell curvature. It is therefore recommended to
use quadratic shell elements when INS are of interest. The quadratic elements contain the curvature
information per element and offer a better approximation than linear elements. The curvature for a
linear shell element is determined from its neighboring elements. This evaluation does not consider
INS induced by edge effects or out-of-plane loads (e.g. inserts, pressures, etc.).

2.3. Exchanging Composite Definitions with Other Programs

This section describes how data can be exchanged between ACP and other programs. The following
interfaces are available:
2.3.1. HDF5 Composite CAE Format
2.3.2. Mechanical APDL File Format
2.3.3. Import of Legacy Mechanical APDL Composite Models
2.3.4.Tabular Data Format for Excel
2.3.5. CSV Format
2.3.6. ESAComp
2.3.7. LS-Dyna
2.3.8. BECAS

2.3.1. HDF5 Composite CAE Format

HDF5 Composite CAE is a vendor-independent specification that allows an accurate exchange of
composite lay-ups between different CAE and CAD packages. The specification uses HDF5 for data
storage, an open and widely used file format that efficiently stores binary data (http://www.hdf-
group.com/). Many specialized simulation tools (for forming and winding simulation, for example)
support this format, which enables a seamless data transfer into Ansys Workbench – ACP to run a
structural, thermal, modal, or buckling analysis. The format and interface contain all the necessary
information such as ply surfaces, fiber directions, thicknesses, stacking sequence, and materials.

ACP supports the export and import of the HDF5 Composite CAE format. The interfaces are accessible
through the ACP Model context menu (p. 58).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
264 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

Figure 2.171: Export and Import Options in Model Context Menu

Note:

The HDF5 Composite CAE format does not take the Fabric Fiber Angle (p. 74) property
into account. As a result, if the Fabric Fiber Angle property is active in ACP when the
composite lay-up is exported, Mechanical properties might not be accurate.

2.3.1.1. Export
Only the effective lay-up in ACP is extracted during the HDF5 Composite CAE export. This means,
for example, ACP will export the ply's thickness distribution but not the taper definitions that affect
the ply's thickness. Neither will it export the reference shell surface. It will, however, extract Inform-
ation on the ply's material, coverage, dimensions, thickness distribution, reference direction field,
as well as the overall ply sequencing. All this information gets stored in the .H5 file.

You can then import the extracted data into a program such as FiberSIM for further design and
production management.

For Export Settings, refer to the dialog box below and the explanations which follow.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 265
Usage Reference

Figure 2.172: HDF5 Composite CAE File Export Settings

• File Path: Specify the destination file name and file path.

• Remove Midside Nodes of Quadratic Elements: By default, midside nodes of the quadratic
elements are not exported.

• Export 3D Representation: If enabled, a 3D representation of the ply surfaces (including the

offsets from the reference surface) and is computed and exported. (An example is shown in the
figure below.) The reference surface, the stacking sequence, and the ply thicknesses of the other
plies in the laminate determines the exact 3D location of the ply surface. If Export 3D Repres-
entation is not enabled, the ply geometry is based on the reference surface only.

Note:

If you intend to import the HDF5 Composite CAE file into an external application, you
must verify which representation it requires. The standard representation is shell surface,
in which case you should not enable Export 3D Representation.

Figure 2.173: 3D Representation of a Lay-Up with Offset Ply Surfaces

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
266 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

• Offset: Select the surface for export: the bottom, mid, or top surface of the plies. The default is
Bottom Offset. The Offset option is available only when Export 3D Representation is enabled.

• Scope:

– All Elements: Uncheck this option to restrict the lay-up export to a region of interest.

– User Defined Set of Elements: Here you can limit the exported plies to the specific Element
Sets and/or Oriented Element Sets that interest you.

– All Plies: By default, all plies of the scope are exported. Uncheck this option to select a user-
defined set of plies to be exported.

– User Defined Set of Plies: Specify the set of Modeling Plies and/or Modeling Groups to be
exported.

Note:

The 3D lay-up representation cannot be generated for complex shapes and topologies.
In those cases, it can help to export sub-areas only by using the user-defined set of ele-
ments and user-defined set of plies options in the export dialog. See Figure 2.172: HDF5
Composite CAE File Export Settings (p. 266).

2.3.1.2. Import
When importing an HDF5 Composite CAE, you must have a model already loaded in ACP. This is
because ACP will take the lay-up definitions from the HDF5 Composite CAE and apply them to the
model as explained in the next section.

When using ACP within Workbench, the model of the upstream Mechanical component is automat-
ically loaded in ACP as described in Basic Workflow (p. 37). You can use the External Model com-
ponent in Workbench to import an external mesh model of almost any format, and then you can
transfer it to ACP as shown here.

Figure 2.174: The External Model Component in Workbench

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 267
Usage Reference

If ACP runs in standalone mode, you can load a mesh model from a .cdb file (Mechanical APDL
format) as shown in Figure 1.45: Switch Between ACP Pre and Post (p. 56) which you will find in
the section Workflow in Stand Alone Operation (p. 54). It is important to understand, the mesh(es)
from a HDF5 Composite CAE cannot be loaded directly as a model.

Furthermore, when using ACP within Workbench, materials are not directly imported into ACP be-
cause materials are always loaded from Engineering Data. This can cause a newly generated Fabric
to lose the link to its material if no material with a matching name exists in Engineering Data. Here
is a workaround:

1. First, extract the materials from the HDF5 Composite CAE file as explained in the section, Extract
Materials From Composite CAE H5 (p. 13).

2. Then import the generated MatML file into Engineering Data.

3. Finally, import the HDF5 Composite CAE file into ACP.

Another option is to add the materials to Engineering Data manually. You can use HDF View (a
third-party application) to open the HDF5 Composite CAE file and look up the material names.

2.3.1.2.1. Import Projection Types

The HDF5 Composite CAE Import supports two types of projections. The first one maps lay-up
data onto the shell mesh (reference surface) in ACP. The second option directly converts the ply data
from the Composite CAE H5 into Imported Plies Objects (p. 153) in ACP. Below is a more detailed ex-
planation of each projection type.

Mapping onto The Reference Surface

During the import process, the mapping algorithm in ACP begins by computing the ply extent
with respect to the reference surface in ACP. It then maps the fiber directions, thicknesses, and
other properties onto the surface. Ply material information gets transferred to the Material Data
object in ACP, and Oriented Selection Sets are generated based on ply coverage. Finally, thickness
distributions and reference direction fields are stored in Look-Up Tables which are then used to
define the modeling plies in the lay-up reconstruction.

A ply in the Composite CAE H5 has its own mesh that typically differs from the reference surface
in ACP, requiring an adjustment to the mapping parameters. For example, different mesh sizes
on curved surfaces can cause element normals to deviate. Nodal locations in the out-of-plane
and in-plane directions can also vary, depending on mesh sizing

You can manage these effects with appropriate import tolerances. Large tolerances can result in
mapping issues, especially with convergent meshes, as with a T-joint. If the tolerances are too
large, ply boundaries cannot be accurately replicated.

Exposed as 3D Plies (Imported Plies)

Instead of mapping the composite data of the HDF5 Composite CAE onto the reference surface
in ACP, the data is directly converted into Imported Ply objects if the projection is set to Expose
as 3D Plies. Since each Imported Ply has its own mesh that is independent of the reference surface,
the meshes of the HDF5 and Imported Plies are identical.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
268 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

This enables you to build complex 3D lay-up models in a CAD environment and load it into ACP
for detailed analyses.

The remaining data, such as Thicknesses and Reference Direction, are stored in the same manner
as the Mapping onto the Reference Surface import option.

Ply material information gets transferred to the Material Data object in ACP. Thickness Distributions
and Reference Direction Fields are stored in look-up tables which are then used to define the
Imported Plies.

2.3.1.2.2. Import Settings

A number of settings and tolerances control the import of the composite model. Refer to the
dialog box below and the explanations which follow.

Figure 2.175: HDF5 Composite CAE File Import Settings

Path

Specify the path to the .h5 file you wish to import.

Import Mode

• Append: Imported data and objects will be appended to the existing model/lay-up.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 269
Usage Reference

• Overwrite: Replaces existing objects that have the same id, unless objects are locked. Note:
To preserve the ply ordering specified in the HDF5 Composite CAE file, imported plies will
be added to the top of the existing lay-up, or moved to the top if they already exist.

Projection

For additional information on Projection types, see the detailed explanation above. (p. 268)

• Map onto Reference Surface: This option maps the plies onto the shell surface in ACP
and exposes them as Modeling Plies.

• Expose as 3D Plies (Imported Modeling Plies): This option converts the plies into Imported
Modeling Plies, uncoupled from the reference surface.

Ply Angles

• Minimum Angle Tolerance: Minimum angle tolerance for which tabular correction angles
are computed for plies.

• Recompute Reference Directions: When this option is selected, reference directions are
recomputed from tabular angle data.

Mapping Scope

• All Elements: By default, the lay-up data specified in the .h5 file is mapped onto all the
elements of a reference shell mesh in ACP. Uncheck this Boolean to restrict the lay-up
mapping to a user-defined region of interest.

• User-Defined Set: The lay-up data is mapped onto the Element Sets specified here.

Ply Area Mapping

Refer to the Figure below (p. 271) for an illustration of the Tolerance Settings.

• Relative Thickness Tolerance: This sets the mapping tolerance in the element thickness
direction relative to a minimum element edge length. In the dialog box (p. 269) shown
above, assuming a minimum edge length of 1mm, elements will be mapped if their deviation
in the element thickness direction is between -0.5 and 0.5 mm.

• Relative In-Plane Tolerance: This sets the mapping tolerance in the element in-plane
direction relative to a minimum element edge length. In the dialog box (p. 269) shown
above, assuming a minimum edge length of 1mm, elements will be mapped if their in-
plane coordinates are within the shell mesh with a maximum allowable tolerance of 0.01mm.

• Angle Tolerance: Mapping tolerance for angles between element normals (in degrees).

• Small Hole Threshold: Holes in plies/Element Sets with an area smaller than this threshold
times the area of the Element Set/ply are filled.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
270 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

Figure 2.176: Schematic of Tolerance Settings for a Single Element

Coordinate Transformation

The imported Composite Definitions are transformed according to the inputs given here. The
transformation order is as follows:

1. Rotation around X-Axis

2. Rotation around Y-Axis

3. Rotation around Z-Axis

4. Translate X, Y, Z

The X, Y and Z rotation happens around three axes of ACP’s global coordinate system. All
angles must be specified in degrees.

Show/Update Mesh Preview

Clicking this button displays a preview of all the meshes in the hdf5 file after the coordinate
transformation has been applied.

2.3.2. Mechanical APDL File Format

A Mechanical APDL input file requires specific element settings if it is to be used with ACP in Stand
Alone mode. This applies to preprocessing models that are used to define a composite lay-up as well
as postprocessing models where reading stresses and strains in future analyses is required. For more
information, see Workflow in Stand Alone Operation (p. 54).

Nodal solutions can be loaded from:

• PRNSOL file formats. An example export could be:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 271
Usage Reference

/format,10,G,25,15,1000,1000
prnsol,u
prnsol,rot

• The .rst file interface allows ACP to load nodal and element results directly from the Ansys result
file.

Use these options for element result import:

– SHELL181: Keyopt(8) = 2 (See Figure 2.177: SHELL181 Keyopts (p. 272) )

– SHELL281: Keyopt(8) = 2 (SeeFigure 2.178: SHELL281 Keyopts (p. 273) )

– SOLID185/SOLID186: Keyopt(3) = 1 (See Figure 2.179: SOLID185 Keyopts (p. 273) and Fig-
ure 2.180: SOLID186 Keyopts (p. 273))

Keyopt(3) must be defined via the command line: KEYOPT,ET_NUM,3,1

– SOLSH190: Keyopt(8) = 1

– ERESX,NO (copy integration point results to nodes)

Supported shell and solid (for post-processing only) element types: SHELL181, SHELL281, SOLID185,
SOLID186

Supported element property definition commands: SECTYPE, SECOFFSET, SECCONTROL, RLBLOCK

Figure 2.177: SHELL181 Keyopts

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
272 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

Figure 2.178: SHELL281 Keyopts

Figure 2.179: SOLID185 Keyopts

Figure 2.180: SOLID186 Keyopts

2.3.3. Import of Legacy Mechanical APDL Composite Models

You can import composite shell models with section definitions created in Mechanical APDL to ACP.
Upon import, the lay-ups are converted into ACP Composite Definitions (Rosettes, Oriented Selection

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 273
Usage Reference

Sets and Modeling Plies). The converted model can be subsequently used in Workbench projects. See
the Special Cases (p. 275) and the Known Limitations (p. 276) sections for more information.

Review the following import scenarios. The scenarios are different based upon whether or not you
are working with the mesh of the legacy model in ACP.

Equal Meshes
In this case, the section definitions of the legacy model are mapped according to the element labels
It also assumes that also the element normals are equal.

To import a legacy model that can be used in Workbench projects:

1. Add an External Model system to the Workbench project page and load the legacy file.

2. Add a new ACP (Pre) system to the Workbench project page.

3. Link the External Model system with the Engineering Data cell of the ACP system. This
loads the materials (cells A2-B2).

4. Link the External Model system with the Model cell of the ACP system in order to load the
mesh (cells A2-B3).

5. Refresh the ACP system Setup cell. Launch ACP.

6. Make sure that the unit system in ACP and the legacy model are the same.

7. From the action menu of the Model folder in ACP, select the option Import Section Data
from Legacy Model. Select the file you have opened in the External Model system (see
Import Section Data from Legacy Model (p. 64)). Verify that you have the correct material
mapping mask.

Figure 2.181: Configuration Overview

Note:

• Engineering Data renames the materials. The pre- and suffix masks enables the automatic
mapping between legacy material IDs and WB material IDs.

• Import each legacy model separately because the mapping is based on the element labels.
You can assemble the legacy files in a downstream Mechanical Model as needed.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
274 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

To import a legacy model in ACP standalone mode:

1. Start ACP in ACP standalone.

2. Load the file using the Import Model option from the Models action menu or File tab in the
application toolbar and select the Convert Section Data check box.

Different Meshes
If you are working with different meshes, you have to convert the legacy model by using the Com-
posite CAE H5 file format.

To convert a legacy model onto a different mesh:

1. In Workbench, import and convert the legacy model as described above (system A and B)

2. Update ACP Setup cell (A4) and export the lay-up to a HDF5 Composite CAE file (p. 64).

3. Create the ACP system (C) where you want to map the legacy lay-up to.

4. Link the External Model with the Engineering Data component to load the materials (A2-
C2).

5. Open the ACP Setup cell (C5) and import the Composite CAE H5 file (p. 64).

Figure 2.182: Configuration Overview

2.3.3.1. Special Cases

Lay-ups in ACP are either stacked on the top or the bottom of a shell surface. If the shell offset
direction of a Mechanical APDL model is not set to top or bottom, then the ply lying on the shell
surface is split into two plies on either side of the shell surface during the conversion.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 275
Usage Reference

Figure 2.183: A Four Ply Mechanical APDL Lay-up Where a Ply Crosses the Reference Surface
is Converted to a Five Ply ACP Lay-up

2.3.3.2. Known Limitations

The conversion of the composite lay-up of legacy Mechanical APDL models to ACP models only
works for shell models.

The proper translation of Mechanical APDL sections to ACP modeling plies can only be guaranteed
if the Mechanical APDL section points to a connected region of elements where all element normals
are oriented the same way. If this is not the case, a warning is issued on export and the resulting
lay-up may not be entirely correct.

The material transfer from External Model to Engineering Data is not supported on Linux. Alternatively
you can load the model in ACP standalone and export the materials in the Ansys Workbench XML
format (p. 71) and import from this file.

2.3.4. Tabular Data Format for Excel

A definition block starts with a cell value of BEGIN TABLE and ends with END TABLE. This cell is in the
first column (A) of the worksheet. The block DEFINITION is used to identify the type of tabular data
defined in the block. ModelingGroup, LookUpTable3D, and LookUpTable1D are currently the only
supported definition types.

Empty lines are not allowed inside of sub-blocks. Lines between sub-blocks are ignored. When the
lay-up is pushed from ACP, the formatting of existing cells is not changed. Missing field in the DATA
block are ignored and not set when synchronized with ACP. Hidden cells are not ignored and are
synchronized with ACP.

Figure 2.184: ModelingGroup Tabular Format in Excel

In the case of Look-Up Tables, if you add the text string "(Read Only)" to the column name, the cor-
responding Excel column is ignored.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
276 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

Figure 2.185: Look-Up Table Tabular Format in Excel

References to other objects (ply material, oriented selection sets, etc.) are defined by the object's ID.
In the case of ply material, the type of material and the material's ID are joined with a forward slash
(for example, fabrics/E-Glass). For the angle and thickness fields, the column name and the ID of the
lookup table must be provided (LookUpTable.1/Angle).

Communication to Excel is accomplished through the COM interface. The identifier used to connect
to Excel is Excel.Application.

You can find more information on how to exchange model data with Excel in Edit Entities with Ex-
cel (p. 23).

2.3.5. CSV Format

Materials, Look-Up Tables, Selection Rules definitions, and Modeling Groups can be exported and
imported using a .csv format (comma separated value file).

The .csv file format for the import and export of Look-Up Tables and Modeling Groups follows the
same format as the Tabular Data Format for Excel (p. 276).

Caution:

The CSV format uses a '','' as list separator. In some Regional Options in Windows, the list
separator is defined by another character (very often '';''). In this case, the .csv files will
not be properly read and written by Excel. Change the list separator in Windows Settings.

2.3.6. ESAComp
Model format: ESAComp XML files.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 277
Usage Reference

The following operations are available:

2.3.6.1. Export
2.3.6.2. Import

2.3.6.1. Export
Material data (Fabrics, Stackups and Sublaminates) and Sampling Points can be exported to ESAComp
XML. A Fabric represents a Ply in ESAComp and Stackups; Sublaminates and Sampling Points are
exported as Laminates.

To be sure that the imported values in ESAComp are in accordance to the ACP model, the FE import
units in ESAComp should be checked first.

• Open FE import and export units in ESAComp.

• Adjust units in the Model Properties dialog (see ACP Model (p. 61)).

2.3.6.2. Import
Import
As for the export, check that the units match in ESAComp and Ansys Composite PrepPost.

In ESAComp, there are 2 ways to export the data:

Script Format (recommended)

In ESAComp, you can export Plies and Laminates through the FE Export / ANSYS ACP option in the
menu. It generates a Python script, in which all the information is stored in ACP format.

XML Format
In ESAComp, export your data as .XML file using the File menu. Import this data in Ansys Composite
PrepPost with the context menu for the Material object in the Tree (see Material Data (p. 70)).

Only material data can be imported.

Important:

The Import from ESAComp XML operation does not create the material in Ansys Com-
posite PrepPost. It only changes the properties. So the material must be created before
with the same name as in ESAComp.

2.3.7. LS-Dyna
There are three ways to exchange an ACP composite model with LS-Dyna:

• LS-DYNA (Extension Library): This approach allows you to convert a Workbench model, including
Composite Definitions, to an LS-Dyna model. This is the recommended approach.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
278 of ANSYS, Inc. and its subsidiaries and affiliates.
 Exchanging Composite Definitions with Other Programs

• LS-Dyna Interface (ACP Add-on): Allows you to define Composite Definitions for LS-Dyna
meshes/models.

• LS-Dyna Solid Model (ACP Add-on): Allows you to export to the solid model in the .K file format.

Caution:

The add-on features described in this section are not recommended for general use. It is
strongly suggested that you use the Workbench interface to transfer information between
ACP and LS-Dyna.

2.3.8. BECAS
ACP can export the 2D mesh of a surface section cut to the cross-section analysis tool BECAS. This
allows you to derive a beam model from an ACP shell model.

The 2D mesh is built with linear elements and includes material information and lay-up orientations.
As a result, consider both geometric and material-dependent coupling.

The 2D mesh can also be exported to Mechanical APDL. In this case, no lay-up information is trans-
ferred.

For more details on exporting surface section cuts, see Section Cuts (p. 164).

For more information on the BECAS tool, see the BECAS website.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 279
 Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
280 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 3: Composite Modeling Techniques
The various composite modeling techniques available in ACP are described in the sections below:
3.1.T-Joint
3.2. Local Reinforcements
3.3. Ply Tapering and Staggering
3.4. Variable Core Thickness
3.5. Draping
3.6. Guide to Solid Modeling
3.7. Guide to Composite Visualizations
3.8. Guide to Composite Failure Criteria
3.9. Element Choice in ACP
3.10. Variable Material Data in Composite Analyses

3.1. T-Joint
T-joints are used to bond a primary structure to a secondary one. A good example is a frame with a
stringer of a boat hull. Oriented Selection Sets (OSS) allow you to define complex laminates by an in-
tuitive approach. For an example of a T-Joint analysis, see T-Joint Tutorial.

The laminate of a T-joint can be split into several sublaminates:

• Base plate (skin)

• Stringer (frame)

• Bonding

• Cover

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 281
Composite Modeling Techniques

Figure 3.1: T-Joint Lay-Up

The laminate is modeled by defining different Oriented Selection Sets for the different regions. The
modeling plies are then associated with the OSS and their order defines the stacking sequence of the
laminate.

The first OSS is defined for the base. The offset direction of this OSS shows from top to bottom as shown
in Figure 3.2: OSS for the Base Plate (p. 282).

Figure 3.2: OSS for the Base Plate

The OSS of the string has an orientation parallel to the global X-direction as shown in Figure 3.3: OSS
for the Stringer (p. 283).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
282 of ANSYS, Inc. and its subsidiaries and affiliates.
 T-Joint

Figure 3.3: OSS for the Stringer

The OSS feature allows you to define several offset directions for one element: OSS can overlap and
can have different orientations. This functionality is used to define the offset direction for the bonding
layers as shown in Figure 3.4: OSS for Bonding Plies (p. 283). The offset direction of the base plate is
different if compared with Figure 3.2: OSS for the Base Plate (p. 282).

Figure 3.4: OSS for Bonding Plies

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 283
Composite Modeling Techniques

In addition, the OSS feature allows you to define the reference directions for complex shapes (twisted
surfaces, right angles). The reference direction is computed from one or several reference coordinate
systems (CSYS) as shown in Figure 3.5: Reference Direction (p. 284). In this case two CSYS are selected.

Figure 3.5: Reference Direction

After all the necessary OSS are defined, define the Modeling Plies in the same order as the structure is
produced later. First, the base lay-up is defined using the OSS of the base plate.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
284 of ANSYS, Inc. and its subsidiaries and affiliates.
 T-Joint

Figure 3.6: Laminate of the Base Plate

The next plies are added to the stringer.

Figure 3.7: Laminate of the Base Plate and Stringer

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 285
Composite Modeling Techniques

It is important to define the base plate and stringer laminate before the bonding plies are defined because
the order is responsible for the final offset. As shown in Figure 3.8: First Bonding Laminate (p. 286), the
bonding layers are applied to the top of the base plate and onto the plies of the stringer.

Figure 3.8: First Bonding Laminate

On the other side, the second bonding laminate is offset to the top (base plate) and to the left (stringer).

Figure 3.9: Second Bonding Laminate

Cover plies complete the lay-up definition of the T-joint. Figure 3.10: Cover Plies (p. 287) shows that ACP
can also handle Drop-Offs.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
286 of ANSYS, Inc. and its subsidiaries and affiliates.
 Local Reinforcements

Figure 3.10: Cover Plies

3.2. Local Reinforcements

Regions with cut-outs, holes or load introduction elements are normally highly stressed and require
local reinforcements to prevent failure. ACP offers different ways to define local patches. Selection
Rules can be used to apply reinforcements to selected areas of the structure's geometry. The shape of
a reinforcing ply is defined by the intersection of an Oriented Selection Set and the selected Selection
Rules.

The examples Tutorial 3 and Tutorial 4 use Parallel Selection Rule and Tube Selection Rule to define
patches. Tutorial 4 describes how a Tube Selection Rule can be defined to add a ply following an edge.
The procedure involves these steps:

1. Define an Edge Set from the boundaries of an Element Set.

2. Create a Tube Selection Rule along the defined Edge Set with a certain inner and outer radius.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 287
Composite Modeling Techniques

Figure 3.11: Tube Selection Rule

3. Create a new ply and configure the Selection Rules in the Rule tab of the Modeling Ply Properties
dialog.

Figure 3.12: Rules Tab of the Modeling Ply Property Dialog

The selection rule parameters can be modified for each Modeling Ply. This allows you to work with
one Selection Rule to define the staggering of a laminate. You can activate a template and set the
new parameters. The final result can be double-checked with Section Cuts or a thickness contour
plot as shown in the figure below.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
288 of ANSYS, Inc. and its subsidiaries and affiliates.
 Ply Tapering and Staggering

Figure 3.13: Resulting Local Reinforcements

Selection Rules can also be combined with Oriented Selection Sets and other Selection Rule types
like Parallel, Spherical, or Cylindrical are also implemented in ACP. Any combination of these selection
rules allows you to create plies with complex shapes.

3.3. Ply Tapering and Staggering

Ply tapering and staggering can be quickly defined within ACP. Several examples are shown below.

3.3.1. Ply Tapering

Core plies are generally much thicker than regular or woven plies. This means that core edges must
be tapered for structural and manufacturing reasons. When a taper is applied to an edge of a ply in
ACP and the corresponding thicknesses are evaluated and mapped automatically onto the finite ele-
ments.

3.3.1.1. Edge Tapering

This section gives an overview of how the edge tapering feature works. The Taper Edges option
can be applied to modeling plies (p. 140). Its definition requires a constant taper angle along an
edge set. Optionally, a taper offset can be specified. Based on this definition, a virtual taper plane
is evaluated to taper the thickness of plies. The effective tapering or thickness distribution over the
taper is further dependent on the resolution of the mesh.

Figure 3.14: Simple Edge Tapering (p. 290) shows a schematic of a simple edge tapering. An Edge
Set runs along the side of a square of elements. Ply tapering is evaluated at each element along
the edge set. The taper edge offset specifies the normal (thus out-of-plane) distance from each
element adjacent to the element set. This offset forms a plane parallel to the underlying element.
The taper angle specifies the angle between this offset plane and the resulting taper plane. In the
figure, the resulting taper plane is the same for the whole edge set. The resulting taper planes are
oriented differently if the Edge Set follows a curved path. The offset direction is set to be positive
in the orientation direction of the oriented selection set of the modeling ply. Depending on the
mesh and application, it may have to be specified as a negative value.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 289
Composite Modeling Techniques

Figure 3.14: Simple Edge Tapering

3.3.1.2. Tapered Core

The Tutorial 3 example uses a tapered core. Open the model and check the Modeling Ply core_bwl
in the Modeling Group Hull. In the Thickness tab of the properties dialog a taper angle of 15
degrees is defined for the edge edgeset.2. A Section Cut or thickness contour plot illustrates
the final result as shown in Figure 3.15: Tapered Edge (p. 290).

Figure 3.15: Tapered Edge

3.3.1.3. Tapered Edges

In Tutorial 4, a Ply Tapering is defined along 2 edges. The procedure involves these steps:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
290 of ANSYS, Inc. and its subsidiaries and affiliates.
 Ply Tapering and Staggering

1. Define an Edge Set. In this case, the Edge Set is defined through a Named Selection in
Mechanical.

2. Open the Thickness tab in the Modeling Ply Properties dialog.

Figure 3.16: Tapering in Ply Definition

3. Select the edge and define the taper angle.

Figure 3.17: Thickness Distribution After Core Tapering

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 291
Composite Modeling Techniques

3.3.1.4. Tapering of Multiple Plies

The Taper Edges option for Modeling Plies is suitable for defining individual taper angles for
specific modeling ply. Its intended purpose is for use with a single tapered ply, such as a core,
however it can be used for tapering multiple plies. If the Modeling Ply tapering option is used for
multiple layers the taper angle is applied to each Modeling Ply and the vertical ply thickness dis-
tribution is superimposed. In such a case, the total taper angle of the lay-up is generally higher
than the individual taper angles. The total taper angle scales non-linearly with the number of plies
and their thicknesses. Furthermore, the taper size is a dependent on the size of the mesh. For this
reason, care should be taken when using the Taper Edges option for multiple plies. When modeling
a composite with a defined total taper angle a Selection Rule definition may be more suitable.
The trailing edge of an airfoil blade is an example for such an application.

The example below shows the effects of superposing multiple modeling plies that have the same
taper angle. The middle column shows a lay-up schematic while the right column displays the
corresponding representation of a section cut in ACP. The superposition of two different ply thick-
nesses results in two taper angles of which one is steeper than the nominal angle.

Figure 3.18: Superposition of Modeling Plies with Identical Taper Angles. Schematic (Middle)
and Section View Illustration (Right)

3.3.2. Ply Staggering

Cutoff Selection Rule

A Cutoff Selection Rule is used to cut plies and is suitable to define a ply staggering. This feature is
not limited to an edge because the staggering is derived from a CAD Geometry. The intersection
between the ply and geometry defines where the plies are cut. The ply offsets are taken into consid-
eration. This allows you to define a laminate where the total thickness follows a 3D shape.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
292 of ANSYS, Inc. and its subsidiaries and affiliates.
 Variable Core Thickness

Figure 3.19: Thickness Distribution of a Laminate with a Cutoff Selection Rule

Template Selection Rule

The template selection rule feature of the Modeling Ply allows you to use one Selection Rule to
define plies of different extensions. You can redefine the parameters of a selection rule in the Modeling
Ply Properties dialog. A wind turbine blade, for example, has hundreds of similar plies that only differ
in their the axial extension. Such plies can be defined with one Oriented Selection Set and one
Parallel Selection Rule and the use of template parameters. The template parameters are easily ad-
justed using the Import from / Export to CSV file feature in the context menu of the Modeling
Group.

Figure 3.20: Template Selection Rule Definition

3.4. Variable Core Thickness

In many cases, the thickness of a sandwich panel is constant or single plies have a constant thickness.
For structural efficiency, cores with variable thickness are used more often since CNC milling allows the
production of core plies with complex shapes.

In ACP there are three different ways to define a laminate with variable thickness:
3.4.1. Solid CAD Geometry

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 293
Composite Modeling Techniques

3.4.2. Look-Up Table

3.4.3. Geometry Cut-Off Selection Rule
3.4.4. General Application

3.4.1. Solid CAD Geometry

An external core geometry can be used to define the variable core thickness. The 3D shape of the
core is modeled in a CAD tool as a 3D solid or a closed shell. This CAD Geometry can be imported
directly into ACP or via Workbench.

Figure 3.21: Imported Core Geometry

In the Thickness tab of the Modeling Ply Properties dialog, the thickness definition can be changed
from Nominal to From Geometry. In this case, ACP samples through the geometry in the normal
direction and evaluates the thickness of the core for each element. The original thickness defined in
the Fabric definition becomes obsolete. This method is used in the Tutorial 3 example..

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
294 of ANSYS, Inc. and its subsidiaries and affiliates.
 Variable Core Thickness

Figure 3.22: Modeling Ply Thickness Definition

Figure 3.23: Section with Variable Core Thickness

3.4.2. Look-Up Table

The variable core thickness can also be defined with a Look-Up Table. A Look-Up Table is used to
define a data field or tabular values. Thicknesses, angles and directions can be defined in a Look-Up
Table and the 3D mapping function of ACP inter- or extrapolates the values for each element. You
define the thickness of the ply material for certain support points. The figure below shows a list of
different angles and thicknesses for selected data points.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 295
Composite Modeling Techniques

Figure 3.24: Table Definition

Following on, the corresponding tabular field can be selected in the Thickness tab of the Modeling
Ply Properties dialog.

Figure 3.25: Thickness Definition Through Tabular Values

The final result can be investigated with Section Cuts or a thickness contour plot as per usual.

3.4.3. Geometry Cut-Off Selection Rule

Another way of achieving a variable core thickness is to use a Cut-Off Selection Rule. Even if the
cutting operation only applies to a core layer, it is dependent on the entire lay-up. If the thickness of
the bottom laminate is changed, the thickness of the core is cutoff at a different height. In this way,
a laminate thickness limit can be set. This can be a very useful in places where the laminate thickness
is limited, near a trailing edge of a blade for example.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
296 of ANSYS, Inc. and its subsidiaries and affiliates.
 Variable Core Thickness

Figure 3.26: Section Cut and Thickness Contour Plot

The core thickness can be set to be cut in different ways depending on the Ply Tapering option of
the Selection Rule. It can either follow the exact intersection with the CAD Geometry or can be cut
off to two discrete size - its nominal thickness or no thickness at all.

The Cut-Off Selection Rule has to be used with precaution as any modification of the underlying
plies might modify the core.

An example of a Cut-Off Selection Rule can be found in Tutorial 4.

Figure 3.27: Imported Cut-Off Geometry

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 297
Composite Modeling Techniques

Figure 3.28: Resulting Thickness Distribution (Ply Tapering Activated)

3.4.4. General Application

The described features can also be used in combination with regular or woven materials and are not
restricted to core materials. The selection of the method is often derived from the manufacturing
process. Tabular values can be used for a winding process and CAD geometries for a CNC milling
process. A Cut-Off Selection Rule (p. 296) is often used in regions of sharp tapered edges (trailing edge
of a wind turbine blade).

3.5. Draping
The ply application (draping) on doubly curved surfaces changes the theoretical fiber orientations. In
many cases the effect is small and can be neglected. On the other side it is important to know how big
this effect can be and if it has to be considered. ACP allows you to evaluate the draped fiber directions.
These angles can be visualized and are considered in all analyses, resulting in more accurate evaluations.
The draping is evaluated on the Production Ply level. In addition the draping algorithm of ACP evaluates
the flatwrap of the Production Plies which can be exported for manufacturing purposes.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
298 of ANSYS, Inc. and its subsidiaries and affiliates.
 Draping

Figure 3.29: Flatwrap (Boundary)

3.5.1. Internal Draping Algorithm of ACP

The draping algorithm is described in Draping Simulation (p. 373).

Draping Method Definition

The draping effect depends highly on the manufacturing process. Process-relevant values can be
defined in the ACP draping algorithm.

Seed Point
The Seed Point is the starting point where the ply is laid into the mold. At this location the fiber
direction is unchanged and the draped fiber direction is equal to the theoretical one. The Seed Point
can have a big influence on the final result of the draped fiber angles. Assuming a half sphere and a
Seed Point located on the pole, the maximum draped fiber angle is much smaller than the same
evaluation with a Seed Point on the equator. The Seed Point corresponds to the first element of the
draping mesh (left representation in Figure 5.1: Draping Scheme (p. 374)).

Draping Direction
After the first point is applied on the mold, the Draping Direction defines along which route the ply
is laid into the mold. The draping algorithm first walks along the Draping Direction, then orthogonal
and finally proceeds with the 45-degree zones. Figure 5.1: Draping Scheme (p. 374) shows the scheme
in which the ply is applied.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 299
Composite Modeling Techniques

Draping Mesh
The draping algorithm minimizes the shear energy dissipation where an internal Draping Mesh is
used for the evaluation. This mesh is independent from the structural mesh and has its own size.
Analog to the structural mesh, the optimal Draping Mesh size is established by balancing the precision
of the draping evaluation and the computational cost.

In the case of an incomplete draping, select another Seed Point, define a different Draping Direction
and/or change the Draping Mesh size. The draping mesh is built as shown in Figure 5.1: Draping
Scheme (p. 374).

Figure 3.30: Draping Mesh with Shear Energy

Draping Definition on OSS Level

The draping can be activated in the Draping tab of the Oriented Selection Set Properties dialog.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
300 of ANSYS, Inc. and its subsidiaries and affiliates.
 Draping

Figure 3.31: Draping Definition in OSS

If draping is activated on the OSS level, the Reference Direction of the OSS is adjusted and all associated
modeling plies use this draped reference direction. If the Modeling Ply also has an active draping
definition, then an independent draping simulation is started for the modeling ply.

Draping Definition on Modeling Ply Level

Just like OSS, draping can be activated on the Modeling Ply level. To activate the draping you toggle
the Draping check box and define a Seed Point. By default, the Mesh Size and Draping Direction
are evaluated automatically.

By default, during the draping simulation the draping mesh is laid on the reference surface of the
model independently of the lay-up thickness. If the model property Use Draping Offset Correction
is enabled, the draping mesh follows the bottom offset (relative to the reference surface orientation)
of the selected ply, thus taking into account the lay-up thickness.

An additional feature, Thickness Correction, is implemented in the Internal Draping algorithm. Due
to the shear deformation, the fiber direction and thickness of the ply change. This change can also
be considered by activating the Thickness Correction option.

3.5.2. User-Defined Draping

ACP can also handle user-defined draping results. The draped fiber directions can be imported as a
Look-Up Table and used instead of Internal Draping.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 301
Composite Modeling Techniques

Figure 3.32: Tabular Values Definition of Draping

The first angle Correction Angle 1 defines the correction of the material reference direction and is
also considered in the analysis. The second value Correction Angle 2 can be used to define the cor-
rection angle of the material 2 direction for woven materials. In ACP, the second correction is not
considered in any evaluation and is just for information or third party products.

3.5.3. Visualization
The result of the draping evaluation can be visualized on the Production Ply and the Analysis Ply
level. The flatwrap and the draping mesh can be visualized through the use of a Draping Mesh
Plot (p. 210). The contour plot of the draping shows the average shear (distortion) angle of each element
(in degree). Zero means no shear deformation. Depending on the Scene configuration the flatwrap
is also available in the Ply Book (p. 245). In addition the Production Ply functionality allows you to
export the flatwrap as a .dxf file.

The last result of the draping are the draped fiber directions which are considered in the analysis.
These directions can be visualized with the Show Draped Fiber Directions button. This visualization
combined with Show Fiber Directions highlights the influence of the draping.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
302 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Solid Modeling

Figure 3.33: Fiber and Draped Fiber Directions

3.6. Guide to Solid Modeling

This section describes when and how to work with the Solid Model (p. 303) feature in ACP (Pre). In this
context we are talking about the solid model extrusion and not the lay-up mapping feature within the
Imported Solid Model.

In the case of thick composites, the layered shell theory can cause significant errors in the obtained
results. In some cases it is necessary to work with 3D models (solid models). ACP has the advanced
features to generate layered solid models based on the shell lay-up definitions. Based on the shell mesh
and the ACP composite definitions, ACP generates layered solid elements representing one-to-one the
composite part. Drop-Offs, staggering and tapering are also considered. In addition the solid model
extrusion allows to define extrusion directions, boundary curves, and cut-outs. Finally, virtual cracks
(fracture analysis) and contacts between plies can be modeled by Interface Layers (p. 145).

In general we recommend working with the "standard" Solid Model because the extrusion approach
allows you to generate a one-to-one solid model. If this is not feasible, then the lay-up mapping approach
within the Imported Solid Model (p. 196) is a great alternative. Modeling full cross-section composites
such as composite springs or turbine blades, for instance. Example analyses for both approaches are
available: Composite Solid Model (p. 331) and Analysis of a Mapped Composite Solid Model (p. 346).

The following sections give a brief guide to Solid Modeling:

3.6.1. When to Use a Solid Model
3.6.2. How to Use the Solid Model Feature

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 303
Composite Modeling Techniques

3.6.3. Principles of Solid Model Generation

3.6.4. Drop-Off and Cut-Off Elements
3.6.5. Workflow
3.6.6. Practical Tips
3.6.7. Known Limitations

3.6.1. When to Use a Solid Model

From an analysis point of view, the choice between a shell or solid element analysis models largely
depends on the structure and the type of structural investigation.

Solid models are inherently larger and computationally more expensive than shell models. It is
therefore wise to start an analysis with a shell model before moving on to a solid model. It provides
a basis for comparison but it is also a good check on whether the model is solvable.

Typically, a solid model describes the behavior of a structure more precisely when its out-of-plane
response becomes significant. ACP has the unique feature of representing the 3D stress state for a
shell model. Shell model stress behavior can therefore be taken as a first indication of the 3D stress
state. If the out-of-plane stresses are significant then it may be worthwhile analyzing the structure as
a solid element model.

The following list shows cases where are a solid element model can be used. The solid modeling
feature is not limited to these examples.

• Analysis of thick structures

• Investigation into 3D stresses (high element resolution necessary)

• Investigation into debonding

• Investigation into edge effects

• Buckling analysis of sandwich structures

There are no hard rules on this matter. It remains entirely the choice of the designer when to use a
solid model in addition to or instead of a shell model.

3.6.2. How to Use the Solid Model Feature

The intention of the solid model feature is to generate analysis models for structures that are built
in one piece.

The feature itself makes no distinction between generating solid element models that are analyzed
in isolation or ones that are analyzed in combination with other components. There is however a
distinct difference in how the analysis of a solid element model of multiple components can be ap-
proached. The components of an assembly can either be extruded individually or extruded as one
assembly. Both approaches are possible within ACP yet they both have advantages and limitations.

The recommended approach is to generate individual components and connect them using contacts
in a Workbench Analysis System. This follows the intention that Solid Models are only created for

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
304 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Solid Modeling

components that are to be built in one piece. Additional connecting structures can be also fully
modeled or dimensioned with the help of substitute model.

The other approach is the extrusion of an entire assembly in one solid model generation. This method
is not only limited by the topological complexity of a geometry but also by a reduced stiffness at
transitions as a result of Drop-Off elements. On the other hand, this approach offers the ability to
model all connecting structures in full.

3.6.3. Principles of Solid Model Generation

The solid model feature requires a reference shell geometry and a composite definition to construct
a solid element model.

Solid model settings control how the solid model is divided into elements in the thickness direction
and how Drop- and Cut-Off elements are handled. The level of detail required in the solid model
depends on how accurate certain features are to be modeled. This depends on the judgment of the
designer.

The feature has additional ways to enhance the resulting solid model to be as detailed as necessary:
ply staggering and tapering are transferred from the composite definitions. Extrusion Guides add
more complex possibilities in shaping the model. The Snap-To functionality makes an alignment with
an external CAD geometry possible. Arbitrary cut-outs or cut-offs can be created with Cut-Off Geo-
metries. The Cut-Off operation is analogous to machining a composite part after curing.

Geometry operations (Extrusion Guides, Snap-To and Cut-Off geometries) help to shape a solid
model into the desired shape. These operations are applied sequentially to the solid model. You
should explore all possibilities of shaping the solid model first with the help of Extrusion Guides and
Snap-To geometries before moving on to Cut-Off features. While Cut-Off geometries allow great
freedom in shaping a solid model, they also introduce degenerated elements which are limited in
representing a layered composite. For more information, see Drop-Off and Cut-Off Elements (p. 305).

Details of the solid model feature are explained in the Usage Reference (p. 57).

3.6.4. Drop-Off and Cut-Off Elements

Drop-Off and Cut-Off elements cannot store any layered information and therefore must be associated
with a homogenous material.

Drop-Off elements are created when ply boundaries exist inside the part. When the plies come to an
end, the solid model extrusion creates a Drop-Off element in the shape of a triangular prism. The
Drop-Off Elements can be modeled with either the ply (or core) material, a different material such as
resin, or as a void.

Cut-Off elements are created when a hexahedral element is diminished by a Cut-Off operation and
decomposed into prism or tetrahedral elements. These elements can also be modeled with different
homogenous materials.

The Cut-Off features offer great freedom in shaping a solid model. The trade-off when using the Cut-
Off feature is that elements diminished by the cutting operation are decomposed into homogenous
tetrahedral and prism elements. These elements cannot store any layered information and the post-
processing results for Cut-Off regions must be interpreted with care.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 305
Composite Modeling Techniques

Both Drop- and Cut-Off elements can cause steps in the structural stiffness, which may lead to stress
peaks and higher IRFs. This affects the homogenous elements as well as the layered elements in their
proximity.

For information on the postprocessing of stresses and strains of homogeneous elements, see Postpro-
cessing of Drop-Off and Cut-Off Elements (p. 260).

3.6.5. Workflow
A solid model is easily created alongside an existing shell model in Workbench. Once a solid model
has been generated in ACP-Pre it can be linked to new Analysis System. A single ACP-Pre system can
be used to create a shell and a solid model analysis. This workflow is shown below:

Figure 3.34: Analyzing a Solid Model Alongside a Shell Model

The analysis of an assembly requires multiple solid model components to be connected in a Workbench
system. The components can be connected with contacts in Mechanical, for example. As a consequence,
the connections can be modeled and analyzed in detail. The Composite Failure Tool in Mechanical
permits the analysis of all composite parts at once or for a selected scope of interest. The post-pro-
cessing of ACP Post supports more features with respect to composites but it is limited to a single
component (ACP Pre system).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
306 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Solid Modeling

Figure 3.35: Solid Model Assembly Workflow

3.6.6. Practical Tips

The solid modeling process is generally more complicated than shell modeling is. The shape and
mesh of a structure have a strong influence on the robustness of the solid modeling process. Generally
speaking, the less complex the model the more robust the process. The challenges of composite
modeling can vary greatly. Following composite design principles for structural concepts will aid the
solid modeling process. Abrupt changes in shape and sharp edges are not advisable in composite
design and also cause problems in composite modeling.

You can use Named Selections to define boundary conditions, contacts, and much more. Named Se-
lections also contribute to making your model associative which automates the update process. For
this reason Named Selections of the shell geometry are converted and maintained in the solid model
workflow as shown in the figure below. An edge becomes a wall (edge_1 ⇒ EDGE_1_WALL) and a
surface is converted into a bottom and top surface (face ⇒ FACE_BOT and FACE_TOP) in the solid
of the downstream Mechanical system.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 307
Composite Modeling Techniques

Figure 3.36: Conversion of the Named Selections in the Solid Model Workflow

3.6.7. Known Limitations

Awareness of the limitation of solid modeling can help you build a better solid model. It is worth
spending time thinking about aspects of your model such as mesh sizing, extrusion methods, and
geometry operations. For example, it can often be more robust to extrude from the inside out.

This section gives an overview of the limitations of these advanced modeling features:

Mesh Extrusion

The solid model relies on the extrusion of a shell geometry mesh. As the extrusion directions and
operations increase the solid model generation reaches a limit of how heavily a shell mesh can
be distorted. If the topology of the structure is complex then the extrusion operations can result
in ill-formed elements which are subsequently deleted in the element check.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
308 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Solid Modeling

Drop-Off Elements

There are transition regions where an edge of a solid model extrusion is reduced to a series of
Drop-Off elements. This reduction in thickness will result in a local reduction in stiffness that
should not be overlooked.

Cut-Off Elements

Cut-Off elements are decomposed into homogenous tetrahedral and prism elements. These ele-
ments can cause abrupt changes in the structural stiffness which may lead to higher stresses and
IRFs. The results in the proximity of Cut-Off elements should be evaluated with care.

Connect Butt-Jointed Plies

The ability to connect adjacent plies is currently restricted to plies that appear sequentially in the
same Modeling Group. Consequently, there a certain arrangement where a ply drop-off cannot
be evaded.

Solid Model Extrusion Offset

The solid model extrusion starts from a reference shell and the lay-up definition. An extrusion
with an offset to the reference geometry is not possible.

Sampling Points, Section Cuts, and Sensors

Sampling points, Section Cuts, and Sensors give information about the lay-up as it was defined
in the Modeling Ply Group. The changes as a result of geometric operations in the solid model
are not reflected in these features. While Cut-Off plies still appear in the sampling point, these
plies show zero stress and strain during postprocessing.

Recomputation of ISS

The recomputation of interlaminar shear stresses only corrects the stresses of layered elements.
Homogenous elements (Drop-Off and Cut-Off elements) retain the interlaminar shear stresses of
the .RST file.

Interface Layers / Elements

Element faces located above and below an interface element must have the same shape (quadri-
lateral or tetrahedral). If their shapes are not the same, the interface element is removed. This can
happen due to the effect of Drop-Off elements (p. 305) (as shown in the figure below). It can also
happen when interface elements intersect a Cut-Off Geomety (p. 305) and the interface element
is not updated. As a result, the interface element does not conform to the new shapes of the
adjacent top and bottom elements.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 309
Composite Modeling Techniques

Figure 3.37: A quadrilateral interface element surrounded by a brick element and two
tetrahedral elements created when the Drop-Off is split

Node Merge Operations on Composite Solid Model Assemblies

The use of node merge operations in Mechanical on composite solid models can lead to incorrect
deformation results in ACP-Post deformation plots. When node merge operations are used, the
Read Strains and Stresses option in the Solution Properties (p. 224) should be active. Appropriate
warnings are issued.

3.7. Guide to Composite Visualizations

There are several features available in ACP that help in visualizing a composite model. Some features
aid in the verification of the lay-up definition. Others provide an insight into the stresses, strains, and
failures and can thus help in the optimization of a structure.

This section aims to be a brief guide to the some of the available functionality.

3.7.1. Model Verification

Two features are very useful for checking the lay-up definition before solving the model. One is the
Orientation Visualization, the other is the Section Cut feature.

The Orientation Visualization can display the direction and/or orientation of the elements, Oriented
Selection Sets, and plies. Refer to Scene Manipulation (p. 22) for more information.

After the whole definition of the lay-up, a visual verification of the lay-up sequence can be very useful.
Section Cuts offer a useful visual check once the lay-up has been determined. By defining one or
several Section Cuts, the ply position (number in the sequence) and orientation can easily be verified.
Refer to Section Cuts (p. 164) for more information.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
310 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Composite Visualizations

Figure 3.38: T-Joint Section Cut

Figure 3.39: Class40 Section Cut

3.7.2. Postprocessing Visualizations

There are several features that can be used for viewing the results of a simulation. They all can give
a different insight into the behavior of the composite structure. The different postprocessing visualiz-
ations mentioned below are also described in the last part of Tutorial 1.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 311
Composite Modeling Techniques

Deformation
The deformation of a structure can be visualized with deformation plot for a specific solution (see
Solution Plots (p. 227)). The plot can be scaled by setting the deformation scale factor in the Solution
Properties dialog.

Figure 3.40: Activate Deformed Geometry in the Solution Properties Visualizations

Figure 3.41: Activate the Deformation Plot for Total Deformation

Failure Criteria
The failure plot displays the critical safety factors (reserve factors, inverse reserve factors & margin of
safety) to first ply failure for a given failure criteria definition.

The safety factors are evaluated for every element and every layer and the critical value through the
thickness of the lay-up is then projected on to the reference shell mesh. A failure plot for an envelope
solution works in the same way and is a display of the most critical failure of all included solution
sets. Alternatively, the safety factors can be displayed ply-wise for each analysis ply.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
312 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Composite Visualizations

A failure criteria definition must be defined before creating a failure plot (see Definitions (p. 221)). A
failure plot can be inserted under a normal solution or an envelope solution and the predefined failure
criteria definition can be selected. Additionally, critical failure modes, critical plies and critical load
case (in case of solution envelope) can be displayed as element labels.

Figure 3.42: Activate the Failure Criteria Plot with Failure Mode and Critical Ply Information

Figure 3.43: IRF Value and Text Plot for Each Element (Tutorial 1)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 313
Composite Modeling Techniques

Figure 3.44: Zoom on Critical Area (Class 40)

Ply-Wise Results
The structural behavior throughout the lay-up at each layer is of great interest in composite design.
Ply-wise information helps to identify and optimize layers that are critical and ones that are not.

All the solution plots except the deformation plot have the option of displaying results ply-by-ply
(see Solution Plots (p. 227)). The plot will only display results if a ply is selected. Plies can be selected
in the Modeling Groups, Sampling Point, or Solid Model Analysis Plies.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
314 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Composite Visualizations

Figure 3.45: Activate the Ply-Wise Results in the Plot Properties

Figure 3.46: Select an Analysis Ply in the Modeling Groups or Sampling Points

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 315
Composite Modeling Techniques

Figure 3.47: Ply-Wise Stress (Tutorial 1)

The Sampling Points (p. 161) are an alternative way of analyzing a lay-up on a ply level. A point of
interest on the composite part is selected and its local lay-up is sampled. The feature can display
failure criteria, stresses and strains through the thickness of the laminate. In this way, the Sampling
Point gives a detailed insight into the laminate behavior ply-by-ply.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
316 of ANSYS, Inc. and its subsidiaries and affiliates.
 Guide to Composite Failure Criteria

Figure 3.48: Stress Analysis for Selected Sampling Point

3.8. Guide to Composite Failure Criteria

ACP-Post provides a number of failure criteria for the strength assessment of composites. Both established
and basic as well as recent and advanced failure criteria are included in the program. This section
provides some guidance on the selection of failure criteria.

• It is advised that you use failure criteria that distinguish between different failure modes (for example,
fiber failure or matrix failure).

• The use of all-inclusive quadratic failure criteria is not advised (for example, Tsai-Wu, Tsai-Hill, or
Hoffman). In most situations, these criteria are less accurate than others and provided minimal inform-
ation on any failure.

• It is more conservative to combine different failure criteria (Puck, Max Stress, and LaRC) than using
any single criterion.

• In general, failure criteria that consider all in-plane stresses (s1, s2, s12) and the out-of-plane interlam-
inar shear stresses (s13, s23) should be used, as these results are available in a shell model.

• 3D stresses (s3) can often be ignored in thin laminates with moderate curvature. Otherwise, Puck 3D
can be used to investigate delamination.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 317
Composite Modeling Techniques

• 3D solid models can be used to get more accurate results, especially if out-of-plane stresses are being
investigated.

• Wrinkling and Core Failure should be evaluated for sandwich structures.

• The use of Puck 2D is recommended over the use of Puck Simplified.

For more information, see Failure Analysis (p. 383) and Postprocessing (p. 256). A comprehensive compar-
ison of composite failure criteria was carried out in the worldwide failure exercise [ 38 (p. 597) ].

3.9. Element Choice in ACP

This section describes the composite modeling techniques for the use of shell, solid, and solid-shell
elements.
3.9.1. Introduction
3.9.2. Shell Elements
3.9.3. Solid Elements
3.9.4. Solid-shell Elements

3.9.1. Introduction
The underlying principle of ACP is that a composite lay-up is defined on a shell geometry. The model
of the lay-up that is passed from the ACP preprocessor to the solver can be a shell element mesh but
also a solid or a solid shell element mesh. The solid model mesh is an extrusion of the shell element
input mesh. If this input shell mesh uses linear elements (SHELL181) the solid model mesh generated
in ACP can have either layered solid elements (SOLID185) or layered solid shell elements (SOLSH190).
If it is quadratic (SHELL281) the solid model mesh can only have quadratic layered solid elements
(SOLID186).

The geometry and loading of the engineering problem ultimately dictate what element type is best
suited for the analysis. The following sections outline a few general considerations about the element
types in ACP. For more detailed information, see Element Library in the Mechanical APDL Theory Ref-
erence.

3.9.2. Shell Elements

Shell elements are suited for modeling thin-walled to moderately thick-walled structures. Shell elements
are compliant in bending and give good deformation results while being computationally inexpensive.

3.9.3. Solid Elements

Solid elements are aimed at modeling thick walled structures. As laminate thicknesses increase, out-
of-plane stresses become more significant; Solid elements are better at approximating these effects.
Furthermore, layered solid elements allow the incorporation of composite parts in larger solid model
assemblies.

A shortcoming of these element types is that they are typically too stiff in bending when elements
are thin. Displacements can be wrong by an order of magnitude as the elements undergo a phenomen-
on called locking. Element technologies such as Enhanced Strain Formulation try to remedy this nu-

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
318 of ANSYS, Inc. and its subsidiaries and affiliates.
 Variable Material Data in Composite Analyses

merical locking but are not sufficient to do so in linear 3D solid elements. Quadratic solid elements
(SOLID186) offer a better solution, however, this comes at an increased computational cost.

3.9.4. Solid-shell Elements

Solid-shell elements cover the spectrum between shell and solid elements and are best suited for
modeling thin to moderately thick structures. Thin solid-shell elements do not undergo locking and
are able to give good results for out-of-plane stresses and strains.

3.10. Variable Material Data in Composite Analyses

Composite modeling in Workbench provides the possibility to account for variability in the mechanical
properties of composite materials due to any scalar user-defined quantity. Temperature, Shear Angle
(defined through ACP-Pre draping (p. 298)), and Degradation Factor are predefined variables in Workbench
Engineering Data to be used for refining a composite material's behavior. You are free to define your
own field variables.

The following mechanical properties can be defined as variable:

• Isotropic elasticity

• Orthotropic elasticity

• Orthotropic stress limits

• Orthotropic strains limits

Dependencies are specified in tabular form in Engineering Data.

An interpolation scheme is used to evaluate the locally effective properties given the local field variable
states in the model. For information on how the interpolation scheme is controlled, see Variable Data
Interpolation Settings (p. 321).

Once the dependencies are defined in Engineering Data, they are accounted for in subsequent composite
analyses and postprocessing. The Shear Value is defined by draping simulation in ACP-Pre, the Temper-
ature is computed or defined in Structural, Transient Thermal, or External Data systems. The state of all
other fields should be defined in ACP-Pre. The state of all other fields can be defined by means of Field
Definitions in ACP-Pre or External Data systems.

Variable material data is compatible with both shell and solid elements.

An example analysis using variable material data is given in Analysis Using Variable Material Data (p. 339).

3.10.1. Element- or Layer-wise Field Definition

You can specify the distribution of any variable used in the definition of a Variable Material in ACP.
This is done by means of Look-up Tables. A scalar Look-up Table column can be associated with with
a field variable. The state of the field variable is interpolated from the scalar Look-up Table column
over the finite element model. To this end, you can specify whether this interpolation is applicable
for the entire model or only specific parts of it. The field definition can be scoped to a combination
of:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 319
Composite Modeling Techniques

• Element Sets

• Oriented Selection Sets

• Modeling Plies.

Element Sets or Oriented Selection Sets as scope of the field definition always affect all layers of their
underlying finite elements. In contrast, scoping Modeling Plies refines the selection to specific layers
of their underlying finite elements. The Field Definition then applies to the layers of the covered finite
elements associated with the Analysis Plies of each Modeling Ply. Elements and layers not covered
with a field variable definition assume the default value for this variable.

Altogether, a Field Definition can be scoped to the full FE-model or refined to affect only subparts
and, furthermore, only layers.

See the Field Definition (p. 158) for additional information about the object as well as object set-up.

3.10.2. Draping Shear

Ply draping on arbitrarily shaped surfaces leads to local shearing of the plies. This manufacturing-in-
duced artifact can lead to significant deviation between the assumed and effective mechanical
properties. This is because the shearing can be in the order of several degrees before ply wrinkling
becomes an issue. Thus, the configuration of the composite can vary considerably from point to point,
as can the mechanical properties.

In order to reflect the mechanical properties’ dependence upon draping shear, ACP-Pre provides a
draping simulation tool. Upon specifying shear-dependent material properties in Engineering Data
and enabling draping (p. 298) in ACP-Pre for individual plies or Oriented Selection Sets, downstream
analysis systems take this effect into account.

The draping shear angle is defined as:

|draped_transverse_angle - draped_fiber_angle| - 90

Where "draped_fiber_angle" and "draped_transverse_angle" denote the angles of the draped fiber
and transverse directions with respect to the reference direction, respectively. Thus, a shear angle of
0 degrees indicates that the ply at the corresponding location is unsheared.

3.10.3. Degradation Factors

Composite parts can exhibit a number of artifacts leading to local degradation of mechanical properties.
Such flaws can be the result of a manufacturing process or can develop during operation. Examples
of these types of flaws include voids, imperfect resin impregnation of fibers, deviation of the fiber
alignment from the design angle, and resin traps.

If such artifacts are known, you can account for them using degradation factors. The typical assumption
is that a degradation factor of 1.0 indicates a sound material, while a degradation factor of 0.0 implies
a disintegrated material. Degradation-dependent material properties can be specified in Engineering
Data.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
320 of ANSYS, Inc. and its subsidiaries and affiliates.
 Variable Material Data in Composite Analyses

3.10.3.1. Definition of the Degradation Factor Field

The degradation factor fields are defined by means of a Field Definition object. If Degradation Factor
has been used to define one of the materials in Engineering Data for the current composite analysis,
you can select it from the drop-down menu under Field Variable Name, as shown in the Figure
below. The scope of applicability of this Field Definition is set under Scope Entities to a combination
of Element Sets, Oriented Selection Sets and Modeling Plies. The degradation factors are interpolated
from the selected Look-up Table Column upon update of the ACP system: for shell elements the
field state values are evaluated at the element centroid taking into account the actual ply offsets
if Include Shell Offset is activated; for solid elements the actual ply position is always considered
and this behavior cannot be changed.

All downstream analysis systems will make use of the information provided for the Degradation
Factor in the Field Definition object.

Figure 3.49: Field Definition Properties to Set Up a Degradation Factor Field

3.10.4. Definition of General User-Defined Fields in ACP-Pre

The Engineering Data enables you to define Isotropic and Orthotropic Elasticity as well as Stress and
Strain limits as a function of up to nine user-defined scalar field variables. Engineering Data pre-defines
Temperature, Degradation Factor and Shear Angle fields. If necessary, you can add a custom field
variables. From within ACP, the custom field variables have to be defined as described by Field
Definition Object Properties (p. 158) for Element- or Layer-wise definitions. From the Workbench-level,
External Data components can be used to define custom field variables. Please note, however, that
External Data components do not permit layer-wise field definitions.

3.10.5. Variable Data Interpolation Settings

The interpolation algorithm and its settings can be controlled from Workbench Engineering Data. For
details on the interpolation schemes available and settings of the interpolation engine, see General
Interpolation Library (p. 414).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 321
 Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
322 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 4: Example Analyses
The following examples demonstrate some of the commonly used features and workflows in ACP.
Other examples and tutorials can be found in the ACP Tutorials. You must be familiar with the basics
of the software to understand the analysis examples in this section.
4.1. Analysis of a Composite Shell Model
4.2. Analysis of a Composite Solid Model
4.3. Analysis Using Variable Material Data
4.4. Analysis of a Mapped Composite Solid Model
4.5. Shear Dependent Materials in Composite Analysis
4.6. 3D Ply Workflow – Imported Plies
4.7. ACP for Workbench LS-DYNA: Bird Strike

4.1. Analysis of a Composite Shell Model

Tutorials 1 and 2 give a good insight into the ACP functionality. While the tutorials always start with
an existing model this section outlines the generic build-up of a composite shell model. Selected steps
are explained in more detail below and highlighted with a link.

• Preprocessing

– Add ACP (Pre) Component to the project (p. 324)

– Define Engineering Data (p. 325)

– Import or construct Geometry (Units) (p. 328)

– Open the Model and

→ Define Named Selections/Element Sets (p. 328)

→ Generate Mesh

– Open ACP (Pre) (p. 328) and

→ Define Fabric

→ Define Rosettes and Oriented Selection Sets

→ Create Modeling Plies

• Workbench Analysis System

– Add Analysis System to the project (p. 329)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 323
Example Analyses

– Open the Analysis System and

→ Define Analysis Settings

→ Define Boundary Conditions

– Solve model (update the project)

• Postprocessing

– Add ACP (Post) component to the project (p. 330)

– Open ACP (Post) and run the post-processing

4.1.1. Preprocessing
The steps involved in pre-processing are described in the sections below:
4.1.1.1. Workbench Integration
4.1.1.2. Adding ACP Components to the Project
4.1.1.3. Engineering Data
4.1.1.4. Properties
4.1.1.5. Geometry and Units
4.1.1.6. Named Selections and Elements/Edge Sets
4.1.1.7. Starting and Running ACP

4.1.1.1. Workbench Integration

The Workbench Add-in of ACP installs two additional Component Systems to the Workbench
Toolbox: ACP (Pre) and ACP (Post). These systems allow transferring the composite definitions of
ACP between ACP and Mechanical on the Workbench schematic level. ACP is now fully integrated
in the data structure of Ansys Workbench and the update and refresh logic.

It is important that the user updates (refresh) the upstream data to pass the modifications to the
ACP components. The update symbols can be used to check the up-to-date status of each compon-
ent.

4.1.1.2. Adding ACP Components to the Project

The components ACP (Pre) and ACP (Post) are available in the Toolbox menu.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
324 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Shell Model

Figure 4.1: ACP Components

These components are handled in the Project Schematic like the other standard components
(drag-and-drop or right mouse-click menu).

4.1.1.3. Engineering Data

With the installation of ACP a new material catalog named Composite Materials is available in the
databank. This catalog contains typical materials used in composite structures like unidirectional
and woven carbon and glass, or core materials. Within the Workbench workflow of ACP, the mater-
ials have to be defined in Engineering Data and not in ACP (Pre).

Figure 4.2: Engineering Data Sources

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 325
Example Analyses

Figure 4.3: Outline of Composite Materials

4.1.1.4. Properties
To fulfill the ACP requirements, the materials in Ansys Workbench have some additional properties
which are highlighted below.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
326 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Shell Model

Figure 4.4: Material Properties for ACP

The new properties are:

• Ply Type: Physical behavior of the material like core, unidirectional or woven ply.

• Strengths:

– Orthotropic Stress Limits

– Orthotropic Strain Limits

– Isotropic Strain Limits

• Composite Failure Parameters:

– Tsai-Wu Constants

– Puck Constants

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 327
Example Analyses

– LaRc03/04 Constants

– Additional Puck Constants

– Woven Specification for Puck.

More information about the ACP material definitions are described in Section Material Data (p. 70).

4.1.1.5. Geometry and Units

A shell geometry is required for building any composite model in ACP. The geometry can either
be constructed in the Ansys DesignModeler or imported as a CAD file.

The ACP unit system is independent from the unit system in the Mechanical application (user inter-
face or solver). The transfer from the Mechanical application to ACP and vice versa automatically
converts the data. The current unit system is displayed in the status bar of ACP at the bottom of
the screen.

4.1.1.6. Named Selections and Elements/Edge Sets

Named Selections based on bodies, surfaces, and edges defined in the DesignModeler or the
Mechanical application are transferred to ACP as an Element Set and Edge Set, respectively. They
are necessary for building a composite model.

4.1.1.7. Starting and Running ACP

First, an ACP (Pre) component has to be defined in the Workbench project. Double-click Setup to
open ACP (Pre). You can also use the context menu and select Edit, or run a Python script in which
the ACP commands are included, from the context menu. After defining the composite data in ACP
(Pre), you can return to the Workbench project to proceed. The ACP data is saved with Save in the
Workbench project or any other Save Project command in the different components.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
328 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Shell Model

Figure 4.5: Context Menu of ACP (Pre) Setup

4.1.2. Workbench: Adding an Analysis System to the Project

The ACP components are handled in the Workbench Project Schematic like any other standard
components. The components can be connected by drag-and-drop operations or by using the context
menu. The Mesh, Engineering Data, Named Selections and Coordinate Systems are transferred to the
analysis system.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 329
Example Analyses

Figure 4.6: Connecting a Static Structural Analysis to ACP (Pre) using a Drag and Drop Operation

4.1.3. Postprocessing: Adding an ACP (Post) Component to the Project

The ACP (Post) component can be linked to one or several solutions and allows postprocessing of
composite shell and solid structures. As ACP (Post) is linked with the Engineering Data, Geometry,
and the Model of the ACP (Pre) component, the composite definitions (section sata) are transferred
to ACP (Post) automatically.

As before, the ACP (Post) component can be added to the project by a drag-and-drop operation.
Pick the ACP (Post) component from the toolbar and drop it on the Model cell of the ACP (Pre)
analysis system.

Figure 4.7: Adding ACP (Post) by Drag and Drop Operation

In the second step, one or several solutions can be linked to the ACP (Post) component by dragging
and dropping the Solution cell into the Result cell of ACP (Post).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
330 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Solid Model

Figure 4.8: Linking a Solution with ACP (Post)

The complete composite shell model is now ready to be analyzed in ACP (Post).

Figure 4.9: Complete Composite Shell Analysis Model

4.2. Analysis of a Composite Solid Model

In the case of thick composites, the layered shell theory can cause significant errors in the obtained
results. In some cases, it is necessary to work with 3D models - also referred to as solid models. ACP
has the unique feature that can generate layered solid models based on the shell lay-up definitions.
ACP generates layered solid elements based on the shell mesh and the ACP composite definitions, thus
representing one-to-one the composite part. Drop-offs, staggering and tapering are also considered.
In addition, the solid model extrusion allows you to define extrusion directions and boundary curves.

In this section, the workflow of modeling a composite solid is outlined as it differs to some extent from
shell modeling. Selected steps that differ from shell modeling are explained in more detail below and
highlighted with a link.

• Preprocessing

– Add ACP (Pre) component to the project

– Define Engineering Data

– Import or construct Geometry

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 331
Example Analyses

– Open the Model and

→ Define Named Selections/Element Sets

→ Generate Mesh

– Open ACP (Pre) and

→ Define Fabric

→ Define Rosettes and Oriented Selection Sets

→ Create Modeling Plies

→ Create Solid Model (p. 332)

• Workbench Analysis System

– Choose an Analysis System (WB Mechanical/Mechanical APDL) (p. 333)

– Add Analysis System to the project (p. 334)

– Add other systems (p. 337)

– Open the Analysis System and

→ Define Analysis Settings

→ Define Boundary Conditions

– Solve model

• Postprocessing

– Post-process complete assembly (p. 337)

– Add ACP (Post) component to the project (p. 337)

– Open ACP (Post) and run the post-processing for composite parts

4.2.1. Preprocessing

Creating a Solid Model

You can generate a Solid Model by performing a mesh extrusion which converts the shell-based lay-
up definition into a layered, solid-element mesh. The configuration of the extrusion happens in ACP
(Pre) with the Solid Model feature. (For details, see Solid Models (p. 171) in the Usage Reference
chapter.) The options and advanced settings of the Solid Model feature control the extrusion, shape,
and mesh quality. See Guide to Solid Modeling (p. 303) for practical tips and recommendations.

The Export settings for the Sold Model control how it is exported for downstream analysis. For instance,
you can choose between different element types (layered solid185 or solsh190). Within Workbench,
the element and node labels are automatically handled to avoid numbering conflicts. (See the section

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
332 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Solid Model

on Assembly (p. 48).) If automatic numbering is disabled, then the numbering options can be used
to specify the initial labels.

In addition, Element Sets and Edge Sets are transferred from ACP (Pre) to the downstream analysis
system (Mechanical Model) where they appear as Named Selections. This aids the definition of
boundary conditions and contacts, for instance, and makes your model associative. (See the section
on Solid Model Properties (p. 173) for more information.) The figure below shows how Named Selections
of the shell geometry are converted into Named Selections of the solid mesh (geometry). An edge
becomes a wall (edge_1 ⇒ EDGE_1_WALL) and a surface is converted into a bottom and top surface
(face ⇒ FACE_BOT and FACE_TOP) in the solid of the downstream Mechanical system.

Figure 4.10: Conversion of the Named Selections in the Solid Model Workflow

4.2.2. Workbench Analysis System

Within Ansys Workbench, there are two ways to analyze composite solid models: The analysis can be
done in Workbench Mechanical, or it can be carried out in Mechanical APDL (Ansys Classic). While
the functionality is identical, the user interface is very different. As an alternative, composite solid
models can be exported from ACP for processing outside of Ansys.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 333
Example Analyses

Analysis with Mechanical

The composite layered solid element model appears in Mechanical as a meshed body. Any other
bodies in the ACP (Pre) component are not carried forward. The user can define loads, boundary
conditions, and connections to other parts in the usual Mechanical fashion. An example of such a
solid model workflow is shown below:

Figure 4.11: Workbench Workflow for Composite Solid Modeling with Mechanical

Analysis with Mechanical APDL

A further option is to link solid models to a Mechanical APDL where the boundary conditions and
loads are defined. Typically, an APDL script is used to set boundary conditions and analysis settings
for a workflow with Mechanical APDL. An example of a solid model workflow with Mechanical APDL
is shown below:

Figure 4.12: Workbench Workflow for Composite Solid Modeling with Mechanical APDL

Adding an ACP (Pre) Component to the Project

The solid modeling workflow in Ansys allows the assembly of many pre-processing components into
one analysis system. In some cases, it may be desirable to analyze thick-walled composites in isolation
but often it is desirable to see the interaction between multiple bodies. The connection procedure
is explained with the help of two examples for both analysis methods (Workbench Mechanical and
Mechanical APDL).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
334 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Solid Model

Link with Workbench Mechanical

The procedure for building an analysis model is illustrated with a Static Structural Analysis system
as an example. A composite tube connected to two metal inserts is subjected to torsion. A Project
Schematic is shown below:

Figure 4.13: Analysis of a Composite Tube with Metal Inserts Modeled with Mechanical

In this example, the geometry consists of one shell and two metal inserts. The link between ACP (Pre)
(B5) and the Static Structural (C2) only transfers the generated layered solid element model. The
link between the Mechanical Model (F4) and the Static Structural (C2) transfers all active bodies.
As such, the shell geometry has to be suppressed. Consequently, all three parts appear as solid bodies
in the Static Structural (C2) component. The connections, boundary conditions and all other pre-
processing definitions can be defined in the Setup (C3) in the usual fashion. The global solution can
be determined and analyzed in Workbench Mechanical while the composite component can be
analyzed in detail in ACP (Post) (D5).

Figure 4.14: Suppressed Shell in Mechanical Model

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 335
Example Analyses

Figure 4.15: Assembly of Composite and Metal Solids

Link with Mechanical APDL

Two composite components serve as an example for the Mechanical APDL workflow procedure - a
plate and a t-joint. A Project Schematic is shown here:

Figure 4.16: Analysis of Composite Plate and T-joint Modeled with Mechanical APDL

The proper sequence of connecting the system always begins with connecting an ACP (Pre) component
first. In this case, it is not important because both inputs are ACP (Pre) solid models.

In the Mechanical APDL component the boundary conditions, loads and all other pre-processing
definitions can be defined through APDL macros. These macros can be linked with the Mechanical
APDL cell which will be integrated in the automatic update functionality of Workbench. A macro file
can be added to the component through the right-click context menu (see figure below). Add Input
File... appends the APDL running sequence with an additional macro. Check the order of the files of
the Mechanical APDL component. The macros should be listed after the Solid Model Process Setup
file(s).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
336 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Composite Solid Model

Figure 4.17: Add Reference File

Figure 4.18: List of Used Files and Their Order in Mechanical APDL

Multiple Parts (Adding Other Systems)

It is possible to add multiple components to one analysis system: two composite parts or a composite
part connected to two isotropic parts, for example.

4.2.3. Postprocessing

Global Postprocessing
In general, the global solution of all parts can be viewed in Workbench Mechanical or in Mechanical
APDL. Analyzing the results of a multi-part assembly is not possible in ACP (Post) for Solid Models.

Adding an ACP (Post) Component to the Project

The post-processing functionality for Solid Models of ACP allows the mapping of ply-wise results onto
the reference surface of the Solid Model. This also ensures that failures occurring inside the laminate
can be observed and investigated.

The connection between an analysis system and ACP (Post) always requires the same two steps re-
gardless of whether the analysis system is Workbench Mechanical or Mechanical APDL. First, the ACP
(Post) system must be associated with an ACP (Pre) system. Subsequently, a solution from an analysis
system can be linked with the ACP (Post) Results. There are other ways of connecting ACP (Post)
with an analysis system, yet they all fall short when it comes to linking the Analysis Solution cell
with the ACP (Post) Results cell. This is a known limitation of the Workbench integration.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 337
Example Analyses

Figure 4.19: Step 1: Drag and Drop an ACP (Post) System on to an ACP (Pre) System

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
338 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis Using Variable Material Data

Figure 4.20: Step 2: Drag and Drop the Static Structural Solution Cell into the ACP (Post) Results
Cell

When multiple ACP (Pre) solid model systems are linked to an analysis system, then every ACP (Pre)
system must have a corresponding ACP (Post) system. See Figure 4.16: Analysis of Composite Plate
and T-joint Modeled with Mechanical APDL (p. 336) for an example workflow.

4.3. Analysis Using Variable Material Data

This simple example of a race car nose and wing demonstrates a possible workflow for composite
analyses using variable material data, ACP draping simulation, and temperature dependence. Variable
material data is used to simulate incomplete curing of the composite material in the model. Note that
the wing geometry, composite lay-up, and material data are fictitious and should not be used in any
real world analysis or application.

The following figure shows the Workbench setup. Cell D (External Data) contains the results of a Fluent
analysis which provides the surface pressure distribution on the race car nose and wing. The composite
lay-up, draping, and incomplete curing field are defined in ACP-Pre in cell A. Cell E (External Data)
defines the temperature field. The structural effect of the airflow around the race car nose and wing

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 339
Example Analyses

are analyzed in cell B (Static Structural). Cell C (ACP-Post) contains the failure analysis of the composite
race car nose and wing.

The model used in this example analysis is available by downloading this file.

A general overview of using variable material data can be found in Variable Material Data in Composite
Analyses (p. 319).

Figure 4.21: Race Car Workbench Setup

4.3.1. Workbench Engineering Data: Set-Up Variable Data

Variable data for composite materials are configured in Engineering Data. The following properties
can be functions of up to nine field variables:

• Density

• Elasticity parameters

• Stress limits

• Strain limits

Temperature, Shear Angles and Degradation Factor are predefined field variables. User-defined field
variables can also be created. In this example, the effect of incomplete curing across the parts is
modeled. As a first step, the field variable Incomplete Curing is defined and specified as dimensionless.
A value of 1.0 indicates perfect curing while a value of 0.0 indicates that no curing took place.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
340 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis Using Variable Material Data

Figure 4.22: Predefined and User-Defined Field Variables in Engineering Data

In the next step, the field variables are assigned to the material properties. Make the elasticity para-
meters of the Epoxy_Carbon_Woven_230GPa_Prepreg material a function of Temperature, Shear
Angle, and Incomplete Curing. To accomplish this, select the material and then select the Ortho-
tropic Elasticity property. Double-clicking a field variable assigns it to the Orthotropic Elasticity
property. Fill the table for the Orthotropic Elasticity property by manually entering values or by
importing a CSV file.

Figure 4.23: Assigning a Field Variable to Material Property

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 341
Example Analyses

Figure 4.24: Populating the Tabular Material using the CSV Interface

During finite element computations and postprocessing, the effective material properties are interpol-
ated from these tables based on the local field variables state. The interpolation scheme can be
controlled when selecting Interpolation Options (p. 414). When selecting the Material Field Variables
property, the unit, default data, lower, and upper limit can be set. The software suggests program
controlled values for some of the options. The default data defines the assumed state of the field
variable, if it is not specified in the model.

In this way, you can have full material specifications in Engineering Data, but only use a subset of
the specified dependencies during the simulation. For more details, see ACP-Pre: Define Fields for
Shear Angle, Degradation Factor, and User-Defined Field Variables (p. 343).

Figure 4.25: Setting Interpolation Options

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
342 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis Using Variable Material Data

4.3.2. ACP-Pre: Define Fields for Shear Angle, Degradation Factor, and User-
Defined Field Variables
ACP-Pre provides the ability to set up fields for Shear Angle (draping), Degradation Factor, and all
user-defined field variables for a complete composite model. The Shear Angle can be defined as a
result of ACP draping simulation or imported via look-up tables (p. 103). Degradation Factor and user-
defined field variables can be defined per shell or solid element as an interpolation result from a
scalar look-up table column. For example, you can define the state of a field variable at various spatial
positions in a .CSV file and import it as a 3D look-up table (p. 103). By creating a Field Definition (p. 158)
object in ACP-Pre, you can assign the imported scalar look-up table column to the field variables
previously specified in Engineering Data and scope them to part of your model, even to single Mod-
eling Plies. See the Element- or Layer-wise Field Definition (p. 319) section.

The application automatically considers the result of the draping simulation when evaluating the ef-
fective material properties in downstream analyses and postprocessing.

Figure 4.26: Draping Results

Use look-up tables to define scalar fields on composite models. The interpolation result from the look-
up tables can be visualized using Scalar Look-up Table plots and the Field Definition objects in turn
can be visualized using Field Definition plots. The following figure shows Curing Degree over the race
car nose and front wing (upside down).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 343
Example Analyses

Figure 4.27: Distribution of the Curing Degree (Scalar Look-Up Table Plot)

To activate a 3D look-up table as the Curing Degree field, you need to assign it in the ACP-Pre by
setting up a respective Field Definition. Note that you must maintain unit consistency between the
Look-up Table column values and the active unit system in Mechanical (units of the look-up table
column are not converted to the active unit system). See the Field Definitions (p. 158) section for ad-
ditional details. The following figure shows this process:

Figure 4.28: Activating a Look-Up Table to Define Curing per Modeling Ply (Layer-Wise)

4.3.3. Mechanical, Thermal Loading, and External Data

Thermal loading through the Temperature field variable can be accomplish by:

• Transient Thermal analysis

• External Data analysis component in Workbench

• Setting the environmental or part temperature directly in Mechanical

The resolution of the temperature field is per element node.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
344 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis Using Variable Material Data

Figure 4.29: Using External Data to Define Temperature Field

4.3.4. ACP-Post: Analysis Effect of Variable Data

Stress and strain limits can be defined in Engineering Data as a function of field variables. These de-
pendencies are fully reflected in Mechanical and ACP-Post when evaluating respective failure criteria.

The following figure shows inverse reserve factor plots of combined Maximum Stess, Hashin, Face
Sheet Wrinkling, and Core Failure failure criteria. The structure is viewed from the bottom. On the left
is the result with constant material properties, and on the right the effect of Temperature, Shear
Angle, and Incomplete Curing is shown. The color bar ranges are the same. It is clearly visible that
the IRFs are much higher within the gold square.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 345
Example Analyses

Figure 4.30: Inverse Reserve Factor (Constant Material Data on the Left; Variable Material
Properties on the Right)

4.4. Analysis of a Mapped Composite Solid Model

In the case of thick composites, the layered shell theory can cause significant errors in the obtained
results. In some cases, it is necessary to work with 3D models, also referred to as Solid Models. ACP has
the feature to map the ACP Composite Definitions onto external solid meshes.

In this section, the workflow of modeling mapped composite solid meshes is outlined. To a large extent
the workflow is the same as that of a standard solid model (p. 331), except there is one main difference:
The solid mesh is imported via Mechanical Model and not generated in ACP (Pre) itself. See Solid
Modeling (p. 47).

An exemplary complete workflow contains these steps:

1. Pre-Processing: Define the Composite Definitions in ACP (Pre) as described in the Analysis of
a Composite Solid Model (p. 331) section.

2. Mapping of the Composite Definitions: Import the external volume mesh and configure the
Imported Solid Model object in ACP (Pre).

3. Analysis: Transfer the solid composite data to a downstream analysis (p. 333) (structural, modal,
etc.).

4. Post-Processing: run the composite failure analysis for the composite structures in Mechanical.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
346 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Mapped Composite Solid Model

This example examines how a full cross-section composite spring can be modeled by mapping Composite
Definitions from ACP (Pre) onto an existing mesh.

You can download the Workbench archive for this example here: Composite Spring Project File

Tip:

A video that demonstrates this capability can be found here.

Geometry and the Lay-Up

The geometry and the lay-up of the spring are shown in the figure below. The lay-up can be split into
three sections. The four reinforcement plies at the outer surface consist of a woven fabric, and the total
thickness of this section is 1 mm. The material orientation of the plies is alternating, +/- 45°. The next
ply is a 2 mm thick isotropic core material. And a roving (carbon UD) fills the center section of the spring
where the fibers are along the extrusion direction (helix) of the spring.

Figure 4.31: Geometry and Lay-Up of the Composite Spring

4.4.1. Transfer External Solid Mesh to ACP (Pre)

The lay-up mapping feature transfers the lay-up definition of ACP (Pre) onto an external solid mesh
that was generated outside ACP (Pre). This section describes how the solid mesh is transferred to ACP
(Pre), system C. This includes preparing the geometry and meshing as well as linking the Workbench
systems.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 347
Example Analyses

4.4.1.1. Geometry
The entire geometry is prepared in SpaceClaim (system E) and contains both the shell reference
surface and the solid. Therefore, the geometry is split into two parts in the subsequent workflow.
The shell surface is used to specify the Composite Definitions in ACP (Pre) and is passed to system
B and later to ACP (Pre), system C. The volume of the spring is required to generate the solid mesh
in Ansys Mechanical and is passed to another Mechanical model (system F).

Figure 4.32: Complete Workbench Project Schematic

To achieve an accurate FE model of the solid with the correct material assignments, the solid geo-
metry is split into two bodies: the Tube and the Roving. This ensures that, later, the reinforcement
plies and UD roving can be mapped accurately onto their intended region and that the volume
contents of the materials are correct. These bodies are passed to ACP (Pre) (the connection between
system F and C) as Named Selections. The figure below shows the geometry with the two solid
bodies and the Named Selections.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
348 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Mapped Composite Solid Model

Figure 4.33: Mechanical Model F4 with the Bodies Roving and Tube

Also, other Named Selections are added which will be used to apply the boundary conditions in
analysis system D. It is important that all geometries except the solid are suppressed in system F
so that the data transfer from F4 (the Mechanical model) to C5 (ACP (Pre)) contains only the solid
mesh.

4.4.1.2. Meshing
The lay-up mapping algorithm in ACP (Pre) is currently designed for structured meshes where de-
generated elements can be filled with an orthotropic material. Therefore, the solid mesh that gets
lay-up data from ACP (Pre) should mainly consist of structured elements (hex) which support layered
section data. In this example, it is the solid Tube.

The mesh of the inner body, the Roving, must meet fewer requirements because the filler option
will be used in ACP (Pre) to assign the UD material to this body. The elements, then, are handled
as homogeneous elements instead of layered elements which relaxes the requirements on the
mesh. The figure below shows the mesh of the solid geometry with a mapped mesh in the outer
region (Tube).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 349
Example Analyses

Figure 4.34: Detail View of the Final Solid Mesh with Hex Elements only in the Outer Body

4.4.1.3. Linking the Workbench Systems

The solid mesh is passed to the ACP (Pre) system by transferring F4 to C5. (Simply drag-and-drop
F4 onto C5.) This connection will create an Imported Solid Model object in ACP (Pre) which contains
the solid mesh and Named Selections.

Figure 4.35: Mesh Features and Solid Mesh with the Inflation Layers and Roving Cross Section

4.4.2. Lay-Up Mapping in ACP (Pre)

An Imported Solid Model (p. 196) object is automatically generated in ACP (Pre) as soon as a Mechan-
ical model is linked to an ACP Setup component. The file format, unit system, and file path are
automatically set and cannot be changed.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
350 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Mapped Composite Solid Model

Figure 4.36: Imported Solid Model Properties Dialog

The Imported Solid Model object also contains the Named Selections which were generated in the
upstream component. They appear as Mesh Components as shown below. You can see the mesh
of the Imported Solid Model (even before you define any settings for the mapping) by right-clicking
Composite_Spring and selecting Import Initial Mesh from the context menu.

In this example, the lay-up mapping is split into two pieces, one for the Tube and one for the Roving.
So, a Lay-up Mapping Object is generated for each of these regions

The source plies for the region Tube are the woven and core plies which are all defined in the Mod-
eling Group Laminate. The configuration of the Lay-Up Mapping Object is shown below.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 351
Example Analyses

Figure 4.37: Figure: Lay-up Mapping Definition of the Mesh Component Tube

The filler option is used to assign the UD material to the roving mesh component. The filler option
is activated by passing an empty list of plies and defining a filler material and orientation. In the figure
below, the filler options for the roving are shown– the General options (A) and the Materials options
(B).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
352 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Mapped Composite Solid Model

Figure 4.38: The Filler Options for the Roving

The mapped plies and generated materials are displayed under the Analysis Plies folder of the Im-
ported Solid Model. You can use these entities to plot ply-wise data such as thickness and fiber direc-
tions.

The figures below show the final solid mesh with mapped plies and UD materials. The first figure
shows the first ply on the solid mesh, its thickness and material orientations.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 353
Example Analyses

Figure 4.39: Filler Elements and Fiber Directions

The assignment of the UD material is shown in the next figure. It shows that the orthotropic material
(UD carbon) is perfectly aligned with the extrusion direction of the spring thanks to the selected
Rosettes and Selection Method.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
354 of ANSYS, Inc. and its subsidiaries and affiliates.
 Analysis of a Mapped Composite Solid Model

Figure 4.40: Using the Filler Option for the Roving

4.4.3. Analysis of A Mapped Composite Model

The Imported Solid Mesh is passed to a structural system to simulate a compression load case until
the surfaces of the helix are in contact. See system D in Figure 4.33: Mechanical Model F4 with the
Bodies Roving and Tube (p. 349).

Once the solution is up-to-date, the composite solid model can be post-processed in Mechanical or
ACP (Post). The figure below shows the composite post-processing in Mechanical. A Composite
Failure Tool is set up to address the different material types (woven and UD fabrics, and core mater-
ial). This can be achieved by selecting for example the Max Stress, Puck, and Core Shear failure criteria.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 355
Example Analyses

Figure 4.41: Ply-wise failure analysis

4.5. Shear Dependent Materials in Composite Analysis

This example demonstrates a possible workflow for composite analyses using homogenized material
data (with shear dependency) for a woven composite provided by Material Designer. To this end, a
simple model consisting of an inflated half-sphere is considered. The effect of ACP draping simulation
combined with shear-dependent material properties will be shown.

The following figure shows the Workbench setup. The material data of a Carbon/Epoxy woven fabric
are computed by Material Designer (systems A and B) as illustrated in the Material Designer Woven
Composite Tutorial. The composite lay-up and draping options are defined in ACP-Pre (system C). Finally,
the structural effect of an internal pressure load is analyzed in system D (Static Structural).

Figure 4.42: Workbench Project Setup

If desired, you can download the model used in this example analysis and perform the steps yourself.

Homogenized Material Data

Following the Material Designer Woven Composite Tutorial, we generate homogenized material data
for a Carbon/Epoxy woven fabric. In particular, we use an RVE whose material directions are aligned
with the yarns bisectors, so that the resulting homogenized material remains orthotropic in presence
of shear (see Fabric Fiber Angle (p. 74) in the Material Designer User's Guide).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
356 of ANSYS, Inc. and its subsidiaries and affiliates.
 Shear Dependent Materials in Composite Analysis

Figure 4.43: Woven RVE defined in Material Designer

We set up two analyses in Material Designer (Cell B in the Workbench project): a constant material
analysis and a variable one with a shear angle between -30° and 30° as parameter. The resulting mater-
ials are then transferred to the Engineering Data component of the ACP system.

Figure 4.44: Materials in the Engineering Data Component of the ACP system

Note that the constant material has a constant Fabric Fiber Angle equal to 45°, while the variable ma-
terial has a shear dependent Fabric Fiber Angle.

Figure 4.45: Shear Dependent Fabric Fiber Angle

Fibers and Material 1 Directions in ACP

In ACP, we define a ply with a variable woven fabric and a ply angle of 0°.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 357
Example Analyses

Figure 4.46: Ply Definition

The effect of the Fabric Fiber Angle property can be highlighted by comparing the ply fiber directions
with the material 1 direction.

Figure 4.47: Fiber (Light Green), Transverse (Dark Green) and Material 1 (Red) Directions

The material 1 direction identifies the direction in which the material properties are specified. However,
the fiber direction is still the nominal modeling direction in ACP, that is, the Ply Angle still defines the
orientation of the fibers with respect to the reference direction.

Draping
The Shear Angle can be defined as a result of ACP draping simulation (see Draping (p. 298)).

You can enable the Internal Draping algorithm in the Draping tab of the Modeling Ply Properties (p. 136)
dialog.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
358 of ANSYS, Inc. and its subsidiaries and affiliates.
 Shear Dependent Materials in Composite Analysis

Figure 4.48: Draping Definition

Figure 4.49: ACP Draping Mesh

You can plot the local ply shear value due to draping using an Angle Plot (p. 210) with Draped Shear
Angle as component.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 359
Example Analyses

Figure 4.50: Shear Angle Plot

In addition, you can further investigate the shearing effect due to draping by plotting the draped fiber
and transverse directions, as well as the material 1 direction.

Figure 4.51: Draped Fiber Direction (Light Blue), Draped Transverse Direction (Blue) and Material
1 Direction (Red)

Plot of Shear Dependent Material Properties

The application automatically considers the result of the draping simulation when evaluating the effective
material properties in downstream analyses and postprocessing. In ACP, you can plot the effective
material properties (for example, the Young's modulus) as a function of the Shear Angle using Material
Plot (p. 233).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
360 of ANSYS, Inc. and its subsidiaries and affiliates.
 3D Ply Workflow – Imported Plies

Figure 4.52: Shear-Dependent Young's Modulus

Analysis
The composite model is passed to a structural system to analyze the effect of a uniform pressure load.
It is worth comparing the result with the one obtained considering a constant material and no draping:
in the latter case the maximum deformation is underestimated by more than 30%.

Figure 4.53: Deformation Plot (variable material on left, constant material on right)

4.6. 3D Ply Workflow – Imported Plies

Many different manufacturing processes are available to build composite structures. Traditional processes
are mainly used to fabricate thin or moderately thick laminated structures which can be modeled based
on a reference surface, also called a mold surface. In ACP Pre, this is covered by the Oriented Selection
Set (p. 128) and Modeling Ply (p. 136)features.

New and alternative processes, such as 3D printing and winding, can produce thick and complex
structures. In such cases the approach of building the entire laminate on only one reference surface
often proves unfeasible or results in an inaccurate model. The Imported Modeling Ply (p. 153) feature
allows you to model laminated structures independent of a reference surface, where the geometrical
information (ply extent and so on) is imported from an external source. The lay-up mapping capability,
which is part of the Imported Solid Model (p. 196), is then used to map the Imported Modeling Plies (3D
plies) onto a solid mesh. You can employ this workflow in combination with thermal and structural
analyses such as linear, transient, or explicit for example.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 361
Example Analyses

4.6.1. Inputs
The 3D Ply Workflow requires two additional inputs, compared to the standard workflow. One is a
finite element mesh of the solid that represents the 3D composite part, and the other is the 3D rep-
resentation of the lay-up. The figure below shows how their data can be transferred to ACP Pre.

In this example, the solid geometry is meshed in Ansys SpaceClaim by using block meshing (see A3).
The solid mesh is then transferred to ACP Pre-Setup by linking the Ansys Mechanical model (the A4-
B5 link). Another option is to mesh the solid geometry in Mechanical. You can import meshes from
third-party applications (such as HyperMesh) in any supported file format via the External Model
system. For more information on supported file formats, see External Model in the Workbench User's
Guide.

Note:

Named Selections (NS) of the finite element mesh of the solid get transferred to the
downstream systems. These Named Selections can be used to define boundary conditions,
contacts, and so on, to make the model associative.

Figure 4.54: 3D Ply Workflow (Courtesy of 9T Labs)

There are two ways to create the 3D ply representations in ACP Pre. Option A: By geometry. Or option
B: By loading an HDF5 Composite CAE (p. 264) in ACP Pre.

Option A: The ply surfaces are represented by CAD faces and are transferred to ACP Pre by linking
one or more geometrical components with ACP Pre (see D2-B5). All the additional information, such
as fiber directions and material, can be defined in ACP Pre using the standard ACP features- such as
Fabrics, Rosettes, and so on.

Option B: This option allows you to import ply definitions from a third-party application. The HDF5
Composite CAE file includes all the information of a layered composite, so the imported ply objects,
their fiber directions, and their thicknesses are created automatically on import. Currently, many CAE

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
362 of ANSYS, Inc. and its subsidiaries and affiliates.
 3D Ply Workflow – Imported Plies

applications support the HDF5 Composite CAE. Contact your Ansys Support Team for further inform-
ation about this format. The figure below shows you how an HDF5 Composite CAE is loaded using
the context menu of the ACP model.

Figure 4.55: HDF5 Composite CAE Imported as 3D Plies (Imported Modeling Plies)

4.6.2. Example of Use - HDF5 Composite CAE

The following example has been provided by 9T Labs (https://www.9tlabs.com/) who automates and
digitizes composite manufacturing. It shows how a 3D printed composite structure, designed with
Fibrify, can be imported into Ansys Workbench/ACP for simulation. This workflow allows you to import
a 3D composite lay-up definition and convert it into a solid FE model with minimal effort.

You can download the Workbench project archive here. You will find the required HDF5 Composite
CAE file in the following location:

user_files\200401_Rocker_PA_print_2NEW.hdf5cc

The model is already fully configured, and the description below highlights the most important steps.

Figure 4.56: 3D Printing with Endless Fiber Reinforcement and Final Part (Courtesy of 9T Labs)

The following figure shows the Workbench Project Schematic. The 3D geometry of the printed
composite part (shown above) is loaded into system A (Solid Mesh) and meshed in SpaceClaim. Three
Named Selections are defined in Model A4 which are used to define the forces and supports later in
the analysis system C3. This is important if you want to have an associative model. The material
properties (such as stiffness and strengths) are defined in the Engineering Data component (B2) of
the ACP Pre system. The solid mesh is transferred to ACP Pre by linking Model A4 with ACP Setup B5
which results in an Imported Solid Model in ACP Pre.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 363
Example Analyses

Figure 4.57: Simulation of a 3D Printed Composite (Courtesy of 9T Labs)

At this point, only a few mouse-clicks are needed in ACP Pre to load the 3D plies and to configure
the mapping. You can perform the import using the context menu of the ACP Model as shown above
(Figure 4.55: HDF5 Composite CAE Imported as 3D Plies (Imported Modeling Plies) (p. 363)). The imported
plies are accessible in the object Tree and are displayed when selected. To see the Fiber Directions
and other properties, enable the options in the display’s toolbar. Of course, the input data can be
modified as well if needed.

The solid mesh on which the plies are mapped is already available (mesh transfer from A4-B5). The
mapping algorithm must be switched over to Imported Plies (3D plies) by enabling the Use Imported
Plies option in the Imported Solid Model Property Dialog. By default, all plies are mapped and the
result can be verified by selecting the plies of the solid model. The figure below shows a few plies
which are visualized on the solid mesh. (Enable the Show on Solid option in the display toolbar
and select the plies.)

You can now transfer the solid mesh downstream for many different types of analyses, such as a
static structural analysis as shown in System C in the workflow above ( Figure 4.57: Simulation of a
3D Printed Composite (Courtesy of 9T Labs) (p. 364)). After solving the analysis, you can employ the
Composite Failure Tool to predict the safety margin of the composite part. As an example, the figure

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
364 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP for Workbench LS-DYNA: Bird Strike

below shows the maximum Inverse Reserve Factor per element. Of course, you can easily generate
ply-wise plots for a more detailed assessment.

Figure 4.58: Distribution of the Inverse Reserve Factors in the Mapped Composite Solid Model

4.7. ACP for Workbench LS-DYNA: Bird Strike

An important part of designing composite structures is fulfilling performance and reliability targets
under operational loads. Most structures are subject to quasi-static or transient phenomena where im-
plicit time integration is sufficient. However, when engineers want to understand the structural behavior
under short duration events, explicit time integration methods are necessary. Common scenarios include
assessing passenger safety in a vehicle crash event, predicting the damage state of consumer goods in
a drop scenario, or predicting the effects of a bird strike on an aircraft and the impact on its ability to
land safely.

Composite models may exhibit complex lay-up patterns when they involve multiple layers, local rein-
forcements, and different materials and orientations. While defining lay-ups in LS-PrePost is tedious and
prone to errors, ACP provides all the functionality (p. 1) needed to generate parametric composite
models efficiently and accurately. You can use these composite models for both implicit analyses in
Ansys Mechanical APDL and explicit analyses in LS-DYNA.

The example that follows shows how to set up a composite model for a bird strike analysis within Ansys
Composite PrepPost for an explicit simulation within Ansys Workbench LS-DYNA. In principle, the
workflow corresponds to the implicit structural analysis of a composite shell model (p. 323). The modeling
steps that have specific application to the Workbench LS-DYNA analysis are given special attention. For
example:

The Workbench project file can be downloaded here: Bird Strike Project File

Tip:

For general considerations and limitations regarding the ACP-to-Workbench LS-DYNA workflow,
see ACP–LS-DYNA (p. 44).

4.7.1. Workbench Workflow

4.7.2. Engineering Data – Material Model Definition
4.7.3. SpaceClaim – Geometry
4.7.4. Mechanical Model Setup

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 365
Example Analyses

4.7.5. ACP - Material Assignment and Lay-Up

4.7.6. Setting Up the LS-DYNA Analysis System
4.7.7. Post-Processing in Workbench LS-DYNA:

4.7.1. Workbench Workflow

The ACP to WB-LSDYNA workflow is similar to a standard implicit Analysis of a Composite Shell
Model (p. 323) using ACP and Ansys Mechanical: The required analysis systems are placed on the
Workbench Project Schematic and connected (p. 329). In the case of a composite analysis with LS-
DYNA, you drag-and-drop an LS-DYNA analysis system onto the Workbench schematic.

Figure 4.59: The Drag-and-Drop Workflow Showing the Transfer of ACP Composite Models to
a Workbench LS-DYNA Analysis System

4.7.2. Engineering Data – Material Model Definition

The material data required for the LS-DYNA model is defined in the Engineering Data. There are two
ways the LS-DYNA material cards are generated from the workflow:

1. Ansys standard material property definitions are automatically converted into the equivalent
LS-DYNA material model.

Once the ACP model is transferred to the LS-DYNA system, you can choose which LS-DYNA
composite material model is used by selecting Composite Damage Model in Composite Controls,
located under Details of Analysis Settings. This converts a basic set of parameters. This is a
global control which defines the entire composite model by one of the two available material
models:

• ENHANCED_COMPOSITE_DAMAGE / *MAT054

• LAMINATED_COMPOSITE_FABRIC / *MAT058

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
366 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP for Workbench LS-DYNA: Bird Strike

Figure 4.60: Setting up an Automatic Conversion of LS-DYNA Material Models

2. You directly define the LS-DYNA material model.

Composite structures are often made of different materials, each exhibiting its own material beha-
viors. This might require using multiple material models. Engineering Data simplifies the task by
giving you access to several LS-DYNA material cards, allowing complete control over stiffness and
damage parameters as well as degradation properties.

The model used in this example contains a unidirectional and a woven material. Each is represented
by a specific LS-DYNA material model:

• UD - *MAT_ENHACED_COMPOSITE_DAMAGE/*MAT054

• Woven - *MAT_LAMINATED_COMPOSITE_FABRIC/*MAT058

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 367
Example Analyses

Figure 4.61: Material Definition for LS-DYNA in Engineering Data

4.7.3. SpaceClaim – Geometry

The geometry is generated in SpaceClaim. It includes a solid geometry which represents the bird (A
in the figure below) and the surface geometry of the composite wing structure (B). The distance (C)
between the bird and the wing is set to minimize the time between the beginning of the simulation
and the impact event.

Figure 4.62: Geometry Preparation in SpaceClaim

4.7.4. Mechanical Model Setup

The geometry is then transferred to the Mechanical model where the following entities must be
defined:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
368 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP for Workbench LS-DYNA: Bird Strike

• Geometry Properties

– Reference Frame: The Reference Frame of the bird is set to Particle which allows the mesh
generation method with SPH particles. In contrast, the Reference Frame of the wing geometry
is set to Lagrangian by default.

– Material: For the bird geometry, Water2 is assigned, an equation-of-state material model for
water. For the bodies of the wing geometry, the default material assignment is retained but will
be overwritten by the composite definition in ACP-Pre.

Figure 4.63: Mechanical Model - Assigning Part Properties to the Bird Body

• Mesh

The mesh Physics Preference is set to Explicit. A Particle Method is used for the mesh generation
of the bird. A multizone meshing approach is chosen for the wing geometry which allows the
generation of a suitable structural mesh-type for explicit analysis.

• Named Selections

Named Selections for some part domains are defined. ACP-Pre uses the Named Selections to set
up various functional domains for assigning composite plies.

4.7.5. ACP - Material Assignment and Lay-Up

Material Assignment
Because each LS-DYNA material model in Engineering Data has its own definition, you can assign
specific materials to each individual ply. If a material without an LS-DYNA definition is used, it is
automatically converted to the preset LS-DYNA material card. The workflow for defining Fabrics,
Stackups, and Sub-Laminates in ACP (p. 70) does not differ from standard composite model generation.
The model in this example uses two different Fabrics, one for the woven and another for the unidirec-
tional material. You must define Fabric Thickness in the Fabric Properties dialog. Additional but
optional controls (p. 80) are available for draping computation and solid model material handling
for degenerated elements.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 369
Example Analyses

Figure 4.64: Defining Materials in ACP

Lay-Up
The composite lay-up contains the two different materials previously defined. The stiffeners and the
base lay-up of the skins are made from the unidirectional material. Additional woven materials are
applied to the trailing edge of the wing as a local reinforcement. The ply stacking direction of the
skin points inward as defined through the underlying Oriented Selection Set of the modeling plies.

Figure 4.65: Composite Lay-Up Modeling in ACP

4.7.6. Setting Up the LS-DYNA Analysis System

The composite lay-up from ACP is transferred to LS-DYNA as a shell model where the wing as well
as the bird model is now present with their required model configuration. A Body Interaction object
is added by default and includes all bodies present in the model. A Fixed Support is applied to one
of the Stiffeners. A Velocity of 125 m/sec is applied to the bird body as an Initial Condition.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
370 of ANSYS, Inc. and its subsidiaries and affiliates.
 ACP for Workbench LS-DYNA: Bird Strike

Figure 4.66: : Setting Up the Analysis

The Details View of Analysis Settings provides additional controls for the solver run and output en-
tities:

• End Time is set to 0.01 seconds.

• Under Output Controls, History Variables is set to Yes.

• Under Time History Output Controls, different output entities are specified (for example: Element
Data and Nodal Data).

• Other control entities are available such as for SPH Controls, Processing Type, CPU and Memory
Management, and Solver Precision.

4.7.7. Post-Processing in Workbench LS-DYNA:

In Ansys Mechanical, you can review very basic result entities such as deformations, strains, and
stresses.

You can evaluate the history variable output through a user-defined result. Be aware that the history
variables have a different meaning for each material model (see History Variable Output in the LS-
DYNA User's Guide).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 371
Example Analyses

For advanced result analyses, you can open the result files and model input files in LS-PrepPost. Right-
click the Solution object and select Open Solver Files Directory in the context menu.

Figure 4.67: Accessing Input Files and Results Files

Alternatively, you can use the free ACT extension LST_PrePost (available in the Ansys Store) to open
the LS-DYNA solver and results files and seamlessly perform further pre- and post-processing. Addi-
tional pre- and post-processing capabilities in Workbench LS-DYNA will be added in future releases.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
372 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 5: Theory Documentation
The theory chapter consists of the following sections:
5.1. Draping Simulation
5.2. Interlaminar Stresses
5.3. Failure Analysis
5.4. Classical Laminate Theory
5.5. General Interpolation Library
5.6. Nomenclature

5.1. Draping Simulation

Draping simulation is explained in the following sections:
5.1.1. Introduction
5.1.2. Draping Procedure
5.1.3.Thickness Correction
5.1.4. Limitations of Draping Simulations

5.1.1. Introduction
Layered composite structures are typically formed by placing reinforced plies against a mold surface
in desired orientations. In the case of flat and singly curved surfaces, the orientation of the ply stays
practically unchanged over the whole application area. When it comes to doubly curved surfaces, a
ply can follow the surface only by deforming. In particular, dry and pre-impregnated woven fabrics
can adapt to the shape of a doubly curved surface without use of excessive force. Deformation occurs
with in-plane shear and up to a certain deformation level the shear stiffness of a fabric is insignificantly
small ([ 2 (p. 595) ]).

When a ply deforms by shearing to follow the surface, the fiber orientation changes. Different ap-
proaches have been developed for the simulation of the draping process [ 3 (p. 595) ]. The need for
draping simulation is twofold. First, the manufacturability of the composite product can be assessed.
Areas where the reinforcement cannot follow the surface are indicated and hence measures can be
taken in design to avoid this. Second, the draping simulation gives the actual fiber orientations at
any location in the model. This information is needed for accurate finite element analysis of the
structure.

5.1.2. Draping Procedure

The draping simulation in ACP uses an energy algorithm. In this approach, a reinforced ply is idealized
with a pin joint net model ([ 1 (p. 595) ] and [ 6 (p. 595) ]). The net consists of unit cells which can un-
dergo different types of deformation depending on the selected draping material model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 373
Theory Documentation

5.1.2.1. Propagation Strategy

During the simulation, the unit cells are laid one by one on the surface of the model to ensure full
contact with the surface. The simulation starts from a given seed point and progresses in the given
draping direction. In this phase, each draping cell initially has two known node points. Draping
cells are laid until the model edge is reached. Then, the procedure is repeated in the opposite dir-
ection (if applicable) and in the orthogonal directions as shown below in Figure 5.1: Draping Scheme
(p. 374). After the main draping paths have been determined, the cells with three known nodes are
populated. The algorithm resolves if the whole model is draped or if there are areas where the
draping simulation needs to be restarted..

Figure 5.1: Draping Scheme

Note:

Above figure represents draping of a cell that has two (left) or three (middle) known
node points and propagation scheme using orthogonal directions (right).

The draping procedure involves the search for two types of draping cells: those with two known
nodes or three known nodes as shown above. When two node points are known and the locations
of the other two must be determined, the search algorithm is based on the minimization of the
shear strain energy [ 4 (p. 595) ]:
(5.1)

where G is the elastic shear modulus of the uncured reinforcement. The shear deformation is related
to the angle α between the originally orthogonal fibers [ 3 (p. 595) ]:
(5.2)

The total shear strain energy of the draping cell is defined as the sum of energy computed at the
four corners. The two constants can be excluded and the minimization problem becomes:

(5.3)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
374 of ANSYS, Inc. and its subsidiaries and affiliates.
 Draping Simulation

Figure 5.2: Angle Notation for the Draping Energy Algorithm

From this, the locations of the two node points can be determined with an iterative minimization
algorithm. In the case of three known points, the search algorithm seeks the fourth node point in
different ways depending on the material model in use.

5.1.2.2. Woven Material Model

In the woven material model, unit cells are made of inextensible bi-directional fibers pinned together
at crossover node points. The deformation of the fabric takes place by pure rotation of the fibers
around the pins as illustrated in Figure 5.3: Deformation of the Draping Unit Cell (p. 375).

Figure 5.3: Deformation of the Draping Unit Cell

When using this model, in case of three known node points the search algorithm seeks the fourth
one from the surface so that the distances (along the surface) to the adjacent node points are equal
to a unit cell side length.

The model is specifically developed for woven fabrics, but it has been proven to work for cross ply
prepreg stacks and also for single unidirectional plies when the deformation is moderate [ 8 (p. 595)
].

5.1.2.3. Unidirectional Material Model

In the unidirectional model, the inextensibility assumption in the transverse direction is removed.
Still, due to the high modulus of individual fibers, cell edges along the fiber direction are assumed
to be inextensible.

As a result, given three node points the fourth one is not uniquely determined by geometrical
considerations. In fact, the length of the missing edge in the transverse direction is a degree of

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 375
Theory Documentation

freedom. This unknown length (l) (and therefore the position of the fourth node) is computed by
minimizing an energy function featuring two contributions weighted by the UD coefficient ω ∈
[0,1]:

(5.4)

The first term promotes low shear energy, while the second term favours edge lengths (in the
transverse direction) close to the reference unit cell length (lref). By varying and possibly fitting to
experimental or manufacturing data the UD coefficient, you can control the amount of deformation
allowed in the transverse direction.

It is worth noting that the unidirectional model reduces to the woven material model when the
UD coefficient is set to zero.

5.1.2.4. Output of the Draping Simulation

The simulation determines fiber principal directions. These directions are mapped to the finite ele-
ment model to correct laminate lay-ups accordingly. The shearing angle β is defined as
(5.5)

It expresses the deviation from the ideal non-sheared case. The visualization of β values over the
model surface is useful for depicting problem areas. For most fabric reinforcements, the maximum
deformation angle α is 30-40 degrees [ 7 (p. 595) ]. When a fabric is sheared to a specific deformation
level, the shear force starts to increase radically with little increase in the shear deformation. This
limit is called the locking angle, and beyond it buckling is observed. The locking angle of a rein-
forcement can be determined experimentally [ 5 (p. 595) ].

5.1.3. Thickness Correction

The thickness correction option of the internal draping feature changes the thickness of a draped ply
when it is sheared. The draping mesh is laid down on top of the finite element mesh and its size is
independent of the finite element mesh. Thickness correction algorithm is based on conservation of
volume per draping element. For that purpose, the ratio of the area of the distorted draping element
to its plane reference is computed and the thickness of the analysis plies being considered is corrected
accordingly.

5.1.4. Limitations of Draping Simulations

The draping simulation approach has the following limitations:

• The surfaces to be draped must be smooth. No sharp edges are allowed.

• The draping procedure does not change mechanical properties of the ply by default. However,
mechanical properties can be altered if a shear-dependent material is defined. For more information,
see Variable Material Data in Composite Analyses (p. 319).

• Draping parameters, such as mesh size and seed point, will significantly effect the draping results.
Be sure to verify the results carefully.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
376 of ANSYS, Inc. and its subsidiaries and affiliates.
 Interlaminar Stresses

• Ply thickness does not automatically change as a result of a draping procedure. A thickness correction
can, however, be activated in the modeling ply properties.

• It is assumed that fabric transverse direction is initially perpendicular to the principal direction 1.

• The fiber slippage is a phenomenon that takes place after the locking limit and is noticeable only
at relatively high deformation levels. The fiber slippage is not considered in this draping approach.

• It is known that some geometries can lead to flawed or deficient results, for example draping across
a complete cylinder. This issue can be rectified by subdivision of the draping geometry.

5.2. Interlaminar Stresses

This section contains detailed background information on the evaluation of interlaminar stresses. A
short general overview of the stress, strain, and failure analysis can be found in Postprocessing (p. 256).
5.2.1. Introduction
5.2.2. Interlaminar Normal Stresses
5.2.3.Transverse Shear Stresses

5.2.1. Introduction
In the analysis of layered composite structures, shell elements are widely used to keep the computa-
tional effort reasonable. In-plane stresses and even transverse shear stresses can be predicted with
accuracy using shells based on the first-order shear deformation theory (FSDT). However, in the ana-
lysis of thick-walled curved structures, interlaminar normal stresses (INS) can play a significant role.
The normal stresses may affect the failure mode or even cause delamination failure. INS computation
is not commonly available in shell element formulations, which leads to use of computationally ex-
pensive solid modeling instead.

The approach by Roos et al. ([ 14 (p. 595) ]) for INS computation of doubly curved laminate structures
represents an alternative for solid modeling. The basis for the INS calculation is the displacement
solution obtained from a shell based model. In conjunction with the INS approach, transverse shear
stresses are computed with the approach presented by Rohwer ([ 11 (p. 595) ]) and Rolfes ([ 12 (p. 595)
]). When considered at layer interfaces, transverse shear stresses are referred to as interlaminar shear
stresses (ISS).

5.2.2. Interlaminar Normal Stresses

This section is a brief description of the post-processing algorithm which computes the interlaminar
normal stresses for layered shell elements based on the laminate deformations and geometrical
curvature.

A cylindrical coordinate system is used for describing an arbitrary doubly curved shell [ 9 (p. 595) ].
Curved shell geometry, illustrated in Figure 5.4: Doubly Curved FE Geometry (p. 378), is described by
the coordinates and it is subdivided into angular segments with the apex angles and
and the constant curvature radii of the centerline and .

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 377
Theory Documentation

Figure 5.4: Doubly Curved FE Geometry

The radial equilibrium equation becomes

(5.6)

where:

Each segment is embedded between four cross-sections which are assumed to remain straight and
perpendicular to the midplane. Studies on singly curved plates ([ 10 (p. 595) ] and [ 13 (p. 595) ]) show
that the shear terms have only small effect and are therefore neglected here. Equation 5.6 (p. 378)
reduces to
(5.7)

where only direct stresses appear and the material law reduces to

(5.8)

where are components of the 3D stiffness matrix expressed in reference coordinates which are
parallel to the principal direction. The evaluation is described in Reference Coordinates (p. 379). The
term indicates free layer strains due to spatially constant changes of temperature and moisture
content .
(5.9)

Direct strains in Equation 5.8 (p. 378) can be expressed through the displacements u, v, and w. The
kinematic relations in the modified coordinate system are:

(5.10)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
378 of ANSYS, Inc. and its subsidiaries and affiliates.
 Interlaminar Stresses

The in-plane deformations u and v are expressed by the laminate deformations and . The through-
the-thickness coordinate is replaced with the radial coordinate and the curvature radii of the
midplane:

(5.11)

The direct strains become

(5.12)

The combination of the material law of Equation 5.8 (p. 378) with the kinematic relations of Equa-
tion 5.10 (p. 378) leads to the direct stresses expressed by the deformations:

(5.13)

Equation 5.13 (p. 379) is combined with the radial equilibrium Equation 5.7 (p. 378) and the differential
equation of the through-the-thickness displacement is:
(5.14)

where:

5.2.2.1. Reference Coordinates

The reference coordinates, which are needed to evaluate the material stiffness and strains are
evaluated depending on the laminate properties or the curvature. If the laminate is non-isotropic,
the reference coordinates are parallel to the principal laminate directions, where the first principal
laminate stiffness has its maximum. In the case of a quasi-isotropic laminate, the reference coordin-
ates are parallel to the principal curvature directions.

5.2.2.2. Numeric Solution

The solution of Equation 5.14 (p. 379) is found with the finite difference method. The differential
equation represents a linear second order boundary value problem.
(5.15)

where the derivatives are replaced with

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 379
Theory Documentation

where are the displacements at the supporting points through the thickness and is the distance
between two consecutive supporting points. Their placement scheme for a single-layer laminate is
shown on the left of Figure 5.5: Integration Scheme (p. 380). The boundary conditions lead to a non-
singular linear system of equations (LSoE) and are represented by the INS which have to vanish at
the top and bottom surfaces of the laminate.

Figure 5.5: Integration Scheme

The above figure shows single layer (left) and multilayer laminate (right) where the indices 1, 2,
and 3 count the layers and refers to .

The through-the-thickness INS distribution is obtained by combining Equation 5.8 (p. 378) and
Equation 5.10 (p. 378).

(5.16)

This equation can be transformed to:

(5.17)

and is integrated in the LSoE where and modify the first and the last row of the left and right
side of the LSoE, respectively.

Every additional layer leads to two more interface continuity conditions that have to be fulfilled:

(5.18)

The first derivative of the through-the-thickness displacements is found using Equation 5.16 (p. 380).
Additional supporting points, which are placed outside the layer, are necessary to evaluate the INS
at the layer intersections. An integration scheme for a three layer laminate is plotted on the right
of Figure 5.5: Integration Scheme (p. 380) where the supporting points n = [7,8,15,16] guarantee the
through-the-thickness continuity of the INS.

5.2.3. Transverse Shear Stresses

The method employed for computing transverse (interlaminar) shear stresses of FSDT-based shell
elements is based on the work by Rohwer ([ 11 (p. 595) ]) and Rolfes ([ 12 (p. 595) ]). The transverse
shear stresses are calculated from the three dimensional equilibrium equations of elasticity:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
380 of ANSYS, Inc. and its subsidiaries and affiliates.
 Interlaminar Stresses

(5.19)

In order to calculate the shear stresses from the equilibrium equations, the in-plane stresses need to
be derived first and then integrated with respect to the thickness coordinate:
(5.20)

In-plane stresses are piecewise continuous functions, so the integration must be done in parts. Applying
the stress-strain relation for in-plane stresses, Equation 5.20 (p. 381) takes the form
(5.21)

where:

Strain derivatives in Equation 5.21 (p. 381) can also be transformed to give an expression in terms of
force derivatives by applying the constitutive equations. In order to calculate the stresses straight
from the shear forces, some additional assumptions have to be made.

The influence of the in-plane force derivatives is neglected, that is

(5.22)

Strain derivatives then reduce to the form

(5.23)

where and are the laminate compliance matrices.

The actual displacement fields are further simplified by assuming two separate cylindrical bending
modes. The moment derivatives then reduce to the simple resultant shear forces:

(5.24)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 381
Theory Documentation

Applying Equation 5.22 (p. 381), Equation 5.23 (p. 381), and Equation 5.24 (p. 381) to Equation 5.21 (p. 381)
yields:

(5.25)

This simplifies to:

(5.26)

where are the components of the 3 x 3 matrix . The components of the matrix are
piecewise continuous, second order functions of determined by:
(5.27)

where:

The functions and are defined by the continuity of stresses at the layer interfaces:

(5.28)

It can be seen that the functions and of Equation 5.27 (p. 382) give the laminate stiffness
matrices and at the lower surface of the laminate and zero at the top surface of the laminate:

(5.29)

Therefore, the transverse shear stresses of Equation 5.26 (p. 382) become zero for the top and bottom
surfaces and fulfill the boundary conditions of transverse shear stresses going to zero at the laminate
surfaces.

In the local coordinate system the transverse shear stresses are:

(5.30)

where the 2 x 2 transformation matrix is

(5.31)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
382 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

5.3. Failure Analysis

This section contains detailed background information on the evaluation of interlaminar stresses. A
generalized overview of failure analysis is shown in Postprocessing (p. 256).
5.3.1. Reserve Factor
5.3.2. Weighting Factors
5.3.3. Failure Criterion Function
5.3.4. Failure Criteria for Reinforced Materials
5.3.5. Sandwich Failure
5.3.6. Isotropic Material Failure
5.3.7. Adhesive Failure (Beta Version)
5.3.8. Failure Criteria vs. Ply Type Table

5.3.1. Reserve Factor

The reserve factor indicates margin to failure. The applied load multiplied by the reserve factor
gives the failure load:
(5.32)

Reserve factor values greater than one indicate positive margin to failure and values less than one
indicate negative margin. The values of reserve factors are always greater than zero.

The critical values of reserve factors lie between zero and one, whereas the non-critical values range
from one to infinity. Whether the results are shown in numeric form or as contour plots, the non-
critical values tend to be emphasized in comparison to critical values. Therefore, the inverse reserve
factor is often preferred in practical use:
(5.33)

The non-critical values of range from zero to one and the critical values from that on.

The margin of safety is an alternative for the reserve factor in indicating margin to failure. The
margin of safety is obtained from the corresponding reserve factor with the relation
(5.34)

A positive margin of safety indicates the relative amount that the applied load can be increased before
reaching failure load. Correspondingly, a negative margin of safety indicates how much the applied
load should be decreased. Margins of safety are typically expressed as percentages.

5.3.2. Weighting Factors

Several failure criteria implemented in ACP are able to predict the failure mode, for example whether
fiber or matrix failure occurs first. It is possible to assign weighting factors to individual failure mode
criteria and therefore create a certain bias towards or against a specific failure mode. As a result,
failure criteria can be tuned to specific requirements. A design may require a higher safety against
delamination than against fiber failure and the weighting factor of delamination is increased.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 383
Theory Documentation

Using the maximum stress criterion given in Equation 5.37 (p. 385) as an example, the following shows
the implementation of weighting factors in ACP:
(5.35)

5.3.3. Failure Criterion Function

The strength of materials and material systems under multiaxial loads can be predicted based on
different failure criteria. Failure criteria relate the material strength allowables, defined for uniaxial
tension-compression and shear, to the general stress-strain state due to multiaxial loads. Typically
failure criteria are presented as mathematical expressions called failure criterion functions , which
are functions of the stresses (or strains) and the material strength.

The values of failure criterion functions change with load similarly as the inverse reserve factor (values
below one are non-critical and one indicates failure). However, the values are generally not equal
except at the failure point. The reserve factor describes the distance from the point of the applied
load to the failure point. Typically a numeric line search method is used for determining the value of
based on the selected failure criterion, stresses and strains due to the applied load, and material
strength allowables.

5.3.4. Failure Criteria for Reinforced Materials

This section contains the following information:
5.3.4.1. Maximum Strain Criterion
5.3.4.2. Maximum Stress Criterion
5.3.4.3. Quadratic Failure Criteria
5.3.4.4. Hashin Failure Criterion
5.3.4.5. Puck Failure Criteria
5.3.4.6. LaRC Failure Criterion
5.3.4.7. Cuntze's Failure Criteria

5.3.4.1. Maximum Strain Criterion

In the maximum strain criterion, the ratios of the actual strains to the failure strains are compared
in the ply principal coordinate system. The failure criterion function is written as

(5.36)

where:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
384 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

5.3.4.2. Maximum Stress Criterion

In the maximum stress criterion, the ratios of the actual stresses to the failure stresses are compared
in the ply principal coordinate system. Thus, the failure criterion function is
(5.37)

where:

5.3.4.3. Quadratic Failure Criteria

In quadratic criteria all the stress or strain components are combined into one expression. Many
commonly used criteria for fiber-reinforced composites belong to a subset of fully interactive criteria
called quadratic criteria. The general form of quadratic criteria can be expressed as a second-order
polynomial.

(5.38)

In plane stress-state ( ), the polynomial reduces to the simpler form

(5.39)

The quadratic failure criteria in ACP (Tsai-Wu (p. 385), Tsai-Hill (p. 386), and Hoffman (p. 387)) differ
in how the coefficients and are defined. Generally, the coefficients and are determined
so that the value of the failure criterion function corresponds to the material strength when a uni-
directional stress state is present. However, not all coefficients can be determined in this way.

5.3.4.3.1. Tsai-Wu Failure Criterion

For the plane stress-state the Tsai-Wu criterion coefficients have the values

(5.40)

Thus, the criterion can be written as:

(5.41)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 385
Theory Documentation

The coefficient cannot be obtained directly from the failure stresses of uniaxial load cases.
For accurate results it should be determined through biaxial load tests. In practice, it is often
given in the form of a non-dimensional interaction coefficient:

(5.42)

To insure that the criterion represents a closed conical failure surface, the value of must be
within the range . However, the value range for physically meaningful material beha-
vior is more limited. The often used value corresponds to a "generalized Von Mises criterion".
The final Tsai-Wu constant becomes -1 as used in Equation 5.43 (p. 386). Similarly ,
can be dealt with using the corresponding values and , which leads to the Tsai-Wu 3D
expression:

(5.43)

In ACP the Tsai-Wu constants are:

, default -1
, default -1
, default -1

5.3.4.3.2. Tsai-Hill Failure Criterion

In the Tsai-Hill criterion, either tensile or compressive strengths are used for determining the
coefficients depending on the loading condition. The coefficients are:

(5.44)

where the values of and are:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
386 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

(5.45)

The Tsai-Hill failure criterion differentiates between UD and woven plies. The Tsai-Hill failure cri-
terion function for UD plies can be written in the form

(5.46)

For woven plies, the function becomes

(5.47)

where .

For the full 3D case, the following formulation can be used, as in [25 (p. 596)]:

(5.48)

where

(5.49)

5.3.4.3.3. Hoffman Failure Criterion

The Hoffman criterion defines the biaxial coefficients , , and with the following mater-
ial strength expressions for the 3D stress state:

(5.50)

The Hoffman failure criterion for a 3D stress state can be written as:

(5.51)

The biaxial coefficient for the plane stress state reduces to:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 387
Theory Documentation

(5.52)

The entire Hoffman criterion in the plane stress case reduces to:

(5.53)

5.3.4.4. Hashin Failure Criterion

The Hashin criterion [ 45 (p. 597) ] is used to predict failure in UD (transversal-isotropic orthotropic
23) materials. There are two formulations, one for plane stress and another for the full 3D stress
state.

In the Hashin criterion, criticality of tensile loads in the fiber direction is predicted with the
expression:

(5.54)

Under compressive loads in the fiber direction , failure is predicted with an independent
stress condition (for both 2D and 3D):
(5.55)

In the case of tensile transverse stress, the expression for predicting matrix failure is:

(5.56)

This expression is used when the transverse stress is compressive:

(5.57)

In addition and optionally, ACP predicts delamination (tension and compression) with this expression:
(5.58)

The most critical of the failure modes is selected:

(5.59)

5.3.4.5. Puck Failure Criteria

There are several different Puck Failure criteria, the following sections describe them.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
388 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

5.3.4.5.1. Simple and Modified Puck Criterion

The two oldest Puck failure criterion formulations are simple Puck and modified Puck. Both criteria
consider failure due to longitudinal loads and matrix failure mode due to transverse and shear
loads separately ([ 27 (p. 596) ] and [ 28 (p. 596) ]).

For both the simple and modified Puck criteria, failure in fiber direction is calculated the same
way as in the maximum stress criterion:
(5.60)

Matrix failure is calculated differently for each formulation as illustrated in Equation 5.61 (p. 389)
for simple Puck. Equation 5.62 (p. 389) demonstrates how tensile or compressive failure stresses
are used depending on the stress state.
(5.61)

where:

(5.62)

The modified Puck criterion differs from the simple criterion only in the formulation for matrix
failure:

(5.63)

As in Hashin Failure Criterion (p. 388), the failure occurs when either or reaches one, so the
failure criterion function is:
(5.64)

Despite being called simple in the failure criteria configuration in the Failure Criteria Definition
dialog the Puck modified version is actually implemented. The name is referring to the simplicity
of that criterion in comparison to Puck's Action Plane Strength Criterion (p. 389).

5.3.4.5.2. Puck's Action Plane Strength Criterion

The following sections describe the different failure modes for Puck’s action plane strength cri-
terion.

5.3.4.5.2.1. Fiber Failure (FF)

As in the simple Puck criterion, one option for evaluating fiber failure is to use the maximum
stress criterion for that case ([ 29 (p. 596) ], [ 30 (p. 596) ], and [ 31 (p. 596) ]):
(5.65)

and similarly a maximum strain criterion:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 389
Theory Documentation

(5.66)

A more complicated version for FF criterion was presented by Puck for the World Wide Failure
Exercise, but the maximum stress criterion is considered sufficient for the case of FF.

5.3.4.5.2.2. Interfiber Failure (IFF)

Interfiber failure is formulated differently depending on the model type.

Plane stress-state

Interfiber failure, or interfiber fracture ([ 29 (p. 596) ] and [ 30 (p. 596) ]) can be explained in the
cutting plane for which the principal stress of a UD layer is zero in the case of plane stress.

Figure 5.6: Fracture Curve in σ2, τ21 Space for σ1 = 0

The curve consists of two ellipses (modes and ) and one parabola (mode ). Generally
Puck's action plane strength criterion is formed utilizing the following 7 parameters,
, where stands for fracture resistances and for slope para-
meters of the fracture curves. The symbols and denote the reference to direction parallel
to the fibers and transverse (perpendicular) to the fibers. The values for and define the
intersections of the curve with -axis, as well as for the intersection with -axis. The
slope parameters and are the inclinations in the latter intersections.

The failure conditions for IFF are:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
390 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

(5.67)

The superscript denotes that the fracture resistance belongs to the action plane.

(5.68)

The assumption is valid here and leads to:

(5.69)

Equation 5.70 (p. 391) is also valid.

(5.70)

As the failure criterion functions and the functions for their corresponding stress exposure
factors are the same, they can be written as follows (given Equation 5.69 (p. 391) and Equa-
tion 5.70 (p. 391)):

(5.71)

3D Stress State

While the latter formulations have been a reduced case working in ( )-stress space, the
3D stress state can be described with Equation 5.72 (p. 391):

(5.72)

where:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 391
Theory Documentation

From the above equations, the failure criterion function is formulated in the fracture (action)
plane using the corresponding stresses and strains. The formulations for the stresses , ,
and in an arbitrary plane with the inclination angle are:

(5.73)

To find the stress exposure factor the angle is iterated to find the global maximum, as
the failure will occur for that angle. An analytical solution for the fracture angle is only available
for plane stress-state by assuming:
(5.74)

which leads to formulations for the exposure factor:

(5.75)

Puck illustrated in [ 29 (p. 596) ] that the latter criterion can be used as a criterion to determine
delamination, if an additional weakening factor for the interface is applied, finally
resulting in:

(5.76)

The active failure mode depends on the fraction angle and the sign of . Delamination can
occur if is positive and is 90 degree. The failure modes and happen with neg-
ative .

Puck Constants

Different default values for the coefficients are set for carbon and glass fiber plies to:

Carbon:

Glass:

Those values are compliant with recommendations given in [ 32 (p. 596) ].

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
392 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

Influence of fiber parallel stresses on inter-fiber failure

To take into account that some fibers might break already under uniaxial loads much lower
than loads which cause ultimate failure (which can be seen as a kind of degradation), weakening
factors can be introduced for the strength parameters. Puck formulated a power law relation
in [ 29 (p. 596) ]:
(5.77)

where and and can be can be experimentally determined.

Different approaches exist to handle this problem numerically. The function given in Equa-
tion 5.77 (p. 393) can be replaced by an elliptic function:

(5.78)

where:

and are degradation parameters.

In ACP, the stress exposure factor is calculated by intersecting the weakening factor ellipse
with a straight line defined by the stress vector using the parameters:

Otherwise the fiber failure criterion determines the stress exposure factor .

Default values for the degradation parameters are and .

5.3.4.6. LaRC Failure Criterion

LaRC03 (2D) and LaRC04 (3D) are two sets of failure criteria for laminated fiber-reinforced composites.
They are based on physical models for each failure mode and distinguish between fiber and matrix
failure for different transverse fiber and matrix tension and compression modes. The LaRC criteria
take into account that the apparent (in-situ) strength of an embedded ply, constrained by plies of
different fiber orientations, is different compared to the same ply embedded in a UD laminate.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 393
Theory Documentation

Specifically, moderate transverse compression increases the apparent shear strength of a ply. Sim-
ilarly in-plane shear significantly reduces the compressive strength of a ply. The evaluation of the
in-situ strength also makes a distinction between thin and thick plies. The definition for a thick ply
is a ply in which the slit crack is much smaller than the ply thickness. For epoxy E-glass and epoxy
carbon laminates, the suggested threshold between thin and thick plies is 0.7 mm ([ 21 (p. 596) ]
and [ 26 (p. 596) ]).

The implemented LaRC04 (3D) failure criterion ACP assumes linear shear behavior and small angle
deflection. The abbreviation LaRC stands for Langley Research Center.

5.3.4.6.1. LaRC03/LaRC04 Constants

The required unidirectional properties for the criteria are:

, , , , , , , , , , and .

where is the longitudinal shear strength and and are the fracture toughness for mode
I and II.

The following LaRC Constants are required for postprocessing in ACP:

• Fracture Toughness Ratio: (Dimensionless)

• Fracture Toughness Mode I: (Force / Length)

• Fracture Toughness Mode II: (Force / Length)

• Fracture Angle under Compression: (Degrees)

• Thin Ply Thickness Limit (Length)

The fracture angle can be determined in tests or taken to be which has proven to have
good results for carbon/epoxy and glass/epoxy laminates [ 30 (p. 596) ]. The Thin Ply Thickness
Limit is the only default value set for the LaRC parameters. The following reference values are
drawn from [ 37 (p. 597) ]:

Parameter Typical Values

(Carbon/epoxy)
Elastic Modulus, (GPa) 128

Elastic Modulus, , (GPa) 7.63

Fracture Angle (deg) 53
Fracture Toughness Mode 1, (N/mm) 0.28
Fracture Toughness Mode 2, 0.79
(N/mm)
Fracture Toughness Ratio, g 0.35
Thin Ply Thickness Limit (mm) 0.7

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
394 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

5.3.4.6.2. General Expressions

Several failure functions involve the friction coefficients, in-situ strengths, and fiber misalignment.
These values are described in the following sections.

Friction Coefficients

Laminates tend not too fail in the plane of maximum shear stress. This is attributed to internal
friction and considered in the LaRC failure criteria with two friction coefficients:

Transverse Friction Coefficient:

Longitudinal Friction Coefficient:

In-Situ Ply Strength

The in-situ transverse direct strength and longitudinal shear strength for a thin ply are:

(5.79)

where:

= thickness of an embedded ply

For a thick ply, the in-situ strengths are not a function of the ply thickness:

(5.80)

5.3.4.6.3. Fiber Misalignment Frame

Fiber compression, where the plies fail due to fiber kinking, is handled separately for transverse
tension and transverse compression. In the model, imperfections in the fiber alignment are rep-
resented by regions of waviness, where transformed stresses can be calculated using a misalign-
ment frame transforming the "original stresses". There are two different misalignment frames for
LaRC03 (2D) and LaRC04 (3D).

LaRC03

For LaRC03, the stresses in the misaligned frame are computed as follows:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 395
Theory Documentation

(5.81)

The misalignment angle for pure compression can be derived to 114 (p. 396) using
and in the equations above as well as the stresses and the quadratic interaction
criterion presented in Equation 5.93 (p. 398) for matrix compression.

(5.82)

The total misalignment angle is calculated from:

(5.83)

LaRC04

The 2D misalignment model assumes that the kinking occurs in the plane of the lamina. LaRC04
incorporates a more complex 3D model for the kink band formation. The kink plane is at an
angle to the plane of the lamina. It is assumed to lie at an angle so that and is therefore
given by:

(5.84)

and the stresses rotated in this plane are:

Following the definition of a kink plane, the stresses are rotated into a misaligned frame. This
frame defined by evaluating the initial and the misalignment angles for pure compression as well
as the shear strain under the assumption of linear shear behavior and small angle approximation:

(5.85)

where:

= the misalignment angle for pure compression.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
396 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

Following this, the stresses can be rotated into the misaligned coordinate system:

5.3.4.6.4. LaRC03 (2D)

The following sections describe the failure modes for LaRC03 (2D).

Fiber Failure

For fiber tension a simple maximum strain approach is applied:

(5.86)

Fiber compression failure for matrix compression is calculated as follows:

(5.87)

For fiber compression failure with matrix tension, the following quadratic equation has to be
solved:

(5.88)

Matrix Failure

The formulation for matrix tensile failure is similar to that of fiber compressive failure under
transverse compression. The difference is that the stress terms are not in the misaligned frame.

(5.89)

Matrix compression failure is divided into two separate cases depending on the longitudal loading.
The failure function for the first case is:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 397
Theory Documentation

(5.90)

where the effective shear stresses for matrix compression are based on the Mohr-Coulomb criterion
which relates the effective shear stresses with the stresses of the fracture plane in Mohr's circle.

(5.91)

The transverse shear strength in terms of the transverse compressive strength and the fracture
angle can be written as:

(5.92)

The failure function for the second case is:

(5.93)

where the effective shear stresses are rotated into the misaligned frame:

5.3.4.6.5. LaRC04 (3D)

The following sections describe the failure modes for LaRC04 (3D).

Fiber Failure

The LaRC04 fiber tensile failure criteria is simply a maximum allowable stress criterion with no
interaction of other components:
(5.94)

Fiber compressive failure is divided into two components depending of the direction of the
transverse stress. For transverse compression it is:

(5.95)

The failure function for fiber compression and matrix tension is based on the Ansys Combined
Stresses and Strains formulation for the LaRC criteria.

(5.96)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
398 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

Matrix Failure

The failure function for matrix tension is based on the Ansys Combined Stresses and Strains for-
mulation for the LaRC criteria.

(5.97)

Matrix compressive failure is given by:

(5.98)

where:

Matrix compressive failure with transverse tension is given by:

(5.99)

5.3.4.7. Cuntze's Failure Criteria

Cuntze's approach is based on his general invarient-formulated failure mode concept (applicable
for isotropic and orthotropic materials), applied here to transversely isotropic UD materials. This
concept strictly separates the 5 strength failure modes inherent to UD materials. Material symmetry
requires strength measurements in 5 directions, and physical fracture morphology dictates that
each failure mode is dominated by strength in a single direction only.

Cuntze's strength of failure conditions (SFC) can be termed modal conditions according to the fact
that a failure function F describes just one failure mode and involves just the mode-associated
strength:
(5.100)

with the vector of 6 stresses .

A set of modal SFCs requires an interaction of the 5 failure modes. The observed failure modes are
two fiber failure modes (FF1 tension, and FF2 compression) and three interfiber failure modes (IFF1
transverse tension, IFF2 transverse compression, and IFF3 shear) which represent cohesive and ad-
hesive matrix failures between fiber and matrix.

Cuntze provides equivalent stresses for all 5 fracture failure modes of the brittle-behaving UD ma-
terial similarly to the Hencky-Mises-Huber yielding failure mode of ductile-behaving materials.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 399
Theory Documentation

Figure 5.7: UD Failure Modes

An equivalent stress includes all stresses that are acting together in a given failure mode. The
vector containing all equivalent stresses is:
(5.101)

where an equivalent stress is related to the mode strength and the material stressing effort by:

(5.102)

(5.103)

where the overbar marks statistical average values and the mode strengths can be substituted by
the respective material stress limits.

In addition to the 5 strengths, Cuntze uses two material-inherent fracture parameters,

(required by Mohr-Coulomb), because SFCs for brittle-behaving materials cannot be based on
strength values alone. Macromechanical SFCs must consider that materials fail on the micromech-
anical level, with respect to the fiber failure modes.

Five invariants are used for the generation of the five SFCs (2D or 3D) [ 17 (p. 596) ]:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
400 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

(5.104)

5.3.4.7.1. 3D Failures
Replacing the invariants in Cuntze's invariant formulated SFCs [ 19 (p. 596) ] [ 20 (p. 596) ] with the
associated stress states (factoring in IFF3 not the full stress state components but just the mode
failure driving stress) and resolving for the simplified material stressing efforts yields the fol-
lowing:

(5.105)

where the superscripts and stand for tension and compression, respectively.

The friction parameter can be computed from the available friction coefficients of the UD ma-
terial, derived in [ 20 (p. 596) ]

(5.106)

with typical ranges being:

If measurement data of the fracture angle is given, the friction coefficient is determined as:
(5.107)

or the directly related parameter as:

(5.108)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 401
Theory Documentation

where .

If the IFF2 and IFF3 curves are based on enough test data, the 2 friction parameters can be de-
termined using the following formulas [ 20 (p. 596) ]:

(5.109)

An interaction of the failure modes occurs due to the fact that the full (global) failure surface
consists of five parts. Cuntze models these interactions by a simple, probability-based series spring
model [ 17 (p. 596) ]. This model describes the lamina failure system as a series failure system
which fails whenever any of its elements fail. Each mode is one element of this failure system
and is treated as independent of the others. By this method, the interaction between FF and IFF
modes as well as between the various IFF modes acts as a rounding-off procedure, enabling the
determination of the final or inverse reserve factor (IRF).
(5.110)

In other words, the interaction equation includes all mode stressing efforts, and each of them
represents a portion of the material's load-carrying capacity. In 2D practice at maximum 3 of the
5 modes will interact.

The modes' interaction exponent is obtained by curve-fitting of test data in the interaction
zones. Experimental data showed that (for CFRP) .

The exponent is high in case of low scatter and low in the case of high scatter, hence chosing
a low value for the interaction exponent is conservative. As an engineering assumption, is always
given by the same value, regardless of the distinct mode interaction domain.

For pre-design, Cuntze recommends and

5.3.4.7.2. 2D Failures

Cuntze's approach delivers the following simplified material stressing efforts for the five failure
modes:

(5.111)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
402 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

5.3.5. Sandwich Failure

The following sections describe the different failure criteria for sandwich failure.
5.3.5.1. Core Failure
5.3.5.2. Face Sheet Wrinkling
5.3.5.3. Shear Crimping Failure

5.3.5.1. Core Failure

The Core Failure criterion predicts failure of core materials in sandwich structures due to interlam-
inar shear ( , ) and normal stresses . It is assumed that core failure is highly dominated by
the out-of-plane stresses and therefore the in-plane terms are neglected. The normal stress is
only considered in the 3D formulation of the criterion. By default, the 2D formulation is active.

The failure criterion distinguishes between isotropic (isotropic-homogeneous) and orthotropic (or-
thotropic homogeneous and honeycomb) core materials. For isotropic cores, a simplified formulation
of the Tsai-Wu (p. 385) is used [ 44 (p. 597) ]. For orthotropic materials, the maximum stress approach
is implemented [ 43 (p. 597) ]. An isotropic-homogeneous core has othotropic stress limits in order
to support the core failure criterion as described below. R, Q, and Zt / Zc are the strength limits
with respect to the corresponding stress component.

Isotropic Core

(5.112)

Orthotropic Core

(5.113)

In previous releases of ACP, the core failure criterion was implemented differently. The previous
implementation can still be evaulated using custom failure criteria. An example implementing the
previous core failure criterion is provided in Evaluating Custom Failure Criteria (p. 260).

5.3.5.2. Face Sheet Wrinkling

Wrinkling of sandwich face sheets is a local instability phenomenon, in which the face sheets can
be modeled as plates on an elastic foundation formed by the core. Simple formulas for estimating
wrinkling stresses of sandwich face sheets under uniaxial load have been presented in the literature
([ 23 (p. 596) ] and [ 33 (p. 596) ]). Linear elastic material behavior is assumed. Possible interaction of
the top and bottom face sheets is not considered.

In the following, , , and refer to a coordinate system in which the -axis is in the direction of
compression and the -axis is perpendicular to the face sheets. The subscripts F and C indicate the
face sheet and the core, respectively.

For sandwich laminates with homogeneous cores, the wrinkling stress of a face sheet is:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 403
Theory Documentation

(5.114)

where the theoretical value of the wrinkling coefficient is 0.825. The effects of initial waviness
and imperfections of the face sheet are normally accounted for by replacing the theoretical value
of the wrinkling coefficient with a lower value. it is recommended that you use the value
as a safe design value for homogeneous cores ([ 23 (p. 596) ] and [ 33 (p. 596) ]).

The wrinkling stresses for sandwich laminates with honeycomb cores are estimated with the expres-
sion:

(5.115)

The theoretical value of is 0.816, whereas a safe design value is ([ 23 (p. 596) ] and [
33 (p. 596) ]).

The prediction of wrinkling under multiaxial stress state is discussed in [ 33 (p. 596) ]. When in-plane
shear stresses exist, it is recommended that the principal stresses are determined first. If the other
of the two principal stresses is tensile, it is ignored and the analysis is based on the equations given
above. When biaxial compression is applied, wrinkling can be predicted with an interaction formula.
The condition for wrinkling is:
(5.116)

where is the direction of maximum compression [ 33 (p. 596) ]. For orthotropic sandwich face
sheets, is more logically interpreted as the most critical of the two directions. The wrinkling
stresses and are computed from the formulas for uniaxial compression by considering the
compressive stresses in the - and -direction independently.

The average face sheet stresses , , are obtained from the layer stresses of the face sheets.
The following procedure for the computation of reserve factors is then used independently for the
top and bottom face sheets.

If the shear stress of the face sheet is zero, the normal stresses and are used directly in
the prediction of wrinkling. Otherwise, the principal stresses are determined first:
(5.117)

The orientation of the normalized principal stresses with respect to the xy-coordinate system is

(5.118)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
404 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

where:

5.3.5.3. Shear Crimping Failure

Although formulated as a local failure criterion, shear crimping describes a form of general overall
buckling failure. It applies to cases where the wavelength of the buckles is very small if compared
with global buckling because of low core shear modulus. The crimping of the sandwich occurs
suddenly and usually causes the core to fail in shear at the crimp. It may also cause shear failure
in the bond between the facing and core. This kind of failure often appears because of a post-
buckled state (out-of-plane deformations) when out-of-plane forces appear due to the deformations.

The critical shear crimping load proposed by Vinson ([39 (p. 597)]) is
(5.119)

where

= allowable compressive force [force/length]

= core thickness
= shear modulus of the core in the loading direction

Vinson ([39 (p. 597)]) assumed very thin face sheets so that their contribution to the critical shear
crimping load can be disregarded. Experience shows that shear crimping can also occur in sandwich
panels with relatively thick face sheets, especially in regions where the laminate stiffness changes
abruptly or close to loadings. Therefore, other theories take the stiffness of the face sheets into
account ([39 (p. 597)]):
(5.120)

where

= distance between middle surfaces of face sheets [length].

= thickness of the bottom face sheet
= thickness of the top face sheet

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 405
Theory Documentation

The critical shear crimping load is sensitive towards imperfections as shown by Léotoing ([41 (p. 597)]).
So a slightly adjusted formulation is implemented in ACP which provides maximum flexibility to
configure the criterion to take application and material specific characteristics into account.
(5.121)

= weighting factor of the core term

= weighting factor of the face sheet term

The shear crimping factors and are derived from test data. The defaults for and are 1
and 0, respectively. So, by default, the critical shear crimping load in ACP is equal to Equa-
tion 5.119 (p. 405) (Vinson (p. 597)) (for laminates where the face sheets are much thinner than the
core material). In case of = = 1, the predicted critical load is slightly different if compared
with Equation 5.120 (p. 405) (Sullins (p. 597)), depending on the thickness ratio between the face
sheet and core.

For uniaxial compression the effort is:

(5.122)

where [force/length] is the in-plane laminate load.

In the case of shear loading, the effort in Equation 5.122 (p. 406) is evaluated with respect to the
principal direction of loading. The material parameters of Equation 5.121 (p. 406) are rotated into
the principal direction of loading to get the allowable forces and with respect to the first
and second principal directions of loading.

In the case of biaxial compression, the failure condition of shear crimping is the sum of the efforts
in the first and second loading direction:

(5.123)

where and are the first and second principal laminate loads, respectively.

In general, it is recommended you validate the numerical results with experimental measurements
because the shear crimping failure mode is sensitive to imperfections and local effects (stiffness
changes, for example).

5.3.6. Isotropic Material Failure

The failure criteria for isotropic materials is based on the von Mises stress (or equivalent stress in
Mechanical):
(5.124)

or on the von Mises strain (or equivalent strain in Mechanical):

(5.125)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
406 of ANSYS, Inc. and its subsidiaries and affiliates.
 Failure Analysis

where and are the first and second principal strains. For isotropic material, the stress failure
function is defined as:
(5.126)

and the strain failure function is defined as:

(5.127)

5.3.7. Adhesive Failure (Beta Version)

This section describes the available failure criteria for adhesive materials. All criteria calculate an ef-
fective stress that corresponds to the applied load. If this value is greater than the allowable
limit , then failure occurs. is defined by the Tensile Yield Strength in Engineering Data.

5.3.7.1. Peel Stress Criterion

This criterion predicts failure in an adhesive material that is dominated by the peel stress .

If is > 0, then = , else = 0.

5.3.7.2. Shear Stress Criterion

The shear stress criterion predicts failure caused by the interlaminar shear stresses and . The
allowable limit is typically determined by a tensile lap shear test (lap shear strength).

Notes
Note that:

• The listed failure criteria can be activated via the application menu (Tools - Preferences -
ACP - Add-Ons - Adhesive Failure Criteria).

• If both the peel and shear stress criteria are active, then the weighting factor can be used
in one of the criteria in order to adjust because the peel and shear strengths typically
differ.

Limitations
Review the following limitations:

• Failure mode labels are not currently exposed and display "na" (not available).

• Adhesive failure criteria are not currently exposed in Mechanical.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 407
Theory Documentation

Reference
Yarrington, P., Zhang, J., Collier, C., Bednarcyk, B.A., Failure Analysis of Adhesively Bonded Composite
Joints, American Institute of Aeronautics and Astronautics.

5.3.8. Failure Criteria vs. Ply Type Table

The table below illustrates which failure criteria evaluates the safety of the different ply types.

Failure Ply Type

Criteria Regular Woven Homogeneous Honeycomb Isotropic Adhesive Sandwich
(UD) Core Core
Max Strain √ √
Max Stress √ √
Tsai-Wu √ √
Tsai-Hill √ √
Hofmann √ √
Hashin √
Puck √ √ [1]
Cuntze √
LaRC √
Wrinkling √ [2]
Core Failure √ √
Von Mises √
Shear √ √
Crimping
Shear Stress √ [3]
Peel Stress √ [3]

1. In combination with Puck for Woven specifications. See the section Puck for Woven (p. 78).

2. Sandwich is a laminate with at least one core layer.

3. Only available if the add-on "Adhesive Failure Criteria" is enabled in ACP.

5.4. Classical Laminate Theory

The Classic Laminate Theory analysis described in the following sections can be evaluated using the
Sampling Point, Stack-up and Sublaminate Properties. In a Sampling Point, the laminate properties and
stiffness/compliance matrices are evaluated based on the lay-up on the shell mesh. The changes to the
lay-up incurred by solid model operations (Extrusion Guides, Snap-To and Cut-Off operations) are not
considered. The laminate forces can only be evaluated if the shell mesh has a solution with nodal de-
formations.
5.4.1. Overview
5.4.2. Analysis

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
408 of ANSYS, Inc. and its subsidiaries and affiliates.
 Classical Laminate Theory

5.4.1. Overview
Classical Laminate Theory provides useful information about the mechanical behavior of a composite
structure. The in-plane and flexural laminate stiffness represent characteristic values which can be
compared with other laminates. These information can be quite useful since no external loads and
boundary conditions are necessary to evaluate these values.

Classical Laminate Theory is described in many text books ([ 34 (p. 596) ] and [ 35 (p. 596) ]). The basic
assumptions are:

• Layers are perfectly bonded together.

• The material properties of each layer are constant through the thickness.

• Linear-elastic strain-stress behavior.

• Lines originally straight and normal to the mid-plane remain straight and normal in extension and
bending.

• Plane stress state.

• In-plane strains and curvature are small compared to all other dimensions.

This requirements are fulfilled in a relatively thin or moderate thick laminate where the thickness is
small compared to the in-plane extensions (length and width).

5.4.2. Analysis
The following sections describe analysis using Classical Laminate Theory.
5.4.2.1. Laminate Stiffness and Compliance Matrices
5.4.2.2. Normalized Laminate Stiffness and Compliance Matrices
5.4.2.3. Laminate Engineering Constants
5.4.2.4. Out-of-Plane Shear Moduli and Correction Factors
5.4.2.5. Polar Properties
5.4.2.6. Analysis Options

5.4.2.1. Laminate Stiffness and Compliance Matrices

The laminate stiffness matrix is an 8 x 8 matrix that contains the ABD matrix (6 x 6) as well as the
shear matrix C (2 x 2).

(5.128)

The ABD matrix of the laminate is the stiffness matrix of the laminate. A is the in-plane stiffness
matrix, B describes the coupling between in-plane forces and bending moments and D is the flex-
ural stiffness matrix. The B matrix becomes 0 in the case of a symmetrically balanced laminate.

In addition to the ABD terms the shear matrix C is evaluated as well. The shear matrix has form

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 409
Theory Documentation

and represent the and stiffness, respectively.

The compliance matrix is an 8 x 8 matrix that contains the inverse of the ABD matrix and the inverse
of the C matrix. The inverse of the ABD is also called the abd matrix (ABD -1).

Figure 5.8: Relation Between ABD Matrix and the Coupling Between Laminate Forces and
Deformations

5.4.2.2. Normalized Laminate Stiffness and Compliance Matrices

The stiffness and compliance matrices can also be written in a normalized form where is the
*
laminate thickness. The normalized stiffness matrices ABD are:

• In-plane stiffness matrix:

• Coupling matrix:

• Flexural stiffness matrix:

• Out-of-plane shear matrix:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
410 of ANSYS, Inc. and its subsidiaries and affiliates.
 Classical Laminate Theory

And the normalized compliance matrices abd * are:

• In-plane compliance matrix:

• Coupling matrix:

• Flexural compliance matrix: .

• Out-of-plane shear matrix:

5.4.2.3. Laminate Engineering Constants

The laminate engineering constants are derived from the normalized compliance matrices which
can be compared with the ply compliance matrix. Therefore the in-plane engineering constants
are derived from the normalized in-plane compliance matrix:

• Laminate stiffness:

• Laminate stiffness:

• Laminate shear stiffness:

and the out-of-plane shear terms are derived from the normalized shear compliance matrix:

• Shear correction factors: and k55

• Out-of-plane shear stiffness:

• Out-of-plane shear stiffness:

And the flexural constants are derived from the normalized flexural compliance matrix:

• Flexural laminate stiffness:

• Flexural laminate stiffness:

• Flexural laminate shear stiffness:

In the case of coupling between in-plane and bending forces ( matrix has non-zero elements),
the engineering constants represents the case where the laminate is free to curve when loaded
with in-plane forces.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 411
Theory Documentation

5.4.2.4. Out-of-Plane Shear Moduli and Correction Factors

The out-of-plane shear stiffness matrix C is computed by:

where ti is the i-th ply thickness and G the i-th ply out-of-plane shear matrix (2x2) in the laminate
coordinate system.

The laminate out-of-plane shear stiffnesses G31 and G23 are overestimated by the first order shear
deformation theory. This can be overcome by using shear correction factors. ACP uses the theory
developed by Isaksson [ 46 (p. 597) ] to compute the out-of-plane shear correction factors k44 and
k55.

The final out-of-plane shear moduli are computed as:

where t is the total laminate thickness. So the shear correction factors are already included in
laminate properties computed by ACP.

Figure 5.9: Laminate Properties with Out-of-Plane Shear Stiffness and Shear Correction
Factors

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
412 of ANSYS, Inc. and its subsidiaries and affiliates.
 Classical Laminate Theory

5.4.2.5. Polar Properties

The polar plot shows the in-plane laminate engineering constants of the laminate ( , and )
rotated by 0 to 360 degrees. This plot highlights the anisotropy of the laminate and the influence
of the orientation.

5.4.2.6. Analysis Options

The options Offset is Middle and Consider Coupling Effect allow you to modify the evaluation
of the laminate properties.

• Offset is Middle: This option moves the reference plane of the laminate to the middle (default:
True). This option is useful since the layers in a FE analysis mostly have one offset direction and
hence the reference plane is at the top or bottom of the laminate. This option reduces the
coupling effect between in-plane and bending forces. It considers the results of the stiffness and
compliance matrices, polar properties, and laminate engineering constants.

• Consider Coupling Effect: The polar properties and laminate engineering constants are derived
from the laminate compliance matrix (inverse ABD matrix) where, by default, the coupling effect
is considered (default: True). This option allows you to neglect this effect which causes the polar
properties and laminate engineering constants to represent the values of a symmetrically balanced
laminate. Note that the coupling effect can significantly reduce the polar properties and laminate
engineering constants.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 413
Theory Documentation

5.5. General Interpolation Library

The General Interpolation Library (GIL) is the interpolation engine used in ACP and Mechanical APDL
during Variable Material Data analyses available with composite workflows. The following sections describe
the available options and algorithms:
5.5.1. Algorithms
5.5.2. Options
5.5.3. Extrapolations

5.5.1. Algorithms
The General Interpolation Library (GIL) currently provides 3 interpolation algorithms:

• Nearest-neighbor (p. 414)

• Linear multivariate (p. 415)

• Radial basis (p. 416)

The GIL is a suitable library for scattered data interpolation. For example, consider a set of materials
testing results that represent the Young's modulus of a material at different temperatures and humid-
ities. The test series will contain only a few combinations of temperature and humidity at which an
actual measurement was made. When transferring this testing data to Workbench Engineering Data
and performing an analysis making use of this material, it is expected that Workbench makes reasonable
guesses at the Young's modulus at intermediate combinations of temperature and humidity as the
simulation is performed.

Generally, the GIL interpolates a dependent variable, which is only known at a few scattered points
in the n-dimensional space of the independent (defining) variables:

is the interpolation function. The set of points in the independent data space together with their
given dependent variable values are called supporting points. The point in the independent space
for which the dependent value is requested is called the query point.

The GIL has no restriction on the dimensions of the independent data space. However, composite
analyses with variable material data are currently restricted to 9 dimensions. This means that properties
such as Young's modulus can be controlled by up to 9 variables.

Note:

The GIL is only suitable for interpolation of scalar quantities.

5.5.1.1. Nearest-Neighbor Interpolation

Given a query point, the nearest neighbor algorithm searches the supporting point with the smallest
Euclidean distance to the query point and returns the corresponding dependent value:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
414 of ANSYS, Inc. and its subsidiaries and affiliates.
 General Interpolation Library

where X is the set of all supporting points and q is the query point.

5.5.1.2. Linear Multivariate Interpolation

The current implementation of the linear multivariate algorithm works as follows:

1. Triangulate the independent variable space.

2. Search the simplex containing the query point (or the closest simplex to the query point).

3. Span a hyperplane through n+1 vertices (supporting points) of the this simplex.

4. Evaluate the dependent value along the hyperplane at the position of the query point.

If the independent variable space is 2D, then this procedure is like finding the triangle containing
the query point, then defining a plane in the third dimension through the dependent values of its
three vertices, which are supporting points, and eventually reading out the dependent variable on
the plane at the position of the query point. Another interpretation of this procedure are barycentric
coordinates of the query point with respect to the vertices of the simplex spanned by the n+1
supporting points. This approach is well-known in finite element theory.

Writing the query point as a linear combination of the n+1 vertices of the respective simplex:

and assuming a linear interpolation function :

we find:

where is the dependent value of the supporting point . The are a function of the coordinates
of of the query point.

More details can be found in [42] (p. 597).

The following figure is an illustration of the linear multivariate algorithm for two independent fields,
and . The dots represent the independent data which are provided. The dashed line represents
the bounding box. The simplex containing the query point x is visualized with solid lines. represent
the respective vertices of this simplex.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 415
Theory Documentation

Figure 5.10: Linear Multivariate Algorithm

By default, the triangulation is performed by using the dD Triangulation from the CGAL library.

Note:

In general, the quality of the triangulation can deteriorate close to the boundary of the
convex hull. For instance, simplices with large aspect ratio are created when you have
support points within the convex hull close to its boundary. This can negatively affect
the interpolation.

5.5.1.3. Radial-Basis Algorithm

Radial-basis interpolation is a global algorithm that is C1 continuous, especially useful for higher-
dimensional scatter data.

Interpolation of the parameters is done by solving the following radial-basis function Z = f(X1, X2,
X3… XO) at all input data points:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
416 of ANSYS, Inc. and its subsidiaries and affiliates.
 General Interpolation Library

where N is the number of data points and O is the number of free variables (or the order of the
interpolation). Input data is (xj,1, xj,2, …, zj) where j varies from 1 to N.

The unknown values are ai (where i varies from 1 to N) and c. Z is the unknown and Xj refers to
the query point. The equation is evaluated for all data points provided in the input to calculate the
ai and c values.

This algorithm is computationally intensive. Large data sets can affect performance adversely.

5.5.2. Options
The GIL provides a set of options to control the interpolation process:

Default Data

Must be specified for each independent variable. This value is assumed for incomplete queries,
this is if only a subset of the independent variables is specified for a query.

Cache

If enabled, GIL caches interpolation results, which improves performance if multiple queries are
made for the same query point. Will increase memory usage.

Normalize

In order to set the different independent variable axes into perspective to each other, each axis
is normalized when this option is turned on. The resulting normalized axes are given as:

where is the independent variable, is the normalized independent variable, is the axis'
Lower Limit, and is the Upper Limit.

Normalization is relevant to all GIL algorithms.

Lower and Upper Limit

These two values control the normalization of the independent variable axes. A reasonable choice
for the upper and lower limit could span the typical range for the independent variable, for ex-
ample.

5.5.3. Extrapolations
The GIL constructs a bounding box around the independent data of the supporting points. By default,
query points outside of this bounding box are projected to the bounding box before interpolation.
In the case of Linear Multivariate interpolation, GIL also provides the option to project query points
to the convex hull of the independent data of the supporting points.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 417
Theory Documentation

5.6. Nomenclature

Greek Symbols
α Coefficient of thermal expansion / Fracture angle in LaRC
β Coefficient of moisture expansion / Shearing angle in draping
γ Shear strain, shear angle
η Coefficient of influence
Δ Load change
ε Normal strain
ϑ Third coordinate of the modified cylindrical coordinate system
κ Curvature
ν Poisson's ratio
σ Normal stress
τ Shear stress
φ Misalignment angle
ϕ Second coordinate of the cylindrical coordinate system
ξ, η, ζ Principal stress/strain coordinate system

Latin Symbols
Curve fitting parameter for Cuntze's failure criterion
Components of the 3D stiffness matrix
Young's modulus
Coefficients in quadratic failure criteria, stress space

Interaction coefficient in the Tsai-Wu criterion

Failure criterion function

Shear modulus
Toughness ratio
Moisture / humidity
Thickness
IRF Inverse Reserve Factor
MoS Margin of safety
Interaction exponent for Cuntze's failure criterion
Slope parameter for Puck's action plane criterion
Shear failure stress in the 23-plane/Wrinkling coefficient
Shear failure stress in the 13-plane/Midplane curvature radius
Fracture resistance in Puck's action plane criterion

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
418 of ANSYS, Inc. and its subsidiaries and affiliates.
 Nomenclature

Radial ordinate R+z

rd Radius difference
RF Reserve Factor
Shear failure stress/strain in the 12-plane
Temperature
In-plane displacement in x, y-direction
Failure stress/strain for isotropic material
Through-the-thickness displacement
Failure stress/strain in the 1-direction
Global x-coordinate
Failure stress/strain in the 2-direction
Global y- and longitudinal coordinate of the cylindrical coordinate system
Thickness coordinate
1, 2, 3 Ply principal coordinate system

Subscripts
Core
Compressive
Delamination
Exposure
Effective
Face sheet
Bottom face sheet
Top face sheet
Fiber failure mode
In-situ
Matrix failure mode
Supporting point number
Tensile
Perpendicular to fiber
Parallel to fiber
Wrinkling
, Derivative

Superscripts
Midplane strain

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 419
Theory Documentation

Action plane
Under compression load
Sum of temperature and moisture effects
Longitudinal
In misalignment frame coordinate system
Under tension load / Transverse

Acronyms
FF Fiber Failure
IFF Inter-fiber Failure
INS Interlaminar Normal Stress
ISS Interlaminar Shear Stress
LSoE Linear System of Equations
UD Unidirectional

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
420 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 6: The ACP Python Scripting User Interface
The ACP Python Module provides the scripting user interface of ACP.
6.1. Introduction to ACP Scripting
6.2. Extending the Python Environment in ACP Pre and Post
6.3.The Python Object Tree
6.4. DB Database
6.5. Material Classes
6.6. Model Classes
6.7. Solid-model Classes
6.8. Solution Classes
6.9. Scene Classes
6.10. Postprocessing Definition Classes
6.11. Plot Classes

6.1. Introduction to ACP Scripting

In this section, the following topics are covered:
6.1.1. Basic Scripting
6.1.2. Advanced Scripting
6.1.3. Scripting Examples

6.1.1. Basic Scripting

The scripting language of ACP is Python which is an object oriented programming language. The
user should have some basics experience in object oriented programming for the optimal use, but a
basic script can easily be written by modifying an existing one or copy and paste the History
View (p. 34) or the Shell View (p. 32).

An example of one command is given below. In this command, the density of the material Core-
cell_A450 is defined (or modified if already defined) as 90.
db.models['class40.1'].material_data.materials['Corecell_A450']['density'].set(rho=90.0)

The easiest way to use scripting is to generate a script with the Graphical User Interface. Every action
performed via the GUI is written to the History View (p. 34). Use copy and paste to create your own
scripts with a text editor. Save the scripts as *.py file and use the Run Script... functionality in the
File Figure 1.3: Ansys Composite PrepPost Menu Options (p. 10) to run your script. In the case of error(s)
check the Shell View (p. 32) for more details.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 421
The ACP Python Scripting User Interface

The aforementioned approach may be limited when it comes to retrieving solution results or specific
model information. The section Advanced Scripting (p. 422) lists several examples of to how to access
such information via a script.

Important:

You cannot define any variable, class, or function with the name "db" because it is reserved
for ACP core operations.

6.1.2. Advanced Scripting

These examples are provided as a guide to more involved commands in the shell view. They all refer
to the example model Kiteboard Tutorial.

Maximum Lay-Up Thickness

# get active model
model = db.active_model
# get total thickness of all elements
thicknesses = list(model.mesh_query(name='thickness',position='centroid',selection='all'))
# get element labels
labels = model.mesh_query(name='labels',position='centroid',selection='all')
# get maximum thickness
max_thickness = max(thicknesses)
index_of_max = thicknesses.index(max_thickness)
# get element label with max thickness
element_label_with_max_thickness = labels[index_of_max]

Maximum Ply Thickness

# get active model
model = db.active_model
# create new selection of all elements attached to a specific ply
modeling_ply = model.modeling_groups['Core'].plies['mp_4']
model.select_elements(selection='sel0',op='new',attached_to=[modeling_ply])
# get total thickness of the first entity of selection sel0
thicknesses = list(model.mesh_query(name='thickness',position='centroid',selection='sel0', entities=[modeling_p
# get element labels
labels = model.mesh_query(name='labels',position='centroid',selection='sel0')
# get maximum thickness
max_thickness = max(thicknesses)
index_of_max = thicknesses.index(max_thickness)
# get element label with max thickness
element_label_with_max_thickness = labels[index_of_max]

Maximum Inverse Reserve Factor and Failure Mode

# get active model
model = db.active_model
model.update()
# get first solution
solution = model.solutions.values()[0]
# get the failure criterion definition
fc_definition = model.definitions["FailureCriteria.MaxStrain_Core"]
# get element labels
labels = model.mesh_query(name='labels',position='centroid',selection='all')
# get inverse reserve factors of all elements
irfs = list(solution.query(definition=fc_definition,position='centroid',selection='all',component='irf'))
# get failure modes of all elements

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
422 of ANSYS, Inc. and its subsidiaries and affiliates.
 Extending the Python Environment in ACP Pre and Post

failure_modes = solution.query(definition=fc_definition,position='centroid',selection='all',component='fm')
# get the maximum IRF value
max_irf = max(irfs)
# get the index of maximum IRF
index_of_max = irfs.index(max_irf)
# get failure mode corresponding to maximum IRF
critical_failure_mode = failure_modes[index_of_max]
# get element label where the maximum IRF occurs
element_label_of_max = labels[index_of_max]

6.1.3. Scripting Examples

Some useful, general purpose scripting examples are included with the Ansys installation. For standard
installations, you will find them in Program Files\ANSYS Inc\V241\ACP\script_examples.
Each file or folder has a descriptive name which conveys the basic purpose of the script. You will find
a more detailed description at the beginning of each script. Some of the sample scripts are:

• Implementation of a user-defined failure criterion

• Plotting of material distribution (where is a material applied to the structure)

• Material-wise post-processing (compute the failure for a certain material)

Review the following topics for additional scripting examples:

• Look-Up Table with a Python Script (p. 107) in the Look-Up Tables section.

• Example Scripts (p. 236) in the User-Defined Plot section.

• Settings for an Expression Output (p. 254) in the Parameters section.

• Evaluating Custom Failure Criteria (p. 260) in the Postprocessing section.

6.2. Extending the Python Environment in ACP Pre and Post

Because ACP is delivered with a frozen Python, the Python environment cannot be modified with
standard modules such as pip. Nevertheless, it is possible to import and use Python modules within
ACP which are not delivered with the installation (matplotlib, for example). You can do this by creating
a virtual Python environment (VENV) and adding this environment to the ACP Python path.

6.2.1. How to Create a Virtual Environment

First, make sure you are you using the same version of Python that ACP is using. To call up the version
number, type sys.version in ACP’s Python shell.

There are several options for generating your own VENV.

• Using the installed Ansys Python, navigate to the delivered Ansys Python that is in the subfolder
of <WB root dir>\commonfiles\CPython and call the venv module.
python.exe -m venv C:\my_ansys_python_env

This command creates a new environment in the folder C:\my_ansys_python_env.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 423
The ACP Python Scripting User Interface

• After installing Python, call the venv module to create a new VENV, using standard Python:
python.exe -m venv C:\my_new_python_env

This command creates a new VENV in the folder C:\my_new_python_env.

• There are other Python distributions as well (Anaconda, for example) which allow you to create
virtual environments.

6.2.2. How to Install a Module in your Virtual Environment and Use it within
ACP
You must activate the virtual Python environment before additional modules can be installed. The
example below shows how to install matplotlib into your virtual Python environment using the Win-
dows Command Prompt:
C:\my_new_python_env\scripts\activate
pip install matplotlib

You are now ready to add the virtual Python environment to ACP’s Python. Use the VENV Python
packages in ACP’s Python by appending the directories of the VENV to the Python system path of
ACP. The Python path of the VENV is available through

import sys
sys.path

Copy this list of paths and add them in the ACP Python shell.
sys.path.extend([….])

Appending the VENV paths to the Python path of ACP is important because it ensures the lookup
goes through the ACP Python first before going into the VENV.

Note:

ACP uses Ansys’ Python which comes with the installation of Ansys Workbench. You can
find it in <installation dir>\commonfiles\CPython. It is possible that the Ansys
version was built with a different compiler than the one used for the official version of
Python or the version you are running. Its delivered modules and libraries may also differ.
This can cause runtime issues if your Python environment and its installed packages are
not compatible with Ansys Python, even if they were built with the same or compatible
compilers.

6.2.3. Alternatives to Extending ACP’s Python

With regard to dictionaries, DataFrames, or other data types, you can write to the disk using Python’s
native pickle module in order to use the data in another program or share it with others. To do so,
use the following commands:
import pickle
import numpy as np

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
424 of ANSYS, Inc. and its subsidiaries and affiliates.
 DB Database

example_array = np.zeros((1000,2))
with open('test.pkl','wb') as f:
pickle.dump(example_array, f)

You can then load the stored data in a different environment using pickle again and then process
the data:
import pickle
with open('test.pkl','rb') as f:
loaded_array = pickle.load(f)

Numpy offers similar functionality. See numpy.save, numpy.savez, and numpy.load for more
details.

6.3. The Python Object Tree

The ACP Python interface is organized as a static python object tree. This tree contains all loaded
models, solutions, definitions, Views and Scenes. Access to the actually loaded object tree is always
provided through the root object compolyx.DB in the embedded Python shell.

An image of the python object tree appears only in the online help. If you are reading the PDF version
of the help and want to see the figure, please access this section in the online help.

6.4. DB Database
class compolyx.DB(*args, **kwargs)

Class to represent ComPoLyX database

Access:
>>> import compolyx
>>> db = compolyx.DB()

active_model

Active model

clear()

Clear database

clear_generated_data(model=None)

Function clears the eventually stored update results and deletes the generated data such as Produc-
tion and Analysis Plies, Solid Models etc.

Parameters

-model: the ACP model to be cleared

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 425
The ACP Python Scripting User Interface

close(model=None)

Close model

Parameters

• model: model to close (optional) if no model is given all models were closed

import_model(name, path, format, ignored_entities=None, convert_section_data=None, unit_sys-

tem_type=None, reference_surface_input_unit_system_type=None)

Create a model from file

Parameters

• name: Custom name of the model

• path: Path to the data file

• format: File format string. Choose one of ‘abaqus:inp’,’ansys:cdb’, ‘ansys:dat’, ‘nastran:bdf’, ‘ansys:h5’

• ignored_entities: Entities to ignore. Can be a subset of the following list: [‘mesh’, ‘element_sets’,
‘materials’, ‘coordinate_systems’, ‘shell_sections’]

• convert_section_data: Whether to import and convert the shell section data into ACP composite
definitions. Default is false.

• unit_system_type : Set the unit system of the model to this type. Ignored if a unit system was
already defined in the data file.

• reference_surface_input_unit_system_type : Set the unit system of the reference surface if the

unit system cannot be read from the input

material_data

Material Data Base

models

Models

open(path, replace_workbench_inputs=None, pre_db=None, unit_system_type=None,

load_cached_data=False, apply_shared_commands=False)

Open ACP file and append the model to models container :Parameters: - path: Path to ACP file -
replace_mesh_kwargs Optional keyword arguments to replace the mesh to load in db.import_mod-
el(…) upfront - replace_workbench_inputs Optional dictionary with Workbench inputs to replace
before executing the .acp file

open_h5(path, cache_data=False, apply_shared_commands=False)

Load a model from an ACPH5 database.

Parameters

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
426 of ANSYS, Inc. and its subsidiaries and affiliates.
 DB Database

• path: acph5 file path

• cache_data: boolean whether to load the update results or not

• apply_shared_commands: boolean to specify whether to load the Python commands from the
ACP Shared section of the h5 file.

refresh_acph5(path, external_sources, input_parameters=None, initialize=False, unit_sys-

tem_type=None, upgrade_from=None)

Refresh an acph5 db (Workbench mode only)

Parameters

• path: file path to acph5 file

• external_sources: nested dict provided by ACP WB Add-in containing all the

external sources info (the file path, whether the source was modified, its ID etc.). The keys of
the dict are: [‘model’, ‘materials’, ‘cad_geometries’, ‘imported_solid_models’, ‘pre_db’, ‘solu-
tions’]. Values for ‘model’ and ‘materials’ are dicts with the following fields [‘path’, ‘external_id’,
‘modified’]. Values for ‘cad_geometries’, ‘imported_solid_models’ and ‘pre_db’ are list of dicts
with fields [‘name’, ‘path’, ‘external_id’, ‘modified’]. Values for ‘solutions’ are dicts with fields
[‘name’, ‘path’, ‘external_id’, ‘modified’, ‘renumbering_mapping_paths’] where renumber-
ing_mapping_paths is a list of file paths.

• input_parameters: a dict of (name, value) pairs of WB input parameters.

• initialize: specifies whether the acph5 database needs to be initialized (i.e. the file does not

yet exist).

• unit_system_type: Defines the unit system of the main / downstream ACP file. (TODO: Do we
need this?)

• upgrade_from: Defines the path of a legacy (.acp) ACP DB that has to be upgrade to the new
format (load composite definitions and save as ACPH5).

reload(model)

Reloads the reference surface (mesh) of the model. See reload_mesh in the model for more details

Parameters

-model: the model to be reloaded

save(path=None, model=None, cache_data=None)

Save active model

Parameters

• path: file path

• model: active model

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 427
The ACP Python Scripting User Interface

• cache_data: whether to store the update results or not.

set_unit_system(unit_system_type)

Set the unit system of all models opened in the database

6.5. Material Classes

This section contains the following topics:
6.5.1. MaterialData
6.5.2. Material
6.5.3. Fabric
6.5.4. Stackup
6.5.5. SubLaminate

6.5.1. MaterialData
class compolyx.MaterialData(graph, parent=None)

MaterialData manages all composite material data.

copy(source, on_duplicate_name='keep_both')

copy a list of material data source, keeps track of all dependencies

Parameters

• source : a list of source of copy

• on_duplicate_name

action to take if source.name is already contained in self.fabrics

keep_both : create a new instance with the same name (different id) overwrite : replace
first instance with equal name in self with source keep_existing : ignore copy action, returns
first existing instance in self with equal name

copy_fabric(source, on_duplicate_name='keep_both', memo=None)

Copy a fabric

Parameters

• source: Source object to copy

• on_duplicate_name

action to take if source.name is already contained in self.fabrics

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
428 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

keep_both : create a new instance with the same name (different id) overwrite : replace
first instance with equal name in self with source keep_existing : ignore copy action, returns
first existing instance in self with equal name

• memo : a dict to collect copied items (for internal dependency tracking when copying stackups
or sub-laminates)

Returns

New Instance of Fabric

copy_material(source, on_duplicate_name='keep_both', memo=None)

Copy a material

Parameters

• source: Source object to copy

• on_duplicate_name

action to take if source.name is already contained in self.materials

keep_both : create a new instance with the same name (different id) overwrite : replace
first instance with equal name in self with source keep_existing : ignore copy action, returns
first existing instance in self with equal name

• memo : a dict to collect copied items (for internal dependency tracking when copying stackups
or sub-laminates)

Returns

New instance of material

copy_stackup(source, on_duplicate_name='keep_both', memo=None)

Copy a stackup

Parameters

• source: Source object to copy

• on_duplicate_name

action to take if source.name is already contained in self.stackups

keep_both : create a new instance with the same name (different id) overwrite : replace
first instance with equal name in self with source keep_existing : ignore copy action, returns
first existing instance in self with equal name

• memo : a dict to collect copied items

Returns

New Instance of Fabric

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 429
The ACP Python Scripting User Interface

copy_sub_laminate(source, on_duplicate_name='keep_both', memo=None)

Copy a sub lamiante

Parameters

• source: Source object to copy

• on_duplicate_name

action to take if source.name is already contained in self.sub_laminates

keep_both : create a new instance with the same name (different id) overwrite : replace
first instance with equal name in self with source keep_existing : ignore copy action, returns
first existing instance in self with equal name

• memo : a dict to collect copied items

Returns

New Instance of sub laminate

create_fabric(name, id=None, material=None, thickness=0.0, area_price=0.0, ignore_for_post-

processing=False, drop_off_material_handling='Global', cut_off_material_handling='Computed',
drop_off_material=None, cut_off_material=None, draping_material_model='woven', draping_ud_coef-
ficient=0.0)

Create a new fabric

Parameters

• name: Name for the Fabric

• material: Material of the Fabric

• thickness: Thickness of the Fabric

• area_price: Area Price of the Fabric

• ignore_for_postprocessing: Flag if this material is post-processed

• drop_off_material_handling: Type defining how drop-off material is used in drop-off areas of

the fabric

• cut_off_material_handling: Type defining how cut-off material is used in cut-off areas of the
fabric

• drop_off_material: Material to use for ‘Custom’ drop-off material handling

• cut_off_material: Material to use for ‘Custom’ cut-off material handling

• draping_material_model: Material model for draping, either ‘woven’ or ‘unidirectional’

• draping_ud_coefficient: Coefficient for the unidirectional draping material model

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
430 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

Returns

The created Fabric

Examples
>>> material_data = db.models['beam'].material_data
>>> fabric_1 = material_data.create_fabric(name='Fabric.1', material=material_data.materials['Material.1'], t

create_material(name, id=None, ply_type='undefined', E1=0.0, E2=0.0, E3=0.0, G12=0.0, G31=0.0,

G23=0.0, nu12=0.0, nu13=0.0, nu23=0.0, rho=0.0, locked=False, ext_id='')

Create a constant Material

Parameters

• name: Name of the new Material

• ply_type: Type of the ply for the material. Allowed string values: regular, woven, orthotropic_ho-
mogeneous_core, isotropic_homogeneous_core, honeycomb_core, isotropic, adhesive, undefined.

• E1 - rho: Material parameters

Returns

New Instance of Material

create_stackup(name, id=None, fabrics=None, area_price=0.0, symmetry='No Symmetry', lay-

up_sequence='Top-Down', drop_off_material_handling='Global', cut_off_material_handling='Com-
puted', drop_off_material=None, cut_off_material=None, draping_material_model='woven', drap-
ing_ud_coefficient=0.0)

Create a new Stackup

Parameters

• name: Name for the Stackup

• fabrics: Fabrics of the Stackup

• area_price: Area Price of the Stackup

• symmetry: Symmetry the Stackup can be ‘No Symmetry’, ‘Even Symmetry’ or ‘Odd Symmetry’

• layup_sequence: Layup sequence of the Stackup can be ‘Top-Down’ or ‘Bottom-Up’

• drop_off_material_handling: Type defining how drop-off material is used in drop-off areas of

the stackup

• cut_off_material_handling: Type defining how cut-off material is used in cut-off areas of the
stackup

• drop_off_material: Material to use for ‘Custom’ drop-off material handling

• cut_off_material: Material to use for ‘Custom’ cut-off material handling

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 431
The ACP Python Scripting User Interface

• draping_material_model: Material model for draping, either ‘woven’ or ‘unidirectional’

• draping_ud_coefficient: Coefficient for the unidirectional draping material model

Returns

The created Stackup

Examples
>>> material_data = db.models['beam'].material_data
>>> stackup_1 = material_data.create_stackup(name='Stackup.1', fabrics=(material_data.fabrics['Fabric.1'],),

create_sub_laminate(name, id=None, fabrics=None, symmetry='No Symmetry', layup_se-

quence='Top-Down')

Create a new SubLaminate

Parameters

• name: Name for the Sub Laminate

• fabrics: Fabrics of the Sub Laminate

• symmetry: Symmetry the Sub Laminate can be ‘No Symmetry’, ‘Even Symmetry’ or ‘Odd Sym-
metry’

• layup_sequence: Layup sequence of the Sub Laminate can be ‘Top-Down’ or ‘Bottom-Up’

Returns

The created SubLaminate

Examples
>>> material_data = db.models['beam'].material_data
>>> sublaminate_1 = material_data.create_sub_laminate(name='SubLaminate.1', fabrics=(material_data.fabrics['F

enabled

Whether MaterialData is currently enabled or not.

export_matml(path, unit_system=None)

Export materials to ANSYS Engineering Data MatML format.

Parameters

• path: Path to file to write.

• unit_system

Convert all quantities into this unit system. The units

will be stored in the file written. The default is the unit system of the model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
432 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

fabrics

Dictionary with all fabrics defined.

find_materials(**properties)

Find materials with the given properties or property ranges

Parameters

• properties: Arbitrary material properties which must be matched.

Note that a single property value can be given as string, number or min-max range

Returns

A list with materials which match the given properties. If nothing matches an empty list is returned.

Examples
>>> material_data = db.models['model.1'].material_data
>>> materials = material_data.find_materials(E1=100000.0, nu12=0.3)
>>> materials = material_data.find_materials( name='1')
>>> materials = material_data.find_materials(E1=[200000.0, 220000.0], nu12=0.3, G12=[4500.0,5500.0])

import_matml(path, material_apdl_path='')

Import material data from MatML file as provided by Workbench Engineering Data.

Parameters

• path: File to read from.

• material_apdl_path

Specify the APDL file containing the

ANSYS Engineering Data material definitions.

material_apdl_path

Optional path to file with APDL material definitions to be used in the CDB export.

materials

Dictionary with all materials defined.

matml_path

Path to MatML file as provided by Workbench EngineeringData

name

Currently a name is needed for every object in the db tree.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 433
The ACP Python Scripting User Interface

serialize()

Serialize to Python string

stackups

Dictionary with all stack ups defined.

sub_laminates

Dictionary with all sub laminates defined.

unit_system

Unit system of material data, propagated from model

6.5.2. Material
This section contains the following topics:
6.5.2.1. PropertySet

class compolyx.Material(graph, obj, parent=None)

ComPoLyX material class.

This class allows to retrieve all material properties defined within the loaded Finite Element model.

Access
>>> import compolyx
>>> db = compolyx.DB()
>>> model = db.models['class40.1']
>>> materials = model.material_data.materials
>>> mat_UD300 = materials['UD300_GLAS']
>>> print mat_UD300.property_names

[‘density’, ‘engineering_constants’, ‘larc_constants’, ‘puck_constants’, ‘strain_limits’, ‘stress_limits’,

‘thermal_expansion_coefficients’, ‘tsai_wu_constants’, ‘woven_characterization’, ‘woven_puck_con-
stants_1’, ‘woven_puck_constants_2’, ‘woven_stress_limits_1’, ‘woven_stress_limits_2’]
>>> property_set_eng_const = mat_UD300['engineering_constants']

active_properties

List of the active properties for the underlying material.

create_property_set(property_name, **kwargs)

Function to create a specific property set.

Parameters

• property_name: A string defining the PropertySet to be created.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
434 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

Key word arguments can be passed to define the constant properties of the newly created Prop-
ertySet. If the property already exists, it will be overwritten with the new data.

Example
>>> m = db.active_model
>>> mat = m.material_data.materials['Corecell_A450']
>>> mat.create_property_set('density', rho=2150.0)

delete_property_set(property_name)

Function to delete a specific property set.

Parameter

• property_name: String defining the PropertySet to be deleted.

ext_id

Id of corresponding Material in external source.

is_constant

True if engineering constants are constant.

is_isotropic

True if ply_type is isotropic or isotropic_homogeneous_core.

link_path

Root path of the current node in the tree for links to this object

locked

Material is generated from an external source and cannot be changed.

ply_type

Ply type. Allowed string values: regular, woven, orthotropic_homogeneous_core, isotropic_homo-

geneous_core, honeycomb_core, isotropic, adhesive, undefined

property_names

List with all available property keys.

serialize()

Serialize to Python string

6.5.2.1. PropertySet
class compolyx.PropertySet(gil_wrapper, parent_=None, name_='')

Python PropertySet class.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 435
The ACP Python Scripting User Interface

This class wraps GIL-functionality and adds Python-UI utilities to all material PropertySets (Engineering
Constants, Stress Limits, …).

Examples
>>> model = db.active_model
>>> Eglas = model.material_data.materials['E-Glas']
>>> Eglas_strain_limits = Eglas['strain_limits']
>>> print Eglas_strain_limits.property_names

[‘eXt’, ‘eXc’, ‘eYt’, ‘eYc’, ‘eZt’, ‘eZc’, ‘eSxy’, ‘eSxz’, ‘eSyz’, ‘effective_strain’]
>>> Eglas.update()
>>> Eglas_Xt = Eglas_strain_limits.query('eXt', {'UserVar1' : 0.3, 'Temperature' : 65.7})

get(variables=None)

Get raw PropertySet data. For puck_constants and woven_characterization the Puck Material
Classification can be retrieved.

Parameters

• variables: Optional string of variable to be retrieved (property or envrionment variable). If

this string is set to mat_type the Puck Material Classification is returned if available.

Returns

• If no variable was specified, all PropertySet raw data will be returned in dictionary-form. If a
variable was specified, then only this data will be returned.

Examples
>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> gil_data = mat['engineering_constants'].get()

>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> mat_type = mat['puck_constants'].get('mat_type')

>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> E1_data = mat['engineering_constants'].get('E1')

independent_names

List of the independent variable names.

is_constant

True if the Engineering Constants of this material are constant.

property_names

Propety name list.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
436 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

query(variables=None, environment_point=None)

Query PropertySet data.

The available property names on this PropertySet can be retrieved through property_names.

An empty query returns all properties at the default environment point in dictionary-form. If
the PropertySet is not up-to-date, zeros are returned and a warning is thrown.

Parameters

• variables: String or list of strings that defines which properties to query for. If a list of properties
is provided, the returned list of results retains the order of properties.

• environment_point: Dictionary defining at which environment state the queried properties

are requested. The dictionary takes the form {Var1 : value_1, …}. For unspecified environment
variables, their default value is assumed. Unkown environment variables will be ignored.

Examples
>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> data = mat['engineering_constants'].query()

>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> data = mat['engineering_constants'].query(['E1', 'E3'], {'Temperature' : 25.73, 'Shear Angle' : 1.8})

set(props=None, **kwargs)

Set constant and variable material data.

Constant properties can be given as keyword arguments.

Parameters

• props: A dictionary or tuple of two dictionaries defining the data

Examples
>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> data_dict = {'Xc' : 5.1, 'Sxy':0.3}
>>> mat['stress_limits'].set(data_dict)

>>> mat['stress_limits'].set(Xc=5.1,Sxy=0.3)

>>> m = db._active_model()
>>> mat = m.material_data.materials['Corecell_A450']
>>> data_dict = ({'rho' : [1000.0, 1020.5, 1025.0]}, {'Temperature' : ([22., 50., 150.], 25.)})
>>> mat['density'].set(data_dict)

6.5.3. Fabric
class compolyx.Fabric(graph, obj, parent=None)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 437
The ACP Python Scripting User Interface

Class to represent fabric

area_price

Area price of fabric

area_weight

Area weight of fabric

capture_analysis_plot(path=None, size=800, 600)

Saves the 2D polar plot to a file.

Note that this function only works when executed from a GUI, or in batch mode with a hidden
GUI. It does not work in full batch mode.

Parameters

• path: Path of the produced image file.

• size: Pixel size of the plot.

clt_query(query='laminate_properties')

Returns the properties of the classical laminate theory:

Parameters

• query: result type

Options

• laminate_properties: Young’s, flexural and shear moduli of the laminate

• polar_properties: E1, E2 and G12 depending on the laminate orientation

Example
>>> fab.clt_query(query='polar_properties')

create_plot(query={'polar_properties': ['E1', 'G12']})

Generates 2D-plots with the results of interest

Parameters

• query: query arguments

Options

• layup:[‘pp’] Production plies

• polar_properties:[‘E1’,’E2’,’G12’] polar plot of laminate stiffess

• text_plot:[‘materials’, ‘angles’, ‘thicknesses’]

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
438 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

Examples
>>> query={'polar_properties':['E1', 'G12'], layup:['pp'], text_plot:['materials', 'angles', 'thicknesses']}

cut_off_material

Cut-off material used in cut-off areas of this fabric.

cut_off_material_handling

Type defining how cut-off material is used in cut-off areas of this fabric. Types: [‘Computed’,
‘Global’, ‘Custom’]

draping_material_model

Draping material model.

draping_ud_coefficient

UD draping coefficient

drop_off_material

Drop-off material used in drop-off areas of this fabric.

drop_off_material_handling

Type defining how drop-off material is used in drop-off areas of this fabric. Types: [‘Global’, ‘Cus-
tom’]

graph_plot

Graph Plot object used to configure 2D plots.

ignore_for_postprocessing

Flag if this material is NOT post-processed.

is_constant()

Returns True if all engineering constants and strength limits of the assigned material are constant.

material

Material of the fabric

serialize()

Serialize to Python string

thickness

Thickness of fabric

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 439
The ACP Python Scripting User Interface

update_plot()

Updates the 2D plot

Note: The coupling effect is always neglected (which is anyway 0 for a single fabric)

6.5.4. Stackup
class compolyx.Stackup(graph, obj, parent=None)

Class to represent stack-up

add_fabric(fabric, angle=0.0)

Add fabric at end of fabrics of the Stackup

area_price

Price per area of the Stackup

area_weight

Area weight of the Stackup

capture_analysis_plot(path=None, size=800, 600)

Saves the 2D polar plot to a file.

Note that this function only works when executed from a GUI, or in batch mode with a hidden
GUI. It does not work in full batch mode.

Parameters

• path: Path of the produced image file.

• size: Pixel size of the plot.

clear_fabrics()

Clear all fabrics

clt_query(query='laminate_properties')

Returns the properties of the classical laminate theory

Parameters

• query: query parameters

Options

• layup: Return the layup

• laminate_properties: Young’s, flexural and shear moduli of the laminate

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
440 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

• polar_properties: E1, E2 and G12 depending on the laminate orientation

• stiffness_matrix: Returns the laminate stiffness matrix (ABD)

• compliance_matrix: Returns the lamiante compliance matrix (inverse of ABD)

Example
>>> stackup.clt_query(query='laminate_properties')

create_plot(query={'layup': ['pp', 'ap'], 'polar_properties': ['E1', 'G12']}, core_scale_factor=None)

Generates 2D-plots with the results of interest

Parameters

• query: Query parameters

• core_scale_factor: Scale core thickness by this value.

Options

• layup:[‘pp’, ‘ap’] Production Ply and Analysis Plies

• polar_properties:[‘E1’,’E2’,’G12’] polar plot of laminate stiffesses

• text_plot:[‘materials’,’angles’,’thicknesses’] property to show as label in the layup plot

Examples
>>> query={'polar_properties':['E1', 'G12'], layup:['pp'], text_plot:['materials']}

cut_off_material

Cut-off material used in cut-off areas of this Stackup.

cut_off_material_handling

Type defining how cut-off material is used in cut-off areas of this stackup. Types: [‘Computed’,
‘Global’, ‘Custom’]

draping_material_model

Draping material model.

draping_ud_coefficient

UD Draping Coefficient

drop_off_material

Drop-off material used in drop-off areas of this Stackup.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 441
The ACP Python Scripting User Interface

drop_off_material_handling

Type defining how drop-off material is used in drop-off areas of this stackup. Types: [‘Global’,
‘Custom’]

fabrics

Fabrics property of the Stackup

get_ordered_fabrics()

Returns all fabrics and orientations including symmetry and layup sequence option.

graph_plot

Graph Plot object used to configure 2D plots.

insert_fabric(pos, fabric, angle)

Insert fabric at given position

is_constant()

Returns True if all engineering constants and strength limits of the assigned fabrics are constant.

layup_sequence

Layup Sequence of the Stackup can be ‘Top-Down’ or ‘Bottom-Up’

remove_fabric(pos)

Remove fabric from position

Parameters

• pos: Position of the Fabric to remove

serialize()

Serialize to Python string

symmetry

Symmetry of the Stackup can be ‘No Symmetry’, ‘Even Symmetry’ or ‘Odd Symmetry’

thickness

Thickness of the Stackup

update_plot()

updates the data of the 2D plot

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
442 of ANSYS, Inc. and its subsidiaries and affiliates.
 Material Classes

6.5.5. SubLaminate
class compolyx.SubLaminate(graph, obj, parent=None)

Class to represent sub-laminate

add_fabric(fabric, angle=0.0)

Add fabric at end of fabrics list

area_price

Price per area of the Sub Laminate

area_weight

Area weight of the Sub Laminate

capture_analysis_plot(path=None, size=800, 600)

Saves the 2D polar plot to a file.

Note that this function only works when executed from a GUI, or in batch mode with a hidden
GUI. It does not work in full batch mode.

Parameters

• path: Path of the produced image file.

• size: Pixel size of the plot.

clear_fabrics()

Clear all fabrics

clt_query(query='laminate_properties')

Returns the properties of the classical laminate theory

Parameters

• query: result type

Options

• layup: Return the layup of the laminate

• laminate_properties: Young’s, flexural and shear moduli of the laminate

• polar_properties: E1, E2 and G12 depending on the laminate orientation

• stiffness_matrix: Returns the laminate stiffness matrix (ABD)

• compliance_matrix: Returns the lamiante compliance matrix (inverse of ABD)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 443
The ACP Python Scripting User Interface

Example
>>> sub.clt_query(query='layup')

create_plot(query={'layup': ['mp', 'pp', 'ap'], 'polar_properties': ['E1', 'G12']}, core_scale_factor=None)

Generates 2D-plots with the results of interest

Parameters

• query: query parameters

• core_scale_factor: Scale core thickness by this value.

Options

• layup:[‘mp’, ‘pp’, ‘ap’] Modeling Ply, Production Plies and Analysis Plies

• polar_properties:[‘E1’,’E2’,’G12’] polar plot of laminate stiffesses

• text_plot:[‘materials’,’thicknesses’,’angles’] text plot shown in the layup plot

Example
>>> query={'polar_properties':['E1', 'G12'], layup:['pp'], text_plot:['materials']}

fabrics

Fabrics property of the Sub Laminate

get_ordered_fabrics()

Returns a list with all sub materials (fabrics and stackups) and orientations including symmetry
and layup sequence option.

get_ordered_sub_materials()

Returns a list with all fabrics and orientations including symmetry and layup sequence option.

graph_plot

Graph Plot object used to configure 2D plots.

insert_fabric(pos, fabric, angle)

Insert fabric at given position

is_constant()

Returns True if all engineering constants and strength limits of the assigned fabrics are constant.

layup_sequence

Layup Sequence of the Sub Laminate can be ‘Top-Down’ or ‘Bottom-Up’

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
444 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

remove_fabric(pos)

Remove fabric from position

serialize()

Serialize to Python string

symmetry

Symmetry of the Sub Laminate can be ‘No Symmetry’, ‘Even Symmetry’ or ‘Odd Symmetry’

thickness

Thickness of the Sub Laminate

update_plot()

Updates the data of the 2D plot

6.6. Model Classes

This section contains the following topics:
6.6.1. Model
6.6.2. Rosette
6.6.3. LookUpTable
6.6.4. ElementSelectionRule Classes
6.6.5. EntitySet Classes
6.6.6. Geometry Classes
6.6.7. OrientedSelectionSet
6.6.8. ModelingGroup
6.6.9. ImportedModelingGroup
6.6.10. FieldDefinition
6.6.11. SamplingPoint
6.6.12. SectionCut
6.6.13. Sensor
6.6.14. PlyBook
6.6.15. PublishedParameter
6.6.16. Script

6.6.1. Model
class compolyx.Model(name=None, path=None, format=None, ignored_entities=None,
graph=None, parent=None, convert_section_data=False, unit_system_type=None, reference_surface_in-
put_unit_system_type=None, cache_data=False)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 445
The ACP Python Scripting User Interface

Class to represent a finite element model

Access:
>>> import compolyx
>>> db = compolyx.DB()
>>> model = db.import_model(name='class40.1', path='class40.cdb', format='ansys:cdb')

Get existing model:

>>> class40_model = db.models['class40.1']

active_scene

Active Scene

add_solution(name, id='', path=None, path2=None, format='ansys:rst', subcase=False, 0, set=- 1,

load_factor=False, 0.0, read_stresses_strains=True, use_felyx_to_compute_pp_results=True,
use_solid_results=True, recompute_iss_of_solids=False, renumbering_mapping_paths=[], ext_id='',
active=True)

Load a nodal solution from file(s) and add it to the model

Parameters

• name: Custom name of the solution

• path: Path to the data file

• path2: Optional path to second result file. Useful for ANSYS PRNSOL solution, where nodal de-
formations and nodal rotations can be exported to different files only.

• format: File format string. Choose one of ‘abaqus:fieldreport’, ‘ansys:prnsol’,’ansys:rst’ or ‘nas-

tran:f06’

• subcase: Optional subcase to read. Only valid for ‘nastran:f06’ format. (False,0) if not given in
the F06 file.

• load_factor: Optional load factor within substep of non-linear solution where the nodal solution
should be taken from. Only valid for ‘nastran:f06’ format. (False,0) if not given in the F06 file.

• set: Result set for ANSYS RST files, None is last result set

• read_stresses_strains: Reads strain and stress results from the RST file (necessary to post-process
non-linear solutions)

• ‘use_felyx_to_compute_pp_results’: Use ACP to compute strain and stress data

• use_solid_results: Mapps solid element solution onto ‘Layered Solid Reference Surface’

• recompute_iss_of_solids: For solids the interlaminar shear stresses are recalculated considering
the laminate stacking

• renumbering_mapping_paths: List of paths of the assembly renumbering files used to map the
results of composite assemblies

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
446 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• active: Active/inactive flag

Returns

The new Solution instance just added to the model

add_winding_entities(axial_direction, origin, reference_radius, layers, max_angle_with_thick-

ness_correction=90.0, number_of_digits_angle=3)

Generates a winding layup for an axisymmetric body.

The function uses the origin (a point on the axis of symmtery), the axial_direction and the reference
radius to automatically generate a winding layup for an axisymmetric body. The radius is defined
as the minimal distance from any point on the surface to the axis of symmetry. The reference ra-
dius is equal to the radius, where the layers have the nominal thickness and angle. For a typical
winding body this is the radius in the cylindrical region.

The thickness correction of each layer is calculated with thickness_correction = reference_radius

/ radius

The angle is calculated based on a geodesic path for which radius*sin(angle) is constant: angle
= arcsin( const / radius) if const / radius in [-1,1] angle = sign(angle) * 90° otherwise

with const = reference_radius * sin(nominal_angle)

Each layer is a dict with the following properties:

• fabric: Fabric of the layer (Stackups and Sublaminates are not supported)

• angle: Nominal angle at Reference Radius with respect to the axis of symmetry (in degree)

• selection_rule_limits: A dictionary with the entries “upper” and “lower” that define the extent
of the plies in axial direction. The “upper” and “lower” values are interpreted as distance
from the origin along the axial_direction.

• add_mirrored_ply: If True, an addtional layer with the same properties but a negative angle
is generated. This implies that the resulting thickness is twice the original thickness of the
layer

Note: The reference directions computed by this function are not defined along the

axis of symmetry, but along the circumferential direction using a cylindrical Rosette. This allows
to handle edge cases such as elements normal to the symmetry plane with a single Rosette.
As a result the “Ply Angle” of the generated plies is rotated by 90° with respect to the specified
nominal angle in the layers list. The resulting fiber direction still matches the specified nom-
inal angle: a nominal angle of 0° means that the fiber direction is along the Axial Direction.

The functions generates the following objects:

• A cylindrical Rosette which defines a reference direction along the circumferential direction
of the axisymmetric body

• An Oriented Selection Set

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 447
The ACP Python Scripting User Interface

• A Lookup Table with the thickness corrections and angles

• A template Selection Rule if limits are defined

• A Modeling Group with the Plies

Parameters

• axial_direction: Direction vector for the axis of symmetry

• origin: Point on the axis of symmetry

• reference radius: Reference radius at which the plies are assumed to have the

nominal angle and the nominal thickness

• layers: List of dicts with the following entries:

– fabric: Fabric of the layer (Stackups and Sublaminates are not supported)

– angle: Nominal angle at Reference Radius with respect to the axis of symmetry (in degree)

– selection_rule_limits: A dictionary with the entries “upper” and “lower” that define the
extent of the plies in axial direction. The “upper” and “lower” values are interpreted as
distance from the origin along the axial_direction.

– add_mirrored_ply: If True an addtional layer with the same properties but a negative
angle is generated. This implies that the resulting thickness is twice the original thickness
of the layer

• number_of_digits_angle, optional, default: 3: Lookup tables for the angles are

shared between different layers with similar angles. Angles which are equal until num-
ber_of_digits_angle after the decimal point share the same lookup table.

• max_angle_with_thickness_correction: The thickness for layers where abs(angle) >

max_angle_with_thickness_correction is not corrected. These layers always have the nom-

inal layer thickness.

Usage
>>> model.add_winding_entities(
axial_direction=(1.0, 0.0, 0.0),
origin=(0.0, 0.0, 0.0),
reference_radius=0.1,
layers=[{
"fabric": db.models['ACP Model'].material_data.fabrics['Fabric.1'],
"angle": 30.0,
"selection_rule_limits": {
"upper": 1,
"lower": 0.0
},
"add_mirrored_ply": True
}]
)

Returns

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
448 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

Dict of generated objects

analysis_model_path

Analysis model file path

angle_tolerance

Section computation angle tolerance (in degree)

average_element_size()

Average element size of the model

cache_update_results

Define whether to store the update results or not.

copy_combined_failure_criteria(source)

Copy a Combined Failure Criteria Definition

Parameters

• source: Source object to copy

Returns

New instance of Combined Failure Criteria Definition

copy_edge_set(source)

Copy a edge set :Parameters: - source: Source object to copy

Returns

New instance of edge set

copy_element_set(source)

Copy a element set

Parameters

• source: Source object to copy

Returns

New instance of element set

copy_field_definition(source)

Copy a FieldDefinition

Parameters

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 449
The ACP Python Scripting User Interface

• source: Source object to copy

Returns

New instance of FieldDefinition

copy_lookup_table(source)

Copy a Look-up Table

Parameters

• source: Source object to copy

Returns

New instance of a Look-Up Table

copy_oriented_selection_set(source)

Copy an oriented element set

Parameters

• source: Source object to copy

Returns

New instance of oriented element set

copy_rosette(source)

Copy a Rosette

Parameters

• source: Source object to copy

Returns

New instance of Rosette

copy_sampling_point(source)

Copy a sampling point

Parameters

• source: Source object to copy

Returns

New instance of a sampling point

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
450 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

copy_section_cut(source)

Copy a section cut

Parameters

• source: Source object to copy

Returns

New instance of a section cut

copy_selection_rule(source)

Copy a rule

Parameters

• source: Source object to copy

Returns

New instance of rule

copy_sensor(source)

Copy a sensor

Parameters

• source: Source object to copy

Returns

New instance of a sensor

copy_solid_model(source)

Copy a solid model

Parameters

• source: Source object to copy

Returns

New instance of a solid model

create_boolean_selection_rule(name, id=None, include_rule_type=True, selection_rules=[])

Create new Boolean Selection Rule

Parameters

• name: Name of the Rule

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 451
The ACP Python Scripting User Interface

• id: ID of the Rule

• include_rule_type: Whether the rule is of type include or exlude

• selection_rules: list of tuples of attached rules and operation type

Returns

The created Boolean Selection Rule

create_combined_failure_criteria(name, set=[], id=None)

Create Combined Failure Criteria

Parameters

• name: Name for the Combined Failure Criteria

• set: set of Failure Criteria to be assigned

• id: id to be assigned (optional)

Returns

• created Combined Failure Criteria

create_cutoff_selection_rule(name, id=None, cutoff_rule_type='geometry', offset=0.0,

angle=0.0, origin=0.0, 0.0, 0.0, direction=1.0, 0.0, 0.0, distance_type='along_direction',
ply_cutoff_type='production_ply_cutoff', ply_tapering=False, cutoff_geometry=None, edge_set=None,
offset_method='laminate_stack', offset_type='out_of_plane')

Create new Cut-Off Rule

Parameters

• name: Name of the rule

• cutoff_rule_type: geometry, taper, or variable_taper

• offset: Offset of the rule (float for cutoff_rule_type=`geometry` or taper, LookUpTableColumn

for cutoff_rule_type=`variable_taper`)

• angle : Angle of the rule (ignored for cutoff_rule_type=`geometry`, float for taper, LookUpTable-
Column for variable_taper)

• origin : Origin of the offset and angle interpolation for variable_taper

• direction : Direction of the offset and angle interpolation for variable_taper

• distance_type : along_direction or along_edge (only relevant for variable_taper)

• ply_cutoff_type: Determines on which ply level the cutoff is done.

• ply_tapering: Use ply tapering

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
452 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• cutoff_geometry: CADGeometry for the rule (only relevant for cutoff_rule_type=`geometry`)

• edge_set: Edge Set for cutoff_rule_type=`taper` or variable_taper

• offset_method : Method to compute offset of plies laminate_stack or attached_plies

• offset_type : Measure offset from edge set normal to element reference surface (out_of_plane)
or in element reference surface (in_plane)

Returns

The created rule

create_cylindrical_selection_rule(name, id=None, origin=None, direction=None, radi-

us=None, relative_rule_type=False, include_rule_type=True, rosette=None, use_global_coordin-
ate_system=None)

Create new Cylindrical Selection Rule

Parameters

• name: Name of the rule

• origin: Origin of the Cylindircal Rule

• direction: Direction of the Cylindircal Rule

• radius: Radius of the Cylindircal Rule

• relative_rule_type: If True parameters are evaluated relative to size of the object

• include_rule_type: Include or Exclude area in rule

• use_global_coordinate_system: Use global coordinate system to define rule parameters

• rosette: Rosette used if use_global_coordinate_system is False

Returns

The created Cylindircal Rule

create_edge_set(name, id=None, origin=0.0, 0.0, 0.0, limit_angle=- 1.0, edge_set_type='By Ref-

erence', element_set=None, node_labels=[], show=False)

Create new Edge Set

Parameters

• name: Name of the Edge Set

• edge_set_type: ‘By Nodes’, ‘By Reference’, ‘Imported’ (only for imported Edge Sets)

• origin: Origin

• limit_angle:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 453
The ACP Python Scripting User Interface

• element_set: element set

• node_labels: list of nodes defining the edge set (only if edge_set_type=’By Nodes’)

Returns

The created Edge Set

create_element_set(name, id=None, element_labels=None, element_sets=None, x=None, y=None,

z=None, op='new', middle_offset=False, show=False)

Create new element set

Parameters

• name: Name of the Element Set

• element_labels: Indices of elements to be assigned to Element Set

• element_sets: Select elements of these sets

• x: X-range to select.

• y: Y-range to select.

• z: Z-range to select.

• op: Select operation. Can be all, new (default), add, remove, intersect, inverse or none

• middle_offset: Boolean to enforce that the laminate mid-plane is moved onto the reference
surface.

Returns

The created Element Set

If element set already exists, it is updated depending on the operation given in op.

create_envelope_solution(name, id=None, solution_sets=[])

Create Envelope Solution

Parameters

• name: Name for the Envelope Solution

• solution_sets: list of Solution Sets that are combined

Returns

The new envelope solution object

create_field_definition(name, id=None, field_variable_name=None, scope_entities=None,

scalar_field=None, full_mapping=False, active=True, locked=False)

Create a new Field Definition

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
454 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

Parameters

• name: The name of the oriented element set

• id: The id of the oriented element set.

• field_variable: String identifier of the field

• scope_entities: A list of scope entities defining the region of definition

• scalar_field: Tabular scalar column defining the field

• full_mapping: Bool. Whether offsets are to be included during the interpolation process

Returns

The created Field Definition

create_geometrical_selection_rule(name, geometrical_rule_type='geometry', id=None,

use_defaults=True, in_plane_capture_tolerance=0.0, neg_capture_tolerance=0.0, pos_capture_tol-
erance=0.0, include_rule_type=True, geometry=None, use_projection_normal=False, projection_nor-
mal=0.0, 0.0, 0.0, element_sets=None)

Create new Geometrical Selection Rule

Parameters

• name: Name of the Rule

• geometrical_rule_type: Define whether the rule extent is defined by a geometry of element

sets. The value can be ‘geometry’ or ‘element_sets’. Default is ‘geometry.

• use_defaults: Whether to use the offset value of the CAD geometry.

• in_plane_capture_tolerance: In-plane extend (extend) if CAD geometry is a surface.

• neg_capture_tolerance: Offset in the negative direction if CAD geometry is a surface.

• pos_capture_tolerance: Offset in the positive direction if CAD geometry is a surface.

• include_rule_type: Whether the selection is inside or outside the CAD geometry

• geometry: CAD geometry used to determine the selection (only relevant for geometric-
al_rule_type=`geometry`)

• use_projection_normal: Boolean wheter to use the projection normal or not.

• projection_normal: Normal direction used to map elements on outlines / curves

• element_sets: Preselection of elements in the form of an element set where the rule is applied
on (only relevant for geometrical_rule_type=`element_sets`)

Returns

The created rule

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 455
The ACP Python Scripting User Interface

create_imported_solid_model(name, id='', active=True, external_file_path=None, unit_sys-

tem='undefined', format='ansys:cdb', ext_id='', use_default_element_index=True, element_index=0,
use_default_node_index=True, node_index=0, use_default_section_index=True, section_index=0,
use_default_material_index=True, material_index=0, use_default_coordinate_system_index=True,
coordinate_system_index=0, use_solsh_elements=False, drop_hanging_nodes=True, use_solid_mod-
el_prefix=True, write_degenerated_elements=True, delete_bad_elements=True, warping_limit=0.4,
minimum_volume=0.0, global_cut_off_material=None, transfer_all_sets=True, transferred_ele-
ment_sets=[], transferred_edge_sets=[], locked=False, from_pre=False)

Create a new Solid Model

Parameters

• name: The name of the Solid Model

• id: The id of the Solid Model

• active : Active status of the solid model

• external_file_path: File path to the external source

• unit_system: Unit system of the imported mesh

• format: File format of the external source

• use_default_element_index : consecutive element numbering if set to true

• element_index : start index for first element (only relevant if use_default_element_index)

• use_default_node_index : consecutive node numbering if set to true

• node_index : start index for first node (only relevant if use_default_node_index)

• use_default_section_index : consecutive section numbering if set to true

• section_index : start index for first element (only relevant if use_default_section_index)

• use_default_material_index : consecutive material numbering if set to true

• material_index : start index for first element (only relevant if use_default_material_index)

• use_default_coordinate_system_index : consecutive coordinate system numbering if set to true

• coordinate_system_index : start index for first coordinate system (only relevant if use_default_co-
ordinate_system_index)

• use_solsh_elements : the solid model is created out of solsh elements

• drop_hanging_nodes: whether to skip mid-side nodes that are not shared by adjacent elements.
Only relevant when the object has applies cut-off geometries and a quadratic mesh.

• use_solid_model_prefix : the name of the solid model is used as a prefix for all components
written to the *cdb file

• write_degenerated_elements : If false, degenerated (homogeneous) elements are not exported

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
456 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• delete_bad_elements: Boolean whether to delete the erroneous elements or not

• warping_limit: Warping limit factor used to detect erroneous elements

• minimum_volume: Minimum volume of solid elements. Default is 0. Elements equal or smaller

than this limit are removed from the solid model.

• global_cut_off_material : Defines the global cut-off material

• transfer_all_sets: defines whether all edge and element sets should be transferred to the solid
model.

• transferred_element_sets: element sets to transfer to the solid model if transfer_all_sets is set

to false.

• transferred_edge_sets: edge sets to transfer to the solid model if transfer_all_sets is set to false.

Returns

The created Imported Solid Model

create_lookup_table1d(name, id='', tabular_data=None, origin=None, direction=None, dimen-

sions=[])

Create a new 1D Look-Up Table object

Parameters

• name : Name

• id : ID

Returns

The created Look-Up Table object

create_lookup_table3d(name, id='', tabular_data=None, algorithm_type='weighted_nearest_neigh-

bor', use_default_search_radius=True, search_radius=0.0, num_min_neighbors=1, dimensions=[])

Create a new 3D Look-Up Table object

Parameters

• name : Name

• id : ID

• tabular_data: data points and values of the look-up table

• algorithm_type: specify which algorithm type is used for the interpolation

• use_default_search_radius: force the program to use the default search radius. Used for the
algorithm weighted_nearest_neighbor”.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 457
The ACP Python Scripting User Interface

• search_radius: set a custom search radius. Used if use_default_search_radius is false. Used for
the algorithm weighted_nearest_neighbor.

• dimensions: list of the dimensions of the columns (e.g. length for coordinates)

Returns

The created Look-Up Table object

create_oriented_selection_set(name, id=None, orientation_point=0.0, 0.0, 0.0, orienta-

tion_direction=0.0, 0.0, 0.0, element_sets=None, geometries=None, rosettes=None, rosette_selec-
tion_method='minimum_angle', selection_rules=None, draping=False, draping_seed_point=0.0, 0.0,
0.0, auto_draping_direction=True, draping_direction=0.0, 0.0, 1.0, draping_mesh_size=0.0,
use_default_draping_mesh_size=True, draping_material_model='woven', draping_ud_coefficient=0.0,
reference_direction_field=None)

Create a new Oriented Selection Set

Parameters

• name: The name of the oriented element set

• id: The id of the oriented element set.

• orientation_point: Orientation Point for the Oriented Selection Set

• orientation_direction: Orientation Direction for the Oriented Selection Set

• element_sets: Element Sets

• geometries: Virtual geometries

• rosettes: Rosettes for the Oriented Selection Set

• rosette_selection_method: Method to calculate element orientation

(‘minimum_angle’, ‘maximum_angle’, ‘minimum_distance’, ‘minimum_angle_superposed’,

‘minimum_distance_superposed’, ‘maximum_angle_superposed’, ‘ansys_classic’, or ‘tabu-
lar_values’)

• reference_direction_field: Table column used to compute reference directions

• draping: Draping enabled

• draping_seed_point: Seed Point used to start draping

• draping_direction: Direction for draping

• auto_draping_direction: Generate direction for draping

• draping_mesh_size: Mesh size for draping.

• use_default_draping_mesh_size: Enable this property to use the default size for the draping
mesh. The default is the average element size of the shell mesh.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
458 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• draping_material_model: Material model for draping, either ‘woven’ or ‘unidirectional’

• draping_ud_coefficient: Coefficient for the unidirectional draping material model

Returns

The created Oriented Selection Set

create_parallel_selection_rule(name, id=None, origin=None, direction=None, pos_dis-

tance=None, neg_distance=None, relative_rule_type=False, use_global_coordinate_system=None,
rosette=None, include_rule_type=True)

Create new Parallel Selection Rule

Parameters

• name: Name of the Rule

• origin: Origin of the Parallel Selection Rule

• direction: Direction of the Parallel Selection Rule

• pos_distance: Positive Disance of the Parallel Selection Rule

• neg_distance: Negative Distance of the Parallel Selection Rule

• relative_rule_type: If True parameters are evaluated relative to size of the object

• use_global_coordinate_system: Use global coordinate system to define rule parameters

• rosette: Rosette used if use_global_coordinate_system is False

• include_rule_type: Include or Exclude area in rule

Returns

The created Parallel Selection Rule

create_published_parameter(name, source_object=None, source_property='', user_script='',

category='input', acp_type=None, description='', lower_limit=None, upper_limit=None, cyclic=False,
float_list=[], string_list=[], unbound_value=None)

Create a published parameter

Parameters

• name: Name of the parameter

• source_object: Name of the object the parameter is linked to

• source_property: Property of the linked object the parameter controls

• user_script: Script to be executed for determining the parameter value. Only used when cat-
egory==”expression_output”

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 459
The ACP Python Scripting User Interface

• category: Controls the behavior of the parameter. Can be one of input, unbound_input, output,
expression_output

• acp_type: Type of the parameter, as used within ACP

• description: String description of the parameter

• lower_limit: The lower limit for numeric values

• upper_limit: The upper limit for numeric values

• cyclic: Whether a float value is cyclic or not

• float_list: A list of possible values for a float

• string_list: A list of possible values. List of objects if the property type is object, else list of
strings

• unbound_value: The value of the parameter, if category==”unbound_input”. In this case, the

parameter is not linked to an existing object

Returns

The created PublishedParameter.

create_rosette(name, id=None, origin=0.0, 0.0, 0.0, dir1=1.0, 0.0, 0.0, dir2=0.0, 1.0, 0.0,
rosette_type='PARALLEL', edge_set=None, show=False)

Create a new rosette

Parameters

• name: The name of the Rosette

• id: ID (optional)

• origin: The origin of the Rosette

• dir1: Direction 1 of the Rosette

• dir2: Direction 2 of the Rosette

• rosette_type: Type of the Rosette ( ‘PARALLEL’, ‘RADIAL’, ‘CYLINDRICAL’, ‘SPHERICAL’, ‘EDGE_WISE’

)

• edge_set: Edge Set to be used in Rosette

• show : Whether the newly created rosette is shown in the scene / the 3D window or not

Returns

The created Rosette

Example

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
460 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

>>> rosette_1 = model.create_rosette('Rosette.1',

origin=(0.,0.,0.),
dir1=(1.,0.,0.),
dir2=(0.,1.,0.),
rosette_type='PARALLEL')

create_sampling_point(name, id=None, point=0.0, 0.0, 0.0, direction=0.0, 0.0, 0.0, locked=False,

use_default_reference_direction=True, rosette=None, offset_is_middle=True, consider_coupling_ef-
fect=True, solution_set=None)

Create new Sampling Point

Parameters

• name: Name of the Sampling Point

• point: Sampling point

• direction: Sampling direction

• use_default_reference_direction: whether to use the default reference direction for the evaluation

• rosette: Rosette used for the evaluation of the reference direction

• offset_is_middle: Specifies the offset of the reference plane used for the CLT analyses

• consider_coupling_effect: Specifies whether the laminate properties are evaluated considering

the coupling effect (B matrix) or not

• solution_set: Specifies the solution and the set of the element-wise post-processing. Note, this
must be given as a tuple.

Returns

The created Sampling Point

create_scene(name, id=None, title='', active_set=None, projection='perspective', scale_factor=1.0,

show_draped_fiber_directions=False, show_draped_transverse_directions=False, show_edges=False,
show_fiber_directions=False, show_global_coordinate_system=True, show_legend=True,
show_normals=False, show_orientations=False, show_ref_directions=False, show_selec-
ted_mesh=False, show_section_cut_plots=False, show_element_type=<ObjectSectionElement-
Types.automatic: 'automatic'>, show_surface=True, show_minmax=False, show_transverse_direc-
tions=False, continuous_pick_enabled=False, show_material_1_directions=False, show_mesh_silhou-
ette=False, show_silhouette=True)

Create a new scene

Parameter

• name: Name of the scene

• show_deformed_mesh: Whether to show the deformed mesh

• show_undeformed_mesh: Whether to show the undeformed mesh

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 461
The ACP Python Scripting User Interface

• scale_factor: Scale factor of the deformed mesh

Returns

New scene

create_script(name, source=None, active=True, uptodate=False, update_mode=<ScriptUpdate-

Mode.ON_TRIGGERS: 'on_triggers'>)

Creates a script object, which allows executing custom Python code

Parameters

• name: The name of the script

• source: The code to be executed, as a string

• active: If False, the script will not be executed

• uptodate: Whether the script currently needs to be executed

• update_mode: Defines which changes cause the script to become

out-of-date. Can be either ‘manual’ (run only when manually triggered), ‘on_triggers’ (run
when a parameter or the script itself changes) or ‘always’ (run with every update)

Returns

The created Script object

create_section_cut(name, id=None, origin=0.0, 0.0, 0.0, normal=0.0, 0.0, 1.0, in_plane_refer-

ence_direction1=1.0, 0.0, 0.0, scale_factor=1.0, core_scale_factor=1.0, intersection_type='nor-
mal_to_surface', section_cut_type='modeling_ply_wise', extrusion_type='wire_frame', use_default_tol-
erance=True, tolerance=0.0, use_default_lut_settings=True, search_radius=0.0, number_of_interpol-
ation_points=1, scope_entire_model=True, scope_element_sets=(), locked=False)

Creates a new section cut

Parameters

• name: The name of the section cut

• id: The ID of the section cut

• origin: Origin of the section cut plane

• normal: Normal of the section cut plane

• in_plane_reference_direction1: Local x-direction of the sectin cut

• scale_factor: Scale factor for the thicknesses

• core_scale_factor: Scale factor for core materials

• intersection_type: Intersection type for the wireframe section cut

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
462 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• section_cut_type: Ply resolution

• extrusion_type: Type of representation and extrusion

• use_default_tolerance: Whether to use the default tolerance or not. Default is 0.1% of the aver-
aged element size.

• tolerance: Tolerance used to generate the surface section cut

• use_default_lut_settings: Use default interpolation properties for the sweep based extrusion

• search_radius: Search radius of the interpolation algorithm

• number_of_interpolation_points: Number of points of the interpolation algorithm

• scope_entire_model: Whether to scope the section cut to the entire model, or only selected
element sets

• scope_element_sets: Element sets to which the section cut is scoped, if scope_entire_mod-

el=False.

create_sensor(name, id=None, sensor_type='SENSOR_BY_AREA', entities=None, locked=False)

Create new Sensor

Parameters

• name: Name of the Rule

• sensor_type: Type of Sensor values are: SENSOR_BY_AREA, SENSOR_BY_MATERIAL,

SENSOR_BY_PLIES

• entities: Entities of the Sensor

Returns

The created Sensor

create_solid_model(name, id='', active=True, element_sets=None, ex_type=None,

drop_off_type=None, offset_type=None, max_thickness=None, ply_group_pointers=None, ele-
ment_set=None, use_default_element_index=True, element_index=0, use_default_node_index=True,
node_index=0, use_default_section_index=True, section_index=0, use_default_material_index=True,
material_index=0, use_default_coordinate_system_index=True, coordinate_system_index=0, con-
nect_butt_joined_plies=True, write_degenerated_elements=True, use_solsh_elements=False,
use_solid_model_prefix=True, global_drop_off_material=None, global_cut_off_material=None,
transfer_all_sets=True, transferred_element_sets=[], transferred_edge_sets=[], delete_bad_ele-
ments=True, disable_dropoffs_on_top=False, disable_dropoffs_on_bottom=False, dis-
able_dropoff_sets_on_top='all', disable_dropoff_sets_on_bottom='all', warping_limit=0.4, minim-
um_volume=0.0, drop_hanging_nodes=True, locked=False)

Create a new Solid Model

Parameters

• name: The name of the Solid Model

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 463
The ACP Python Scripting User Interface

• id: The id of the Solid Model

• active : Active status fo the Solid Model

• element_sets: a list of Element Sets

• ex_type: monolithic (1 element through the thickness),

analysis_ply_wise (1 element per layer), modeling_ply_wise (1 element for each modeling

ply), production_ply_wise (1 element for each production ply) specify_thickness (1 element
per layer, layers thicker than max_thickness are split to several solids of at most
max_thickness) user_defined (groups plies by global ply numbers to groups material_wise
(groups subsequent plies with equal material)

• drop_off_type: inside ply (one element inside the ply boundary), outside ply (one element
outside the ply boundary)

• offset_type

shell normal (offset to the shell normal), surface normal (update normal direction by normal
of layered solids),

distortion controlled (surface normal with local corrections)

• max_thickness : maximum thickness for one solid, splits the layer into more solids, if a single
layer is thicker than this value (only for ex_type=`specify thickness`)

• ply_group_pointers : step used to make user-defined ply groups

• element_set : (deprecated, use element_sets instead) a single element set

• use_default_element_index : consecutive element numbering if set to true

• element_index : start index for first element (only relevant if use_default_element_index)

• use_default_node_index : consecutive node numbering if set to true

• node_index : start index for first node (only relevant if use_default_node_index)

• use_default_section_index : consecutive section numbering if set to true

• section_index : start index for first element (only relevant if use_default_section_index)

• use_default_material_index : consecutive material numbering if set to true

• material_index : start index for first element (only relevant if use_default_material_index)

• use_default_coordinate_system_index : consecutive coordinate system numbering if set to true

• coordinate_system_index : start index for first coordinate system (only relevant if use_default_co-
ordinate_system_index)

• connect_butt_joined_plies : connect adjacent plies without intermediate drop-offs

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
464 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• write_degenerated_elements : degenerated drop-off and cut-off elements are written to the

*cdb file

• use_solsh_elements : the solid model is created out of solsh elements

• use_solid_model_prefix : the name of the solid model is used as a prefix for all components
written to the *cdb file

• global_drop_off_material: defines the global drop-off material

• global_cut_off_material: defines the global cut-off material

• transfer_all_sets: defines whether all edge and element sets should be transferred to the solid
model.

• transferred_element_sets: element sets to transfer to the solid model if transfer_all_sets is set

to false.

• transferred_edge_sets: edge sets to transfer to the solid model if transfer_all_sets is set to false.

• delete_bad_elements: Boolean whether to delete the erroneous elements or not

• disable_dropoffs_on_top: Boolean whether to disalbe the drop-off elements on the top surface
of the laminate.

• disable_dropoffs_on_bottom: Boolean whether to disalbe the drop-off elements on the bottom

surface of the laminate.

• disable_dropoff_sets_on_top: List of element or oriented selection sets defining the region

where the drop-offs are disabled on the top skin of the laminate. Default is ‘all’

• disable_dropoff_sets_on_bottom: List of element or oriented selection sets defining the region

where the drop-offs are disabled on the bottom skin of the laminate. Default is ‘all’

• warping_limit: Warping limit factor used to detect erroneous elements

• minimum_volume: Minimum volume of solid elements. Default is 0. Elements equal or smaller

than this limit are removed from the solid model.

• drop_hanging_nodes: Hanging nodes are dropped (not exported) if set to true. Hanging nodes
are mid-side nodes that are not shared by adjacent elements.

Returns

The created Solid Model

create_spherical_selection_rule(name, id=None, origin=None, radius=None, relat-

ive_rule_type=False, include_rule_type=True, use_global_coordinate_system=None, rosette=None)

Create new Spherical Selection Rule

Parameters

• name: Name of the rule

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 465
The ACP Python Scripting User Interface

• origin: Origin of the Spherical Selection Rule

• radius: Radius of the Spherical Selection Rule

• relative_rule_type: Flag for relative rule

• include_rule_type: Include or Exclude area in rule

• use_global_coordinate_system: Use global coordinate system to define rule parameters

• rosette: Rosette used if use_global_coordinate_system is False

Returns

The created Spherical Selection Rule

create_tube_selection_rule(name, id=None, outer_radius=1.0, inner_radius=0.0, in-

clude_rule_type=True, edge_set=None)

Create new Tube Selection Rule

Parameters

• name: Name of the rule

• radius: Radius of the rule

• include_rule_type: Include or Exclude area in rule

• edge_set: Edge Set for the rule

Returns

The created rule

create_variable_offset_selection_rule(name, id=None, radius_origin=None, radius_dir-

ection=None, edge_set=None, offsets=None, angles=None, element_set=None, relat-
ive_rule_type=False, include_rule_type=True, use_offset_correction=False, dis-
tance_along_edge=False, inherit_from_lookup_table=True)

Create new Slab Offset Rule

Parameters

• name: Name of the Rule

• id: The unique ID of the rule

• radius_origin: Reference point of the 1D lookup table used for the offsets

• radius_direction: Normal of the cutting plane.

• edge_set: Guide/axis of variable tube

• offsets: 1D lookup table including the radii of the variable tube

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
466 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• angles: Optional taber edge angles

• element_set: Preselection of elements in the form of an element set where the rule is applied
on

• include_rule_type: Boolean whether to select the element inside or outside the variable tube.

• use_offset_correction: Boolean whether to evaluate the evaluat the radius/offset along the
surface or not.

• distance_along_edge: Boolean whether to evaluate the distance along the edge or direction
of the rule. Default is false.

• inherit_from_lookup_table: Boolean whether to inherit origin and direction from the attached
lookup table. Default is false.

Returns

The created rule

definitions

Definitions

deformation_scale_factor

Factor with which the deformed shape plot is scaled.

draping_offset_correction

Define whether to consider lay-up thickness in draping analysis.

edge_sets

Dictionary with all Edge Sets defined.

element_normal(globalID)

Returns the element normal (direction)

Parameters

• globalID: Element label

element_sets

Dictionary with all Element Sets defined.

export(path)

Exports all ACP composite defintions.

Parameters

• path: .acp file path

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 467
The ACP Python Scripting User Interface

export_composite_cae_h5(path, remove_midside_nodes=True, layup_representation_3d=False,

offset_type='bottom_offset', element_sets=None, modeling_plies=None)

Export layup to Composite CAE HDF5 file.

parameters

• path : Save path of the h5 file.

• remove_midside_nodes : Whether midside nodes should be exported or not.

• layup_representation_3d : Whether to compute the 3D lay-up representation of the model. See

note.

• offset_type : Specifies the ply surface to export. Can be bottom_offset, middle_offset or

top_offset.

• element_sets

A list of Element Sets and/or Oriented Selection Sets.

Only plies defined over the selected elements will be exported. If empty list or None, all
elements will be considered.

• modeling_plies

A list of Modeling Plies and/or Modeling Groups. If empty list or None,

all modeling plies will be exported

Note about layup_representation_3d: the 3D lay-up representation contains the offset ply surfaces
where the bottom offset of each ply is exported. The computation can take a while depending
on the model size and it can fail if the model is too complex (shape and topology). This can be
resolved by exporting sub-parts (element sets).

export_h5_composite_definitions(path)

Save composite definitions to HDF5 file. Function is mainly used to exchange composite definitions
with ANSYS Workbench

parameters

• path Save path of the h5 file

export_ply_geometries(filename, plies=[], boundary=True, surface=True, offset_type='middle_off-

set', direction_arrows=False, first_direction=True, second_direction=False, arrow_length=1.0, ar-
row_type='no_arrow')

Exports the surface, boundary and/or fiber directions of modeling, production and analysis ply to
igs or step file.

Parameters

• filename: File path (allowed extensions are iges, igs, step, stp and stl).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
468 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• plies: List of plies (allowed are modeling, production and analysis plies).

• boundary: Boolean whether to export the boundary. Default is True.

• surface: Boolean whether to export the ply surface. Default is True.

• offset_type: Offset type (can be ‘no_offset’, ‘middle_offset’, ‘top_offset’ or ‘bottom_offset’).

Default is ‘middle_offset’

• direction_arrows: Boolean whether to export the direction arrows. Default is False.

• first_direction: Boolean whether to export the first (main) material direction. Default is True.

• second_direction: Boolean whether to export the second material direction. Default is False.

• arrow_length: Length of the arrows. Default is 1.

• arrow_type: Defines the arrow type (can be ‘standard_arrow’, ‘no_arrow’, ‘half_arrow’). Default
is ‘no_arrow’.

Note: Directions and boundaries are not supported by the STL format.

export_solid_models(directory=None, prefix='ACPSolidModel_', delete_existing=True,

formats=['cdb', 'h5'])

Save solid models to files. Function is used within Workbench updates

Parameters

• directory: Directory to save the models.

• prefix: Prefix of the model. Default ACPSolidModel_

• delete_existing: Flag if existing models should be deleted. Default True

• formats: Available file formats are ‘cdb’ or h5. Default [‘cdb’, ‘h5’].

field_definitions

Dictionary with all defined field definitions.

find_materials(**properties)

Find materials with the given properties or property ranges

Parameters

• properties: Arbitrary material properties which must be matched. Note that a single property
value can be given as string, number or min-max range

Returns

A list with materials which match the given properties. If nothing matches an empty list is returned.

Examples:

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 469
The ACP Python Scripting User Interface

format

File format string. Choose one of ‘ansys:h5’, ‘ansys:cdb’, ‘ansys:dat’ or ‘layup’

geometry

Geometry node

get_element_by_point(point)

Returns the element label of the closest element with respect to the given point.

Parameters

-point: Tuple of the global coordinates

get_layup(path, format=None, objects=None, mode='update_entities')

Load layup from excel or csv file

Parameters

• mode: can be: update_properties_only: Definitions are updated with properties given

update_entities: Definitions are update, additional plies are generated and deleted recreate:
Existing layup is deleted generated from scratch

get_layup_from_csv_file(path, objects=None, mode='update_entities', modeling_group=None)

Function that reads the layup data from a csv file and adds the data to the graph

Parameters

• objects: List of objects to be synced

• path: the path to the file

• mode: can be: update_properties_only: Definitions are updated with properties given

update_entities: Definitions are update, additional plies are generated and deleted recreate:
Existing layup is deleted generated from scratch

• modeling_group: key of the mpg_collection dict = the id of the mpg. Only plies of this model-
ing_group will be imported from the file if none is specified all mpgs are read

get_layup_from_excel_file(path, objects=None, mode='update_entities')

Load layup from Excel File

Parameters

• path: Path to file to load

• objects: Objects to be loaded and overwritten

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
470 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• mode: can be: update_properties_only: Definitions are updated with properties given

update_entities: Definitions are update, additional plies are generated and deleted recreate:
Existing layup is deleted generated from scratch

import_composite_cae_h5(path, mode='append', projection='shell', tol_thickness=None,

tol_in_plane=None, tol_angle=None, small_hole_threshold=None, tol_min_angle=None, recom-
pute_ref_directions=False, element_sets=None, offset='bottom_offset', coord_transform_inputs=None)

Import a composite layup definition from a HDF5 file.

Parameters

• path : Load path of the h5 file

• mode

Specify how objects are imported

– append : Imported data/objects are appended to existing model/layup.

– overwrite : Replace objects with equal ids in the model with imported instances if possible
(not locked).

• projection: Defines whether the imported data is treated as shell or solid data

– shell: Default. The imported components are mapped onto the reference surface and
converted into Modeling Plies.

– solid: The components are imported one-to-one exposed as Imported Plies. Can be used
in combination with ImportedSolidModel (lay-up mapping)

• tol_thickness : Mapping tolerance in element thickness direction relative to min element edge
length.

• tol_in_plane : Mapping tolerance in element in-plane direction relative to min element edge
length.

• tol_angle : Mapping tolerance for the angles between element normals.

• small_hole_threshold : Holes in plies/element sets with an area smaller than this threshold
times the area of the element set/ply are filled.

• tol_min_angle : Minimum angle tolerance for which tabular correction angles for plies are
computed.

• recompute_ref_directions’ : Whether reference directions should be recomputed from tabular

angle data or not.

• element_sets : A list of Element Sets.

• offset: Offset for imported plies. Defines if imported mesh is interpreted as bottom, middle
or top ply surface.

Valid modes are ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 471
The ACP Python Scripting User Interface

• coord_transform_inputs: Coordinate transform for the imported data. Dict with the following
properties:

“translation_x”, “translation_y”, “translation_z”, “rotation_angle_deg_x”, “rota-

tion_angle_deg_y”, “rotation_angle_deg_z” The data transformed in the following order:
Rotation X, Rotation Y, Rotation Z Translation

import_composite_definitions_from_acp_file(path=None, import_mode='keep_both')

This functions loads the ACP composite definitions from an external ACP system. Within WB, this
function loads all objects but the mesh, materials and plots In stand-alone mode, all objects but
the mesh and plots are imported.

Parameters

• path: *.acp file path

• import_mode: Defines how to solve conflicts of objects of equal name.

Global Resolution Actions

• keep_both: Keep target and source. Default.

• keep_existing: Imported entities are ignored

• overwrite: Overwrite target with source

import_section_data_from_legacy_model(path, format='ansys:cdb', materials_mask_pre-

fix='mat', materials_mask_suffix=' (setup, file1)')

Import and convert the lay-up of a legacy (MAPDL) shell model into ACP composite definitions.

The mapping is based on the element labels and therefore it is a requirement that the element
labels in the legacy and ACP model match. The import is only performed if the file and ACP
Model units are consistent.

Parameters

• path: file path. Supported file extensions are CDB, DAT and INP.

• format: file format. Supported are ‘ansys:cdb’ and ‘ansys:dat’

• materials_mask_prefix: Defines the prefix that is added to the Matierla ID while importing ma-
terials via ExternalModel.

• materials_mask_suffix: Defines the suffix that is added to the Matierla ID while importing ma-
terials via ExternalModel.

Materials mapping

Only relevant when the import happens within WB. The materials mask pre- and suffix parameters
allow to automatically map WB material and legacy material ids. For instance the pre- and suffix
MAT and ` (Setup, File1)` allows to map MAT1 (Setup, File1) with legacy material 1. The mapping
is case independent. Pass empty mapping masks when no mapping is needed

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
472 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

Example
>>> db.active_model.import_section_data_from_legacy_model(path=r'D: mp\class40_analysis_model.cdb', format='

layup_plots

Plots

lookup_tables

Dictionary with all Look-Up Tables

material_data

Dictionary with all Material Data defined.

mesh

Mesh of this model

mesh_query(name, position, selection='all', entity=None, entities=None, simulate=False, compon-

ent=None)

Query arbitrary data from the mesh of the model

Parameters

• name

Data type to query:

– labels, indices

– etypes

– coordinates

– angles (needs component)

– thickness (needs component)

– normals

– orientations, ref_directions, fiber_directions, transverse_directions

– draped_fiber_directions, draped_transverse_directions

– ply_offsets (offset vector)

– area, volume, mass, price

– cog (centre of gravity)

– offset (offset in the thickness direction)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 473
The ACP Python Scripting User Interface

• component

Defines the component. Needed for name=’angles’ or ‘thickness’

– angles: design_angle, shear, draped_fiber_angle, draped_transverse_angle. design_angle

is the default.

– thickness: thickness, relative_thickness_correction. thickness is the default.

• position

Position where data is queried:

– nodal

– centroid

– element_nodal

• selection

The selection set determines the selected nodes and elements.

Can be given as string ‘sel0’ - ‘sel5’ or ‘all’ or can be given as ObjectSelection object such
as - model.selection - scene.active_set

• entity

Specialized queries require the specification of an additional associated entity,

e.g. an oriented element set is needed to compute orientations. Entity can be given as
NamedGraphObjects or vertex descriptor.

• entities : If a list of entities is given, the query will also compute and return a list of results, with
one array for each entity.

• simulate

Whether the query is only simulated to test if it will return data.

If this flag is set the mesh_query(…) function will only return 0 or 1.

minimum_analysis_ply_thickness

Section computation minimum analysis ply thickness (in length unit of model)

modeling_groups

Dictionary with all Modeling Groups defined.

oriented_selection_sets

Dictionary with all oriented element sets defined.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
474 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

parameters

List of parameters visible to the workbench

path

Path to the reference surface input file. Read only.

plot_dependencies(path=None, parent=None, levels=3)

Generates a graph with all dependencies. The output is a dot, png and pdf file

Parameters

• path: file path without file extension

• parent: Parent object

• levels: Depth levels to look for children

Output

A dot file which can be opend with Graphviz

Usage
>>> model.plot_dependencies(r'C:\\tmp\hull_dependencies', model.element_sets['HULL'], 3)

plybook

PlyBook

pre_path

Save path of pre database linked to currently loaded post database

reference_surface_bounding_box

Tuple with corners of bounding box of reference surface mesh.

reference_surface_input_unit_system_locked

If the unit system of the reference surface is not defined in the mesh input, the unit system can
be changed.

reference_surface_input_unit_system_type

Unit System of the Reference Surface (set by user)

refresh_material_data(matml_file_path, apdl_file_path)

Refresh material external data sources in the model acph5 db. Needs the save_path to be set.

relative_thickness_tolerance

Section computation relative thickness tolerance

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 475
The ACP Python Scripting User Interface

reload_mesh(path=None, format=None)

Reloads the mesh (nodes, elements and named selections) Ignored imported entities are the
materials and rosettes.

Parameters:

• path: New mesh path. Default is the current model path.

• format: New format. Default is the current format

reorder_modeling_groups(source=[], target=None, option='after')

Reorders the modeling groups by placing source before or after the target.

Parameters

• source: list of modeling groups to insert at the new position

• target: a modeling group which defines the position to insert the source.

• option: whether to insert the source before or after the target.

Usage
>>> model.reorder_modeling_groups(source=[modelmodeling_groups['DECK']], target=modelmodeling_groups['HULL'],

rosettes

Dictionary with all Rosettes defined.

sampling_points

Sampling Point Container

save(path=None, cache_data=None)

Save ACP model to .acph5 file :Parameters: - path : Path to file - cache_data : Whether to cache
current state of model or not.

save_analysis_model(path)

Save actual analysis model to disc

parameters

• path Save path of the cdb file

save_apdl_commands(path)

Save APDL commands for composite definitions of actual model

parameters

• path Save path of the cdb file

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
476 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

save_h5(path, cache_data=False)

Save ACP model in ACPH5 format

save_layup(path, format=None, objects=None)

Function that saves the layup data to a csv file

Parameters

• path: the path to the file

• format: format can be csv and excel (on windows only)

• objects: optional parameter if left the entire layup is written to the file, else only the layup
defined within modeling_groups

save_layup_to_csv_file(path, objects=None)

Function that saves the layup data to a csv file

Parameters

• path: the path to the file

• modeling_groups: optional parameter if left the entire layup is written to the file, else only the
layup defined within modeling_groups

save_layup_to_excel_file(path, objects=None)

Function that saves the layup data to an excel file. Windows only!

Parameters

• path: the path to the file

• objects: optional parameter if left the entire layup is written to the file, else only the layup
defined within modeling_groups

scenes

Scenes

scripts

List of user-defined scripts

section_cuts

Section Cuts

select_elements(selection='sel0', op='new', labels=None, indices=None, attached_to=None,

x=None, y=None, z=None, element_type='all')

Selects element within active model. (Marks the given selection as SELECTED)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 477
The ACP Python Scripting User Interface

Parameters

• selection

The selection to update

Can be given as string ‘sel0’ - ‘sel5’ or ‘all’ or can be given as ObjectSelection object such
as - model.selection - scene.active_set

• op: Select operation. Can be all, new (default), add, remove, intersect, inverse or none

• labels: List with element labels to select.

• indices: List with element indices to select.

• attached_to: Elements attached to entities / vertices in this list will be selected.

• x: X-range to select.

• y: Y-range to select.

• z: Z-range to select.

• element_type: Element type: solid, shell

select_nodes(selection='sel0', op='new', labels=None, attached_to=None, x=None, y=None,

z=None)

Function selects nodes in graph and marks the given selection as SELECTED.

Parameters

• selection

The selection to update

Can be given as string ‘sel0’ - ‘sel5’ or ‘all’ or can be given as ObjectSelection object such
as - model.selection - scene.active_set

• op: Select operation. Can be all, new (default), add, remove, intersect, inverse, none

• labels: List with node labels to select.

• attached_to: Nodes attached to the given list of entities or vertices will be selected.

If attached_to=”elements” all nodes attached to selected elements are selected

• x: X-range to select.

• y: Y-range to select.

• z: Z-range to select.

select_solid_elements_from_shells(selection='sel0')

Selects the solid element within given selection and deselects the shell elements.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
478 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

Parameters

• selection : The selection to update. Can be given as string ‘sel0’ - ‘sel5’

Return

Number of selected solid elements

selection

Selected objects of this model

selection_rules

Dictionary with all Selection Rules defined.

sensors

Dictionary with all Sensors.

show_deformed

Whether to show result plots in the deformed and scaled configuration.

show_solver_elements

Whether mesh selections and plot should consider solver elements in solid models or not.

solid_models

SolidModel

solutions

Solutions

solve(wait=False)

Convenience function to directly solve the current model

Parameters

• wait: Wait until solver process finishes computation

solver

Solver instance

unit_system

Create a unit system and assign it to the model. Unit system types are:
si,mks,cgs,umks,mpa,bft,bin,undefined

update(objects='all', relations_only=False)

Main update function

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 479
The ACP Python Scripting User Interface

Parameters

• objects: List of objects to update.

• relations_only: Set this option to true to only update and propagate the status of all objects.

use_default_section_tolerances

Boolean whether to uses angle and thickness tolerances of the application preferences for section
computation. Otherwise model specific values are used.

use_nodal_thicknesses

Define whether to use nodal thicknesses or element thicknesses.

views

Views

6.6.2. Rosette
class compolyx.Rosette(graph, obj, parent=None)

Rosette class.

Access:
>>> model = db.models['class40.1']
>>> rosette_1 = model.rosettes['Rosette.1']
>>> rosette_2 = model.create_rosette(name='Rosette.2', origin=(1.5, 5.75, 7.), dir1=(-0.4, -0.4, 0.8), dir2=(-6.0,

changed

Status boolean. Set to true if the underlying data has been changed. Write only property

dir1

Direction 1 of the Rosette

dir2

Direction 2 of the Rosette

edge_set

Edge Set for Rosette

get_global_coordinates(coordinates)

Evaluates the global coordinates of a point given in local rosette coordinates: CYLINDRICAL, RA-
DIAL and SPHERICAL coord sys type: Give phi and theta in RAD

Parameters

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
480 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• (x, y, z): x = x for PARALLEL, r for CYLINDRICAL, RADIAL and SPHERICAL)

y = y for PARALLEL, phi for CYLINDRICAL, RADIAL and SPHERICAL z = z for PARALLEL, CYL-
INDRICAL, RADIAL and theta for SPHERICAL)

Usage
>>> rosette.get_global_coordinates((1.,2.,3.))

get_global_vector_components(vector)

gets global vector components from local rosette vector components CYLINDRICAL, RADIAL and
SPHERICAL coord sys type: Give phi and theta in RAD

Parameters

• (x, y, z): x = x for PARALLEL, r for CYLINDRICAL, RADIAL and SPHERICAL)

y = y for PARALLEL, phi for CYLINDRICAL, RADIAL and SPHERICAL z = z for PARALLEL, CYL-
INDRICAL, RADIAL and theta for SPHERICAL)

Usage
>>> rosette.get_global_vector_components((1.,2.,3.))

get_local_coordinates(coordinates)

Evaluates the local rosette coordinates of a point given in global coordinates:

Parameters

• (x, y, z): coordinates in global (parallel) coordinates

:returns (x,y,z)

x = x for PARALLEL, r for CYLINDRICAL, RADIAL and SPHERICAL) y = y for PARALLEL, phi for
CYLINDRICAL, RADIAL and SPHERICAL z = z for PARALLEL, CYLINDRICAL, RADIAL and theta
for SPHERICAL) CYLINDRICAL, RADIAL and SPHERICAL coord sys type: phi and theta in RAD

Usage
>>> rosette.get_local_coordinates((1.,2.,3.))

get_local_vector_components(vector)

Returns local rosette vector components from global vector components

Parameters

• (x, y, z): components in global (parallel) coordinates

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 481
The ACP Python Scripting User Interface

:returns (x,y,z)

x = x for PARALLEL, r for CYLINDRICAL, RADIAL and SPHERICAL) y = y for PARALLEL, phi for
CYLINDRICAL, RADIAL and SPHERICAL z = z for PARALLEL, CYLINDRICAL, RADIAL and theta
for SPHERICAL) CYLINDRICAL, RADIAL and SPHERICAL coord sys type: phi and theta in RAD

Usage
>>> rosette.get_local_vector_components((1.,2.,3.))

local_direction(point, angle)

Get local orientation for a given relative angle and position in space

locked

Rosette is generated from an imported rosette and cannot be changed.

origin

Origin of the Rosette

rosette_type

Rosette Types can be: parallel,radial,cylindrical,spherical,edge_wise

serialize()

Serialize to Python string

set_Xy()

sets dir2 orthogonal to dir1 as y- and x-axis

set_Xz()

sets dir2 orthogonal to dir1 as z- and x-axis

set_Yz()

sets dir2 orthogonal to dir1 as z- and y-axis

set_xY()

sets dir1 orthogonal to dir2 as x- and y-axis

set_xZ()

sets dir1 orthogonal to dir2 as x- and z-axis

set_yZ()

sets dir1 orthogonal to dir2 as y- and z-axis

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
482 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

6.6.3. LookUpTable
This section contains the following topics:
6.6.3.1. LookUpTableBase
6.6.3.2. LookUpTable1D
6.6.3.3. LookUpTable3D
6.6.3.4. LookUpTableColumn

6.6.3.1. LookUpTableBase
class compolyx.LookUpTableBase(obj, parent=None)

Bases: compolyx.graph_interface.NamedGraphFuncObject

Look-Up Table Class

associates scalar or vector values to points

Example:
>>> table = db.models['class40.1'].create_lookup_table1d(name='LookUpTable1D.1')
>>> table.columns['Location'].values = [0,1,2,3]
>>> db.models['class40.1'].lookup_tables['LookUpTable1D.2'].create_column( name='Radius', type='scalar' )
>>> r = db.models['class40.1'].lookup_tables['LookUpTable1D.2'].columns['Radius']
>>> r.values = [0,0.3,0.6,1]

active

LookUpTable active

clear()

clear table data (rows and columns)

clear_rows()

clear table rows (keep columns)

column_types

a list of column types (‘scalar’, or ‘direction’)

columns

Dictionary with all columns

create_column(name, type=None, values=None, dimension='dimensionless')

Create a new column.

Parameters

• name : name of column

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 483
The ACP Python Scripting User Interface

• type : a string (‘scalar’, ‘direction’) specifying the column type (the values will be initialized
to NaN)

• values : a numpy array with values (the type is determined from its shape)

empty

True if table is empty

load_from_csv_file(path)

load the table from csv file in path

Load LookUpTable from CSV file

Parameters

• path: path to output file

num_cols

Number of rows

num_rows

Number of columns

save_to_csv_file(path)

Save LookUpTable to CSV file

Parameters

• path: path to output file

tabular_data

a tuple containing a list of column labels and a 2d array with floats for all cells. This is a flattened
view of all columns.

6.6.3.2. LookUpTable1D
class compolyx.LookUpTable1D(obj, parent=None)

Bases: compolyx.lookup_table.LookUpTableBase

A LookUpTable to associate arbitrary data to a one-dimensional field of Locations

column_factory

alias of LookUpTable1DColumn

direction

The Direction of the Look Up Table

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
484 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

origin

The Origin of the Look Up Table

tabular_data

a tuple containing a list of column labels and a 2d array with floats for all cells. This is a flattened
view of all columns.

6.6.3.3. LookUpTable3D
class compolyx.LookUpTable3D(obj, parent=None)

Bases: compolyx.lookup_table.LookUpTableBase

A LookUpTable to associate arbitrary data to a three-dimensional field of locations

algorithm_type

Algorithm types can be: nearest_neighbor,linear_multivariate,weighted_nearest_neighbor

column_factory

alias of LookUpTable3DColumn

num_min_neighbors

Number of neighbors used for the interpolation with weighted nearest neighbor.

remove_duplicate_points()

Removes duplicate supporting points from the table. :return: Number of removed points

Example

>> db.models[‘plate’].lookup_tables[‘LookUpTable3D_scalar’].remove_duplicate_points()

search_radius

Search Radius used for the interpolation with weighted nearest neighbor.

tabular_data

a tuple containing a list of column labels and a 2d array with floats for all cells. This is a flattened
view of all columns.

use_default_search_radius

True if the search radius is estimated automatically.

6.6.3.4. LookUpTableColumn
class compolyx.LookUpTableColumn(name, parent)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 485
The ACP Python Scripting User Interface

an object to hold a column in a table

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

status

column status (‘UPTODATE’,’NOTUPTODATE’, or ‘LOCKED’)

type

column type (scalar or direction)

values

numpy array containing the column values

6.6.4. ElementSelectionRule Classes

This section contains the following topics:
6.6.4.1. ParallelSelectionRule
6.6.4.2. CylindricalSelectionRule
6.6.4.3. SphericalSelectionRule
6.6.4.4.TubeSelectionRule
6.6.4.5. CutoffSelectionRule
6.6.4.6. GeometricalSelectionRule
6.6.4.7. BooleanSelectionRule
6.6.4.8. VariableOffsetSelectionRule

class compolyx.ElementSelectionRule(graph, obj, parent=None)

Base class for Rules This acts as an interface to the cpp object of the rules. The base class implements
_py_update which is called after the cpp update. It sets the changed flag. Since NameGraph derives
from Observable, observers can listen on ‘changed’.

In order to support csv_serialization, the classes have to implement a ‘_dict’ method and a list named
‘_csv_parameters’ The _dict method specifies which properties are written and _csv_parameters
specifies which parameters are read and how they are parsed. The keys in _dict and the elements in
_parameters_csv have to be consistent. If the conversion from the string to an object is more than
simple type conversion, it can be implemented in _update_rule_from_csv.

changed

Triggers Observable to dispatch changed message

extent

extent of the rule

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
486 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

include_rule_type

include type

relative_rule_type

relative type

6.6.4.1. ParallelSelectionRule
class compolyx.ParallelSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

Parallel Selection Rule

direction

Direction of the Parallel Selection Rule.

direction_in_global_coordinates

Direction of the rule in global coordinates

neg_distance

Negative distance

origin

Origin of the Parallel Selection Rule.

origin_in_global_coordinates

Origin of the rule in global coordinates

pos_distance

Positive distance

rosette

Rosette of the used for origin and direction

serialize()

Serialize to Python string

use_global_coordinate_system

Use global coordinate system for origin and direction

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 487
The ACP Python Scripting User Interface

6.6.4.2. CylindricalSelectionRule
class compolyx.CylindricalSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

Cylindrical Selection Rule

direction

Direction of the Cylinder.

direction_in_global_coordinates

Direction of the rule in global coordinates

origin

Origin of the Cylinder.

origin_in_global_coordinates

Origin of the rule in global coordinates

radius

Radius of the Cylinder

rosette

Rosette of the used for origin and direction

serialize()

Serialize to Python string

use_global_coordinate_system

Use global coordinate system for origin and direction

6.6.4.3. SphericalSelectionRule
class compolyx.SphericalSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

Spherical Selection Rule

direction_in_global_coordinates

Direction of the rule in global coordinates

origin

Origin of the Sphere.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
488 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

origin_in_global_coordinates

Origin of the rule in global coordinates

radius

Sphere Radius

rosette

Rosette of the used for origin and direction

serialize()

Serialize to Python string

use_global_coordinate_system

Use global coordinate system for origin and direction

6.6.4.4. TubeSelectionRule
class compolyx.TubeSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

Tube Selection Rule

display_data

The tube rule mesh plot

edge_set

Edge Set for the Tube Selection Rule

extend_endings

Whether to extend the ending of the edge.

get_nodes()

Returns

List of nodes which define the guid of the tube

head

Defines the head of the tube. Only needed if the extensions are asymmetric.

head_extension

Specifies the length of the extension at the head of the tube.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 489
The ACP Python Scripting User Interface

inner_radius

Inner tube-radius

is_closed

Returns true if the edge set of this rule is closed.

mesh

The mesh of the tube rule

nodes

Returns the nodes of this tube as nx3 array including the extensions.

outer_radius

Outer tube-radius

serialize()

Serialize to Python string

symmetrical_extension

Whether the extensions are equal on both ends or not.

tail_extension

Specifies the length of the extension at the tail of the the tube.

6.6.4.5. CutoffSelectionRule
class compolyx.CutoffSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

angle

Cut-Off angle

cutoff_geometry

Cut-Off Geometry for the Cut-Off Rule

cutoff_rule_type

Cutoff rule type, valid values geometry,taper,variable_taper

direction

Direction of the offset and angle interpolation for ‘variable_taper’

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
490 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

distance_type

Distance type for offset and angle interpolation for ‘variable_taper’

edge_set

Edge Set for cutoff_rule_type=`taper` or variable_taper

offset

Cut-Off offset

offset_method

Method to compute the offset of a ply.

offset_type

Take offset from edge set perpendicular to element reference surface (out_of_plane) or in ele-
ment reference surface (in_plane)

origin

Origin of the offset and angle interpolation for ‘variable_taper’ cutoff rules

ply_cutoff_type

Cutoff Types can be: production_ply_cutoff,analysis_ply_cutoff

ply_tapering

Use Ply Tapering Orientation

6.6.4.6. GeometricalSelectionRule
class compolyx.GeometricalSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

Geometrical Selection Rule

add_element_set(element_set)

Add Element Set to GeometricalSelection Rule

clear_element_sets()

Clear Element Sets of Oriented Selection Set

element_sets

Element Sets for the Geometrical Selection Rule.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 491
The ACP Python Scripting User Interface

geometrical_rule_type

Geometrical rule type, valid values geometry,element_sets

geometry

Virtual Geometry for the Geometrical Selection Rule.

in_plane_capture_tolerance

In-plane capture tolerance

neg_capture_tolerance

Capture tolerance in the negative direction of the CAD surface.

pos_capture_tolerance

Capture tolerance in the positive direction of the CAD surface.

projection_normal

Projection direction used to map curves onto the shell mesh.

serialize()

Serialize to Python string

use_defaults

Whether to use the offset value of the CAD Geometry or not.

use_projection_normal

Whether to use a projection normal for outlines or not.

6.6.4.7. BooleanSelectionRule
class compolyx.BooleanSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

Boolean Selection Rule

add_rule(rule, template_rule=False, rule_values=0.0, 0.0, operation_type='intersect')

Add Selection Rule to Boolean Selection rule

Parameters

• rule: The Rule to be added

• template_rule: Whether this is a template rule or not

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
492 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• rule_values: Parameters of the template rule (For instance upper and lower limit of a Paral-
lelSelectionRule)

• operation_type: Boolean operation type (intersect, add, remove)

Example: >>> boolean_rule.add_rule(rule=model.selection_rules[‘ParallelRule.1’],tem-

plate_rule=True, rule_values=(-20.0, 50.0), operation_type=’intersect’)

selection_rules

Element Selection Rule of the Boolean Selection Rule.

serialize()

Serialize to Python string

6.6.4.8. VariableOffsetSelectionRule
class compolyx.VariableOffsetSelectionRule(graph, obj, parent=None)

Bases: compolyx.selection_rule.ElementSelectionRule

angles

Link to lookup table column with taper angles

distance_along_edge

Whether to evaluate the distance along the edge or direction of the rule

edge_set

Link to edge set

element_set

The element set on which the rule is applied.

inherit_from_lookup_table

Whether to inherit the Look-Up Table object properties.

offsets

Link to lookup table column with offsets

radius_direction

Direction for offset value interpolations

radius_origin

Origin for offset value interpolations

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 493
The ACP Python Scripting User Interface

serialize()

Serialize to Python string

use_offset_correction

Use offset correction on mesh

6.6.5. EntitySet Classes

This section contains the following topics:
6.6.5.1. ElementSet
6.6.5.2. EdgeSet

class compolyx.EntitySet(graph, obj, parent=None)

Base class for entity sets

add(entity)

Add entity to the set

remove(entity)

Remove entity from the set

size

Number of entities

6.6.5.1. ElementSet
class compolyx.ElementSet(graph, obj=None, parent=None)

Bases: compolyx.entity_set.EntitySet

Element set class

Exemplary usage
>>> m=db.models.values()[-1]
>>> eset=m.element_sets['DECK']
>>> eset.modify(op='none')
>>> eset.modify(op='new', element_labels=[1,2,3,4])
>>> eset.modify(op='add', element_sets=[ m.element_sets['Deck_layup-1'] ])
>>> eset.modify(op='intersect', x=[-6.5,-5.5])

boundaries

Get the boundaries of the Element Set

locked

Element Set is imported and cannot be changed.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
494 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

middle_offset

Middle offset flag

modify(op='new', element_labels=None, element_sets=None, x=None, y=None, z=None)

General method to modify the elements in an element set

Parameters

• op: Selection method: new, add, remove, intersect or inverse

• element_labels: List of element ids

• element_sets: List of element sets

• x: Min and max of x location

• y: Min and max of y location

• z: Min and max of z location

normals

Get the Normals of the Element Set

orientable

True if the Element Set has an orientable topology

partition()

Partitions this ElementSet into new ElementSets with an orientable topology if this ElementSet
is already orientable, a copy will be created

planar

True if the Element Set has a planar topology

serialize()

Serialize to Python string

write_boundaries(filename, format=None)

Write boundaries in iges/step format :Parameters: - filename: output file - format: ‘iges’, ‘step’,
None (automatic format recognition)

6.6.5.2. EdgeSet
class compolyx.EdgeSet(graph, obj=None, parent=None)

Edge Set class

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 495
The ACP Python Scripting User Interface

changed

Status boolean. Set to true if the underlying data has been changed. Write only property

display_data

The edge set mesh plot

edge_set_type

Edge Set Types can be: “By Reference”, “By Nodes”

get_nodes()

Return python list with nodes as objects

is_closed

Edge Set is closed.

limit_angle

Edge Set limit angle for creation of edge set by reference

locked

Edge Set is imported and cannot be changed.

mesh

The edge set mesh

node_labels

Node labels defining the NodeSet (only if type=’By Nodes’)

nodes

Node indexes/labels of the Edge Set

origin

Edge Set origin for createion of edge set by reference

serialize()

Serialize to Python string

6.6.6. Geometry Classes

This section contains the following topics:
6.6.6.1. CADGeometry
6.6.6.2. CADCompound
6.6.6.3. CADSolid

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
496 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

6.6.6.4. CADShell
6.6.6.5. CADFace
6.6.6.6. VirtualGeometry
6.6.6.7. CADReference

6.6.6.1. CADGeometry
class compolyx.CADGeometry(graph, obj, visible_sub_shapes=None, parent=None)

cad_compounds

Dictionary with all compounds in the CAD Geometry.

cad_faces

Dictionary with all face shapes.

cad_solids

Dictionary with all solid shapes.

cad_surfaces

Dictionary with all shell shapes.

changed

Status boolean. Set to true if the underlying data has been changed. Write only property

display_data

CAD geometry mesh surface plot

ext_id

External ID of the CAD Geometry object.

locked

CAD geometry is generated from an imported geometry and cannot be changed.

normals_display_data

CAD geometry normals visualization

offset

Offset value used to analyze the surface’s coverage regarding the mesh.

path

The file path where the CAD geometry is loaded from.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 497
The ACP Python Scripting User Interface

precision

Precision of geometrical operations (intersection points, thickness sampling, …).

refresh_external_source(enforce=False)

Reload the geometry from the external source.

Parameters

• enforce: enforce the reloading of external data for locked object in the new acph5 serialization
format. This option should be used with care!

root_shapes

Dictonary with all free shapes of the CAD Geometry

save_as(path)

Save the initial geometry file to the specified path.

The file extension must match the original one.

scale_factor

Geometry is scaled with this factor.

shape_type

Topological type of the shape.

show_normals

Visibility of Face Normals.

sub_shape_selection_display_data

CAD face selection plot

sub_shapes

Sub faces of the CAD Geometry.

use_default_offset

Whether to use the default value or not.

use_default_precision

Whether to use default precision value or not.

visible_sub_shapes

Ids of CAD sub shapes to be displayed, stored per-scene id

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
498 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

visualization_mesh

Visualization mesh of this geometry

6.6.6.2. CADCompound
class compolyx.CADCompound(graph, obj, parent=None)

ComPoLyX Class to represent CADCompound

sub_shapes

Sub faces of the CAD Compound.

6.6.6.3. CADSolid
class compolyx.CADSolid(graph, obj, parent=None)

ComPoLyX Class to represent CADSolid

sub_shapes

Sub faces of the CAD Solid.

6.6.6.4. CADShell
class compolyx.CADShell(graph, obj, parent=None)

ComPoLyX Class to represent CADShell

sub_shapes

Sub faces of the CAD Shell.

6.6.6.5. CADFace
class compolyx.CADFace(graph, obj, parent=None)

ComPoLyX Class to represent CADFace

6.6.6.6. VirtualGeometry
class compolyx.VirtualGeometry(graph, obj, parent=None)

ComPoLyX Class to represent VirtualGeometry

add(shape)

Creates a new CADReference object for the given shape. Returns the new CADReference object
or the existing one if available

Parameters

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 499
The ACP Python Scripting User Interface

• shape: A tuple. The first item is the shape object and the second the link path (root path) of
the shape.

If the first item is None, the link path is used to link the shape with the virtual geometry.

Usage
>>> cad = db.active_model.geometry.cad_geometries['CadGeometry.1']
>>> db.active_model.geometry.virtual_geometries['RefGeom'].add( (cad.root_shapes['top_surface'], "") )
or
>>> db.active_model.geometry.virtual_geometries['RefGeom'].add( (None, "CadGeometry.1/top_surface") )

cad_geometry

Returns the linked CADGeometry. Read only.

cad_references

Dictionary of all cad references.

clear_cad_references()

Clear all linked references (VirtualGeometry becomes empty)

create_cad_reference(name='VirtualGeometry.1', id=None, path=None, size=None, cog=None,

dimension=None, bounding_box_min=None, bounding_box_max=None)

Creates a new Cad Reference and links it with the Virtual Geometry

Parameters

• name: Name of the object

• id: ID of the object

• path: Geometry path of the linked cad component

• size: Size of the linked cad component. Size can be the volume, area or length depending
on the type of the linked cad component.

• cog: Center of gravity of the linked cad component.

• dimension: The shape type of the cad component. CADCompound, CADSolid, CADShell or
CADFace.

• bounding_box_min: Minimum point of the bounding box

• bounding_box_max: Maximum point of the bounding box

Return

• the new cad reference object

dimension

Highest dimension of all cad references. 3=solid, 2=surface, 1=curve

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
500 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

remove(shape)

Removes the CADReference object for the given shape

Usage
>>> cad = db.active_model.geometry.cad_geometries['CadGeometry.1']
>>> db.active_model.geometry.virtual_geometries['RefGeom'].remove( (cad.root_shapes['top_surface'], "") )
or
>>> db.active_model.geometry.virtual_geometries['RefGeom'].remove( (None, "CadGeometry.1/top_surface") )

serialize()

Serialize to Python string

set(shapes)

Clears the existing CAD References and creates a new one for each given shape

Parameters

• shapes: A list of tuples. The first item is the shape object and the second the link path (root
path) of the shape.

Usage
>>> shell = db.active_model.geometry.cad_geometries['CADGeometry.1'].root_shapes['cut_surface']
>>> db.active_model.geometry.virtual_geometries['RefGeom.1'].set(shapes=[ (shell, "") ] )
or
>>> db.active_model.geometry.virtual_geometries['RefGeom.1'].set(paths=[ (None, "CADGeometry.1/cut_surface

sub_shapes

Sub components of the VirtualGeometry.

6.6.6.7. CADReference
class compolyx.CADReference(graph, obj, parent=None)

ComPoLyX Class to represent CAD Reference

bounding_box_max

Maximum of the bounding box.

bounding_box_min

Minimum of the bounding box.

cog

Center of gravity of the linked shape

dimension

Dimension of the linked shape (1 for lines, 2 for surfaces and 3 for solids).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 501
The ACP Python Scripting User Interface

path

Link path of the CADReference

size

Size of the linked cad shape

status

Status of the CADReference

6.6.7. OrientedSelectionSet
class compolyx.OrientedSelectionSet(graph, obj, parent=None)

Class to represent Oriented Selection Set

add_element_set(element_set)

Add Element Set to Oriented Selection Set

add_rosette(rosette)

Add Rosette to Oriented Selection Set

add_selection_rule(rule)

Add Selection Rule to Oriented Selection Set

auto_draping_direction

Automatic selection of draping direction.

boundaries

Get the boundaries of the Oriented Selection Set

clear_element_sets()

Clear Element Sets of Oriented Selection Set

clear_rosettes()

Clear Rosettes of Oriented Selection Set

clear_selection_rules()

Clear Selection Rules of Oriented Selection Set

draping

Flag for using draping or not

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
502 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

draping_direction

The direction in which the draping starts.

draping_material_model

Draping material model.

draping_mesh_size

The mesh size for draping.

draping_obj

Draping representation

draping_seed_point

The seed point where the draping starts.

draping_ud_coefficient

UD draping coefficient

element_sets

Element Sets of the oriented element set.

elements

Elements of the Oriented Selection Set.

normal_from_id(id)

Returns the element normal

normals

Get the Normals of the Oriented Selection Set

orientation_direction

The Orientation Direction of the Oriented Element set.

orientation_point

The Orientation Point of the Oriented Selection Set.

orientations

Get the oriented normals of the Oriented Selection Set

ref_directions

Get the Refernce Directions of the Oriented Selection Set

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 503
The ACP Python Scripting User Interface

reference_direction_field

a look-up table column or None for external reference directions

remove_element_set(element_set)

Remove Element Set from Oriented Selection Set

remove_rosette(rosette)

Remove Rosette from Oriented Selection Set

remove_selection_rule(rule)

Remove Rule from Oriented Selection Set

rosette_selection_method

Selection Method for Rosettes of the Oriented Selection Set.

rosettes

Rosettes of the Oriented Selection Set.

save_flat_wrap(filename)

Write the flatwrap to DXF, IGES or STEP file

Parameters

• filename: Path to the file to be writen

selection_rules

Selection Rules of the Oriented Selection Set.

serialize()

Serialize to Python string

use_default_draping_mesh_size

Whether to use a default size for the draping mesh.

write_boundaries(filename, format=None)

Write boundaries in iges/step format :Parameters: - filename: output file - format: ‘iges’, ‘step’,
None (automatic format recognition)

6.6.8. ModelingGroup
This section contains the following topics:
6.6.8.1. ModelingPly
6.6.8.2. ProductionPly

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
504 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

6.6.8.3. AnalysisPly
6.6.8.4. InterfaceLayer
6.6.8.5. ButtJointSequence

class compolyx.ModelingGroup(graph, obj, parent=None)

Class to manage modeling groups.

Access:
>>> import compolyx
>>> db = compolyx.DB()
>>> model = db.models['class40.1']
>>> mpg = model.modeling_groups['PlyGroup.1']

Creation:
>>> import compolyx
>>> db = compolyx.DB()
>>> model = db.models['class40.1']
>>> mpg_1 = model.create_modeling_group('PlyGroup.1')

copy_butt_joint_sequence(source, global_ply_nr=None, sort=True)

Makes a copy of a butt joint sequence

Parameters

• source: Source object to copy

• global_ply_nr: Global ply number to use. If 0 the ply is added at the top.

• sort: Whether to sort all plies of modeling group after copy.

If multiple plies are copied at once it can be useful to sort only once at the end of the copy
operation.

Returns

New instance of modeling ply

copy_interface_layer(source, global_ply_nr=None, sort=True)

Copy a Interface Layer

Parameters

• source: Source object to copy

• global_ply_nr: Global ply number to use. If 0 the ply is added at the top.

• sort: Whether to sort all plies of Interface Layer group after copy.

If multiple plies are copied at once it can be useful to sort only once at the end of the copy
operation.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 505
The ACP Python Scripting User Interface

Returns

New instance of Interface Layer

copy_modeling_ply(source, global_ply_nr=None, sort=True)

Copy a modeling ply

Parameters

• source: Source object to copy

• global_ply_nr: Global ply number to use. If 0 the ply is added at the top.

• sort: Whether to sort all plies of modeling group after copy.

If multiple plies are copied at once it can be useful to sort only once at the end of the copy
operation.

Returns

New instance of modeling ply

create_butt_joint_sequence(name=None, id=None, global_ply_nr=None, primary_plies=None,

secondary_plies=None, active=True)

Creates an new butt joint sequences and adds it to this modeling group

Parameters

-name: Name of the butt joint -id: ID of the name -global_ply_nr: Global ply number which orders
the ply sequences -primary_plies: List of tuples (modeling ply, level). Define the source of the
thickness between plies. -secondary_plies: Single or list of modeling plies. Secondary plies inherit
the thickness from the primary plies -active: Boolean whether the butt joint sequence is active or
not

Return

New butt joint sequence

create_interface_layer(name=None, id=None, global_ply_nr=None, oriented_selec-

tion_sets=None, open_area_sets=None, active=True)

Create Interface Layer

Parameters

• name: Name of the new Interface Layer

• id: Optional id of the new Interface Layer

• global_ply_nr: Ply number for stacking sequence

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
506 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• oriented_selection_sets: Oriented Selection Set for the expansion

of the Interface Layer

• open_area_sets: Defines the initial crack of a VCCT layer (optional)

• active: Interface Layer active. Default True

Returns

The created Interface Layer

Example
>>> oes_1 = model.oriented_selection_sets['OrientedSelectionSet.1']
>>> mpg = model.modeling_groups['PlyGroup.1']
>>> mp_1 = mpg.create_interface_layer( name='InterfaceLayer.1',
global_ply_nr=0,
oriented_selection_sets=(oes_1,),
active=True)

create_modeling_ply(name=None, id=None, ply_material=None, ply_angle=0.0, number_of_lay-

ers=1, global_ply_nr=None, oriented_selection_sets=None, selection_rules=None, draping='no_drap-
ing', draping_seed_point=None, auto_draping_direction=True, draping_thickness_correction=True,
draping_direction=None, draping_mesh_size=0.0, use_default_draping_mesh_size=True, thick-
ness_definition='nominal', core_geometry=None, active=True, taper_edges=None, thick-
ness_field=None, thickness_field_type='absolute', angle_1_field=None, angle_2_field=None)

Create modeling ply

Parameters

• name: Name of the new Modeling Ply

• id: Optional id of the new Modeling Ply

• ply_material: Ply Material (Fabric, Stackup, SubLaminate)

• ply_angle: Angle of the Ply Material

• number_of_layers: Multiplier of this layer

• global_ply_nr: Ply number for stacking sequence

• oriented_selection_sets: Oriented Selection Set for the expansion

of the Modeling Ply

• selection_rules: Element Selection Rules for the Modeling Ply

• draping: The type of draping to be used “no_draping”, “evaluate_draping”, or “tabular_values”

• draping_seed_point: Start/Seed Point for Draping

• auto_draping_direction: Automatically set draping direction (Default: True)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 507
The ACP Python Scripting User Interface

• draping_direction: Direction to go in Draping (Default: None)

• draping_mesh_size: Mesh size used for Draping

• use_default_draping_mesh_size: Wheterh to use a default size for the draping mesh. Default
is the average element size of the shell mesh.

• thickness_definition: Enum that describes the method used for thickness definition (Default:
Nominal)

• core_geometry: The assigned core geometry

• active: Modeling Ply active

• taper_edges: Taper Edges for the Modeling Ply

• thickness_field: Look-Up table column with scalar values for thickness sampling (optional)

• thickness_field_type: The type of thickness field ‘absolute’ or ‘relative’

• angle_1_field: Look-Up table column with scalar values for angle 1

• angle_2_field: Look-Up table column with scalar values for angle 2

Returns

The created Modeling Ply

Example
>>> oes_1 = model.oriented_selection_sets['OrientedSelectionSet.1']
>>> fabric_1 = model.material_data.fabrics['Fabric.1']
>>> mpg = model.modeling_groups['PlyGroup.1']
>>> mp_1 = mpg.create_modeling_ply( name='ModelingPly.1',
ply_angle=0.0,
global_ply_nr=0,
number_of_layers=1,
ply_material=fabric_1,
oriented_selection_sets=(oes_1,),
selection_rules=(rule1,),
draping="no_draping",
draping_seed_point = (1,0,0),
auto_draping_direction = True)

export_ply_geometries(filename, ply_level='production_ply', boundary=True, surface=True,

offset_type='middle_offset', direction_arrows=False, first_direction=True, second_direction=False,
arrow_length=1.0, arrow_type='no_arrow')

Exports the surface, boundary and/or fiber directions of modeling, production and analysis ply to
igs or step file.

Parameters

• filename: File path (allowed extensions are iges, igs, step and stp).

• ply_level: Defines which plies are exported: modeling_ply_wise, production_ply_wise or analys-

is_ply_wise. Default is production_ply_wise.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
508 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• boundary: Boolean whether to export the boundary. Default is True.

• surface: Boolean whether to export the ply surface. Default is True.

• offset_type: Offset type (can be no_offset, middle_offset, top_offset or bottom_offset). Default

is middle_offset.

• direction_arrows: Boolean whether to export the direction arrows. Default is False.

• first_direction: Boolean whether to export the first (main) material direction. Default is True

• second_direction: Boolean whether to export the second material direction. Default is False.

• arrow_length: Length of the arrows. Default is 1.

• arrow_type: Defines the arrow type (can be standard_arrow, no_arrow, half_arrow). Default is
no_arrow.

plies

Modeling Plies of the Modeling Group

reorder_plies(source, target, option='after')

Reorder the ply group. Take source plies and insert before/after target ply. If the ModelingGroup
itself is specified as a target, the modeling plies retain their original global ply number.

Parameters

• source: list of plies to insert at new position

• target: position to insert plies. Can be modeling group or sequence entity

• option: where to insert: after`(default), `before, or end (for SequenceEntity targets) keep (for

ModelingGroup targets) - after: paste right after the target - before: paste right before the
target - end: paste at the end of the ModelingGroup containing target - keep: keep the
previous global_ply_nr (only works for move, and when target is a ModelingGroup)

serialize(butt_joints=False)

Serialize to Python string

Parameters

• butt_joints: specify whether butt-joints are serialized or everything else (Modeling Group,
Modeling Plies and Interface Layers)

6.6.8.1. ModelingPly
class compolyx.ModelingPly(graph, obj, parent=None, element_vd=None)

Class to represent Modeling Ply

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 509
The ACP Python Scripting User Interface

add_oriented_selection_set(oriented_selection_set)

Add Oriented Selection Set

Parameters

• oriented_selection_set: The Oriented Selection Set to be assigned to ModelingPly

add_selection_rule(rule, template_rule=False, rule_values=(), operation_type='intersect')

Add Rule to Modeling Ply

Parameters

• rule: The Rule to be added to the Modeling Ply

• template_rule: Bool

• rule_values: Parameters of the template rule

• operation_type: Boolean operation type (intersect, add, remove)

add_taper_edge(taper_edge, angle, offset=0.0)

Add Taper Edge to Modeling Ply

Parameters

• taper_edge: The Taper Edge to be added to the Modeling Ply

• angle: Angle for tapering

• offset: Offset for tapering

angle_1_field

Angle 1 Correction field

angle_2_field

Angle 2 Correction field

area

Area of the Modeling Ply

auto_draping_direction

Automatic selection of draping direction.

clear_oriented_selection_sets()

Clear all Oriented Selection Sets of the Modeling Ply

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
510 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

clear_selection_rules()

Clear all selection_rules assigned to the Modeling Ply

clear_taper_edges()

Clear all taper_edges assigned to the Modeling Ply

core_geometry

Assigned Core Geometry

direction_arrows(arrow_length=None, arrow_type='standard_arrow', offset_type='no_offset')

Direction arrows of the ply

Parameters

• arrow_length: length of the arrow

• arrow_type: ‘standard_arrow’ (default), ‘no_arrow’, ‘half_arrow’

• offset_type: ‘no_offset’ (default), ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

draped_fiber_directions

Get the Draped Fiber Directions of the Modeling Ply

draping

Type of draping to be used

draping_direction

The direction in which the draping starts.

draping_direction_from_calculation(analysis_ply=None)

Draping direction used for draping calculation

draping_mesh_size

The mesh size for draping.

draping_obj

Draping properties of the Modeling Ply

draping_seed_point

The seed point where the draping starts.

draping_seed_point_from_calculation(analysis_ply=None)

Draping seed point used for draping calculation

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 511
The ACP Python Scripting User Interface

draping_thickness_correction

Thickness correction for draping.

element_normal_is_equal(element_id=None, normal=None)

Returns 1 if the element normal is equal the orientation of the modeling ply, else -1

Parameters

• element_id: Element label

• normal: Reference normal direction

fiber_directions

Get the Fiber Directions of the Modeling Ply

number_of_layers

Number of layers of the Modeling Ply

on_sampling_point

Flag if the modeling ply is on sampling point

orientation_at_element(element_id=None)

Returns the orientation of this modeling ply for a certain element. If the element does not belong
to the modeling ply the return value is [0,0,0]

Parameters

• element_id: Element label

orientations

Get the oriented normals of the Modeling Ply

oriented_selection_sets

Oriented Selection Sets of the Modeling Ply

ply_angle

Ply Angle of the Modeling Ply

ply_offsets

Get the offsetted Modeling Ply

price

Price of the Modeling Ply

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
512 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

production_plies

Production Plies of the Modeling Ply

ref_directions

Get the Reference Directions of the Modeling Ply

remove_oriented_selection_set(oriented_selection_set)

Remove Oriented Selection Set from Modeling Ply

Parameters

• oriented_selection_set: The Oriented Selection Set to be removed from ModelingPly

remove_selection_rule(rule)

Remove Rule from Modeling Ply

Parameters

• rule: The Rule to be removed from Modeling Ply

remove_taper_edge(taper_edge)

Remove taper_edge from Modeling Ply

Parameters

• taper_edge: The taper_edge to be removed from Modeling Ply

selection_rules

Element Selection Rule of the Modeling Ply.

serialize()

Serialize to Python string

taper_edges

Taper Edges of the Modeling Ply.

thickness_definition

Type of thickness-definition to be used

thickness_field

LookUpTable Column with tabular thicknesses or None

thickness_field_type

The type of the Thickness field ‘absolute’ or ‘relative’

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 513
The ACP Python Scripting User Interface

use_default_draping_mesh_size

Enable this property to use a default size for the draping mesh.

weight

Weight of the Modeling Ply

write_boundaries(filename, format=None, offset_type='no_offset', with_direction_arrows=False,

arrow_length=None, arrow_type='standard_arrow')

Write boundaries in iges/step format

Parameters

• filename: output file

• format: ‘iges’, ‘step’, None (automatic format recognition)

• offset_type: ‘no_offset’ (default), ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

• with_direction_arrows: the element directions should be written to

• arrow_length: length of the direction arrows (default is average element edge size)

• arrow_type: type to be used as arrows (‘standard_arrow’(default), ‘no_arrow’, ‘half_arrow’)

6.6.8.2. ProductionPly
class compolyx.production_ply.ProductionPly(graph, obj, parent=None, ele-
ment_vd=None)

Class to represent Production Ply

analysis_plies

Analysis Plies of the Production Ply

angle

Ply Angle of the Production Ply

area

Area of the production ply

const_thickness

True if this Production Ply has a constant thickness

direction_arrows(arrow_length=None, arrow_type='standard_arrow', offset_type='no_offset')

Direction arrows of the ply

Parameters

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
514 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

• arrow_length: length of the arrow

• arrow_type: ‘standard_arrow’ (default), ‘no_arrow’, ‘half_arrow’

• offset_type: ‘no_offset’ (default), ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

draping_obj

Draping representation

ply_material

Ply Material of the Production Ply

price

Price of the production ply

save_draping_input_data(filename)

Writes out Modeling Ply to Draping Interface File

Parameters

• filename: Path to the file to be written

save_flat_wrap(filename)

Write the flatwrap to DXF, IGES or STEP file

Parameters

• filename: Path to the file to be writen

thickness

Thickness of the Production Ply

update()

Update the Production Ply

weight

Weight of the production ply

write_boundaries(filename, format=None, offset_type='no_offset', with_direction_arrows=False,

arrow_length=None, arrow_type='standard_arrow')

Write boundaries in iges/step format

Parameters

• filename: output file

• format: ‘iges’, ‘step’, None (automatic format recognition)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 515
The ACP Python Scripting User Interface

• offset_type: ‘no_offset’ (default), ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

• with_direction_arrows: the element directions should be written to

• arrow_length: length of the direction arrows (default is average element edge size)

• arrow_type: type to be used as arrows (‘standard_arrow’(default), ‘no_arrow’, ‘half_arrow’)

6.6.8.3. AnalysisPly
class compolyx.AnalysisPly(graph, obj, parent=None)

ComPoLyX Class to represent Analysis Ply

active

Sequence Entity is active

active_in_post_mode

True if failure criteria will be processed for this ply.

angle

Ply Angle of the Analysis Ply

direction_arrows(arrow_length=None, arrow_type='standard_arrow', offset_type='no_offset')

Direction arrows of the ply

Parameters

• arrow_length: length of the arrow

• arrow_type: ‘standard_arrow’ (default), ‘no_arrow’, ‘half_arrow’

• offset_type: ‘no_offset’ (default), ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

draping_obj

Get the Fiber Directions of the Analysis Ply

is_reinforcing()

True if the AnalysisPly is a reinforcing ply.

For instance, if linked to a Lay-up Mapping Object of type “reinforcing” or to an Imported Solid
Model via a Mapping Object of type “reinforcing”.

material

Ply Material of the Analysis Ply

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
516 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

mesh

Mesh. Only available if analysis plyis reinforcement

ply_material

Ply Material of the Analysis Ply

thickness

Thickness of the Analysis Ply

update()

Update the Analysis Ply

write_boundaries(filename, format=None, offset_type='no_offset', with_direction_arrows=False,

arrow_length=None, arrow_type='standard_arrow')

Write boundaries in iges/step format

Parameters

• filename: output file

• format: ‘iges’, ‘step’, None (automatic format recognition)

• offset_type: ‘no_offset’ (default), ‘bottom_offset’, ‘middle_offset’, ‘top_offset’

• with_direction_arrows: the element directions should be written to

• arrow_length: length of the direction arrows (default is average element edge size)

• arrow_type: type to be used as arrows (‘standard_arrow’(default), ‘no_arrow’, ‘half_arrow’)

6.6.8.4. InterfaceLayer
class compolyx.InterfaceLayer(graph, obj, parent=None)

Class to represent Interface Layer

add_open_area_set(value)

Add Open Area Set to Interface Layer

add_oriented_selection_set(oriented_selection_set)

Add Oriented Selection Set

Parameters

• oriented_selection_set: The Oriented Selection Set to be assigned to Interface Layer

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 517
The ACP Python Scripting User Interface

clear_open_area_sets()

Clears the open area selection

clear_oriented_selection_sets()

Clear all Oriented Selection Sets of the Interface Layer

enabled

Whether this object is currently enabled or not.

open_area_sets

Open area set(s) of the Interface Layer

oriented_selection_sets

Oriented Selection Sets of the Interface Layer

ply_offsets

Get the offsetted Interface Layer

remove_open_area_set(value)

Remove Open Area Set from Interface Layer

remove_oriented_selection_set(oriented_selection_set)

Remove Oriented Selection Set from Interface Layer

Parameters

• oriented_selection_set: The Oriented Selection Set to be removed from Interface Layer

serialize()

Serialize to Python string

6.6.8.5. ButtJointSequence
class compolyx.ButtJointSequence(graph, obj, parent=None)

Class to represent the Butt Joint Sequence

primary_plies

Primary plies of the butt joint squence

secondary_plies

Secondary plies of the butt joint squence

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
518 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

serialize()

Serialize to Python string

6.6.9. ImportedModelingGroup
This section contains the following topics:
6.6.9.1. ImportedModelingPly
6.6.9.2. ImportedProductionPly
6.6.9.3. ImportedAnalysisPly

class compolyx.ImportedModelingGroup(graph, obj, parent=None)

copy_imported_modeling_ply(source)

Copy an imported modeling ply

Parameters

• source: Source object to copy

Returns

New instance of imported modeling ply

create_imported_modeling_ply(name=None, id=None, active=True, offset='bottom', ply_ma-

terial=None, ply_angle=0.0, mesh_import_type='from_geometry', mesh_geometry=None,
rosette_selection_method='minimum_angle', rosettes=[], thickness_definition='nominal', thick-
ness_field=None, thickness_field_type='absolute', draping='no_draping', angle_1_field=None,
angle_2_field=None)

Create modeling ply

Parameters

• name: Name of the new Imported Modeling Ply

• id: Optional id of the new Imported Modeling Ply

• active: Whether the ply is active or not

• offset: whether the mesh defines the bottom, middle or top surface of the ply

• ply_material: Ply Material (Fabric)

• ply_angle: Angle of the Ply Material

• mesh_import_type: The source of the imported mesh (‘from_h5_composite_cae’ or

‘from_geometry’)

• mesh_geometry: if mesh_import_type is from_geometry, then this geometry defines the surface

of the ply

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 519
The ACP Python Scripting User Interface

• rosette_selection_method: Method to calculate element orientation

(‘minimum_angle’, ‘maximum_angle’, ‘minimum_distance’, ‘minimum_angle_superposed’,

‘minimum_distance_superposed’, ‘maximum_angle_superposed’, ‘ansys_classic’, or ‘tabu-
lar_values’)

• rosettes: Rosettes for the Imported Modeling Ply

• reference_direction_field: Table column used to compute reference directions. Only needed if

rosette_selection_method is tabular_values.

• thickness_definition: Enum that describes the method used for thickness definition (Default:
nominal)

• thickness_field: Look-Up table column with scalar values for thickness sampling (optional)

• thickness_field_type: The type of thickness field ‘absolute’ or ‘relative’

• draping: The type of draping to be used “no_draping” or “tabular_values”

• angle_1_field: Look-Up table column with scalar values for angle 1

• angle_2_field: Look-Up table column with scalar values for angle 2

Returns

The created Imported Modeling Ply

Example
>>> modeling_group = db.active_model.create_imported_modeling_group( name='ImportedModelingGroup' )
>>> modeling_group.create_imported_modeling_ply(name='ImportedModelingPly.1', offset='middle', ply_angle=45)

plies

Modeling Plies of the Modeling Group

6.6.9.1. ImportedModelingPly
class compolyx.ImportedModelingPly(graph, obj, parent=None)

active

Whether the ply is active or surpressed.

angle_1_field

Angle 1 Correction field

angle_2_field

Angle 2 Correction field

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
520 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

clear_rosettes()

Clear Rosettes of Imported Modeling Ply

draping

Type of draping to be used

mesh

mesh_geometry

Geometry that defines the mesh/surface of this ply

mesh_import_type

Defines the source of the imported mesh

offset

Defines whether the imported mesh defines the bottom, middle or top surface of the ply.

ply_angle

Ply Angle of the Imported Modeling Ply

ply_material

Material of the Modeling Ply

production_plies

Attached imported production plies

reference_direction_field

a look-up table column or None for external reference directions

rosette_selection_method

Defines the rosette selection method

rosettes

Rosettes of the Imported Modeling Ply.

thickness_definition

Type of thickness-definition to be used (from table, nominal)

thickness_field

LookUpTable Column with tabular thicknesses or None

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 521
The ACP Python Scripting User Interface

thickness_field_type

The type of the Thickness field ‘absolute’ or ‘relative’

6.6.9.2. ImportedProductionPly
class compolyx.ImportedProductionPly(graph, obj, parent=None)

analysis_plies

Analysis Plies of the Production Ply

angle

Ply Angle of the Production Ply

mesh

ply_material

Ply Material of the Production Ply

thickness

Thickness of the Production Ply

6.6.9.3. ImportedAnalysisPly
class compolyx.ImportedAnalysisPly(graph, obj, parent=None)

Class to represent an imported modeling ply

active_in_post_mode

Whether ply is active in ACP Post

angle

Ply Angle

is_reinforcing()

True if the AnalysisPly is a reinforcing ply.

For instance, if linked to a Lay-up Mapping Object of type “reinforcing” or to an Imported Solid
Model via a Mapping Object of type “reinforcing”.

material

Ply material

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
522 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

mesh

thickness

Average ply thickness

6.6.10. FieldDefinition
class compolyx.FieldDefinition(graph, obj, parent=None)

Class to represent Field Definition

active

Field Definition is active

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

field_variable_name

The name of the field variable defined.

full_mapping

Whether the field is interpolated to the shell reference surface or to the actual ply-position by
taking into account the shell offset; in solid models the interpolation takes always place at the
actual ply position.

locked

Returns the locked status of the Field Definition

scalar_field

Look-up table used with this field definition.

scope_entities

The entities defining the scope of the field definition. Allowed are Element Sets, Modeling Plies
and Oriented Selection Sets.

serialize()

Serialize to Python string

6.6.11. SamplingPoint
class compolyx.SamplingPoint(graph, obj, parent=None)

The Sampling Point allows to pick through the laminate at a certain point to run detailed analyses.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 523
The ACP Python Scripting User Interface

Usage
>>> model.create_sampling_point(name='Sampling Point')

aligned()

Returns true if the sampling direction is aligned with the normal direction of the closest element

capture_analysis_plot(path=None, size=800, 600)

Saves the sampling point analysis plot to a file.

Note that this function only works when executed from a GUI, or in batch mode with a hidden
GUI. It does not work in full batch mode.

Parameters

• path: Path of the produced image file.

• size: Pixel size of the plot.

clt_query(query='layup', offset_is_middle=True, consider_coupling_effect=True)

Returns the properties of the classical laminate theory:

Parameters

• query: query parameter (see below)

• offset_is_middle: Whether to offset the reference surface to the mid-plane of the laminate. This
has an influence on the laminate stiffness calculations.

• consider_coupling_effect: Whether to consider the coupling effect or not (B-Matrix). It’s only
of relevance for the laminate engineering constants.

Options

• layup: Returns the layup of the laminate (Modeling, Production and Analysis Plies). Default.

• laminate_properties: Young’s, flexural and shear moduli of the laminate

• polar_properties: E1, E2 and G12 depending on the laminate orientation

• text_labels: Returns a list with the material names, angles and thicknesses

• stiffness_matrix: Returns the laminate stiffness matrix (ABD)

• compliance_matrix: Returns the lamiante compliance matrix (inverse of ABD)

• laminate_forces: Returns a dict with the laminate forces Nx, Ny, Nxy, Mx, My, Mxy, Qx and Qy.
Offset is middle is always true for this evaluation.

Usage:
>>> se.clt_query(query='polar_properties')

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
524 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

consider_coupling_effect

Whether to consider coupling effects (B-Matrix) for the calculation of the laminate engineering
constants. The computation of the ABD matrices is not affected by this parameter.

create_plot(query={'layup': ['mp'], 'polar_properties': ['E1', 'G12']}, offset_is_middle=True, con-

sider_coupling_effect=True)

Generates 2D-plots with the results of interest

Parameters

• query: query parameter

• offset_is_middle: Whether to offset the reference surface to the mid-plane of the laminate. This
has an influence on the laminate stiffness calculations.

• consider_coupling_effect: Whether to consider the coupling effect or not (B-Matrix). It’s only
of relevance for the laminate engineering constants.

Options

• layup:[‘mp’, ‘pp’, ‘ap’] Modeling Plies, Production Plies and Analysis Plies

• polar_properties:[‘E1’,’E2’,’G12’] polar plot of laminate stiffesses

• strains:[‘e1’, ‘e2’, ‘e3’, ‘e12’, ‘e13’, ‘e23’, ‘eI’, ‘eII’, ‘eIII’] - Strain definition name and component

• stresses:[‘s1’, ‘s2’, ‘s3’, ‘s12’, ‘s13’, ‘s23’, ‘sI’, ‘sII’, ‘sIII’] - Stress definition name and component

• failures:[‘FailureCriteria.1_irf’, ‘FailureCriteria.1_rf’, ‘FailureCriteria.1_mos’, ‘FailureCriteria.1_fm’]

- Name of FC and value

• text_labels:[‘material’, ‘angle’, ‘thickness’]

Usage
>>> se.create_plot(query={layup:['mp'], failure:['FailureCriteria.1_irf']}
>>> se.graph_plot.x_values
>>> se.graph_plot.layer_thicknesses

direction

Sampling Point Direction

element_id

Element ID (label) of the Sampling Point

enabled

Whether this object is currently enabled or not. SamplingPoints are always enabled.

graph_plot

Graph Plot object used to configure 2D plots.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 525
The ACP Python Scripting User Interface

locked

Sampling Point is generated from an imported source and cannot be changed.

offset_is_middle

Whether to offset the reference surface to the mid-plane of the laminate.

plies

Plies of the Sampling Point

point

Sampling Point Point

reference_direction

Reference direction

rosette

Rosette of the Sampling Point

solution_set

Solution and Set selection

update_plot(offset_is_middle, consider_coupling_effect)

Updates the 2D plot

Parameters

• offset_is_middle: Whether to offset the reference surface to the mid-plane of the laminate. This
has an influence on the laminate stiffness calculations.

• consider_coupling_effect: Whether to consider the coupling effect or not (B-Matrix). It’s only
of relevance for the laminate engineering constants.

use_default_reference_direction

Flag to use default reference direction

6.6.12. SectionCut
class compolyx.SectionCut(graph, obj, parent=None, color_table=None)

Section Cut Class showing the lay-up in the cutting plane.

active

Whether a section cut is computed on update or not.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
526 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

changed

Status boolean. Set to true if the underlying data has been changed. Write only property

core_scale_factor

Get/set the core scale factor

display_data

Section cut plots

elastic_measures

Cross-sectional Measures of Elasticity

element_labels

Label of elements within ex1 array.

element_nodes

Coincidence list

element_types

Element types within ex1 array.

enabled

Whether this object is currently enabled or not. SectionCuts are always enabled.

export_surface_section_cut(path, format='becas:in', export_strength_limits=True)

Exports the suface section cut to BECAS or ANSYS MAPDL

Paramters

• path: File path or directory depending on the export format.

• format: Export format. Implemented are ‘becas:in’ and ‘ansys:cdb’. ‘becas:in’ is the default.

• export_strength_limits: Boolean whether to export the strength limits for BECAS. True by default.

Usage
>>> section_cut.export_surface_section_cut(r'D:\tmp\section_cut.cdb', 'ansys:cdb', 1.e-3)
>>> section_cut.export_surface_section_cut(path=r'D:\tmp', format='becas:in', export_strength_limits=False)

Output

• mapdl: CDB file including the nodes and elements

• becas: BECAS IN input files: N2D, E2D, EMAT and MATPROPS. Optional FAILMAT.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 527
The ACP Python Scripting User Interface

extrusion_type

Section Cut Types can be: wire_frame,surface_normal,surface_sweep_based

geometric_measures

Cross-sectional Measures of Geometry

in_plane_reference_direction1

Reference direction for cross-sectional measures

in_plane_reference_direction2

Reference direction for cross-sectional measures

intersection_type

Intersection Types can be: normal_to_surface,in_plane

locked

Section cut was imported and cannot be changed.

mass_measures

Cross-sectional Measures of Mass

node_labels

Label of nodes within nx1 array.

nodes

Returns nodes of this mesh as nx3 array.

normal

Get/set the plane normal

number_of_interpolation_points

User-defined number of interpolation points.

origin

Get/set the plane origin

scale_factor

Scale factor used for visualization of section cuts

scope_element_sets

Element Sets to which the Section Cut is scoped. Only used if ‘scope_entire_model’ is False.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
528 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

scope_entire_model

Whether the section cut is scoped to the entire model, or only selected element sets.

search_radius

User-defined search radius.

section_cut_type

Section Cut Types can be: modeling_ply_wise,production_ply_wise,analysis_ply_wise

surface_display_data

Section cut surface plot

surface_mesh

Section cut line surface mesh

tolerance

Tolerance used to generate the surface section cut.

use_default_lut_settings

Boolean whether to use the dault settings of the LookUp Table.

use_default_tolerance

Whether to use the default feature tolerance. 0.1% of the averaged element size.

vtk_element_data

Returns mesh coincidence data in the format needed by VTK.

wireframe_display_data

Section cut wireframe plot

wireframe_mesh

Section cut line wireframe mesh

6.6.13. Sensor
class compolyx.Sensor(graph, obj, parent=None)

Sensor object for meassuring areas, prices, weights, and centers of gravity

active

Whether the sensor is computed on update or not.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 529
The ACP Python Scripting User Interface

add_entity(entity)

Add entity to Sensor

area

Area covered by all Entities of the Sensor

center_of_gravity

Center of Gravity over all Entities of the Sensor

clear_entities()

Clear all entities of this Sensor

enabled

Whether this object is currently enabled or not. Sensors are always enabled.

entities

Entities of the Sensor

locked

Sensor cut was imported and cannot be changed.

modeling_ply_area

Cumulated area of all modeling-plies involved

price

Price over all Entities of the Sensor

production_ply_area

Cumulated area of all production-plies involved

remove_entity(entity)

Remove entity from sensor

sensor_type

Sensor type. Allowed string values: sensor_by_area, sensor_by_plies, sensor_by_material and

sensor_by_solid_model.

weight

Weight over all Entities of the Sensor

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
530 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

6.6.14. PlyBook
This section contains the following topics:
6.6.14.1. PlyBook
6.6.14.2. Chapter

6.6.14.1. PlyBook
class compolyx.PlyBook(name='PlyBook', parent=None, reST_ply='', reST_chapter='',
reST_title_page='', scene=None)

Class to represent a ply book

chapters

Dictionary with all chapters defined.

create_chapter(name, view=None, ply_entities=(), show_rosettes=True)

Add a chapter to the Ply book

Parameters

• name: Name of the chapter to be added

• view: The view for snapshots of the chapter

• ply_entities: List of modeling plies and modeling groups for the chapter

• show_rosettes: If True, show rosettes when creating ply snapshots

generate(filename, format=None, **write_kwargs)

Generate the complete plybook

Parameters

• filename: output filename

• format: pdf, html, odt, txt

reST_chapter

reST chapter template

reST_ply

reST ply template

reST_title_page

reST title page template

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 531
The ACP Python Scripting User Interface

6.6.14.2. Chapter
class compolyx.Chapter(name, parent, view=None, ply_entities=(), id=0, show_rosettes=True)

Class to represent plybook chapter

generate_reST(reST_chapter_template, reST_ply_template, image_provider)

Get the interpolated reST string for the chapter.

get_production_plies()

Return a list of production plies which are associated with this chapter.

ply_entities

Plies/PlyGroups for the chapter

show_rosettes

Show the rosettes linked to a ply in snapshots

6.6.15. PublishedParameter
class compolyx.PublishedParameter(name, parent, source_object=None, source_property='',
user_script='', category='input', acp_type=None, description='', lower_limit=None, upper_limit=None,
cyclic=False, float_list=[], string_list=[], unbound_value=None)

Class to represent parameters which are linked to the ANSYS workbench

acp_type

ACP parameter type. Can be one of: ‘int’, ‘float’, ‘float_list’, ‘bool’, ‘string’ or None

ansys_type

ANSYS parameter type where ACP parameter is mapped to. Can be one of: ‘int’, ‘double’, ‘boolean’,
or None

category

Should be one of: input, unbound_input, output or expression_output

cyclic

Whether a float value is cyclic or not

description

A human-readable description of the linked parameter

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
532 of ANSYS, Inc. and its subsidiaries and affiliates.
 Model Classes

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

float_list

A list of possible values for a float

get_source_str()

Returns the active source string. Either the user script or the property (string) of the ACP object

lower_limit

The lower limit for numeric values

name

Name of object

serialize()

Serialize to Python string

string_list

A list of possible values. List of objects if the property type is object, else list of strings

unit

The unit associated with the actual parameter value

upper_limit

The upper limit for numeric values

value

The actual parameter value

wb_value

The parameter value as it is represented in the ANSYS workbench

6.6.16. Script
class compolyx.Script(name, *, parent=None, source=None, active=True, uptodate=False,
update_mode=<ScriptUpdateMode.ON_TRIGGERS: 'on_triggers'>)

Class to represent user-defined scripts operating on the input parameters.

active

Whether the script should run or not.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 533
The ACP Python Scripting User Interface

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

serialize()

Serialize to Python string

source

Source code of the user-defined script.

status

String status indicating if the object is up-to-date.

status_changed

Specifies if the object has changed, for the purposes of notifying workbench.

update_mode

Defines which changes cause the script to become out-of-date. Can be either ‘manual’ (run only
when manually triggered), ‘on_triggers’ (run when a parameter or the script itself changes), or
‘always’ (run with every update).

uptodate

Whether the script execution is up to date.

6.7. Solid-model Classes

This section contains the following topics:
6.7.1. SolidModel
6.7.2. ExtrusionGuide
6.7.3. SnapToGeometry
6.7.4. CutOffGeometry
6.7.5. SolidElementSet
6.7.6. ImportedSolidModel
6.7.7. LayupMappingObject

6.7.1. SolidModel
class compolyx.SolidModel(graph, obj, parent=None)

Solid Model class

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
534 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solid-model Classes

active

Solid-Model active

add_disable_dropoff_set_on_bottom(set)

Add set where the drop-offs on bottom surface are disabled

add_disable_dropoff_set_on_top(set)

Add set where the drop-offs on top surface are disabled

add_element_set(element_set)

Add Element Set to Solid Model

clear_disable_dropoff_sets_on_bottom()

Clear sets where the drop-offs on bottom are disabled

clear_disable_dropoff_sets_on_top()

Clear sets where the drop-offs on top are disabled

clear_element_sets()

Clear Element Sets of Solid Model

clear_generated_data()

Function clears generated solid model but keeps all definitions.

connect_butt_joined_plies

Do not make drop-offs between butt-joined plies if set to True

copy_extrusion_guide(source)

Copy a Extrusion Guide

Parameters

• source: Source object to copy

Returns

New instance of a Extrusion Guide

copy_snap_to_geometry_obj(source)

Copy a Snap-To Geometry

Parameters

• source: Source object to copy

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 535
The ACP Python Scripting User Interface

Returns

New instance of a Snap-To Geometry

create_extrusion_guide(name, edge_set=None, id='', cad_geometry=None, direction=0.0, 0.0,

0.0, radius=None, depth=1.0, use_curvature_correction=False, active=True)

Create a new extrusion guide

Parameters

• name : the name of the extrusion guide

• edge_set : an edge set where this guide applies

• id : the id of the extrusion guide

• cad_geometry : a cad geometry object

• direction: Extrusion direction

• radius

distance up to which node translations due to the guide will be propagated through the
mesh

0.0 : only the nodes extruded from edge_set will be shifted onto the guide

• depth

intensity for the propagation of mesh corrections

1.0 : linear decay from guide to radius >1.0 : higher reach <1.0 : more local

• use_curvature_correction : whether to use curvature correction algorithm to smooth mesh ad-

apted to extrusion guide. Default is False

create_snap_to_geometry_obj(name, cad_geometry=None, oriented_selection_set=None, ori-

entation='top', active=True, id='')

Create a new snap-to-geometry object

Parameters

• name : the name of the object

• id : the id of the object

• active : pass the active-flag of the object

• cad_geometry : a geometry to snap to

• oriented_selection_set : oriented element set where this snap to applies

• orientation : “top” or “bottom”

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
536 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solid-model Classes

disable_dropoff_sets_on_bottom

Elements where the drop-offs on bottom are disabled.

disable_dropoff_sets_on_top

Elements of where the drop-offs on top are disabled.

disable_dropoffs_on_bottom

Boolean whether to disable the drop-off elements on bottom surface.

disable_dropoffs_on_top

Boolean whether to disable the drop-off elements on top surface.

drop_off_type

Drop-off type. Allowed string values: [‘inside_ply’, ‘outside_ply’]

element_sets

Element Set(s) of the solid model.

enabled

Whether this object is currently enabled or not. Solid Models are are enabled in pre and shared
mode.

ex_type

Extrusion type. Allowed string values: [‘monolithic’, ‘analysis_ply_wise’, ‘production_ply_wise’,

‘modeling_ply_wise’, ‘sandwich_wise’, ‘specify_thickness’, ‘material_wise’, ‘user_defined’]

extrusion_guides

Extrusion Guides

global_drop_off_material

Global material of the drop-off elements.

max_thickness

Maximum thickness of solid elements.

offset_type

Offset type. Allowed string values: [‘shell_normal’, ‘surface_normal’]

ply_group_pointers

Ply group pointers for user defined extrusion.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 537
The ACP Python Scripting User Interface

remove_element_set(element_set)

Remove Element Set from the solid model

reorder_extrusion_guides(source, target, option='after')

Reorders the extrusion guides

Parameters

• source: Extrusion guide to be reordered.

• target: Place to put the source.

• option: Can be ‘after’ or ‘before’. Defines if the source is put before or after the target.

Usage
>>> sm.reorder_extrusion_guides(source = sm.extrusion_guides['wall'], target=sm.extrusion_guides['leading_edg

snap_to_geometry_objs

Snap to Geometry objects

6.7.2. ExtrusionGuide
class compolyx.ExtrusionGuide(obj, parent=None)

Extrusion guide class

active

Extrusion Guide active

cad_geometry

Associated CADGeometry.

depth

intensity for the propagation of mesh corrections, depth=1 leads to a linear decay from the guide
to the radius, depth<1 leads to more local corrections

direction

extrusion direction

edge_set

Associated EdgeSet.

enabled

Whether this object is currently enabled or not. It’s derived from the parent solid model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
538 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solid-model Classes

radius

radius up to which nodal guide translations are propagated through the mesh

use_curvature_correction

whether to use curvature correction algorithm to smooth mesh adapted to extrusion guide. Default
is False

6.7.3. SnapToGeometry
class compolyx.SnapToGeometry(obj, parent)

SnapToGeometry guide class

active

Snap-To Geometry active

cad_geometry

Associated Geometry.

elements

List of affected shell elements

enabled

Whether this object is currently enabled or not. It’s derived from the parent solid model.

orientation

Orientation. Allowed string values: [‘top’, ‘bottom’, ‘undefined’]

6.7.4. CutOffGeometry
class compolyx.CutOffGeometry(obj, parent=None)

CutOffGeometry guide class

active

Cut-Off Geometry active

cad_geometry

Associated CADGeometry.

enabled

Whether this object is currently enabled or not. It’s derived from the parent solid model.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 539
The ACP Python Scripting User Interface

orientation

Orientation. Allowed string values: [‘up’, ‘down’]

rel_merge_tolerance

Relative Merge Tolerance

6.7.5. SolidElementSet
class compolyx.SolidElementSet(graph, obj=None, parent=None)

Solid element set class Element Set of a solid model

element_labels

List of solid elements which are linked to this element set.

locked

Returns true if the object is locked (nor editable, neither deletable)

serialize()

Serialize to Python string

size

Number of entities

6.7.6. ImportedSolidModel
class compolyx.ImportedSolidModel(graph, obj, parent=None)

Imported Solid Model class

clear_generated_data()

Function clears generated solid model but keeps all definitions.

copy_layup_mapping_object(source)

Copy a Lay-up Mapping Object

Parameters

• source: Source object to copy

Returns

New instance of LayupMappingObject

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
540 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solid-model Classes

create_layup_mapping_object(name='', id='', active=True, entire_solid_mesh=True, solid_ele-

ment_sets=[], element_sets=None, delete_lost_elements=True, rosette_selection_method_type='min-
imum_distance', base_element_rosette_selection_method_type='minimum_distance', element_tech-
nology='layered_element', scale_ply_thicknesses=True, all_plies=True, use_imported_plies=False,
sequences=[], rosettes=[], base_element_rosettes=[], minimum_void_material_thickness=- 1.0,
void_material=None, filler_material=None, base_material=None, base_element_material_hand-
ling='remove', reinforcing_stress_state='plane_stress_state_with_transverse_shear_and_bending_stiff-
ness', reinforcing_behavior='tension_and_compression')

Create a new lay-up mapping object

Parameters

• name: The name of the Solid Model

• id: The id of the Solid Model

• active : Active status of lay-up mapping object

• entire_solid_mesh : If true, then the scope is all solid elements

• solid_element_sets: Defines the scope of solid elements if entire_solid_mesh is False

• element_sets: a list of Element Sets of the reference surface. Used to extract the plies.

• filler_material : Global filler material which is assigned to the elements without any layers

• delete_lost_elements : If enabled, then all elements which do not intersect with the lay-up are
deleted.

• rosette_selection_method_type : Defines how the coordinate systems are applied to the filler/lost
elements. Used if the element technology is layered_element.

• base_element_rosette_selection_method_type : Defines how the coordinate systems are applied

to the base solid elements. Used if the element technology is reinforcing.

• element_technology: Specifies the element technology of this mapping (layered elements or

reinforcings)

• scale_ply_thicknesses : Scale plies within layered solid element if they do not fill the entire
element, else add void layers

• all_plies : Whether all plies of the selected scope (element_sets) should be mapped or only
specific sequences

• use_imported_plies: If selected, Imported Ply objects can be used for the mapping. Else standard
Modeling Plies.

• sequences : List of Modeling Groups and/or Modeling Plies which are mapped onto the element
scope

• rosettes : List of rosettes used to orient the lost elements. Used if the element technology is
layered_element.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 541
The ACP Python Scripting User Interface

• base_element_rosettes : List of coordinate systems used to orient the base solid elements. Used
if the element technology is reinforcing.

• minimum_void_material_thickness : Specifies the minimum thickness of void layers. Default is

equal to the minimum analysis ply thickness of the model.

• void_material : Global void material which is assigned to layered elements that are not fully
filled with ply material

• base_material: Specify the base material of the solids if reinforcing are used

• base_element_material_handling: Whether to remove the base material of the solids where

the reinforcing intersect, or keep it.

• reinforcing_stress_state: Specify the stress state of the reinforcing.

• reinforcing_behavior: Select the mechanical behavior of the reinforcing.

Returns

The created Layup Mapping Object

Note

• Base solid elements are the solid elements of a Lay-up Mapping object of type reinforcing which
are intersected with the reinforcing surfaces.

create_solid_element_set(name, id='', locked=False)

For internal use only: Creates a Solid Element Set

enabled

Whether this object is currently enabled or not. Solid Models are are enabled in pre and shared
mode.

ext_id

Id of corresponding Mechanical Model within WB arhcive (ComponentID).

external_file_path

The file path where the CAD geometry is loaded from.

format

File format of the imported mesh

has_reinforcing_objects()

Boolean whether Lay-up Mapping Objects of type reinforcing are present.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
542 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solid-model Classes

import_initial_mesh()

Import the solid mesh without updating the lay-up mapping. Nothing is done if the mesh was
already loaded

layup_mapping_objects

Objects which define the scoping and details of each mapping step.

mapping_statistics()

Returns the statistics of the layup mapping (number of elements, volumes, mass etc.)

refresh_external_source(enforce=False)

Reloads the mesh from the external source.

Parameters

• enforce: enforce the reloading of external data for locked object in the new acph5 serialization
format. This option should be used with care!

serialize()

Returns the Python serialization string

unit_system

Unit system type of the imported mesh. Allowed string values are undefined, si, mks, umks, cgs,
mpa, bft, bin

update_mapping_statistics()

Computes the mapping statistics per ply to compare the original lay-up with the mapped data.
Use imported_solid_model.mapping_statistics() to retrieve the results

6.7.7. LayupMappingObject
class compolyx.LayupMappingObject(graph, obj, parent=None)

Layup Mapping class

active

Boolean whether to this object is active or not.

all_plies

Boolean whether all plies of the selected scope should be mapped or a user-defined subset.

analysis_plies

Analysis Plies of the Mapping Object

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 543
The ACP Python Scripting User Interface

base_element_material_handling

Whether the base-element material is removed or kept. Allowed string values: [‘retain’, ‘remove’]

base_element_rosette_selection_method_type

Selection method of the coordinate systems for the base elements. Allowed string values: [‘min-
imum_distance’, ‘minimum_distance_superposed’]

base_element_rosettes

List of rosettes used to orient the lost elements

base_material

Material of base-element if reinforcing is used.

delete_lost_elements

Boolean whether to delete solid elements without layup data.

element_sets

Element Set(s) of the solid model.

element_technology

Defines the element technology. Allowed string values: [‘layered_element’, ‘reinforcing’]

enabled

Whether this object is currently enabled or not. Solid Models are are enabled in pre and shared
mode.

entire_solid_mesh

Boolean whether the mapping object is applied to the entire solid mesh.

filler_material

Filler material if layered elements are used.

minimum_void_material_thickness

Minimum thickness of the void layer!

reinforcing_behavior

Whether the reinforcing carries load and/or tension. Allowed string values: [‘tension_and_com-
pression’, ‘tension_only’, ‘compression_only’]

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
544 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solution Classes

reinforcing_stress_state

Defines which FE elements are used. Allowed string values: [‘uniaxial_stress_state’,

‘plane_stress_state’, ‘plane_stress_state_with_transverse_shear_stiffness’,
‘plane_stress_state_with_transverse_shear_and_bending_stiffness’]

rosette_selection_method_type

Selection method of the coordinate systems for the filler/lost elements. Allowed string values:
[‘minimum_distance’, ‘minimum_distance_superposed’]

rosettes

List of rosettes used to orient the lost elements

scale_ply_thicknesses

Boolean whether to scale the layer thicknesses or to add void layers to fill voids.

sequences

User-defined sequence entities to map.

solid_element_sets

List of element sets of the solid mesh onto which the mapping is applied to

use_imported_plies

Boolean whether to map imported plies.

void_material

Global void material.

6.8. Solution Classes

This section contains the following topics:
6.8.1. Solution
6.8.2. EnvelopeSolution

6.8.1. Solution
class compolyx.Solution(obj, parent=None)

Class to compute postprocessings of a finite element solution.

Access:
>>> import compolyx
>>> db = compolyx.DB()
>>> model = db.models['class40.1']
>>> sol = db.models['class40.1'].add_solution(name='class40.1', path='class40.rst', format='ansys:rst')

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 545
The ACP Python Scripting User Interface

ID

Id to be displayed in Envelope solution

active

Activate or deactivate solution

clear()

Clear all result data

clear_element_results()

Resets the post-processing results for each layered element

clear_failure_criteria_results()

Resets the failure criteria results for each layered element

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

export_results_to_csv(definition=None, entities=[], file_path=None, solution_set=- 1,

solids=False, spot='all')

Exports the shell results of the selected entities to a csv file.

Parameters

• definitions: Selected definition - CombinedFailure Criteria object or as string ‘deformations’,

‘strains’ or ‘stresses’

• entities: Defines the selection for the export. Can be a list of ElementSets, AnalysisPlies or
SolidModels

• file_path: File name

• solution_set: Solution Set for which data is requested

• solids: Boolean whether to take the results of the solid elements or not. Default is False (results
of shells).

• spots: Layer positions for which the results are exported. Allowed are ‘bot’, ‘mid’, ‘top’, ‘bot/top’,
and ‘all’.

Export results of solid models: Select the element set which is selected in the extrusion settings.

Usage
>>> model = db.active_model
>>> model.solutions['Solution.1'].export_results_to_csv( definition='stresses', entities=[model.element_sets[

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
546 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solution Classes

ext_id

Id of corresponding Solution in external solution (ComponentID).

format

File format string. Choose one of ‘abaqus:inp’,’ansys:cdb’ or ‘nastran:f06’

has_element_temperatures

Boolean flag if element nodal temperatures are read from the rst file.

has_progressive_damage

Boolean flag if progressive_damage data are read from the rst file.

load()

Load result data from file

load_factor

Optional load factor within substep of non-linear solution where the nodal solution should be
taken from. Only valid for ‘nastran:f06’ format. Becomes (False,0) if not defined.

path

Path to the data file

path2

Path to the data file

plots

Container with PostProcessing Plots

query(definition, options={'eval_ins': False}, position='centroid', selection='all', entity=None, entit-

ies=None, spot=None, component=None, rosette=None, simulate=False, solution_set=- 1)

Query results from the solution

Parameters

• definition

The postproc definition defines what results are evaluated. Can be given as

CombinedFailureCriteria object or as string such as ‘strains’, ‘stresses’, ‘laminate_forces’,

‘deformations’, ‘temperatures’ or ‘progressive_damage’.

• options

Dict with the additional options used to fully configure the definition.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 547
The ACP Python Scripting User Interface

– stresses: options={“eval_ins”:True} to enable the interlaminar normal stress evaluation for

shells

• position

Position where data is queried:

– nodal, centroid, element_nodal, integration_point or element_results

• selection

The selection set determines the selected nodes and elements.

Can be given as string ‘sel0’ - ‘sel5’ or ‘all’ or can be given as ObjectSelection object such
as model.selection or scene.active_set

• entity

Entity for which results are evaluated.

Currently supported: Analysis ply or analysis ply vertex

• entities : If a list of entities is given, the query will also compute and return a list of results, with
one array for each entity.

• spot: Used to identify bot, mid or top when querying layered shells

• component: Components to query. Valid components for

– DEFORMATION - x, y, z, usum, rotx, roty, rotz -> (nx1) - all -> (nx6), translations, rotations
-> (nx3)

– STRAIN - e1, e2, e3, e12, e23, e13, eI, eII, eII, von_mises -> (nx1) - all -> (nx6), principals
-> (nx3)

– STRESS - s1, s2, s3, s12, s23, s13, sI, sII, sII -> (nx1) - all -> (nx6), principals -> (nx3)

– FAILURE CRITERIA - irf (Inverse reserve factor), rf (Reserve factor), mos (Margin of safety)
-> (nx1) - fm (Failure mode) ->(n x string(size<=4)) - li (Layer index) ->(n x 1) (Only available
for element queries where no entity is given.)

– LAMINATE FORCES - all -> (nx8)

– PROGRESSIVE DAMAGE - status (damage status), ft, fc (fiber tensile/compressive) ->(nx1)

- mt, mc (matrix tensile/compressive), s (shear) ->(nx1) - sed (energy dissipated per unit
volume), sedv (energy per unit volume due to viscous damping) ->(nx1)

• rosette : If a rosette is given, the results are evaluated with respect to this coordinate system
(not recommended for non-linear results)

• simulate

Whether the query is only simulated to test if it will return data.

If this flag is set the query(…) function will only return 0 or 1.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
548 of ANSYS, Inc. and its subsidiaries and affiliates.
 Solution Classes

• solution_set : Identifier of the queried solution. -1 identifies the last available Set.

Usage
>>> solution.query(definition='laminate_forces',position='centroid',selection='sel0',component='all',rosette=
>>> solution.query(definition=model.defintions['FailureCriteria'], position='centroid', selection='sel0', com
>>> solution.query(definition='stresses', position='element_results', selection='sel0', component='s3',soluti

read_stresses_strains

True if the stresses and strains are to be read from rst file. Only valid for ‘ansys:rst’ format.

recompute_iss_of_solids

Use laminate-based computation method to recalculate the interlaminar shear stress distribution.

renumbering_mapping_paths

Path of the assembly renumbering files.

serialize()

Serialize to Python string

set

Result set to be read. Only valid for ‘ansys:rst’ format.

solution_dict

The time or frequency dictionary used in the solution plots GUI.

subcase

Optional subcase to read. Only valid for ‘nastran:f06’ format. Becomes (False,0) if not defined.

time_or_frequency

The time or frequency associated with the active set.

use_felyx_to_compute_pp_results

True if the stresses and strains are to be computed by felyx. If the stresses and strains are read
from rst file, nothing is computed.

use_solid_results

Allows to visualize the post-processing results of layered solid models on the ‘Layered Solid Ref-
erence Surface’.

6.8.2. EnvelopeSolution
class compolyx.EnvelopeSolution(graph, obj, parent=None)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 549
The ACP Python Scripting User Interface

add_solution_set(solution, sset=- 1)

Add solution set to solution sets of Envelope Solution

Parameters

• solution: Solution object

• sset: Solution set (default: -1)

clear_solution_sets()

Clear Solution Sets of Envelope Solution

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

remove_solution_set(solution, sset=- 1)

Remove solution set from solution sets of Envelope Solution

Parameters

• solution: Solution object

• sset: Solution set (default: -1)

6.9. Scene Classes

This section contains the following topics:
6.9.1. Scene
6.9.2. View

6.9.1. Scene
class compolyx.Scene(graph, model=None, name='', id=None, title='', view=None, parent=None,
active_set=None)

Class to represent Scene

active_set

Set of active entities

background

Background color

background2

Background color 2

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
550 of ANSYS, Inc. and its subsidiaries and affiliates.
 Scene Classes

camera

Camera settings

changed

Status boolean. Set to true if the underlying data has been changed. Write only property

descriptions_changed

Set to True if descriptions should be updated.

fit_to_window

Reset the zoom of the window

foreground

Foreground color

logo_type

Logo type: default or black

mode

Current ACP mode (pre or post).

projection

Projection method: ‘parallel’ or ‘perspective’

save_snapshot(path, width=None, height=None, draw_background=False)

Create a snapshot of the scene

Parameters

• path: File path

• width: Width in pixels of the snapshot

• height: Height in pixels of the snapshot

• draw_background: Boolean whether to draw the background or not. If false, the background
is white.

scale_factor

Scale factor of the deformed mesh.

serialize()

Serialize to Python string

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 551
The ACP Python Scripting User Interface

show_element_type

Highlight “shell” or “solid” elements, or use “automatic” to select solid elements if the object be-
longs to a solid model.Note: Only analysis plies have solid elements. Shell elements are highlighted
for modeling and production plies.

show_global_coordinate_system

Toggle visibility of global coordinate system marker

show_labeled_bounding_box

Toggle visibility of labeled bounding box

show_selected_mesh

Specify whether to show/highlight currently selected Elements

show_silhouette

Whether to show the silhouette of currently selected elements

status

Status of the object

title

Scene title

update_direction_display_data(entities)

Function syncronizes the following direction plots with the added/removed entities given: - “ori-
entations” - “ref_directions” - “fiber_directions” - “draped_fiber_directions”

uptodate

Apply a view to the scene. Write only

view

Apply a view to the scene.

6.9.2. View
class compolyx.View(name, position=0.0, 0.0, 0.0, orientation=0.0, 0.0, 0.0, rotation_point=0.0,
0.0, 0.0, parallel_scale=1.0, projection='perspective', locked=False, parent=None)

ComPoLyX class to capture view properties.

Access:
>>> import compolyx
>>> db = compolyx.DB()
>>> view1 = db.create_view(name='View.1', position=[1.5, 5.75, 7.], orientation=[-0.4, -0.4, 0.8], rotation_point=

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
552 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing Definition Classes

locked

A View which is imported from an other source can not be modified.

orientation

Get/set the view orientation

parallel_scale

Get/set the view parallel perspective scale factor.

position

Get/set the view position

projection

Get/set the projection method parallel or perspective

rotation_point

Get/set the view rotation point.

serialize()

Serialize to Python string

6.10. Postprocessing Definition Classes

This section contains the following topics:
6.10.1. CombinedFailureCriteria

6.10.1. CombinedFailureCriteria
This section contains the following topics:
6.10.1.1. MaxStressCriterion
6.10.1.2. MaxStrainCriterion
6.10.1.3.TsaiWu
6.10.1.4.TsaiHill
6.10.1.5. Hashin
6.10.1.6. Hoffman
6.10.1.7. Puck
6.10.1.8. Wrinkling
6.10.1.9. CoreShear
6.10.1.10. Larc
6.10.1.11. Cuntze
6.10.1.12. VonMises

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 553
The ACP Python Scripting User Interface

6.10.1.13. ShearCrimping

class compolyx.CombinedFailureCriteria(graph, obj, failure_criteria=[], parent=None)

CombinedFailureCriteria class

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

serialize()

Serialize to Python string

6.10.1.1. MaxStressCriterion
class compolyx.MaxStressCriterion(s1=1, s2=1, s3=0, s12=1, s13=0, s23=0, wf_s1=1.0,
wf_s2=1.0, wf_s3=1.0, wf_s12=1.0, wf_s13=1.0, wf_s23=1.0)

Max stress failure criterion configuration Properties are s1, s2, s3, s12, s13, s23, wf_s1, wf_s2, wf_s3,
wf_s12, wf_s13, wf_s23 e.g. MaxStressCriterion(s1=1, s2=1, s3=0, s12=1, s13=0, s23=0, wf_s1=1,
wf_s2=1, wf_s3=1, wf_s12=1, wf_s13=1, wf_s23=1)

s1

specifies whether to compute max stress in 1 direction

s12

specifies whether to compute max shear stress in 1 direction

s13

specifies whether to compute max normal stress in 1 direction

s2

specifies whether to compute max stress in 2 direction

s23

specifies whether to compute max normal stress in 2 direction

s3

specifies whether to compute max stress in 3 direction

serialize()

Serialize to Python string

wf_s1

weighting factor of s1

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
554 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing Definition Classes

wf_s12

weighting factor of s12

wf_s13

weighting factor of s13

wf_s2

weighting factor of s2

wf_s23

weighting factor of s23

wf_s3

weighting factor of s3

6.10.1.2. MaxStrainCriterion
class compolyx.MaxStrainCriterion(e1=1, e2=1, e3=0, e12=1, e13=0, e23=0, wf_e1=1.0,
wf_e2=1.0, wf_e3=1.0, wf_e12=1.0, wf_e13=1.0, wf_e23=1.0, eXt=0.0, eXc=0.0, eYt=0.0, eYc=0.0,
eZt=0.0, eZc=0.0, eSxy=0.0, eSxz=0.0, eSyz=0.0, force_global_strain_limits=False)

Max strain failure criterion configuration

e1

specifies whether to compute max strain in 1 direction

e12

specifies whether to compute max shear 12 strain

e13

specifies whether to compute max shear 13 strain

e2

specifies whether to compute max strain in 2 direction

e23

specifies whether to compute max shear 23 strain

e3

specifies whether to compute max strain in 3 direction

eSxy

global limit shear strain in material 12 direction

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 555
The ACP Python Scripting User Interface

eSxz

global limit shear strain in material 13 direction

eSyz

global limit shear strain in material 23 direction

eXc

global limit compression strain in material 1 direction

eXt

global limit tension strain in material 1 direction

eYc

global limit compression strain in material 2 direction

eYt

global limit tension strain in material 2 direction

eZc

global limit compression strain in material 3 direction

eZt

global limit tension strain in material 3 direction

force_global_strain_limits

force to use global strain limits

serialize()

Serialize to Python string

wf_e1

weighting factor of e1

wf_e12

weighting factor of e12

wf_e13

weighting factor of e13

wf_e2

weighting factor of e2

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
556 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing Definition Classes

wf_e23

weighting factor of e23

wf_e3

weighting factor of e3

6.10.1.3. TsaiWu
class compolyx.TsaiWu(dim=2, wf=1.0)

Tsai Wu failure criterion configuration

dim

dimension of the Tsai-Wu failure criterion (2 or 3)

serialize()

Serialize to Python string

wf

weighting factor

6.10.1.4. TsaiHill
class compolyx.TsaiHill(dim=2, wf=1.0)

Tsai Hill failure criterion configuration

dim

dimension of the Tsai-Hill failure criterion (2 or 3)

serialize()

Serialize to Python string

wf

weighting factor

6.10.1.5. Hashin
class compolyx.Hashin(dim=2, hf=1, hm=1, hd=1, wf_hf=1.0, wf_hm=1.0, wf_hd=1.0)

Hashin failure criterion configuration

dim

dimension of the Hashin failure criterion (2 or 3)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 557
The ACP Python Scripting User Interface

hd

specifies whether to compute delamination

hf

specifies whether to compute fiber failure

hm

specifies whether to compute matrix failure

serialize()

Serialize to Python string

wf_hd

weighting factor

wf_hf

weighting factor

wf_hm

weighting factor

6.10.1.6. Hoffman
class compolyx.Hoffman(dim=2, wf=1.0)

Hoffman failure criterion configuration

dim

dimension of the Hoffman failure criterion (2 or 3)

serialize()

Serialize to Python string

wf

weighting factor

6.10.1.7. Puck
class compolyx.Puck(dim=2, force_global_constants=False, p21_pos=0.325, p21_neg=0.275,
p22_neg=0.225, p22_pos=0.225, s=0.5, M=0.5, interface_weakening_factor=0.8, pf=1, pmA=1,
pmB=1, pmC=1, pd=1, wf_pf=1.0, wf_pmA=1.0, wf_pmB=1.0, wf_pmC=1.0, wf_pd=1.0, cfps=True)

Puck failure criterion configuration

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
558 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing Definition Classes

Degradation factor (Default=0.5)

cfps

specifies whether to consider the influence of fiber parallel stresses on inter-fiber failure

dim

dimension of the puck failure criterion (1, 2 or 3)

force_global_constants

Use global Puck constants instead of material specific values.

interface_weakening_factor

Interface weakening factor (Default=0.8)

p21_neg

Inclination of the failure curve for negative normal matrix stresses (Default=0.275)

p21_pos

Inclination of the failure curve for positive normal matrix stresses (Default=0.325)

p22_neg

Inclination of the failure curve for negative normal matrix stresses (Default=0.225)

p22_pos

Inclination of the failure curve for positive normal matrix stresses (Default=0.225)

pd

specifies whether to compute delamination

pf

specifies whether to compute fiber failure

pmA

specifies whether to compute matrix tension failure

pmB

specifies whether to compute matrix compression failure

pmC

specifies whether to compute matrix shear failure

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 559
The ACP Python Scripting User Interface

Degradation factor (Default=0.5)

serialize()

Serialize to Python string

wf_pd

weighting factor

wf_pf

weighting factor

wf_pmA

weighting factor

wf_pmB

weighting factor

wf_pmC

weighting factor

6.10.1.8. Wrinkling
class compolyx.Wrinkling(q_homogeneous=0.5, q_honeycomb=0.33, wf_wr=1.0)

Configuration of wrinkling failure criterion for sandwich structures

q_homogeneous

Wrinkling coefficient for sandwiches with homogeneous core. Default=0.5

q_honeycomb

Wrinkling coefficient for sandwiches with honeycomb core. Default=0.33

serialize()

Serialize to Python string

wf_wr

weighting factor

6.10.1.9. CoreShear
class compolyx.CoreShear(ins=False, iss=True, wf_cs=1.0)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
560 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing Definition Classes

Configuration of core shear failure criterion for sandwich structures

ins

Whether to compute sandwich core shear criterion under consideration of interlaminar normal
stresses. Default = False

iss

Whether to compute sandwich core shear criterion under consideration of interlaminar shear
stresses. Default = True

serialize()

Serialize to Python string

wf_cs

weighting factor

6.10.1.10. Larc
class compolyx.Larc(dim=2, lft=1, lfc=1, lmt=1, lmc=1, wf_lft=1.0, wf_lfc=1.0, wf_lmt=1.0,
wf_lmc=1.0)

LaRC failure criterion configuration

dim

dimension of the LARC failure criterion (2 or 3)

lfc

specifies whether to compute fiber compression failure

lft

specifies whether to compute fiber tension failure

lmc

specifies whether to compute matrix compression failure

lmt

specifies whether to compute matrix tension failure

serialize()

Serialize to Python string

wf_lfc

weighting factor for lfc

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 561
The ACP Python Scripting User Interface

wf_lft

weighting factor for lft

wf_lmc

weighting factor for lmc

wf_lmt

weighting factor for lmt

6.10.1.11. Cuntze
class compolyx.Cuntze(dim=2, cft=1, cfc=1, cmA=1, cmB=1, cmC=1, wf_cft=1.0, wf_cfc=1.0,
wf_cmA=1.0, wf_cmB=1.0, wf_cmC=1.0, b21=0.2, b32=1.38, fracture_plane_angle=53.0, m=2.6)

Puck failure criterion configuration

b21

In-plane shear related friction parameter (between 0.1 and 0.6, default=0.2)

b32

Out-of-plane shear related friction parameter (between 1.0 and 1.6, default=1.38)

cfc

specifies whether to compute fiber compression failure

cft

specifies whether to compute fiber tensile failure

cmA

specifies whether to compute matrix tension failure

cmB

specifies whether to compute matrix compression failure

cmC

specifies whether to compute matrix wedge shape failure

dim

dimension of the cuntze failure criterion (2 or 3)

fracture_plane_angle

Angle between the out-of-plane axis and fracture plane in degree (> 45), default=53.)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
562 of ANSYS, Inc. and its subsidiaries and affiliates.
 Postprocessing Definition Classes

Mode interaction coefficient (between [2.0,4.0], default=2.6)

serialize()

Serialize to Python string

wf_cfc

weighting factor

wf_cft

weighting factor

wf_cmA

weighting factor

wf_cmB

weighting factor

wf_cmC

weighting factor

6.10.1.12. VonMises
class compolyx.VonMises(vme=1, vms=1, iss=1, ins=0, wf_vme=1.0, wf_vms=1.0)

Von Mises failure criterion configuration

ins

specifies wether to compute interlaminar normal stresses

iss

specifies wether to compute interlaminar shear stresses

serialize()

Serialize to Python string

vme

specifies whether to compute von mises strain criteria

vms

specifies whether to compute von mises stress criteria

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 563
The ACP Python Scripting User Interface

wf_vme

weighting factor

wf_vms

weighting factor

6.10.1.13. ShearCrimping
class compolyx.ShearCrimping(kc=1.0, kf=0.0, wf_sc=1.0)

Configuration of core shear failure criterion for sandwich structures

kc

Core material factor. Default is 1.

kf

Face sheet factor. Default is 0.

serialize()

Serialize to Python string

wf_sc

weighting factor

6.11. Plot Classes

This section contains the following topics:
6.11.1. PlotContainer Classes
6.11.2. PlotData Classes

6.11.1. PlotContainer Classes

This section contains the following topics:
6.11.1.1. PlotDataDict Class
6.11.1.2. LayupPlotDict Class
6.11.1.3. PostProcessingPlotDict Class

6.11.1.1. PlotDataDict Class

class compolyx.plot_data.PlotDataDict(name, label=None, obj=None, list=[],
item_type=<class 'object'>, parent=None, key_attr='name')

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
564 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

copy_plot(source)

Copy a plot object.

Parameters

• source: Plot object to be copied.

Returns

Object of the plot duplicate.

Examples:

Make a copy of the thickness plot “My_Thickness_Plot”:

>>> plot_copy = db.active_model.layup_plots.copy_plot( db.active_model.layup_plots['My_Thickness_Plot']

6.11.1.2. LayupPlotDict Class

class compolyx.plot_data.LayupPlotDict(name, label=None, obj=None, list=[],
item_type=<class 'object'>, parent=None, key_attr='name')

Container for Layup Plots

create_angle_plot(name=None, id=None, scope_entire_model=True, data_scope=[],

show_on_solids=False, show_on_section_cuts=True, show_ply_offsets=False, ply_off-
set_scale_factor=1.0, component=None, add_to_active_set=True, locked=False)

Create a Angle Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned

Applicable are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_on_section_cuts: Whether to show the results on the surface section cuts as well. Default
is True.

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 565
The ACP Python Scripting User Interface

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

Returns

the plot object

Example:

Create a angle plot with Data Scope set to Element Set “All_Elements”:
>>> angle_plot = db.active_model.layup_plots.create_angle_plot(self, name="MyPlot", data_scope=db.activ

create_draping_plot(name=None, id=None, show_flatwrap=True, show_draping_mesh=True,

add_to_active_set=True, locked=False)

Create a Draping Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

Returns

the plot object

Example:

Create a draping plot with Data Scope set to Element Set “All_Elements”:
>>> draping_plot = db.active_model.layup_plots.create_draping_plot(self, name="MyPlot")

create_field_definition_plot(name=None, id=None, scope_entire_model=True,

data_scope=[], field_variable_name=None, show_on_solids=False, add_to_active_set=True,
locked=False)

Create a FieldDefinition Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
566 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

Returns

the plot object

Example:

Create a field definition plot for field degradation with Data Scope set to Element Set
“All_Elements” in ply_wise mode:
>>> field_plot = db.active_model.layup_plots.create_field_definition_plot(self, name="MyPlot", field_va

create_layup_mapping_plot(name=None, id=None, data_scope=[], ply_wise=True,

add_to_active_set=True, locked=False, component=None, show_on_solids=True, active=True)

Create a Layup Mapping Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Imported Solid Model

• ply_wise: True or False (default). Decides whether to return the thickness of the individual
plies or of the whole stack of plies present at an element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• component: Specifies the active component

• show_on_solids: Whether to show the values of the solid element or not

• active: Whether the plot is active or not

Returns

the plot object

Example:

Create a thickness plot with Data Scope set to Element Set “All_Elements” in ply_wise mode:
>>> thick_plot = db.active_model.layup_plots.create_layup_mapping_plot(self, name="MyPlot", data_scope=

create_material_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], show_on_solids=False, show_ply_offsets=False, ply_offset_scale_factor=1.0,
add_to_active_set=True, locked=False, component='E1', use_all_available_fields=True,
field_variable_names=[], shear_angle_enabled=False, temperature_enabled=False)

Create a Material Plot object.

Parameters

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 567
The ACP Python Scripting User Interface

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• component: Specifies the component.

• use_all_available_fields: True (default) or False. Whether to enable all available field variables
in the evaluation or not.

Returns

the plot object

Example:

Create a material plot with Data Scope set to Element Set “All_Elements” showing the Young
Modulus E2:
>>> E2_plot = db.active_model.layup_plots.create_material_plot(name="E2_Plot", data_scope=[db.active_mo

create_scalar_field_plot(name=None, id=None, scope_entire_model=True, data_scope=[],

scalar_field=None, show_supporting_points=False, show_supporting_point_labels=False, support-
ing_point_scale_factor=1.0, show_on_solids=False, show_ply_offsets=False, ply_off-
set_scale_factor=1.0, add_to_active_set=True, locked=False)

Create a Field Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
568 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

• ply_wise: True or False (default). Decides whether to return the field values of the individual
plies or of the whole stack of plies present at an element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

Returns

the plot object

Example:

Create a field plot with Data Scope set to Element Set “All_Elements” in ply_wise mode::
tbdtbdtbd

create_thickness_plot(name=None, id=None, scope_entire_model=True, data_scope=[],

ply_wise=False, show_on_solids=False, show_ply_offsets=False, ply_offset_scale_factor=1.0,
add_to_active_set=True, locked=False, component='thickness')

Create a Thickness Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• ply_wise: True or False (default). Decides whether to return the thickness of the individual
plies or of the whole stack of plies present at an element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• component: Specifies the component

Returns

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 569
The ACP Python Scripting User Interface

the plot object

Example:

Create a thickness plot with Data Scope set to Element Set “All_Elements” in ply_wise mode:
>>> thick_plot = db.active_model.layup_plots.create_thickness_plot(self, name="MyPlot", data_scope=db.a

create_user_defined_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], user_data=[], user_text=[], user_script=None, user_script_enabled=False,
show_on_solids=False, show_user_text=False, text_threshold=0.0, text_threshold_type='show_all',
show_ply_offsets=False, ply_offset_scale_factor=1.0, add_to_active_set=True, locked=False)

Create a User-defined Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• user_data: Retrieve or provide the user data, which must obey the order of the user_ele-
ment_indices or user_element_labels, respectively.

• user_text: Access to the user-defined text of the plot. Empty strings can be inserted when
no labels are to be shown for certain elements.

• user_script: The body of the script to be executed on update if user_script_enabled = True.

• user_script_enabled: Boolean that controls if a custom script is run on update.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_user_text: True or False (default). Whether to show the text, which the user provided.

• text_threshold_type: “show_all” (default), “show_only_values_above_threshold”,

“show_only_values_below_threshold. Threshold can be set using the text_threshold property

• text_threshold: Threshold used for showing text if text_threshold_type is not “show_all”

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
570 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

Returns

the plot object

Example:

Create a user-defined plot with Data Scope set to Element Set “All_Elements”:
>>> u_plot = db.active_model.layup_plots.create_user_defined_plot(self, name="MyPlot", data_scope=db.ac

6.11.1.3. PostProcessingPlotDict Class

class compolyx.plot_data.PostProcessingPlotDict(name, label=None, obj=None,
list=[], item_type=<class 'object'>, parent=None, key_attr='name')

Container for Post Processing Plots

create_deformation_contour_plot(name=None, id=None, active=True, scope_entire_mod-

el=True, data_scope=[], component=None, spot=None, ply_wise=False, show_on_solids=False,
solution_set=- 1)

Create a Deformation Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• component: ‘x’, ‘y’, ‘z’, ‘rotx’, ‘roty’, ‘rotz’, ‘usum’

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• solution_set: Selection of the Solution Set.

Returns

the plot object

Example:

Create a deformation plot with Data Scope set to Element Set “All_Elements” for ‘rotx’:
>>> defo_plot = db.active_model.solutions['Solution.1'].plots.create_deformation_contour_plot(self, nam

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 571
The ACP Python Scripting User Interface

create_failure_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], component=None, spot=None, ply_wise=False, show_on_solids=False, show_crit-
ical_failure_mode=True, show_critical_layer=False, show_critical_load_case=False,
text_threshold=0.0, text_threshold_auto=True, failure_criteria_definition=None, show_ply_off-
sets=False, ply_offset_scale_factor=1.0, solution_set=- 1)

Create a Failure Criterion Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• component: ‘irf’, ‘mos’, or ‘rf’, which are Inverse Reserve Factor, Margin of Safety, and Reserve
Factor

• ply_wise: True or False (default). Decides whether to evaluate for individual plies or pick the
most critical ply per element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_critical_failure_mode: True (default) or False. Whether to show the text, which indicates
the mode of failure.

• show_critical_layer: Ture or False (default). Whether to show the text, which indicates the
number of the failing ply (only if ply_wise = False)

• show_critical_load_case: Ture or False (default). Whether to show the text, which indicates
the load case for which failure is predicted (only for Envelope Solutions)

• text_threshold: Threshold value above/below which text for an element is hidden. This helps
to declutter the text plot.

• text_threshold_auto: True (default) or False. If True, suggested text_thersold values are used.

• failure_criteria_definition: Object of the failure criterion definition to be used for this plot.

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• solution_set: Selection of the Solution Set.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
572 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

Returns

the plot object

Example:

Create a failure criterion plot with Data Scope set to Element Set “All_Elements”, showing
the inverse reserve factor with the most critical layer per element for failure criterion “MyFC”,
and not showing any text.:
>>> fc_plot = db.active_model.solutions['Solution.1'].plots.create_failure_plot(self, name="MyPlot", da

create_material_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], show_on_solids=False, show_ply_offsets=False, ply_offset_scale_factor=1.0,
add_to_active_set=True, locked=False, component='E1', use_all_available_fields=True,
field_variable_names=[], shear_angle_enabled=False, temperature_enabled=False, solution_set=-
1)

Create a Material Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• component: Specifies the component

• use_all_available_fields: True (default) or False. Whether to enable all available field variables
in the evaluation or not.

• solution_set: Selection of the Solution Set.

Returns

the plot object

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 573
The ACP Python Scripting User Interface

create_progressive_damage_plot(name=None, id=None, active=True, scope_entire_mod-

el=True, data_scope=[], component=None, spot=None, ply_wise=False, show_on_solids=False,
show_ply_offsets=False, ply_offset_scale_factor=1.0, solution_set=- 1)

Create a Progressive Damage Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• component: ‘state’, ‘fc’, ‘ft’, ‘mc’, ‘mt’, ‘s’ which are damage status, fiber compressive/tension
damage, matrix compressive/tension damage and shear damage.

• spot: ‘bot’, ‘top’, ‘mid’ (only if ply_wise = True)

• ply_wise: True (default) or False. Decides whether to evaluate for individual plies or return
the result of the finite element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• solution_set: Selection of the Solution Set.

Returns

the plot object

Example:

Create a progressive damage plot with Data Scope set to Element Set “All_Elements” for
‘e1’ at ‘mid’ in ply_wise mode:
>>> pd_plot = db.active_model.solutions['Solution.1'].plots.create_progressive_damage_plot(self, name="

create_strain_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], component=None, spot=None, ply_wise=True, show_on_solids=False,
show_ply_offsets=False, ply_offset_scale_factor=1.0, solution_set=- 1)

Create a Strain Plot object.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
574 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• component: ‘e1’, ‘e2’, ‘e3’, ‘e12’, ‘e23’, ‘e13’, ‘eI’, ‘eII’, ‘eIII’

• spot: ‘bot’, ‘top’, ‘mid’ (only if ply_wise = True)

• ply_wise: True (default) or False. Decides whether to evaluate for individual plies or return
the result of the finite element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• solution_set: Selection of the Solution Set.

Returns

the plot object

Example:

Create a strain plot with Data Scope set to Element Set “All_Elements” for ‘e1’ at ‘mid’ in
ply_wise mode:
>>> strain_plot = db.active_model.solutions['Solution.1'].plots.create_strain_plot(self, name="MyPlot",

create_stress_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], component=None, spot=None, ply_wise=True, show_on_solids=False,
show_ply_offsets=False, ply_offset_scale_factor=1.0, interlaminar_normal_stresses=False, solu-
tion_set=- 1)

Create a Stress Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 575
The ACP Python Scripting User Interface

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• component: ‘s1’, ‘s2’, ‘s3’, ‘s12’, ‘s23’, ‘s13’, ‘sI’, ‘sII’, ‘sIII’

• spot: ‘bot’, ‘top’, ‘mid’ (only if ply_wise = True)

• ply_wise: True (default) or False. Decides whether to evaluate for individual plies or return
the result of the finite element.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• solution_set: Selection of the Solution Set.

Returns

the plot object

Example:

Create a stress plot with Data Scope set to Element Set “All_Elements” for ‘s1’ at ‘mid’ in
ply_wise mode:
>>> stress_plot = db.active_model.solutions['Solution.1'].plots.create_stress_plot(self, name="MyPlot",

create_temperature_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], component=None, spot=None, ply_wise=False, show_on_solids=True, solution_set=-
1)

Create a Temperature Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
576 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• spot: ‘bot’, ‘top’, ‘mid’ (only if ply_wise = True)

• ply_wise: True (default) or False. Decides whether to evaluate for individual plies or return
the result of the finite element.

• solution_set: Selection of the Solution Set.

Returns

the plot object

Example:

Create a temperature plot with Data Scope set to Element Set “All_Elements” with spot set
to ‘mid’ in ply_wise mode:
>>> temp_plot = db.active_model.solutions['Solution.1'].plots.create_temperature_plot(self, name="MyPlo

create_user_defined_plot(name=None, id=None, active=True, scope_entire_model=True,

data_scope=[], user_data=[], user_text=[], user_script=None, user_script_enabled=False,
show_on_solids=False, show_user_text=False, text_threshold=0.0, text_threshold_type='show_all',
show_ply_offsets=False, ply_offset_scale_factor=1.0, add_to_active_set=True, locked=False,
solution_set=- 1)

Create a User-Defined Plot object.

Parameters

• name: Name of the plot

• id: ID for the plot

• active: Whether the plot is active or not.

• scope_entire_model: If true, then the scope of this plot is the entire model. If not, then set
to false and use the data_scope to specify a sub scope.

• data_scope: Object(s) defining the scope for which data is computed and returned. Applicable
are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point

• user_data: Retrieve or provide the user data, which must obey the order of the user_ele-
ment_indices or user_element_labels, respectively.

• user_text: Access to the user-defined text of the plot. Empty strings can be inserted when
no labels are to be shown for certain elements.

• user_script: The body of the script to be executed on update if user_script_enabled = True.

• user_script_enabled: Boolean that controls if a custom script is run on update.

• show_on_solids: True or False (default). Whether to show the results on the shell or solid
model (if present).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 577
The ACP Python Scripting User Interface

• show_user_text: True or False (default). Whether to show the text, which the user provided.

• text_threshold_type: “show_all” (default), “show_only_values_above_threshold”,

“show_only_values_below_threshold. Threshold can be set using the text_threshold property

• text_threshold: Threshold used for showing text if text_threshold_type is not “show_all”

• show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply
offsets or not.

• ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_off-
sets=True.

• solution_set: Selection of the Solution Set.

Returns

the plot object

Example:

Create a user-defined plot with Data Scope set to Element Set “All_Elements”:
>>> u_plot = db.active_model.layup_plots.create_user_defined_plot(self, name="MyPlot", data_scope=db.ac

6.11.2. PlotData Classes

This section contains the following topics:
6.11.2.1. PlotData
6.11.2.2. ContourData
6.11.2.3. AngleData
6.11.2.4.ThicknessData
6.11.2.5. ScalarFieldData
6.11.2.6. DrapingData
6.11.2.7. FieldDefinitionData
6.11.2.8. LayupMappingData
6.11.2.9. UserDefinedData
6.11.2.10. DeformationContourData
6.11.2.11. StrainData
6.11.2.12. StressData
6.11.2.13. FailureData
6.11.2.14.TemperatureData
6.11.2.15. ProgressiveDamageData

6.11.2.1. PlotData
class compolyx.plot_data.PlotData(graph, obj, parent=None)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
578 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

active

Whether the plot is active or not; an inactive plot is not updated and it does not contain data.

active_display_data

Returns a dictionary containing display data for this plot owned by the active scene

add_data_scope_entity(entity)

Add 1 entity to the Data Scope of a plot.

Parameters

• entity: Entity to be added. Applicable are Element Set, Oriented Selection Set, Modeling Ply,
Production Ply, Analysis Ply, and Sampling Point

Example:

Add the Element Set “My_ESet” to a my_plot:

>>> my_plot.add_data_scope_entity(entity = db.active_model.element_sets['My_ESet'])

all_display_data

Returns a list of all display data classes in existence for this object

changed

Status boolean. Set to true if the underlying data has been changed. Write only property

clear_data_scope()

Cleares the complete data scope of a plot, i.e. all scope entities are removed at once.

component

The requested result component for a specific plot, e.g. s1 for the stress in the 1-direction

components

Return the possible component set on this plot type

data_scope

Data scope of the plot where results will be evaluated.

description_changed

Status boolean. Set to true if the object’s description has been changed. Write only property

display_data_create(parent=None)

Function for internal use, not meant for scripting.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 579
The ACP Python Scripting User Interface

enabled

Whether this object is currently enabled or not. Mainly defined through the current application
mode pre or post.

eval_position

The finite element position at which the results are given, e.g. centroid or nodal.

get_data(visible=None, selected=None)

Get data of plot.

Parameters

• visible: Object(s) defining visible scope

• selected: Selected object(s) for ply-wise evaluations.

Returns

Resulting n-dimensional array with plot data for each selected object. The scope of the data is
evaluated identically as for get_element_xx functions as the intersection of - data_scope of plot
- visible_scope defined by visible - selection_scope defined by selected

Data is returned independent of update status of plot, but only if results for the current plot
configuration are available, else an empty array is returned.

Examples:

Get data for current ply-wise plot with visible scope set to element set “All_Elements” and
with ply1 and ply2 selected:
>>> data = my_plot.get_data(visible=db.active_model.element_sets['All_Elements'], selected=[ply1, ply2]

Get data for current element-wise plot with visible scope equal to all objects visible in current
scene:
>>> data = my_plot.get_data(visible=db.active_model.active_scene.active_set.entities)

get_deformations(visible=None, selected=None)

Function used internally to query matching nodal deformations for a given plot. To query de-
formations in a script it is recommended to create a separate deformations plot and query its
data using normal get_data(…) method.

get_element_indices(visible=None, selected=None)

Get element indices (ACP internal element numbers starting from 0) of plot

Parameters

• visible: Object(s) defining visible scope

• selected: Selected object(s) for ply-wise evaluations.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
580 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

Returns

Resulting array with element indices from the intersection of - data_scope of plot - visible_scope
defined by visible - selection_scope defined by selected

Indices are returned independent of update status of plot, but only if results for the current
plot configuration are available, else an empty array is returned.

Examples:

Get element indices for current plot with visible scope set to element set “All_Elements”
and with ply1 and ply2 selected:
>>> eis = my_plot.get_element_indices(visible=db.active_model.element_sets['All_Elements'], selected=[p

Get element indices for current plot with visible scope equal to all objects visible in current
scene:
>>> eis = my_plot.get_element_indices(visible=db.active_model.active_scene.active_set.entities)

get_element_labels(visible=None, selected=None)

Get element labels (element numbers as read from / written to mesh files) of plot.

Parameters

• visible: Object(s) defining visible scope

• selected: Selected object(s) for ply-wise evaluations.

Returns

Resulting array with element labels from the intersection of - data_scope of plot - visible_scope
defined by visible - selection_scope defined by selected

Labels are returned independent of update status of plot, but only if results for the current plot
configuration are available, else an empty array is returned.

Examples:

Get element labels for current plot with visible scope set to element set “All_Elements” and
with ply1 and ply2 selected:
>>> eis = my_plot.get_element_labels(visible=db.active_model.element_sets['All_Elements'], selected=[pl

get_full_description()

This function returns information displayed together with the legend. Internal use only, not
meant for scripting.

has_element_wise

Whether the plot offers element-wise data.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 581
The ACP Python Scripting User Interface

has_ply_wise

Whether the plot offers ply-wise data.

locked

Returns the locked status of the plot

name

Name of object

ply_wise

Whether to plot ply-wise or element-wise.

remove_data_scope_entity(entity)

Remove 1 entity to the Data Scope of a plot.

Parameters

• entity: Entity to be removed. Applicable are Element Set, Oriented Selection Set, Modeling
Ply, Production Ply, Analysis Ply, and Sampling Point

Example:

Remove the Element Set “My_ESet” from my_plot:

>>> my_plot.remove_data_scope_entity(entity = db.active_model.element_sets['My_ESet'])

scope_entire_model

Whether the plot scope is the entire model or a subset defined by the data_scope.

serialize()

Serialize to Python string

serialize_properties()

Serialize to Python string

show_on_solids

Whether to plot results on solid or shell elements.

solution

Solution underlying the plot.

solution_set

Solution Set selection.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
582 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

spot

Whether to plot data at bot, mid or top of the layer or laminate.

spots

Return the possible spot set on this plot type

updated

Status boolean. Set to true if the underlying data has been changed. Write only property

uptodate

Whether the plot is uptodate.

6.11.2.2. ContourData
class compolyx.plot_data.ContourData(graph, obj, parent=None, display_data=None)

Bases: compolyx.plot_data.plot_data.PlotData

get_ply_offsets(visible=None, selected=None)

Get the offset between plies and reference surface.

Parameters

• visible: Object(s) defining visible scope

• selected: Selected object(s) for ply-wise evaluations.

Returns

Resulting n-dimensional array of arrays with the ply-offset vectors for each node within the
object/ply-selection: [ [array(float, float, float), array(float, float, float), …] … ]

The scope of the data is evaluated as the intersection of

• data_scope of plot

• visible_scope defined by visible

• selection_scope defined by selected

Example:

Get the ply-offsets for the current ply-wise plot with visible scope set to element set
“All_Elements” and with ply1 and ply2 selected:
>>> p_offs = my_contour_plot.get_ply_offsets(visible=db.active_model.element_sets['All_Elements'], sele

minmax

Min and max value of current data

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 583
The ACP Python Scripting User Interface

minmax_last_query

Min and max value of data of last query

ply_offset_scale_factor

Offset scale factor

serialize()

Serialize to Python string

6.11.2.3. AngleData
class compolyx.plot_data.AngleData(graph, obj, parent=None, display_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

spot

Not applicable to an angle plot

6.11.2.4. ThicknessData
class compolyx.plot_data.ThicknessData(graph, obj, parent=None, display_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

spot

Not applicable to a thickness plot

6.11.2.5. ScalarFieldData
class compolyx.plot_data.ScalarFieldData(graph, obj, parent=None)

Bases: compolyx.plot_data.contour_data.ContourData

get_support_point_coordinates()

Get the coordinates of the supporting points.

Returns

Resulting n-dimensional array with the coordinates for each supporting point.

Data is returned independent of update status of plot.

Examples:

Get coordinates for supporting points defining look-up table plot:

>>> coords = my_plot._get_support_point_coordinates()

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
584 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

get_support_point_labels()

Get the identifiers for the supporting points.

Returns

Resulting n-dimensional array with the supporting point labels.

Labels are returned independent of update status of plot.

Examples:

Get labels for supporting points defining look-up table plot:

>>> coords = my_plot._get_support_point_labels()

get_support_point_values()

Get the scalar values defined at the supporting points.

Returns

Resulting n-dimensional array with the scalar values as defined at the supporting points.

Values are returned independent of update status of plot.

Examples:

Get scalar values for supporting points defining look-up table plot:
>>> coords = my_plot._get_support_point_values()

scalar_field

The underlying scalar field.

serialize()

Serialize to Python string

show_supporting_point_labels

Whether to plot the labels of the supporting points.

show_supporting_points

Whether to the plot supporting points.

spot

Not applicable to a scalar field plot

supporting_point_scale_factor

Relative scale factor for the supporting points.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 585
The ACP Python Scripting User Interface

6.11.2.6. DrapingData
class compolyx.plot_data.DrapingData(graph, obj, parent=None)

Bases: compolyx.plot_data.plot_data.PlotData

serialize()

Serialize to Python string

serialize_properties()

Serialize to Python string

show_draping_mesh

Whether to plot the draping mesh.

show_flatwrap

Whether to plot the flatwrap.

6.11.2.7. FieldDefinitionData
class compolyx.plot_data.FieldDefinitionData(graph, obj, parent=None, dis-
play_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

field_variable_name

The underlying field variable name.

serialize()

Serialize to Python string

spot

Not applicable to a field definition plot

6.11.2.8. LayupMappingData
class compolyx.plot_data.LayupMappingData(graph, obj, parent=None, dis-
play_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

spot

Not applicable to a layup mapping plot

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
586 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

6.11.2.9. UserDefinedData
class compolyx.plot_data.UserDefinedData(graph, obj, parent=None, dis-
play_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

serialize_properties()

Serialize to Python string

show_user_text

Whether to show the user-defined text labels or not.

spot

Not applicable to a user-defined plot

text_threshold

Threshold above/below which user text is hidden.

text_threshold_type

“show_all” (default), “show_only_values_above_threshold”, “show_only_values_below_threshold.

Threshold can be set using the text_threshold property

user_data

Access to the user-defined data of the plot.

user_element_centroids

Retrieve the centroids of the elements consistent with the current user element indices/labels.

user_element_indices

Access the indices for the given data-scope.

user_element_labels

Access the labels for the given data-scope.

user_script

Body of the script to be executed is user_script_enabled is set to True

user_script_enabled

Whether to run a custom script on update

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 587
The ACP Python Scripting User Interface

user_text

Access to the user-defined text of the plot. Note: the get method returns the filtered data which
takes the threshold into account.

6.11.2.10. DeformationContourData
class compolyx.plot_data.DeformationContourData(graph, obj, parent=None, dis-
play_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

6.11.2.11. StrainData
class compolyx.plot_data.StrainData(graph, obj, parent=None, display_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

6.11.2.12. StressData
class compolyx.plot_data.StressData(graph, obj, parent=None, display_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

interlaminar_normal_stresses

Whether to evaluate normal stresses.

6.11.2.13. FailureData
class compolyx.plot_data.FailureData(graph, obj, parent=None, display_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

get_text(visible=None, selected=None, str_results=True)

Get text data of failure plot.

Parameters

• visible: Object(s) defining visible scope

• selected: Selected object(s) for ply-wise evaluations.

• str_results: Whether to return failure modes as strings or enums. (default is str)

Returns

Resulting n-dimensional array with a dict with data for each selected object/ply: [ dict( “fm” :
array(int/str), “li” : array(int), “lc” : array(int) ), dict( “fm” : array(int/str), “li” : array(int), “lc” : array(int)
), … ] Possible keys: - fm: Failure Mode (enum) - li: Layer index - lc: Load case (for envelope
solutions only)

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
588 of ANSYS, Inc. and its subsidiaries and affiliates.
 Plot Classes

The scope of the data is evaluated identically as for get_element_xxx functions as the intersection
of: - data_scope of plot - visible_scope defined by visible - selection_scope defined by selected

Text data is returned independent of update status of plot, but only if results for the current
plot configuration are available, else an empty array is returned.

Examples:

Get text data for current ply-wise plot with visible scope set to element set “All_Elements” and
with ply1 and ply2 selected:
>>> text = my_plot.get_text(visible=db.active_model.element_sets['All_Elements'], selected=[ply1, ply2])

Get textdata for current element-wise plot with visible scope equal to all objects visible in current
scene:
>>> text = my_plot.get_text(visible=db.active_model.active_scene.active_set.entities)

serialize()

Serialize to Python string

show_critical_failure_mode

Whether to evaluate and show the critical failure mode.

show_critical_layer

Whether to evaluate and show the critical layer.

show_critical_load_case

Whether to evaluate and show the critical laod case; available only for Envelope Solutions.

spot

Not applicable to a failure plot

text_threshold

Threshold value below which or above which the error mode text is displayed or not. Hidden
text becomes ‘ns’ if you query the results by scripting.

text_threshold_auto

Whether the threshold for visualization of failure text is set automatically or not. Hidden text
becomes ‘ns’ if you query the results by scripting.

6.11.2.14. TemperatureData
class compolyx.plot_data.TemperatureData(graph, obj, parent=None, dis-
play_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 589
The ACP Python Scripting User Interface

6.11.2.15. ProgressiveDamageData
class compolyx.plot_data.ProgressiveDamageData(graph, obj, parent=None, dis-
play_data=None)

Bases: compolyx.plot_data.contour_data.ContourData

spot

Not applicable to a progressive damage plot

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
590 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 7: Guide for ACP Terminology
The following terms and concepts appear in composite analyses.

Classical laminate theory (CLT) analysis

For a given sampling point, the laminate properties and stiffness/compliance matrices are evaluated
based on the lay-up on the shell mesh. Also, laminate forces are calculated when a sampling point
is used on a solved model where nodal displacement results are available. For more information,
see Classical Laminate Theory (p. 408).

Coupling effect

Coupling effects describe the relationship between laminate forces and bending moments of a
composite structure caused by imbalanced laminates. Classical laminate theory (CLT), by default,
uses the coupling effect to calculate the polar properties and laminate engineering constants from
the laminate compliance matrix. For more information, see Analysis Options (p. 413).

Cut-off selection rule

Acts as a cutting operation on the composite lay-up and can be defined by a geometry or a tapered
edge.

Edge set

A named selection of connected edges in Mechanical are transferred to ACP as an edge set, which
stores the node labels of an edge and is, therefore, not associated with the geometry. You can also
define an edge set manually in ACP (Pre). For more information, see Edge Sets (p. 92).

Element set

A named selection of connected faces/connected elements in Mechanical are transferred to ACP as

an element set, which stores the element label and is, therefore, not associated with the geometry.
For more information, see Element Sets (p. 91).

Fabric

Associates a material with a ply, defines its thickness and optionally the fabrics cost. For more in-
formation, see Fabric (p. 80).

Failure criteria

Is used to evaluate the strength of a composite structure with respect to the different composite
failure modes. A failure plot displays the critical margin to failure (reserve factors, inverse reserve
factors, and margin of safety) to the first ply failure for a given failure criteria definition. For more
information, see Guide to Composite Failure Criteria (p. 317).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 591
Guide for ACP Terminology

Failure plot

Displays the margin to failure for the first ply failure of a pre-defined failure criteria definition. For
more information, see Solution Plots (p. 227).

Fiber direction

Describes the material 1 direction of a ply material and can be visualized on the composite model.
For more information, see Fiber Directions (p. 26).

Geometry

The virtual 3D shape, and the derived subshapes, imported into ACP (Pre) to build complex laminates.
For more information, see Geometry (p. 93).

Global ply number

Defines a ply’s global position in the ply-ordering sequence. The global ply number represents the
order of the plies in the modeling group. For more information, see Modeling Ply Properties (p. 136).

Inverse reserve factor (IRF)

A result type that measures the margin to failure of a composite material. For more information,
see Failure Mode Measures (p. 258).

Lay-up

The stack of plies and their sequence in ACP. For more information, see Lay-Up Plots (p. 210).

Modeling ply (MP)

The MP is internal to ACP and is the most basic definition of a ply. The production ply (PP) and
analysis ply (AP) are built automatically from information placed on this level. For instance, a sub
laminate is an MP and each of their materials (either fabric or stackup) displays as a PP. For more
information, see Modeling Ply Properties (p. 136).

Reference direction of an oriented selection set (OSS)

Specifies the reference direction (0°) to which all MP ply angles are relative. For more information,
see Oriented Selection Sets (OSS) (p. 128).

Orthotropic elasticity

A mechanical property for linear elastic materials with direction-dependency. For more information,
see Orthotropic Elasticity.

Puck failure

Composite failure criterion that evaluates the strength of a reinforced material. This criterion is
available in ACP. For more information, see Puck Failure Criteria (p. 388) and Failure Criteria vs. Ply
Type Table (p. 408).

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
592 of ANSYS, Inc. and its subsidiaries and affiliates.
Sampling point

Used in pre- and post-processing to access detailed properties and results of a layup in a specific
location. ACP samples through the specific element near the given coordinates to run detailed
analyses (lay-up plots, through-the-thickness plots, and laminate engineering constants). For more
information, see Sampling Points (p. 161).

Script

Instructions in Python code that allow for more complex model definition, parametrization, and
automation in ACP. Scripts are marked for execution whenever a parameter or the script itself
changes. For more information, see Scripts (p. 67).

Selection rule

Enables you to define specific lay-up areas or ply boundaries without depending on the mesh and
the geometry of the model. The selection can be combined with OSSs or MPs to define plies of ar-
bitrary shapes. For more information, see Selection Rules (p. 111).

Stackup

A multiaxial stack of fabrics consisting of several plies. Typically, these layers are then stitch-bonded
to form a fabric, also called a non-crimp fabric. For more information, see Stackup (p. 84).

Tapering

The process of progressively narrowing the thickness of an individual ply or laminate in a composite
structure.

Thickness type

Determines the thickness definition when defining an MP.

T-joint

A t-joint connects two parts at right angles. It is omnipresent in composite structures.

Tsai-wu

Composite failure criterion to evaluate the strength of reinforced materials. This criterion is available
in ACP. For more information, see Tsai-Wu Failure Criterion (p. 385) and Failure Criteria vs. Ply Type
Table (p. 408).

Tube selection rule

A selection rule that is defined by a constant inner and outer radius along an edge. The longitudinal
direction is defined by an edge set and the radii define the diameters of the inner and outer cylinder.
Enabling Include Rule Type selects all elements between the tube's inner and outer radii. Otherwise,
the elements outside the tube will be selected. For more information, see Selection Rules (p. 111).

Virtual geometry

Enables you to select and group specific regions or bodies of the imported CAD geometry and use
them for subsequent modeling operations. All geometry-based operations are based on virtual

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 593
Guide for ACP Terminology

geometries. Virtual geometries act as a reference to one or more faces or bodies of one CAD geo-
metry. For more information, see Virtual Geometries (p. 97).

Warping limit

When ACP performs shape checking for element quality, solid elements with a warping factor above
this user-adjustable limit are removed from the solid model. For more information, see Element
Quality (p. 176).

Woven fabric

Woven fabrics consisting of fiber strands that have been woven together in two directions, also re-
ferred to as warp and weft. For more information, see Woven Composite.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
594 of ANSYS, Inc. and its subsidiaries and affiliates.
Bibliography
[1] K.D. Potter. The influence of accurate stretch data for reinforcements on the production of complex
structural moldings. Part 1. Deformation of aligned sheets and fabrics.. Composites. Vol 10. pp.
161-167. 1979.

[2] O.K. Bergsma and J Huisman. Deep drawing of fabric reinforced thermoplastics. Computer Aided
Design in Composite Material Technology. pp. 323-334. 1988.

[3] F. Van der Ween. Algorithms for draping fabrics on doubly-curved surfaces. Int J Numer Meth Eng.
31. pp. 1415-1426. 1991,.

[4] B.P., Van West and S.C. Luby. Fabric draping simulation in composites manufacturing Part II. Analyt-
ical methods. J Adv Matter. Vol. 28. No. 3. pp. 36-41. 1997.

[5] A.G., Prodromou and J. Chen. On the relationship between shear angle and wrinkling of textile
composite preforms. Composites Part A: Applied Science and Manufacturing. Vol 28. No. 5. pp.
491-503. 1997.

[6] J. Wang, R. Paton, and J.R. Page. The draping of woven fabric preforms and prepregs for production
of polymer composite components. Composites Part A: Applied Science and Manufacturing. Vol.
30. No. 6. pp. 757-765. 1999.

[7] U. Mohammed, C. Lekakou, and M.G. Bader. Experimental studies and analysis of the draping of
woven fabrics. Composites Part A: Applied Science and Manufacturing. Vol. 31. No. 12. pp. 1409-
1420. 2000.

[8] K. Potter. Bias extension measurements on cross-plied unidirectional prepreg. Composites Part A:
Applied Science and Manufacturing. Vol. 33. No. 1. pp. 63-73. 2002.

[9] N.N. Huang and T.R. Tauchert. Thermal stresses in doubly curved cross-ply laminate. Int. J. Solids
Structures. Vol 29. No. 8. pp. 991-1000. 1991.

[10] G. Kress, R. Roos, M. Barbezat, C. Dransfeld, and P. Ermanni. Model for interlaminar normal stress
in singly curved laminates. Composite Structures. Vol. 69. No. 4. pp. 458-469. 2005.

[11] K. Rohwer. Improved Transverse Shear Stiffnesses for Layered Finite Elements. DFVLR-FB. 1988.

[12] R. Rolfes and K. Rohwer. Improved Transverse Shear Stresses in Composite Finite Elements Based
on First Order Shear Deformation Theory. Int. J. for Num. Meth. in Eng. Vol. 40. pp. 51-60. 1997.

[13] R. Roos, G. Kress, M. , Barbezat, and P. Ermanni. Enhanced model for interlaminar normal stress in
singly curved laminates. Journal of Composite Structures. Vol. 80. No. 3. pp. 327–333. 2007.

[14] R. Roos, G. Kress, and P. Ermanni. A post-processing method for interlaminar normal stresses in
doubly curved laminates. Journal of Composite Structures. Vol. 81. pp. 463-470. 2007.

[15] P. Camanho and L. Lambert. A design methodology for mechanically fastened joints in laminated
composite materials. Comp. Sci. Technol.. Vol. 66. pp. 3004-3020. 2006.

[16] P. Camanho, C. Davila, S. Pinho, I. Iannucci, and P. Robinson. Prediction of in situ strengths and
matrix cracking in composites under transverse tension and in-plane shear. Composites Part A:
Applied Science and Manufacturing. Vol. 37. No. 2. pp. 165-176. 2006.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 595
Bibliography

[17] R. Cuntze and A. Freund. The predictive capability of failure mode concept-based strength criteria
for multidirectional laminates. Comp. Sci. Technol.. Vol. 64. pp. 343-377. 2004.

[18] R. Cuntze. Efficient 3D and 2D failure conditions for UD laminae and their application within the
verification of the laminate design. Comp. Sci. Technol.. Vol. 66. No. 7-8. pp. 1081-1096. 2006.

[19] R. Cuntze. The predictive capability of failure mode concept-based strength conditions for laminates
composed of UD laminas under static tri-axial stress states. Part A of the WWFE-II. Journal of
Composite Materials. 46. pp. 2563-2594. 2012.

[20] R. Cuntze. Basis Document, Update ComPoLyX Manual Chapter Cuntze and Relationship of Cuntze's
UD Friction Parameters b with Mohr's Friction Coefficients.. CCeV website. May 4, 2015.

[21] C. Davila and J. Navin. Failure Criteria for FRP Laminates in Plane-Stress. NASA Langley Research
Center. 2003.

[22] C. Davila, P. Camanho, and C. Rose. Failure Criteria for FRP Laminates. Journal of Composite Materials.
Vol. 39. No. 4. 2005.

[23] Structural Materials Handbook, Volume 1. ESA PSS-03-203. ESA Publications Division. 1994.

[24] Structural Materials Handbook. ECSS-HB-304. ESA2009ESA Publications Division. 2009.

[25] R. Jones. Mechanics of Composite Materials. Taylor & Francis. pp. 109-112. 1999.

[26] S. Pinho, C. Davila, P. Camanho, L. Iannucci, and P. Robinson. Failure models and criteria for FRP
under in-plane or three-dimensional stress states including shear non-linearity. TM-2005-213530.
NASA. 2005.

[27] A. Puck and W. Schneider. On Failure Mechanisms and Failure Criteria of Filament-wound Glass-
Fiber/Resin Composites. Plastic and Polymer Technology. pp. 33-43. 1969.

[28] A. Puck. Festigkeitsberechnung an Glasfaser/Kunststoff-Laminaten bei zusammengesetzter Beans-

pruchung. Kunststoffe. Vol. 59. No. 11. pp. 780-787. 1969.

[29] A. Puck. Festigkeitsanalyse von Faser-Matrix-Laminaten. Carl Hanser. 1996.

[30] A. Puck and H. Schurmann. Failure analysis of FRP laminates by means of physically based phe-
nomenological models. Comp. Sci. Technol.. Vol. 58. pp 1045-1067. 1998.

[31] A. Puck, J. Kopp, and M. Knops. Failure analysis of FRP laminates by means of physically based
phenomenological models. Comp. Sci. Technol.. 62. pp. 1633-1662. 2002.

[32] A. Puck, J. Kopp, and M. Knops. Guidelines for the determination of the parameters in Puck's action
plane strength criterion. Comp. Sci. Technol. 62. pp. 371-378. 2002.

[33] R.T. Sullins. Manual for Structural Stability Analysis of Sandwich Plates and Shells. CR-145. NASA.
1969.

[34] M. Palantera. ESAComp4.1Theoretical Background of ESAComp Analyses. 1998.

[35] R.M. Jones. Mechanics of Composite Material. Hemisphere. 1975.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
596 of ANSYS, Inc. and its subsidiaries and affiliates.
[36] O. Hoffman. The Brittle Strength of Orthotropic Materials. Journal of Composite Materials. Vol. 1.
pp. 200-206. 1967.

[37] T.A. Sebaey, N. Blanco, C.S. Lopes, and J. Costa. Numerical investigation to prevent crack jumping
in Double Cantilever Beam tests of multidirectional composite laminates. Comp. Sci. and Technol..
Vol. 71. pp. 1587-1592. 2011.

[38] P.D. Soden, A.S. Kaddour, and M.J. Hinton. Recommendations for designers and researchers resulting
from the world-wide failure exercise. Composites Science and Technology. Vol. 64. No. 3-4. pp.
589-604. March, 2004.

[39] J.R. Vinson. Optimum design of composite honeycomb sandwich panels subjected to uniaxial
compression. American Institute of Aeronautics and Astronautics Journal. Vol. 44. No. 10.
pp.1690–1696. 1986.

[40] R.T. Sullins, G.W. Smith, and E.E. Spier. NASA CR-1457. Manual for structural stability analysis of
sandwich plates and shells. 1969.

[41] L. Léotoing. International Journal of Solids and Structures. Nonlinear interaction of geometrical and
material properties in sandwich beam instabilities. Vol.39. No. 13-14. pp. 3717-3739. 2002.

[42] I. Amidror. Scattered data interpolation methods for electronic imaging systems: a survey. Journal
of Electronic Imaging. Vol. 11. No. 2. pp. 157-176. 2002.

[43] A. Petras. Failure mode maps for honeycomb sandwich panels. Composite Structures. Vol. 44. pp.
237-252. 1999.

[44] I.M. Daniel. Influence of Core Properties on the Failure of Composite Sandwich Beams. Journal of
Mechanics of Materials and Structures. Vol. 4. No. 7-8. pp. 1271-1286. 2009.

[45] Z. Hashin. Failure Criteria for Unidirectional Fiber Composites. Journal of Applied Mechanics. Vol. 47.
No. 2. pp. 329-334. 1980.

[46] P. Isaksson, A. Krusper, and P.A. Gradin. Shear Correction Factors for Corrugated Core Structures.
Composite Structures. Vol. 80. pp. 123-130. 2007.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 597
 Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
598 of ANSYS, Inc. and its subsidiaries and affiliates.