- Mapdl.nldiag(label='', key='', maxfile='', **kwargs)¶
Sets nonlinear diagnostics functionality.
APDL Command: NLDIAG
NRRE - Store the Newton-Raphson residuals information.
EFLG - Identify or display elements or nodes that violate the criteria.
- CONT - Write contact information to a single Jobname.cnd diagnostic text file during
Diagnostic function characteristics:
OFF or 0 - Suppresses writing of diagnostic information (default).
- ON or 1 - Writes diagnostic information to the Jobname.ndxxx, Jobname.nrxxx, or
Jobname.cnd file. (If Label = CONT, this option is the same as the SUBS option described below.)
- ITER - Writes contact diagnostic information at each iteration. Valid only when Label
- SUBS - Writes contact diagnostic information at each substep. Valid only when Label =
- LSTP - Writes contact diagnostic information at each load step. Valid only when Label
STAT - Lists information about the diagnostic files in the current working directory.
DEL - Deletes all diagnostic files in the current working directory.
Maximum number of diagnostic files to create. Valid values are 1 through 999. Default = 4. Valid only when Label = NRRE or EFLG.
The NLDIAG command is a nonlinear diagnostics tool valid for nonlinear structural analyses. It is a debugging tool for use when you must restart after an unconverged solution. The command creates Jobname.ndxxx, Jobname.nrxxx, or Jobname.cnd files in the working directory to store the information you specify.
For more information, see Performing Nonlinear Diagnostics.
Issue the NLDIAG,NRRE,ON command to create Jobname.nrxxx diagnostic files (for each equilibrium iteration after the first) in which to store the relevant Newton-Raphson residual information of forces/moments Fx, Fy, Fz, Mx, My and Mz for the last MAXFILE equilibrium iterations.
Issue a NLDPOST,NRRE,STAT command to list the load step, substep, time, and equilibrium iteration corresponding to each of the Jobname.nrxxx diagnostic files in the working directory, then issue a PLNSOL,NRRES,,,,FileID command to point to the file from which you want to create a contour plot of your Newton-Raphson residuals.
If you restart or issue a new SOLVE command, any Jobname.nrxxx diagnostic files in the current (working) directory are overwritten.
Issue a NLDIAG,EFLG,ON command to create Jobname.ndxxx diagnostic files which store IDs for elements violating the following criteria:
Too large a distortion (HDST)
Elements contain nodes that have near zero pivots (PIVT) for nonlinear analyses
Too large a plastic/creep (EPPL/EPCR) strain increment (CUTCONTROL)
Elements for which mixed u-P constraints are not satisfied (mixed U-P option of 18x solid elements only) (MXUP)
Hyperelastic element (EPHY), cohesive zone material (EPCZ), or damage strain (EPDM) not converged
Radial displacement (RDSP) not converged
MPC184 multipoint constraint elements using KEYOPT(1) = 6 through 16 with the Lagrange multiplier option fail to satisfy constraint conditions (184J)
For NLDIAG,EFLG,ON, all Jobname.ndxxx diagnostic files (for each equilibrium iteration after the first) in the current (working) directory are deleted when you issue a new SOLVE command (or restart).
In the solution processor (/SOLU), use the STAT option to list the active status of this command. In the postprocessor (/POST1), issue a NLDPOST,EFLG,STAT command to list the load step, substep, time, and equilibrium iteration corresponding to each of the Jobname.ndxxx diagnostic files in the working directory, then issue a NLDPOST,EFLG,CM,FileID command to create element components that violate the criteria.
Issue the NLDIAG,CONT,ON command to create a Jobname.cnd diagnostic file which stores contact information for all defined contact pairs at all substeps. Alternatively, you may issue one of the following commands to store contact information at a specific frequency:
NLDIAG,CONT,ITER to write at each iteration
NLDIAG,CONT,SUBS to write at each substep (default)
NLDIAG,CONT,LSTP to write at each load step
Contact diagnostic information is available for elements CONTA171 through CONTA177; it is not available for CONTA178.
Diagnostic file Jobname.cnd is written during solution and lists, on a pair-base, the following contact information:
Contact pair ID
Number of contact elements in contact
Number of contact elements in “sticking” contact status
Maximum chattering level
Maximum contact penetration/Minimum gap
Maximum closed gap
Maximum normal contact stiffness
Minimum normal contact stiffness
Maximum resulting pinball
Maximum elastic slip distance
Maximum tangential contact stiffness
Minimum tangential contact stiffness
Maximum sliding distance
Maximum contact pressure
Maximum friction stress
Average contact depth
Maximum closed penetration
Number of contact points having too much penetration
Maximum contact damping pressure
Maximum tangential contact damping stress
Maximum total sliding distance (GSLID), including near-field
Minimum total sliding distance (GSLID), including near-field
Maximum fluid penetration pressure on contact surface
Maximum fluid penetration pressure on target surface
Total volume lost due to wear for the contact pair
Total strain energy due to contact constraint
Total frictional dissipation energy
Total contact stabilization energy
ANSYS Workbench contact pair ID