Class TransientSolverOptions
Inheritance
Implements
Inherited Members
Namespace: SMT.MastaAPI.NodalAnalysis
Assembly: SMT.MastaAPI.13.0.dll
Syntax
public class TransientSolverOptions : APIBase, IEquatable<APIBase>
Fields
_parent
Declaration
protected readonly APIBase _parent
Field Value
| Type | Description |
|---|---|
| APIBase |
Properties
AbsoluteToleranceAngularVelocityForNewtonRaphson
When using a non-linear solver the values are treated as not changing if the absolute change in the angular velocity is less than this value.
Measurement: AngularVelocity
Declaration
public double AbsoluteToleranceAngularVelocityForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceAngularVelocityForStep
When using a variable time step the absolute error in the angular velocity is kept below this value.
Measurement: AngularVelocity
Declaration
public double AbsoluteToleranceAngularVelocityForStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceLagrangeForceForNewtonRaphson
When using a non-linear solver the values are treated as not changing if the absolute change in the Lagrange force is less than this value.
Measurement: Force
Declaration
public double AbsoluteToleranceLagrangeForceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceLagrangeMomentForNewtonRaphson
When using a non-linear solver the values are treated as not changing if the absolute change in the Lagrange moment is less than this value.
Measurement: Torque
Declaration
public double AbsoluteToleranceLagrangeMomentForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceSimple
Scaling for absolute tolerances.
Declaration
public double AbsoluteToleranceSimple { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceTemperatureForNewtonRaphson
When using a non-linear solver the values are treated as not changing if the absolute change in the temperature is less than this value.
Measurement: TemperatureDifference
Declaration
public double AbsoluteToleranceTemperatureForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceTemperatureForStep
When using a variable time step the absolute error in the temperature is kept below this value.
Measurement: TemperatureDifference
Declaration
public double AbsoluteToleranceTemperatureForStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceTranslationalVelocityForNewtonRaphson
When using a non-linear solver the values are treated as not changing if the absolute change in the translational velocity is less than this value.
Measurement: VelocitySmall
Declaration
public double AbsoluteToleranceTranslationalVelocityForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
AbsoluteToleranceTranslationalVelocityForStep
When using a variable time step the absolute error in the translational velocity is kept below this value.
Measurement: VelocitySmall
Declaration
public double AbsoluteToleranceTranslationalVelocityForStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
DampingScalingFactor
Maximum scaling factor applied to the damping during the initial transients. The extra damping is only applied to the Rayleigh damping β terms so that the mean load on the system is correct.
Declaration
public double DampingScalingFactor { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
DampingScalingForInitialTransients
Options other than 'None' add additional damping to the system during the initial transient period. 'Linear' uses a linear scaling for the additional damping with a maximum at the start and dropping to zero at time 0. The extra damping is only applied to the Rayleigh damping β terms so that the mean load on the system is correct.
Declaration
public DampingScalingTypeForInitialTransients DampingScalingForInitialTransients { get; set; }
Property Value
| Type | Description |
|---|---|
| DampingScalingTypeForInitialTransients |
EndTime
The stop time for the analysis. Note that the total time simulated may be longer if a time for initial transients is specified.
Measurement: TimeShort
Declaration
public double EndTime { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
IntegrationMethod
Method used to solve the equations of motion.
Declaration
public EnumWithSelectedValue<IntegrationMethod> IntegrationMethod { get; set; }
Property Value
| Type | Description |
|---|---|
| EnumWithSelectedValue<IntegrationMethod> |
LimitTimeStepForFinalResults
If this option is selected, an alternative maximum time step can be specified that is used after a specified time. This can be used to quickly get up to an interesting point in the analysis by using a coarse time step and then using a small time step to obtain detailed results.
Declaration
public bool LimitTimeStepForFinalResults { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
LogInitialTransients
If this option is selected, initial transients will also be logged
Declaration
public bool LogInitialTransients { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
MaximumNumberOfTimeSteps
The analysis will stop if this number of time steps is reached even if the end time has not been reached.
Declaration
public int MaximumNumberOfTimeSteps { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
MaximumTimeStep
The time step will not exceed this value even if the error would allow it too. It may be necessary to reduce this in order to capture high frequency events that do not have a large influence on the system evolution.
Measurement: TimeShort
Declaration
public double MaximumTimeStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
MaximumTimeStepForFinalResults
The maximum time step to use when obtaining detailed results.
Measurement: TimeShort
Declaration
public double MaximumTimeStepForFinalResults { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
MinimumStepBetweenResults
The minimum time step between successive logged values.
Measurement: TimeShort
Declaration
public double MinimumStepBetweenResults { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
MinimumTimeStep
The smallest the time step is allowed to be in order to meet the error tolerance.
Measurement: TimeVeryShort
Declaration
public double MinimumTimeStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
RayleighDampingAlpha
The alpha damping parameter determines the low frequency damping of the system. The alpha damping can be safely set to zero to avoid power loss of the rigid body rotation mode of the whole model. The damping matrix for the model C = alphaM + betaK where M and K are the stiffness and mass matrices and alpha and beta are the Rayleigh damping parameters.
Measurement: InverseShortTime
Declaration
public double RayleighDampingAlpha { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
RayleighDampingBeta
The beta damping parameter mainly affects the damping of high frequency modes. Some beta damping should always be included to remove high frequency modes that are a result of high stiffnesses used to form rigid connections. The damping matrix for the model C = alphaM + betaK where M and K are the stiffness and mass matrices and alpha and beta are the Rayleigh damping parameters. Typical global values are in the range 1e-6 to 1e-4.
Measurement: TimeShort
Declaration
public double RayleighDampingBeta { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
RelativeToleranceForNewtonRaphson
When using a non-linear solver the values are treated as not changing if the relative change is less than this value.
Measurement: Percentage
Declaration
public double RelativeToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
RelativeToleranceForStep
When using a variable time step the relative error is kept below this value.
Measurement: Percentage
Declaration
public double RelativeToleranceForStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
RelativeToleranceSimple
Scaling for relative tolerances.
Declaration
public double RelativeToleranceSimple { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResidualForceToleranceForNewtonRaphson
The maximum force residual allowed for convergence when using a non-linear solver.
Measurement: Force
Declaration
public double ResidualForceToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResidualLagrangeAngularToleranceForNewtonRaphson
The maximum Lagrange angular residual allowed for convergence when using a non-linear solver.
Measurement: SmallAngle
Declaration
public double ResidualLagrangeAngularToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResidualLagrangeTranslationalToleranceForNewtonRaphson
The maximum Lagrange translational residual allowed for convergence when using a non-linear solver.
Measurement: ShortLength
Declaration
public double ResidualLagrangeTranslationalToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResidualMomentToleranceForNewtonRaphson
The maximum moment residual allowed for convergence when using a non-linear solver.
Measurement: Torque
Declaration
public double ResidualMomentToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResidualRelativeToleranceForNewtonRaphson
For each entry in the residual the maximum error is calculated from the sum of the absolute forces on the degree of freedom multiplied by this tolerance.
Declaration
public double ResidualRelativeToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResidualTemperatureToleranceForNewtonRaphson
The maximum temperature residual allowed for convergence when using a non-linear solver.
Measurement: Power
Declaration
public double ResidualTemperatureToleranceForNewtonRaphson { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
ResultLoggingFrequency
Set to 'All' to log all available results. Set to 'Ignore Small Steps' to specify a minimum gap between logged values. Set to 'None' to not log any results.
Declaration
public ResultLoggingFrequency ResultLoggingFrequency { get; set; }
Property Value
| Type | Description |
|---|---|
| ResultLoggingFrequency |
RotateConnectionsWithBodies
If this option is selected, the constraints between bodies are rotated in time so that the correct local deflections occur on the bodies. Otherwise, a force on a shaft in the X direction, for example, will always bend the shaft in the local shaft X direction even if it is rotating.
Declaration
public bool RotateConnectionsWithBodies { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
SolverToleranceInputMethod
Simple method lets you specify a relative and an absolute tolerance which will scale all the tolerance values compared to their default values. The advanced method lets you specify all the required tolerances individually.
Declaration
public TransientSolverToleranceInputMethod SolverToleranceInputMethod { get; set; }
Property Value
| Type | Description |
|---|---|
| TransientSolverToleranceInputMethod |
Theta
Theta value used in the Wilson Theta Method
Declaration
public double Theta { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
TimeForInitialTransients
The start time for the analysis is set to t=-(Time For Initial Transients). Logging of results then begins at t=0. Anything that occurs during this initial period is not considered when calculating rating results and cannot be viewed.
Measurement: TimeShort
Declaration
public double TimeForInitialTransients { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
TimeStepLength
The time step to use if a variable time step is not being used.
Measurement: TimeVeryShort
Declaration
public double TimeStepLength { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
TimeToStartUsingFinalResultsMaximumTimeStep
The time at which to start using the 'Maximum Time Step For Final Results'.
Measurement: TimeShort
Declaration
public double TimeToStartUsingFinalResultsMaximumTimeStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Double |
UseNonLinearSolverForStep
Select this to use a Newton Raphson solver to take a step.
Declaration
public bool UseNonLinearSolverForStep { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |