NLADAPTIVE

NLADAPTIVE, Component, Action, Criterion, Option, VAL1, VAL2, VAL3, VAL4, VAL5, VAL6, VAL7
Defines the criteria under which the mesh is refined or modified during a nonlinear solution.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Component

Specifies the element component upon which this command should act:

ALL

 — 

All selected components, or all selected elements if no component is selected (default).

Name

 — 

Component name.

Action

Action to perform on the selected component(s):

ADD

 — 

Add a criterion to the database.

LIST

 — 

List the criteria defined for the specified component(s).

DELETE

 — 

Delete the criteria defined for the specified component(s).

ON

 — 

Enable the defined criteria for the specified component(s) and specify how frequently and when to check them (via ON,,,VAL1,VAL2,VAL3):

VAL1 -- Checking frequency. If > 0, check criteria at every VAL1 substeps. If < 0, check criteria at each of the VAL1 points (approximately equally spaced) between VAL2 and VAL3. (Default = -1.)

VAL2 -- Checking start time, where VAL2 < VAL3. (Default = Start time of load step.)

VAL3 -- Checking end time, where VAL3 > VAL2. (Default = End time of load step.)

VAL4 -- SOLID187 element type ID (defined prior to issuing this command). Valid only for SOLID185 or SOLID186 components in a NLAD-ETCHG analysis.

OFF

 — 

Disable the defined criteria for the specified component(s).

Criterion

Type of criterion to apply to the selected component(s):

CONTACT

 — 

Contact-based. Valid only for Action = ADD, Action = LIST, or Action = DELETE.

ENERGY

 — 

Energy-based. Valid only for Action = ADD, Action = LIST, or Action = DELETE.

BOX

 — 

A position-based criterion, defined by a box. Valid only for Action = ADD, Action = LIST, or Action = DELETE.

MESH

 — 

A mesh-quality-based criterion. Valid only for Action = ADD, Action = LIST, or Action = DELETE.

AM

 — 

Criterion used with Additive Manufacturing analyses. Valid only for Action = ADD, Action = LIST, or Action = DELETE.

REMELM

 — 

An element-removal-based criterion. Valid only for Action = ADD, Action = LIST, or Action = DELETE.

ALL

 — 

All criteria and options. Valid only for Action = LIST or Action = DELETE. Option and all subsequent arguments are ignored.

Option

Criterion option to apply to the selected component(s):

NUMELEM

 — 

For target elements only, defines the minimum number of contact elements to contact with each target element. If this criterion is not satisfied, the program refines the contact elements and the associated solid elements. For this option, VAL1 must be a positive integer.

Valid only for Criterion = CONTACT and Action = ADD, LIST, or DELETE.

MEAN

 — 

Checks the strain energy of any element that is part of the defined component for two possible conditions:

Ee ≥ c1 * Etotal / NUME (where c1 = VAL1, Etotal is the total strain energy of the component, and NUME is the number of elements of the component). If this criterion is satisfied at an element, the program refines the element. A negative VAL1 ignores this option. Default = 1.

Ee < c2 * Etotal / NUME (where c2 = VAL2, Etotal is the total strain energy of the component, and NUME is the number of elements of the component). If this criterion is satisfied at an element, the program coarsens the element. A negative VAL2 ignores this option. Default = Option ignored.

Both conditions can be applied together provided that VAL1 > VAL2; otherwise, the command is ignored.

Valid only for Criterion = ENERGY and Action = ADD, LIST, or DELETE.

XYZRANGE

 — 

Defines the location box in which all elements within are to be split, or refined / coarsened. Up to seven values are allowed following the Option argument, the seventh being an optional coarsening flag.

VAL1, ..., VAL6 – The x1, x2, y1, y2, z1, and z2 box coordinates. An unspecified coordinate is not checked.
VAL7 – Coarsening flag. Specify coarsening by setting this value to COAR. If not specified, the default behavior is refining.

Valid only for Criterion = BOX and Action = ADD, LIST, or DELETE.

OCTREE

 — 

Sets octree options for AM octree adaptive meshing for additive simulations.

VAL1 – Number of layers to keep at fine mesh resolution between the current, top layer and the layers to be remeshed. Default = 2.
VAL2 – Number of buffer elements to keep at fine mesh resolution between the part edges and the remeshed elements. Default = 2.

Valid only for Criterion = AM and Action = ADD, LIST, or DELETE.

SKEWNESS

 — 

Mesh-quality-control threshold for elements SOLID187, SOLID285, and SOLID227:

VAL1 – Defines skewness. Valid values: 0.0 through 1.0. Default = 0.9.
VAL2 – Maximum Jacobian ratio at element integration points (SOLID187 and SOLID227 only). Valid values: 0.0 to 1.0. Default = 0.1.

Valid only for Criterion = MESH and Action = ADD, LIST, or DELETE.

SHAPE

 — 

Mesh-quality control threshold for elements PLANE182 and PLANE222. Also applies to SOLID185 and SOLID186 in a NLAD-ETCHG analysis.

VAL1 -- Maximum corner angle of an element in degrees. Valid values are 0 through 180. Default = 160 (2D analysis) or 155 (3D analysis). An element is remeshed when any of its corner angles reach the specified value.

Valid only for Criterion = MESH and Action = ADD, LIST, or DELETE.

WEAR

 — 

For contact elements having surface wear specified (TB,WEAR) only, defines VAL1 as a critical ratio of magnitude of wear to the average depth of the solid element underlying the contact element. Once this critical ratio is reached for any element, the program morphs the mesh to improve the quality of the elements. VAL1 must be a positive integer.

Valid only for Criterion = CONTACT and Action = ADD, Action = LIST, or Action = DELETE. Cannot be combined with any other option during solution.

CZM

 — 

For contact elements with cohesive zone material (TB,CZM) only, defines VAL1 as a critical value of change in released energy due to debonding between reference and current substep, and VAL2 as the critical value for the change in the damage parameter between neighboring elements. Both values can be applied separately or together.

When the critical value is reached (for either of the defined options) for one contact element, the solid elements underlying that contact element and the corresponding deformable target element are selected as candidates for remeshing.

Required: VAL1 > 0, and 1 ≤ VAL2 ≤ 1. No default.

If issuing NLMESH,,,VAL3 where VAL3 > 1.0, the criterion also checks for coarsening of solid elements underlying the debonded contact element and the corresponding deformable target element.

Valid only for Criterion = CONTACT and Action = ADD, LIST, or DELETE. Combining the CZM criterion with mesh-quality-based criteria may be necessary to improve distorted elements.

ESTN

 — 

For element-removal-based criterion (Criterion = REMELM) for PLANE182 elements only. Indicates that the maximum equivalent strain measure is used to determine if the removal of an element is required.

VAL1 – Lower bound check of the maximum equivalent strain. Default = -1, indicating that if not specified, the lower bound check of the maximum equivalent strain is ignored.
VAL2 – Upper bound check of the maximum equivalent strain. Default = -1, indicating that if not specified, the upper bound check of the maximum equivalent strain is ignored.
VAL1 < VAL2. If both are specified, the element is a candidate for material removal if (VAL1 <= S <= VAL2), where S = Maximum equivalent strain at that integration point. If only VAL1 is specified, the element is a candidate for removal if (S >= VAL1). If only VAL2 is specified, the element is a candidate for removal if (S <= VAL2)

PSTN

 — 

For element-removal-based criterion (Criterion = REMELM) for PLANE182 elements only. Indicates that the maximum principal strain measure is used to determine if an element can be removed.

VAL1 – Lower bound check of the maximum principal strain. Default = -1, indicating that if not specified, the lower bound check of the maximum principal strain is ignored.
VAL2 – Upper bound check of the maximum principal strain. Default = -1, indicating that if not specified, the upper bound check of the maximum principal strain is ignored.
VAL1 < VAL2. If both are specified, the element is a candidate for material removal if (VAL1 <= P <= VAL2), where P = Maximum principal strain at that integration point. If only VAL1 is specified, the element is a candidate for removal if (P >= VAL1). If only VAL2 is specified, the element is a candidate for removal if (P <= VAL2)

MANUAL

 — 

For element-removal-based criterion (Criterion = REMELM) for PLANE182 elements only. Indicates that all element defined in the relevant component are candidates for removal and the removal will happen in a specific substep.

ALL

 — 

All options. Valid only for Action = LIST or Action = DELETE. All subsequent arguments are ignored.

Notes

If a specified component (Component) is an assembly, the defined criterion applies to all element components included in the assembly.

All components must be defined and selected before the first solve (SOLVE), although their nonlinear adaptivity criteria can be modified from load step to load step, and upon restart. For nonlinear adaptivity to work properly, ensure that all components are selected before each solve.

After issuing this command to define a new criterion, the new criterion becomes active. The program checks the new criterion once per load step, roughly in mid-loading (unless this behavior is changed via Action = ON).

When a criterion is defined, it overwrites a previously defined criterion (if one exists) through the same component, or through the component assembly that includes the specified component.

During solution, the same criteria defined for an element through different components are combined, and the tightest criteria and action control (Action,ON,,,VAL1) are used. If an ON action is defined by a positive VAL1 value through one component and a negative VAL1 value through another, the program uses the positive value.

When the AM octree option is specified (Action = ADD, Criterion = AM, Option = OCTREE), the checking frequency (Action,ON,,,VAL1), checking start time (Action,ON,,,VAL2), and checking end time (Action,ON,,,VAL3) control the checking layer frequency, start layer, and end layer respectively. If start and end layers are not specified, the start layer will default to the checking frequency, and the end layer will default to the final layer of the AM simulation.

Action = ON

If VAL1 < 0, the program checks VAL1 points between VAL2 and VAL3. The time interval between each check points is determined by (VAL3 - VAL2) / (VAL1 + 1), with the first check point as close to VAL2 + (VAL3 - VAL2) / (VAL1 + 1) as possible. Fewer check points can be used if the number of substeps during solution is insufficient (as the program can only check at the end of a substep).

If VAL2 (start time) and/or VAL3 (end time) are unspecified or invalid, the program uses the start and/or end time (respectively) of the load step.

Option = SKEWNESS

VAL1 applies to tetrahedral elements SOLID187, SOLID227, and SOLID285. When the skewness of an element is >= VAL1, the element is used as the core (seed) element of the remeshed region(s). The most desirable skewness value is 0, applicable when the element is a standard tetrahedral element; the highest value is 1, applicable when the element becomes flat with zero volume. To bypass skewness checking (not recommended), set VAL1 = 0.

VAL2 represents the Jacobian ratio and is required for tetrahedral elements SOLID187 and SOLID227. When the maximum Jacobian ratio of an element is <= VAL2, the element is used as the core (seed) element of the remeshed region(s). The most desirable maximum Jacobian ratio is 1, when the element is a standard tetrahedral element; the lowest reported value is -1, when the element is turned inside out. To bypass maximum Jacobian ratio checking (not recommended), set VAL2 = 0.

If this criterion is used with any other criteria defined for the same component, and a mesh change is requested at the same substep, all criteria defined are considered together. For more information about this special case, see Simultaneous Quality- and Refinement-Based Remeshing in the Nonlinear Adaptivity Analysis Guide.

Resources

For more information about skewness, maximum Jacobian ratio, and remeshing, see Nonlinear Mesh Adaptivity in the Nonlinear Adaptivity Analysis Guide.

For more granular control of the source mesh geometry, see NLMESH.

Menu Paths

This command cannot be accessed from a menu.