Mapdl.lswrite(lsnum='', **kwargs)

Writes load and load step option data to a file.



Number to be assigned to the load step file name for identification purposes. Defaults to 1 + highest LSNUM used in the current session. Issue LSWRITE,STAT to list the current value of LSNUM. Issue LSWRITE,INIT to reset to 1. The load step file will be named Jobname.Sn, where n is the specified LSNUM value (preceded by “0” for values 1-9). On systems with a 3-character limit on the file name extension, the “S” is dropped for LSNUM > 99.


Writes all load and load step option data for the selected model to a load step file for later use. LSWRITE does not capture changes made to real constants (R), material properties (MP), couplings (CP), or constraint equations (CE).

Solid model loads will not be saved if the model is not meshed. Solid model loads, if any, are transferred to the finite element model. Issue LSCLEAR,FE to delete finite element loads.

One file is written for each load step. Use the LSREAD command to read a single load step file, and the LSDELE command to delete load step files. Use the LSSOLVE command to read and solve the load steps sequentially.

Solution control commands are typically not written to the file unless you specifically change a default solution setting.

LSWRITE does not support the following commands: DJ, FJ, GSBDATA, GSGDATA, ESTIF, EKILL, EALIVE, MPCHG, and OUTRES. These commands will not be written to the load step file.

LSWRITE cannot be used with the birth-death option.

This command is also valid in PREP7.