ModalReduction
Solve parametric or time-dependent problem using modal reduction.
Syntax
model.sol(sname).create(fname,"ModalReduction")
model.sol(sname).feature(fname).set(pname,pvalue)
Description
Operation feature. The following properties are accepted:
Table 6-53: Valid Modal Properties for the Modal Reduction.
Property
Value
Default
Description
analysistype
frequency | transient
frequency
Solve for frequency response or transient response.
clist
String array
 
Provide values for constants as input parameters using a string array; for the corresponding constant names, use cname. See The clist and cname Properties.
cname
String array
 
Provide names of constants as input parameters using a string array; for the corresponding constant values, use clist. See The clist and cname Properties.
constrmodes
array of integers
 
The constraint modes to use, if constrmodeselection is set to manual.
constrmodeselection
all | manual
all
The constraint modes to use.
constrsol
solution object or none
 
The solution to use for the constraint modes.
constrsoluse
current | manual | solution store
current
Subsolution to use for the constraint modes.
control
String
user
Name of the controlling study step or user if the feature is controlled manually.
eigensoluse
current | manual | solution store
current
Subsolution to use for the eigenmodes.
eigsol
solution object
 
Precomputed eigenpairs (or other vectors) to be used in the modal analysis.
initialdataextend
automatic | true | false
automatic
Extend basis with initial data. For automatic, it is done only if it is large enough to make a difference.
keeplog
on | off
off
Keep warnings in stored log.
linearity
false | linper
false
Use linear linearity or a linear perturbation when analysistype has been set to frequency.
linplistsolnum
Integer array
new int[]{1}
List of solutions to use for the linearization point, when linpsolnum is set to from_list.
linpmanualsolnum
Integer array
new int[]{1}
Solution number (index) to use for the linearization point, when linpsolnum is set to manual.
linpmethod
init | sol
init
Method used for linearization point, which for sol is given by the linpsol property.
linpsol
zero | solution object
zero
Linearization point solution.
linpsolnum
all | auto | first | last | from_list | interp | manual | solution number
1
Indices to solutions to use as linearization points.
linpsoluse
current | manual | solution store
current
Subsolution that defines linearization point for the Eigenvalue study step.
linpsolusesolnum
integer
 
Index for the solution to use when linpsoluse is set to manual.
linpt
double
0
Interpolated point for the linearization point when linpsolnum is set to interp.
message
String
 
The log message from the last solution process.
modes
integer vector
all
Participating modes.
modeselection
all | manual
all
The eigenpairs to use.
outsollinearized
du | u
du
Store the total solution (u) or deviation and linearization point (du), when analysistype is set to frequency and storelinpoint is set to off.
plist
scalar | numeric vector
 
Frequency list. Only applicable when analysistype has been set to frequency.
pname
vector of strings
 
Parameter names.
pout
plist | fraction | spread
plist
Use plist as it stands or modify in relation to the participating modes.
romdata
String
new
Tag of the target container for the reduced model (new for a new reduced model).
rominterf
stateless | stateful
stateless
The reduced-order model interface if romdata is set to new.
romReconstruct
true | false
true
Enable reconstruction in the produced reduced model.
rtol
scalar
0.01
Relative tolerance. Only applicable when analysistype has been set to transient.
soltypemat
on | off
off
Store reduced-model matrices.
soltypeonline
on | off
off
Create a reduced model.
soltypesol
on | off
on
Perform frequency sweep or transient simulation using the modal solver.
storelinpoint
on | off
off
Whether to store the linearization point.
tlist
scalar | numeric vector
 
Time list. Only applicable when analysistype has been set to transient.
usesens
true | false
false
If set to true, the sensitivity solution (when available) is used as constraint modes.
In addition, the following properties are available for exporting matrices and vectors:
Table 6-54: Valid Modal Properties for Matrix and Vector Export from the Modal Solver.
Property
Value
Default
Description
AllL
on | off
off
All load vectors, frequency.
B0r
on | off
off
Reduced initial value input matrix, transient.
B0rdot
on | off
off
Reduced initial time derivative input matrix, transient.
Br
on | off
off
Reduced input matrix, transient and frequency.
Brdot
on | off
off
Reduced time derivative input matrix, transient.
Brdotdot
on | off
off
Reduced second time derivative input matrix, transient.
C
on | off
off
Output matrix (state space).
C_c
on | off
off
Constrained part of output matrix.
Clmap
on | off
off
Constraint modes to inputs map.
Cr
on | off
off
Reduced output matrix, transient and frequency.
D
on | off
off
Input feedback matrix (state space).
DPartSol
on | off
off
Damping matrix times particular solution, frequency.
Dr
on | off
off
Reduced damping matrix, transient and frequency.
Dr_c
on | off
off
Constrained part of damping matrix.
Dra
on | off
off
Damping ratio matrix, transient and frequency.
Dra_c
on | off
off
Constrained part of damping ratio matrix.
EPartSol
on | off
off
Mass matrix times particular solution, frequency.
Er
on | off
off
Reduced mass matrix, transient and frequency.
Er_c
on | off
off
Constrained part of mass matrix.
F
on | off
off
Input feedback, transient and frequency.
Kr
on | off
off
Reduced stiffness matrix, transient and frequency.
Kr_c
on | off
off
Constrained part of stiffness matrix.
Kud
on | off
off
Stiffness matrix times ud, transient.
L
on | off
off
Load vector, transient and frequency.
MA
on | off
off
Stiffness matrix (state space).
MA_c
on | off
off
Constrained part of stiffness matrix.
MB
on | off
off
Input matrix (state space).
Mc
on | off
off
Mass matrix (state space).
Mc_c
on | off
off
Constrained part of mass matrix.
Pm
on | off
off
Projection matrix, transient and frequency.
U0
on | off
off
Initial value vector, transient.
ud
on | off
off
Particular solution (state space).
Udot0
on | off
off
Initial derivative vector, transient.
x0
on | off
off
Initial value (state space).
Y0
on | off
off
Output bias, transient and frequency.
The reduced matrices are the matrices that result from the elimination of constraints in the discretized model.
For frequency response analysis, nonconstant Neumann boundary conditions and constant Dirichlet boundary conditions are supported. The only allowed type of parameter-dependent Dirichlet boundary condition are those that can be written as a constant vector times a scalar function. The scalar function is specified via the property loadfact. For transient response analysis only constant Dirichlet boundary conditions are supported. Neumann conditions that can be written as a constant vector times a scalar function (which is specified via the property loadfact) are supported for transient response.
The property modes is index-0 based.
If pout is set to fraction the output frequencies are the ones in plist multiplied by the absolute value of the largest eigenvalue in eigsol (or some other fraction of the largest participating eigenvalue of eigsol). The purpose of this property is to be able to automatically compute the frequency response for reasonable frequencies. If pout is set to spread then plist is interpreted as an interval around each participating eigenvalue. For example, if plist is set to range(0.9,0.04,1.1) then each participating eigenvalue is multiplied by this list, and the resulting lists are concatenated into the plist that is used.