MODOPT
MODOPT,
Method
, NMODE
,
FREQB
, FREQE
,
Cpxmod
, Nrmkey
,
ModType
, BlockSize
,
--
, --
, --
,
FREQMOD
Specifies modal analysis options.
Method
Mode-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
NMODE
The number of modes to extract. The value can depend on the value supplied for
Method
.NMODE
has 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, aFREQE
value must be set).Recommendation:
When Method
= LANPCG,NMODE
should be less than 100 to be computationally efficient.When Method
= SNODE,NMODE
should be greater than 100 for 2D plane or 3D shell/beam models and greater than 250 for 3D solid elements to be computationally efficient.FREQB
The beginning, or lower end, of the frequency range (or eigenvalue range if
FREQMOD
is specified) of interest.For
Method
= LANB, SUBSP, UNSYM, DAMP, and QRDAMP,FREQB
also 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
FREQB
value, eigenvalues are output beginning at the shift point and increase in magnitude. For the UNSYM and DAMP methods with a negativeFREQB
value, eigenvalues are output beginning at zero magnitude and increase.Choosing higher
FREQB
values with the LANPCG and SNODE methods may lead to inefficient solution times because these methods will find all eigenvalues between zero andFREQB
before finding the requested modes betweenFREQB
andFREQE
.FREQE
The ending, or upper end, of the frequency range (or eigenvalue range if
FREQMOD
is 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
FREQE
value too high; for example, not higher than 5000 Hz for an industrial problem. The higher theFREQE
value used for the SNODE method, the more accurate the solution and the more eigenvalues produced; however, the solution time also increases. For example, ifFREQE
is 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 byFREQE
and by theRangeFact
value on the SNOPTION command.Cpxmod
Complex 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.Nrmkey
Mode 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).ModType
Type 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.
BlockSize
The block vector size to be used with the Block Lanczos or Subspace eigensolver (used only when
Method
= LANB or SUBSP).BlockSize
must 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, higherBlockSize
values 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
BlockSize
is increased. It is recommended that you use a value divisible by 4 (4, 8, 12, or 16).--
Unused field.
--
Unused field.
--
Unused field.
FREQMOD
The 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 |