Mapdl.lnsrch(key='', **kwargs)

Activates a line search to be used with Newton-Raphson.



Line search key:

OFF - Do not use a line search.

ON - Use a line search. Note, adaptive descent is suppressed when LNSRCH is on

unless explicitly requested on the NROPT command. Having line search on and adaptive descent on at the same time is not recommended.

AUTO - The program automatically switches line searching ON and OFF between substeps

of a load step as needed. This option is recommended.


Activates a line search to be used with the Newton-Raphson method [NROPT]. Line search is an alternative to adaptive descent (see Line Search in the Mechanical APDL Theory Reference).

LNSRCH,AUTO can be very efficient for problems in which LNSRCH is needed at only certain substeps.

You cannot use line search [LNSRCH], automatic time stepping [AUTOTS], or the DOF solution predictor [PRED] with the arc-length method [ARCLEN, ARCTRM]. If you activate the arc-length method after you set LNSRCH, AUTOTS, or PRED, a warning message appears. If you choose to proceed with the arc-length method, the program disables your line search, automatic time stepping, and DOF predictor settings, and the time step size is controlled by the arc-length method internally.

This command is also valid in PREP7.