Mechanical APDL Command Reference

1880 Pages·2013·12.2 MB·English

ANSYS Mechanical APDL Command Reference
ANSYS, Inc. Release 15.0
Southpointe November 2013
275 Technology Drive
Canonsburg, PA 15317 ANSYS, Inc. is
[email protected] certified to ISO
9001:2008.
http://www.ansys.com
(T) 724-746-3304
(F) 724-514-9494
Copyright and Trademark Information
© 2013 SAS IP, Inc. All rights reserved. Unauthorized use, distribution or duplication is prohibited.
ANSYS, ANSYS Workbench, Ansoft, AUTODYN, EKM, Engineering Knowledge Manager, CFX, FLUENT, HFSS 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 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.
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. is certified to ISO 9001:2008.
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, please contact ANSYS, Inc.
Published in the U.S.A.
Table of Contents
1. About This Reference.............................................................................................................................. 1
1.1. Conventions Used in This Reference.................................................................................................. 1
1.1.1. Product Codes......................................................................................................................... 2
1.1.2. Applicable Products................................................................................................................. 2
1.2. Product Capabilities.......................................................................................................................... 3
1.3.Terminology ..................................................................................................................................... 3
1.4. Command Characteristics................................................................................................................. 4
1.4.1. Data Input ............................................................................................................................... 5
1.4.2. Free-Format Input.................................................................................................................... 5
1.4.3. Nonrestrictive Data Input......................................................................................................... 5
1.4.4. Condensed Data Input............................................................................................................. 6
1.4.5. Units........................................................................................................................................ 6
1.4.6. Command and Argument Defaults........................................................................................... 6
1.4.7. File Names............................................................................................................................... 7
1.4.8. Star and Slash Commands........................................................................................................ 8
2. Command Groupings.............................................................................................................................. 9
2.1. SESSION Commands......................................................................................................................... 9
2.2. DATABASE Commands.................................................................................................................... 11
2.3. GRAPHICS Commands.................................................................................................................... 14
2.4. APDL Commands............................................................................................................................ 17
2.5. PREP7 Commands........................................................................................................................... 20
2.6. SOLUTION Commands.................................................................................................................... 36
2.7. POST1 Commands.......................................................................................................................... 50
2.8. POST26 Commands........................................................................................................................ 58
2.9. AUX2 Commands............................................................................................................................ 61
2.10. AUX3 Commands.......................................................................................................................... 61
2.11. AUX12 Commands........................................................................................................................ 62
2.12. AUX15 Commands........................................................................................................................ 62
2.13. Mapping Processor Commands..................................................................................................... 63
2.14. PROBABILISTIC Design Commands................................................................................................ 63
2.15. DISPLAY Program Commands........................................................................................................ 65
2.16. REDUCED Order Modeling Commands.......................................................................................... 65
3. Command Dictionary............................................................................................................................ 67
I. Connection Commands............................................................................................................................ 71
II. A Commands........................................................................................................................................... 79
III. B Commands........................................................................................................................................ 177
IV. C Commands........................................................................................................................................ 229
V. D Commands ........................................................................................................................................ 359
VI. E Commands........................................................................................................................................ 445
VII. F Commands....................................................................................................................................... 621
VIII. G Commands...................................................................................................................................... 677
IX. H Commands....................................................................................................................................... 763
X. I Commands.......................................................................................................................................... 783
XI. J Commands ........................................................................................................................................ 815
XII. K Commands....................................................................................................................................... 819
XIII. L Commands...................................................................................................................................... 849
XIV. M Commands..................................................................................................................................... 925
XV. N Commands..................................................................................................................................... 1035
XVI. O Commands................................................................................................................................... 1109
XVII. P Commands................................................................................................................................... 1139
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
Command Reference
XVIII. Q Commands.................................................................................................................................. 1337
XIX. R Commands.................................................................................................................................... 1343
XX. S Commands..................................................................................................................................... 1423
XXI.T Commands.................................................................................................................................... 1621
XXII. U Commands................................................................................................................................... 1727
XXIII.V Commands.................................................................................................................................. 1753
XXIV.W Commands................................................................................................................................. 1829
XXV. X Commands................................................................................................................................... 1845
XXVI.Y Commands.................................................................................................................................. 1849
XXVII. Z Commands................................................................................................................................. 1851
Index...................................................................................................................................................... 1853
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
List of Figures
1. RCL Lumped Circuit............................................................................................................................... 204
2. Input Signal........................................................................................................................................... 636
3. Amplitude Spectrum of the FFT............................................................................................................. 636
4. Signal Obtained with the Filter............................................................................................................... 637
5. Basic Ocean Data Type Components .................................................................................................... 1111
6. Ocean Zone Types (Specified via ZoneType)....................................................................................... 1123
7. Usage Example:Option = COND ........................................................................................................ 1417
8. Offsets for a CHAN Section Subtype..................................................................................................... 1460
9.Two-hole Box Section........................................................................................................................... 1467
10. Cell Mesh for the Two-hole Box Section.............................................................................................. 1468
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. v
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
vi of ANSYS, Inc. and its subsidiaries and affiliates.
List of Tables
2.1. Run Controls........................................................................................................................................... 9
2.2. Processor Entry..................................................................................................................................... 10
2.3. Files...................................................................................................................................................... 10
2.4. List Controls.......................................................................................................................................... 11
2.5. Setup ................................................................................................................................................... 11
2.6. Selecting .............................................................................................................................................. 11
2.7. Components......................................................................................................................................... 12
2.8.Working Plane ...................................................................................................................................... 13
2.9. Coordinate System................................................................................................................................ 13
2.10. Picking ............................................................................................................................................... 13
2.11. Setup.................................................................................................................................................. 14
2.12.Views.................................................................................................................................................. 15
2.13. Scaling ............................................................................................................................................... 15
2.14. Style................................................................................................................................................... 15
2.15. Labeling ............................................................................................................................................. 16
2.16. Graphs................................................................................................................................................ 16
2.17. Annotation......................................................................................................................................... 16
2.18. Parameter Definition........................................................................................................................... 17
2.19. Macro Files ......................................................................................................................................... 17
2.20. Abbreviations..................................................................................................................................... 18
2.21. Array Parameters................................................................................................................................. 18
2.22. Process Controls ................................................................................................................................. 19
2.23. Matrix Operations (APDL Math)........................................................................................................... 19
2.24. Database ............................................................................................................................................ 20
2.25. Element Type...................................................................................................................................... 21
2.26. Real Constants.................................................................................................................................... 21
2.27. Materials............................................................................................................................................. 21
2.28. Material Data Tables............................................................................................................................ 22
2.29. Primitives............................................................................................................................................ 22
2.30. Keypoints ........................................................................................................................................... 23
2.31. Hard Points......................................................................................................................................... 24
2.32. Lines................................................................................................................................................... 24
2.33. Areas.................................................................................................................................................. 25
2.34.Volumes.............................................................................................................................................. 25
2.35. Booleans............................................................................................................................................. 26
2.36. Meshing ............................................................................................................................................. 27
2.37. Nodes................................................................................................................................................. 29
2.38. Elements ............................................................................................................................................ 29
2.39. Superelements ................................................................................................................................... 31
2.40. Digitizing............................................................................................................................................ 31
2.41. Coupled Degrees of Freedom.............................................................................................................. 31
2.42. Constraint Equations........................................................................................................................... 31
2.43. Element Reordering............................................................................................................................ 32
2.44. Status................................................................................................................................................. 32
2.45. Explicit Dynamics................................................................................................................................ 33
2.46. Sections.............................................................................................................................................. 34
2.47. Morphing ........................................................................................................................................... 35
2.48. Perfectly Matched Layers.................................................................................................................... 35
2.49. Special Purpose.................................................................................................................................. 35
2.50. Analysis Options................................................................................................................................. 36
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. vii
Command Reference
2.51. Nonlinear Options............................................................................................................................... 38
2.52. Dynamic Options................................................................................................................................ 38
2.53. Spectrum Options............................................................................................................................... 39
2.54. Load Step Options.............................................................................................................................. 40
2.55. Solid Constraints................................................................................................................................. 41
2.56. Solid Forces........................................................................................................................................ 41
2.57. Solid Surface Loads............................................................................................................................. 41
2.58. Solid Body Loads................................................................................................................................. 42
2.59. Inertia................................................................................................................................................. 42
2.60. Miscellaneous Loads........................................................................................................................... 42
2.61. Load Step Operations.......................................................................................................................... 43
2.62. Master Degrees of Freedom................................................................................................................ 43
2.63. Gap Conditions................................................................................................................................... 43
2.64. Rezoning............................................................................................................................................ 44
2.65. 2-D to 3-D Analysis.............................................................................................................................. 44
2.66. Birth and Death.................................................................................................................................. 44
2.67. FE Constraints..................................................................................................................................... 44
2.68. FE Forces............................................................................................................................................ 45
2.69. FE Surface Loads................................................................................................................................. 45
2.70. FE Body Loads..................................................................................................................................... 45
2.71. Ocean................................................................................................................................................. 46
2.72. Status................................................................................................................................................. 46
2.73. Explicit Dynamics................................................................................................................................ 47
2.74. Radiosity............................................................................................................................................. 48
2.75. ANSYS Multi-field solver Definition Commands.................................................................................... 49
2.76. ANSYS Multi-field solver Global Controls.............................................................................................. 49
2.77. ANSYS Multi-field solver Time Controls................................................................................................ 49
2.78. ANSYS Multi-field solver Load Transfer................................................................................................. 49
2.79. ANSYS Multi-field solver Convergence Controls................................................................................... 50
2.80. ANSYS Multi-field solver Interface Mapping......................................................................................... 50
2.81. Pile Analysis........................................................................................................................................ 50
2.82. Setup.................................................................................................................................................. 50
2.83. Controls.............................................................................................................................................. 51
2.84. Results................................................................................................................................................ 51
2.85. Element Table..................................................................................................................................... 52
2.86. Listing ................................................................................................................................................ 53
2.87. Animation .......................................................................................................................................... 53
2.88. Path Operations.................................................................................................................................. 53
2.89. Surface Operations............................................................................................................................. 54
2.90. Load Case Calculations........................................................................................................................ 55
2.91. Magnetics Calculations....................................................................................................................... 55
2.92. Fatigue............................................................................................................................................... 56
2.93.Trace Points ........................................................................................................................................ 56
2.94. Special Purpose.................................................................................................................................. 56
2.95. Status................................................................................................................................................. 58
2.96. Failure Criteria..................................................................................................................................... 58
2.97. Setup.................................................................................................................................................. 58
2.98. Controls.............................................................................................................................................. 59
2.99. Operations.......................................................................................................................................... 59
2.100. Display ............................................................................................................................................. 60
2.101. Listing .............................................................................................................................................. 60
2.102. Special Purpose ................................................................................................................................ 60
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
viii of ANSYS, Inc. and its subsidiaries and affiliates.
Command Reference
2.103. Status ............................................................................................................................................... 60
2.104. Binary File Dump............................................................................................................................... 61
2.105. Binary File Manipulation.................................................................................................................... 61
2.106. Results Files...................................................................................................................................... 61
2.107. General Radiation............................................................................................................................. 62
2.108. Radiation Matrix Method................................................................................................................... 62
2.109. Radiosity Solver ................................................................................................................................ 62
2.110. IGES.................................................................................................................................................. 62
2.111. Pressure Mapping............................................................................................................................. 63
2.112. Deterministic Model.......................................................................................................................... 63
2.113. Probabilistic Preprocessing................................................................................................................ 63
2.114. Probabilistic Methods........................................................................................................................ 63
2.115. Run Probabilistic Analysis.................................................................................................................. 64
2.116. Probabilistic Postprocessing.............................................................................................................. 64
2.117. Probabilistic Database....................................................................................................................... 64
2.118. Response Surface.............................................................................................................................. 64
2.119. Auxiliary Commands and Information................................................................................................ 64
2.120. Setup................................................................................................................................................ 65
2.121. Driver Options .................................................................................................................................. 65
2.122. Action............................................................................................................................................... 65
2.123. Setup................................................................................................................................................ 65
2.124. Preparation....................................................................................................................................... 65
2.125. Generation Pass................................................................................................................................ 66
2.126. Use Pass............................................................................................................................................ 66
127. ANSOL - General Item and Component Labels.................................................................................... 123
128. ASEL - Valid Item and Component Labels............................................................................................ 157
129. Adjusted Contact Status with CNKMOD is Issued................................................................................ 297
130. DESOL - Valid Item and Component Labels......................................................................................... 385
131. *DIM - Primary Variables..................................................................................................................... 396
132. DNSOL - Valid Item and Component Labels........................................................................................ 422
133. Birth Time, Death Time, and CID Support............................................................................................ 493
134.ESEL - Valid Item and Component Labels............................................................................................ 572
135.ESOL - General Item and Component Labels...................................................................................... 580
136.ETABLE - General Item and Component Labels................................................................................... 594
137. *GET General Items, Entity = ACTIVE................................................................................................... 683
138. *GET General Items, Entity = CMD....................................................................................................... 684
139. *GET General Items, Entity = COMP..................................................................................................... 684
140. *GET General Items, Entity = GRAPH................................................................................................... 685
141. *GET General Items, Entity = PARM..................................................................................................... 686
142. *GET Preprocessing Items, Entity = ACTIVE.......................................................................................... 688
143. *GET Preprocessing items, Entity = AREA............................................................................................ 688
144. *GET Preprocessing Items, Entity = AXIS.............................................................................................. 689
145. *GET Preprocessing Items, Entity = CDSY............................................................................................ 690
146. *GET Preprocessing Items, Entity = CE................................................................................................. 690
147. *GET Preprocessing Items, Entity = CMPB............................................................................................ 690
148. *GET Preprocessing Items, Entity = CP................................................................................................ 691
149. *GET Preprocessing Items, Entity = CSEC............................................................................................. 692
150. *GET Preprocessing Items, Entity = EDCC............................................................................................ 692
151. *GET Preprocessing Items, Entity = ELEM............................................................................................ 692
152. *GET Preprocessing Items, Entity = ETYP............................................................................................. 694
153. *GET Preprocessing Items, Entity = FLDATA......................................................................................... 695
154. *GET Preprocessing Items, Entity = GENB............................................................................................ 695
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. ix
Command Reference
155. *GET Preprocessing Items, Entity = GENS............................................................................................ 696
156. *GET Preprocessing Items, Entity = KP................................................................................................. 697
157. *GET Preprocessing Items, Entity = LINE.............................................................................................. 698
158. *GET Preprocessing Items, Entity = MAT.............................................................................................. 699
159. *GET Preprocessing Items, Entity = MPLAB.......................................................................................... 700
160. *GET Preprocessing Items, Entity = NODE........................................................................................... 700
161. *GET Preprocessing Items, Entity = OCEAN......................................................................................... 701
162. *GET Preprocessing Items, Entity = OCZONE....................................................................................... 702
163. *GET Preprocessing Items, Entity = PIPE.............................................................................................. 702
164. *GET Preprocessing Items, Entity = PART............................................................................................. 703
165. *GET Preprocessing Items, Entity = RCON............................................................................................ 703
166. *GET Preprocessing Items, Entity = REIN............................................................................................. 704
167. *GET Preprocessing Items, Entity = SCTN............................................................................................ 704
168. *GET Preprocessing Items, Entity = SECP............................................................................................. 705
169. *GET Preprocessing Items, Entity = SHEL............................................................................................. 706
170. *GET Preprocessing Items, Entity = TBFT............................................................................................. 707
171. *GET Preprocessing Items, Entity = TBLAB........................................................................................... 708
172. *GET Preprocessing Items, Entity = VOLU............................................................................................ 708
173. *GET Preprocessing Items, Entity = WELD............................................................................................ 709
174. *GET Solution Items, Entity = ACTIVE.................................................................................................. 710
175. *GET Solution Items, Entity = ELEM..................................................................................................... 711
176. *GET Solution Items, Entity = MODE................................................................................................... 711
177. *GET Postprocessing Items, Entity = ACTIVE........................................................................................ 713
178. *GET Postprocessing Items, Entity = CAMP.......................................................................................... 714
179. *GET Postprocessing Items, Entity = CINT............................................................................................ 715
180. *GET Postprocessing Items, Entity = ELEM........................................................................................... 716
181. *GET Postprocessing Items, Entity = ETAB........................................................................................... 717
182. *GET Postprocessing Items, Entity = FSUM.......................................................................................... 717
183. *GET Postprocessing Items, Entity = GSRESULT.................................................................................... 717
184. *GET Postprocessing Items, Entity = INTSRF........................................................................................ 717
185. *GET Postprocessing Items, Entity = KCALC......................................................................................... 718
186. *GET Postprocessing Items, Entity = NODE.......................................................................................... 718
187. *GET Postprocessing Items, Entity = PATH........................................................................................... 721
188. *GET Postprocessing Items, Entity = PLNSOL....................................................................................... 722
189. *GET Postprocessing Items, Entity = PRERR......................................................................................... 722
190. *GET Postprocessing Items, Entity = RAD............................................................................................ 723
191. *GET Postprocessing Items, Entity = RSTMAC...................................................................................... 723
192. *GET Postprocessing Items, Entity = SECR........................................................................................... 724
193. *GET Postprocessing Items, Entity = SECTION...................................................................................... 726
194. *GET Postprocessing Items, Entity = SORT........................................................................................... 726
195. *GET Postprocessing Items, Entity = SSUM.......................................................................................... 727
196. *GET Postprocessing Items, Entity = VARI............................................................................................ 727
197. *GET Postprocessing Items, Entity = ACUS.......................................................................................... 727
198. *GET Probabilistic Design Items, Entity = PDS (pre).............................................................................. 728
199. *GET Probabilistic Design Items, Entity = PDS (post)............................................................................ 730
200. JSOL - Valid Item and Component Labels............................................................................................ 816
201. KSEL - Valid Item and Component Labels............................................................................................ 842
202. LSEL - Valid Item and Component Labels............................................................................................ 908
203. NLHIST - Valid NSOL Item and Component Labels............................................................................. 1055
204. NLHIST - Valid ESOL Item and Component Labels............................................................................. 1056
205. NLHIST - Valid PAIR Item and Component Labels............................................................................... 1057
206.NSEL - Valid Item and Component Labels......................................................................................... 1079
Release 15.0 - © SAS IP, Inc. All rights reserved. - Contains proprietary and confidential information
x of ANSYS, Inc. and its subsidiaries and affiliates.