MODOPT
MODOPT,
Method, NMODE,
FREQB, FREQE,
Cpxmod, Nrmkey,
ModType, BlockSize,
--, --, --,
FREQMOD
Specifies modal analysis options.
MethodMode-extraction method to be used for the modal analysis.
LANB
—
Block Lanczos
LANPCG
—
PCG Lanczos
SNODE
—
Supernode modal solver
SUBSP
—
Subspace algorithm
UNSYM
—
Unsymmetric matrix
DAMP
—
Damped system
QRDAMP
—
Damped system using QR algorithm
NMODEThe number of modes to extract. The value can depend on the value supplied for
Method.NMODEhas no default and must be specified. IfMethod= LANB, LANPCG, or SNODE, the number of modes that can be extracted can equal the DOFs in the model after the application of all boundary conditions.For
Method= LANB, SUBSP and UNSYM, you can specifyNMODE= ALL to extract all eigenvalues in a given frequency range. To use this option, you must also define the frequency range (that is, aFREQEvalue must be set).Recommendation:
When Method= LANPCG,NMODEshould be less than 100 to be computationally efficient.When Method= SNODE,NMODEshould be greater than 100 for 2D plane or 3D shell/beam models and greater than 250 for 3D solid elements to be computationally efficient.FREQBThe beginning, or lower end, of the frequency range (or eigenvalue range if
FREQMODis specified) of interest.For
Method= LANB, SUBSP, UNSYM, DAMP, and QRDAMP,FREQBalso represents the first shift point for the eigenvalue iterations. For UNSYM and DAMP, the default = -1.0 For other methods, the default is calculated internally.Eigenvalue extraction is most accurate near the shift point. Multiple shift points are used internally in the LANB, SUBSP, UNSYM, and QRDAMP methods. For the LANB, LANPCG, SUBSP, UNSYM, DAMP, and QRDAMP methods with a positive
FREQBvalue, eigenvalues are output beginning at the shift point and increase in magnitude. For the UNSYM and DAMP methods with a negativeFREQBvalue, eigenvalues are output beginning at zero magnitude and increase.Choosing higher
FREQBvalues with the LANPCG and SNODE methods may lead to inefficient solution times because these methods will find all eigenvalues between zero andFREQBbefore finding the requested modes betweenFREQBandFREQE.FREQEThe ending, or upper end, of the frequency range (or eigenvalue range if
FREQMODis specified) of interest (in Hz). Default = 100 Hz whenMethod= SNODE. The default for all other methods is to calculate all modes, regardless of their maximum frequency.To maintain solution efficiency, do not set the
FREQEvalue too high; for example, not higher than 5000 Hz for an industrial problem. The higher theFREQEvalue used for the SNODE method, the more accurate the solution and the more eigenvalues produced; however, the solution time also increases. For example, ifFREQEis set to 1e8, it causes the underlying supernodal structures to find all possible eigenvalues of each group of supernodes, requiring excessive solution time. The accuracy of the SNODE solution is controlled byFREQEand by theRangeFactvalue on the SNOPTION command.CpxmodComplex eigenmode key. (Valid only when
Method= QRDAMP orMethod= UNSYM).AUTO
—
Determine automatically if the eigensolutions are real or complex and output them accordingly (default when
Method= UNSYM). Not supported forMethod= QRDAMP.ON or CPLX
—
Calculate and output complex eigenmode shapes.
OFF or REAL
—
Do not calculate complex eigenmode shapes (default). This setting is required if a mode-superposition analysis is intended after the modal analysis for
Method= QRDAMP.NrmkeyMode shape normalization key:
OFF
—
Normalize the mode shapes to the mass matrix (default). This option is invalid for damped modal cyclic symmetry (
Method= DAMP or QRDAMP with the CYCLIC command).ON
—
Normalize the mode shapes to unity instead of to the mass matrix (default for damped modal cyclic symmetry [
Method= DAMP or QRDAMP with the CYCLIC command]).If a subsequent spectrum or mode-superposition analysis is planned, the mode shapes should be normalized to the mass matrix (
Nrmkey= OFF).ModTypeType of modes calculated by the eigensolver. Only applicable to the unsymmetric eigensolver.
Blank
—
Right eigenmodes (default).
BOTH
—
Right and left eigenmodes. The left eigenmodes are written to Jobname.lmode. This option must be activated if a mode-superposition analysis is intended.
BlockSizeThe block vector size to be used with the Block Lanczos or Subspace eigensolver (used only when
Method= LANB or SUBSP).BlockSizemust be an integer value between 0 and 16. When BlockSize = zero or blank, the code decides the block size internally (normally, a value of 8 is used for LANB and a value of 6 is used for SUBSP). Typically, higherBlockSizevalues are more efficient under each of the following conditions:When running in out-of-core mode and there is not enough physical memory to buffer all of the files written by the Block Lanczos or Subspace eigensolver (and thus, the time spent doing I/O is considerable).
Many modes are requested (>100).
Higher-order solid elements dominate the model.
The memory usage only slightly increases as
BlockSizeis increased. It is recommended that you use a value divisible by 4 (4, 8, 12, or 16).--Unused field.
--Unused field.
--Unused field.
FREQMODThe specified frequency when the solved eigenvalues are no longer frequencies (for example, the model has the Floquet periodic boundary condition). In a modal analysis, the Floquet periodic boundary condition (body load FPBC) is only valid for the acoustic elements FLUID30, FLUID220, and FLUID221.
Notes
Specifies modal analysis (ANTYPE,MODAL) options.
Additional options for specific eigensolvers are controlled by these commands:
SNOPTION specifies options for the Supernode (SNODE) eigensolver.
SUBOPT specifies options for the Subspace (SUBSP) eigensolver.
QRDOPT specifies options for the QRDAMP eigensolver.
DAMPOPT specifies options for the damped (DAMP) eigensolver.
LANBOPTION specifies options for the Block Lanczos (LANB) eigensolver. For more difficult modal problems, you can specify an alternative version of the Block Lanczos eigensolver (LANBOPTION,,, ALT1).
If Method = LANPCG, Mechanical APDL automatically switches to the PCG
solver internally for this modal analysis. You can further control the efficiency of the
PCG solver with the PCGOPT and EQSLV
commands.
For models that involve a non-symmetric element stiffness matrix, as in the case of a contact element with frictional contact, the QRDAMP eigensolver (MODOPT, QRDAMP) extracts modes in the modal subspace formed by the eigenmodes from the symmetrized eigenproblem. The QRDAMP eigensolver symmetrizes the element stiffness matrix on the first pass of the eigensolution, and in the second pass, eigenmodes are extracted in the modal subspace of the first eigensolution pass. For such non-symmetric eigenproblems, you should verify the eigenvalue and eigenmode results using the non-symmetric matrix eigensolver (MODOPT,UNSYM).
The DAMP and QRDAMP options cannot be followed by a subsequent spectrum analysis. The UNSYM method supports spectrum analysis when eigensolutions are real.
In a modal analysis, the Floquet periodic boundary condition (body load FPBC) is only valid for the acoustic elements FLUID30, FLUID220, and FLUID221.
For more details about mode shape normalization, see Description of Analysis for Symmetric Undamped Systems in the Theory Reference.
When rigid bodies are present in a modal analysis using the supernode modal eigensolver (ANTYPE,MODAL and MODOPT,SNODE), mode shape displacements at the constrained nodes cannot be post-processed.
This command is also valid in PREP7.
Distributed-Memory Parallel (DMP) Restriction — All extraction methods are supported in a DMP solution. Block Lanczos, PCG Lanczos, SUBSP, UNSYM, DAMP, and QRDAMP are distributed eigensolvers that run a fully distributed solution. However, the Supernode eigensolver is not a distributed eigensolver; therefore, you will not see the full performance improvements with this method that you would with a fully distributed solution.
Product Restrictions
| Command Option Method | Available Products |
| LANB | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |
| LANPCG | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |
| SNODE | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |
| SUBSP | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |
| UNSYM | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |
| DAMP | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |
| QRDAMP | Pro | Premium | Enterprise | PrepPost | Solver | AS add-on |