Mapdl.magsolv(opt='', nramp='', cnvcsg='', cnvflux='', neqit='', biot='', cnvtol='', **kwargs)

Specifies magnetic solution options and initiates the solution.



Static magnetic solution option:

0 - Vector potential (MVP) or edge formulation (default).

1 - Combined vector potential and reduced scalar potential (MVP-RSP).

2 - Reduced scalar potential (RSP).

3 - Difference scalar potential (DSP).

4 - General scalar potential (GSP).


Number of ramped substeps for the first load step of a nonlinear MVP or MVP-RSP solution. Defaults to 3. If NRAMP = -1, ignore the ramped load step entirely.NRAMP is ignored for linear magnetostatics.


Tolerance value on the program-calculated reference value for the magnetic current-segment convergence. Used for the MVP, the MVP- RSP, and the edge formulation solution options (OPT = 0 and 1). Defaults to 0.001.


Tolerance value on the program-calculated reference value for the magnetic flux convergence. Used for all scalar potential solution options (OPT = 2, 3, 4). Defaults to 0.001.


Maximum number of equilibrium iterations per load step. Defaults to 25.


Option to force execution of a Biot-Savart integral solution [BIOT,NEW] for the scalar potential options. Required if multiple load steps are being performed with different current source primitives (SOURC36 elements).

0 - Do not force execution of Biot-Savart calculation (default); Biot-Savart is

automatically calculated only for the first solution.

1 - Force execution of Biot-Savart calculation.


Sets the convergence tolerance for AMPS reaction. Defaults to 1e-3.


MAGSOLV invokes an ANSYS macro which specifies magnetic solution options and initiates the solution. The macro is applicable to any ANSYS magnetostatic analysis using the magnetic vector potential (MVP), reduced scalar potential (RSP), difference scalar potential (DSP), general scalar potential (GSP), or combined MVP-RSP formulation options. Results are only stored for the final converged solution. (In POST1, issue *SET,LIST to identify the load step of solution results.) The macro internally determines if a nonlinear analysis is required based on magnetic material properties.

If you use the BIOT option and issue SAVE after solution or postprocessing, the Biot-Savart calculations are saved to the database, but will be overwritten upon normal exit from the program. To save this data after issuing SAVE, use the /EXIT,NOSAVE command. You can also issue the /EXIT,SOLU command to exit ANSYS and save all solution data, including the Biot-Savart calculations, in the database. Otherwise, when you issue RESUME, the Biot-Savart calculation will be lost (resulting in a zero solution).

The MVP, MVP-RSP, and edge formulation options perform a two-load-step solution sequence. The first load step ramps the applied loads over a prescribed number of substeps (NRAMP), and the second load step calculates the converged solution. For linear problems, only a single load step solution is performed. The ramped load step can be bypassed by setting NRAMP to -1.

The RSP option solves in a single load step using the adaptive descent procedure. The DSP option uses two load steps, and the GSP solution uses three load steps.

The following analysis options and nonlinear options are controlled by this macro: KBC, NEQIT, NSUBST, CNVTOL, NROPT, MAGOPT, and OUTRES.

You cannot use constraint equations with OPT = 4.